Files
OpenUxAS-bootstrap/CONTRIBUTING.md
M. Anthony Aiello b5749b1aab Be specific about python version. (#1)
Make sure references to python in shebangs and in text specify python3
rather than simply python. This better supports convention of fresh
machines.
2020-08-04 15:41:19 -04:00

1.2 KiB

Contributing to OpenUxAS-bootstrap

Thank you for taking the time to contribute!

Code conventions

pre-commit checks

Before contributing a change please activate pre-commit checks locally:

$ pip3 install pre-commit
$ pre-commit install

Note that the pre-commit check configuration can be found in .pre-commit-config.yaml. Before any change to that file please run:

$ pre-commit run --all-files

The pre-commit checks will format the code with Black, run flake8 and mypy.

Flake8, mypy, and Black

All code should follow PEP8, PEP257. The code is automatically formatted with Black at commit time.

All changes should contain type hinting and running mypy should be clean of errors.

You should also document your method's parameters and their return values in reStructuredText format:

"""Doc string for function

:param myparam1: description for param1
:param myparam2: description for param1
:return: description for returned object
"""

The code is automatically formatted with Black.