Poetry
python-poetry.org又名 Python Poetry
Python 的依赖管理与打包工具,把依赖声明、锁定和构建发布收进一个 pyproject.toml,适合写库或应用、希望依赖可复现且不想手工维护 requirements 和打包脚本的开发者。
最近 5 次实测
4 次可以打开平均 2.1 秒11 月 19 日 起国内不可直接访问
本站从国内机房定期实测。竖条由远及近:绿 = 可以打开,橙 = 国内不可直接访问,灰 = 打不开。Poetry 是 Python 项目的依赖管理和打包工具。它把过去散落在 requirements.txt、setup.py、虚拟环境命令里的活儿收进一个 pyproject.toml:声明依赖、解析版本、锁定、装包、构建、发布,都在同一个命令行里完成。
装一个库就是 poetry add pendulum,它会解析依赖、写入锁文件,并提示实际选中的版本。项目环境默认与全局 Python 隔离,这是它设计上的核心之一。
主要功能
- 依赖声明:按 PEP 621 写在 project.dependencies 里,2.0 之前则写在 tool.poetry.dependencies。
- 依赖解析:自带解析器,有解时给出方案,无解时说明冲突原因;依赖多时解析可能偏慢,官方解释是部分 PyPI 包元数据不规范。
- 构建与发布:poetry build 生成 sdist 和 wheel,poetry publish 上传到 PyPI,也支持私有仓库。
- 依赖查看:poetry show --tree 看依赖树,--latest 对比最新版本。
- 版本约束:要求符合 PEP 440,支持适合语义化版本的写法。
适合谁
写 Python 库或应用、希望依赖可复现、不想手工维护 requirements 和打包脚本的开发者。发布到 PyPI 的开源作者用它一条命令就能上传。想扩展行为的人还可以写插件。
费用与限制
工具本身免费,文档站提供稳定版和开发版两套说明。它不是包索引,默认从 PyPI 取包,用私有源需要自己配置。项目要求 Python 版本符合 PEP 440,像 1.0.0-hotfix.1 这种写法不被接受。构建扩展模块的功能官方标注仍属不稳定。
常见问题
Poetry 收费吗?
Poetry 免费使用。
