Poetry vous aide à déclarer, gérer et installer les dépendances des projets Python, vous garantissant ainsi d'avoir la bonne pile partout.
Poetry remplace setup.py
, requirements.txt
, setup.cfg
, MANIFEST.in
et Pipfile
par un simple format de projet basé sur pyproject.toml
.
[ 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 prend en charge plusieurs méthodes d'installation, y compris un simple script trouvé sur install.python-poetry.org. Pour obtenir des instructions d'installation complètes, y compris l'utilisation avancée du script, d'autres méthodes d'installation et les meilleures pratiques CI, consultez la documentation d'installation complète.
La documentation pour la version actuelle de Poetry (ainsi que pour la branche de développement et les versions récemment hors support) est disponible sur le site officiel.
La poésie est un projet vaste et complexe qui a toujours besoin de contributeurs. Pour ceux qui découvrent le projet, une liste de questions suggérées sur lesquelles travailler en poésie et en poésie-core est disponible. La documentation complète fournit également des conseils utiles.
Merci à JetBrains de nous soutenir avec des licences pour leurs outils.