poetry是一個Python虛擬環境和依賴管理的工具,之前用pipenv,最近學習httprunner時,接觸了poetry。poetry和pipenv類似,另外還提供了打包和發布的功能。
官方文檔:python-poetry.org/docs/
python項目部署:poetry管理本地環境,上線用docker
poetry安裝
poetry提供多種安裝方式,個人推薦從以下2種方式中選擇:
方式一:(推薦)
$ curl -sSL https://raw.githubusercontent.com/python-poetry/poetry/master/get-poetry.py | python
方式二:(pip)
$ pip install --user poetry
工程初始化
如果當前還沒有創建工程,可以使用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
除了新建工程,還可以在已有工程的基礎上進行創建,
$ poetry init
這時候,它會讓你輸入包名稱、版本號等信息,你可以選擇輸入,也可以選擇按下ENTER鍵使用默認值,完成以后,pyproject.toml如以下格式:
name = "poetry-demo" version = "0.1.0" description = "" authors = ["wenli"] [tool.poetry.dependencies] python = "*" [tool.poetry.dev-dependencies] pytest = "^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環境的依賴,一般部署時使用<br />
更新所有鎖定版本的依賴包
$ 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