Code should follow the Python PEP8 style guide. You can check if your code has style problems using any one of the following shell commmands (you may need to install the relevant package):
% pylint file.py % pep8 file.py
autopep8 command-line utility can be used to automatically reformat
non-conforming code to the PEP8 style.
API Documentation Style¶
All functions, classes, and modules should contain appropriate API documentation in their docstrings. The docstrings should be written in ReStructuredText format (same as the Sphinx high-level documentation), and should follow the NumPy Docstring Standards
Documentation for all algorithms should contain citations to external
works, which should be collected in
bibliography.rst. An example of
citing a reference in that file:
this algorithm is an implementaton of [author2003]_
Interactive Development Environment¶
It is recommended that a fully python-aware interactive development environment (IDE) is used to develop code, rather than a basic text editor. IDEs will automatically mark lines that have style problems. The recommended IDEs are:
The IDEs provide a lot of support for avoiding common style and coding
mistakes, and automatic re-formatting (e.g.