#123: Release to PyPI with digital attestations

PEP 740 - Index support for digital attestations
https://packaging.python.org/en/latest/guides/publishing-package-distribution-releases-using-github-actions-ci-cd-workflows/

Author: shimizukawa

.github/workflows/ci.yml

@@ -78,7 +78,30 @@ jobs:
           name: distributions
           path: dist/
 
-  pypi-publish:
+  publish-to-testpypi:
+    name: Upload release to TestPyPI
+    if: github.repository_owner == 'sphinx-doc' && github.ref == 'refs/heads/master'  # only publish to TestPyPI on push to master
+    needs:
+      - build
+    runs-on: ubuntu-latest
+    environment:
+      name: testpypi
+      url: https://test.pypi.org/p/sphinx-intl
+    permissions:
+      id-token: write  # IMPORTANT: this permission is mandatory for trusted publishing
+    steps:
+      - name: Download all the dists
+        uses: actions/download-artifact@v4
+        with:
+          name: distributions
+          path: dist/
+      - name: Publish package distributions to TestPyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          verbose: true
+          repository-url: https://test.pypi.org/legacy/
+
+  publish-to-pypi:
     name: Upload release to PyPI
     if: github.repository_owner == 'sphinx-doc' && startsWith(github.ref, 'refs/tags/')
     needs:
@@ -102,36 +125,45 @@ jobs:
         with:
           verbose: true
 
-          # for test
-          password: ${{ secrets.TESTPYPI_TOKEN }}
-          repository_url: https://test.pypi.org/legacy/
-
-          # for production
-          # password: ${{ secrets.PYPI_TOKEN }}
-
   github-release:
-    name: GitHub release
+    name: Sign the Python 🐍 distribution 📦 with Sigstore and upload them to GitHub Release
     if: github.repository_owner == 'sphinx-doc'
+    needs:
+    - publish-to-pypi
     runs-on: ubuntu-latest
     needs:
       - pypi-publish
     environment: release
     permissions:
-      contents: write  # for softprops/action-gh-release to create GitHub release
-
+      contents: write  # IMPORTANT: mandatory for making GitHub Releases
+      id-token: write  # IMPORTANT: mandatory for sigstore
     steps:
-      - uses: actions/checkout@v4
-        with:
-          persist-credentials: false
-      - name: Get release version
-        id: get_version
-        uses: actions/github-script@v7
+      - name: Download all the dists
+        uses: actions/download-artifact@v4
         with:
-          script: core.setOutput('version', context.ref.replace("refs/tags/", ""))
-
-      - name: Create GitHub release
-        uses: softprops/action-gh-release@v2
-        if: startsWith(github.ref, 'refs/tags/')
+          name: distributions
+          path: dist/
+      - name: Sign the dists with Sigstore
+        uses: sigstore/[email protected]
         with:
-          name: "sphinx-intl ${{ steps.get_version.outputs.version }}"
-          body: "Changelog: https://sphinx-intl.readthedocs.io/en/master/changes.html"
+          inputs: >-
+            ./dist/*.tar.gz
+            ./dist/*.whl
+      - name: Create GitHub Release
+        env:
+          GITHUB_TOKEN: ${{ github.token }}
+        run: >-
+          gh release create
+          "$GITHUB_REF_NAME"
+          --repo "$GITHUB_REPOSITORY"
+          --notes ""
+      - name: Upload artifact signatures to GitHub Release
+        env:
+          GITHUB_TOKEN: ${{ github.token }}
+        # Upload to GitHub Release using the `gh` CLI.
+        # `dist/` contains the built packages, and the
+        # sigstore-produced signatures and certificates.
+        run: >-
+          gh release upload
+          "$GITHUB_REF_NAME" dist/**
+          --repo "$GITHUB_REPOSITORY"