mirrors/uv
1
0
Fork 0
mirror of https://github.com/astral-sh/uv.git synced 2025-08-04 19:08:04 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 2

Link to persistent configuration options in Python versions document (#6226)

Browse source
This commit is contained in:
Zanie Blue 2024-08-19 14:22:58 -05:00 • committed by GitHub
parent 923dc13617
commit ea3db275a9
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
1 changed files with 12 additions and 5 deletions
Download patch file Download diff file Expand all files Collapse all files

17
docs/concepts/python-versions.md
View file

@ -165,17 +165,24 @@ version download.
By default, uv will automatically download Python versions when needed.
The `python-downloads` option can be used to disable this behavior. By default, it is set to
`automatic`; set to `manual` to only allow Python downloads during `uv python install`.
The [`python-downloads`](../reference/settings.md#python-downloads) option can be used to disable
this behavior. By default, it is set to `automatic`; set to `manual` to only allow Python downloads
during `uv python install`.
!!! tip
The `--python-downloads` option can be passed to any uv command, or it can be set in a
[persistent configuration file](../configuration/files.md) to change the default behavior.
## Adjusting Python version preferences
By default, uv will attempt to use Python versions found on the system and only download managed
interpreters when necessary.
The `python-preference` option can be used to adjust this behavior. By default, it is set to
`managed` which prefers managed Python installations over system Python installations. However,
system Python installations are still preferred over downloading a managed Python version.
The [`python-preference`](../reference/settings.md#python-preference) option can be used to adjust
this behavior. By default, it is set to `managed` which prefers managed Python installations over
system Python installations. However, system Python installations are still preferred over
downloading a managed Python version.
The following alternative options are available: