[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