2.7.6. Poetry¶
简介¶
Poetry requires Python 3.8+. It is multi-platform and the goal is to make it work equally well on Linux, macOS and Windows.
Poetry 是一个专注于 Python 项目依赖管理的工具，它使用 pyproject.toml 文件来定义项目元数据和依赖项。
相比Conda：conda 是一个通用的包管理和环境管理工具，不仅可以管理 Python 包，还可以管理其他语言的包；Poetry 更专注于 Python 项目的依赖和包管理，而 conda 则是一个通用的包管理器，适用于跨语言和跨平台的应用
安装:
curl -sSL https://install.python-poetry.org | python3 -
or
pip install poetry
Basic usage¶
Project setup¶
create our new project:
$ poetry new poetry-demo
=>
目录结构:
poetry-demo
├── pyproject.toml
├── README.md
├── poetry_demo
│ └── __init__.py
└── tests
└── __init__.py
pyproject.toml:
[tool.poetry]
name = "poetry-demo"
version = "0.1.0"
description = ""
authors = ["Sébastien Eustace <sebastien@eustace.io>"]
readme = "README.md"
packages = [{include = "poetry_demo"}]
[tool.poetry.dependencies]
python = "^3.7"
... # 增加各种依赖
[build-system]
requires = ["poetry-core"]
build-backend = "poetry.core.masonry.api"
Using your virtual environment¶
By default, Poetry creates a virtual environment in {cache-dir}/virtualenvs
Using poetry run¶
直接使用:
poetry run python your_script.py
Activating the virtual environment¶
The easiest way to activate the virtual environment is to create a nested shell with poetry shell.
对应的退出命令:
$ exit or $ deactivate
Installing dependencies¶
poetry install
Installing without poetry.lock¶
If you have never run the command before and there is also no poetry.lock file present, Poetry simply resolves all dependencies listed in your pyproject.toml file and downloads the latest version of their files.
When Poetry has finished installing, it writes all the packages and their exact versions that it downloaded to the poetry.lock file, locking the project to those specific versions. You should commit the poetry.lock file to your project repo so that all people working on the project are locked to the same versions of dependencies (more below).
Installing with poetry.lock¶
If there is already a poetry.lock file as well as a pyproject.toml file when you run poetry install, it means either you ran the install command before, or someone else on the project ran the install command and committed the poetry.lock file to the project
Running install when a poetry.lock file is present resolves and installs all dependencies that you listed in pyproject.toml, but Poetry uses the exact versions listed in poetry.lock to ensure that the package versions are consistent for everyone working on your project.
配置¶
cache-dir:
Environment Variable: POETRY_CACHE_DIR
// 默认目录
macOS: ~/Library/Caches/pypoetry
Windows: C:\Users\<username>\AppData\Local\pypoetry\Cache
Unix: ~/.cache/pypoetry