使用 Homebrew, apk, dnf, MacPorts, Nix, apt, pacman, scoop 安装 poetry

项目链接

• 主页
• 仓库
• 软件包管理器页面

命令和别名

• poetry

项目历史

Poetry was authored by Sébastien Eustace as an integrated Python dependency-management and packaging tool. Its early releases established declarative project metadata, dependency resolution, virtual-environment management, building, and publishing.

The 1.0 release formalized the workflow in 2019. During the following 1.1 development cycle, core packaging functionality was extracted into poetry-core, allowing the build backend to operate independently of the full Poetry application. Later releases moved features such as export and shell into plugins and expanded standards-based pyproject.toml support.

采用历史

Poetry became a prominent pyproject.toml-centered workflow by combining dependency resolution, lock files, isolated environments, package building, and publishing behind one command-line interface. It is packaged by Homebrew and many Linux, macOS, Windows, and declarative package ecosystems.

Its installation documentation recommends pipx as one supported way to isolate Poetry itself, while project environments and dependencies remain managed by Poetry.

使用方式

A typical workflow initializes or opens a pyproject.toml project, adds dependencies, commits poetry.lock, and uses poetry install or poetry sync to reproduce the environment. Poetry can also build distributions and publish them to PyPI or configured private repositories.

Global application settings live in config.toml, project-local overrides in poetry.toml, and project metadata in pyproject.toml. Repository credentials normally use the system keyring; when keyring storage is unavailable or disabled, Poetry falls back to auth.toml.

为什么软件包爱好者会关心

Poetry helped popularize an integrated, lockfile-oriented alternative to assembling pip, virtualenv, build, and upload tools separately. Packaging enthusiasts care about its resolver behavior, lock-file compatibility, PEP adoption, build backend, repository authentication, and the boundary between the Poetry application and poetry-core.

时间线

• 2018: The official history records the early 0.9 release line.
• 2019: Poetry 1.0.0 was released.
• 2020: Core build functionality was extracted into poetry-core during 1.1 development.
• 2022: Poetry 1.2 separated export functionality into a plugin.
• 2024: Poetry 1.8 added non-package mode and lazy wheel metadata retrieval.

Related projects

• poetry-core is Poetry's independently usable PEP 517 build backend and core metadata library.
• pipx is an officially documented way to install and maintain the Poetry CLI in an isolated environment.
• uv overlaps with Poetry's project, environment, lockfile, build, and publishing workflow while also managing Python installations and standalone tools.

来源

• https://github.com/python-poetry/poetry/blob/main/pyproject.toml
• https://python-poetry.org/blog/announcing-poetry-1-0-0.html
• https://python-poetry.org/docs/
• https://python-poetry.org/history/