Contributions to InvenTree are welcomed - please follow the guidelines below.
No pushing to master! New featues must be submitted in a separate branch (one branch per feature).
Any required migration files must be included in the commit, or the pull-request will be rejected. If you change the underlying database schema, make sure you run invoke migrate
and commit the migration files before submitting the PR.
Any PRs which update translatable strings (i.e. text strings that will appear in the web-front UI) must also update the translation (locale) files to include hooks for the translated strings.
This does not mean that all translations must be provided, but that the translation files must include locations for the translated strings to be written.
To perform this step, simply run invoke translate
from the top level directory before submitting the PR.
Any new code should be covered by unit tests - a submitted PR may not be accepted if the code coverage is decreased.
New features or updates to existing features should be accompanied by user documentation. A PR with associated documentation should link to the matching PR at https://github.com/inventree/inventree-docs/
Sumbitted Python code is automatically checked against PEP style guidelines. Locally you can run invoke style
to ensure the style checks will pass, before submitting the PR.