Thank you for your interest in improving Nox. Nox is open-source under the Apache License Version 2.0 and welcomes contributions in the form of bug reports, feature requests, and pull requests.
Nox is hosted on GitHub.
Feel free to file a bug or feature request on GitHub. If your question is more general or does not fit neatly into one of those categories, we also have a Nox channel on the Winterbloom Discord server.
You should find a permalink to the invite when you raise a new issue on GitHub.
File a bug on GitHub. To help us figure out what's going on, please err on the side of including lots of information, such as:
- Operating system.
- Python version.
- If possible, a minimal case that can reproduce the issue.
- It's recommended to file a bug before starting work on anything. It'll allow chance to talk it over with the owners and validate your approach.
- Nox maintains 100% test coverage. All pull requests must maintain this.
- Follow pep8.
- Update documentation and tests if relevant.
- Ensure your changes pass Nox's tests and lint suites before pushing.
Nox runs its own tests (it's recursive!). The best thing to do is start with a known-good Nox installation, e.g. from PyPI:
pip install --pre --upgrade nox
To just check for lint errors, run:
nox --session lint
To run against a particular Python version:
nox --session "tests(python='3.12', tox_version='latest')"
nox --session conda_tests
nox --session mamba_tests
nox --session micromamba_tests
When you send a pull request the CI will handle running everything, but it is recommended to test as much as possible locally before pushing.
You can list all possible tests with:
nox --list-sessions
If you've contributed to Nox, you can get a cute little Nox sticker. Reach out to Thea at [email protected] to request one.
Contributions to Nox can be expensed through our Open Collective. The maintainers will let you know when and for how much you can expense contributions, but always feel free to ask.