Working on your first Pull Request? You can learn how from this free series How to Contribute to an Open Source Project on GitHub
If you find any bugs, be sure to open up an issue. Or you email me: py@bodo-schoenfeld.de.
-
Python 3 (versions 3.8+ are currently supported)
-
pip3 install flake8 pytestflake8to check for errors and to enforce code style.pytestto run the tests (optional, you can contribute without writing tests).
-
Install all requirements with the following command:
pip3 install -r requirements_dev.txt -
If you're making changes to the documentation, install the documentation dependencies:
pip3 install -r docs/requirements.txt. -
You can find a brief introduction to reStructuredText in the Sphinx documentation.
Note: This project uses absolute imports (recommended by PEP8). So, you'd be better off using a virtual environment and run
python3 setup.py install --user
-
Select an issue to work on.
-
Fork and clone the repository, create a virtual environment and install all the dependencies:
$ pip3 install -r requirements_dev.txt -
Work on the master branch for smaller patches or create a separate branch for new features.
-
Make changes,
git addand then commit. You can link to the issue number in the commit message (optional). -
(Optional) Run
flake8andpytest. -
(Optional) If you're updating the documentation, make sure you update
docs/index.rstandREADME.mdsimultaneously. -
Use the GitHub website to create a Pull Request (PR) and wait for the maintainers to review it.