用途:指导创建、组织并分发 Python 包,覆盖从项目结构到发布 PyPI 的完整流程。
主要能力:介绍源码布局(src/package_name/)与扁平布局、多包项目、命名空间包;讲解 PEP 517/518、PEP 621、PEP 660 等现代打包标准,以及 setuptools、hatchling、flit、poetry 等构建后端;演示 pyproject.toml 的元数据、依赖、可选依赖、入口点、脚本、包数据与工具配置;说明语义化版本、动态版本与 setuptools-scm 的 git 版本管理;包含 Click 与 argparse 的 CLI 入口写法、数据文件读取、C 扩展、多架构 wheel 与私有索引。
使用方式:按资料中的结构创建项目,编写 pyproject.toml,使用 pip install build twine 后执行 python -m build 构建,twine check dist/* 校验,先 twine upload --repository testpypi dist/* 测试,再 twine upload dist/* 发布;开发时用 pip install -e ".[dev]" 可编辑安装。
适用场景:发布 Python 库、构建带入口点的命令行工具、搭建可安装包与依赖、生成 wheel 与源码分发包、版本发布与命名空间包。
限制:资料未提供具体收费、价格、平台支持范围或效果数据;部分内容为示例配置,实际使用需按项目调整。