GHA: Comment dev build numbers on PR after merge (#510)

Use GHA to leave a comment with on a PR after its merged
with a link to the corresponding dev build on PyPI and instructions
on how to install it.

Author: jorisroovers

.github/workflows/ci.yml

@@ -238,3 +238,29 @@ jobs:
     secrets: inherit # pass all secrets (required to access secrets in a called workflow)
     with:
       docs_version: "dev"
+
+  # After merging a PR, leave a comment on the PR with a link to the new dev build
+  notify:
+    needs:
+      - auto-publish-dev
+    if: github.ref == 'refs/heads/main'
+    runs-on: "ubuntu-latest"
+    steps:
+      - uses: actions/github-script@v6
+        with:
+          script: |
+            const body = `Build \
+            [${{ needs.auto-publish-dev.outputs.gitlint_version }}](https://pypi.org/project/gitlint/${{ needs.auto-publish-dev.outputs.gitlint_version }}) \
+            is now available on PyPI!
+
+            Install using:
+            \`\`\`sh
+            pip install gitlint==${{ needs.auto-publish-dev.outputs.gitlint_version }}
+            \`\`\`
+            `;
+            github.rest.issues.createComment({
+              issue_number: context.issue.number,
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              body: body
+            });

.github/workflows/publish-release.yml

@@ -18,6 +18,10 @@ on:
         required: true
         type: string
         default: "latest_dev"
+    outputs:
+      gitlint_version:
+        description: "Gitlint version that was published"
+        value: ${{ jobs.publish.outputs.gitlint_version }}
 
   # Manually trigger a release
   workflow_dispatch: