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

官方文档:https://python-poetry.org/docs/

安装

macOS或Linux

curl-sSLhttps://raw.githubusercontent.com/python-poetry/poetry/master/get-poetry.py|python

从文字里可以看到安装路径是:$HOME/.poetry/bin,红框部分提示了还需要将该目录添加到PATH环境变量下。

macOS10.15后终端使用zsh,对应配置文件是.zshrc,之前的版本使用bash,对应终端文件是.bash_profile:

vi.bash_profile#文件中添加exportPATH=$PATH:/Users/zhoubihui/.poetry/bin之后:wq保存退出后,执行source.bash_profile即可

可在终端输入命令:poetry --version来确认是否安装配置完成。

windows

powershell或cmd中输入:

(Invoke-WebRequest-Urihttps://raw.githubusercontent.com/python-poetry/poetry/master/get-poetry.py-UseBasicParsing).Content|python

解决GitHub网页githubusercontent地址无法访问问题

安装成功后这里有提示,需要将poetry的bin目录添加到PATH路径,%USERPROFILE\.poetry\bin对应是c:\Users\admin\.poetry\bin,admin对应计算机的用户名,修改环境变量,将这个路径添加到PATH。

添加之后重开一个命令窗口,可输入poetry --version命令来确认。

基本使用

已有项目添加poetry管理

poetry可以输入poetry new来创建一个项目脚手架,包括基本结构、pyproject.toml文件,基于每个人的项目目录不同,推荐在已有项目添加poetry管理。

在已有的项目使用poetry,只需要执行poetry init命令来创建一个pyproject.toml文件,可看到有很多提示输入,不确定的内容就先按下Enter使用默认值,后续可以再修改pyproject.toml文件。

指定依赖的环节也可以跳过,后续再安装会更加高效。

创建虚拟环境

1、利用virtualenvs.create=true自动创建

当参数virtualenvs.create=true时,执行poetry install或poetry add时会检测当前项目是否有虚拟环境,没有就自动创建。

这里一个问题就是:如果系统中既有Python2又有Python3,且项目既支持Python2也支持Python3,那poetry会优先使用Python2。

2、利用poetry env use创建

这个命令,可以指定创建虚拟环境时使用的Python解释器版本。

从提示信息,可以看到使用了Python3.

使用这个命令后,会在虚拟环境路径下创建一个envs.toml文件,用来存储哪些虚拟环境指定了Python解释器的版本。

激活虚拟环境

执行poetry的命令并不需要激活虚拟环境,因为poetry会自动检测当前虚拟环境,如果想在当前目录对应的虚拟环境中执行命令,可以使用以下命令:

poetryrun<你的命令>#例如:poetryrunpythonflask.py

如果想显示的激活虚拟环境,使用如下命令:

poetryshell

安装依赖

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环境的依赖,一般部署时使用

追踪&更新包

输入poetry show -h可以查看poetry show之后可以加什么参数:

poetry show:查看项目安装的依赖

poetry show -t:树形结构查看项目安装的依赖

这里解释下colorama >= 0.4.1,<0.5.0。

安装某个包时,会在pyproject.toml文件中默认使用版本限定,比如colorama = "^0.4.1",当我执行poetry update时,colorama也许会更新到0.4.9,但绝不会更新到0.5.0,意思是在更新依赖时不会修改最左边非零的数字号版本,这样的默认设定可以确保不会更新到不兼容变动的版本。

poetry update:更新所有锁定版本的依赖

poetry update httprunner:更新指定的依赖

卸载依赖

会将依赖包一起卸载。

查找当前项目的虚拟环境

加上--full-path,可显示绝对路径。

删除虚拟环境路径

1、可以直接删除虚拟环境文件夹

2、通过poetry env -h查看帮助文档:

所以执行删除虚拟环境时,指定对应的解析器版本即可。

poetryenvremovepython2poetryenvremovepython3

poetry config配置

config.toml文件

poetry提供了全局config配置和特定项目的config配置。

windows下的全局config配置文件:

macOS下的全局config配置文件:

目前poetry支持的参数有:

所以通过表格也可以确定,poetry config命令:poetry config <key> <value>,key就是表格内的参数名,value就是参数要配置的值。

poetry confiig

可以看到poetry config之后可以接[--list]、[--unset]、[--local]。

本地参数配置

可以在poetry config后加--local来配置当前项目。

poetryconfigvirtualenvs.createfalse--local

执行后,当前项目在执行poetry install/poetry add时如果没有虚拟环境的话就会直接安装到系统路径上。

执行后,会在当前项目生成poetry.toml文件:

查看全局配置config.toml文件,可以看到不受影响:

全局配置

poetryconfigvirtualenvs.createfalse

这里只是示范使用,virtualenvs.create这个参数其实基本不用修改,保留原值就好。

重置配置

poetry config的--unset就是用来重置配置的,如果是重置全局配置:

poetryconfigvirtualenvs.create--unset

如果是重置项目配置:

poetryconfigvirtualenvs.create--local--unset

查看项目下的poetry.toml文件,可以看到值被重置了。

列出当前配置

列出当前项目的配置可以使用:poetry config --list

这里需要注意,列出配置时,包括了全局和本地的配置,本地的配置会覆盖全局的参数:

举例:virtualenvs.create全局为true,本地为false,那这里virtualenvs.create=false

修改虚拟环境路径

接下来,可以按照自己的文件存放习惯,修改缓存目录,同时也修改了虚拟环境目录:

poetryconfigcache-dirE:\Documents\Library

Pycharm中使用poetry创建的虚拟环境路径

1、如果是已有项目,或GitHub拷贝项目,pyproject.toml文件已存在,首先执行poetry install创建虚拟环境并安装全部依赖库,然后再将这个虚拟环境添加到pycharm中:

点击齿轮,show all->+

然后选择前面创建的虚拟环境,比如我这个是:E:\Documents\Library\virtualenvs\httprunner-ih9MoPBn-py3.7\Scripts\python.exe,选中后确定。

2、如果项目和虚拟环境都没创建,首先创建新的Python项目:

这里先选择系统的python解释器,创建项目后,执行poetry init创建pypoetry.toml文件,然后执行poetry add <packageName>或poetry install创建虚拟环境,之后同第一点,添加已经存在的虚拟环境给对应项目就可以了。

到此,相信大家对“python Poetry的基本使用方法”有了更深的了解,不妨来实际操作一番吧!这里是本站网站,更多相关内容可以进入相关频道进行查询,关注我们,继续学习!