astral-sh/uv

Move environment variable parsing to `EnvironmentOptions`

Open

Aperta il 18 lug 2025

Vedi su GitHub
 (25 commenti) (1 reazione) (0 assegnatari)Rust (84.934 star) (3111 fork)batch import
good first issuehelp wantedinternal

Descrizione

In https://github.com/astral-sh/uv/pull/14662 I added a new EnvironmentOptions abstraction which allows us to express semantics that Clap cannot and perform up-front parsing of non-CLI environment variables, e.g., https://github.com/astral-sh/uv/pull/14544 and https://github.com/astral-sh/uv/pull/14369.

We should move other extraneous environment variables to be parsed there and provided through our usual settings structs.

These changes should be relatively easy. We should probably do it one variable at a time.

  • UV_HTTP_RETRIES
  • UV_COMPILE_BYTECODE_TIMEOUT
  • UV_HTTP_TIMEOUT
  • UV_REQUEST_TIMEOUT
  • HTTP_TIMEOUT
  • UV_RUN_RECURSION_DEPTH
  • UV_RUN_MAX_RECURSION_DEPTH
  • UV_CONCURRENT_DOWNLOADS
  • UV_CONCURRENT_BUILDS
  • UV_CONCURRENT_INSTALLS
  • UV_PYTHON_INSTALL_MIRROR
  • UV_PYPY_INSTALL_MIRROR
  • UV_PYTHON_DOWNLOADS_JSON_URL
  • UV_NO_GITHUB_FAST_PATH
  • UV_GITHUB_FAST_PATH_URL
  • UV_GIT_LFS
  • UV_CUDA_DRIVER_VERSION
  • UV_AMD_GPU_ARCHITECTURE
  • UV_STACK_SIZE
  • UV_LOG_CONTEXT
  • TRACING_DURATIONS_FILE
  • UV_LOCK_TIMEOUT (https://github.com/astral-sh/uv/pull/16342#discussion_r2448547512)

Guida contributor

Tech stack
rust
Dominio
clideveloper experiencetooling
Tipo issue
refactor
DifficoltàQuanto dovrebbe essere impegnativa per un nuovo contributor.
2
Tempo stimatoTempo stimato per completare e verificare uno scope piccolo.
1-2 days
Stato attivitàQuanto è probabile che la issue sia ancora attiva e reviewable.
active
ChiarezzaQuanto chiaramente la issue descrive problema, scope e risultato atteso.
clear
Prerequisiti
RustEnvironment variable parsinguv codebase structure
Adatta ai principiantiQuanto la issue è adatta a contributor alla prima esperienza.
65
Direzione di ricerca
Esamina l'astrazione `EnvironmentOptions` introdotta nella PR #14662. Identifica dove le restanti variabili d'ambiente (ad es. `UV COMPILE BYTECODE TIMEOUT`, `UV RUN RECURSION DEPTH`, `UV GIT LFS`, ecc.) sono attualmente analizzate nella codebase (probabilmente in `cli.rs` o `settings.rs`). Sposta la logica di analisi di ciascuna variabile nella struct `EnvironmentOptions` seguendo lo schema utilizzato per le variabili già completate come `UV HTTP RETRIES`. Aggiorna i test corrispondenti e assicurati che la modifica compili e superi i test.