Features

• Expose the selected interpreter's dependency marker values as PythonInfo.marker_environment (#178) by @gaborbernat.

PyPI release

Full Changelog

Features

• Accept the free-threaded, debug, architecture and machine suffixes after a version specifier, as in >=3.13t or cpython>=3.11,<3.14-64, and raise ValueError for a spec that starts with a comparison operator but does not parse, such as >=3.13., instead of looking it up as an executable name (#176) by @gaborbernat. (#175)

Bug fixes

• Stop a .python-version file that is not valid UTF-8, or that cannot be read, from aborting discovery through a pyenv, mise or asdf shim; a stray byte no longer hides the versions it names, and an unreadable file is skipped like a missing one (#173) by @darrenhuai and @gaborbernat.

Documentation

• Link every documentation page to its source and edit view on GitHub, and add a GitHub icon to the footer (#177) by @gaborbernat. (#174)

PyPI release

Full Changelog

Bug fixes

• Rank uv's minor version links behind the concrete install on Windows too, where uv creates them as directory junctions that Path.is_symlink() does not report (#170) by @darrenhuai and @gaborbernat.
• Stop a venv lookup from rewriting the executable of earlier results, PythonInfo.current() and PythonInfo.current_system() when they share its base interpreter (#171) by @darrenhuai and @gaborbernat.

PyPI release

Full Changelog

Bug fixes

• Treat version specifiers with an item that cannot be parsed, such as >=3.x, >=3.12 <4 or >=3.12,foo, as literal executable paths instead of raising a bare AssertionError or ignoring the item during discovery (#157) by @darrenhuai and @gaborbernat.
• Accept relative interpreter paths that step up a directory, such as ../venv/bin/python, which were found and queried but never matched the spec (#158) by @darrenhuai and @gaborbernat.
• Match ~=X.Y compatible-release specifiers against later minor versions, as PEP 440 defines, instead of only the same minor; ~=3.10 now accepts 3.11 and newer 3.x (#159) by @darrenhuai and @gaborbernat.

🐍 PyPI release

📜 Full Changelog

Packaging

• Releases now run on the shared tox-dev/github-workflows pipeline, with a locked release toolchain and generated GitHub Release notes (#164) by @gaborbernat.

🐍 PyPI release

📜 Full Changelog

Documentation

• Clarify the executable paths accepted by try_first_with in the standalone usage example. (#150) by @travisfortney.

New Contributors

• @travisfortney made their first contribution in #150

🐍 PyPI release

📜 Full Changelog

Bug fixes

• Treat specs with dot-only version components, such as python., as literal executable paths instead of raising IndexError by @harbinresearcher and @gaborbernat. (#147)
• Pass PEP 514 ExecutableArguments to registered Windows interpreters when querying them, so a registration that points at a launcher such as py.exe -3.11 reports the interpreter it selects by @blouirts123 and @gaborbernat. (#148)

New Contributors

• @harbinresearcher made their first contribution in #147
• @blouirts123 made their first contribution in #148

🐍 PyPI release

📜 Full Changelog

Features

• Require Python 3.9 or newer for installation while still discovering Python 3.6 and 3.7 interpreters (#142) by @gaborbernat.

Bug fixes

• Discard malformed interpreter cache entries and query the interpreter again, including entries with missing, non-string or unusable system_executable paths by @darrenhuai and @gaborbernat. (#141)
• Use the default interpreter query timeout and warn for invalid PY_DISCOVERY_TIMEOUT values. Accept inf or values above the subprocess wait limit to disable the timeout by @darrenhuai and @gaborbernat. (#143)

New Contributors

• @darrenhuai made their first contribution in #141

🐍 PyPI release

📜 Full Changelog

Bug fixes

• Skip empty PATH entries during interpreter discovery by @gaborbernat. (#132)

Documentation

• Document system_exe across the tutorial, the how-to guide and the explanation of how resolution reaches a base interpreter. The class diagram in the how-to guide had system_executable typed str rather than str | None by @gaborbernat. (#128)

🐍 PyPI release

📜 Full Changelog