poetry是一个Python虚拟环境和依赖管理的工具,之前用pipenv,最近学习http runner时,接触了poetry。poetry和pipenv类似,另外还提供了打包和发布的功能。

python项目部署: poetry管理本地环境, 上线用docker

一、poetry安装

poetry提供多种安装方式,个人推荐从以下2种方式中选择:

方式一:(官方推荐!推荐!)

# Linux 建议使用代理
$ curl -sSL https://install.python-poetry.org | python3 -
# 安装完毕后提示下
Retrieving Poetry metadata
# Welcome to Poetry!
This will download and install the latest version of Poetry,
a dependency and package manager for Python.
It will add the `poetry` command to Poetry's bin directory, located at:
$HOME/.local/bin
You can uninstall at any time by executing this script with the --uninstall option,
and these changes will be reverted.
Installing Poetry (1.3.2): Creating environment
# 在~/.bashrc中添加 export PATH=$PATH:$HOME/.poetry/bin 环境变量
# windows 等待比较久
(Invoke-WebRequest -Uri https://install.python-poetry.org -UseBasicParsing).Content | py -
# 安装完毕后结果类似Linux
# 在环境变量里添加 %USERPROFILE%\.poetry\bin

https://raw.githubusercontent.com/python-poetry/poetry/master/get-poetry.py代码保存成本地python文件,命名为install-poetry.py
进入https://github.com/python-poetry/poetry/releases查看最新版本
使用命令安装

python install-poetry.py --version 1.1.12

方式三:(pip)

$ pip install --user poetry

使用命令查看是否安装成功

$ poetry --version

Linux

curl -sSL https://install.python-poetry.org | python3 - --uninstall
curl -sSL https://install.python-poetry.org | POETRY_UNINSTALL=1 python3 -

Windows

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

三、工程初始化

1、如果当前还没有创建环境,可以使用poetry环境
输入poetry new [环境名] 来创建一个项目脚手架,包括基本结构pyproject.toml文件。

$ poetry new poetry-demo

这时候,会创建一个包含如下内容的工程,

poetry-demo
	├── pyproject.toml
	├── README.rst
	├── poetry_demo
		│── __init__.py
	├── tests
	├── __init__.py
	└── test_poetry_demo.py

2、如果新建了工程,还可以在已有工程的基础上进行创建

$ poetry init

这时候,它会让你输入包名称、版本号等信息,你可以选择输入,也可以选择按下ENTER键使用默认值,完成以后,pyproject.toml如以下格式:

name = "poetry-demo"
version = "0.1.0"
description = ""
authors = ["xxxxx"]
[tool.poetry.dependencies]
python = "*"
[tool.poetry.dev-dependencies]
pytest = "^3.4" # 指定这个包只能是3.4

四、依赖包管理

安装依赖包

可以使用install命令直接解析并安装pyproject.toml的依赖包

$ poetry install
#pyproject.toml文件的配置如下:
	# [tool.poetry.dependencies]
	# pendulum = "^1.4"

也可以可以使用add命令来安装一款Python工具包,

$ poetry add numpy

还可以,通过添加配置参数–dev来区分不同环境下的依赖包。
详细:

poetry add flask :安装最新稳定版本的flask
poetry add pytest --dev : 指定为开发依赖,会写到pyproject.toml中的[tool.poetry.dev-dependencies]区域
poetry add flask=2.22.0 : 指定具体的版本
poetry install : 安装pyproject.toml文件中的全部依赖
poetry install --no-dev : 只安装非development环境的依赖,一般部署时使用

安装git内网包

poetry add git+ssh@git地址

然后会在pyproject.toml里看到

net = {git = "git@git地址", rev = "master"}

这就安装上了内网的包。
如果“git地址”的包有更新,使用到它的项目poetry update 一下就会自动更新

  • 简而言是之,如果 “自己的项目”使用poetry的方式安装git上的python依赖包,那安装的python依赖包在git的master更新了,在“自己的项目”下运行 poetry update就能同步更新

更新所有锁定版本的依赖包

$ poetry update

更新指定依赖包

$ poetry update numpy

卸载依赖包

$ poetry remove numpy

查看可以更新的依赖

$ poetry show --outdated

查看项目安装的依赖

$ poetry show

树形结构查看项目安装的依赖

$ poetry show -t

五、虚拟环境管理

创建虚拟环境
创建虚拟环境有2种方式:
方式1:
如果在配置文件中配置了virtualenvs.create=true,执行poetry install时会检查是否有虚拟环境,否则会自动创建。
方式2:
指定创建虚拟环境时使用的Python解释器版本

$ poetry env use python3.7

激活虚拟环境

$ poetry shell

查看虚拟环境信息

$ poetry env info

显示虚拟环境列表

$ poetry env list

显示虚拟环境绝路径

$ poetry env list --full-path

删除虚拟环境

$ poetry env remove python3.7

查看python版本

$ poetry run python -V
# 更改环境安装路径
$ poetry config virtualenvs.path /path/to/cache/directory/virtualenvs
                                    比如老板的这个guide,如果定义了前置条件:git-bash最新版,phthon用3.8以上,3.12一下,且不能是3.9。检查自己的python 版本是3.6.8 再去官网看看,已经到13了,不管三七二十一,先换python版本,就换成12吧, 更换后,果然成功执行该条命令, 如下图所示(这个是我后来补的,仅供参考)继续执行后面的命令,结果发现又出现如下错误:要求python版本在3.8.1和3.12之间,且不包括3.12和3.9.7 真是晕😵(猜中了,但是不够精准啊,哈哈)继续换3.11版本。
                                    Poetry 作为一个现代的 Python 依赖管理工具,提供了一种清晰、一致的方式来管理项目依赖。它通过和文件,确保了依赖的声明和锁定,使得项目在不同环境中的一致性得到了保障。👍🏻呗。❤️❤️❤️本人水平有限,如有纰漏,欢迎各位大佬评论批评指正!😄😄😄👍 👍 👍🔥🔥🔥Stay Hungry Stay Foolish 道阻且长,行则将至,让我们一起加油吧!🌙🌙🌙。
                                    这是官方的如果安装过程中有什么错误的,请以官方文档为主Linux, macOS, Windows (Windows 上的 Linux 子系统)请使用如下指令上面教程都会安装在默认的路径,如果需要更改安装位置请参考官方这里我编写了一个一键安装脚本。大家可以使用一下。
                                    Poetry 是一个用于管理 Python 项目依赖关系和构建工具的工具。它提供了一个简单的命令行界面,可以帮助您创建、管理和发布 Python 项目,使用方法:command [options] [arguments]官网:https://python-poetry.org/docs/主要功能和用途创建新的 Python 项目:Poetry 提供了 new 命令,可以创建一个新的 Python 项目,并设置项目的基本配置。
                                    因为是python的第三方库,我们可以直接用pip install poetry来下载poetry;但是这会有个弊端,就是安装poetry的同时也会安装一大堆依赖库,因而会污染全局的python环境。因此这里选择用pipx来安装poetry。然后的话pipx给所安装的包也搞了个虚拟环境,我们要找poetry的执行文件(比如pycharm里面要求输入的poetry路径)怎么找呢?2. 在venvs路径下的poetry\Scripts\poetry.exe就是poetry的可执行文件了。
                                    官方文档在此,poetry目前来说是取代pipenv的一个工具,后者已经几乎不维护了,被抛弃也是正常的。
安装过程不再赘述了,看官方文档就行了,记录一下简单的使用操作。
会生存一个toml文件,这个文件很关键,将会根据它来部署环境。
定位到你的项目文件夹,执行:
poetry init
会有很多配置让你输入,如果没什么特殊需求全部默认即可。
添加环境
有很多环境的话可以直接写在toml文件里面,不过如果不多的话可以使用a
Poetry 是一个包管理和打包的工具。
在 Python 中,对于初学者来说,打包系统和依赖管理是非常复杂和难懂的。即使对于经验丰富的开发者,一个项目总是要同时创建多个文件: setup.py
,requirements.txt,setup.cfg , MANIFEST.in ,还有最新的 Pipfile,十分繁琐。因此, poetry 将所有的配置都放置在一个 toml 文件(pyproject.toml)中,这些配置包括:依赖管理、构建、打包、发布。
Poetry 的灵感来自于其他语言的一些工具
基于此, poetry 将所有的配置都放置在一个 toml 文件中,包括:依赖管理、构建、打包、发布等,可谓是简单方便。
Poetry 要求 Python 版本为 2.7 或者 3.5+。Poetry 官方提供了一个脚本,可以快速
                                    Python Poetry 是一个专注于 Python 项目依赖管理的工具,它提供了一种简洁而强大的方式来定义项目依赖、创建虚拟环境、构建和发布 Python 包。与传统的依赖管理工具相比,Python Poetry 具有更加简洁的语法、更加直观的操作界面和更高效的依赖解析算法,使得项目的依赖管理变得更加简单和可靠。Python Poetry 使用 pyproject.toml 文件来定义项目的依赖和配置信息,这种格式简洁明了,易于理解和维护。
                                    PoetryPython 中依赖管理和打包的工具。他可以管理项目中的第三包的依赖(安装/更新)。同时也提供了一个锁定文件以确保可重复安装,并且可以构建项目以供分发。poetryPython版本要求为 3.7+,且是多平台的。​。