成为赞助商——支持中文 Agent 生态

了解赞助
库Agent场景库
← 返回用例列表

TestPyPI 上传与试装核对清单

按独立账号、twine --repository testpypi、pip --index-url/--extra-index-url 与 .pypirc,整理试发布与试装核对清单;不代传包、不代保管 token。

场景说明

面向独立开发者:把「上正式 PyPI 前先在 TestPyPI 走通」写成可对账步骤,避免误传正式索引。

案例叙事

01他们做了什么

个人开源或内部工具包最怕:第一次 twine upload 直接打到正式 PyPI,元数据写错或版本号占坑。

Python Packaging User Guide《Using TestPyPI》说明:TestPyPI 是与正式索引分离的实例,托管在 test.pypi.org,用于练习分发工具与流程而不影响真实索引。因其独立数据库,需到 test.pypi.org 单独注册账号;文档注明数据库可能被定期 prune,用户账号被删并不少见。上传可用 twine,并指定 `--repository testpypi`,例如 `twine upload --repository testpypi dist/*`;成功后可打开 `https://test.pypi.org/project/<项目名>` 确认(可能延迟一两分钟才出现)。安装可用 pip 的 `--index-url https://test.pypi.org/simple/`;若包还有依赖需从正式 PyPI 拉,再加 `--extra-index-url https://pypi.org/simple/`。为减少反复输入凭据,可在 `$HOME/.pypirc` 配置 `[testpypi]`,用户名 `__token__`、密码为 TestPyPI API Token。本场景据此输出试发布/试装清单。禁止声称「已上传成功」或代存 token。

02实际效果

  • 源未披露量化「试发布一次成功率」;公开文只描述账号分离、twine/pip 标志与 .pypirc 配置要点。
  • 能把「误传正式索引 / 依赖装不到 / 项目页延迟」拆开提问。
  • 与正式 Trusted Publisher 上线流程可衔接,但本条止于 TestPyPI 演练。

03值得知道

  • TestPyPI 内容与账号可能被清理,勿当长期制品库。
  • token 与密码只放本机 .pypirc 或 CI 密钥库,勿贴进对话。
  • 上面写的是官方指南步骤,不是你的包当前在 TestPyPI 上的状态。

04可复制提示词

TestPyPI 试发布清单

你是 Python 打包试发布助手。只给核对清单,不要编造已上传成功。

项目名:{{project_name}}
发行物路径摘要:{{dist_brief}}
已有账号/报错:{{account_or_error}}

输出 Markdown:
1. 为何必须单独注册 TestPyPI
2. twine --repository testpypi 命令核对
3. 项目页确认与延迟说明
4. pip --index-url / --extra-index-url 试装
5. .pypirc 字段提问(不要索要真实 token)
禁止代跑 upload;禁止把 token 写进回复。

试装失败排查提纲

从 TestPyPI 试装失败或依赖解析异常,请写排查提纲。

pip 命令:{{pip_cmd}}
报错摘要:{{error}}
依赖说明:{{deps}}

输出:
1. index-url 是否指错
2. 是否缺 extra-index-url
3. 项目是否已在 TestPyPI 可见
4. 下一步人工命令
不要伪造「已安装成功」。

05一手来源

怎么做

  1. 粘贴包名、是否已有 test.pypi.org 账号、计划用的 twine/pip 命令与报错摘要
  2. Agent 按官方指南输出:注册→twine 上传→项目页确认→pip 试装(含依赖走 extra-index)→.pypirc 提问清单
  3. 人工执行上传与安装;Agent 不代持 API token、不代跑 upload

实用提示

  • TestPyPI 与正式 PyPI 数据库分离,须单独注册;库可能被定期清理,账号消失并不罕见
  • 试装有第三方依赖时用 --index-url 指向 TestPyPI simple,并加 --extra-index-url https://pypi.org/simple/
#TestPyPI#twine#pip#Python打包#独立开发者