Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly
Appearance settings

Document support for free-threaded and debug Python versions #15961

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 6 commits into from
Sep 22, 2025
Merged

Document support for free-threaded and debug Python versions #15961

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
cf86432
Document support for free-threaded and debug Python versions
zanieb Sep 20, 2025
5b1a606
Update docs/concepts/python-versions.md
zanieb Sep 22, 2025
2d64691
Update docs/concepts/python-versions.md
zanieb Sep 22, 2025
5e3c973
Add note
zanieb Sep 22, 2025
1e6d93a
Fix note
zanieb Sep 22, 2025
b52da6c
Reset lockfile
zanieb Sep 22, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Prev Previous commit
Next Next commit
Add note
  • Loading branch information
@zanieb
zanieb committed Sep 22, 2025
commit 5e3c973328c381754c540bc12310f1daef88bd22
20 changes: 10 additions & 10 deletions 20 Cargo.lock
View file
Open in desktop

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

13 changes: 10 additions & 3 deletions 13 docs/concepts/python-versions.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -330,16 +330,23 @@ Python version instead.

## Free-threaded Python

uv supports discovering and installing [free-threaded](https://docs.python.org/3.14/glossary.html#term-free-threading) Python variants in CPython 3.13+.
uv supports discovering and installing
[free-threaded](https://docs.python.org/3.14/glossary.html#term-free-threading) Python variants in
CPython 3.13+.

Free-threaded Python versions will not be selected by default. Free-threaded Python versions will
only be selected when explicitly requested, e.g., with `3.13t` or `3.13+freethreaded`.

## Debug Python variants

uv supports discovering and installing [debug builds](https://docs.python.org/3.14/using/configure.html#debug-build) of Python, i.e., with debug assertions enabled.
uv supports discovering and installing
[debug builds](https://docs.python.org/3.14/using/configure.html#debug-build) of Python, i.e., with
debug assertions enabled. These builds also do not have debug symbols stripped, which can be useful
when debugging a Python process with a C-level debugger.
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is less accurate than the phrasing I suggested :) As I understand it, uv will both discover existing --with-pydebug builds on the system (e.g. dnf install python3.14-debug, which gets you a /usr/bin/python3.14d), and install our own managed versions, and in both cases it will only use them if it cannot find a non-debug version. But the lack of stripping of debug symbols only applies to our own debug builds and may not apply to existing discoverable versions. (And it also only applies for now, I would like to do something else about debug symbols in the future.)

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

These are all great reasons not to say this at all imo, it's too complicated :)

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I changed it.


Debug builds of Python are slower and are not appropriate for general use.
!!! important

Debug builds of Python are slower and are not appropriate for general use.

Debug builds will be used if there is no other available installation matching the request. For
example, if only a debug version is available it will be used but otherwise a stable release version
Expand Down
Loading
Morty Proxy This is a proxified and sanitized view of the page, visit original site.