Nox
Flexible test automation with Python
-
Documentation: https://nox.readthedocs.io
-
Source Code: https://github.com/wntrblm/nox
Overview
nox is a command-line tool that automates testing in multiple Python environments, similar to tox. Unlike tox, Nox uses a standard Python file for configuration:
import nox
@nox.session
def tests(session: nox.Session) -> None:
session.install("pytest")
session.run("pytest")
@nox.session
def lint(session: nox.Session) -> None:
session.install("flake8")
session.run("flake8", "--import-order-style", "google")
Installation
Nox is designed to be installed globally (not in a project virtual environment), the recommended way of doing this is via pipx, a tool designed to install python CLI programs whilst keeping them separate from your global or system python.
To install Nox with pipx:
pipx install nox
You can also use pip in your global python:
python3 -m pip install nox
You may want to use the user-site to avoid messing with your Global python install:
python3 -m pip install --user nox
Usage
List all sessions
nox -l/--list
Get help on a particular session (if it has a docstring)
nox --usage test
Run all sessions
nox
Run a particular session
nox -s/--session test
Checkout the docs for more! 🎉
Contributing
Nox is an open source project and welcomes contributions of all kinds, checkout the contributing guide for help on how to help us out!
All contributors must follow the code of conduct and be nice to one another! 😃
6 maintainers
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file nox-2026.8.10.tar.gz.
File metadata
- Download URL: nox-2026.8.10.tar.gz
- Upload date:
- Size: 4.1 MB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
13f45e46552eade9f4b60474133e31e1e0bb341234a3cc0c9d6fff17570ce8bb
|
|
| MD5 |
20d198588de0f8d9d0a1e0e15e3b51b5
|
|
| BLAKE2b-256 |
977874026b59fd3becd3a549498e8f7809e768c9a1db808f6f016f88b638eda6
|
Provenance
The following attestation bundles were made for nox-2026.8.10.tar.gz:
Publisher:
cd.yml on wntrblm/nox
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
nox-2026.8.10.tar.gz -
Subject digest:
13f45e46552eade9f4b60474133e31e1e0bb341234a3cc0c9d6fff17570ce8bb - Sigstore transparency entry: 2413301994
- Sigstore integration time:
-
Permalink:
wntrblm/nox@57f9e10c4eef84277dcd692d0056420c947674f9 -
Branch / Tag:
refs/tags/2026.08.10 - Owner: https://github.com/wntrblm
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
cd.yml@57f9e10c4eef84277dcd692d0056420c947674f9 -
Trigger Event:
release
-
Statement type:
File details
Details for the file nox-2026.8.10-py3-none-any.whl.
File metadata
- Download URL: nox-2026.8.10-py3-none-any.whl
- Upload date:
- Size: 94.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
943f1ebcace1efb35d91ad2034007df1942d2a1bed75fb33e1bf0ed5a0df1cdb
|
|
| MD5 |
a4b838512c042222105879b97504dfe4
|
|
| BLAKE2b-256 |
776a020c992d7121377b27676af368d5d5287121a9bb12216264d979961e90d8
|
Provenance
The following attestation bundles were made for nox-2026.8.10-py3-none-any.whl:
Publisher:
cd.yml on wntrblm/nox
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
nox-2026.8.10-py3-none-any.whl -
Subject digest:
943f1ebcace1efb35d91ad2034007df1942d2a1bed75fb33e1bf0ed5a0df1cdb - Sigstore transparency entry: 2413302014
- Sigstore integration time:
-
Permalink:
wntrblm/nox@57f9e10c4eef84277dcd692d0056420c947674f9 -
Branch / Tag:
refs/tags/2026.08.10 - Owner: https://github.com/wntrblm
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
cd.yml@57f9e10c4eef84277dcd692d0056420c947674f9 -
Trigger Event:
release
-
Statement type:
