Frost's Blog
·
Python打包指南2021
内容提要
本文介绍了Python打包的最新指南，重点在于setup.py的编写和PEP 517的应用。作者强调了使用twine上传包的正确方法，如何指定依赖、发布可执行程序和包含数据文件。PEP 517使构建过程更加灵活，支持使用pyproject.toml替代setup.py，简化了包管理和构建流程。
关键要点
-
本文介绍了Python打包的最新指南，重点在于setup.py的编写和PEP 517的应用。
-
setup.py的编写涉及指定依赖、发布可执行程序和包含数据文件。
-
PEP 517使构建过程更加灵活，支持使用pyproject.toml替代setup.py，简化了包管理和构建流程。
-
使用twine工具上传包是推荐的方法，避免使用过时的上传方式。
-
PEP 517提案后，所有的PyPI包必须通过wheel格式安装，确保符合PyPA规范。
-
pyproject.toml文件中定义了构建系统的要求和后端，允许不同的构建后端组合使用。
-
setup.py作为元数据定义格式存在问题，PEP 621提供了新的元数据配置格式，使用pyproject.toml定义。
延伸解读
PEP 517的影响
PEP 517的引入使得Python包的构建过程更加灵活，允许开发者使用pyproject.toml文件替代传统的setup.py。这一变化不仅简化了包管理流程，还支持多种构建后端的组合使用，提升了开发效率。开发者应关注这一新标准，以便更好地适应未来的包管理趋势。
使用twine的优势
文章强调使用twine工具上传Python包，而非过时的上传方式。这种方法不仅安全性更高，还能避免潜在的上传错误。对于希望在CI/CD环境中自动化发布的开发者，使用twine结合生成的token是最佳实践，确保了上传过程的安全与便利。
setup.py的复杂性
尽管setup.py是Python包管理的重要组成部分，但其编写复杂性常常让开发者感到困惑。文章提供了一些常用配置示例，帮助开发者更好地理解如何指定依赖和发布可执行程序。掌握这些技巧对于顺利发布Python包至关重要。
延伸问答
如何编写setup.py文件以指定依赖？
可以使用install_requires和extras_require来指定依赖，例如：setup(install_requires=['flask'], extras_require={'mysql': ['mysqlclient']})。
PEP 517对Python包构建有什么影响？
PEP 517使构建过程更加灵活，支持使用pyproject.toml替代setup.py，简化了包管理和构建流程。
使用twine上传Python包的正确方法是什么？
推荐使用twine工具上传包，命令为$ twine upload dist/*，避免使用过时的上传方式。
pyproject.toml文件的作用是什么？
pyproject.toml文件定义了构建系统的要求和后端，允许不同的构建后端组合使用。
为什么不推荐使用python setup.py install？
因为在PEP 517发布后，所有的PyPI包必须通过wheel格式安装，使用setup.py install不符合最新规范。
setup.py的元数据定义格式存在哪些问题？
setup.py作为元数据定义格式存在无法静态解析和注入恶意代码的风险，因此需要新的格式，如PEP 621。
