If you want to add to plant, please familiarize yourself with the code & our Coding Standards. Make a fork of the repository & file a Pull Request from your fork with the changes. You will need to click the checkbox in the template to show you agree to the Developer Certificate of Origin.
If you make regular & substantial contributions to Auditree, you may want to become a collaborator. This means you can approve pull requests (though not your own) & create releases of the tool. Please file an issue to request collaborator access. A collaborator supports the project, ensuring coding standards are met & best practices are followed in contributed code, cutting & documenting releases, promoting the project etc.
Please ensure all code contributions are formatted by black and pass all flake8 linter requirements.
CI/CD will run black and flake8 on all new commits and reject changes if there are failures. If you
run make develop to setup and maintain your virtual environment then black and flake8 will be executed
automatically as part of all git commits. If you'd like to run things manually you can do so locally by using:
make code-format
make code-lintPlease ensure all code contributions are covered by appropriate unit tests and that all tests run cleanly. CI/CD will run tests on all new commits and reject changes if there are failures. You should run the test suite locally by using:
make testWe follow semantic versioning and changelog standards with the following addendum:
- We set the main package
__init__.pyversionfor version tracking. - Our change log is CHANGES.md.
- In addition to the types of changes outlined in the changelog standards we also include a BREAKING type of change to call out any change that may cause downstream execution disruption.
- Change types are always capitalized and enclosed in square brackets. For
example
[ADDED],[CHANGED], etc. - Changes are in the form of complete sentences with appropriate punctuation.