mirror of
https://github.com/tj-actions/branch-names.git
synced 2024-11-23 14:53:50 +08:00
:octocat: Github action to retrieve branch or tag names with support for all events.
actionsbranchbranchesbranchingcdcici-cdgit-branchgithubgithub-actionsgithub-actions-cigithub-branch-testgithub-branchesworkflows
.github | ||
.gitignore | ||
action.yml | ||
CONTRIBUTING.md | ||
HISTORY.md | ||
LICENSE | ||
README.md |
branch-names
Get branch information without the /ref/*
prefix
...
steps:
- uses: actions/checkout@v2
- name: Get branch names
uses: tj-actions/branch-names@v1
id: branch-names
- name: Get Ref brach name
run: |
echo "${{ steps.branch-name.outputs.ref_branch }}" # Outputs: "main" for non PR branches | "1/merge" for a PR branch
- name: Get Head Ref branch name
if: github.event_name == 'pull_request'
run: |
echo "${{ steps.branch-name.outputs.head_ref_branch }}" # Outputs: "feature/test" current PR branch.
- name: Get Base Ref branch name
if: github.event_name == 'pull_request'
run: |
echo "${{ steps.branch-name.outputs.base_ref_branch }}" # Outputs: "main" for main <- PR branch.
Possible usage with actions/checkout@v2:
- name: Get branch names.
id: branch-names
uses: tj-actions/branch-names@v1
- uses: actions/checkout@v2
with:
ref: ${{ steps.branch-names.outputs.base_ref_branch }}
Inputs
Input | type | required | default |
---|---|---|---|
token | string |
false |
${{ github.token }} |
Outputs
Output | type | Example | Description |
---|---|---|---|
base_ref_branch | string |
main |
The target branch of a pull request |
head_ref_branch | string |
feature/test |
The source branch of a pull request |
ref_branch | string |
1/merge |
The branch that triggered the workflow run |
- Free software: MIT license
Credits
This package was created with Cookiecutter.
Report Bugs
Report bugs at https://github.com/tj-actions/branch-names/issues.
If you are reporting a bug, please include:
- Your operating system name and version.
- Any details about your workflow that might be helpful in troubleshooting.
- Detailed steps to reproduce the bug.