Python
/
uv
mirror of https://github.com/astral-sh/uv
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
uv/crates
History
Meitar Reihan 2b62f73064
Add `UV_PYTHON_DOWNLOADS_JSON_URL` to set custom managed python sources (#10939) 
## Summary

Add an option to overwrite the list of available Python downloads from a
local JSON file by using the environment variable
`UV_PYTHON_DOWNLOADS_JSON_URL`

as an experimental support for providing custom sources for Python
distribution binaries #8015

related #10203

I probably should make the JSON to be fetched from a remote URL instead
of a local file.
please let me know what you think and I will modify the code
accordingly.

## Test Plan

### normal run
```
root@75c66494ba8b:/# /code/target/release/uv python list
cpython-3.14.0a4+freethreaded-linux-x86_64-gnu    <download available>
cpython-3.14.0a4-linux-x86_64-gnu                 <download available>
cpython-3.13.1+freethreaded-linux-x86_64-gnu      <download available>
cpython-3.13.1-linux-x86_64-gnu                   <download available>
cpython-3.12.8-linux-x86_64-gnu                   <download available>
cpython-3.11.11-linux-x86_64-gnu                  <download available>
cpython-3.10.16-linux-x86_64-gnu                  <download available>
cpython-3.9.21-linux-x86_64-gnu                   <download available>
cpython-3.8.20-linux-x86_64-gnu                   <download available>
cpython-3.7.9-linux-x86_64-gnu                    <download available>
pypy-3.10.14-linux-x86_64-gnu                     <download available>
pypy-3.9.19-linux-x86_64-gnu                      <download available>
pypy-3.8.16-linux-x86_64-gnu                      <download available>
pypy-3.7.13-linux-x86_64-gnu                      <download available>
```

### empty JSON file
```sh
root@75c66494ba8b:/# export UV_PYTHON_DOWNLOADS_JSON_URL=/code/crates/uv-python/my-download-metadata.json 
root@75c66494ba8b:/# cat $UV_PYTHON_DOWNLOADS_JSON_URL 
{}
root@75c66494ba8b:/# /code/target/release/uv python list
root@75c66494ba8b:/# 
```

### JSON file with valid version
```sh
root@75c66494ba8b:/# export UV_PYTHON_DOWNLOADS_JSON_URL=/code/crates/uv-python/my-download-metadata.json 
root@75c66494ba8b:/# cat $UV_PYTHON_DOWNLOADS_JSON_URL 
{
  "cpython-3.11.9-linux-x86_64-gnu": {
    "name": "cpython",
    "arch": {
      "family": "x86_64",
      "variant": null
    },
    "os": "linux",
    "libc": "gnu",
    "major": 3,
    "minor": 11,
    "patch": 9,
    "prerelease": "",
    "url": "https://github.com/astral-sh/python-build-standalone/releases/download/20240814/cpython-3.11.9%2B20240814-x86_64-unknown-linux-gnu-install_only_stripped.tar.gz",
    "sha256": "daa487c7e73005c4426ac393273117cf0e2dc4ab9b2eeda366e04cd00eea00c9",
    "variant": null
  }
}
root@75c66494ba8b:/# /code/target/release/uv python list
cpython-3.11.9-linux-x86_64-gnu    <download available>
root@75c66494ba8b:/# 
```

### Remote Path

```sh
root@75c66494ba8b:/# export UV_PYTHON_DOWNLOADS_JSON_URL=http://a.com/file.json 
root@75c66494ba8b:/# /code/target/release/uv python list
error: Remote python downloads JSON is not yet supported, please use a local path (without `file://` prefix)
```

---------

Co-authored-by: Aria Desires <aria.desires@gmail.com>
 		2025-04-07 13:55:00 -04:00
..
uv Add `UV_PYTHON_DOWNLOADS_JSON_URL` to set custom managed python sources (#10939) 2025-04-07 13:55:00 -04:00
uv-auth Use `Credentials` abstraction in `uv-publish` (#12682) 2025-04-04 19:07:51 -04:00
uv-bench Omit wheels from lockfile based on `--exclude-newer` (#12299) 2025-03-22 12:27:11 -04:00
uv-build Bump to 0.6.12 (#12637) 2025-04-02 15:22:15 -05:00
uv-build-backend Bump MSRV to 1.84 (#12670) 2025-04-04 11:49:26 -04:00
uv-build-frontend Bump MSRV to 1.84 (#12670) 2025-04-04 11:49:26 -04:00
uv-cache Use `Box<Path>` in lieu of `PathBuf` for immutable structs (#12346) 2025-03-25 21:56:06 +00:00
uv-cache-info Avoid allocations for default cache keys (#12063) 2025-03-17 19:59:32 -04:00
uv-cache-key Use hash instead of full wheel name in wheels bucket (#11738) 2025-02-26 22:41:57 +00:00
uv-cli Add `--show-version` to `uv python find` (#12376) 2025-04-03 08:34:45 -05:00
uv-client Bump MSRV to 1.84 (#12670) 2025-04-04 11:49:26 -04:00
uv-configuration fix parsing of `python-platform` in settings tomls (#12592) 2025-04-01 09:08:35 -04:00
uv-console Bump MSRV to 1.84 (#12670) 2025-04-04 11:49:26 -04:00
uv-dev Bump MSRV to 1.84 (#12670) 2025-04-04 11:49:26 -04:00
uv-dirs Add support for global `uv python pin` (#12115) 2025-03-13 13:48:37 +01:00
uv-dispatch Move lowered requirement source type out of `uv-pypi-types` (#12356) 2025-03-20 21:16:12 -04:00
uv-distribution respect --offline flag for git cli operations (#12619) 2025-04-04 11:02:54 -05:00
uv-distribution-filename Bump MSRV to 1.84 (#12670) 2025-04-04 11:49:26 -04:00
uv-distribution-types Bump MSRV to 1.84 (#12670) 2025-04-04 11:49:26 -04:00
uv-extract only warn if CRC appears to be missing (#12722) 2025-04-07 12:49:05 -05:00
uv-fs Bump MSRV to 1.84 (#12670) 2025-04-04 11:49:26 -04:00
uv-git respect --offline flag for git cli operations (#12619) 2025-04-04 11:02:54 -05:00
uv-git-types Bump MSRV to 1.84 (#12670) 2025-04-04 11:49:26 -04:00
uv-globfilter Bump MSRV to 1.84 (#12670) 2025-04-04 11:49:26 -04:00
uv-install-wheel Remove unused `thiserror` variants (#11713) 2025-02-22 12:12:22 -10:00
uv-installer Bump MSRV to 1.84 (#12670) 2025-04-04 11:49:26 -04:00
uv-macros Remove unnecessary prefixes (#10158) 2024-12-25 14:18:01 -05:00
uv-metadata only warn if CRC appears to be missing (#12722) 2025-04-07 12:49:05 -05:00
uv-normalize add `default-groups = "all"` sugar to `pyproject.toml` (#12289) 2025-03-18 13:42:06 -05:00
uv-once-map Bump MSRV to 1.84 (#12670) 2025-04-04 11:49:26 -04:00
uv-options-metadata Upgrade minimum Rust version to 1.83 (#9815) 2024-12-11 10:06:19 -06:00
uv-pep440 Use consistent commas around i.e. and e.g. (#12157) 2025-03-13 23:42:10 +00:00
uv-pep508 Bump MSRV to 1.84 (#12670) 2025-04-04 11:49:26 -04:00
uv-performance-memory-allocator Update Rust crate mimalloc to v0.1.45 (#12704) 2025-04-07 10:01:04 -04:00
uv-platform-tags Fix GraalPy abi tag parsing and discovery (#12154) 2025-03-13 23:55:07 +00:00
uv-publish Use `Credentials` abstraction in `uv-publish` (#12682) 2025-04-04 19:07:51 -04:00
uv-pypi-types Bump MSRV to 1.84 (#12670) 2025-04-04 11:49:26 -04:00
uv-python Add `UV_PYTHON_DOWNLOADS_JSON_URL` to set custom managed python sources (#10939) 2025-04-07 13:55:00 -04:00
uv-requirements Use a boxed slice for various requirement types (#12514) 2025-03-27 17:09:26 -04:00
uv-requirements-txt Move lowered requirement source type out of `uv-pypi-types` (#12356) 2025-03-20 21:16:12 -04:00
uv-resolver Bump MSRV to 1.84 (#12670) 2025-04-04 11:49:26 -04:00
uv-scripts Avoid writing empty `requires-python` to script blocks (#12517) 2025-03-28 10:26:51 -04:00
uv-settings Enable necessary optional features in `uv-settings` (#12504) 2025-03-27 02:30:00 +00:00
uv-shell Add support for Windows legacy scripts via uv tool run (#12079) 2025-03-11 09:02:17 -05:00
uv-small-str Edition 2024 prep: Escape `r#gen` and remove redundant ref (#11922) 2025-03-03 11:13:56 +00:00
uv-state Add `uv-dirs` to consolidate directory lookup methods (#8453) 2024-10-22 11:33:25 -05:00
uv-static Add `UV_PYTHON_DOWNLOADS_JSON_URL` to set custom managed python sources (#10939) 2025-04-07 13:55:00 -04:00
uv-tool Move lowered requirement source type out of `uv-pypi-types` (#12356) 2025-03-20 21:16:12 -04:00
uv-torch Check all compatible torch indexes when `--torch-backend` is enabled (#12385) 2025-03-22 11:53:23 -04:00
uv-trampoline Upgrade Rust toolchain to 1.85 (#11720) 2025-02-23 16:52:34 +01:00
uv-trampoline-builder Upgrade zip crate to v2 (#12196) 2025-03-16 23:58:11 +00:00
uv-types Use a boxed slice for extras and groups (#12391) 2025-03-22 11:53:36 -04:00
uv-version Bump to 0.6.12 (#12637) 2025-04-02 15:22:15 -05:00
uv-virtualenv Bump MSRV to 1.84 (#12670) 2025-04-04 11:49:26 -04:00
uv-warnings chore: Move all integration tests to a single binary (#8093) 2024-10-11 16:41:35 +02:00
uv-workspace Bump MSRV to 1.84 (#12670) 2025-04-04 11:49:26 -04:00
README.md Link to Dependency specifiers instead of PEP 508 (#8411) 2024-10-21 14:43:38 -04:00

README.md

Crates

uv-bench

Functionality for benchmarking uv.

uv-cache-key

Generic functionality for caching paths, URLs, and other resources across platforms.

uv-distribution-filename

Parse built distribution (wheel) and source distribution (sdist) filenames to extract structured metadata.

uv-distribution-types

Abstractions for representing built distributions (wheels) and source distributions (sdists), and the sources from which they can be downloaded.

uv-install-wheel-rs

Install built distributions (wheels) into a virtual environment.

uv-once-map

A waitmap-like concurrent hash map for executing tasks exactly once.

uv-pep440-rs

Utilities for interacting with Python version numbers and specifiers.

uv-pep508-rs

Utilities for parsing and evaluating dependency specifiers, previously known as PEP 508.

uv-platform-tags

Functionality for parsing and inferring Python platform tags as per PEP 425.

uv-cli

Command-line interface for the uv package manager.

uv-build-frontend

A PEP 517-compatible build frontend for uv.

uv-cache

Functionality for caching Python packages and associated metadata.

uv-client

Client for interacting with PyPI-compatible HTTP APIs.

uv-dev

Development utilities for uv.

uv-dispatch

A centralized struct for resolving and building source distributions in isolated environments. Implements the traits defined in uv-types.

uv-distribution

Client for interacting with built distributions (wheels) and source distributions (sdists). Capable of fetching metadata, distribution contents, etc.

uv-extract

Utilities for extracting files from archives.

uv-fs

Utilities for interacting with the filesystem.

uv-git

Functionality for interacting with Git repositories.

uv-installer

Functionality for installing Python packages into a virtual environment.

uv-python

Functionality for detecting and leveraging the current Python interpreter.

uv-normalize

Normalize package and extra names as per Python specifications.

uv-requirements

Utilities for reading package requirements from pyproject.toml and requirements.txt files.

uv-resolver

Functionality for resolving Python packages and their dependencies.

uv-shell

Utilities for detecting and manipulating shell environments.

uv-types

Shared traits for uv, to avoid circular dependencies.

uv-pypi-types

General-purpose type definitions for types used in PyPI-compatible APIs.

uv-virtualenv

A venv replacement to create virtual environments in Rust.

uv-warnings

User-facing warnings for uv.

uv-workspace

Workspace abstractions for uv.

uv-requirements-txt

Functionality for parsing requirements.txt files.