astral-sh/uv

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

Open

#16.963 geöffnet am 3. Dez. 2025

Auf GitHub ansehen
 (5 Kommentare) (1 Reaktion) (0 zugewiesene Personen)Rust (84.934 Stars) (3.111 Forks)batch import
enhancementerror messageshelp wanted

Beschreibung

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

Contributor Guide

Tech Stack
rustpython
Domain
clideveloper experience
Issue Type
feature
SchwierigkeitGeschätzte Implementierungsschwierigkeit für neue Contributors, von 1 für sehr kleine Änderungen bis 5 für Expertenarbeit.
2
Geschätzte ZeitEin grober Zeitrahmen, um zu recherchieren, zu implementieren, zu testen und einen Pull Request vorzubereiten.
1-3 hours
AktivitätsstatusWie verfügbar das Issue gerade wirkt: frisch, aktiv, stale, blockiert oder wartet auf Maintainer-Input.
active
KlarheitWie klar das Issue die erwartete Änderung, Akzeptanzkriterien und den nächsten Schritt erklärt.
clear
Voraussetzungen
Rust basicsUV error handling patterns
EinsteigerfreundlichkeitEin Score von 1 bis 100, der schätzt, wie zugänglich dieses Issue für First-Time Contributors ist.
85
Research-Richtung
Investigate the version parsing module (likely in crates/uv version or similar) to locate where the error for invalid requires python is raised. Modify the error handling to detect when a 't' suffix is used (free threaded) and emit a hint suggesting 'uv python pin 3.14t'. Refer to the linked issue #16951 and the example error message in the issue body for the expected output format.