rlespinasse/github-slug-action
1
0
Fork 0
mirror of https://github.com/rlespinasse/github-slug-action.git synced 2026-06-13 01:51:09 +00:00
Code Issues Packages Projects Releases Wiki Activity

Compare commits

base: rlespinasse:v4.x
Branches Tags
rlespinasse:v5.x
rlespinasse:v5.6.0 rlespinasse:v5 rlespinasse:v5.5.0 rlespinasse:v5.4.0 rlespinasse:v5.3.0 rlespinasse:v5.2.0 rlespinasse:v4.x rlespinasse:v5.1.0 rlespinasse:v5.0.0 rlespinasse:v4 rlespinasse:v4.5.0 rlespinasse:v3.x rlespinasse:v3 rlespinasse:v3.9.0 rlespinasse:v3.8.0 rlespinasse:v4.4.1 rlespinasse:v4.4.0 rlespinasse:v4.3.2 rlespinasse:v4.3.1 rlespinasse:v3.7.1 rlespinasse:v4.3.0 rlespinasse:v3.7.0 rlespinasse:v4.2.5 rlespinasse:3.6.1 rlespinasse:4.2.5 rlespinasse:4.2.4 rlespinasse:4.2.3 rlespinasse:4.2.2 rlespinasse:4.2.1 rlespinasse:4.2.0 rlespinasse:4.1.0 rlespinasse:4.0.1 rlespinasse:4.0.0 rlespinasse:3.6.0 rlespinasse:v2.x rlespinasse:2.2.0 rlespinasse:1.2.0 rlespinasse:v1.1.x rlespinasse:3.5.1 rlespinasse:3.5.0 rlespinasse:3.4.0 rlespinasse:3.3.0 rlespinasse:3.2.0 rlespinasse:3.1.0 rlespinasse:3.0.0 rlespinasse:2.1.1 rlespinasse:1.1.1 rlespinasse:2.1.0 rlespinasse:2.0.0 rlespinasse:1.1.0 rlespinasse:1.0.2 rlespinasse:1.0.1 rlespinasse:1.0.0
...
compare: rlespinasse:v5.0.0
Branches Tags
rlespinasse:v5.x
rlespinasse:v5.6.0 rlespinasse:v5 rlespinasse:v5.5.0 rlespinasse:v5.4.0 rlespinasse:v5.3.0 rlespinasse:v5.2.0 rlespinasse:v4.x rlespinasse:v5.1.0 rlespinasse:v5.0.0 rlespinasse:v4 rlespinasse:v4.5.0 rlespinasse:v3.x rlespinasse:v3 rlespinasse:v3.9.0 rlespinasse:v3.8.0 rlespinasse:v4.4.1 rlespinasse:v4.4.0 rlespinasse:v4.3.2 rlespinasse:v4.3.1 rlespinasse:v3.7.1 rlespinasse:v4.3.0 rlespinasse:v3.7.0 rlespinasse:v4.2.5 rlespinasse:3.6.1 rlespinasse:4.2.5 rlespinasse:4.2.4 rlespinasse:4.2.3 rlespinasse:4.2.2 rlespinasse:4.2.1 rlespinasse:4.2.0 rlespinasse:4.1.0 rlespinasse:4.0.1 rlespinasse:4.0.0 rlespinasse:3.6.0 rlespinasse:v2.x rlespinasse:2.2.0 rlespinasse:1.2.0 rlespinasse:v1.1.x rlespinasse:3.5.1 rlespinasse:3.5.0 rlespinasse:3.4.0 rlespinasse:3.3.0 rlespinasse:3.2.0 rlespinasse:3.1.0 rlespinasse:3.0.0 rlespinasse:2.1.1 rlespinasse:1.1.1 rlespinasse:2.1.0 rlespinasse:2.0.0 rlespinasse:1.1.0 rlespinasse:1.0.2 rlespinasse:1.0.1 rlespinasse:1.0.0

5 Commits
v4.x ... v5.0.0

Author SHA1 Message Date
Romain Lespinasse
aba9f8db6e feat: use GITHUB_REF_POINT as variable for the branch name (#149) 
BREAKING CHANGE: Change the behavior of GITHUB_REF_NAME to match the default GitHub Action behavior,
BREAKING CHANGE: Introduce GITHUB_REF_POINT as a replacement for GITHUB_REF_NAME to match this GitHub Action behavior in v4.
 2024-11-06 00:16:25 +01:00
Romain Lespinasse
63a442f83b build: prepare v5.x branch (#148) 
Signed-off-by: Romain Lespinasse <romain.lespinasse@gmail.com>
 2024-11-01 10:11:33 +01:00
dependabot[bot]
c6c92fed42 ci: bump github/super-linter from 6 to 7 (#146) 
Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
 2024-09-02 23:45:16 +02:00
Romain Lespinasse
7c4f489627 build: cleanup old npm packages from GitHub dependency graph 
Signed-off-by: Romain Lespinasse <romain.lespinasse@gmail.com>
 2024-07-16 08:54:31 +02:00
Romain Lespinasse
45c9d47db8 docs(security): update supported versions 
Signed-off-by: Romain Lespinasse <romain.lespinasse@gmail.com>
 2024-06-24 22:37:23 +02:00
14 changed files with 401 additions and 360 deletions
Expand all files Collapse all files

13
.github/workflows/linter.yml vendored
View File

@@ -3,6 +3,8 @@ name: Lint Code Base
on: pull_request on: pull_request
permissions: read-all
jobs: jobs:
build: build:
name: Lint Code Base name: Lint Code Base
@@ -15,13 +17,16 @@ jobs:
- name: Checkout Code - name: Checkout Code
uses: actions/checkout@v4 uses: actions/checkout@v4
with: with:
# Full git history is needed to get a proper list of changed files within `super-linter` # Full git history is needed to get a proper
# list of changed files within `super-linter`
fetch-depth: 0 fetch-depth: 0
- name: Lint Code Base - name: Lint Code Base
uses: github/super-linter@v6 uses: github/super-linter@v7
env: env:
VALIDATE_ALL_CODEBASE: false VALIDATE_ALL_CODEBASE: false
DEFAULT_BRANCH: v4.x VALIDATE_JSCPD: false
VALIDATE_JSON_PRETTIER: false
VALIDATE_MARKDOWN_PRETTIER: false
DEFAULT_BRANCH: v5.x
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

128
.github/workflows/v4-tests-and-release.yml → .github/workflows/v5-tests-and-release.yml vendored
View File

@@ -1,8 +1,9 @@
name: '[v4] Test and Release' name: "[v5] Test and Release"
on: [push, pull_request] on: [push, pull_request]
permissions: read-all
jobs: jobs:
check-v3compatibility: check-v4-compatibility:
name: 'Check v3 compatibility' name: "Check v4 compatibility"
strategy: strategy:
fail-fast: false fail-fast: false
matrix: matrix:
@@ -12,14 +13,13 @@ jobs:
- name: Checkout - name: Checkout
uses: actions/checkout@v4 uses: actions/checkout@v4
- name: Load using v4.x with prefix - name: Load this action from HEAD
uses: ./ uses: ./
- name: Load using v4
uses: rlespinasse/github-slug-action@v4
with: with:
prefix: V4_ prefix: V4_
short-length: 8
- name: Load using v3.x
uses: rlespinasse/github-slug-action@v3.x
- name: Validate // Partial variables - name: Validate // Partial variables
run: | run: |
@@ -68,13 +68,13 @@ jobs:
[[ "${{ env.GITHUB_EVENT_REF_SLUG_URL_CS }}" == "${{ env.V4_GITHUB_EVENT_REF_SLUG_URL_CS }}" ]] [[ "${{ env.GITHUB_EVENT_REF_SLUG_URL_CS }}" == "${{ env.V4_GITHUB_EVENT_REF_SLUG_URL_CS }}" ]]
shell: bash shell: bash
- name: Validate // Ref Name - name: Validate // Ref Point
run: | run: |
[[ "${{ env.GITHUB_REF_NAME }}" == "${{ env.V4_GITHUB_REF_NAME }}" ]] [[ "${{ env.GITHUB_REF_POINT }}" == "${{ env.V4_GITHUB_REF_NAME }}" ]]
[[ "${{ env.GITHUB_REF_NAME_SLUG }}" == "${{ env.V4_GITHUB_REF_NAME_SLUG }}" ]] [[ "${{ env.GITHUB_REF_POINT_SLUG }}" == "${{ env.V4_GITHUB_REF_NAME_SLUG }}" ]]
[[ "${{ env.GITHUB_REF_NAME_SLUG_URL }}" == "${{ env.V4_GITHUB_REF_NAME_SLUG_URL }}" ]] [[ "${{ env.GITHUB_REF_POINT_SLUG_URL }}" == "${{ env.V4_GITHUB_REF_NAME_SLUG_URL }}" ]]
[[ "${{ env.GITHUB_REF_NAME_SLUG_CS }}" == "${{ env.V4_GITHUB_REF_NAME_SLUG_CS }}" ]] [[ "${{ env.GITHUB_REF_POINT_SLUG_CS }}" == "${{ env.V4_GITHUB_REF_NAME_SLUG_CS }}" ]]
[[ "${{ env.GITHUB_REF_NAME_SLUG_URL_CS }}" == "${{ env.V4_GITHUB_REF_NAME_SLUG_URL_CS }}" ]] [[ "${{ env.GITHUB_REF_POINT_SLUG_URL_CS }}" == "${{ env.V4_GITHUB_REF_NAME_SLUG_URL_CS }}" ]]
shell: bash shell: bash
- name: Validate // Short SHA variables - name: Validate // Short SHA variables
@@ -83,10 +83,10 @@ jobs:
[[ "${{ env.GITHUB_EVENT_PULL_REQUEST_HEAD_SHA_SHORT }}" == "${{ env.V4_GITHUB_EVENT_PULL_REQUEST_HEAD_SHA_SHORT }}" ]] [[ "${{ env.GITHUB_EVENT_PULL_REQUEST_HEAD_SHA_SHORT }}" == "${{ env.V4_GITHUB_EVENT_PULL_REQUEST_HEAD_SHA_SHORT }}" ]]
shell: bash shell: bash
check-v3compatibility-without-checkout: check-v4-compatibility-without-checkout:
name: 'Check v3 compatibility (without checkout)' name: "Check v4 compatibility (without checkout)"
needs: needs:
- check-v3compatibility - check-v4-compatibility
strategy: strategy:
fail-fast: false fail-fast: false
matrix: matrix:
@@ -99,14 +99,13 @@ jobs:
path: this-action path: this-action
ref: ${{ github.ref }} ref: ${{ github.ref }}
- name: Load using v4.x with prefix - name: Load this action from HEAD
uses: ./this-action uses: ./this-action
- name: Load using v4
uses: rlespinasse/github-slug-action@v4
with: with:
prefix: V4_ prefix: V4_
short-length: 8
- name: Load using v3.x
uses: rlespinasse/github-slug-action@v3.x
- name: Validate // Short SHA variables - name: Validate // Short SHA variables
run: | run: |
@@ -115,7 +114,7 @@ jobs:
shell: bash shell: bash
display: display:
name: 'Display produced variables' name: "Display produced variables"
strategy: strategy:
fail-fast: false fail-fast: false
matrix: matrix:
@@ -125,7 +124,7 @@ jobs:
- name: Checkout - name: Checkout
uses: actions/checkout@v4 uses: actions/checkout@v4
- name: Load using v4.x - name: Load this action from HEAD
uses: ./ uses: ./
- name: Partial variables - name: Partial variables
@@ -140,48 +139,55 @@ jobs:
echo "repository owner : ${{ env.GITHUB_REPOSITORY_OWNER_PART_SLUG }}" echo "repository owner : ${{ env.GITHUB_REPOSITORY_OWNER_PART_SLUG }}"
echo "repository name : ${{ env.GITHUB_REPOSITORY_NAME_PART_SLUG }}" echo "repository name : ${{ env.GITHUB_REPOSITORY_NAME_PART_SLUG }}"
echo "ref : ${{ env.GITHUB_REF_SLUG }}" echo "ref : ${{ env.GITHUB_REF_SLUG }}"
echo "ref name : ${{ env.GITHUB_REF_NAME_SLUG }}"
echo "head ref : ${{ env.GITHUB_HEAD_REF_SLUG }}" echo "head ref : ${{ env.GITHUB_HEAD_REF_SLUG }}"
echo "base ref : ${{ env.GITHUB_BASE_REF_SLUG }}" echo "base ref : ${{ env.GITHUB_BASE_REF_SLUG }}"
echo "event ref : ${{ env.GITHUB_EVENT_REF_SLUG }}" echo "event ref : ${{ env.GITHUB_EVENT_REF_SLUG }}"
shell: bash shell: bash
- name: Slug variables (Case Sensitive) - name: Slug variables (Case Sensitive)
run: | run: |
echo "repository : ${{ env.GITHUB_REPOSITORY_SLUG_CS }}" echo "repository : ${{ env.GITHUB_REPOSITORY_SLUG_CS }}"
echo "repository owner : ${{ env.GITHUB_REPOSITORY_OWNER_PART_SLUG_CS }}" echo "repository owner : ${{ env.GITHUB_REPOSITORY_OWNER_PART_SLUG_CS }}"
echo "repository name : ${{ env.GITHUB_REPOSITORY_NAME_PART_SLUG_CS }}" echo "repository name : ${{ env.GITHUB_REPOSITORY_NAME_PART_SLUG_CS }}"
echo "ref : ${{ env.GITHUB_REF_SLUG_CS }}" echo "ref : ${{ env.GITHUB_REF_SLUG_CS }}"
echo "ref name : ${{ env.GITHUB_REF_NAME_SLUG_CS }}"
echo "head ref : ${{ env.GITHUB_HEAD_REF_SLUG_CS }}" echo "head ref : ${{ env.GITHUB_HEAD_REF_SLUG_CS }}"
echo "base ref : ${{ env.GITHUB_BASE_REF_SLUG_CS }}" echo "base ref : ${{ env.GITHUB_BASE_REF_SLUG_CS }}"
echo "event ref : ${{ env.GITHUB_EVENT_REF_SLUG_CS }}" echo "event ref : ${{ env.GITHUB_EVENT_REF_SLUG_CS }}"
shell: bash shell: bash
- name: Slug URL variables - name: Slug URL variables
run: | run: |
echo "repository : ${{ env.GITHUB_REPOSITORY_SLUG_URL }}" echo "repository : ${{ env.GITHUB_REPOSITORY_SLUG_URL }}"
echo "repository owner : ${{ env.GITHUB_REPOSITORY_OWNER_PART_SLUG_URL }}" echo "repository owner : ${{ env.GITHUB_REPOSITORY_OWNER_PART_SLUG_URL }}"
echo "repository name : ${{ env.GITHUB_REPOSITORY_NAME_PART_SLUG_URL }}" echo "repository name : ${{ env.GITHUB_REPOSITORY_NAME_PART_SLUG_URL }}"
echo "ref : ${{ env.GITHUB_REF_SLUG_URL }}" echo "ref : ${{ env.GITHUB_REF_SLUG_URL }}"
echo "ref name : ${{ env.GITHUB_REF_NAME_SLUG_URL }}"
echo "head ref : ${{ env.GITHUB_HEAD_REF_SLUG_URL }}" echo "head ref : ${{ env.GITHUB_HEAD_REF_SLUG_URL }}"
echo "base ref : ${{ env.GITHUB_BASE_REF_SLUG_URL }}" echo "base ref : ${{ env.GITHUB_BASE_REF_SLUG_URL }}"
echo "event ref : ${{ env.GITHUB_EVENT_REF_SLUG_URL }}" echo "event ref : ${{ env.GITHUB_EVENT_REF_SLUG_URL }}"
shell: bash shell: bash
- name: Slug URL variables (Case Sensitive) - name: Slug URL variables (Case Sensitive)
run: | run: |
echo "repository : ${{ env.GITHUB_REPOSITORY_SLUG_URL_CS }}" echo "repository : ${{ env.GITHUB_REPOSITORY_SLUG_URL_CS }}"
echo "repository owner : ${{ env.GITHUB_REPOSITORY_OWNER_PART_SLUG_URL_CS }}" echo "repository owner : ${{ env.GITHUB_REPOSITORY_OWNER_PART_SLUG_URL_CS }}"
echo "repository name : ${{ env.GITHUB_REPOSITORY_NAME_PART_SLUG_URL_CS }}" echo "repository name : ${{ env.GITHUB_REPOSITORY_NAME_PART_SLUG_URL_CS }}"
echo "ref : ${{ env.GITHUB_REF_SLUG_URL_CS }}" echo "ref : ${{ env.GITHUB_REF_SLUG_URL_CS }}"
echo "ref name : ${{ env.GITHUB_REF_NAME_SLUG_URL_CS }}"
echo "head ref : ${{ env.GITHUB_HEAD_REF_SLUG_URL_CS }}" echo "head ref : ${{ env.GITHUB_HEAD_REF_SLUG_URL_CS }}"
echo "base ref : ${{ env.GITHUB_BASE_REF_SLUG_URL_CS }}" echo "base ref : ${{ env.GITHUB_BASE_REF_SLUG_URL_CS }}"
echo "event ref : ${{ env.GITHUB_EVENT_REF_SLUG_URL_CS }}" echo "event ref : ${{ env.GITHUB_EVENT_REF_SLUG_URL_CS }}"
shell: bash shell: bash
- name: Ref Name - name: Ref Point
run: | run: |
echo "raw : ${{ env.GITHUB_REF_NAME }}" echo "raw : ${{ env.GITHUB_REF_POINT }}"
echo "slug : ${{ env.GITHUB_REF_NAME_SLUG }}" echo "slug : ${{ env.GITHUB_REF_POINT_SLUG }}"
echo "slug url : ${{ env.GITHUB_REF_NAME_SLUG_URL }}" echo "slug url : ${{ env.GITHUB_REF_POINT_SLUG_URL }}"
echo "slug (Case Sensitive) : ${{ env.GITHUB_REF_NAME_SLUG_CS }}" echo "slug (Case Sensitive) : ${{ env.GITHUB_REF_POINT_SLUG_CS }}"
echo "slug url (Case Sensitive) : ${{ env.GITHUB_REF_NAME_SLUG_URL_CS }}" echo "slug url (Case Sensitive) : ${{ env.GITHUB_REF_POINT_SLUG_URL_CS }}"
shell: bash shell: bash
- name: Short SHA variables - name: Short SHA variables
@@ -191,7 +197,7 @@ jobs:
shell: bash shell: bash
display-without-checkout: display-without-checkout:
name: 'Display produced variables (without checkout)' name: "Display produced variables (without checkout)"
needs: needs:
- display - display
strategy: strategy:
@@ -206,14 +212,8 @@ jobs:
path: this-action path: this-action
ref: ${{ github.ref }} ref: ${{ github.ref }}
- name: Load using v4.x with prefix - name: Load this action from HEAD
uses: ./this-action uses: ./this-action
with:
prefix: V4_
short-length: 8
- name: Load using v3.x
uses: rlespinasse/github-slug-action@v3.x
- name: Short SHA variables - name: Short SHA variables
run: | run: |
@@ -236,11 +236,11 @@ jobs:
- name: Using correct short length - name: Using correct short length
uses: ./ uses: ./
with: with:
prefix: 'CSL_' prefix: "CSL_"
short-length: 4 short-length: 4
- name: Using correct length // Validate that all short variables lengths are equals to short-length - name: Using correct length // Validate that all short variables lengths are equals to short-length
run: | run: |
env | grep "CSL_" | grep "_SHORT" | cut -d"=" -f2 | while read -r value; do [ "$(echo "$value" | wc -m)" -le 5 ] ; done env | grep "CSL_" | grep "_SHORT" | cut -d"=" -f2 | while read -r value; do [ "${#value}" -le 5 ] ; done
shell: bash shell: bash
# Test 2 # Test 2
@@ -248,12 +248,12 @@ jobs:
id: using-wrong-short-length id: using-wrong-short-length
uses: ./ uses: ./
with: with:
prefix: 'WSL_' prefix: "WSL_"
short-length: 'wrong' short-length: "wrong"
continue-on-error: true continue-on-error: true
- name: Using wrong short length // Validate that the action end with an error - name: Using wrong short length // Validate that the action end with an error
run: | run: |
[[ "$(env | grep "WSL_" | grep "_SHORT" | wc -l)" -eq 0 ]] [[ "$(env | grep "WSL_" | grep "_SHORT" -c)" -eq 0 ]]
[[ "${{ steps.using-wrong-short-length.outcome }}" == "failure" ]] [[ "${{ steps.using-wrong-short-length.outcome }}" == "failure" ]]
[[ "${{ steps.using-wrong-short-length.conclusion }}" == "success" ]] [[ "${{ steps.using-wrong-short-length.conclusion }}" == "success" ]]
shell: bash shell: bash
@@ -278,11 +278,11 @@ jobs:
- name: Using correct short length - name: Using correct short length
uses: ./this-action uses: ./this-action
with: with:
prefix: 'CSL_' prefix: "CSL_"
short-length: 4 short-length: 4
- name: Using correct length // Validate that all short variables lengths are equals to short-length - name: Using correct length // Validate that all short variables lengths are equals to short-length
run: | run: |
env | grep "CSL_" | grep "_SHORT" | cut -d"=" -f2 | while read -r value; do [ "$(echo "$value" | wc -m)" -le 5 ] ; done env | grep "CSL_" | grep "_SHORT" | cut -d"=" -f2 | while read -r value; do [ "${#value}" -le 5 ] ; done
shell: bash shell: bash
# Test 2 # Test 2
@@ -290,11 +290,11 @@ jobs:
id: using-empty-short-length id: using-empty-short-length
uses: ./this-action uses: ./this-action
with: with:
prefix: 'ESL_' prefix: "ESL_"
continue-on-error: true continue-on-error: true
- name: Using empty short length // Validate that the action don't end with an error - name: Using empty short length // Validate that the action don't end with an error
run: | run: |
[[ "$(env | grep "ESL_" | grep "_SHORT" | wc -l)" -gt 0 ]] [[ "$(env | grep "ESL_" | grep "_SHORT" -c)" -gt 0 ]]
[[ "${{ steps.using-empty-short-length.outcome }}" == "success" ]] [[ "${{ steps.using-empty-short-length.outcome }}" == "success" ]]
[[ "${{ steps.using-empty-short-length.conclusion }}" == "success" ]] [[ "${{ steps.using-empty-short-length.conclusion }}" == "success" ]]
shell: bash shell: bash
@@ -304,12 +304,12 @@ jobs:
id: using-wrong-short-length id: using-wrong-short-length
uses: ./this-action uses: ./this-action
with: with:
prefix: 'WSL_' prefix: "WSL_"
short-length: 'wrong' short-length: "wrong"
continue-on-error: true continue-on-error: true
- name: Using wrong short length // Validate that the action end with an error - name: Using wrong short length // Validate that the action end with an error
run: | run: |
[[ "$(env | grep "WSL_" | grep "_SHORT" | wc -l)" -eq 0 ]] [[ "$(env | grep "WSL_" | grep "_SHORT" -c)" -eq 0 ]]
[[ "${{ steps.using-wrong-short-length.outcome }}" == "failure" ]] [[ "${{ steps.using-wrong-short-length.outcome }}" == "failure" ]]
[[ "${{ steps.using-wrong-short-length.conclusion }}" == "success" ]] [[ "${{ steps.using-wrong-short-length.conclusion }}" == "success" ]]
shell: bash shell: bash
@@ -329,11 +329,11 @@ jobs:
- name: Using correct slug max length - name: Using correct slug max length
uses: ./ uses: ./
with: with:
prefix: 'CML_' prefix: "CML_"
slug-maxlength: 1 slug-maxlength: 1
- name: Using correct max length // Validate that all slug variables lengths are equals or under the slug-maxlength - name: Using correct max length // Validate that all slug variables lengths are equals or under the slug-maxlength
run: | run: |
env | grep "CML_" | grep "_SLUG" | cut -d"=" -f2 | while read -r value; do [ "$(echo "$value" | wc -m)" -le 2 ] ; done env | grep "CML_" | grep "_SLUG" | cut -d"=" -f2 | while read -r value; do [ "${#value}" -le 2 ] ; done
shell: bash shell: bash
# Test 2 # Test 2
@@ -341,12 +341,12 @@ jobs:
id: using-wrong-slug-max-length id: using-wrong-slug-max-length
uses: ./ uses: ./
with: with:
prefix: 'WML_' prefix: "WML_"
slug-maxlength: 'wrong' slug-maxlength: "wrong"
continue-on-error: true continue-on-error: true
- name: Using wrong slug max length // Validate that the action end with an error - name: Using wrong slug max length // Validate that the action end with an error
run: | run: |
[[ "$(env | grep "WML_" | grep "_SLUG" | wc -l)" -eq 0 ]] [[ "$(env | grep "WML_" | grep "_SLUG" -c)" -eq 0 ]]
[[ "${{ steps.using-wrong-slug-max-length.outcome }}" == "failure" ]] [[ "${{ steps.using-wrong-slug-max-length.outcome }}" == "failure" ]]
[[ "${{ steps.using-wrong-slug-max-length.conclusion }}" == "success" ]] [[ "${{ steps.using-wrong-slug-max-length.conclusion }}" == "success" ]]
shell: bash shell: bash
@@ -356,12 +356,12 @@ jobs:
id: using-empty-slug-max-length id: using-empty-slug-max-length
uses: ./ uses: ./
with: with:
prefix: 'EML_' prefix: "EML_"
slug-maxlength: '' slug-maxlength: ""
continue-on-error: true continue-on-error: true
- name: Using empty slug max length // Validate that the action end with an error - name: Using empty slug max length // Validate that the action end with an error
run: | run: |
[[ "$(env | grep "EML_" | grep "_SLUG" | wc -l)" -eq 0 ]] [[ "$(env | grep "EML_" | grep "_SLUG" -c)" -eq 0 ]]
[[ "${{ steps.using-empty-slug-max-length.outcome }}" == "failure" ]] [[ "${{ steps.using-empty-slug-max-length.outcome }}" == "failure" ]]
[[ "${{ steps.using-empty-slug-max-length.conclusion }}" == "success" ]] [[ "${{ steps.using-empty-slug-max-length.conclusion }}" == "success" ]]
shell: bash shell: bash
@@ -371,21 +371,25 @@ jobs:
id: using-nolimit-slug-max-length id: using-nolimit-slug-max-length
uses: ./ uses: ./
with: with:
prefix: 'NLML_' prefix: "NLML_"
slug-maxlength: 'nolimit' slug-maxlength: "nolimit"
- name: Using no limit on slug max length // Validate that the action end with an error - name: Using no limit on slug max length // Validate that the action end with an error
run: | run: |
[[ "$(env | grep "NLML_" | grep "_SLUG" | wc -l)" -gt 0 ]] [[ "$(env | grep "NLML_" | grep "_SLUG" -c)" -gt 0 ]]
[[ "${{ steps.using-nolimit-slug-max-length.outcome }}" == "success" ]] [[ "${{ steps.using-nolimit-slug-max-length.outcome }}" == "success" ]]
[[ "${{ steps.using-nolimit-slug-max-length.conclusion }}" == "success" ]] [[ "${{ steps.using-nolimit-slug-max-length.conclusion }}" == "success" ]]
shell: bash shell: bash
release: release:
runs-on: ubuntu-latest runs-on: ubuntu-latest
permissions:
contents: write
issues: write
id-token: write
packages: write
concurrency: concurrency:
group: release-${{ github.ref }}-${{ github.event_name }} group: release-${{ github.ref }}-${{ github.event_name }}
needs: needs:
- check-v3compatibility-without-checkout
- display-without-checkout - display-without-checkout
- input-short-length-without-checkout - input-short-length-without-checkout
- input-slug-maxlength - input-slug-maxlength

288
README.md
View File

@@ -2,27 +2,6 @@
This GitHub Action will expose the slug/short values of [some GitHub environment variables][default-environment-variables] inside your GitHub workflow. This GitHub Action will expose the slug/short values of [some GitHub environment variables][default-environment-variables] inside your GitHub workflow.
## Table of Contents
- [GitHub Slug action](#github-slug-action)
- [Table of Contents](#table-of-contents)
- [Overview](#overview)
- [Use this action](#use-this-action)
- [Migration from previous versions](#migration-from-previous-versions)
- [Available Environment variables](#available-environment-variables)
- [Enhanced variables](#enhanced-variables)
- [Partial variables](#partial-variables)
- [Slug variables](#slug-variables)
- [Slug URL variables](#slug-url-variables)
- [Short variables](#short-variables)
- [Troubleshooting](#troubleshooting)
- [The SHORT variables doesn't have the same lengths as before](#the-short-variables-doesnt-have-the-same-lengths-as-before)
- [One of the environment variables doesn't work as intended](#one-of-the-environment-variables-doesnt-work-as-intended)
- [Known environment variable conflicts](#known-environment-variable-conflicts)
- [GITHUB_REF_NAME](#github_ref_name)
- [An action could not be found at the URI](#an-action-could-not-be-found-at-the-uri)
- [Thanks for talking about us](#thanks-for-talking-about-us)
## Overview ## Overview
`SLUG` on a variable will `SLUG` on a variable will
@@ -33,11 +12,9 @@ This GitHub Action will expose the slug/short values of [some GitHub environment
- limit the string size to 63 characters - limit the string size to 63 characters
- remove trailing `-` characters - remove trailing `-` characters
<details> ### Others Slug-ish variables are available
<summary>Others <b>Slug-ish</b> commands are available</summary>
<p>
- `SLUG_URL` on a variable to have a `slug` variable compliant to be used in an URL - `SLUG_URL` on a variable to have a `slug` variable compliant to be used in a URL
- Like `SLUG` but `.`, and `_` are also replaced by `-` - Like `SLUG` but `.`, and `_` are also replaced by `-`
- `SHORT` on a variable will limit the string size to ~8 characters - `SHORT` on a variable will limit the string size to ~8 characters
- Useful for _sha_ value - Useful for _sha_ value
@@ -46,133 +23,155 @@ This GitHub Action will expose the slug/short values of [some GitHub environment
- `<VAR>_CS` on others variables to keep the value case-sensitive - `<VAR>_CS` on others variables to keep the value case-sensitive
- Like `GITHUB_REF_SLUG_CS` - Like `GITHUB_REF_SLUG_CS`
Additional enhanced environment variables can be compute to help you around GitHub environment variables. ## Installation
</p>
</details>
## Use this action Add this step to your workflow
Add this in your workflow
```yaml ```yaml
- name: Inject slug/short variables steps:
uses: rlespinasse/github-slug-action@v4 - name: Inject enhanced GitHub environment variables
uses: rlespinasse/github-slug-action@v5
``` ```
<details> > [!CAUTION]
<summary>Others configurations</summary> > Use [Dependabot][dependabot] to maintain your `github-slug-action` version updated in your GitHub workflows.
<p>
- With a prefix ## Configuration Options
```yaml > [!TIP]
- name: Inject slug/short variables > Check for more [examples][examples] (OS usage, URL use, ...)
uses: rlespinasse/github-slug-action@v4
### With a prefix
```yaml
steps:
- name: Inject enhanced GitHub environment variables
uses: rlespinasse/github-slug-action@v5
with: with:
prefix: CI_ prefix: CI_
``` ```
- With another max length for slug values ### With another max length for slug values
```yaml
- name: Inject slug/short variables
uses: rlespinasse/github-slug-action@v4
with:
slug-maxlength: 80 # Use 'nolimit' to remove use of a max length (Default to 63)
```
- With another length for short values
```yaml
- name: Inject slug/short variables
uses: rlespinasse/github-slug-action@v4
with:
short-length: 7 # By default it's up to git to decide, use 8 to have the v3.x behavior
```
**Warning**: If you leave it empty, you need to checkout the source first in order to let git decide the size by itself.
</p>
</details>
Check for more [examples][examples] (OS usage, URL use, ...)
**Tip:** Use [Dependabot][dependabot] to maintain your `github-slug-action` version updated in your GitHub workflows.
### Migration from previous versions
The short sha length is not the same as previous version.
- `v4` let git configuration decide of it (but you can override it),
- `v3` and before, it's always a length of 8 characters.
So to reproduce previous behavior, use
```yaml ```yaml
- name: Inject slug/short variables steps:
uses: rlespinasse/github-slug-action@v4 - name: Inject enhanced GitHub environment variables
with: uses: rlespinasse/github-slug-action@v5
short-length: 8 # Same as v3 and before with:
slug-maxlength: 80 # Use 'nolimit' to remove use of a max length (Default to 63)
``` ```
### With another length for short values
```yaml
steps:
- name: Inject enhanced GitHub environment variables
uses: rlespinasse/github-slug-action@v5
with:
short-length: 7 # By default it's up to Git to decide, use 8 to have the v3.x behavior
```
> [!WARNING]
> If you leave it empty, you need to checkout the source first in order to let Git decide the size by itself.
## Available Environment variables ## Available Environment variables
**Note**: If you don't find what you search for, read more about [available `GitHub` variables](docs/github-variables.md), and propose a [new custom variable][custom-variable]. > [!TIP]
> If you don't find what you search for
>
> - Read more about [available `GitHub` variables](docs/github-variables.md), and propose a [new custom variable][custom-variable].
> - Use your own variable with [slugify-value][slugify-value], or [shortify-git-revision][shortify-git-revision] for git reference.
### Enhanced variables ### Enhanced variables
- `GITHUB_REF_NAME` will contains the reference name (branch or tag) - `GITHUB_REF_POINT` will contains the reference name (branch or tag)
- based on `GITHUB_HEAD_REF` in a [`pull-request*`][webhooks-and-events] event context, - based on `GITHUB_HEAD_REF` in a [`pull-request*`][webhooks-and-events] event context,
- based on `GITHUB_REF` in others event context. - based on `GITHUB_REF_NAME` in others event context.
**NOTE:** All enhanced variables are available in all **slug** formats. > [!NOTE]
> All enhanced variables are available in all **slug** formats.
### Partial variables ### Partial variables
| Variable | Partial version of | Description | | Variable | Description |
| -------------------------------------------------------------------------------------- | ------------------ | ------------------------------------------------------ | | -------- | ----------- |
| [GITHUB_REPOSITORY_OWNER_PART](docs/partial-variables.md#github_repository_owner_part) | GITHUB_REPOSITORY | The Owner part of GITHUB_REPOSITORY variable | | [GITHUB_REPOSITORY_OWNER_PART](docs/partial-variables.md#github_repository_owner_part) | The Owner part of GITHUB_REPOSITORY variable |
| [GITHUB_REPOSITORY_NAME_PART](docs/partial-variables.md#github_repository_name_part) | GITHUB_REPOSITORY | The Repository name part of GITHUB_REPOSITORY variable | | [GITHUB_REPOSITORY_NAME_PART](docs/partial-variables.md#github_repository_name_part) | The Repository name part of GITHUB_REPOSITORY variable |
### Slug variables ### Slug variables
**NOTE:** `_CS` suffix available > [!TIP]
> Available in standard and case-sensitive (`_CS`) versions.
| Variable | Slug version of | Description | | Variable | Description |
| ------------------------------------------------------------------------------------------------- | ---------------------------- | -------------------------------------------------------------------------------------------------------------------- | | -------- | ----------- |
| [GITHUB_REPOSITORY_SLUG](docs/slug-variables.md#github_repository_slug) | GITHUB_REPOSITORY | The owner and repository name. | | [GITHUB_REPOSITORY_SLUG](docs/slug-variables.md#github_repository_slug) | The owner and repository name. |
| [GITHUB_REPOSITORY<br>_OWNER_PART_SLUG](docs/slug-variables.md#github_repository_owner_part_slug) | GITHUB_REPOSITORY_OWNER_PART | The owner name. | | [GITHUB_REPOSITORY_OWNER_PART_SLUG](docs/slug-variables.md#github_repository_owner_part_slug) | The owner name. |
| [GITHUB_REPOSITORY<br>_NAME_PART_SLUG](docs/slug-variables.md#github_repository_name_part_slug) | GITHUB_REPOSITORY_NAME_PART | The repository name. | | [GITHUB_REPOSITORY_NAME_PART_SLUG](docs/slug-variables.md#github_repository_name_part_slug) | The repository name. |
| [GITHUB_REF_SLUG](docs/slug-variables.md#github_ref_slug) | GITHUB_REF | The branch or tag ref that triggered the workflow. | | [GITHUB_REF_SLUG](docs/slug-variables.md#github_ref_slug) | The branch or tag ref that triggered the workflow. |
| [GITHUB_HEAD_REF_SLUG](docs/slug-variables.md#github_head_ref_slug) | GITHUB_HEAD_REF | The branch of the head repository.<br>Only set for [pull-request][event-pull-request] event and forked repositories. | | [GITHUB_REF_NAME_SLUG](docs/slug-variables.md#github_ref_name_slug) | This value matches the branch or tag name shown on GitHub. |
| [GITHUB_BASE_REF_SLUG](docs/slug-variables.md#github_base_ref_slug) | GITHUB_BASE_REF | The branch of the base repository.<br>Only set for [pull-request][event-pull-request] event and forked repositories. | | [GITHUB_HEAD_REF_SLUG](docs/slug-variables.md#github_head_ref_slug) | The branch of the head repository. |
| [GITHUB_EVENT_REF_SLUG](docs/slug-variables.md#github_event_ref_slug) | _github.event.ref_ | <br>Only set for [following webhook events][webhooks-and-events]<ul><li>`create`</li><li>`delete`</li></ul> | | [GITHUB_BASE_REF_SLUG](docs/slug-variables.md#github_base_ref_slug) | The branch of the base repository. |
| [GITHUB_EVENT_REF_SLUG](docs/slug-variables.md#github_event_ref_slug) | The Git reference resource associated to triggered webhook. |
### Slug URL variables ### URL-Safe Slug variables
**NOTE:** `_CS` suffix available Same as slug variables but URL-compliant
| Variable | Slug URL version of | Description | > [!TIP]
| --------------------------------------------------------------------------------------------------------- | ---------------------------- | --------------------------------------------------------------------------------------------------------------------- | > Available in standard and case-sensitive (`_CS`) versions.
| [GITHUB_REPOSITORY_SLUG_URL](docs/slug-url-variables.md#github_repository_slug_url) | GITHUB_REPOSITORY | The owner and repository name. |
| [GITHUB_REPOSITORY<br>_OWNER_PART_SLUG_URL](docs/slug-variables.md#github_repository_owner_part_slug_url) | GITHUB_REPOSITORY_OWNER_PART | The owner name. | | Variable | Description |
| [GITHUB_REPOSITORY<br>_NAME_PART_SLUG_URL](docs/slug-variables.md#github_repository_name_part_slug_url) | GITHUB_REPOSITORY_NAME_PART | The repository name. | | -------- | ----------- |
| [GITHUB_REF_SLUG_URL](docs/slug-url-variables.md#github_ref_slug_url) | GITHUB_REF | The branch or tag ref that triggered the workflow. | | [GITHUB_REPOSITORY_SLUG_URL](docs/slug-url-variables.md#github_repository_slug_url) | The owner and repository name. |
| [GITHUB_HEAD_REF_SLUG_URL](docs/slug-url-variables.md#github_head_ref_slug_url) | GITHUB_HEAD_REF | The branch of the head repository.<br>Only set for [pull-request][webhooks-and-events] event and forked repositories. | | [GITHUB_REPOSITORY_OWNER_PART_SLUG_URL](docs/slug-variables.md#github_repository_owner_part_slug_url) | The owner name. |
| [GITHUB_BASE_REF_SLUG_URL](docs/slug-url-variables.md#github_base_ref_slug_url) | GITHUB_BASE_REF | The branch of the base repository.<br>Only set for [pull-request][webhooks-and-events] event and forked repositories. | | [GITHUB_REPOSITORY_NAME_PART_SLUG_URL](docs/slug-variables.md#github_repository_name_part_slug_url) | The repository name. |
| [GITHUB_EVENT_REF_SLUG_URL](docs/slug-url-variables.md#github_event_ref_slug_url) | _github.event.ref_ | <br>Only set for [following webhook events][webhooks-and-events]<ul><li>`create`</li><li>`delete`</li></ul> | | [GITHUB_REF_SLUG_URL](docs/slug-url-variables.md#github_ref_slug_url) | The branch or tag ref that triggered the workflow. |
| [GITHUB_REF_NAME_SLUG_URL](docs/slug-url-variables.md#github_ref_slug_url) | This value matches the branch or tag name shown on GitHub. |
| [GITHUB_HEAD_REF_SLUG_URL](docs/slug-url-variables.md#github_head_ref_slug_url) | The branch of the head repository. |
| [GITHUB_BASE_REF_SLUG_URL](docs/slug-url-variables.md#github_base_ref_slug_url) | The branch of the base repository. |
| [GITHUB_EVENT_REF_SLUG_URL](docs/slug-url-variables.md#github_event_ref_slug_url) | The Git reference resource associated to triggered webhook. |
### Short variables ### Short variables
| Variable | Short version of | Description | | Variable | Description |
| -------------------------------------------------------------------------------------------------------------------- | -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | -------- | ----------- |
| [GITHUB_SHA_SHORT](docs/short-variables.md#github_sha_short) | GITHUB_SHA | The commit SHA that triggered the workflow. | | [GITHUB_SHA_SHORT](docs/short-variables.md#github_sha_short) | The commit SHA that triggered the workflow. |
| [GITHUB_EVENT<br>_PULL_REQUEST<br>_HEAD_SHA_SHORT](docs/short-variables.md#github_event_pull_request_head_sha_short) | _github.event<br>.pull_request<br>.head.sha_ | The commit SHA on pull request that trigger workflow.<br>Only set for [following webhook events][webhooks-and-events]<ul><li>`pull_request`</li><li>`pull_request_review`</li><li>`pull_request_review_comment`</li><li>`pull_request_target`</li></ul> | | [GITHUB_EVENT_PULL_REQUEST_HEAD_SHA_SHORT](docs/short-variables.md#github_event_pull_request_head_sha_short) | The commit SHA on pull request that trigger workflow. |
## Troubleshooting ## Migration from previous versions
### The SHORT variables doesn't have the same lengths as before ### v4 to v5
Since `v4`, it's git who manage the short variables by using [git rev-parse][git-revparse] behaviour. The **GITHUB_REF_NAME SLUG/SLUG_URL** variables doesn't work the same way as before
> [!TIP]
> If you use `v5` or related versions, you need to use `GITHUB_REF_POINT` instead of `GITHUB_REF_NAME` to get the behavior of the `v4` action.
Before `v5`, the behavior was the same as the GitHub one except on `pull_request*` workflows ([Ready the full story][issue-104]).
- `${{ env.GITHUB_REF_NAME }}` will serve the behavior of this action,
- `$GITHUB_REF_NAME` will serve the behavior of GitHub Action.
On `pull_request*` workflows, the content will be `<PR-number>/merge` instead of the branch name.
So you need to use `GITHUB_REF_POINT` instead
```yaml
steps:
- name: Inject enhanced GitHub environment variables
uses: rlespinasse/github-slug-action@v5
- run: |
echo "Branch Name: ${GITHUB_REF_POINT}"
shell: bash
```
Then `${{ env.GITHUB_REF_POINT }}`, and `$GITHUB_REF_POINT` will serve the behavior of this action.
And `${{ env.GITHUB_REF_NAME }}`, and `$GITHUB_REF_NAME` will serve the behavior of GitHub Action.
### v3 to v4
Since `v4`, it's Git who manage the short variables by using [`git rev-parse`][git-revparse] behaviour.
The length of a short sha depends of the size of our repository and can differ over time. The length of a short sha depends of the size of our repository and can differ over time.
To manage that moving length, you can use `short-length` input To manage that moving length, you can use `short-length` input
@@ -180,11 +179,25 @@ To manage that moving length, you can use `short-length` input
- set `7` to reproduce `small repository` behavior - set `7` to reproduce `small repository` behavior
- set `8` to reproduce `v3` behavior - set `8` to reproduce `v3` behavior
**Warning**: The minimum length is 4, the default is the effective value of the [core.abbrev][git-core-abbrev] configuration variable. > [!WARNING]
> The minimum length is 4, the default is the effective value of the [core.abbrev][git-core-abbrev] configuration variable.
So to reproduce previous behavior, use
```yaml
steps:
- name: Inject enhanced GitHub environment variables
uses: rlespinasse/github-slug-action@v5
with:
short-length: 8 # Same as v3 and before
```
## Troubleshooting
### One of the environment variables doesn't work as intended ### One of the environment variables doesn't work as intended
[**Note**][naming-conventions]: When you set a custom environment variable, you cannot use any of the default environment variable names. For a complete list of these, see [Default environment variables][default-environment-variables]. **If you attempt to override the value of one of these default environment variables, the assignment is ignored.** > [!WARNING]
> When you set a custom environment variable, you [cannot use any of the default environment variable names][naming-conventions]. For a complete list of these, see [Default environment variables][default-environment-variables]. **If you attempt to override the value of one of these default environment variables, the assignment is ignored.**
If a variable start to be used as default environment variable, the environment variable may have a different behavior than the expected one. If a variable start to be used as default environment variable, the environment variable may have a different behavior than the expected one.
@@ -196,30 +209,8 @@ If this append, the `${{ env.GITHUB_AWESOME_VARIABLE }}` and `$GITHUB_AWESOME_VA
Otherwise the two expression will serve the behavior of this action. Otherwise the two expression will serve the behavior of this action.
This will not occurs if you use the `prefix` input to avoid the issue. This will not occurs if you use the `prefix` input to avoid the issue.
**NOTE:** If detected, the maintainers of this action will choose the best course of action depending of the impact. > [!IMPORTANT]
> If detected, the maintainers of this action will choose the best course of action depending of the impact.
#### Known environment variable conflicts
##### GITHUB_REF_NAME
The behavior is the same as the GitHub one except on `pull_request*` workflows ([Ready the full story][issue-104]).
- `${{ env.GITHUB_REF_NAME }}` will serve the behavior of this action,
- `$GITHUB_REF_NAME` will serve the behavior of GitHub Action.
On `pull_request*` workflows, the content will be `<PR-number>/merge` instead of the branch name.
A possible workaround is to use `prefix` input
```yaml
- name: Inject slug/short variables
uses: rlespinasse/github-slug-action@v4
with:
prefix: CI_
```
Then `${{ env.CI_GITHUB_REF_NAME }}`, and `$CI_GITHUB_REF_NAME` will serve the behavior of this action.
And `$GITHUB_REF_NAME` will serve the behavior of GitHub Action.
### An action could not be found at the URI ### An action could not be found at the URI
@@ -235,7 +226,7 @@ If the `GIT_REFERENCE` value is
- `v4.x` or after, the branch don't exists anymore following the [end-of-life for a branch](SECURITY.md#end-of-life-of-a-branch) security process. - `v4.x` or after, the branch don't exists anymore following the [end-of-life for a branch](SECURITY.md#end-of-life-of-a-branch) security process.
- `master`, the branch don't exists anymore, read more about it on the corresponding issue ([EOL issue][issue-15]) - `master`, the branch don't exists anymore, read more about it on the corresponding issue ([EOL issue][issue-15])
Please, use the current major tag `v4` or a version tag (see [releases pages][releases]) in order to fix your workflow. Please, use the current major tag `v5` or a version tag (see [releases pages][releases]) in order to fix your workflow.
## Thanks for talking about us ## Thanks for talking about us
@@ -243,25 +234,28 @@ In English :gb:
- [Action spotlight by Michael Heap][article-2] - [Action spotlight by Michael Heap][article-2]
- [Serverless Deploy Previews on GitHub Actions][article-3] - [Serverless Deploy Previews on GitHub Actions][article-3]
- [Let's Build a Continuous Delivery and Branching Process with Github Actions, Vercel and Heroku][article-4] - [Let's Build a Continuous Delivery and Branching Process with GitHub Actions, Vercel and Heroku][article-4]
In French :fr: In French :fr:
- [Mettre en place une CI/CD Angular avec GitHub Actions & Netlify][article-1] - [Mettre en place une CI/CD Angular avec GitHub Actions & Netlify][article-1]
- [Github Actions : enfin des pipelines accessibles aux développeurs][talk-1] - [GitHub Actions : enfin des pipelines accessibles aux développeurs][talk-1]
In Chinese :cn: In Chinese :cn:
- [利用github-slug-action暴漏Github Action上下文中的关键变量][article-5] - [利用github-slug-action暴漏GitHub Action上下文中的关键变量][article-5]
> The next one is you. _Don't hesitate to add youself to one of these lists._ > The next one is you. _Don't hesitate to add youself to one of these lists._
[examples]: https://github.com/rlespinasse/github-slug-action/tree/v4.x/examples [examples]: https://github.com/rlespinasse/github-slug-action/tree/v5.x/examples
[custom-variable]: https://github.com/rlespinasse/github-slug-action/issues/new?assignees=&labels=enhancement&template=feature_request.md&title= [custom-variable]: https://github.com/rlespinasse/github-slug-action/issues/new?assignees=&labels=enhancement&template=feature_request.md&title=
[releases]: https://github.com/rlespinasse/github-slug-action/releases [releases]: https://github.com/rlespinasse/github-slug-action/releases
[issue-15]: https://github.com/rlespinasse/github-slug-action/issues/15 [issue-15]: https://github.com/rlespinasse/github-slug-action/issues/15
[issue-104]: https://github.com/rlespinasse/github-slug-action/issues/104 [issue-104]: https://github.com/rlespinasse/github-slug-action/issues/104
[slugify-value]: https://github.com/rlespinasse/slugify-value
[shortify-git-revision]: https://github.com/rlespinasse/shortify-git-revision
[git-revparse]: https://git-scm.com/docs/git-rev-parse#Documentation/git-rev-parse.txt---shortlength [git-revparse]: https://git-scm.com/docs/git-rev-parse#Documentation/git-rev-parse.txt---shortlength
[git-core-abbrev]: https://git-scm.com/docs/git-config#Documentation/git-config.txt-coreabbrev [git-core-abbrev]: https://git-scm.com/docs/git-config#Documentation/git-config.txt-coreabbrev

17
SECURITY.md
View File

@@ -4,23 +4,24 @@
| Version | Supported | End of Support | Branch | Specific Tags | | Version | Supported | End of Support | Branch | Specific Tags |
| ------- | ------------------ | -------------- | ------ | ------------- | | ------- | ------------------ | -------------- | ------ | ------------- |
| 4.x | :white_check_mark: | | v4.x | v4 | | 5.x | :white_check_mark: | | v5.x | v5 |
| 3.x | :white_check_mark: | 2024-01-31 | v3.x | v3 | | 4.x | :white_check_mark: | 2025-01-31 | v4.x | v4 |
| 3.x | :x: | 2024-01-31 | | v3.x, v3 |
| 2.x | :x: | 2021-04-05 | | v2.x, 2.2.0 | | 2.x | :x: | 2021-04-05 | | v2.x, 2.2.0 |
| 1.x | :x: | 2021-04-05 | | v1.1.x, 1.2.0 | | 1.x | :x: | 2021-04-05 | | v1.1.x, 1.2.0 |
| 1.0.x | :x: | 2019-11-07 | | 1.0.2 | | 1.0.x | :x: | 2019-11-07 | | 1.0.2 |
A GitHub repository can used one of the available branches as action inside its workflows. A GitHub repository can use one of the available branches as an action inside its workflows.
### End of Life of a branch ### End of Life of a branch
Since `2023-10-20`, when a new major version is release, Since `2023-10-20`, when a new major version is released,
- The previous one will continue to receive security patches during a 3-months periods, - The previous one will continue to receive security patches for 3 months,
- After the 3-month periods, the branch is deleted, only the tags remains. - After the 3 months, the branch is deleted, and only the tags remain.
## Reporting a Vulnerability ## Reporting a Vulnerability
You can report a Vulnerability by creating a [draft security advisory](https://github.com/rlespinasse/github-slug-action/security/advisories) in this project. In this project, you can report a Vulnerability by creating a [draft security advisory](https://github.com/rlespinasse/github-slug-action/security/advisories).
If the vulnerability is confirm, a fix will be produce and the advisory will be publish. If the vulnerability is confirmed, a fix will be produced and the advisory will be published.

7
action.yml
View File

@@ -59,7 +59,12 @@ runs:
- uses: rlespinasse/slugify-value@v1.4.0 - uses: rlespinasse/slugify-value@v1.4.0
with: with:
key: GITHUB_REF_NAME key: GITHUB_REF_NAME
# Related to https://github.com/rlespinasse/github-slug-action/issues/104 value: ${{ github.ref_name }}
prefix: ${{ inputs.prefix }}
slug-maxlength: ${{ inputs.slug-maxlength }}
- uses: rlespinasse/slugify-value@v1.4.0
with:
key: GITHUB_REF_POINT
value: ${{ env.GITHUB_HEAD_REF_RAW || env.GITHUB_REF_NAME_RAW }} value: ${{ env.GITHUB_HEAD_REF_RAW || env.GITHUB_REF_NAME_RAW }}
prefix: ${{ inputs.prefix }} prefix: ${{ inputs.prefix }}
slug-maxlength: ${{ inputs.slug-maxlength }} slug-maxlength: ${{ inputs.slug-maxlength }}

55
docs/github-variables.md
View File

@@ -12,10 +12,10 @@ All `GitHub` variables availables in your workflow in addition of ones exposed b
- [Action-managed Event Variables](#action-managed-event-variables) - [Action-managed Event Variables](#action-managed-event-variables)
- [create](#create) - [create](#create)
- [delete](#delete) - [delete](#delete)
- [pull_request](#pull_request) - [pull\_request](#pull_request)
- [pull_request_review](#pull_request_review) - [pull\_request\_review](#pull_request_review)
- [pull_request_review_comment](#pull_request_review_comment) - [pull\_request\_review\_comment](#pull_request_review_comment)
- [pull_request_target](#pull_request_target) - [pull\_request\_target](#pull_request_target)
## Default environment variables ## Default environment variables
@@ -23,13 +23,14 @@ Read the official documentation about [Default environment variables][1].
### Action-managed Environment Variables ### Action-managed Environment Variables
| Action-managed Variables | Can be suffix by | | Action-managed Variables | Can be suffix by |
| ------------------------ | -------------------- | | ------------------------ | --------------- |
| GITHUB_REPOSITORY | `_SLUG`, `_SLUG_URL` | | GITHUB_REPOSITORY | `_SLUG`, `_SLUG_URL` |
| GITHUB_REF | `_SLUG`, `_SLUG_URL` | | GITHUB_REF | `_SLUG`, `_SLUG_URL` |
| GITHUB_HEAD_REF | `_SLUG`, `_SLUG_URL` | | GITHUB_REF_NAME | `_SLUG`, `_SLUG_URL` |
| GITHUB_BASE_REF | `_SLUG`, `_SLUG_URL` | | GITHUB_HEAD_REF | `_SLUG`, `_SLUG_URL` |
| GITHUB_SHA | `_SHORT` | | GITHUB_BASE_REF | `_SLUG`, `_SLUG_URL` |
| GITHUB_SHA | `_SHORT` |
## Variables from events ## Variables from events
@@ -41,50 +42,50 @@ Read the official documentation about [Events that trigger workflows][2].
Checkout [create][3] webhook payload content Checkout [create][3] webhook payload content
| Action-managed Variables | Available as | | Action-managed Variables | Available as |
| ------------------------ | ------------------------- | | ------------------------ | ------------ |
| github.event.ref | GITHUB_EVENT_REF_SLUG | | github.event.ref | GITHUB_EVENT_REF_SLUG |
| github.event.ref | GITHUB_EVENT_REF_SLUG_URL | | github.event.ref | GITHUB_EVENT_REF_SLUG_URL |
#### delete #### delete
Checkout [delete][4] webhook payload content Checkout [delete][4] webhook payload content
| Action-managed Variables | Available as | | Action-managed Variables | Available as |
| ------------------------ | ------------------------- | | ------------------------ | ------------ |
| github.event.ref | GITHUB_EVENT_REF_SLUG | | github.event.ref | GITHUB_EVENT_REF_SLUG |
| github.event.ref | GITHUB_EVENT_REF_SLUG_URL | | github.event.ref | GITHUB_EVENT_REF_SLUG_URL |
#### pull_request #### pull_request
Checkout [pull_request][5] webhook payload content Checkout [pull_request][5] webhook payload content
| Action-managed Variables | Available as | | Action-managed Variables | Available as |
| ---------------------------------- | ---------------------------------------- | | ------------------------ | ------------ |
| github.event.pull_request.head.sha | GITHUB_EVENT_PULL_REQUEST_HEAD_SHA_SHORT | | github.event.pull_request.head.sha | GITHUB_EVENT_PULL_REQUEST_HEAD_SHA_SHORT |
#### pull_request_review #### pull_request_review
Checkout [pull_request_review][6] webhook payload content Checkout [pull_request_review][6] webhook payload content
| Action-managed Variables | Available as | | Action-managed Variables | Available as |
| ---------------------------------- | ---------------------------------------- | | ------------------------ | ------------ |
| github.event.pull_request.head.sha | GITHUB_EVENT_PULL_REQUEST_HEAD_SHA_SHORT | | github.event.pull_request.head.sha | GITHUB_EVENT_PULL_REQUEST_HEAD_SHA_SHORT |
#### pull_request_review_comment #### pull_request_review_comment
Checkout [pull_request_review_comment][7] webhook payload content Checkout [pull_request_review_comment][7] webhook payload content
| Action-managed Variables | Available as | | Action-managed Variables | Available as |
| ---------------------------------- | ---------------------------------------- | | ------------------------ | ------------ |
| github.event.pull_request.head.sha | GITHUB_EVENT_PULL_REQUEST_HEAD_SHA_SHORT | | github.event.pull_request.head.sha | GITHUB_EVENT_PULL_REQUEST_HEAD_SHA_SHORT |
#### pull_request_target #### pull_request_target
Checkout [pull_request][5] webhook payload content Checkout [pull_request][5] webhook payload content
| Action-managed Variables | Available as | | Action-managed Variables | Available as |
| ---------------------------------- | ---------------------------------------- | | ------------------------ | ------------ |
| github.event.pull_request.head.sha | GITHUB_EVENT_PULL_REQUEST_HEAD_SHA_SHORT | | github.event.pull_request.head.sha | GITHUB_EVENT_PULL_REQUEST_HEAD_SHA_SHORT |
[1]: https://docs.github.com/en/actions/reference/environment-variables#default-environment-variables [1]: https://docs.github.com/en/actions/reference/environment-variables#default-environment-variables

24
docs/partial-variables.md
View File

@@ -4,25 +4,25 @@
- [Partial Variables](#partial-variables) - [Partial Variables](#partial-variables)
- [Table of Contents](#table-of-contents) - [Table of Contents](#table-of-contents)
- [GITHUB_REPOSITORY_OWNER_PART](#github_repository_owner_part) - [GITHUB\_REPOSITORY\_OWNER\_PART](#github_repository_owner_part)
- [GITHUB_REPOSITORY_NAME_PART](#github_repository_name_part) - [GITHUB\_REPOSITORY\_NAME\_PART](#github_repository_name_part)
## GITHUB_REPOSITORY_OWNER_PART ## GITHUB_REPOSITORY_OWNER_PART
Owner part of the environment variable **GITHUB_REPOSITORY** Owner part of the environment variable **GITHUB_REPOSITORY**
| GITHUB_REPOSITORY | GITHUB_REPOSITORY_OWNER_PART | | GITHUB_REPOSITORY | GITHUB_REPOSITORY_OWNER_PART |
| ---------------------------- | ---------------------------- | | ----------------- | ---------------------------- |
| octocat/Hello-World | octocat | | octocat/Hello-World | octocat |
| rlespinasse/Hello-World.go | rlespinasse | | rlespinasse/Hello-World.go | rlespinasse |
| AnotherPerson/SomeRepository | AnotherPerson | | AnotherPerson/SomeRepository | AnotherPerson |
## GITHUB_REPOSITORY_NAME_PART ## GITHUB_REPOSITORY_NAME_PART
Repository name part of the environment variable **GITHUB_REPOSITORY** Repository name part of the environment variable **GITHUB_REPOSITORY**
| GITHUB_REPOSITORY | GITHUB_REPOSITORY_NAME_PART | | GITHUB_REPOSITORY | GITHUB_REPOSITORY_NAME_PART |
| ---------------------------- | --------------------------- | | ----------------- | --------------------------- |
| octocat/Hello-World | Hello-World | | octocat/Hello-World | Hello-World |
| rlespinasse/Hello-World.go | Hello-World.go | | rlespinasse/Hello-World.go | Hello-World.go |
| AnotherPerson/SomeRepository | SomeRepository | | AnotherPerson/SomeRepository | SomeRepository |

16
docs/short-variables.md
View File

@@ -4,8 +4,8 @@
- [Short Variables](#short-variables) - [Short Variables](#short-variables)
- [Table of Contents](#table-of-contents) - [Table of Contents](#table-of-contents)
- [GITHUB_SHA_SHORT](#github_sha_short) - [GITHUB\_SHA\_SHORT](#github_sha_short)
- [GITHUB_EVENT_PULL_REQUEST_HEAD_SHA_SHORT](#github_event_pull_request_head_sha_short) - [GITHUB\_EVENT\_PULL\_REQUEST\_HEAD\_SHA\_SHORT](#github_event_pull_request_head_sha_short)
## GITHUB_SHA_SHORT ## GITHUB_SHA_SHORT
@@ -13,15 +13,15 @@ Short the environment variable **GITHUB_SHA**
The commit SHA that triggered the workflow The commit SHA that triggered the workflow
| GITHUB_SHA | GITHUB_SHA_SHORT | | GITHUB_SHA | GITHUB_SHA_SHORT |
| ---------------------------------------- | ---------------- | | ---------- | ---------------- |
| ffac537e6cbbf934b08745a378932722df287a53 | ffac537e | | ffac537e6cbbf934b08745a378932722df287a53 | ffac537e |
## GITHUB_EVENT_PULL_REQUEST_HEAD_SHA_SHORT ## GITHUB_EVENT_PULL_REQUEST_HEAD_SHA_SHORT
Short the value of `github.event.pull_request.head.sha` that represents the last commit Short the value of `github.event.pull_request.head.sha` that represents the last commit
used for triggering an action for a pull request. used for triggering an action for a pull request.
| github.event.pull_request.head.sha | GITHUB_EVENT_PULL_REQUEST_HEAD_SHA_SHORT | | github.event.pull_request.head.sha | GITHUB_EVENT_PULL_REQUEST_HEAD_SHA_SHORT |
| ---------------------------------------- | ---------------------------------------- | | ---------------------------------- | ---------------------------------------- |
| ffac537e6cbbf934b08745a378932722df287a53 | ffac537e | | ffac537e6cbbf934b08745a378932722df287a53 | ffac537e |

98
docs/slug-url-variables.md
View File

@@ -4,13 +4,14 @@
- [Slug URL Variables](#slug-url-variables) - [Slug URL Variables](#slug-url-variables)
- [Table of Contents](#table-of-contents) - [Table of Contents](#table-of-contents)
- [GITHUB_REPOSITORY_SLUG_URL](#github_repository_slug_url) - [GITHUB\_REPOSITORY\_SLUG\_URL](#github_repository_slug_url)
- [GITHUB_REPOSITORY_OWNER_PART_SLUG_URL](#github_repository_owner_part_slug_url) - [GITHUB\_REPOSITORY\_OWNER\_PART\_SLUG\_URL](#github_repository_owner_part_slug_url)
- [GITHUB_REPOSITORY_NAME_PART_SLUG_URL](#github_repository_name_part_slug_url) - [GITHUB\_REPOSITORY\_NAME\_PART\_SLUG\_URL](#github_repository_name_part_slug_url)
- [GITHUB_REF_SLUG_URL](#github_ref_slug_url) - [GITHUB\_REF\_SLUG\_URL](#github_ref_slug_url)
- [GITHUB_HEAD_REF_SLUG_URL](#github_head_ref_slug_url) - [GITHUB\_REF\_NAME\_SLUG\_URL](#github_ref_name_slug_url)
- [GITHUB_BASE_REF_SLUG_URL](#github_base_ref_slug_url) - [GITHUB\_HEAD\_REF\_SLUG\_URL](#github_head_ref_slug_url)
- [GITHUB_EVENT_REF_SLUG_URL](#github_event_ref_slug_url) - [GITHUB\_BASE\_REF\_SLUG\_URL](#github_base_ref_slug_url)
- [GITHUB\_EVENT\_REF\_SLUG\_URL](#github_event_ref_slug_url)
## GITHUB_REPOSITORY_SLUG_URL ## GITHUB_REPOSITORY_SLUG_URL
@@ -18,10 +19,10 @@ Slug URL the environment variable **GITHUB_REPOSITORY**
The owner and repository name. The owner and repository name.
| GITHUB_REPOSITORY | GITHUB_REPOSITORY_SLUG_URL | | GITHUB_REPOSITORY | GITHUB_REPOSITORY_SLUG_URL |
| ---------------------------- | ---------------------------- | | ----------------- | ---------------------------- |
| octocat/Hello-World | octocat-hello-world | | octocat/Hello-World | octocat-hello-world |
| rlespinasse/Hello-World.go | rlespinasse-hello-world-go | | rlespinasse/Hello-World.go | rlespinasse-hello-world-go |
| AnotherPerson/SomeRepository | anotherperson-somerepository | | AnotherPerson/SomeRepository | anotherperson-somerepository |
## GITHUB_REPOSITORY_OWNER_PART_SLUG_URL ## GITHUB_REPOSITORY_OWNER_PART_SLUG_URL
@@ -32,9 +33,9 @@ The Owner part of **GITHUB_REPOSITORY** variable.
| GITHUB_REPOSITORY_OWNER_PART | GITHUB_REPOSITORY_OWNER_PART_SLUG_URL | | GITHUB_REPOSITORY_OWNER_PART | GITHUB_REPOSITORY_OWNER_PART_SLUG_URL |
| ---------------------------- | ------------------------------------- | | ---------------------------- | ------------------------------------- |
| octocat | octocat | | octocat | octocat |
| rlespinasse | rlespinasse | | rlespinasse | rlespinasse |
| AnotherPerson | anotherperson | | AnotherPerson | anotherperson |
## GITHUB_REPOSITORY_NAME_PART_SLUG_URL ## GITHUB_REPOSITORY_NAME_PART_SLUG_URL
@@ -44,9 +45,9 @@ The Repository name part of **GITHUB_REPOSITORY** variable.
| GITHUB_REPOSITORY_NAME_PART | GITHUB_REPOSITORY_NAME_PART_SLUG_URL | | GITHUB_REPOSITORY_NAME_PART | GITHUB_REPOSITORY_NAME_PART_SLUG_URL |
| --------------------------- | ------------------------------------ | | --------------------------- | ------------------------------------ |
| Hello-World | hello-world | | Hello-World | hello-world |
| Hello-World.go | hello-world-go | | Hello-World.go | hello-world-go |
| SomeRepository | somerepository | | SomeRepository | somerepository |
## GITHUB_REF_SLUG_URL ## GITHUB_REF_SLUG_URL
@@ -55,17 +56,30 @@ Slug URL the environment variable **GITHUB_REF**
The branch or tag ref that triggered the workflow. The branch or tag ref that triggered the workflow.
_If neither a branch or tag is available for the event type, the variable will not exist._ _If neither a branch or tag is available for the event type, the variable will not exist._
| GITHUB_REF | GITHUB_REF_SLUG_URL | | GITHUB_REF | GITHUB_REF_SLUG_URL |
| ------------------------------ | ------------------- | | ---------- | ------------------- |
| refs/heads/main | main | | refs/heads/main | main |
| refs/heads/feat/new_feature | feat-new-feature | | refs/heads/feat/new_feature | feat-new-feature |
| refs/tags/v1.0.0 | v1-0-0 | | refs/tags/v1.0.0 | v1-0-0 |
| refs/pull/42-merge | 42-merge | | refs/pull/42/merge | 42-merge |
| refs/tags/product@1.0.0-rc.2 | product-1-0-0-rc-2 | | refs/tags/product@1.0.0-rc.2 | product-1-0-0-rc-2 |
| refs/heads/New_Awesome_Product | new-awesome-product | | refs/heads/New_Awesome_Product | new-awesome-product |
**Caution**: From v3.0.0 to v3.2.0 included, `GITHUB_REF_SLUG` have the wrong value on `pull_request` event. ## GITHUB_REF_NAME_SLUG_URL
`refs/pull/42-merge` become `refs-pull-42-merge` instead of `42-merge`. The bug have been fixed in v3.3.0
Slug URL the environment variable **GITHUB_REF_NAME**
The branch or tag ref that triggered the workflow.
_If neither a branch or tag is available for the event type, the variable will not exist._
| GITHUB_REF_NAME | GITHUB_REF_SLUG_URL |
| --------------- | ------------------- |
| refs/heads/main | main |
| refs/heads/feat/new_feature | feat-new-feature |
| refs/tags/v1.0.0 | v1-0-0 |
| refs/pull/42/merge | 42-merge |
| refs/tags/product@1.0.0-rc.2 | product-1-0-0-rc-2 |
| refs/heads/New_Awesome_Product | new-awesome-product |
## GITHUB_HEAD_REF_SLUG_URL ## GITHUB_HEAD_REF_SLUG_URL
@@ -74,11 +88,11 @@ Slug URL the environment variable **GITHUB_HEAD_REF**
The branch of the head repository. The branch of the head repository.
_Only set for forked repositories._ _Only set for forked repositories._
| GITHUB_REF | GITHUB_HEAD_REF_SLUG_URL | | GITHUB_REF | GITHUB_HEAD_REF_SLUG_URL |
| ------------------------------ | ------------------------ | | ---------- | ------------------------ |
| refs/heads/main | main | | refs/heads/main | main |
| refs/heads/feat/new_feature | feat-new-feature | | refs/heads/feat/new_feature | feat-new-feature |
| refs/heads/New_Awesome_Product | new-awesome-product | | refs/heads/New_Awesome_Product | new-awesome-product |
## GITHUB_BASE_REF_SLUG_URL ## GITHUB_BASE_REF_SLUG_URL
@@ -87,23 +101,23 @@ Slug URL the environment variable **GITHUB_BASE_REF**
The branch of the base repository. The branch of the base repository.
_Only set for forked repositories._ _Only set for forked repositories._
| GITHUB_REF | GITHUB_HEAD_REF_SLUG_URL | | GITHUB_REF | GITHUB_HEAD_REF_SLUG_URL |
| ------------------------------ | ------------------------ | | ---------- | ------------------------ |
| refs/heads/main | main | | refs/heads/main | main |
| refs/heads/feat/new_feature | feat-new-feature | | refs/heads/feat/new_feature | feat-new-feature |
| refs/heads/New_Awesome_Product | new-awesome-product | | refs/heads/New_Awesome_Product | new-awesome-product |
## GITHUB_EVENT_REF_SLUG_URL ## GITHUB_EVENT_REF_SLUG_URL
Slug URL the variable **github.event.ref** Slug URL the variable **github.event.ref**
The git reference resource associated to triggered webhook. The Git reference resource associated to triggered webhook.
_Only set for [`create`, and `delete`][1] events._ _Only set for [`create`, and `delete`][1] events._
| GITHUB_REF | GITHUB_HEAD_REF_SLUG_URL | | GITHUB_REF | GITHUB_HEAD_REF_SLUG_URL |
| ------------------------------ | ------------------------ | | ---------- | ------------------------ |
| refs/heads/main | main | | refs/heads/main | main |
| refs/heads/feat/new_feature | feat-new-feature | | refs/heads/feat/new_feature | feat-new-feature |
| refs/heads/New_Awesome_Product | new-awesome-product | | refs/heads/New_Awesome_Product | new-awesome-product |
[1]: https://docs.github.com/en/developers/webhooks-and-events/webhook-events-and-payloads [1]: https://docs.github.com/en/developers/webhooks-and-events/webhook-events-and-payloads

95
docs/slug-variables.md
View File

@@ -4,13 +4,14 @@
- [Slug Variables](#slug-variables) - [Slug Variables](#slug-variables)
- [Table of Contents](#table-of-contents) - [Table of Contents](#table-of-contents)
- [GITHUB_REPOSITORY_SLUG](#github_repository_slug) - [GITHUB\_REPOSITORY\_SLUG](#github_repository_slug)
- [GITHUB_REPOSITORY_OWNER_PART_SLUG](#github_repository_owner_part_slug) - [GITHUB\_REPOSITORY\_OWNER\_PART\_SLUG](#github_repository_owner_part_slug)
- [GITHUB_REPOSITORY_NAME_PART_SLUG](#github_repository_name_part_slug) - [GITHUB\_REPOSITORY\_NAME\_PART\_SLUG](#github_repository_name_part_slug)
- [GITHUB_REF_SLUG](#github_ref_slug) - [GITHUB\_REF\_SLUG](#github_ref_slug)
- [GITHUB_HEAD_REF_SLUG](#github_head_ref_slug) - [GITHUB\_REF\_NAME\_SLUG](#github_ref_name_slug)
- [GITHUB_BASE_REF_SLUG](#github_base_ref_slug) - [GITHUB\_HEAD\_REF\_SLUG](#github_head_ref_slug)
- [GITHUB_EVENT_REF_SLUG](#github_event_ref_slug) - [GITHUB\_BASE\_REF\_SLUG](#github_base_ref_slug)
- [GITHUB\_EVENT\_REF\_SLUG](#github_event_ref_slug)
## GITHUB_REPOSITORY_SLUG ## GITHUB_REPOSITORY_SLUG
@@ -18,10 +19,10 @@ Slug the environment variable **GITHUB_REPOSITORY**
The owner and repository name. The owner and repository name.
| GITHUB_REPOSITORY | GITHUB_REPOSITORY_SLUG | | GITHUB_REPOSITORY | GITHUB_REPOSITORY_SLUG |
| ---------------------------- | ---------------------------- | | ----------------- | ---------------------- |
| octocat/Hello-World | octocat-hello-world | | octocat/Hello-World | octocat-hello-world |
| rlespinasse/Hello-World.go | rlespinasse-hello-world.go | | rlespinasse/Hello-World.go | rlespinasse-hello-world.go |
| AnotherPerson/SomeRepository | anotherperson-somerepository | | AnotherPerson/SomeRepository | anotherperson-somerepository |
## GITHUB_REPOSITORY_OWNER_PART_SLUG ## GITHUB_REPOSITORY_OWNER_PART_SLUG
@@ -32,9 +33,9 @@ The Owner part of **GITHUB_REPOSITORY** variable.
| GITHUB_REPOSITORY_OWNER_PART | GITHUB_REPOSITORY_OWNER_PART_SLUG | | GITHUB_REPOSITORY_OWNER_PART | GITHUB_REPOSITORY_OWNER_PART_SLUG |
| ---------------------------- | --------------------------------- | | ---------------------------- | --------------------------------- |
| octocat | octocat | | octocat | octocat |
| rlespinasse | rlespinasse | | rlespinasse | rlespinasse |
| AnotherPerson | anotherperson | | AnotherPerson | anotherperson |
## GITHUB_REPOSITORY_NAME_PART_SLUG ## GITHUB_REPOSITORY_NAME_PART_SLUG
@@ -44,9 +45,9 @@ The Repository name part of **GITHUB_REPOSITORY** variable.
| GITHUB_REPOSITORY_NAME_PART | GITHUB_REPOSITORY_NAME_PART_SLUG | | GITHUB_REPOSITORY_NAME_PART | GITHUB_REPOSITORY_NAME_PART_SLUG |
| --------------------------- | -------------------------------- | | --------------------------- | -------------------------------- |
| Hello-World | hello-world | | Hello-World | hello-world |
| Hello-World.go | hello-world.go | | Hello-World.go | hello-world.go |
| SomeRepository | somerepository | | SomeRepository | somerepository |
## GITHUB_REF_SLUG ## GITHUB_REF_SLUG
@@ -55,14 +56,30 @@ Slug the environment variable **GITHUB_REF**
The branch or tag ref that triggered the workflow. The branch or tag ref that triggered the workflow.
_If neither a branch or tag is available for the event type, the variable will not exist._ _If neither a branch or tag is available for the event type, the variable will not exist._
| GITHUB_REF | GITHUB_REF_SLUG | | GITHUB_REF | GITHUB_REF_SLUG |
| ------------------------------ | ------------------- | | ---------- | --------------- |
| refs/heads/main | main | | refs/heads/main | main |
| refs/heads/feat/new_feature | feat-new-feature | | refs/heads/feat/new_feature | feat-new-feature |
| refs/tags/v1.0.0 | v1.0.0 | | refs/tags/v1.0.0 | v1.0.0 |
| refs/tags/product@1.0.0-rc.2 | product-1.0.0-rc.2 | | refs/tags/product@1.0.0-rc.2 | product-1.0.0-rc.2 |
| refs/heads/New_Awesome_Product | new-awesome-product | | refs/heads/New_Awesome_Product | new-awesome-product |
## GITHUB_REF_NAME_SLUG
Slug the environment variable **GITHUB_REF_NAME**
The branch or tag ref that triggered the workflow.
_If neither a branch or tag is available for the event type, the variable will not exist._
| GITHUB_REF_NAME | GITHUB_REF_SLUG |
| --------------- | --------------- |
| main | main |
| feat/new_feature | feat-new-feature |
| v1.0.0 | v1.0.0 |
| product@1.0.0-rc.2 | product-1.0.0-rc.2 |
| New_Awesome_Product | new-awesome-product |
| 42/merge | 42-merge |
## GITHUB_HEAD_REF_SLUG ## GITHUB_HEAD_REF_SLUG
Slug the environment variable **GITHUB_HEAD_REF** Slug the environment variable **GITHUB_HEAD_REF**
@@ -70,11 +87,11 @@ Slug the environment variable **GITHUB_HEAD_REF**
The branch of the head repository. The branch of the head repository.
_Only set for [`pull-request`][1] event and forked repositories._ _Only set for [`pull-request`][1] event and forked repositories._
| GITHUB_REF | GITHUB_HEAD_REF_SLUG | | GITHUB_REF | GITHUB_HEAD_REF_SLUG |
| ------------------------------ | -------------------- | | ---------- | -------------------- |
| refs/heads/main | main | | refs/heads/main | main |
| refs/heads/feat/new_feature | feat-new-feature | | refs/heads/feat/new_feature | feat-new-feature |
| refs/heads/New_Awesome_Product | new-awesome-product | | refs/heads/New_Awesome_Product | new-awesome-product |
## GITHUB_BASE_REF_SLUG ## GITHUB_BASE_REF_SLUG
@@ -83,23 +100,23 @@ Slug the environment variable **GITHUB_BASE_REF**
The branch of the base repository. The branch of the base repository.
_Only set for [`pull-request`][1] event and forked repositories._ _Only set for [`pull-request`][1] event and forked repositories._
| GITHUB_REF | GITHUB_HEAD_REF_SLUG | | GITHUB_REF | GITHUB_HEAD_REF_SLUG |
| ------------------------------ | -------------------- | | ---------- | -------------------- |
| refs/heads/main | main | | refs/heads/main | main |
| refs/heads/feat/new_feature | feat-new-feature | | refs/heads/feat/new_feature | feat-new-feature |
| refs/heads/New_Awesome_Product | new-awesome-product | | refs/heads/New_Awesome_Product | new-awesome-product |
## GITHUB_EVENT_REF_SLUG ## GITHUB_EVENT_REF_SLUG
Slug the variable **github.event.ref** Slug the variable **github.event.ref**
The git reference resource associated to triggered webhook. The Git reference resource associated to triggered webhook.
_Only set for [`create`, and `delete`][1] events._ _Only set for [`create`, and `delete`][1] events._
| GITHUB_REF | GITHUB_HEAD_REF_SLUG | | GITHUB_REF | GITHUB_HEAD_REF_SLUG |
| ------------------------------ | -------------------- | | ---------- | -------------------- |
| refs/heads/main | main | | refs/heads/main | main |
| refs/heads/feat/new_feature | feat-new-feature | | refs/heads/feat/new_feature | feat-new-feature |
| refs/heads/New_Awesome_Product | new-awesome-product | | refs/heads/New_Awesome_Product | new-awesome-product |
[1]: https://docs.github.com/en/developers/webhooks-and-events/webhook-events-and-payloads [1]: https://docs.github.com/en/developers/webhooks-and-events/webhook-events-and-payloads

4
examples/linux-usage.yml
View File

@@ -6,8 +6,8 @@ jobs:
usage: usage:
runs-on: ubuntu-latest runs-on: ubuntu-latest
steps: steps:
- uses: actions/checkout@v2 - uses: actions/checkout@v4
- uses: rlespinasse/github-slug-action@v4 - uses: rlespinasse/github-slug-action@v5
- name: Output - name: Output
run: | run: |
echo "Partial variables" echo "Partial variables"

4
examples/macos-usage.yml
View File

@@ -6,8 +6,8 @@ jobs:
usage: usage:
runs-on: macos-latest runs-on: macos-latest
steps: steps:
- uses: actions/checkout@v2 - uses: actions/checkout@v4
- uses: rlespinasse/github-slug-action@v4 - uses: rlespinasse/github-slug-action@v5
- name: Output - name: Output
run: | run: |
echo "Partial variables" echo "Partial variables"

8
examples/url-use.yml
View File

@@ -6,15 +6,15 @@ jobs:
as_subdomain: as_subdomain:
runs-on: ubuntu-latest runs-on: ubuntu-latest
steps: steps:
- uses: actions/checkout@v2 - uses: actions/checkout@v4
- uses: rlespinasse/github-slug-action@v4 - uses: rlespinasse/github-slug-action@v5
- run: | - run: |
./deploy-application.sh --url "https://${{ env.GITHUB_REF_SLUG_URL }}.staging.app.example.com" ./deploy-application.sh --url "https://${{ env.GITHUB_REF_SLUG_URL }}.staging.app.example.com"
as_resource_path: as_resource_path:
runs-on: ubuntu-latest runs-on: ubuntu-latest
steps: steps:
- uses: actions/checkout@v2 - uses: actions/checkout@v4
- uses: rlespinasse/github-slug-action@v4 - uses: rlespinasse/github-slug-action@v5
- run: | - run: |
./deploy-application.sh --url "https://staging.app.example.com/${{ env.GITHUB_REF_SLUG_URL }}" ./deploy-application.sh --url "https://staging.app.example.com/${{ env.GITHUB_REF_SLUG_URL }}"

4
examples/windows-usage.yml
View File

@@ -6,8 +6,8 @@ jobs:
usage: usage:
runs-on: windows-latest runs-on: windows-latest
steps: steps:
- uses: actions/checkout@v2 - uses: actions/checkout@v4
- uses: rlespinasse/github-slug-action@v4 - uses: rlespinasse/github-slug-action@v5
- name: Output - name: Output
run: | run: |
echo "Partial variables" echo "Partial variables"