Poetry hilft Ihnen, Abhängigkeiten von Python-Projekten zu deklarieren, zu verwalten und zu installieren und stellt so sicher, dass Sie überall den richtigen Stack haben.
Poetry ersetzt setup.py
, requirements.txt
, setup.cfg
, MANIFEST.in
und Pipfile
durch ein einfaches, auf pyproject.toml
basierendes Projektformat.
[ tool . poetry ]
name = " my-package "
version = " 0.1.0 "
description = " The description of the package "
license = " MIT "
authors = [
" Sébastien Eustace <[email protected]> "
]
repository = " https://github.com/python-poetry/poetry "
homepage = " https://python-poetry.org "
# README file(s) are used as the package description
readme = [ " README.md " , " LICENSE " ]
# Keywords (translated to tags on the package index)
keywords = [ " packaging " , " poetry " ]
[ tool . poetry . dependencies ]
# Compatible Python versions
python = " >=3.8 "
# Standard dependency with semver constraints
aiohttp = " ^3.8.1 "
# Dependency with extras
requests = { version = " ^2.28 " , extras = [ " security " ] }
# Version-specific dependencies with prereleases allowed
tomli = { version = " ^2.0.1 " , python = " <3.11 " , allow-prereleases = true }
# Git dependencies
cleo = { git = " https://github.com/python-poetry/cleo.git " , branch = " main " }
# Optional dependencies (installed by extras)
pendulum = { version = " ^2.1.2 " , optional = true }
# Dependency groups are supported for organizing your dependencies
[ tool . poetry . group . dev . dependencies ]
pytest = " ^7.1.2 "
pytest-cov = " ^3.0 "
# ...and can be installed only when explicitly requested
[ tool . poetry . group . docs ]
optional = true
[ tool . poetry . group . docs . dependencies ]
Sphinx = " ^5.1.1 "
# Python-style entrypoints and scripts are easily expressed
[ tool . poetry . scripts ]
my-script = " my_package:main "
Poetry unterstützt mehrere Installationsmethoden, einschließlich eines einfachen Skripts unter install.python-poetry.org. Vollständige Installationsanweisungen, einschließlich erweiterter Verwendung des Skripts, alternativer Installationsmethoden und CI-Best Practices, finden Sie in der vollständigen Installationsdokumentation.
Dokumentation für die aktuelle Version von Poetry (sowie für den Entwicklungszweig und kürzlich nicht mehr unterstützte Versionen) ist auf der offiziellen Website verfügbar.
Poesie ist ein großes, komplexes Projekt, das immer auf Mitwirkende angewiesen ist. Für diejenigen, die neu im Projekt sind, steht eine Liste vorgeschlagener Themen zur Arbeit in Poetry und Poetry-Core zur Verfügung. Die vollständige beitragende Dokumentation bietet ebenfalls hilfreiche Anleitungen.
Vielen Dank an JetBrains für die Unterstützung mit Lizenzen für ihre Tools.