Nox

This release improves PEP 723 support, including adding dependencies to the noxfile itself ("plugins"). It adds the long-awaited "requires" option, allowing sessions to require other sessions. And it brings further improvements to the `pyproject.toml` support, including helpers for dependency-groups and Python version lists.

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

* btemplep (first contribution)
* chirizxc (first contribution)
* davidhewitt (first contribution)
* gschaffner (first contribution)
* henryiii
* oliversen (first contribution)

New features:

* Support PEP 723 noxfiles by henryiii in https://github.com/wntrblm/nox/pull/881
* Expose main as `nox.main` by henryiii in https://github.com/wntrblm/nox/pull/878 (followup fix: https://github.com/wntrblm/nox/pull/884)
* Support session dependencies (`requires`) by gschaffner in https://github.com/wntrblm/nox/pull/631
* Helper to get dependency-groups by henryiii in https://github.com/wntrblm/nox/pull/876
* Helper to get the Python listing by henryiii in https://github.com/wntrblm/nox/pull/877
* Add a `"pyproject.toml"` default for `load_toml` by henryiii in https://github.com/wntrblm/nox/pull/917

Bugfixes:

* Correct virtualenv bin dir under mingw python by davidhewitt in https://github.com/wntrblm/nox/pull/901
* Allow `pypy-*` to be used as well for `pypy*` (matching GHA) by henryiii in https://github.com/wntrblm/nox/pull/913
* Don't trigger a background update process for virtualenv by henryiii in https://github.com/wntrblm/nox/pull/918
* Include encoding for consistent behavior (default in Python 3.15+) by henryiii in https://github.com/wntrblm/nox/pull/891
* Outer env issues fixed by henryiii in https://github.com/wntrblm/nox/pull/874
* Support noxfile being a symlink by henryiii in https://github.com/wntrblm/nox/pull/829
* Drop PyPy from the default list for the GitHub Action by henryiii in https://github.com/wntrblm/nox/pull/916

Bugfixes related to uv support:

* Catch `PermissionError` from popen when UV is not installed by btemplep in https://github.com/wntrblm/nox/pull/908
* Use `uv python install` only with uv backend by oliversen in https://github.com/wntrblm/nox/pull/900
* Handle `"uvx"` like `"uv"` by henryiii in https://github.com/wntrblm/nox/pull/920
* Support broken uv (via pyenv) by henryiii in https://github.com/wntrblm/nox/pull/922

Tox-to-nox script:

* Drop support for tox 3 by henryiii in https://github.com/wntrblm/nox/pull/910
* Switch pkgutil for importlib-resources by henryiii in https://github.com/wntrblm/nox/pull/887
* Correctly separate command-line arguments by chirizxc in https://github.com/wntrblm/nox/pull/906

Improved noxfile validation:

* Error if invalid `reuse_venv` set by henryiii in https://github.com/wntrblm/nox/pull/872
* Error with helpful message if invalid option is set via `nox.options` by henryiii in https://github.com/wntrblm/nox/pull/871 (followup fix: https://github.com/wntrblm/nox/pull/921)
* Validate entries in `nox.config`, too, using attrs by henryiii in https://github.com/wntrblm/nox/pull/880

Internal changes:

* Add more Ruff checks and fixes by henryiii in https://github.com/wntrblm/nox/pull/893
* Cleanup symlink noxfile code by henryiii in https://github.com/wntrblm/nox/pull/865
* Drop some type ignores for colorlog by henryiii in https://github.com/wntrblm/nox/pull/888
* Limit the visible items for tab completion by henryiii in https://github.com/wntrblm/nox/pull/889
* More typing and test improvements by henryiii in https://github.com/wntrblm/nox/pull/890
* Some extra simplifications from Ruff by henryiii in https://github.com/wntrblm/nox/pull/870
* Use dependency-groups by henryiii in https://github.com/wntrblm/nox/pull/873
* Pull out env creation into helper method by henryiii in https://github.com/wntrblm/nox/pull/912
* Pulled out `get_virtualenv` & better typing by henryiii in https://github.com/wntrblm/nox/pull/882
* Fix broken mock on CPython 3.12.8+ in tests by henryiii in https://github.com/wntrblm/nox/pull/903
* Statically type tests by henryiii in https://github.com/wntrblm/nox/pull/894
* Use `tmp_path` instead of `tmpdir` in tests by henryiii in https://github.com/wntrblm/nox/pull/895

This release adds explicit support for Python 3.13 and drops support for running Nox itself under Python 3.7. Note that you can still use 3.7 in your Nox sessions, we just dropped support for installing & running `nox` itself in 3.7.

We'd like to thank the following folks who contributed to this release:
- edgarrmondragon
- ember91
- henryiii
- hmd101
- KasperZutterman
- living180
- mayeut
- saucoide
- Wurstnase

New features:
* Allow setting tags on parametrized sessions by living180 in https://github.com/wntrblm/nox/pull/832
* Added support for `uv`-installed pythons by saucoide in https://github.com/wntrblm/nox/pull/842
* Added `session.install_and_run_script` by henryiii in https://github.com/wntrblm/nox/pull/847

Bugfixes:
* Updated type annotation of `stderr` parameter to make it optional by edgarrmondragon in https://github.com/wntrblm/nox/pull/835
* Removed `add_timestamp` from `noxfile.options` by Wurstnase in https://github.com/wntrblm/nox/pull/856

Documentation:
* Added warning about uv and local packages by henryiii in https://github.com/wntrblm/nox/pull/830
* Fixed contribution guidelines by Wurstnase in https://github.com/wntrblm/nox/pull/850
* Fixed typos by ember91 in https://github.com/wntrblm/nox/pull/839
* Fixed typoss in cookbook by hmd101 in https://github.com/wntrblm/nox/pull/837
* Added missing cookbook recipe snippet imports by KasperZutterman in https://github.com/wntrblm/nox/pull/853
* Cleaned up `dev` recipe by henryiii in https://github.com/wntrblm/nox/pull/862
* Added note about `uv reinstall` by henryiii in https://github.com/wntrblm/nox/pull/863
* Added `uv sync` example by henryiii in https://github.com/wntrblm/nox/pull/864

Internal changes:
* Use default action tests for macos-14 by mayeut in https://github.com/wntrblm/nox/pull/824
* Added 3.13 to the action defaults by henryiii in https://github.com/wntrblm/nox/pull/846
* Dropped Python 3.7 by henryiii in https://github.com/wntrblm/nox/pull/822
* Included 3.13 in classifiers by henryiii in https://github.com/wntrblm/nox/pull/851
* Use `uv` if available in action by henryiii in https://github.com/wntrblm/nox/pull/831
* Run tests with Python 3.13 by edgarrmondragon in https://github.com/wntrblm/nox/pull/834
* Updated `macos-latest` to `macos-14` by henryiii in https://github.com/wntrblm/nox/pull/821
* Use `miniforge` by henryiii in https://github.com/wntrblm/nox/pull/854
* Use `astral-sh/setup-uv` by henryiii in https://github.com/wntrblm/nox/pull/859
* Dropped PyPy 3.9 from test matrix by henryiii in https://github.com/wntrblm/nox/pull/858

We'd like to thank the following folks who contributed to this release:
- cjolowicz
- henryiii
- mayeut

New features:
* Added support for [PEP 723](https://peps.python.org/pep-0723/) (inline script metadata) with `nox.project.load_toml` by henryiii in https://github.com/wntrblm/nox/pull/811
* Added support for `micromamba` by henryiii in https://github.com/wntrblm/nox/pull/807
* Added `venv_backend` property to sessions by henryiii in https://github.com/wntrblm/nox/pull/798
* Added the ability to use `None` to remove environment variables by henryiii in https://github.com/wntrblm/nox/pull/812
* Added support for skipping sessions by default using `default=False` by henryiii in https://github.com/wntrblm/nox/pull/810

Bugfixes:
* Use static arguments instead of `**kwargs` by henryiii in https://github.com/wntrblm/nox/pull/815
* Do not depend on `pipx` in Nox GitHub action by mayeut in https://github.com/wntrblm/nox/pull/768
* Disallow `UV_SYSTEM_PYTHON` by henryiii in https://github.com/wntrblm/nox/pull/817
* Ensure 'uv' always works in a uv venv by henryiii in https://github.com/wntrblm/nox/pull/818
* Look for `uv` next to `python` if it's not on `PATH` by cjolowicz in https://github.com/wntrblm/nox/pull/795
* Fixed missing f-string in `--help` message by cjolowicz in https://github.com/wntrblm/nox/pull/790
* Don't error if not installing to passthrough by henryiii in https://github.com/wntrblm/nox/pull/809
* Avoid mixing `venv` and `conda` from environment by henryiii in https://github.com/wntrblm/nox/pull/804
* Skip test for conda env when `conda` isn't installed by cjolowicz in https://github.com/wntrblm/nox/pull/794

We'd like to thank the following folks who contributed to this release:
- DiddiLeija
- MicaelJarniac
- chrysle
- edgarrmondragon
- fazledyn-or
- franekmagiera
- frenzymadness
- henryiii
- johnthagen
- mayeut
- patrick91
- q0w
- samypr100
- scop
- stasfilin
- stefanv

New Features:
* Add `uv` backend by henryiii in https://github.com/wntrblm/nox/pull/762
* Add venv backend fallback by henryiii in https://github.com/wntrblm/nox/pull/787
* Add option `--reuse-venv {yes,no,never,always}` by samypr100 in https://github.com/wntrblm/nox/pull/730
* Add environment variable `NOX_DEFAULT_VENV_BACKEND` for default backend by edgarrmondragon in https://github.com/wntrblm/nox/pull/780
* Rename `session.run_always` to `session.run_install` by henryiii in https://github.com/wntrblm/nox/pull/770
* Add more option argument completions by scop in https://github.com/wntrblm/nox/pull/707
* Implement `tox-to-nox` for tox 4 by frenzymadness in https://github.com/wntrblm/nox/pull/687
* Allow `--force-python` on unparametrized sessions by chrysle in https://github.com/wntrblm/nox/pull/756
* Add `include_outer_env` parameter to `session.run` and friends by franekmagiera in https://github.com/wntrblm/nox/pull/652
* GitHub Action: Add support for the `~` version specifier by mayeut in https://github.com/wntrblm/nox/pull/712

Bugfixes:
* Rebuild environment when changing to an incompatible backend type by henryiii in https://github.com/wntrblm/nox/pull/781
* Warn user when first argument to `session.run` is a list by stefanv in https://github.com/wntrblm/nox/pull/786
* Allow overriding `nox.options.sessions` with `--tags` by q0w in https://github.com/wntrblm/nox/pull/684
* Allow overriding `NO_COLOR` with `--force-color` by stasfilin in https://github.com/wntrblm/nox/pull/723
* Fix `nox.options.error_on_missing_interpreters` when running in CI by samypr100 in https://github.com/wntrblm/nox/pull/725

Documentation Improvements:
* Create an official Nox badge by johnthagen in https://github.com/wntrblm/nox/pull/714 and https://github.com/wntrblm/nox/pull/715
* Add recipe for generating a matrix with GitHub Actions by henryiii in https://github.com/wntrblm/nox/pull/696
* Update some links by henryiii in https://github.com/wntrblm/nox/pull/774

Internal Changes:
* fix: always pull versions from metadata by henryiii in https://github.com/wntrblm/nox/pull/782
* chore: ruff moved to astral-sh by henryiii in https://github.com/wntrblm/nox/pull/722
* Use double quotes instead of single in github actions examples by patrick91 in https://github.com/wntrblm/nox/pull/724
* tests: fixes when running locally by henryiii in https://github.com/wntrblm/nox/pull/721
* chore: modernize Ruff config, bump pre-commit by henryiii in https://github.com/wntrblm/nox/pull/744
* chore(deps): bump actions/checkout from 3 to 4 by dependabot in https://github.com/wntrblm/nox/pull/738
* chore: ruff-format by henryiii in https://github.com/wntrblm/nox/pull/745
* chore(action): update default python-versions by mayeut in https://github.com/wntrblm/nox/pull/767
* chore(ci): allow manual runs on branches without a PR by mayeut in https://github.com/wntrblm/nox/pull/766
* chore(ci): bump actions/setup-python & conda-incubator/setup-miniconda by mayeut in https://github.com/wntrblm/nox/pull/765
* ci: group dependabot updates by henryiii in https://github.com/wntrblm/nox/pull/755
* fix(types): improve typing by henryiii in https://github.com/wntrblm/nox/pull/720
* ci: fix coverage combine for different OS's by henryiii in https://github.com/wntrblm/nox/pull/778
* ci: update to artifacts v2 by henryiii in https://github.com/wntrblm/nox/pull/772
* ci: remove skipped job & combine (faster) by henryiii in https://github.com/wntrblm/nox/pull/771
* chore: cleanup Ruff a bit by henryiii in https://github.com/wntrblm/nox/pull/783
* chore(deps): bump the actions group with 2 updates by dependabot in https://github.com/wntrblm/nox/pull/784
* style: add type hints, update few functions by stasfilin in https://github.com/wntrblm/nox/pull/728
* Include Python 3.12 in GHA by DiddiLeija in https://github.com/wntrblm/nox/pull/743
* Allow tests to pass in environments where NO_COLOR=1 is set by edgarrmondragon in https://github.com/wntrblm/nox/pull/777
* tests: support running when the Python launcher for UNIX is present by henryiii in https://github.com/wntrblm/nox/pull/775
* chore: drop unneeded config option by henryiii in https://github.com/wntrblm/nox/pull/773
* Bump minimum virtualenv to 20.14.1 by johnthagen in https://github.com/wntrblm/nox/pull/747
* chore: save session name in `Func` by MicaelJarniac in https://github.com/wntrblm/nox/pull/718
* Removed the problematic Python 2.7.18 version by stasfilin in https://github.com/wntrblm/nox/pull/726
* Fixed Improper Method Call: Replaced `NotImplementedError` by fazledyn-or in https://github.com/wntrblm/nox/pull/749

We'd like to thank the following folks who contributed to this release:
- crwilcox
- dcermak
- edgarrmondragon
- FollowTheProcess
- henryiii
- reaperhulk
- scop

New Features:
- Add support for `NOXPYTHON`, `NOXEXTRAPYTHON` and `NOXFORCEPYTHON` by edgarrmondragon in https://github.com/wntrblm/nox/pull/688
- feat: --json --list-sessions by henryiii in https://github.com/wntrblm/nox/pull/665

Documentation Improvements:
- style: spelling and grammar fixes by scop in https://github.com/wntrblm/nox/pull/682
- Add invite link to the discord server to CONTRIBUTING.md by dcermak in https://github.com/wntrblm/nox/pull/679

Internal Changes:
- chore: update pre-commit hooks by edgarrmondragon in https://github.com/wntrblm/nox/pull/690
- chore: move to using Ruff by henryiii in https://github.com/wntrblm/nox/pull/691
- Fix assertion in GHA tests by FollowTheProcess in https://github.com/wntrblm/nox/pull/670
- ci: some minor fixes by henryiii in https://github.com/wntrblm/nox/pull/675
- Constrain tox to <4.0.0 and minor fixes by FollowTheProcess in https://github.com/wntrblm/nox/pull/677
- chore: long term fix for bugbear opinionated checks by henryiii in https://github.com/wntrblm/nox/pull/678
- chore: switch to hatchling by henryiii in https://github.com/wntrblm/nox/pull/659
- Don't run python 2.7 virtualenv tests for newer versions of virtualenv by crwilcox in https://github.com/wntrblm/nox/pull/702
- allow the use of argcomplete 3 by reaperhulk in https://github.com/wntrblm/nox/pull/700
- fix: enable `list_sessions` for session completion by scop in https://github.com/wntrblm/nox/pull/699
- chore: remove 3.6 tests, min version is 3.7 by crwilcox in https://github.com/wntrblm/nox/pull/703

We'd like to thank the following folks who contributed to this release:
- airtower-luna
- DiddiLeija
- FollowTheProcess
- henryiii
- hynek
- Julian
- nhtsai
- paw-lu

New features:
- Include Python 3.11 classifier & testing (655)

Improvements:
- Fixed a few typos (661, 660)
- Drop dependency on `py` (647)
- `nox.session.run` now accepts a `pathlib.Path` for the command (649)
- Document `nox.session.run`'s `stdout` and `stderr` arguments and add example of capturing output (651)

Bugfixes:
- GitHub Action: replace deprecated set-output command (668)
- GitHub Action: point docs to 2022.8.7 not latest (664)
- Docs: fix argument passing in `session.posargs` example (653)
- Include GitHub action helper in `MANIFEST.in` (645)

Internal changes:
- GitHub Action: move to 3.11 final (667)
- Cleanup Python 2 style code (657)
- Update tools used in pre-commit (646, 656)