Style guide

We aim to keep the cotainr code base and documentation consistent by following the style guides listed here.

• We follow the PEP 8 style guide.

• The Python source code is formatted using black .

• All docstrings are formatted according to the numpydoc format.

• We reference the python interpreter executable as python3 (not python) when explicitly calling the system python executable and as sys.executable when reinvoking the interpreter as recommended in PEP 394.

When hacking on cotainr, we generally try to:

• Error early.

• Use self-describing commands and options.

• Make it simple.

Specifically, we use the following conventions:

• Force keyword only arguments to functions and methods.

• Use relative imports within the cotainr package when importing functionality from other modules. The imports must be done such that all objects imported are still references (not copies) which allows for monkey patching objects in their definition module in tests.