python-packaging
Python包创建与PyPI发布工具
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:python-packaging。 它的用途是:Python包创建与PyPI发布工具 完整的 Skill 内容见:https://321skill.com/skills/python-packaging-x-4/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'帮我创建一个Python包,配置pyproject.toml,设置入口点为命令行工具,并发布到PyPI',它会自动生成项目结构、填写包名和版本,创建入口点函数,然后执行构建与上传。如果已有项目,说'将这个项目的setup.py迁移到pyproject.toml并添加entry points',它会解析现有代码,生成兼容配置并验证构建。
介绍
在Python项目开发中,将代码打包成可发布的包并上传到PyPI是分享和分发功能的常见需求。然而,手动配置setup.py、管理依赖、处理入口点等步骤容易出错且耗时。本Skill通过pyproject.toml和entry points机制,标准化了Python包的创建、构建和发布流程,让你无需记忆繁琐的配置细节。
使用方式非常直观:你只需在项目根目录下运行技能提供的命令,它会自动生成符合PEP 621标准的pyproject.toml文件,引导你设置包名、版本、依赖和入口点。随后,通过一条命令即可完成构建(生成wheel和sdist)并上传到PyPI,整个过程自动处理了版本号、许可证、分类器等元数据。
本Skill特别适合后端开发、全栈开发以及运维工程师,尤其是那些需要频繁创建或维护Python工具库、CLI工具、微服务模块的团队。对于刚开始接触Python包管理的新手,它也能显著降低学习曲线,让你专注于功能实现而非配置细节。
建议在使用前确保已安装Python 3.8+并激活虚拟环境。首次发布前需在PyPI注册账号并配置API令牌。如果项目包含C扩展或需要复杂构建步骤,可能需要结合setuptools的额外插件。另外,注意保持pyproject.toml中的版本号与Git标签一致,以方便追溯。
核心特点
与传统的setup.py工具或cookiecutter模板相比,本Skill完全基于现代pyproject.toml标准,且自动覆盖entry points配置,无需手动编写setup.py或setup.cfg,同时内置了PyPI发布和版本管理功能。
注意事项
不适合需要复杂构建脚本(如涉及Cython、SWIG)或需要多平台预编译二进制的项目。
常见问题
如何配置命令行入口点(console_scripts)?
在pyproject.toml的[project.scripts]下添加键值对,如'mycli = mypackage.cli:main',技能会自动生成对应入口。
发布到PyPI时需要什么凭证?
需要先在PyPI注册账号,然后在终端设置环境变量TWINE_USERNAME和TWINE_PASSWORD,或使用API令牌(推荐)。技能会调用twine进行上传。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/python-packaging-x-4/raw/index.md 读取 python-packaging 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/python-packaging-x-4/raw/index.md(查看排版版本)