2022.8.7 🧚

We'd like to thank the following folks who contributed to this release:

• @CN-M
• @crwilcox
• @DiddiLeija
• @edgarrmondragon
• @FollowTheProcess
• @hauntsaninja
• @henryiii
• @johnthagen
• @jwodder
• @ktbarrett
• @mayeut
• @meowmeowmeowcat
• @NickleDave
• @raddessi
• @zhanpon

Removals:

• Drop support for Python 3.6 (#526)
• Disable running session.install outside a venv (#580)

New features:

• Official Nox GitHub Action (#594, #606, #609, #620, #629, #637, #632, #633)
• Missing interpreters now error the session on CI by default (#567)
• Allow configurable child shutdown timeouts (#565)
• Add session tags (#627)
• Add short -N alias for --no-reuse-existing-virtualenvs (#639)
• Export session name in NOX_CURRENT_SESSION environment variable (#641)

Improvements:

• Add VENV_DIR to dev session in cookbook (#591)
• Fix typo in tutorial.rst (#586)
• Use consistent spelling for Nox in documentation (#581)
• Support descriptions in tox-to-nox (#575)
• Document that silent=True returns the command output (#578)
• Support argcomplete v2 (#564)

Bugfixes:

• Fix incorrect FileNotFoundError in load_nox_module (#571)

Internal changes:

• Update the classifiers, documentation, and more to point to the new Winterbloom location (#587)
• Support PEP 621 (pyproject.toml) (#616, #619)
• Configure language code to avoid warning on sphinx build (#626)
• Use latest GitHub action runners and include macOS (#613)
• Jazz up the README with some badges/logo etc. (#605, #614)
• Prefer type checking against Jinja2 (#610)
• Introduce GitHub issue forms (#600, #603, #608)
• Full strictness checking on mypy (#595, #596)
• Drop 99% coverage threshold flag for 3.10 in noxfile (#593)
• Create a requirements-dev.txt (#582)
• Use myst-parser for Markdown docs (#561)

2022.1.7 🥳

Claudio Jolowicz, Diego Ramirez, and Tom Fleet have become maintainers of Nox. We'd like to thank the following folks who contributed to this release:

• @brettcannon
• @cjolowicz
• @dhermes
• @DiddiLeija
• @FollowTheProcess
• @franekmagiera
• @henryiii
• @jugmac00
• @maciej-lech
• @nawatts
• @Tolker-KU

New features:

• Add mamba backend (#444, #448, #546, #551)
• Add session.debug to show debug-level messages (#489)
• Add cookbook page to the documentation (#483)
• Add support for the FORCE_COLOR environment variable (#524, #548)
• Allow using session.chdir() as a context manager (#543)
• Deprecate use of session.install() without a valid backend (#537)

Improvements:

• Test against Python 3.10 (#495, $502, #506)
• Add support for the channel option when using the conda backend (#522)
• Show more specific error message when the --keywords expression contains a syntax error (#493)
• Include reference to session.notify() in tutorial page (#500)
• Document how session.run() fails and how to handle failures (#533)
• Allow the list of sessions to be empty (#523)

Bugfixes:

• Fix broken temporary directory when using session.chdir() (#555, #556)
• Set the CONDA_PREFIX environment variable (#538)
• Fix bin directory for the conda backend on Windows (#535)

Internal changes:

• Replace deprecated load_module with exec_module (#498)
• Include tests with source distributions (#552)
• Add missing copyright notices (#509)
• Use the new ReadTheDocs configurations (#527)
• Bump the Python version used by ReadTheDocs to 3.8 (#496)
• Improve the Sphinx config file (#499)
• Update all linter versions (#528)
• Add pre-commit and new checks (#530, #539)
• Check MANIFEST.in during CI (#552)
• Remove redundant LICENSE from MANIFEST.in (#505)
• Make setuptools use the standard library's distutils to work around virtualenv bug. (#547, #549)
• Use shlex.join() when logging a command (#490)
• Use shutil.rmtree() over shelling out to rm -rf in noxfile (#519)
• Fix missing Python 3.9 CI session (#529)
• Unpin docs session and add --error-on-missing-interpreter to CI (#532)
• Enable color output from Nox, pytest, and pre-commit during CI (#542)
• Only run conda_tests session by default if user has conda installed (#521)
• Update dependencies in requirements-conda-test.txt (#536)

2021.10.1 🎃

New features:

• Add session.warn to output warnings (#482)
• Add a shared session cache directory (#476)
• Add session.invoked_from (#472)

Improvements:

• Conda logs now respect nox.options.verbose (#466)
• Add session.notify example to docs (#467)
• Add friendlier message if no noxfile.py is found (#463)
• Show the noxfile.py docstring when using nox -l (#459)
• Mention more projects that use Nox in the docs (#460)

Internal changes:

• Move configs into pyproject.toml or setup.cfg (flake8) (#484)
• Decouple test_session_completer from project level noxfile (#480)
• Run Flynt to convert str.format to f-strings (#464)
• Add python 3.10.0-rc2 to GitHub Actions (#475, #479)
• Simplify CI build (#461)
• Use PEP 517 build system, remove setup.py, use setup.cfg (#456, #457, #458)
• Upgrade to mypy 0.902 (#455)

Special thanks to our contributors:

• @henryiii
• @cjolowicz
• @FollowTheProcess
• @franekmagiera
• @DiddiLeija

2021.6.12

• Fix crash on Python 2 when reusing environments. (#450)
• Hide staleness check behind a feature flag. (#451)
• Group command-line options in --help message by function. (#442)
• Avoid polluting tests with a .nox directory. (#445)

2021.6.6

• Add option --no-install to skip install commands in reused environments. (#432)
• Add option --force-python as shorthand for --python and --extra-python. (#427)
• Do not reuse environments if the interpreter or the environment type has changed. (#418, #425, #428)
• Allow common variations in session names with parameters, such as double quotes instead of single quotes. Session names are considered equal if they produce the same Python AST. (#417, #434)
• Preserve the order of parameters in session names. (#401)
• Allow @nox.parametrize to select the session Python. (#413)
• Allow passing posargs when scheduling another session via session.notify. (#397)
• Prevent sessions from modifying each other's posargs. (#439)
• Add nox.needs_version to specify Nox version requirements. (#388)
• Add session.name to get the session name. (#386)
• Gracefully shutdown child processes. (#393)
• Decode command output using the system locale if UTF-8 decoding fails. (#380)
• Fix creation of Conda environments when venv_params is used. (#420)
• Various improvements to Nox's type annotations. (#376, #377, #378)
• Remove outdated notes on Windows compatibility from the documentation. (#382)
• Increase Nox's test coverage on Windows. (#300)
• Avoid mypy searching for configuration files in other directories. (#402)
• Replace AppVeyor and Travis CI by GitHub Actions. (#389, #390, #403)
• Allow colorlog <7.0.0. (#431)
• Drop contexter from test requirements. (#426)
• Upgrade linters to the latest version. (#438)

2020.12.31

• Fix NoxColoredFormatter.format(#374)
• Use conda remove to clean up existing conda environments (#373)
• Support users specifying an undeclared parametrization of python via --extra-python (#361)
• Support double-digit minor version in python keyword (#367)
• Add py.typed to manifest.in (#360)
• Update nox to latest supported python versions. (#362)
• Decouple merging of --python with nox.options from --sessions and --keywords (#359)
• Do not merge command-line options in place (#357)

2020.8.22

• conda_install and install args are now automatically double-quoted when needed. (#312)
• Offline mode is now auto-detected by default by conda_install. This allows users to continue executing Nox sessions on already installed environments. (#314)
• Fix the default paths for Conda on Windows where the python.exe found was not the correct one. (#310)
• Add the --add-timestamp option (#323)
• Add Session.run_always(). (#331)

2020.5.24

• Add new options for venv_backend, including the ability to set the backend globally. (#326)
• Fix various typos in the documentation. (#325, #326, #281)
• Add session.create_tmp. (#320)
• Place all of Nox's command-line options into argparse groups. (#306)
• Add the --pythons command-line option to allow specifying which versions of Python to run. (#304)
• Add a significant amount of type annotations. (#297, #294, #290, #282, #274)
• Stop building universal wheels since we don't support Python 2. (#293)
• Add the ability to specify additional options for the virtualenv backend using venv_params. (#280)
• Prefer importlib.metadata for metadata loading, removing our dependency on pkg_resources. (#277)
• Add OmegaConf and Hydra to list of projects that use Nox. (#279)
• Use a more accurate error message, along with the cause, if loading of noxfile runs into error. (#272)
• Test against Python 3.8. (#270)
• Fix a syntax highlighting mistake in configuration docs. (#268)
• Use stdout.isatty to finalize color instead of stdin.isatty. (#267)

2019.11.9

• Fix example installation call for pip. (#259)
• Allow colorlog 4. (#257)
• Order Pythons in descending version in appveyor.yml. (#258)
• Add link to GitHub Action for Nox. (#255)
• Use double "`" for inline code. (#254)
• Add types to _option_set.py. (#249)
• Add type hints to tasks.py. (#241)
• Fix typo (virtulenvs). (#247)
• Replace flake8 sorter with isort. (#242)
• Pass VIRTUAL_ENV environment variable to commands executed in a virtualenv. (#245)
• Fix docs to show correct list for parametrize. (#244)
• Add argcomplete dependency to conda test session. (#240)

2019.8.20

• Add interactive property to session. (#196)
• Promote contributors to maintainers, add Open Collective details. (#201)
• Fix funding external link. (#200)
• Refactor how Nox defines and process options. (#187)
• Fix typo in tutorial. (#194)
• Use 'pytest' instead of 'py.test' in examples and configuration. (#193)
• Fix some CSS issues on mobile. (#192)
• Use short form of virtualenv path when creating the virtualenv. (#191)
• Refresh tutorial and fixup small docs things. (#190)
• Add the ability to give parametrized sessions a custom ID. (#186)
• Make --list list all available sessions, not just the selected ones. (#185)
• Allow providing a friendlier CLI name to sessions. (#170)
• Add urllib3 to the list of projects that use Nox (#182)
• Fix documentation link for Docker Cloud vs Hub (#179)