stdlib/.github/workflows/generate_pr_commit_message.yml at develop · schnrj/stdlib · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
#/
# @license Apache-2.0
#
# Copyright (c) 2024 The Stdlib Authors.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#    http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
#/

# Workflow name:
name: generate_pr_commit_message

# Workflow triggers:
on:
  pull_request_target:
    types:
      - labeled

# Global permissions:
permissions:
  # Allow read-only access to the repository contents:
  contents: read

# Workflow jobs:
jobs:

  # Job to generate commit message draft:
  generate-commit-message:

    # Define a display name:
    name: 'Generate PR Commit Message Draft'

    # Define the type of virtual host machine:
    runs-on: ubuntu-latest

    # Ensure the job only runs when the specified label is added:
    if: github.event.label.name == 'Ready to Merge'

    # Define environment variables:
    env:
      PR_NUMBER: ${{ github.event.pull_request.number }}

    # Define the sequence of job steps...
    steps:
      # Checkout repository:
      - name: 'Checkout repository'
        # Pin action to full length commit SHA
        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2
        with:
          # Ensure we have access to the scripts directory and .mailmap file for generating the commit message:
          sparse-checkout: |
            .github/workflows/scripts
            .mailmap
          sparse-checkout-cone-mode: false

      # Generate commit message:
      - name: 'Generate commit message'
        id: commit_message
        shell: bash {0} # Omit -e to avoid triggering a failure if the script returns a non-zero exit code
        run: |
          COMMIT_MESSAGE=$($GITHUB_WORKSPACE/.github/workflows/scripts/generate_pr_commit_message $PR_NUMBER)
          EXIT_CODE=$?

          echo "commit_message<<EOF" >> $GITHUB_OUTPUT
          echo "$COMMIT_MESSAGE" >> $GITHUB_OUTPUT
          echo "EOF" >> $GITHUB_OUTPUT

          if [ $EXIT_CODE -eq 200 ]; then
            echo "has_tracking_issue=true" >> $GITHUB_OUTPUT
          else
            echo "has_tracking_issue=false" >> $GITHUB_OUTPUT
          fi

          # Ensure the script itself doesn't fail the workflow:
          exit 0

      # Check if the commit message already exists in the PR comments:
      - name: 'Check if commit message already exists in PR comments'
        uses: peter-evans/find-comment@3eae4d37986fb5a8592848f6a574fdf654e61f9e # v3.1.0
        id: fc
        with:
          issue-number: ${{ github.event.pull_request.number }}
          body-includes: '<!-- PR_COMMIT_MESSAGE -->'

      # Post commit message as PR comment:
      - name: 'Post commit message as PR comment'
        # Pin action to full length commit SHA
        uses: peter-evans/create-or-update-comment@71345be0265236311c031f5c7866368bd1eff043 # v4.0.0
        with:
          token: ${{ secrets.STDLIB_BOT_PAT_REPO_WRITE }}
          comment-id: ${{ steps.fc.outputs.comment-id }}
          issue-number: ${{ github.event.pull_request.number }}
          edit-mode: replace
          body: |
            ### PR Commit Message

            ```text
            ${{ steps.commit_message.outputs.commit_message }}
            ```

            *Please review the above commit message and make any necessary adjustments.*

            ${{ steps.commit_message.outputs.has_tracking_issue == 'true' && '⚠️ **Action Required**: This PR references tracking issues. Please update the PR description to replace any "Closes", "Fixes", or "Resolves" keywords with "Ref" when referencing these issues.' || '' }}

            <!-- PR_COMMIT_MESSAGE -->