Skip to main content

Flexible test automation.

Project description

logo

Nox

Nox License PyPI GitHub Code Style CI Downloads

Flexible test automation with Python

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 user the user-site to avoid messing with your Global python install:

python3 -m pip install --user nox

Usage

List all sessions

nox -l/--list

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! 😃

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

nox-2025.5.1.tar.gz (4.0 MB view details)

Uploaded Source

Built Distribution

nox-2025.5.1-py3-none-any.whl (71.8 kB view details)

Uploaded Python 3

File details

Details for the file nox-2025.5.1.tar.gz.

File metadata

  • Download URL: nox-2025.5.1.tar.gz
  • Upload date:
  • Size: 4.0 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for nox-2025.5.1.tar.gz
Algorithm Hash digest
SHA256 2a571dfa7a58acc726521ac3cd8184455ebcdcbf26401c7b737b5bc6701427b2
MD5 9db413ce407b2d4630fe123acf072637
BLAKE2b-256 b48047712208c410defec169992e57c179f0f4d92f5dd17ba8daca50a8077e23

See more details on using hashes here.

Provenance

The following attestation bundles were made for nox-2025.5.1.tar.gz:

Publisher: cd.yml on wntrblm/nox

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file nox-2025.5.1-py3-none-any.whl.

File metadata

  • Download URL: nox-2025.5.1-py3-none-any.whl
  • Upload date:
  • Size: 71.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for nox-2025.5.1-py3-none-any.whl
Algorithm Hash digest
SHA256 56abd55cf37ff523c254fcec4d152ed51e5fe80e2ab8317221d8b828ac970a31
MD5 c09508bf00671206d63c43c6bdcefce0
BLAKE2b-256 a6be7b423b02b09eb856beffe76fe8c4121c99852db74dd12a422dcb72d1134e

See more details on using hashes here.

Provenance

The following attestation bundles were made for nox-2025.5.1-py3-none-any.whl:

Publisher: cd.yml on wntrblm/nox

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page