astral-sh/uv

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

Open

#16,963 创建于 2025年12月3日

在 GitHub 查看
 (5 评论) (1 反应) (0 负责人)Rust (84,934 star) (3,111 fork)batch import
enhancementerror messageshelp wanted

描述

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

贡献者指南

技术栈
rustpython
领域
clideveloper experience
议题类型
feature
难度面向新贡献者的预计实现难度，1 表示很小改动，5 表示专家级工作。
2
预计时间有经验贡献者完成调查、实现、测试并准备 pull request 的粗略时间范围。
1-3 hours
活动状态议题当前的可参与程度：新鲜、活跃、陈旧、阻塞或等待维护者输入。
active
清晰度议题是否清楚说明期望改动、验收标准和下一步。
clear
前置要求
Rust basicsUV error handling patterns
新手友好度1-100 的估计分数，表示该议题对首次贡献者的友好程度。
85
研究方向
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.