nox-poetry
nox-poetry
Decision gist · record as of 2026-08-14
Yes. If you use both Poetry and Nox, this package solves a real problem—making Nox respect your lock file so that session dependencies are reproducible and deterministic. Low install friction, active maintenance, no known vulnerabilities, and permissive license. The only gotcha is the installation requirement (must be in the same environment as Nox, and Poetry >= 1.0.0 must be on your system), which is documented and straightforward.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Poetry >= 1.0.0 installed on your system and Python >= 3.9.
- In Poetry >= 2, poetry-plugin-export must be declared as a required plugin in pyproject.toml.
- Low friction: pure Python wheel with four straightforward runtime dependencies (build, nox, packaging, tomlkit).
License · maintenance · safety
MIT (permissive) — MIT permissive license; you can use, modify, and distribute this package freely in commercial and private projects without restriction.
last release 2025-02-25 (535 days) · last repo commit 2026-06-03 · 170 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 131,609 downloads/mo, #11,584 on PyPI
Alternatives
Verify before relying
pip install nox-poetry
from nox_poetry import session
@session(python=["3.10", "3.9"])
def tests(session):
session.install("pytest", ".")
session.run("pytest")- Whether session.poetry utilities (installroot, build_package, export_requirements) are stable or subject to breaking changes.
- Performance impact of Poetry export and wheel-building on session startup time for large projects.
What it is and what it does
nox-poetry is a drop-in replacement for Nox's @session decorator and Session object that makes Nox respect Poetry's lock file when installing packages. Instead of letting pip resolve dependencies fresh each time, it exports Poetry's constraints and uses them to pin versions during installation, ensuring reproducible and deterministic test runs across environments and CI systems.
The package works by intercepting session.install() calls and passing them through Poetry's export mechanism, which generates a constraints file that pip then uses. When you install your own package (via session.install(".")), nox-poetry builds a wheel using Poetry first, then installs that wheel. This approach avoids the pitfalls of editable installs while keeping each session's environment minimal—you only get the dependencies each tool actually needs.
Use it for
- Run tests across Python versions with dependencies pinned by Poetry's lock file, ensuring CI and local results match.
- Install development tools as Poetry dev dependencies and use them in isolated Nox sessions without the full dependency tree.
- Build and test a wheel installation in Nox rather than an editable install, catching packaging mistakes before release.
- Manage reproducible checks across a team by centralizing dependency versions in Poetry's lock file.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
If you use both Poetry and Nox, this package solves a real problem—making Nox respect your lock file so that session dependencies are reproducible and deterministic. Low install friction, active maintenance, no known vulnerabilities, and permissive license. The only gotcha is the installation requirement (must be in the same environment as Nox, and Poetry >= 1.0.0 must be on your system), which is documented and straightforward.
Install
nox-poetry on PyPI
Before you install
Low friction: pure Python wheel with four straightforward runtime dependencies (build, nox, packaging, tomlkit). Must be installed into the same environment as Nox itself—if using pipx for Nox, inject it via pipx inject rather than pip install. Active maintenance with recent release.
Requires Poetry >= 1.0.0 installed on your system and Python >= 3.9. In Poetry >= 2, poetry-plugin-export must be declared as a required plugin in pyproject.toml.
License in practice
MIT permissive license; you can use, modify, and distribute this package freely in commercial and private projects without restriction.
Quickstart
pip install nox-poetry
from nox_poetry import session
@session(python=["3.10", "3.9"])
def tests(session):
session.install("pytest", ".")
session.run("pytest")Verify before relying
- Whether session.poetry utilities (installroot, build_package, export_requirements) are stable or subject to breaking changes.
- Performance impact of Poetry export and wheel-building on session startup time for large projects.
Package facts
| License | MIT permissive |
| Python support | Supports the current Python release >=3.9 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 4 packagesbuildnoxpackagingtomlkit |
| Maintenance | Actively maintained 535 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 131,609 / month, #11,584 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableLicense :: OSI Approved :: MIT LicenseProgramming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.9 |
Evidence: nox_poetry-1.2.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “poetry lock file nox sessions”
- nox-poetryIntegrates Poetry's lock file into Nox sessions, allowing…
- poetryPoetry is a dependency management and packaging tool that replaces…
- poetry-plugin-exportExports Poetry's locked dependency tree to requirements.txt,…
Give your agent the search over MCP, or paste the wish link into any chat.
More Build Tools packages
Provides reusable utilities for Python packaging interoperability, including version handling, specifiers, markers, requirements, tags, and metadata parsing according to standards like PEP 440 and PEP 425.
Wraps any iterable to display a real-time progress bar in the terminal or Jupyter notebook, showing iteration count, elapsed time, and estimated time remaining.
pip is the standard installer for Python packages, enabling you to download and install packages from the Python Package Index and other indexes into your Python environment.
Hatchling is a standards-compliant Python build backend that handles packaging, metadata, and distribution of Python projects when configured in a project's pyproject.toml file.
Generates Python gRPC service stubs and message classes from Protocol Buffer definitions, enabling developers to build gRPC clients and servers.
pre-commit is a framework for installing and running git hooks written in any language before commits are made, automating code quality and validation checks across multi-language projects.
Install it if your team needs consistent, automated validation at commit time.
See also nox-uv · poetry · poetry-plugin-export · poetry-plugin-shell · nox · poetry-core · pip-upgrader · migrate-to-uv · pdm-build-locked · charmcraftlocal