Start by creating a fork of the repository and pulling down the code. The project's tests can be run using pytest:
pip install -r requirements-test.txt
pytest test/Linting tools are also provided and can be run through the command line:
pip install -r requirements-dev.txt
black --check PACKAGE_NAME/ test/
flake8 PACKAGE_NAME/ test/Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change. When adding new assertions, please update the unit tests and changelog.
Make sure your code is properly formatted before submitting a pull request!
black PACKAGE_NAME/ test
When making changes, please add a short human-readable description of the change to the latest (unreleased) entry in the changelog. Changes should be added under the relevant category:
- New code features go here
- Changes to existing code features go here
- Removals of code features go here
- Changes to documentation go here
- Bugfixes go here
- Identifed (unresolved) bugs go here
If you are planning to release a new version of PACKAGE_NAME, don't worry about adding dates or a new version to the changelog. Zest will handle that!
PACKAGE_NAME uses Zest and Github Actions to automate the release process. In order to do so, manually run the Release workflow from the base repository. This will add the current date to the changelog, build and publish artifacts to PyPI, and bump the version number in all the places that matter.