https://github.com/binarymuse/tip-of-branch
A GitHub Action to ensure the triggering commit is still at the tip of a given branch
https://github.com/binarymuse/tip-of-branch
Last synced: 5 months ago
JSON representation
A GitHub Action to ensure the triggering commit is still at the tip of a given branch
- Host: GitHub
- URL: https://github.com/binarymuse/tip-of-branch
- Owner: BinaryMuse
- Created: 2019-05-30T20:53:19.000Z (about 7 years ago)
- Default Branch: master
- Last Pushed: 2022-01-22T05:06:47.000Z (over 4 years ago)
- Last Synced: 2025-10-23T10:49:23.288Z (8 months ago)
- Language: JavaScript
- Homepage:
- Size: 70.3 KB
- Stars: 4
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# tip-of-branch GitHub Action
This action acts as a filter for `push`-based actions to ensure that the triggering event meets the following qualifications:
* The event was not generated by a branch deletion
* The branch the triggering commit was pushed to matches one of the branches listed in the arguments
* The triggering commit is the head of that branch at the time the action runs
This helps prevent subtle race conditions when multiple commits or PRs are committed or merged to master and multiple workflows that automatically deploy changes run simultaneously, since only the most recently created commit will pass the check.
## Usage
In your workflow:
```workflow
action "your-action" {
uses = "BinaryMuse/tip-of-branch@master"
args = "master"
secrets = [ "GITHUB_TOKEN" ]
}
```
`args` can be a single branch, or can be multiple branches if you want to match any of them:
```workflow
action "your-action" {
uses = "BinaryMuse/tip-of-branch@master"
args = [ "master", "some-other-branch" ]
secrets = [ "GITHUB_TOKEN" ]
}
```
You must include the `GITHUB_TOKEN` secret in order for the action to reach the API and ensure that the commit is still at the head of the branch.