[python]poetry安装和使用

Python新建Poetry 环境

一、安装 Poetry：

1、windows直接安装：

(Invoke-WebRequest -Uri https://install.python-poetry.org -UseBasicParsing).Content | python -

2、pip安装

pip install poetry

二、创建项目

1、指定虚拟环境存放目录

poetry config virtualenvs.path D:\WorkSpace\Venv

2、创建新的 Poetry 项目：

安装 Poetry 后，您可以使用 poetry new 命令来创建一个新项目。打开您的终端或命令提示符，然后导航到您想要创建项目的目录，并运行以下命令：

poetry new my-project

其中 my-project 是您想要创建的项目的名称。这个命令会创建一个名为 my-project 的新目录，并在其中生成一个基本的 Poetry 项目结构。 您可以使用 --path 或 -p 选项来指定一个特定的目录。

poetry new my-project

3、poetry初始化

创建虚拟环境，并指定python版本

poetry env use 'D:\Program Files\Python312\python.exe'

如果是已有项目转为使用poetry作为依赖管理，可以进行初始化

poetry init

会在项目根目录生成pyproject.toml文件

1）如果你想指定安装的数据源可以在pyproject.toml文件中添加下面代码：

[[tool.poetry.source]]
name = "tuna"
url = "https://pypi.tuna.tsinghua.edu.cn/simple"
priority = "primary"  # 或者选择 'primary', 'supplemental', 'explicit'

2）使用命令添加源：

poetry source add --priority primary tuna https://pypi.tuna.tsinghua.edu.cn/simple

三、激活虚拟环境：

1、已有pyproject.toml进行安装依赖激活

在项目创建后，您需要激活 Poetry 创建的虚拟环境。在项目根目录中运行以下命令：

poetry install

这个命令会安装 pyproject.toml 中定义的所有依赖项，并激活虚拟环境。

2、使用虚拟环境

一旦虚拟环境被激活，您可以开始使用您的项目了。例如，您可以使用以下命令来运行一个简单的 Python 脚本：

poetry run python my_script.py

或者，如果您想要使用交互式 Python 解释器：

poetry shell

这会将您带入一个 shell 会话，其中已经激活了 Poetry 的虚拟环境。在这个会话中，您可以运行 Python 命令和脚本，而无需手动激活环境。

四、管理依赖

1、新增：

1）如果您需要添加或更新依赖项，可以使用 poetry add 命令：

poetry add requests

这会将 requests 库添加到您的项目中，并自动更新 pyproject.toml 和 poetry.lock 文件。

2）如果你想从requirements.txt 管理依赖改为使用poetry管理，可以使用 PowerShell 脚本读取 requirements.txt 并将依赖项添加到 Poetry 项目中：

Get-Content requirements.txt | ForEach-Object { poetry add $_ }

2、更新依赖：

使用 Poetry 的 update 命令来更新项目中的依赖项。例如，如果您想要更新所有依赖项，可以使用以下命令：

poetry update

如果您只想更新特定的依赖项，可以使用以下命令：

poetry update requests

如果你想安装 requests 的最新版本，而不受当前版本约束的限制，可以运行：

poetry add requests@latest

请注意，如果您的项目中存在锁文件（poetry.lock），Poetry 可能会跳过依赖更新，因为锁文件中已经定义了依赖的版本。在这种情况下，您需要先删除锁文件，然后再运行 update 命令。

rm -f poetry.lock
poetry update

3、删除依赖

如果你想删除名为 requests 的库，可以运行：

poetry remove requests

注意

• 如果你只想移除某个库，但不希望影响其他已安装的包，可以使用 --dry-run 选项来预览即将进行的更改，而不实际执行删除操作。
• 运行poetry remove 后，poetry 会自动更新依赖，确保项目的依赖关系保持一致

4、查看已安装的依赖：

要查看项目中已安装的依赖项，可以使用 poetry show 命令：

poetry show

这将显示项目中所有已安装的依赖项及其版本。

5、查看环境信息：

您可以使用以下命令来查看当前激活的环境信息：

poetry env info