astral-sh/uv

Add a hint when free-threaded selector is used in `requires-python`

Open

Aperta il 3 dic 2025

Vedi su GitHub
 (5 commenti) (1 reazione) (0 assegnatari)Rust (84.934 star) (3111 fork)batch import
enhancementerror messageshelp wanted

Descrizione

Summary

See https://github.com/astral-sh/uv/issues/16951

We should be able to suggest a resolution here

Example

error: Failed to parse: `pyproject.toml`
  Caused by: TOML parse error at line 4, column 19
  |
4 | requires-python = ">=3.14t"
  |                   ^^^^^^^^^
Failed to parse version: after parsing `3.14`, found `t`, which is not part of a valid version:
>=3.14t
^^^^^^^

hint: `requires-python` cannot include a free-threaded selector, consider using `uv python pin 3.14t` instead

Guida contributor

Tech stack
rustpython
Dominio
clideveloper experience
Tipo issue
feature
DifficoltàQuanto dovrebbe essere impegnativa per un nuovo contributor.
2
Tempo stimatoTempo stimato per completare e verificare uno scope piccolo.
1-3 hours
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
RustGit
Adatta ai principiantiQuanto la issue è adatta a contributor alla prima esperienza.
70
Direzione di ricerca
Esamina il codice di parsing per `requires python` nel codice di uv, individua dove viene sollevato l'errore e aggiungi la logica per rilevare il suffisso 't' per Python free threaded, quindi emetti un suggerimento con il comando proposto.