Improve release creation and publishing

The CI now also creates a draft release

Signed-off-by: Philippe Ombredanne <[email protected]>

Author: pombredanne

.github/workflows/pypi-release.yml

@@ -1,32 +1,82 @@
-name: Release library as a PyPI wheel and sdist on tag
+name: Create library release archives, create a GH release and publish PyPI wheel and sdist on tag in main branch
+
+
+# This is executed automatically on a tag in the main branch
+
+# Summary of the steps:
+# - build wheels and sdist
+# - upload wheels and sdist to PyPI
+# - create gh-release and upload wheels and dists there
 
 on:
-  release:
-    types: [created]
+  workflow_dispatch:
+  push:
+    tags:
+      - "v*.*.*"
 
 jobs:
-  build-and-publish-to-pypi:
+  build-pypi-distribs:
     name: Build and publish library to PyPI
     runs-on: ubuntu-24.04
+
     steps:
-     - uses: actions/checkout@v4
+      - uses: actions/checkout@v4
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: 3.12
 
-     - name: Set up Python
-       uses: actions/setup-python@v5
-       with:
-         python-version: 3.12
+      - name: Install pypa/build and twine
+        run: python -m pip install --user --upgrade build twine packaging pip setuptools
 
-     - name: Install pypa/build and twine
-       run: python -m pip install --user --upgrade build twine packaging pip setuptools
+      - name: Build a binary wheel and a source tarball
+        run: python -m build --sdist --wheel --outdir dist/
 
-     - name: Build a binary wheel and a source tarball
-       run: python -m build --sdist --wheel --outdir dist/ .
+      - name: Validate wheel and sdis for Pypi
+        run: python -m twine check dist/*
+
+      - name: Upload built archives
+        uses: actions/upload-artifact@v4
+        with:
+          name: pypi_archives
+          path: dist/*
+
+
+  create-gh-release:
+    name: Create GH release
+    needs:
+      - build-pypi-distribs
+    runs-on: ubuntu-24.04
 
-     - name: Check wheel and sdist with twine
-       run: python -m twine check dist/*
+    steps:
+      - name: Download built archives
+        uses: actions/download-artifact@v4
+        with:
+          name: pypi_archives
+          path: dist
+
+      - name: Create GH release
+        uses: softprops/action-gh-release@v2
+        with:
+          draft: true
+          files: dist/*
+
+
+  create-pypi-release:
+    name: Create PyPI release
+    needs:
+      - create-gh-release
+    runs-on: ubuntu-24.04
+
+    steps:
+      - name: Download built archives
+        uses: actions/download-artifact@v4
+        with:
+          name: pypi_archives
+          path: dist
 
-     - name: Publish distribution to PyPI
-       if: startsWith(github.ref, 'refs/tags')
-       uses: pypa/gh-action-pypi-publish@release/v1
-       with:
-         password: ${{ secrets.PYPI_API_TOKEN }}
+      - name: Publish to PyPI
+        if: startsWith(github.ref, 'refs/tags')
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.PYPI_API_TOKEN }}