PROVIDER - Python dependency and packaging suite

Poetry

Poetry unifies Python dependencies, virtual environments and publishing in 1 pyproject.toml, pins every transitive dependency through poetry.lock and supports grouped dev, test and docs dependencies; the trade-offs are strict resolution and slower solving for large trees.

Developer Tools United States 2026.11.19
4.3pts

Detailed Notes

Pros 5 items

Manages dependency declarations, metadata and build settings in 1 pyproject.toml file
Produces 1 poetry.lock file pinning versions and hashes for every transitive dependency
Creates and switches virtual environments itself, so 1 tool covers isolation too
Supports 3+ dependency groups so dev, test and docs extras install only when needed
Builds and publishes in 1 command to PyPI or a private index

Cons 4 items

Strict resolution rejects loose version constraints found in older projects
Parallel use with pip and requirements.txt demands manual synchronisation
Resolving large dependency trees is notably slower than newer tools such as uv
The plugin system is thin and limits extension

Service Overview

Poetry is the widely adopted dependency management and packaging tool for Python. It folds dependency declarations, project metadata, virtual environments and build publishing into one pyproject.toml backed by a lock file that keeps installs identical across a team.

In the development tools category it is language-level package management: unlike pip, which only installs, Poetry spans the whole path from resolution to a PyPI release.

Key Strengths

  • Unified configuration: 1 pyproject.toml holds dependencies, metadata and build settings
  • Reliable locking: poetry.lock pins every transitive dependency with hashes
  • Built-in environments: virtual environment creation and switching included
  • Dependency groups: dev, test and docs dependencies installed on demand
  • Smooth publishing: one command builds and uploads to PyPI or a private index

Product Ecosystem

Platform capabilities

Dependency resolution, lock file management, virtual environment operations, script commands, wheel and sdist builds, private index configuration.

Integrations

Works with GitHub Actions, pre-commit, tox, multi-stage Docker builds and artifact repositories such as PyPI and Artifactory.

Typical scenarios

Python library and application development, team dependency consistency, internal package publishing and reproducible installs in CI.

Limitations

  • Strict resolution: loose legacy constraints may be unsatisfiable
  • Workflow split: coexisting with pip and requirements.txt needs extra syncing
  • Speed: large dependency trees resolve slower than newer tools
  • Thin plugins: a smaller extension ecosystem than some rivals

Use Cases

  • Python library development (★★★★★): packaging and publishing in one chain
  • Team dependency consistency (★★★★★): lock files keep environments aligned
  • Separated dependency sets (★★★★☆): groups reduce install size
  • Very large monorepos (★★★☆☆): consider a faster resolver

Pricing

Item Price Notes
Poetry itself $0 MIT open source, commercial use allowed
PyPI hosting $0 Public packages publish free
Private index Service dependent Artifactory and CodeArtifact bill by usage

FAQ

How does Poetry relate to pip?

Poetry resolves and locks dependencies while still consuming packages from the pip ecosystem; they can coexist, but avoid editing dependencies in both.

Do I need to create a virtual environment manually?

No. poetry install creates and reuses the project environment automatically.

Should the lock file be committed?

Yes. It is the foundation of consistent environments across the team and CI.

How does it compare with uv?

uv resolves and installs faster, while Poetry remains steadier for packaging, publishing and ecosystem maturity.

Code Examples

# pyproject.toml
[tool.poetry]
name = "demo-service"
version = "0.1.0"
description = "Demo service"
authors = ["Dev Team <[email protected]>"]

[tool.poetry.dependencies]
python = "^3.11"
fastapi = "^0.110.0"

[tool.poetry.group.dev.dependencies]
pytest = "^8.0"
ruff = "^0.3"

[build-system]
requires = ["poetry-core"]
build-backend = "poetry.core.masonry.api"
# Install dependencies and lock them
poetry install

# Add a development dependency
poetry add --group dev pytest

# Build and publish
poetry build
poetry publish

Community & Resources

Visit Poetry Website → https://python-poetry.org/
Visit Website ↗