1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
|
# Contributing
Pull requests are welcome, but please ensure they are supported by at least 1 open Issue ticket describing
the objectives of the PR.
## Setup
This project uses [poetry]. Have it installed and setup first.
To install dev-dependencies and tools:
```shell
poetry install
```
## Code style
This project uses [PEP8] Style Guide for Python Code.
This project loves sorted imports.
Get it all applied via:
```shell
poetry run isort .
poetry run autopep8 -ir requirements/ tests/
```
This project prefers `f'strings'` over `'string'.format()`.
This project prefers `'single quotes'` over `"double quotes"`.
This project prefers `lower_snake_case` variable names.
## Documentation
This project uses [Sphinx] to generate documentation which is automatically published to [readthedocs.io].
Source for documentation is stored in the `docs` folder in [RST] format.
You can generate the documentation locally by running:
```shell
cd docs
pip install -r requirements.txt
make html
```
## Testing
Run all tests in dedicated environments, via:
```shell
poetry run tox run
```
## Sign off your commits
Please sign off your commits, to show that you agree to publish your changes under the current terms and licenses of the project
, and to indicate agreement with [Developer Certificate of Origin (DCO)](https://developercertificate.org/).
```shell
git commit --signed-off ...
```
## Pre-commit hooks
If you like to take advantage of [pre-commit hooks], you can do so to cover most of the topics on this page when
contributing.
```shell
pre-commit install
```
All our pre-commit checks will run locally before you can commit!
[poetry]: https://python-poetry.org
[PEP8]: https://www.python.org/dev/peps/pep-0008
[Sphinx]: https://www.sphinx-doc.org/
[readthedocs.io]: https://requirements-parser.readthedocs.io/
[RST]: https://en.wikipedia.org/wiki/ReStructuredText
[pre-commit hooks]: https://pre-commit.com
|
