Mininet Python Style
Clone this wiki locally
Mininet is currently written in the Mininet Python Style, which is based on the Arista Networks Python style. It mainly follows PEP8, but differs in several important ways, including the following:
Spaces are inserted inside parentheses, such as those in function definitions and calls, for readability. They may be omitted in mathematical formulas if readability would otherwise be compromised.
camelCaseis used for method and variable names in preference to
under_scores. This is intended to make names look more consistent and to reduce cognitive load.
Single-line docstrings are surrounded by single double-quotes. This makes them more compact.
Multi-line docstrings are surrounded by triple double-quotes. This makes them consistent with single-line docstrings. The ending triple-quote is at the end of the last line of text.
The Mininet code style can be checked (more or less) by running
make codecheck. A utility to help with conversion from PEP8 to Mininet style is provided as
Mininet also uses
doxypy for automatic API documentation. We run a pre-processor which eliminates most uses of the
@ character in docstrings. For example:
def someFunction( someArg, anotherArg=False ): """This function does something someArg: an argument anotherArg: another argument returns: True on success""" return True
util/doxify.py converts this format into something that can be parsed by