Poetry介绍

Poetry类似于 Pipenv。它是一个 Python 虚拟环境和依赖管理工具。此外，它还提供包管理功能，例如打包和发布。你可以把它想象成一个超集Pipenv 和 Flit。 它允许你使用 Poetry 同时管理 Python 库和 Python 程序。

• Poetry官方文档地址：https://python-poetry.org/docs

Poetry安装

官方推荐的安装命令是使用内置get-poetry.py脚本，我们可以使用curl命令获取脚本进行安装：

curl -sSL https://install.python-poetry.org | python3 -

运行输出：

安装完成后，可以使用以下命令确认安装成功：

poetry --version

基本用法

Poetry 的用法很简单，大部分命令都类似于Pipenv. 但是，我们需要先了解一些基本概念和技巧：

• 使用 PEP 518 引入的新标准pyproject.toml文件来管理项目的依赖列表和各种元信息，用于替换各种配置文件，如Pipfile, requirements.txt, setup.py, setup.cfg,MANIFEST.ini等。
• 有两种类型的依赖，生产环境和开发依赖。
• 锁定的依赖项不会像 那样随时更新锁定的依赖项版本，而是Pipenv存储在poetry.lock文件中（该文件将自动生成）。因此，请记住将你的poetry.lock文件放入版本控制中。
• 执行poetry或poetry list命令以查看所有可用命令。

如何在现有项目使用poetry

如果你在现有项目中使用 Poetry，则只需要执行poetry init 命令创建pyproject.toml文件

poetry init

根据提示输入你的项目信息，不确定时回车使用默认值，后期也可以手动更新。指定依赖的链接可以跳过，手动安装会更有效率。

在新项目使用poetry

如果要创建新的 Python 项目，请使用poetry new命令创建项目模板：

poetry new test

上述命令将创建以下项目结构：

如果要使用 src 文件夹，可以添加--src选项，该选项会将包嵌套在 src 文件夹中。

创建虚拟环境

使用poetry install命令创建虚拟环境（确保pyproject.toml在当前目录下）：

poetry install

该命令将读取所有依赖项（包括开发依赖项）pyproject.toml并安装它们。如果你不想安装开发依赖项，则可以添加该--no-dev选项。如果poetry.lock项目根目录下有文件，则安装该文件中列出的锁定版本的依赖项。如果执行 add/remove 命令时没有检测到虚拟环境，则会自动为当前目录创建虚拟环境。

激活虚拟环境

执行诗歌开头的命令不需要激活虚拟环境，因为它会自动检测当前的虚拟环境。如果想在当前目录对应的虚拟环境中快速执行命令，可以使用poetry run <你的命令>命令，例如：

poetry run python app.py

如果要显式激活虚拟环境，请使用poetry shell 命令：

poetry shell

安装包

使用poetry add命令安装包：

poetry add flask

添加--dev参数可以指定为开发依赖：

poetry add pytest --dev

跟踪和更新包

使用poetry show 命令查看所有已安装的依赖项（可以将包名作为参数传递来查看特定包的信息）：

poetry show

添加--tree选项以查看依赖项：

poetry show --tree

添加--outdated查看可以更新的依赖：

poetry show --outdated

执行poetry update 命令更新所有锁定版本的依赖：

poetry update

如果要更新特定依赖项，请将包名称作为参数传递：

poetry update requests

卸载包

用于poetry remove <package name>卸载包：

poetry remover requests

构建和发布

主要用于打包python文件。打包后的产品有两种打包格式：sdist是源代码格式；wheel是编译后的格式。

poetry build

要发布：

poetry config http-basic.pypi username password
poetry publish

如果你的公司有自己的私有仓库，你可以通过以下方式上传：

poetry config repositories.foo https://foo.bar/simple/
poetry config http-basic.foo username password
poetry publish -r my-repository

结论

列出我学到的一些优点和缺点：

优点

• 使用标准pyproject.toml文件，无需编写多个配置文件
• 支持同时管理Python程序和Python库
• 更直观的默认设计，比如不随便更新锁定版本的依赖
• 干净简洁的命令行输出
• 卸载包时直接卸载隔离的子依赖，不需要pipenv clean像 Pipenv 那样再次执行。

缺点

• 会有一些潜在的错误
• 对虚拟环境的管理控制有些薄弱，没有 Pipenv 删除虚拟环境，清除依赖的东西。
• 缺乏稳定的维护团队，有大量的问题和PR等待处理，但情况正在好转

当然，你仍然可以选择继续使用基本工具virtualenv/venv ，pip 直到出现完美的解决方案。