Premiers pas avec Python : créer un projet Hello World à l'aide de la poésie

Introduction

Poetry est un puissant outil de gestion des dépendances et de packaging pour Python. Il simplifie la création de projets, l'installation des dépendances et l'isolation de l'environnement. Dans ce didacticiel, nous passerons en revue les étapes permettant de créer et d'initialiser un message « Hello, World ! » Projet Python utilisant Poetry.

Conditions préalables

Avant de commencer, assurez-vous que les éléments suivants sont installés sur votre système :

1. Python (version 3.7 ou ultérieure)
2. Poésie (suivre le guide d'installation officiel)

Vous pouvez vérifier vos installations en exécutant :

python --version
poetry --version

Étape 1 : Créer un nouveau projet

Commencez par créer un nouveau répertoire pour votre projet. Accédez au répertoire dans lequel vous souhaitez stocker votre projet et exécutez :

poetry new hello-world

Cette commande crée un nouveau dossier nommé hello-world avec la structure suivante :

hello-world/
├── README.rst
├── hello_world
│   └── __init__.py
├── pyproject.toml
└── tests
    ├── __init__.py
    └── test_hello_world.py

Composants clés

• hello_world/ : contient votre package Python.
• pyproject.toml : définit les dépendances et les métadonnées de votre projet.
• tests/ : Répertoire de vos cas de tests.

Étape 2 : ajoutez un message « Bonjour tout le monde ! » Scénario

Accédez au répertoire hello_world :

cd hello-world/hello_world

Modifiez le fichier __init__.py ou créez un nouveau fichier, main.py :

# hello_world/main.py
def main():
    print("Hello, World!")

if __name__ == "__main__":
    main()

Étape 3 : Mettre à jour pyproject.toml

Assurez-vous que le fichier pyproject.toml inclut un point d'entrée afin que vous puissiez exécuter le script en tant que commande. Ajoutez ce qui suit sous la section [tool.poetry.scripts] :

[tool.poetry.scripts]
hello-world = "hello_world.main:main"

Étape 4 : Installer les dépendances

Exécutez la commande suivante pour installer les dépendances et préparer l'environnement :

poetry install

Étape 5 : Exécutez votre script

Pour tester votre script, utilisez :

poetry run hello-world

Vous devriez voir le résultat :

Hello, World!

Étape 6 : Ajout de tests

Pour vous assurer que votre script fonctionne correctement, ajoutez un scénario de test dans le fichier tests/test_hello_world.py :

def test_main(capsys):
    from hello_world.main import main

    main()
    captured = capsys.readouterr()
    assert captured.out == "Hello, World!\n"

Exécutez les tests en utilisant Poésie :

poetry run pytest

Conclusion

Félicitations ! Vous avez créé avec succès un message « Hello, World ! » Projet Python utilisant Poetry. Cette configuration fournit une base solide pour créer des applications plus complexes tout en gérant les dépendances et le packaging sans effort.

N'hésitez pas à explorer les fonctionnalités supplémentaires de Poetry, telles que les contraintes de version de dépendance, les environnements virtuels et les packages de publication.

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!