Skip to content

wntrblm/nox

Folders and files

NameName
Last commit message
Last commit date

Latest commit

21ee4bf Β· Feb 27, 2025
Feb 9, 2025
Feb 27, 2025
Feb 13, 2025
Feb 27, 2025
Dec 23, 2021
Jan 15, 2025
Oct 28, 2024
Feb 21, 2025
Oct 4, 2024
Jan 15, 2025
Feb 24, 2016
Feb 21, 2024
Jan 31, 2025
Jan 29, 2025
Feb 9, 2025
Jan 15, 2025

Repository files navigation

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! πŸ˜ƒ