Any contribution is welcome, and it’s much appreciated! Every little helps, and a credit will always be given.
An issue may be a simple comment, question, feature request, or bug report. When reporting an issue, please make sure to provide enough information to understand it.
You may want to make some changes to the project codebase. For example, to fix a bug, to add a new feature, or to update documentation. You can do so by following these simple steps:
Fork the project repository on GitHub.
Clone your fork to your local machine.
Add the project repository as the “upstream” remote.
Create a new branch from the
Make your changes, format code, and run tests.
Pull the latest changes from upstream.
Commit and push your changes to your fork.
Create a pull request on GitHub and select the
The following are some commands you may need to use when coding on a local machine. It’s assumed that you have already created and activated a virtual environment with Python 3.10 or newer.
Preparing for development:
The project and development dependencies can be installed using:
pip install -r requirements-dev.txt && pip install -e .
After changing code, run the formatter to ensure consistency:
Running tests and quality checks:
Before committing changes, make sure to pass all tests and quality checks:
task test task lint
To build and browse documentation locally, run:
pip install -r docs/requirements.txt sphinx-build -E docs docs/_build
The resulting HTML can be found in
Don’t let anything discourage you from making the pull request. I can help you! Just go ahead and submit the pull request.