Repolode
wntrblm

wntrblm/nox

一个命令行工具,用标准 Python 文件配置,在多个 Python 环境中自动运行测试。

Star
1,561
Fork
212
未关闭 Issue
81
最近提交
昨天

这是什么?

Nox 是一个命令行工具,可在多个 Python 环境中自动执行测试及其他任务,用途类似 tox。每个会话(session)都是一个带装饰器的 Python 函数,因此测试和代码检查步骤直接用普通 Python 编写,无需单独的配置格式。

每个会话可以在独立的虚拟环境中安装自己的依赖并运行命令。用户可以列出所有会话、按名称运行单个会话,或一次运行全部会话;会话的文档字符串会显示在帮助信息中。

Nox 建议全局安装,例如通过 pipx,而不是装在项目的虚拟环境里。它发布在 PyPI 上,文档托管于 Read the Docs。

核心功能

  • 01用带 @nox.session 装饰器的普通 Python 函数定义测试会话。
  • 02在独立的虚拟环境中运行每个会话,可覆盖多个 Python 版本。
  • 03通过命令行列出会话,运行单个会话或全部会话。
  • 04通过 --usage 选项将会话的文档字符串显示为帮助信息。
  • 05可作为独立命令行工具安装,常用方式是 pipx。

适用场景

  • 为 Python 库在各自独立的环境中分别运行 pytest 和 flake8。
  • 用可自由定制的 Python 文件替代 tox.ini 配置。
  • 用一条命令在多个 Python 解释器版本上测试同一个项目。

快速上手

  1. 1

    使用 pipx 安装 Nox

    pipx install nox
  2. 2

    列出所有可用会话

    nox -l
  3. 3

    运行所有会话

    nox

收录于专题

标签

常见问题

nox 是什么?
一个命令行工具,用标准 Python 文件配置,在多个 Python 环境中自动运行测试。 Nox 是一个命令行工具,可在多个 Python 环境中自动执行测试及其他任务,用途类似 tox。每个会话(session)都是一个带装饰器的 Python 函数,因此测试和代码检查步骤直接用普通 Python 编写,无需单独的配置格式。
nox 可以免费使用吗?用的什么许可证?
nox 以 Apache-2.0 许可证开源。用于商业产品前,请先确认许可证条款。
nox 还在维护吗?
活跃维护中。nox 最近一次提交是在 2026年11月6日。
nox 适合用来做什么?
为 Python 库在各自独立的环境中分别运行 pytest 和 flake8。 用可自由定制的 Python 文件替代 tox.ini 配置。 用一条命令在多个 Python 解释器版本上测试同一个项目。
nox 怎么安装和运行?
使用 pipx 安装 Nox: pipx install nox 列出所有可用会话: nox -l 运行所有会话: nox
在哪里获取 nox?
源代码和安装说明在 GitHub 上:https://github.com/wntrblm/nox

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目