Poetry 安装与使用指南
项目介绍
Poetry 是一个用于 Python 的依赖管理和打包工具,旨在简化 Python 项目的依赖管理和打包过程。它通过一个简单的 pyproject.toml
文件来管理项目的依赖、元数据和构建过程,取代了传统的 setup.py
、requirements.txt
、setup.cfg
和 Pipfile
。
项目快速启动
安装 Poetry
你可以通过以下命令安装 Poetry:
curl -sSL https://install.python-poetry.org | python3 -
创建新项目
使用 Poetry 创建一个新的 Python 项目:
poetry new my-project
cd my-project
添加依赖
在项目目录中,你可以通过以下命令添加依赖:
poetry add requests
运行项目
在项目目录中,你可以通过以下命令运行项目:
poetry run python my_script.py
应用案例和最佳实践
应用案例
Poetry 广泛应用于各种 Python 项目中,包括 Web 开发、数据科学和自动化脚本等。例如,一个 Web 应用可以使用 Poetry 来管理 Flask 和 SQLAlchemy 等依赖。
最佳实践
- 使用虚拟环境:Poetry 会自动为你的项目创建和管理虚拟环境,确保项目之间的依赖隔离。
- 版本锁定:使用
poetry.lock
文件来锁定依赖版本,确保在不同环境中的一致性。 - 持续集成:在 CI/CD 流程中使用 Poetry 来管理依赖,确保每次构建的一致性。
典型生态项目
poetry-core
poetry-core
是 Poetry 的核心库,提供了 PEP 517 构建系统的实现,是 Poetry 项目的基础。
poetry-plugin-export
poetry-plugin-export
是一个 Poetry 插件,用于将 Poetry 项目的 pyproject.toml
和 poetry.lock
文件导出为其他格式,如 requirements.txt
。
poetry-plugin-bundle
poetry-plugin-bundle
是另一个 Poetry 插件,用于将 Poetry 项目的依赖安装到外部环境,如虚拟环境。
通过这些生态项目,Poetry 提供了丰富的功能和扩展性,使其成为 Python 项目管理的强大工具。