This action generates notifications for expired pull requests. A pull request is considered expired depending on the default-ttl and/or labels-ttl.
Given a default PR TTL and a set of TTL per label, it calculates if the PR is expired or not based on its creation date and the last reopened event. If it is, it will generate notifications for its pending reviewers.
The PRs without reviewers and draft PRs will be discarded.
The GitHub token needed to request info about the PRs of the repo and reviewers.
The elapsed time (in seconds) to consider a pull request expired if the interval between its creation time and now exceeds that time. If it is null, the pull request will not be expired by default.
TTLs by labels. If the pull request contains any label of them, the action will take the MIN TTL of the matched labels to decide if it is expired or not.
The pull request to generate notifications. If it is null, the action will get all the pull requests of the repository.
If a PR has this label, the action will not notify to its reviewers.
The notifications generated.
...
jobs:
get-notifications:
name: Get notifications
runs-on: ubuntu-latest
outputs:
notifications: ${{ steps.generator.outputs.notifications }}
steps:
- name: Generation step
uses: amegias/[email protected]
id: generator
with:
access-token: ${{ secrets.GITHUB_TOKEN }}
default-ttl: '259200' # 3 days
labels-ttl: '{ "bug": 86400 }' # bug: 1 dayAn array of notifications with the pull request and recipient info.
[
{
"pullRequest": {
"id": 1,
"title": "My PR #1",
"url": "https://api.github.com/repos/me/myrepo/pulls/1",
"number": 1,
"createdAt": "2023-04-03T07:52:45Z",
"owner": "anOwner",
"openedAt": "2023-10-22T20:46:04Z",
"expiration": {
"ttl": 1,
"expiredAt": "2023-10-22T20:46:05Z"
}
},
"recipient": {
"login": "login1",
"email": "[email protected]"
}
},
{
"pullRequest": {
"id": 1,
"title": "My PR #1",
"url": "https://api.github.com/repos/me/myrepo/pulls/1",
"number": 1,
"createdAt": "2023-04-03T07:52:45Z",
"owner": "anOwner",
"openedAt": "2023-10-22T20:46:04Z",
"expiration": {
"ttl": 1,
"expiredAt": "2023-10-22T20:46:05Z"
}
},
"recipient": {
"login": "login2",
"email": "[email protected]"
}
},
{
"pullRequest": {
"id": 2,
"title": "My PR #2",
"url": "https://api.github.com/repos/me/myrepo/pulls/1",
"number": 2,
"createdAt": "2023-04-03T07:52:45Z",
"owner": "anOwner",
"openedAt": "2023-10-22T20:46:04Z",
"expiration": {
"ttl": 1,
"expiredAt": "2023-10-22T20:46:05Z",
"label": "anyLabel"
}
},
"recipient": {
"login": "login1",
"email": "[email protected]"
}
}
]You can handle its output like:
send-notification:
name: (Simulate) Send notification
needs: get-notifications
if: ${{ needs.get-notifications.outputs.notifications != '[]' }}
runs-on: ubuntu-latest
strategy:
matrix:
notifications: ${{ fromJSON(needs.get-notifications.outputs.notifications) }}
steps:
- name: Print result
run: echo "${{ matrix.notifications.pullRequest.url }} must be reviewed by ${{ matrix.notifications.recipient.login }}"