Création et test de Python

Introduction

Ce guide vous montre comment générer, tester et publier un package Python.

GitHubLes runners hébergés disposent d’un cache d’outils contenant des logiciels préinstallés, notamment Python et PyPy. Vous n’avez donc rien à installer ! Pour obtenir la liste complète des logiciels up-to-date et des versions préinstallées de Python et PyPy, consultez Exécuteurs hébergés par GitHub.

Prérequis

Vous devez être familiarisé avec YAML et la syntaxe pour GitHub Actions. Pour plus d’informations, consultez « Écriture de workflows ».

Nous vous recommandons d’avoir une compréhension de base des Python et pip. Pour plus d’informations, consultez l’article suivant :

• Débuter avec Python
• Gestionnaire de paquets pip

Utilisation d’un modèle de flux de travail Python

Pour démarrer rapidement, ajoutez un modèle de workflow au répertoire .github/workflows de votre référentiel.

GitHub fournit un modèle de flux de travail pour Python qui doit fonctionner si votre référentiel contient déjà au moins un fichier .py. Les sections suivantes de ce guide donnent des exemples de la manière dont vous pouvez personnaliser ce modèle de workflow.

1. Sur GitHub, accédez à la page principale du référentiel.

2. Sous le nom de votre référentiel, cliquez sur Actions.

   

3. Si vous disposez déjà d’un workflow dans votre dépôt, cliquez sur Nouveau workflow.

4. La page « Choisir un workflow » présente une sélection de modèles de workflow recommandés. Recherchez « application Python ».

5. Dans le flux de travail « application Python », cliquez sur Configure.

6. Modifiez le workflow en fonction des besoins. Par exemple, modifiez la version de Python.

7. Cliquez sur Commiter les changements.

   Le python-app.yml fichier de flux de travail est ajouté au .github/workflows répertoire de votre référentiel.

Spécification d’une version Python

Pour utiliser une version préinstallée de Python ou PyPy sur un exécuteur hébergé par GitHub, utilisez l’action setup-python. Cette action recherche une version spécifique de Python ou PyPy à partir du cache des outils sur chaque exécuteur et ajoute les fichiers binaires nécessaires à PATH, qui persiste pour le reste du travail. Si une version spécifique de Python n’est pas préinstallée dans le cache des outils, l’action setup-python télécharge et configure la version appropriée à partir du référentiel python-versions.

L’utilisation de l’action setup-python est la méthode recommandée d’utiliser Python avec GitHub Actions, car elle garantit un comportement cohérent entre différents exécuteurs et différentes versions de Python. Si vous utilisez un exécuteur auto-hébergé, vous devez installer Python et l’ajouter à PATH. Pour plus d’informations, consultez l’action setup-python.

Le tableau ci-dessous décrit les emplacements du cache des outils de chaque GitHub runner hébergé.