Contributing to py-moneyed¶
If you would like to contribute to py-moneyed, the recommended workflow is:
First raise an issue on GitHub for any proposal or idea that might be controversial and get feedback from the maintainers. If you have something that is an obvious bug (a typo in the docs, for example), you can skip this step.
Fork the project and checkout your fork onto your development machine.
Create a virtualenv of some kind for development (venv, virtualenv or virtualenvwrapper) and install py-moneyed into it:
python setup.py develop
Optional, but highly recommended to save time later - install pre-commit hooks:
pip install pre-commit pre-commit install
Create a git branch for your changes, starting from
master
Fix the bug or implement your changes, being sure to:
Add tests and docs
Run the test suite (below)
Push your changes to your GitHub repo and submit a pull request.
Testing¶
To run the test suite, first install tox (into your virtualenv):
pip install tox
Run the tests using tox:
tox -e py310
You can run the test suite on all supported environments using tox (recommended). If you do not have all versions of Python that are used in testing, you can use pyenv to install them, and you may benefit from the additional plugin pyenv-implict.
The py-moneyed package is tested against Python 3.7 - 3.11 and PyPy 3.