Before you contribute on this project you need to create a new separate virtualenv.
Here is one example.
python -m venv .env
source .env/bin/activate
We have listed all the python dependencies in the requirements.txt
files.
The config file for pre-commit
hooks is in .pre-commit-config.yaml file. To install pre-commit and enable the hook please refer to https://pre-commit.com
A .editorconfig is available to maintain the coding style. Besides, your code will automatically gets formatted if you have install the pre-commit hook.
Run the unittest using the below command:
make test
To run the coverage report:
make coverage
To generate HTML coverage report
make coverage-html
Before submitting your code please do the following steps:
- Add any changes you want.
- Add tests for the new changes.
- Update the
CHANGELOG.md
file if necessary. - Edit documentation (
README.md
) if you have changed something significant. - Commit your changes using Conventional Commits.
Examples:feat: add JSON parser
,feat(parser): add JSON parser
.
You can contribute by spreading a word about this library. It would also be a huge contribution to write a short article on how you are using this project. You can also share your best practices with us.