『Python学习笔记』Python环境管理器—Poetry入门指南

已于 2024-10-29 10:47:48 修改
阅读量2.6k 收藏 25
点赞数 27
分类专栏： Python学习笔记 文章标签： python 学习 笔记 Poetry pip conda
于 2024-08-05 11:31:04 首次发布
引用请附上作者博客链接https://zhangkaifang.blog.csdn.net/，谢谢理解！
本文链接：https://blog.csdn.net/abc13526222160/article/details/140919693
版权
Python环境管理器—Poetry入门指南

文章目录

在这里插入图片描述

一. 基础知识

1. Poetry是什么？

  • Poetry 帮助你定义、管理和安装 Python 项目的依赖，还可以用于项目的打包和发布。
  • 简单来说，Poetry 类似pip，能协助你进行套件管理（dependency management），但又比pip 强大得多，因为它还包含了pip 所未有的下列功能：
  • 管理第三方模块的安装与卸载
  • 管理虚拟环境
  • 管理虚拟环境的依赖
  • 管理打包与发布。其中最重要的是 虚拟环境的依赖。

2. 名词解释：虚拟环境管理、模块管理、模块依赖管理

在这里插入图片描述

3. pip的不足

  • pip 是Python 内建的套件管理工具，而它的最大罩门，就是对于「套件间的相依性管理」能力不足。尤其是在「移除」套件时的依赖解析——可以说没有。这也是我提议改用Poetry 的根本原因。
  • 怎么说？看完下面的例子就能明白。
  • pip uninstall的困境：以Flask 为例
  • 假设现在你的工作专案中有开发API 的需求，经过一番研究与讨论，决定使用Flask网页框架来进行开发。
  • 我们知道，很多套件都有依赖的套件，也就是使用「别人已经造好的轮子」来构成套件功能的一部分。
  • 安装主套件时，这些依赖套件也必须一并安装，主套件才能正常运作，这里的Flask 就是如此。安装Flask 时，不会只安装单一个flask套件，还会安装所有Flask 的必要构成部分——也就是依赖套件，结果如下：
❯ pip install flask 
Collecting flask 
  Downloading Flask-2.1.1-py3-none-any.whl (95 kB) 
     |█████████████████████████ ███████| 95 kB 993 kB/s 
... 
Installing collected packages: zipp, MarkupSafe, Werkzeug, Jinja2, itsdangerous, importlib-metadata, click, flask 
Successfully installed Jinja2-3.1.1 MarkupSafe-2.1.1 Werkzeug-2.1.1 click-8.1.2 flask-2.1.1 importlib-metadata-4.11.3 itsdangerous-2.1.2 zipp-3.7.0
  • 从上可知，pip install flask还会一并安装importlib-metadata、itsdangerous等7 个依赖套件，实际上总共安装了8 个套件！

在这里插入图片描述
在这里插入图片描述
在这里插入图片描述

在这里插入图片描述

  • pip 替代方案选择——Pipenv vs Poetry

二. 从零开始使用Poetry

1. 安装Poetry

> - Poetry 和pip、git、pyenv 等工具一样，都是典型的命令列工具，需要先安装才能下达指令—— poetry。

2. 初始化Poetry

在这里插入图片描述

在这里插入图片描述

3. 管理Poetry 虚拟环境

在这里插入图片描述

在这里插入图片描述

4. 修改config，建立专案内.venv虚拟环境

在这里插入图片描述

5. 启动与退出虚拟环境

在这里插入图片描述

6. Poetry 指令

在这里插入图片描述

6.1. Poetry 新增套件

在这里插入图片描述

6.2. poetry.lock与更新顺序

在这里插入图片描述

6.3. poetry lock：更新poetry.lock

在这里插入图片描述

7. 指定套件「版本」范围

在这里插入图片描述

7.1. Poetry 的版本管理能力

在这里插入图片描述
在这里插入图片描述

在这里插入图片描述

8. 新增套件至dev-dependencies

在这里插入图片描述
在这里插入图片描述

在这里插入图片描述

9. Poetry 更新套件

在这里插入图片描述

10. 列出全部套件清单

在这里插入图片描述

11. 「树状」显示套件依赖层级

在这里插入图片描述
在这里插入图片描述

12. Poetry移除套件(remove)

在这里插入图片描述
在这里插入图片描述

13. 输出requirements.txt

poetry export -f requirements.txt -o requirements.txt --without-hashes

在这里插入图片描述

14. 输出dev-dependencies

在这里插入图片描述

在这里插入图片描述

15. Poetry 常用指令清单

在这里插入图片描述

三. Poetry 常见使用情境与操作QA

在这里插入图片描述

1. 新增专案并使用Poetry

在这里插入图片描述

2. 现有项目改用Poetry

在这里插入图片描述

3. 在别台主机上重现项目的Poetry虚拟环境

在这里插入图片描述

4. 我想要移除并重建虚拟环境

在这里插入图片描述

5. 为什么我不在Docker 环境中使用Poetry？

在这里插入图片描述

6. 我可以使用自己习惯的virtualenv 吗？

在这里插入图片描述

7. 修改 poetry 镜像源

  • 修改为清华镜像源
poetry source add tsinghua https://pypi.tuna.tsinghua.edu.cn/simple

四. 轻松打包(poetry build)和发布(poetry publish)

1. 打包(poetry build)

在这里插入图片描述

在这里插入图片描述

2. 发布(poetry publish)

# -----------------------使用账户密码方式
poetry publish --build --username xxx --password xxx
# -----------------------使用token方式
# poetry config pypi-token.pypi xxxx
poetry config pypi-token.pypi pypi-AgEIcHlwaS5vcmcCJDkxNTQ2NzA5LTY4NzMtNDhmNC04ZDczLWM2NGM2ZTI2MWNlNwACKlszLCI0OWRlYjAyZC0xNzM5LTRmNTctOWUyNi1iOTUyOWQzMzM1YWMiXQAABiCr2ay7NyHuJUnJhRPgLeWsJ7nrWE-9V28KDHiOdBK1jA

在这里插入图片描述
在这里插入图片描述
在这里插入图片描述

五. poetry run python如何理解

poetry run python 是一个用于在 Poetry 管理的虚拟环境中执行 Python 脚本或进入 Python 解释器的命令。具体理解可以从以下几个方面来讲解：

1. 上下文

当你在项目中使用 Poetry 时，通常会创建一个虚拟环境来管理项目的依赖和 Python 版本。这个虚拟环境是隔离的，确保你安装的库不会影响到系统的全局 Python 环境或其他项目。

2. poetry run 的作用

poetry run 命令用于在当前虚拟环境中执行后续命令。它会确保以下几点：

  • 使用虚拟环境的 Python 解释器：poetry run python 将使用与当前项目相关联的虚拟环境中的 Python 解释器，而不是系统的 Python 解释器。
  • 访问虚拟环境的依赖：任何在当前虚拟环境中安装的依赖包都可用。这意味着你可以运行任何依赖于这些包的脚本，而不需要激活虚拟环境。

3. 具体示例

假设你在一个名为 my_project 的目录中，有一个 pyproject.toml 文件，且已经通过 poetry install 安装了所需依赖。

示例 1：进入 Python 解释器

你可以在项目目录中运行以下命令：

poetry run python

这会启动项目虚拟环境中的 Python 解释器，你可以在其中运行 Python 代码，而不需要手动激活虚拟环境。

示例 2：运行 Python 脚本

如果你的项目中有一个 Python 脚本 script.py，你可以这样运行它：

poetry run python script.py

这条命令会使用虚拟环境中的 Python 解释器执行 script.py，同时确保所有在 pyproject.toml 中指定的依赖都可以使用。

4. 与其他命令的配合

poetry run 不仅限于 Python 命令。你可以使用它运行任何在虚拟环境中安装的命令。例如，如果你安装了 black（一个代码格式化工具），可以这样运行：

poetry run black .

这会在当前目录下格式化代码，使用的是虚拟环境中安装的 black 版本。

总结

  • poetry run: 使得在项目的虚拟环境中运行命令成为可能，避免手动激活虚拟环境。
  • 确保环境一致性: 在运行时确保使用正确的 Python 版本和依赖。
  • 简化开发流程: 提供了一种方便的方式来执行脚本和命令，无需关注环境的切换。

这种方式在管理项目依赖和执行环境时，非常高效和灵活。

五. 参考文献

poetry，一个好用的Python项目依赖管理库
qq_35716689的博客
02-15 1万+
在 Python 开发领域，项目依赖管理是一个至关重要的问题。Python Poetry 是一个现代化的项目依赖管理工具，旨在简化 Python 项目的依赖管理和打包发布过程。本文将深入探讨 Python Poetry 的特性、用法以及如何利用它来管理 Python 项目的依赖。
用于管理虚拟环境的 Python 工具
youpccc的博客
04-23 940
或者，在 Windows 上：如果不使用 Bash 或 Powershell，您可能会在or目录中查看 CMD、fish 或 csh 的其他选项。激活后，命令提示符应更改为以虚拟环境目录的名称为前缀。就像是：那（或任何你命名的）是你已经激活你的虚拟环境的标志。在您重新启动计算机或启动不同的 shell 或终端选项卡后，它不会保持活动状态。习惯运行激活脚本。激活后，您应该可以尝试以下操作：>>> import sys>>> sys.executable‘/home/my_username/sample_pyt
python包的依赖管理：Poetry
最新发布
人工智能微客/aiweker
03-07 1580
Poetry作为一款现代化、简洁而强大的Python项目依赖管理工具，为Python开发者提供了一种便捷和可靠的方式来管理项目依赖、创建虚拟环境、构建和发布Python包。通过使用Poetry，开发者可以更加轻松地管理和分享自己的Python项目，从而提高开发效率和代码质量。无论是初学者还是资深开发者，都能从Poetry中受益。
Poetry：强大的 Python 依赖管理工具
步子哥的博客
08-10 652
Poetry 是一个用于 Python 项目依赖管理和打包的工具。它允许开发者声明项目所需的库，并自动处理这些库的安装和更新。Poetry 通过生成一个锁定文件来确保依赖项的可重复安装，从而简化了多开发者环境下的协作问题。此外，Poetry 还可以构建项目，以便于分发给其他用户或上传到 PyPI。Poetry 是一个功能强大的 Python 包管理器，它集成了依赖管理和虚拟环境管理的功能。通过简单的命令，开发者可以轻松创建项目、管理依赖、更新包版本，并确保项目在不同环境中的一致性。
Python项目管理超简单！用Poetry轻松搞定依赖和打包，新手也能快速上手✨
洛阳泰山的博客
03-03 967
本文章深入探讨了Python包管理工具Poetry的详细使用方法，涵盖安装、项目初始化、依赖管理、虚拟环境配置、包构建与发布等核心功能。同时提供了脚本运行、任务自动化及高级用法的全面解析，适合希望提升项目管理效率的Python开发者阅读。通过本文，您将掌握Poetry的关键技巧，并优化您的开发流程。文章内容详尽且结构清晰，是学习Poetry不可或缺的指南。
【python虚拟环境管理】【mac m3】使用poetry管理python项目
hiliang521的博客
07-16 964
【python虚拟环境管理】使用poetry管理python项目
Python技术栈 —— Poetry
键盘国治理专家的博客
08-08 1322
一种Python包管理工具。参考文章或视频链接[1][2]《poetry 入门完全指南》 - CSDN。
poetry 入门完全指南
热门推荐
weixin_42871919的博客
03-28 2万+
使用 poetry 作为项目的虚拟环境已经蛮久了，这个工具虽然非常好用，但是一致没有用于生成环境之中，也没有力荐这个工具的使用。如果感觉差不多是时候了，所以打算把虚拟环境改为poetry，不在使用其他的虚拟环境。相比 pip 与 venv 的使用，poetry 确实有一定的学习门槛，需要先理清楚 pip 与 虚拟环境之间的关系，然后才能学习 poetry 的使用。现在我把自己的项目全部用 poetry 来进行管理，使用体验远远大于我之前用过的pip + venvpyenvconda的虚拟环境。
Python依赖管理及打包利器-Poetry
吃果冻不吐果冻皮
08-28 1100
简介 Poetry 是一个包管理和打包的工具。 在 Python 中，对于初学者来说，打包系统和依赖管理是非常复杂和难懂的。即使对于经验丰富的开发者，一个项目总是要同时创建多个文件： setup.py ,requirements.txt,setup.cfg , MANIFEST.in ，还有最新的 Pipfile，十分繁琐。因此， poetry 将所有的配置都放置在一个 toml 文件（pyproject.toml）中，这些配置包括：依赖管理、构建、打包、发布。 Poetry 的灵感来自于其他语言的一些工具
Poetry入门教程
NLP工程化
07-27 2538
以前使用模块管理和虚拟环境为pip和Virtualenv组合，随着Rasa、Dify等开源项目逐步使用Poetry模块管理，也开始尝试使用Poetry。本文简要介绍Poetry入门操作。
【学习笔记】Macbook管理多个不同的Python版本
哥老倌的博客
01-15 1848
pyenv：适合需要管理多个Python版本的场景。conda：适合数据科学和机器学习项目，提供丰富的科学计算包。virtualenv和：轻量级，适合简单的项目管理。poetry：现代的包管理工具，自动创建虚拟环境，适合新项目。选择适合你项目需求的工具，可以让你更高效地管理不同项目的不同Python版本。希望这些信息对你有帮助！
小甲鱼python（2019最新版）学习笔记（P3-P8）
weixin_45413322的博客
12-20 1196
P3：设计小游戏 """用python设计第一个游戏""" temp = input("不妨猜一下小甲鱼现在心里想的是哪个数字:") guess = int(temp) if guess==8: print("你是小甲鱼心里的蛔虫嘛?") print("猜中了也没奖励") else: print("猜错了，想的是8") print("游戏结束") 课后作业： temp = input("please input a number between 1-100")
【Python学习笔记（基础篇）】：新手必看！入门Python的10个高效策略
[Python学习笔记（干货）PDF完整版](https://img-blog.csdnimg.cn/83d7181330644bf8bd6af07f9a4054c6.png) # 摘要 本文旨在为初学者提供一个全面的Python编程入门指南，涵盖了从基础语法到面向对象编程，再到数据...
Poetry - Python 环境管理
AI工程化、开源分享、文档翻译、代码笔记
05-16 1739
Poetry 差不多是 pip + venv，的结合体。可以类似 pip 用于管理第三方模块的管理，但是比 pip 的功能强大许多，同时还包含 venv 的虚拟环境管理功能。你可以不用激活环境，因为poetry会自动检测当前虚拟环境。然后会跳出来一连串的互动对话，用于创建项目的配置文件。个人觉得这个体验和 rust - cargo 很相似。直接全部一路回车，然后看一下生成的。伊织 2024-05-14（二）你可以直接删除 虚拟环境文件夹。更新当前环境所有依赖。如 requests。
python之poetry模块，项目管理
局外人LZ的博客
01-31 4198
Poetry 是一个用于管理 Python 项目依赖关系和构建工具的工具。它提供了一个简单的命令行界面，可以帮助您创建、管理和发布 Python 项目，使用方法：command [options] [arguments]官网：https://python-poetry.org/docs/主要功能和用途创建新的 Python 项目：Poetry 提供了 new 命令，可以创建一个新的 Python 项目，并设置项目的基本配置。
Python 包管理工具 - poetry
m0_56966142的博客
10-22 2745
Python的包管理一直算是个痛点，作为Python基金会官方钦定的Pipenv并不是太给力，反倒中途杀出的Poetry，让人眼前一亮。今天我们就快速入门一下Poetry。
Python Poetry 入门指南
gitblog_00933的博客
08-08 650
Python Poetry 入门指南 poetry简化Python包的打包与依赖关系管理工作而设计的一种解决方案或工具项目地址:https://gitcode.com/gh_mirrors/po/poetry 项目介绍 Python Poetry 是一个用于 Python 项目的依赖管理工具及构建系统，它简化了包管理和创建可复用、可部署的 Python 项目的过程。通过提供一致且易于理解的命令行...
【Python系列】Poetry使用指南
CSDN站内信: https://i.csdn.net/#/msg/chat/qyj19920704
08-07 1万+
Poetry 作为一个现代的 Python 依赖管理工具，提供了一种清晰、一致的方式来管理项目依赖。它通过和文件，确保了依赖的声明和锁定，使得项目在不同环境中的一致性得到了保障。👍🏻呗。❤️❤️❤️本人水平有限，如有纰漏，欢迎各位大佬评论批评指正！😄😄😄👍 👍 👍🔥🔥🔥Stay Hungry Stay Foolish 道阻且长,行则将至,让我们一起加油吧！🌙🌙🌙。
使用Poetry进行项目管理和本地开发：详细指南
ppoojjj的博客
10-04 1595
在本篇文章中，我们介绍了如何使用Poetry进行依赖管理和本地开发，包括环境设置、依赖安装、格式化和Linting、测试等方面。希望这些内容能帮助你更高效地进行Python项目开发。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

AI大模型前沿研究

感谢您的打赏，我会继续努力！

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值