SuperAPI AI 工具集

python-packaging

编程与开发

查看项目

更新于 10-15 21:38

技能介绍

用途:帮助开发者创建、组织和分发 Python 包,涵盖从项目结构设计、元数据配置到构建与发布 PyPI 或私有仓库的完整流程。

主要能力:介绍源码布局(src/package_name)与扁平布局两种结构;讲解 pyproject.toml、setup.py、setup.cfg 元数据配置;涉及 PEP 517/518(构建系统要求)、PEP 621(元数据)、PEP 660(可编辑安装)等现代打包标准;对比 setuptools、hatchling、flit、poetry 等构建后端;说明 wheel 与源码分发包(.tar.gz)两种分发格式;覆盖命令行入口点、依赖与可选依赖(dev 等)、命名空间包、版本发布和分类器元数据。

使用方式:按建议的目录结构组织项目(含 pyproject.toml、README、LICENSE、src 布局与 tests),在 pyproject.toml 中声明 [build-system]、[project] 及依赖,使用所选构建后端构建 wheel 与 sdist,然后发布到 TestPyPI 测试或直接发布 PyPI;私有仓库(如 JFrog、AWS CodeArtifact)亦可。源码布局需在 pyproject.toml 中配置 [tool.setuptools.packages.find] 的 where = ["src"]。

适用场景:开发可分发的 Python 库、构建带入口点的命令行工具、发布到 PyPI 或私有源、设置标准项目结构、创建带依赖的可安装包、生成 wheel 与源码包、版本管理与发布、创建命名空间包、完善包元数据与分类器。

限制:资料未提供具体价格、平台支持范围、运行环境要求或实际效果数据;示例内容以引导性配置为主,完整细节需阅读 references/details.md。