1a753bf200
Before commands in manual.rst and related files started with $ sign. While this shows, that commands should be executed in shell it also makes them hard to copy-paste. This change removes $ and splits commands, that include ';' into multiple lines. After this change user would be able to copy-paste whole blocks of code into shell and execute them right away. Removes `#` that meant that root privileges are required for the command and adds sudo, where relevant (yum/apt, etc.). Fixes occasional indentation inconsistencies. Change-Id: Ib649ae2a3a110bdf09b0bf9c5fbf54a5ce40ccc6
1.9 KiB
Development Guidelines
Coding Guidelines
For all the code in Murano we have a rule - it should pass PEP 8.
To check your code against PEP 8 run:
tox -e pep8Testing Guidelines
Murano has a suite of tests that are run on all submitted code, and it is recommended that developers execute the tests themselves to catch regressions early. Developers are also expected to keep the test suite up-to-date with any submitted code changes.
Unit tests are located at muranoapi/tests.
Murano's suite of unit tests can be executed in an isolated environment with Tox. To execute the unit tests run the following from the root of Murano repo on Python 2.7:
tox -e py27For Python 2.6:
tox -e py26Documentation Guidelines
Murano dev-docs are written using Sphinx / RST and located in the
main repo in doc directory.
The documentation in docstrings should follow the PEP 257 conventions (as mentioned in the PEP 8 guidelines).
More specifically:
- Triple quotes should be used for all docstrings.
- If the docstring is simple and fits on one line, then just use one line.
- For docstrings that take multiple lines, there should be a newline after the opening quotes, and before the closing quotes.
- Sphinx is used to build documentation, so use the restructured text markup to designate parameters, return values, etc. Documentation on the sphinx specific markup can be found here:
Run the following command to build docs locally.
tox -e docs