How python-poetry/poetry works
Poetry is a command-line frontend for declaring, resolving, locking, building, installing, and publishing Python projects. The main workflow starts with a user command, loads project metadata and configuration, resolves dependencies against repositories, records a lockfile, then installs packages into a managed Python environment. Separate branches cover package building and publishing, project scaffolding, and plugins. The graph uses README statements and SOURCE INDEX references; some runtime connections are dashed because the relevant command implementations were not sampled.
Main entry points: commands Project commands · http_repository.py HTTP repositories · application.py CLI application · factory.py Project factory
Components 24
CLI and project setup
- CLI application
src/poetry/console/application.py - Project factory
src/poetry/factory.py - Project model
src/poetry/poetry.py - Project commands
src/poetry/console/commands
Dependency resolution
- Version solver
src/poetry/mixology/version_solver.py - Package provider
src/poetry/puzzle/provider.py - Repository pool
src/poetry/repositories/repository_pool.py - HTTP repositories
src/poetry/repositories/http_repository.py - PyPI repository
src/poetry/repositories/pypi_repository.py - Simple API links
src/poetry/repositories/link_sources/json.py - Lockfile manager
src/poetry/packages/locker.py - poetry.lock
Installation and environments
- Installer executor
src/poetry/installation/executor.py - Environment manager
src/poetry/utils/env/env_manager.py - Python environment
Build and publishing
- Package builders
src/poetry/masonry/builders - Package publisher
src/poetry/publishing/publisher.py
Configuration and extensions
- Configuration
src/poetry/config/config.py - Plugin manager
src/poetry/plugins/plugin_manager.py - HTTP authentication
src/poetry/utils/authenticator.py - Isolated builds
src/poetry/utils/isolated_build.py
Other components
- Project user
- Package index
- Package registry
Connections 24
- Project user → CLI application: runs command
README.md - CLI application → Project factory: loads project
src/poetry/console/application.py - Project factory → Project model: creates model
src/poetry/factory.py - Project factory → Configuration: configures
src/poetry/factory.py - Project factory → Lockfile manager: creates locker
src/poetry/factory.py - CLI application → Project commands: loads commands
src/poetry/console/application.py - Project commands → Version solver: resolves dependencies
- Version solver → Package provider: queries
src/poetry/mixology/version_solver.py - Package provider → Repository pool: queries repositories
src/poetry/puzzle/provider.py - Repository pool → HTTP repositories: dispatches lookup
- HTTP repositories → HTTP authentication: uses authentication
src/poetry/repositories/http_repository.py - HTTP repositories → Package index: fetches package data
src/poetry/repositories/http_repository.py - PyPI repository → HTTP repositories: extends access
src/poetry/repositories/pypi_repository.py - HTTP repositories → Simple API links: parses listings
src/poetry/repositories/http_repository.py - Project commands → Lockfile manager: records lock
- Lockfile manager → poetry.lock: reads and writes
src/poetry/packages/locker.py - Project commands → Installer executor: runs install
- Installer executor → Environment manager: targets environment
- Environment manager → Python environment: manages
src/poetry/utils/env/env_manager.py - Project commands → Package builders: builds distributions
- Project commands → Package publisher: publishes packages
- Package publisher → Package registry: uploads package
- CLI application → Plugin manager: loads plugins
src/poetry/console/application.py - Installer executor → Isolated builds: uses build isolation
src/poetry/installation/executor.py