Le besoin d’environnements virtuels et de reproductibilité

Les projets Python s'appuient souvent sur de nombreuses bibliothèques et packages externes. À mesure que les projets grandissent et évoluent, la gestion de ces dépendances peut devenir complexe. Deux aspects critiques du développement Python sont :

1. Environnements virtuels : espaces isolés qui séparent les dépendances du projet des installations Python à l'échelle du système.

2. Reproductibilité : garantir qu'un projet peut être facilement configuré et exécuté de manière cohérente sur différentes machines ou environnements.

Des outils traditionnels tels que venv et pip sont utilisés depuis longtemps à ces fins, mais ils nécessitent souvent plusieurs étapes et une intervention manuelle. C'est là qu'intervient Poetry, offrant une solution plus simple et plus robuste.

Pourquoi choisir la poésie ?

La poésie offre plusieurs avantages par rapport aux outils traditionnels :

1. Workflow simplifié : combine la gestion des dépendances, le packaging et la publication dans un seul outil.

2. Résolution des dépendances : résout automatiquement les dépendances et les conflits potentiels.

3. Builds reproductibles : garantit des environnements cohérents sur différentes machines.

4. Fichier de verrouillage : génère un fichier de verrouillage pour un contrôle exact de la version de toutes les dépendances.

5. Isolement du projet : crée et gère automatiquement des environnements virtuels.

6. Commandes intuitives : offre une CLI conviviale pour les tâches courantes.

Installer et configurer la poésie

curl -sSL https://install.python-poetry.org | python3 -

Après l'installation, ajoutez Poetry à votre PATH en ajoutant la ligne suivante à votre fichier de configuration shell (par exemple, ~/.bashrc ou ~/.zshrc) :

export PATH="$HOME/.local/bin:$PATH"

Redémarrez votre terminal ou exécutez source ~/.bashrc (ou le fichier approprié) pour appliquer les modifications.

Vérifiez l'installation en exécutant :

poetry --version

Activer la complétion des onglets pour Bash, Fish ou Zsh

poetry prend en charge la génération de scripts de complétion pour Bash, Fish et Zsh.

Frapper

poetry completions bash >> ~/.bash_completion

Poisson

poetry completions fish > ~/.config/fish/completions/poetry.fish

Zsh

poetry completions zsh > ~/.zfunc/_poetry

Utiliser la poésie

Créer un nouveau projet

Pour créer un nouveau projet Python avec Poetry :

poetry new my-project
cd my-project

Cela crée un nouveau répertoire avec une structure de projet de base, y compris un fichier pyproject.toml.

Ajout de dépendances

Pour ajouter une nouvelle dépendance :

poetry add requests

Cela ajoute le package à votre fichier pyproject.toml et l'installe dans l'environnement virtuel.

Gestion des dépendances

Afficher les packages installés :

poetry show

Mettre à jour tous les packages :

poetry update

Supprimer un package :

poetry remove requests

Exécuter des scripts

Exécuter des scripts Python dans l'environnement virtuel du projet :

poetry run python your_script.py

Gestion de l'environnement virtuel

Activer l'environnement virtuel :

poetry shell

Désactivez-le :

exit

Construction et publication

Construisez votre projet :

poetry build

Publier sur PyPI :

poetry publish

Exigences d'exportation

Générer un fichier requis.txt :

poetry export -f requirements.txt --output requirements.txt

Conclusion

Poetry simplifie la gestion de projet Python en fournissant un outil unifié pour la gestion des dépendances, les environnements virtuels et le packaging. Son interface intuitive et ses fonctionnalités puissantes en font un excellent choix pour les développeurs Python cherchant à rationaliser leur flux de travail et à garantir la reproductibilité des projets.