configure GITHUB Actions To Upload Python Package to PypI.github.io

Condition préalable

• ? Un package Python à télécharger
• Un compte github
• Un compte PYPI
• ? Un jeton API PYPI

Générer un jeton API PYPI

1. Connectez-vous à votre compte PYPI : accédez au site Web PYPI (https://pypi.org/) et connectez-vous à votre compte.

2. Accédez à "Paramètres du compte" : cliquez sur votre nom d'utilisateur dans le coin supérieur droit et sélectionnez "Paramètres de compte" dans le menu déroulant.

3. Créez un nouveau jeton API : faites défiler vers le bas vers la section "Tokens API" et cliquez sur le bouton "Créer un jeton API".

4. Nommez votre jeton : donnez un nom à votre jeton qui vous aidera à identifier son objectif (par exemple, "Github Actions").

5. Générez le jeton : cliquez sur le bouton "Générer le jeton". Le jeton sera affiché à l'écran. Copiez ce jeton et gardez-le en sécurité, car vous ne pourrez pas le revoir.

6. Ajoutez le jeton aux secrets GitHub : accédez à votre référentiel GitHub, cliquez sur "Paramètres", puis "Secrets", puis cliquez sur "Nouveau secret de référentiel". Nommez votre secret (par exemple, TEST_PYPI_API_TOKEN ) et collez le jeton API PYPI que vous avez généré. Cliquez sur "Ajouter un secret" pour l'enregistrer.

Mesures

1. Créez votre package Python : assurez-vous que votre package est structuré correctement et contient tous les fichiers nécessaires.

2. ? Téléchargez votre package sur GitHub : poussez votre package Python dans un référentiel GitHub.

3. Ouvrez votre référentiel sur GitHub : accédez à la page de votre référentiel sur GitHub.

4. Accédez aux actions GitHub : cliquez sur l'onglet "Actions" dans votre référentiel.

5. ➕ Créez un nouveau workflow : cliquez sur "Nouveau workflow" et sélectionnez "Publier Python Package".

6. ? Modifiez le fichier Workflow : un nouveau fichier YAML sera créé dans le dossier .github/workflows . Remplacez son contenu par ce qui suit:

 name : Upload Python Package

on :
  push :
    tags :
    - ' * '

jobs :
  deploy :
    runs-on : ubuntu-latest

    steps :
    - uses : actions/checkout@v2
    - uses : actions/setup-python@v2
    - name : Install dependencies
      run : |
        python -m pip install --upgrade pip
        pip install setuptools wheel twine
    - name : Build and publish
      env :
        TWINE_USERNAME : __token__
        TWINE_PASSWORD : ${{ secrets.TEST_PYPI_API_TOKEN }}
      run : |
        python setup.py sdist bdist_wheel
        # twine upload --repository testpypi dist/* --skip-existing
      

• Twine Téléchargez DIST / * - Utilisation existante de Skip pour PYPI dans YML 7.Tag Your Commits: Utilisez Git Tag -a -M "Version" pour marquer un engagement avec un numéro de version avant de le pousser. Par exemple, Git Tag -a V1.0 -M "Version 1.0"

Poussez vos balises: utilisez Git Push Origin pour pousser vos balises vers le référentiel distant. Par exemple, Git Push Origin v1.0.

Après avoir configuré cela, chaque fois que vous poussez un engagement avec une version taguée, les actions GitHub construisent et téléchargent votre package sur PYPI.