Python 依赖管理和打包工具 poetry

Poetry 是 Python 中进行依赖管理和打包的工具,使用 poetry 可以帮助你管理项目的依赖。poetry 提供了一个 lockfile 确保了项目可以重复安装,并且可以打包发布

安装

Poetry 支持 Python3.8 及以上的版本。具体安装方法如下:

复制代码
pipx install poetry

只需一条命令即可,当然还有其他的安装方法,具体可以查看poetry文档

但需要注意的一点是,poetry 需要安装在一个独立的虚拟环境中,不要与系统中使用的其他虚拟环境混淆。这是为了防止 poetry 的依赖被意外的升级或者卸载。而上面的 pipx 就是用来帮助将 python 的应用安装在一个独立的虚拟环境当中的

命令补全

poetry 支持 Bash,Fish和Zsh 的补全脚本,如果要使用 poetry 的自动补全,可以执行如下命令:

bash 复制代码
poetry completions bash >> ~/.bash_completion

该命令是支持在 bash 下的自动补全,其他的可以参考 poetry文档

poetry 使用

安装好 poetry 之后,就可以使用了,下面是一些基本的使用案例

创建项目

可以使用 poetry 创建一个项目,具体命令如下:

arduino 复制代码
poetry new poetry-demo

创建后的项目有一个 pyproject.toml,在这个文件里面可以指定 python 的版本,如下:

ini 复制代码
[tool.poetry.dependencies]
python = "^3.7.0"

上面表示支持 python3.7.0 及以上的版本。因为 poetry 不会自动帮你安装一个 python 解释器,所以需要你手动指定一个

已有项目使用 poetry

上面是通过 poetry 创建的一个新项目,如果是一个已有的项目,那么也可以使用 poetry 进行管理。具体的命令如下:

bash 复制代码
cd pre-existing-project
poetry init

这是用一种交互的方式去生成对应的依赖文件,完成之后就可以使用 poetry 管理依赖了

poetry 的两种模式

poetry 有两种模式,package mode 和 non-package model;如果你想打包你的项目并且想发布到 PyPI 这样的库当中,可以使用 package mode;在这种模式下,name 和 version 是必须要指定的

如果你只想使用 poetry 进行版本管理,那么就可以在 non-package model 下,这种模式下,name 和 version 不是必须的

默认模式是 package model,可以在 pyproject.toml 中添加以下配置进行更改:

ini 复制代码
[tool.poetry]
package-mode = false

指定依赖

如果你想指定依赖,可以在 pyproject.toml 中的 tool.poetry.dependencies 中指定。具体如下:

ini 复制代码
[tool.poetry.dependencies]
pendulum = "^2.1"

poetry 会使用这个信息到 tool.poetry.source 指定的仓库搜索,如果没有指定就会使用默认的 PyPi;除此之外也可以使用命令添加依赖,具体如下:

csharp 复制代码
poetry add pendulum

这条命令会自动找到合适的版本进行安装,并且会安装子依赖;因为默认拉取依赖是在 Pypi 仓库中,国内很容易拉取失败,所以可以 poetry 的 pip 镜像源。在 pyproject.toml 中指定,如下内容:

ini 复制代码
[[tool.poetry.source]]
name = "tsinghua"
url = "https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple/"
priority = "primary"

这样就能够保证正常拉取了,拉取之后就会生成一个 poetry.lock 的文件,这个文件就是进行版本锁定,保证其他地方重新安装时也是一样的版本

使用虚拟环境

poetry 支持两种形式的虚拟环境,如果当前项目在一个虚拟环境当中,那么就会直接使用这个虚拟环境。

如果当前项目没有虚拟环境,那么在执行poetry add xxx或者执行 poetry install的时候都会创建一个虚拟环境。该虚拟环境默认在~/.cache/pypoetry/virtualenvs(如果是Linux)目录下面。虚拟环境名称是项目名称和一个随机数

之后使用 poetry 添加的依赖都会在这个虚拟环境当中。但是使用 pip install xxx不会将新增的依赖添加到这个虚拟环境当中。要想使用 pip 安装,则需要先激活这个虚拟环境,具体命令如下:

复制代码
poetry shell

这样就会激活这个虚拟环境

使用 poetry 管理虚拟环境

poetry 是在指定的 python 版本下安装的,所以默认情况下使用 poetry 创建的虚拟环境就是安装 poetry 时的 python 版本。

有时候,可能需要使用不同的 python 版本,那么此时就需要进行一些配置;如果你使用 pyenv 进行 python 的版本管理,可以设置环境变量virtualenvs.prefer-active-python=true,此时 poetry 就会查找当前 shell 的python 版本

例如:可以在某个项目中指定一个 python版本,如下:

bash 复制代码
pyenv install 3.9.8
pyenv local 3.9.8  # Activate Python 3.9 for the current project
poetry install

这样 poetry 就会在这个版本下创建虚拟环境了,具体可以参考 poetry环境管理

poetry 切换环境

如果在一些环境下面 pyenv 不可用,那么此时就可能需要指定当前的 python 版本了,具体命令如下:

bash 复制代码
poetry env use /full/path/to/python
相关推荐
亿牛云爬虫专家1 小时前
Kubernetes下的分布式采集系统设计与实战:趋势监测失效引发的架构进化
分布式·python·架构·kubernetes·爬虫代理·监测·采集
蹦蹦跳跳真可爱5895 小时前
Python----OpenCV(图像増强——高通滤波(索贝尔算子、沙尔算子、拉普拉斯算子),图像浮雕与特效处理)
人工智能·python·opencv·计算机视觉
nananaij5 小时前
【Python进阶篇 面向对象程序设计(3) 继承】
开发语言·python·神经网络·pycharm
雷羿 LexChien5 小时前
从 Prompt 管理到人格稳定:探索 Cursor AI 编辑器如何赋能 Prompt 工程与人格风格设计(上)
人工智能·python·llm·编辑器·prompt
敲键盘的小夜猫6 小时前
LLM复杂记忆存储-多会话隔离案例实战
人工智能·python·langchain
高压锅_12206 小时前
Django Channels WebSocket实时通信实战:从聊天功能到消息推送
python·websocket·django
胖达不服输7 小时前
「日拱一码」020 机器学习——数据处理
人工智能·python·机器学习·数据处理
吴佳浩8 小时前
Python入门指南-番外-LLM-Fingerprint(大语言模型指纹):从技术视角看AI开源生态的边界与挑战
python·llm·mcp
吴佳浩8 小时前
Python入门指南-AI模型相似性检测方法:技术原理与实现
人工智能·python·llm
叶 落8 小时前
计算阶梯电费
python·python 基础·python 入门