Poetry : qu'est-ce que c'est et pourquoi l'utiliser ?

Poetry est un outil open source qui simplifie la gestion des dependances et le packaging de projets Python. Cree en 2018 par Sebastien Eustace, il repond a une frustration partagee par beaucoup de developpeurs Python : l'ecosysteme standard (pip, setuptools, virtualenv) est fragmente, avec plusieurs fichiers de configuration qui ne communiquent pas entre eux. Poetry unifie tout dans un seul fichier : `pyproject.toml`.

Le probleme que Poetry resout

En Python, gerer les dependances a longtemps ete penible. Un projet typique utilisait `requirements.txt` pour lister les dependances, `setup.py` pour le packaging, et un outil separe (virtualenv, venv, conda) pour isoler l'environnement. Chaque fichier avait son propre format, et la coherence entre eux etait rarement garantie.

Le probleme le plus concret : `pip install` ne gere pas la resolution de dependances de maniere deterministe. Deux installations successives du meme `requirements.txt` pouvaient donner des resultats differents selon l'ordre de resolution. C'est un vrai probleme en production, ou la reproductibilite est indispensable, notamment pour les projets de data science et de machine learning.

Comment Poetry fonctionne

Poetry repose sur deux fichiers :

• `pyproject.toml` : le fichier de configuration principal. Il declare les metadonnees du projet (nom, version, description), les dependances de production, les dependances de developpement, et les contraintes de version. C'est un standard Python (PEP 518, PEP 621), pas un format proprietaire.
• `poetry.lock` : le fichier de verrouillage. Il enregistre les versions exactes de chaque dependance (y compris les sous-dependances) installees. Ce fichier garantit que tous les membres de l'equipe et les environnements de CI/CD utilisent exactement les memes versions.

La commande `poetry install` lit le lockfile et installe les versions exactes. La commande `poetry add` ajoute une dependance, resout les conflits de versions et met a jour le lockfile. La resolution est deterministe : meme entree, meme sortie, a chaque fois.

Gestion des environnements virtuels

Poetry cree et gere automatiquement un environnement virtuel par projet. Pas besoin de lancer `python -m venv` ou d'activer manuellement un environnement. La commande `poetry shell` ouvre un shell dans l'environnement du projet, `poetry run` execute une commande dans cet environnement.

Par defaut, les environnements sont stockes dans un repertoire centralise (`~/.cache/pypoetry/virtualenvs/`), mais on peut configurer Poetry pour les creer dans le dossier du projet (`poetry config virtualenvs.in-project true`), ce qui facilite l'integration avec les IDE.

Avantages par rapport a pip et conda

• Determinisme : le lockfile garantit des installations reproductibles. Avec pip, les versions resolues peuvent varier.
• Separation dev/prod : Poetry distingue nativement les dependances de production et de developpement. Avec pip, il faut maintenir plusieurs fichiers requirements.
• Resolution de conflits : Poetry detecte les conflits de versions avant l'installation, la ou pip peut installer des combinaisons incompatibles.
• Packaging integre : `poetry build` genere un package distribuable (wheel ou sdist), `poetry publish` le publie sur PyPI. Pas besoin de setuptools ni de twine.

Conda reste pertinent pour les projets qui necessitent des dependances non-Python (librairies C, GPU drivers), car il gere les packages systeme. Poetry se limite a l'ecosysteme Python.

Poetry dans un projet data

Pour les Data Engineers et les ML Engineers, Poetry apporte une rigueur bienvenue dans les projets de donnees et de ML. Le lockfile garantit que le modele entraine localement utilise exactement les memes versions de librairies que l'environnement de production. C'est un prerequis pour la reproductibilite des experiences et pour le MLOps.

Les commandes utiles en contexte data :

• `poetry add pandas numpy scikit-learn` : ajouter des dependances data science
• `poetry add --group dev pytest black mypy` : ajouter des outils de developpement
• `poetry export -f requirements.txt` : generer un requirements.txt pour les environnements qui ne supportent pas Poetry (certains services Cloud)

Alternatives et ecosysteme

Poetry n'est pas le seul outil dans cette categorie. uv, developpe par Astral (les createurs de ruff), est une alternative recente qui se distingue par sa vitesse d'execution (ecrit en Rust). Pipenv a ete un precurseur mais souffre de lenteurs de resolution. PDM est une autre option conforme aux standards PEP. Le choix depend des besoins du projet, mais Poetry reste le plus adopte en 2025, avec une communaute active et une documentation solide.