chore(release): 2.2.0 [skip ci]

# [2.2.0](http://github.com/rlespinasse/github-slug-action/compare/2.1.1...2.2.0) (2021-04-05) ### Features * add version warning ([f536765](f536765da4))
feat: add version warning
2026-06-10 16:43:09 +00:00 · 2021-04-05 18:00:05 +00:00 · 2021-04-05 19:59:17 +02:00 · 2020-10-07 20:54:07 +00:00 · 2020-10-07 22:53:24 +02:00 · 2020-09-26 09:12:06 +02:00
44 changed files with 6705 additions and 1986 deletions
--- a/.codespellrc
+++ b/.codespellrc
@@ -1,2 +0,0 @@
 [codespell]
 ignore-words-list = ans
--- a/.github/CODEOWNERS
+++ b/.github/CODEOWNERS
@@ -1 +0,0 @@
 *       @rlespinasse
--- a/.github/dependabot.yml
+++ b/.github/dependabot.yml
@@ -1,23 +0,0 @@
 version: 2
 updates:
  - package-ecosystem: 'github-actions'
    directory: '/.github/'
    schedule:
      interval: 'weekly'
    groups:
      dependencies:
        patterns:
          - '*'
    labels: []
  - package-ecosystem: 'github-actions'
    directory: '/'
    commit-message:
      prefix: 'feat: '
    schedule:
      interval: 'weekly'
    groups:
      dependencies:
        patterns:
          - 'rlespinasse/slugify-value'
          - 'rlespinasse/shortify-git-revision'
    labels: []
--- a/.github/workflows/check-variables.yml
+++ b/.github/workflows/check-variables.yml
@@ -1,139 +0,0 @@
 ---
 name: Compare GitHub Variables
 on:
  workflow_dispatch: # Manual trigger
  schedule:
    - cron: "0 0 * * 1" # Weekly on Monday at midnight
  pull_request:
 permissions: read-all
 jobs:
  compare-variables:
    runs-on: ubuntu-latest
    permissions:
      issues: write
    steps:
      - name: Checkout repository
        uses: actions/checkout@v6
      - name: Load environment variables for testing
        uses: rlespinasse/github-slug-action@v5
        with:
          prefix: TEST_
      - name: Compare GitHub variables
        id: compare
        run: |
          # Initialize arrays to store results
          MISMATCHED_VARS=()
          TEST_VALUES=()
          ACTUAL_VALUES=()
          # Get all environment variables
          ALL_ENV=$(env)
          # Extract TEST_GITHUB variables
          TEST_VARS=$(echo "$ALL_ENV" | grep "^TEST_GITHUB_" | cut -d= -f1)
          # Check for mismatches
          for TEST_VAR in $TEST_VARS; do
          # Get the corresponding GITHUB variable name
          GITHUB_VAR=${TEST_VAR/TEST_GITHUB_/GITHUB_}
          # Get the values
          TEST_VALUE="${!TEST_VAR}"
          # Check if the GITHUB variable exists
          if [[ -n "${!GITHUB_VAR+x}" ]]; then
            GITHUB_VALUE="${!GITHUB_VAR}"
            # Compare values
            if [[ "$TEST_VALUE" != "$GITHUB_VALUE" ]]; then
              MISMATCHED_VARS+=("$TEST_VAR vs $GITHUB_VAR")
              TEST_VALUES+=("$TEST_VALUE")
              ACTUAL_VALUES+=("$GITHUB_VALUE")
              echo "Mismatch found: $TEST_VAR=$TEST_VALUE, $GITHUB_VAR=$GITHUB_VALUE"
            else
              echo "Match: $TEST_VAR=$TEST_VALUE, $GITHUB_VAR=$GITHUB_VALUE"
            fi
          else
            echo "Skipping $TEST_VAR as $GITHUB_VAR does not exist"
          fi
          done
          # Set output for next steps
          if [[ ${#MISMATCHED_VARS[@]} -gt 0 ]]; then
          echo "has_mismatches=true" >>"$GITHUB_OUTPUT"
          # Create a JSON array of mismatched variables for the issue
          MISMATCHED_JSON=$(printf '"%s",' "${MISMATCHED_VARS[@]}" | sed 's/,$//')
          MISMATCHED_JSON="[$MISMATCHED_JSON]"
          echo "mismatched_vars=$MISMATCHED_JSON" >>"$GITHUB_OUTPUT"
          # Create a JSON array of test values
          TEST_JSON=$(printf '"%s",' "${TEST_VALUES[@]}" | sed 's/,$//')
          TEST_JSON="[$TEST_JSON]"
          echo "test_values=$TEST_JSON" >>"$GITHUB_OUTPUT"
          # Create a JSON array of actual values
          ACTUAL_JSON=$(printf '"%s",' "${ACTUAL_VALUES[@]}" | sed 's/,$//')
          ACTUAL_JSON="[$ACTUAL_JSON]"
          echo "actual_values=$ACTUAL_JSON" >>"$GITHUB_OUTPUT"
          # Create summary table
          {
            echo "## GitHub Variable Mismatches";
            echo "| Variable Pair | TEST Value | GITHUB Value |";
            echo "| ------------- | ---------- | ------------ |";
          } >>"$GITHUB_STEP_SUMMARY"
          for i in "${!MISMATCHED_VARS[@]}"; do
            echo "| ${MISMATCHED_VARS[$i]} | ${TEST_VALUES[$i]} | ${ACTUAL_VALUES[$i]} |" >>"$GITHUB_STEP_SUMMARY"
          done
          else
          echo "has_mismatches=false" >>"$GITHUB_OUTPUT"
          echo "## All GitHub Variables Match" >>"$GITHUB_STEP_SUMMARY"
          echo "All action GITHUB_ variables match their official GITHUB_ counterparts." >>"$GITHUB_STEP_SUMMARY"
          fi
        shell: bash
      - name: Create issue for mismatches
        if: steps.compare.outputs.has_mismatches == 'true' && github.event_name != 'pull_request'
        uses: actions/github-script@v9
        with:
          github-token: ${{ secrets.GITHUB_TOKEN }}
          script: |
            const mismatchedVars = JSON.parse('${{ steps.compare.outputs.mismatched_vars }}');
            const testValues = JSON.parse('${{ steps.compare.outputs.test_values }}');
            const actualValues = JSON.parse('${{ steps.compare.outputs.actual_values }}');
            // Create table for issue body
            let tableBody = '| Variable Pair | TEST Value | GITHUB Value |\n';
            tableBody += '| ------------- | ---------- | ------------ |\n';
            for (let i = 0; i < mismatchedVars.length; i++) {
              tableBody += `| ${mismatchedVars[i]} | ${testValues[i]} | ${actualValues[i]} |\n`;
            }
            // Create the issue
            const issueTitle = `GitHub Variable Mismatches Detected - ${new Date().toISOString().split('T')[0]}`;
            const issueBody = `## GitHub Variable Mismatches Detected\n\nThe following mismatches were found between the action **GITHUB_** variables and their official **GITHUB_** counterparts:\n\n${tableBody}\n\nPlease review these discrepancies and update the test variables as needed.`;
            await github.rest.issues.create({
              owner: context.repo.owner,
              repo: context.repo.repo,
              title: issueTitle,
              body: issueBody,
              labels: ['bug']
            });
            console.log('Issue created for GitHub variable mismatches');
      - name: Fail workflow if mismatches detected
        if: steps.compare.outputs.has_mismatches == 'true' && github.event_name == 'pull_request'
        run: |
          echo "::error::GitHub variable mismatches detected! See the summary for details."
          exit 1
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -1,34 +1,45 @@
-name: Linux usage
+name: Build
-
+on: [push, pull_request]
 on: push
 jobs:
-  usage:
+  build:
    runs-on: ubuntu-latest
    steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@v1
-      - uses: rlespinasse/github-slug-action@v5
+      - uses: docker://ffurrer/bats:latest
        with:
          args: "--recursive ."
      - uses: cycjimmy/semantic-release-action@v2
        with:
          semantic_version: 17.0.7
          branches: |
            [
              'v1.1.x',
              'v2.x'
            ]
          extra_plugins: |
            @semantic-release/changelog@5.0.1
            @semantic-release/git@9.0.0
        env:
          GITHUB_TOKEN: ${{ secrets.GH_TOKEN }}
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      - uses: ./
      - name: Output
        run: |
          echo "Partial variables"
          echo "   repository owner    : ${{ env.GITHUB_REPOSITORY_OWNER_PART }}"
          echo "   repository name     : ${{ env.GITHUB_REPOSITORY_NAME_PART }}"
          echo "Slug variables"
          echo "   repository          : ${{ env.GITHUB_REPOSITORY_SLUG }}"
          echo "   repository owner    : ${{ env.GITHUB_REPOSITORY_OWNER_PART_SLUG }}"
          echo "   repository name     : ${{ env.GITHUB_REPOSITORY_NAME_PART_SLUG }}"
          echo "   ref                 : ${{ env.GITHUB_REF_SLUG }}"
          echo "   head ref            : ${{ env.GITHUB_HEAD_REF_SLUG }}"
          echo "   base ref            : ${{ env.GITHUB_BASE_REF_SLUG }}"
          echo "   event ref           : ${{ env.GITHUB_EVENT_REF_SLUG }}"
          echo "Slug URL variables"
          echo "   repository          : ${{ env.GITHUB_REPOSITORY_SLUG_URL }}"
          echo "   repository owner    : ${{ env.GITHUB_REPOSITORY_OWNER_PART_SLUG_URL }}"
          echo "   repository name     : ${{ env.GITHUB_REPOSITORY_NAME_PART_SLUG_URL }}"
          echo "   ref                 : ${{ env.GITHUB_REF_SLUG_URL }}"
          echo "   head ref            : ${{ env.GITHUB_HEAD_REF_SLUG_URL }}"
          echo "   base ref            : ${{ env.GITHUB_BASE_REF_SLUG_URL }}"
          echo "   event ref           : ${{ env.GITHUB_EVENT_REF_SLUG_URL }}"
          echo "Short SHA variables"
          echo "   sha                 : ${{ env.GITHUB_SHA_SHORT }}"
          echo "   pull request sha    : ${{ env.GITHUB_EVENT_PULL_REQUEST_HEAD_SHA_SHORT }}"
--- a/.github/workflows/linter.yml
+++ b/.github/workflows/linter.yml
@@ -1,32 +0,0 @@
 ---
 name: Lint Code Base
 on: pull_request
 permissions: read-all
 jobs:
  build:
    name: Lint Code Base
    runs-on: ubuntu-latest
    permissions:
      contents: read
      packages: read
      statuses: write
    steps:
      - name: Checkout Code
        uses: actions/checkout@v6
        with:
          # Full git history is needed to get a proper
          # list of changed files within `super-linter`
          fetch-depth: 0
      - name: Lint Code Base
        uses: super-linter/super-linter@v8
        env:
          VALIDATE_ALL_CODEBASE: false
          VALIDATE_GITHUB_ACTIONS_ZIZMOR: false
          VALIDATE_JSCPD: false
          VALIDATE_MARKDOWN_PRETTIER: false
          VALIDATE_YAML_PRETTIER: false
          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
--- a/.github/workflows/v5-tests-and-release.yml
+++ b/.github/workflows/v5-tests-and-release.yml
@@ -1,402 +0,0 @@
 name: "[v5] Test and Release"
 on: [push, pull_request]
 permissions: read-all
 jobs:
  check-v4-compatibility:
    name: "Check v4 compatibility"
    strategy:
      fail-fast: false
      matrix:
        os: [macos-latest, ubuntu-latest, windows-latest]
    runs-on: ${{ matrix.os }}
    steps:
      - name: Checkout
        uses: actions/checkout@v6
      - name: Load this action from HEAD
        uses: ./
      - name: Load using v4
        uses: rlespinasse/github-slug-action@v4
        with:
          prefix: V4_
      - name: Validate // Partial variables
        run: |
          [[ "${{ env.GITHUB_REPOSITORY_OWNER_PART }}" == "${{ env.V4_GITHUB_REPOSITORY_OWNER_PART }}" ]]
          [[ "${{ env.GITHUB_REPOSITORY_NAME_PART }}" == "${{ env.V4_GITHUB_REPOSITORY_NAME_PART }}" ]]
        shell: bash
      - name: Validate // Slug variables
        run: |
          [[ "${{ env.GITHUB_REPOSITORY_SLUG }}" == "${{ env.V4_GITHUB_REPOSITORY_SLUG }}" ]]
          [[ "${{ env.GITHUB_REPOSITORY_OWNER_PART_SLUG }}" == "${{ env.V4_GITHUB_REPOSITORY_OWNER_PART_SLUG }}" ]]
          [[ "${{ env.GITHUB_REPOSITORY_NAME_PART_SLUG }}" == "${{ env.V4_GITHUB_REPOSITORY_NAME_PART_SLUG }}" ]]
          [[ "${{ env.GITHUB_REF_SLUG }}" == "${{ env.V4_GITHUB_REF_SLUG }}" ]]
          [[ "${{ env.GITHUB_HEAD_REF_SLUG }}" == "${{ env.V4_GITHUB_HEAD_REF_SLUG }}" ]]
          [[ "${{ env.GITHUB_BASE_REF_SLUG }}" == "${{ env.V4_GITHUB_BASE_REF_SLUG }}" ]]
          [[ "${{ env.GITHUB_EVENT_REF_SLUG }}" == "${{ env.V4_GITHUB_EVENT_REF_SLUG }}" ]]
        shell: bash
      - name: Validate // Slug variables (Case Sensitive)
        run: |
          [[ "${{ env.GITHUB_REPOSITORY_SLUG_CS }}" == "${{ env.V4_GITHUB_REPOSITORY_SLUG_CS }}" ]]
          [[ "${{ env.GITHUB_REPOSITORY_OWNER_PART_SLUG_CS }}" == "${{ env.V4_GITHUB_REPOSITORY_OWNER_PART_SLUG_CS }}" ]]
          [[ "${{ env.GITHUB_REPOSITORY_NAME_PART_SLUG_CS }}" == "${{ env.V4_GITHUB_REPOSITORY_NAME_PART_SLUG_CS }}" ]]
          [[ "${{ env.GITHUB_REF_SLUG_CS }}" == "${{ env.V4_GITHUB_REF_SLUG_CS }}" ]]
          [[ "${{ env.GITHUB_HEAD_REF_SLUG_CS }}" == "${{ env.V4_GITHUB_HEAD_REF_SLUG_CS }}" ]]
          [[ "${{ env.GITHUB_BASE_REF_SLUG_CS }}" == "${{ env.V4_GITHUB_BASE_REF_SLUG_CS }}" ]]
          [[ "${{ env.GITHUB_EVENT_REF_SLUG_CS }}" == "${{ env.V4_GITHUB_EVENT_REF_SLUG_CS }}" ]]
        shell: bash
      - name: Validate // Slug URL variables
        run: |
          [[ "${{ env.GITHUB_REPOSITORY_SLUG_URL }}" == "${{ env.V4_GITHUB_REPOSITORY_SLUG_URL }}" ]]
          [[ "${{ env.GITHUB_REPOSITORY_OWNER_PART_SLUG_URL }}" == "${{ env.V4_GITHUB_REPOSITORY_OWNER_PART_SLUG_URL }}" ]]
          [[ "${{ env.GITHUB_REPOSITORY_NAME_PART_SLUG_URL }}" == "${{ env.V4_GITHUB_REPOSITORY_NAME_PART_SLUG_URL }}" ]]
          [[ "${{ env.GITHUB_REF_SLUG_URL }}" == "${{ env.V4_GITHUB_REF_SLUG_URL }}" ]]
          [[ "${{ env.GITHUB_HEAD_REF_SLUG_URL }}" == "${{ env.V4_GITHUB_HEAD_REF_SLUG_URL }}" ]]
          [[ "${{ env.GITHUB_BASE_REF_SLUG_URL }}" == "${{ env.V4_GITHUB_BASE_REF_SLUG_URL }}" ]]
          [[ "${{ env.GITHUB_EVENT_REF_SLUG_URL }}" == "${{ env.V4_GITHUB_EVENT_REF_SLUG_URL }}" ]]
        shell: bash
      - name: Validate // Slug URL variables (Case Sensitive)
        run: |
          [[ "${{ env.GITHUB_REPOSITORY_SLUG_URL_CS }}" == "${{ env.V4_GITHUB_REPOSITORY_SLUG_URL_CS }}" ]]
          [[ "${{ env.GITHUB_REPOSITORY_OWNER_PART_SLUG_URL_CS }}" == "${{ env.V4_GITHUB_REPOSITORY_OWNER_PART_SLUG_URL_CS }}" ]]
          [[ "${{ env.GITHUB_REPOSITORY_NAME_PART_SLUG_URL_CS }}" == "${{ env.V4_GITHUB_REPOSITORY_NAME_PART_SLUG_URL_CS }}" ]]
          [[ "${{ env.GITHUB_REF_SLUG_URL_CS }}" == "${{ env.V4_GITHUB_REF_SLUG_URL_CS }}" ]]
          [[ "${{ env.GITHUB_HEAD_REF_SLUG_URL_CS }}" == "${{ env.V4_GITHUB_HEAD_REF_SLUG_URL_CS }}" ]]
          [[ "${{ env.GITHUB_BASE_REF_SLUG_URL_CS }}" == "${{ env.V4_GITHUB_BASE_REF_SLUG_URL_CS }}" ]]
          [[ "${{ env.GITHUB_EVENT_REF_SLUG_URL_CS }}" == "${{ env.V4_GITHUB_EVENT_REF_SLUG_URL_CS }}" ]]
        shell: bash
      - name: Validate // Ref Point
        run: |
          [[ "${{ env.GITHUB_REF_POINT }}" == "${{ env.V4_GITHUB_REF_NAME }}" ]]
          [[ "${{ env.GITHUB_REF_POINT_SLUG }}" == "${{ env.V4_GITHUB_REF_NAME_SLUG }}" ]]
          [[ "${{ env.GITHUB_REF_POINT_SLUG_URL }}" == "${{ env.V4_GITHUB_REF_NAME_SLUG_URL }}" ]]
          [[ "${{ env.GITHUB_REF_POINT_SLUG_CS }}" == "${{ env.V4_GITHUB_REF_NAME_SLUG_CS }}" ]]
          [[ "${{ env.GITHUB_REF_POINT_SLUG_URL_CS }}" == "${{ env.V4_GITHUB_REF_NAME_SLUG_URL_CS }}" ]]
        shell: bash
      - name: Validate // Short SHA variables
        run: |
          [[ "${{ env.GITHUB_SHA_SHORT }}" == "${{ env.V4_GITHUB_SHA_SHORT }}" ]]
          [[ "${{ env.GITHUB_EVENT_PULL_REQUEST_HEAD_SHA_SHORT }}" == "${{ env.V4_GITHUB_EVENT_PULL_REQUEST_HEAD_SHA_SHORT }}" ]]
        shell: bash
  check-v4-compatibility-without-checkout:
    name: "Check v4 compatibility (without checkout)"
    needs:
      - check-v4-compatibility
    strategy:
      fail-fast: false
      matrix:
        os: [macos-latest, ubuntu-latest, windows-latest]
    runs-on: ${{ matrix.os }}
    steps:
      - name: Checkout
        uses: actions/checkout@v6
        with:
          path: this-action
          ref: ${{ github.ref }}
      - name: Load this action from HEAD
        uses: ./this-action
      - name: Load using v4
        uses: rlespinasse/github-slug-action@v4
        with:
          prefix: V4_
      - name: Validate // Short SHA variables
        run: |
          [[ "${{ env.GITHUB_SHA_SHORT }}" == "${{ env.V4_GITHUB_SHA_SHORT }}" ]]
          [[ "${{ env.GITHUB_EVENT_PULL_REQUEST_HEAD_SHA_SHORT }}" == "${{ env.V4_GITHUB_EVENT_PULL_REQUEST_HEAD_SHA_SHORT }}" ]]
        shell: bash
  display:
    name: "Display produced variables"
    strategy:
      fail-fast: false
      matrix:
        os: [macos-latest, ubuntu-latest, windows-latest]
    runs-on: ${{ matrix.os }}
    steps:
      - name: Checkout
        uses: actions/checkout@v6
      - name: Load this action from HEAD
        uses: ./
      - name: Partial variables
        run: |
          echo "repository owner : ${{ env.GITHUB_REPOSITORY_OWNER_PART }}"
          echo "repository name  : ${{ env.GITHUB_REPOSITORY_NAME_PART }}"
        shell: bash
      - name: Slug variables
        run: |
          echo "repository       : ${{ env.GITHUB_REPOSITORY_SLUG }}"
          echo "repository owner : ${{ env.GITHUB_REPOSITORY_OWNER_PART_SLUG }}"
          echo "repository name  : ${{ env.GITHUB_REPOSITORY_NAME_PART_SLUG }}"
          echo "ref              : ${{ env.GITHUB_REF_SLUG }}"
          echo "ref name         : ${{ env.GITHUB_REF_NAME_SLUG }}"
          echo "head ref         : ${{ env.GITHUB_HEAD_REF_SLUG }}"
          echo "base ref         : ${{ env.GITHUB_BASE_REF_SLUG }}"
          echo "event ref        : ${{ env.GITHUB_EVENT_REF_SLUG }}"
        shell: bash
      - name: Slug variables (Case Sensitive)
        run: |
          echo "repository       : ${{ env.GITHUB_REPOSITORY_SLUG_CS }}"
          echo "repository owner : ${{ env.GITHUB_REPOSITORY_OWNER_PART_SLUG_CS }}"
          echo "repository name  : ${{ env.GITHUB_REPOSITORY_NAME_PART_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 "base ref         : ${{ env.GITHUB_BASE_REF_SLUG_CS }}"
          echo "event ref        : ${{ env.GITHUB_EVENT_REF_SLUG_CS }}"
        shell: bash
      - name: Slug URL variables
        run: |
          echo "repository       : ${{ env.GITHUB_REPOSITORY_SLUG_URL }}"
          echo "repository owner : ${{ env.GITHUB_REPOSITORY_OWNER_PART_SLUG_URL }}"
          echo "repository name  : ${{ env.GITHUB_REPOSITORY_NAME_PART_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 "base ref         : ${{ env.GITHUB_BASE_REF_SLUG_URL }}"
          echo "event ref        : ${{ env.GITHUB_EVENT_REF_SLUG_URL }}"
        shell: bash
      - name: Slug URL variables (Case Sensitive)
        run: |
          echo "repository       : ${{ env.GITHUB_REPOSITORY_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 "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 "base ref         : ${{ env.GITHUB_BASE_REF_SLUG_URL_CS }}"
          echo "event ref        : ${{ env.GITHUB_EVENT_REF_SLUG_URL_CS }}"
        shell: bash
      - name: Ref Point
        run: |
          echo "raw                       : ${{ env.GITHUB_REF_POINT }}"
          echo "slug                      : ${{ env.GITHUB_REF_POINT_SLUG }}"
          echo "slug url                  : ${{ env.GITHUB_REF_POINT_SLUG_URL }}"
          echo "slug (Case Sensitive)     : ${{ env.GITHUB_REF_POINT_SLUG_CS }}"
          echo "slug url (Case Sensitive) : ${{ env.GITHUB_REF_POINT_SLUG_URL_CS }}"
        shell: bash
      - name: Short SHA variables
        run: |
          echo "sha              : ${{ env.GITHUB_SHA_SHORT }}"
          echo "pull request sha : ${{ env.GITHUB_EVENT_PULL_REQUEST_HEAD_SHA_SHORT }}"
        shell: bash
  display-without-checkout:
    name: "Display produced variables (without checkout)"
    needs:
      - display
    strategy:
      fail-fast: false
      matrix:
        os: [macos-latest, ubuntu-latest, windows-latest]
    runs-on: ${{ matrix.os }}
    steps:
      - name: Checkout
        uses: actions/checkout@v6
        with:
          path: this-action
          ref: ${{ github.ref }}
      - name: Load this action from HEAD
        uses: ./this-action
      - name: Short SHA variables
        run: |
          echo "sha              : ${{ env.GITHUB_SHA_SHORT }}"
          echo "pull request sha : ${{ env.GITHUB_EVENT_PULL_REQUEST_HEAD_SHA_SHORT }}"
        shell: bash
  input-short-length:
    name: "Input 'short-length'"
    strategy:
      fail-fast: false
      matrix:
        os: [macos-latest, ubuntu-latest, windows-latest]
    runs-on: ${{ matrix.os }}
    steps:
      - name: Checkout
        uses: actions/checkout@v6
      # Test 1
      - name: Using correct short length
        uses: ./
        with:
          prefix: "CSL_"
          short-length: 4
      - name: Using correct length // Validate that all short variables lengths are equals to short-length
        run: |
          env | grep "CSL_" | grep "_SHORT" | cut -d"=" -f2 | while read -r value; do [ "${#value}" -le 5 ] ; done
        shell: bash
      # Test 2
      - name: Using wrong short length
        id: using-wrong-short-length
        uses: ./
        with:
          prefix: "WSL_"
          short-length: "wrong"
        continue-on-error: true
      - name: Using wrong short length // Validate that the action end with an error
        run: |
          [[ "$(env | grep "WSL_" | grep "_SHORT" -c)" -eq 0 ]]
          [[ "${{ steps.using-wrong-short-length.outcome }}" == "failure" ]]
          [[ "${{ steps.using-wrong-short-length.conclusion }}" == "success" ]]
        shell: bash
  input-short-length-without-checkout:
    name: "Input 'short-length' (without checkout)"
    needs:
      - input-short-length
    strategy:
      fail-fast: false
      matrix:
        os: [macos-latest, ubuntu-latest, windows-latest]
    runs-on: ${{ matrix.os }}
    steps:
      - name: Checkout
        uses: actions/checkout@v6
        with:
          path: this-action
          ref: ${{ github.ref }}
      # Test 1
      - name: Using correct short length
        uses: ./this-action
        with:
          prefix: "CSL_"
          short-length: 4
      - name: Using correct length // Validate that all short variables lengths are equals to short-length
        run: |
          env | grep "CSL_" | grep "_SHORT" | cut -d"=" -f2 | while read -r value; do [ "${#value}" -le 5 ] ; done
        shell: bash
      # Test 2
      - name: Using empty short length
        id: using-empty-short-length
        uses: ./this-action
        with:
          prefix: "ESL_"
        continue-on-error: true
      - name: Using empty short length // Validate that the action don't end with an error
        run: |
          [[ "$(env | grep "ESL_" | grep "_SHORT" -c)" -gt 0 ]]
          [[ "${{ steps.using-empty-short-length.outcome }}" == "success" ]]
          [[ "${{ steps.using-empty-short-length.conclusion }}" == "success" ]]
        shell: bash
      # Test 3
      - name: Using wrong short length
        id: using-wrong-short-length
        uses: ./this-action
        with:
          prefix: "WSL_"
          short-length: "wrong"
        continue-on-error: true
      - name: Using wrong short length // Validate that the action end with an error
        run: |
          [[ "$(env | grep "WSL_" | grep "_SHORT" -c)" -eq 0 ]]
          [[ "${{ steps.using-wrong-short-length.outcome }}" == "failure" ]]
          [[ "${{ steps.using-wrong-short-length.conclusion }}" == "success" ]]
        shell: bash
  input-slug-maxlength:
    name: "Input 'slug-maxlength'"
    strategy:
      fail-fast: false
      matrix:
        os: [macos-latest, ubuntu-latest, windows-latest]
    runs-on: ${{ matrix.os }}
    steps:
      - name: Checkout
        uses: actions/checkout@v6
      # Test 1
      - name: Using correct slug max length
        uses: ./
        with:
          prefix: "CML_"
          slug-maxlength: 1
      - name: Using correct max length // Validate that all slug variables lengths are equals or under the slug-maxlength
        run: |
          env | grep "CML_" | grep "_SLUG" | cut -d"=" -f2 | while read -r value; do [ "${#value}" -le 2 ] ; done
        shell: bash
      # Test 2
      - name: Using wrong slug max length
        id: using-wrong-slug-max-length
        uses: ./
        with:
          prefix: "WML_"
          slug-maxlength: "wrong"
        continue-on-error: true
      - name: Using wrong slug max length // Validate that the action end with an error
        run: |
          [[ "$(env | grep "WML_" | grep "_SLUG" -c)" -eq 0 ]]
          [[ "${{ steps.using-wrong-slug-max-length.outcome }}" == "failure" ]]
          [[ "${{ steps.using-wrong-slug-max-length.conclusion }}" == "success" ]]
        shell: bash
      # Test 3
      - name: Using empty slug max length
        id: using-empty-slug-max-length
        uses: ./
        with:
          prefix: "EML_"
          slug-maxlength: ""
        continue-on-error: true
      - name: Using empty slug max length // Validate that the action end with an error
        run: |
          [[ "$(env | grep "EML_" | grep "_SLUG" -c)" -eq 0 ]]
          [[ "${{ steps.using-empty-slug-max-length.outcome }}" == "failure" ]]
          [[ "${{ steps.using-empty-slug-max-length.conclusion }}" == "success" ]]
        shell: bash
      # Test 4
      - name: Using no limit on slug max length
        id: using-nolimit-slug-max-length
        uses: ./
        with:
          prefix: "NLML_"
          slug-maxlength: "nolimit"
      - name: Using no limit on slug max length // Validate that the action end with an error
        run: |
          [[ "$(env | grep "NLML_" | grep "_SLUG" -c)" -gt 0 ]]
          [[ "${{ steps.using-nolimit-slug-max-length.outcome }}" == "success" ]]
          [[ "${{ steps.using-nolimit-slug-max-length.conclusion }}" == "success" ]]
        shell: bash
  release:
    runs-on: ubuntu-latest
    permissions:
      contents: write
      issues: write
      id-token: write
      packages: write
    concurrency:
      group: release-${{ github.ref }}-${{ github.event_name }}
    needs:
      - display-without-checkout
      - input-short-length-without-checkout
      - input-slug-maxlength
    steps:
      - name: Checkout
        uses: actions/checkout@v6
      - name: Release this GitHub Action
        uses: rlespinasse/release-that@v1
        with:
          github-token: ${{ secrets.GH_TOKEN }}
--- a/.gitignore
+++ b/.gitignore
@@ -0,0 +1 @@
 node_modules/
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -0,0 +1,20 @@
 # [2.2.0](http://github.com/rlespinasse/github-slug-action/compare/2.1.1...2.2.0) (2021-04-05)
 ### Features
 * add version warning ([f536765](http://github.com/rlespinasse/github-slug-action/commit/f536765da448783f587c88e2c69f8f65b4e06541))
 ## [2.1.1](http://github.com/rlespinasse/github-slug-action/compare/2.1.0...2.1.1) (2020-10-07)
 ### Bug Fixes
 * remove set-env due to CVE fix ([d678898](http://github.com/rlespinasse/github-slug-action/commit/d678898ce55139d0005c35618747506fbeb2d1ed))
 # [2.1.0](http://github.com/rlespinasse/github-slug-action/compare/2.0.0...2.1.0) (2020-07-28)
 ### Features
 * expose slug variables for github.event.ref ([5a334a8](http://github.com/rlespinasse/github-slug-action/commit/5a334a8573fc27451af5b2a6ee175d8e11579e10))
--- a/CODE_OF_CONDUCT.md
+++ b/CODE_OF_CONDUCT.md
@@ -1,133 +1,76 @@
 # Contributor Covenant Code of Conduct
 ## Our Pledge
-We as members, contributors, and leaders pledge to make participation in our
+In the interest of fostering an open and welcoming environment, we as
-community a harassment-free experience for everyone, regardless of age, body
+contributors and maintainers pledge to making participation in our project and
-size, visible or invisible disability, ethnicity, sex characteristics, gender
+our community a harassment-free experience for everyone, regardless of age, body
-identity and expression, level of experience, education, socio-economic status,
+size, disability, ethnicity, sex characteristics, gender identity and expression,
-nationality, personal appearance, race, caste, color, religion, or sexual
+level of experience, education, socio-economic status, nationality, personal
-identity and orientation.
+appearance, race, religion, or sexual identity and orientation.
 We pledge to act and interact in ways that contribute to an open, welcoming,
 diverse, inclusive, and healthy community.
 ## Our Standards
-Examples of behavior that contributes to a positive environment for our
+Examples of behavior that contributes to creating a positive environment
-community include:
+include:
-* Demonstrating empathy and kindness toward other people
+* Using welcoming and inclusive language
-* Being respectful of differing opinions, viewpoints, and experiences
+* Being respectful of differing viewpoints and experiences
-* Giving and gracefully accepting constructive feedback
+* Gracefully accepting constructive criticism
-* Accepting responsibility and apologizing to those affected by our mistakes,
+* Focusing on what is best for the community
-  and learning from the experience
+* Showing empathy towards other community members
 * Focusing on what is best not just for us as individuals, but for the overall
  community
-Examples of unacceptable behavior include:
+Examples of unacceptable behavior by participants include:
-* The use of sexualized language or imagery, and sexual attention or advances of
+* The use of sexualized language or imagery and unwelcome sexual attention or
-  any kind
+ advances
-* Trolling, insulting or derogatory comments, and personal or political attacks
+* Trolling, insulting/derogatory comments, and personal or political attacks
 * Public or private harassment
-* Publishing others' private information, such as a physical or email address,
+* Publishing others' private information, such as a physical or electronic
-  without their explicit permission
+ address, without explicit permission
 * Other conduct which could reasonably be considered inappropriate in a
 professional setting
-## Enforcement Responsibilities
+## Our Responsibilities
-Community leaders are responsible for clarifying and enforcing our standards of
+Project maintainers are responsible for clarifying the standards of acceptable
-acceptable behavior and will take appropriate and fair corrective action in
+behavior and are expected to take appropriate and fair corrective action in
-response to any behavior that they deem inappropriate, threatening, offensive,
+response to any instances of unacceptable behavior.
 or harmful.
-Community leaders have the right and responsibility to remove, edit, or reject
+Project maintainers have the right and responsibility to remove, edit, or
-comments, commits, code, wiki edits, issues, and other contributions that are
+reject comments, commits, code, wiki edits, issues, and other contributions
-not aligned to this Code of Conduct, and will communicate reasons for moderation
+that are not aligned to this Code of Conduct, or to ban temporarily or
-decisions when appropriate.
+permanently any contributor for other behaviors that they deem inappropriate,
 threatening, offensive, or harmful.
 ## Scope
-This Code of Conduct applies within all community spaces, and also applies when
+This Code of Conduct applies both within project spaces and in public spaces
-an individual is officially representing the community in public spaces.
+when an individual is representing the project or its community. Examples of
-Examples of representing our community include using an official email address,
+representing a project or community include using an official project e-mail
-posting via an official social media account, or acting as an appointed
+address, posting via an official social media account, or acting as an appointed
-representative at an online or offline event.
+representative at an online or offline event. Representation of a project may be
 further defined and clarified by project maintainers.
 ## Enforcement
 Instances of abusive, harassing, or otherwise unacceptable behavior may be
-reported to the community leaders responsible for enforcement at
+reported by contacting the project team at romain.lespinasse@gmail.com. All
-<romain.lespinasse@gmail.com>.
+complaints will be reviewed and investigated and will result in a response that
-All complaints will be reviewed and investigated promptly and fairly.
+is deemed necessary and appropriate to the circumstances. The project team is
 obligated to maintain confidentiality with regard to the reporter of an incident.
 Further details of specific enforcement policies may be posted separately.
-All community leaders are obligated to respect the privacy and security of the
+Project maintainers who do not follow or enforce the Code of Conduct in good
-reporter of any incident.
+faith may face temporary or permanent repercussions as determined by other
-
+members of the project's leadership.
 ## Enforcement Guidelines
 Community leaders will follow these Community Impact Guidelines in determining
 the consequences for any action they deem in violation of this Code of Conduct:
 ### 1. Correction
 **Community Impact**: Use of inappropriate language or other behavior deemed
 unprofessional or unwelcome in the community.
 **Consequence**: A private, written warning from community leaders, providing
 clarity around the nature of the violation and an explanation of why the
 behavior was inappropriate. A public apology may be requested.
 ### 2. Warning
 **Community Impact**: A violation through a single incident or series of
 actions.
 **Consequence**: A warning with consequences for continued behavior. No
 interaction with the people involved, including unsolicited interaction with
 those enforcing the Code of Conduct, for a specified period of time. This
 includes avoiding interactions in community spaces as well as external channels
 like social media. Violating these terms may lead to a temporary or permanent
 ban.
 ### 3. Temporary Ban
 **Community Impact**: A serious violation of community standards, including
 sustained inappropriate behavior.
 **Consequence**: A temporary ban from any sort of interaction or public
 communication with the community for a specified period of time. No public or
 private interaction with the people involved, including unsolicited interaction
 with those enforcing the Code of Conduct, is allowed during this period.
 Violating these terms may lead to a permanent ban.
 ### 4. Permanent Ban
 **Community Impact**: Demonstrating a pattern of violation of community
 standards, including sustained inappropriate behavior, harassment of an
 individual, or aggression toward or disparagement of classes of individuals.
 **Consequence**: A permanent ban from any sort of public interaction within the
 community.
 ## Attribution
-This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
-version 2.1, available at
+available at https://www.contributor-covenant.org/version/1/4/code-of-conduct.html
 [https://www.contributor-covenant.org/version/2/1/code_of_conduct.html][v2.1].
 Community Impact Guidelines were inspired by
 [Mozilla's code of conduct enforcement ladder][Mozilla CoC].
 For answers to common questions about this code of conduct, see the FAQ at
 [https://www.contributor-covenant.org/faq][FAQ]. Translations are available at
 [https://www.contributor-covenant.org/translations][translations].
 [homepage]: https://www.contributor-covenant.org
-[v2.1]: https://www.contributor-covenant.org/version/2/1/code_of_conduct.html
+
-[Mozilla CoC]: https://github.com/mozilla/diversity
+For answers to common questions about this code of conduct, see
-[FAQ]: https://www.contributor-covenant.org/faq
+https://www.contributor-covenant.org/faq
 [translations]: https://www.contributor-covenant.org/translations
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -1,33 +0,0 @@
 # How to contribute to GitHub Slug Action
 ## Did you find a bug
 * **Do not open up a GitHub issue if the bug is a security vulnerability**, and instead to refer to our [security policy][1].
 * **Ensure the bug was not already reported** by searching on GitHub under [Issues][2].
 * If you're unable to find an open issue addressing the problem, [open a 'Bug' issue][4].
 Be sure to include a **title and clear description**, as much relevant information as possible, and a **code sample** or an **executable test case** demonstrating the expected behavior that is not occurring.
 ## Did you write a patch that fixes a bug
 * Open a new GitHub pull request with the patch.
 * Ensure the PR description clearly describes the problem and solution.
 Include the relevant issue number if applicable.
 ## Do you intend to add a new feature or change an existing one
 * Suggest your change by [opening a 'Feature request' issue][5]
 ## Do you have questions about the source code
 * [open an issue][3] with your question.
 Thanks!
 [1]: https://github.com/rlespinasse/github-slug-action/security/policy
 [2]: https://github.com/rlespinasse/github-slug-action/issues
 [3]: https://github.com/rlespinasse/github-slug-action/issues/new
 [4]: https://github.com/rlespinasse/github-slug-action/issues/new?assignees=&labels=bug&template=bug_report.md&title=
 [5]: https://github.com/rlespinasse/github-slug-action/issues/new?assignees=&labels=enhancement&template=feature_request.md&title=
--- a/4
+++ b/4
@@ -0,0 +1,4 @@
 FROM alpine:3.10
 RUN apk add --no-cache jq
 COPY entrypoint.sh /entrypoint.sh
 ENTRYPOINT ["/entrypoint.sh"]
--- a/README.md
+++ b/README.md
@@ -1,128 +1,153 @@
-# GitHub Slug Action
+# GitHub Slug action
-This GitHub Action exposes slug and short values of [GitHub environment variables][default-environment-variables] inside your workflow.
+[![Actions Status][1]][2]
 [![Public workflows that use this action.][8]][9]
-## Quick Start
+This action slug and expose some github variables.
 `Slug` a variable will
 - put the variable content in lower case
 - replace any character by `-` except `0-9`, `a-z`, and `.`
 - remove leading and trailing `-` character
 - limit the string size to 63 characters
 Others `Slug`-ish commands are available:
 - `Slug URL` a variable will be like the `slug` variable but the `.` character will also be replaced by `-`
 - `Short SHA` a variable will limit the string size to 8 characters
 ## Exposed environment variables
 ```yaml
-steps:
+- name: Inject slug/short variables
-  - uses: actions/checkout@v6
+  uses: rlespinasse/github-slug-action@v2.x
-  - name: Inject enhanced GitHub environment variables
+
-    uses: rlespinasse/github-slug-action@v5
+- name: Print slug/short variables
  run: |
    echo "Slug variables"
    echo "   ref        : ${{ env.GITHUB_REF_SLUG }}"
    echo "   head ref   : ${{ env.GITHUB_HEAD_REF_SLUG }}"
    echo "   base ref   : ${{ env.GITHUB_BASE_REF_SLUG }}"
    echo "   event ref  : ${{ env.GITHUB_EVENT_REF_SLUG }}"
    echo "   repository : ${{ env.GITHUB_REPOSITORY_SLUG }}"
    echo "Slug URL variables"
    echo "   ref        : ${{ env.GITHUB_REF_SLUG_URL }}"
    echo "   head ref   : ${{ env.GITHUB_HEAD_REF_SLUG_URL }}"
    echo "   base ref   : ${{ env.GITHUB_BASE_REF_SLUG_URL }}"
    echo "   event ref  : ${{ env.GITHUB_EVENT_REF_SLUG_URL }}"
    echo "   repository : ${{ env.GITHUB_REPOSITORY_SLUG_URL }}"
    echo "Short SHA variables"
    echo "   sha        : ${{ env.GITHUB_SHA_SHORT }}"
 ```
-> [!CAUTION]
+Read [default environment variables][3] page for more information.
 > Use [Dependabot][dependabot] to maintain your `github-slug-action` version updated in your GitHub workflows.
-## What It Does
+### GITHUB_REF_SLUG / GITHUB_REF_SLUG_URL
- **SLUG** -- Lowercase, replace special characters with `-`, limit to 63 characters. _Dots and underscores preserved._
+Slug the environment variable **GITHUB_REF**
 - **SLUG_URL** -- Same as SLUG, but dots and underscores are also replaced. _Safe for URLs and subdomains._
 - **SHORT** -- Shorten Git SHA values to a unique prefix.
 - **PART** -- Extract portions of a variable (e.g., owner or repository name from `GITHUB_REPOSITORY`).
 - **_CS** -- Case-sensitive variants of SLUG and SLUG_URL (original casing preserved).
-> [!TIP]
+The branch or tag ref that triggered the workflow.
-> Read the [slug transformation rules](docs/explanation/slug-transformation-rules.md) for the full algorithm and rationale.
+_If neither a branch or tag is available for the event type, the variable will not exist._
-## Inputs
+| GITHUB_REF                     | GITHUB_REF_SLUG     | GITHUB_REF_SLUG_URL |
 | ------------------------------ | ------------------- | ------------------- |
 | refs/heads/master              | master              | master              |
 | refs/heads/feat/new_feature    | feat-new-feature    | feat-new-feature    |
 | refs/tags/v1.0.0               | v1.0.0              | v1-0-0              |
 | refs/tags/product@1.0.0-rc.2   | product-1.0.0-rc.2  | product-1-0-0-rc-2  |
 | refs/heads/New_Awesome_Product | new-awesome-product | new-awesome-product |
-| Input | Default | Description |
+> **NOTE :**
-| ----- | ------- | ----------- |
+> GITHUB_REF_SLUG_URL is design to be used as subdomain in an URL.
 | `prefix` | `""` | Value prepended to each generated variable name |
 | `slug-maxlength` | `63` | Max length of slugified values (`"nolimit"` to disable) |
 | `short-length` | _(Git default)_ | Length of short SHA values (minimum `4`) |
-See the [inputs reference](docs/reference/inputs.md) for details.
+_Additional variables (only set for forked repositories) :_
-## Available Variables
+- `GITHUB_HEAD_REF_SLUG`/`GITHUB_HEAD_REF_SLUG_URL`, The branch of the head repository **GITHUB_HEAD_REF**
 - `GITHUB_BASE_REF_SLUG`/`GITHUB_BASE_REF_SLUG_URL`, The branch of the base repository **GITHUB_BASE_REF**
-| Variable | Type | Description |
+_Additional variables (only set for [create][4], and [delete][5] webhook events with `ref` data) :_
 | -------- | ---- | ----------- |
 | [GITHUB_REF_POINT](docs/reference/variables.md#github_ref_point) | Enhanced | Branch or tag name (consistent across event types) |
 | [GITHUB_REPOSITORY_OWNER_PART](docs/reference/variables.md#github_repository_owner_part) | Partial | Owner extracted from repository |
 | [GITHUB_REPOSITORY_NAME_PART](docs/reference/variables.md#github_repository_name_part) | Partial | Repository name extracted from repository |
 | [GITHUB_REPOSITORY_SLUG](docs/reference/variables.md#github_repository_slug) | Slug | The owner and repository name |
 | [GITHUB_REF_SLUG](docs/reference/variables.md#github_ref_slug) | Slug | The branch or tag ref |
 | [GITHUB_REF_NAME_SLUG](docs/reference/variables.md#github_ref_name_slug) | Slug | The branch or tag name shown on GitHub |
 | [GITHUB_HEAD_REF_SLUG](docs/reference/variables.md#github_head_ref_slug) | Slug | PR head branch |
 | [GITHUB_BASE_REF_SLUG](docs/reference/variables.md#github_base_ref_slug) | Slug | PR base branch |
 | [GITHUB_EVENT_REF_SLUG](docs/reference/variables.md#github_event_ref_slug) | Slug | Webhook Git ref |
 | [GITHUB_SHA_SHORT](docs/reference/variables.md#github_sha_short) | Short | Shortened commit SHA |
 | [GITHUB_EVENT_PULL_REQUEST_HEAD_SHA_SHORT](docs/reference/variables.md#github_event_pull_request_head_sha_short) | Short | Shortened PR head commit SHA |
-All slug variables also have `_SLUG_URL` and `_CS` variants. See the [full variable reference](docs/reference/variables.md).
+- `GITHUB_EVENT_REF_SLUG`/`GITHUB_EVENT_REF_SLUG_URL`, The git reference resource associated to the webhook.
-> [!TIP]
+### GITHUB_REPOSITORY_SLUG / GITHUB_REPOSITORY_SLUG_URL
 > If you don't find what you need, read about [available GitHub variables](docs/reference/github-variables.md), [propose a new variable][custom-variable], or use [slugify-value][slugify-value] / [shortify-git-revision][shortify-git-revision] directly.
-## Documentation
+Slug the environment variable **GITHUB_REPOSITORY**
-### Tutorial
+The owner and repository name.
- [Getting started](docs/getting-started.md) -- Step-by-step guide for first-time users
+| GITHUB_REPOSITORY          | GITHUB_REPOSITORY_SLUG     | GITHUB_REPOSITORY_SLUG_URL |
 | -------------------------- | -------------------------- | -------------------------- |
 | octocat/Hello-World        | octocat-hello-world        | octocat-hello-world        |
 | rlespinasse/Hello-World.go | rlespinasse-hello-world.go | rlespinasse-hello-world-go |
-### How-To Guides
+> **NOTE :**
 > GITHUB_REPOSITORY_SLUG_URL is design to be used as subdomain in an URL.
- [Use a prefix](docs/how-to/use-prefix.md)
+### GITHUB_SHA_SHORT
 - [Configure slug max length](docs/how-to/configure-slug-maxlength.md)
 - [Configure short SHA length](docs/how-to/configure-short-length.md)
 - [Use slug variables in URLs](docs/how-to/use-slugs-in-urls.md)
 - More [workflow examples](https://github.com/rlespinasse/github-slug-action/tree/v5.x/examples) (OS-specific usage, URL patterns)
-### Reference
+Short the environment variable **GITHUB_SHA**
- [Variable reference](docs/reference/variables.md) -- All variables with transformation examples
+The commit SHA that triggered the workflow
 - [Inputs reference](docs/reference/inputs.md) -- Action inputs specification
 - [GitHub variables by event](docs/reference/github-variables.md) -- Which variables are available per event type
-### Explanation
+| GITHUB_SHA                               | GITHUB_SHA_SHORT |
 | ---------------------------------------- | ---------------- |
 | ffac537e6cbbf934b08745a378932722df287a53 | ffac537e         |
- [Slug transformation rules](docs/explanation/slug-transformation-rules.md) -- How and why transformations work
+### Use slug variable in an URL
-## Migration
+In an URL, use `<GITHUB_VARIABLE>_SLUG_URL` instead of **<GITHUB_VARIABLE>\_SLUG** as subdomain to be compliant.
- [Migrate from v4 to v5](docs/how-to/migrate-v4-to-v5.md) -- `GITHUB_REF_NAME` behaviour changed on pull request events
+> **NOTE :**
- [Migrate from v3 to v4](docs/how-to/migrate-v3-to-v4.md) -- Short SHA length is now determined by Git
+> <GITHUB*VARIABLE>\_SLUG can be used in an URL only as part of the \_resource path*.
 ```yaml
 - name: Inject slug/short variables
  uses: rlespinasse/github-slug-action@v2.x
 - name: Deploy dummy application using slug in the 'subdomain' part
  run: |
    ./deploy-application.sh --url "https://${{ env.<GITHUB_VARIABLE>_SLUG_URL }}.staging.app.mycompagny.com"
 - name: Deploy dummy application using slug in the 'resource path' part
  run: |
    ./deploy-application.sh --url "https://staging.app.mycompagny.com/${{ env.<GITHUB_VARIABLE>_SLUG }}"
 ```
 ## Troubleshooting
-See the [troubleshooting guide](docs/how-to/troubleshooting.md) for common issues and solutions.
+### Missing master branch
-## Thanks for talking about us
+If your workflow fail on the `Set up job` task with this kind of log :
-In English :gb:
+```
 Download action repository 'rlespinasse/github-slug-action@master'
 ##[error]An action could not be found at the URI 'https://api.github.com/repos/rlespinasse/github-slug-action/tarball/master'
 ```
- [Action spotlight by Michael Heap][article-2]
+Use the current branch `v2.x` or a version tag (see [releases pages][6]).
 - [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]
 - [Celebrating 5 Years of github-slug-action on sfeir.dev][article-7]
-In French :fr:
+The master branch EOL is set on **2020-10-25** after a 6-month deprecation period (more information on the [EOL issue][7])
- [Mettre en place une CI/CD Angular avec GitHub Actions & Netlify][article-1]
+### Can't run on Windows or Macos
 - [GitHub Actions : enfin des pipelines accessibles aux développeurs][talk-1]
 - [GitHub-slug-action : 5 ans d'open source pour cette GitHub Action essentielle au CI/CD][article-6]
-In Chinese :cn:
+When using this action on Windows or Macos workflows, A `##[error]Container action is only supported on Linux` error can be see in your workflow logs.
 Currently, this action don't support a system other than Linux due to Github Action Limitation on `Container`-based action.
- [利用github-slug-action暴漏GitHub Action上下文中的关键变量][article-5]
+On the `v3.x` branch, this GitHub action have been rewrite to be able to run on Windows or Macos workflow.
-> The next one is you. _Don't hesitate to add yourself to one of these lists._
+```yaml
 - name: Inject slug/short variables
  uses: rlespinasse/github-slug-action@v3.x
 ```
-[custom-variable]: https://github.com/rlespinasse/github-slug-action/issues/new?assignees=&labels=enhancement&template=feature_request.md&title=
+[1]: https://github.com/rlespinasse/github-slug-action/workflows/Build/badge.svg
 [2]: https://github.com/rlespinasse/github-slug-action/actions
 [3]: https://help.github.com/en/actions/configuring-and-managing-workflows/using-environment-variables#default-environment-variables
 [4]: https://docs.github.com/en/developers/webhooks-and-events/webhook-events-and-payloads#create
 [5]: https://docs.github.com/en/developers/webhooks-and-events/webhook-events-and-payloads#delete
 [6]: https://github.com/rlespinasse/github-slug-action/releases
 [7]: https://github.com/rlespinasse/github-slug-action/issues/15
 [8]: https://img.shields.io/endpoint?url=https%3A%2F%2Fapi-git-master.endbug.vercel.app%2Fapi%2Fgithub-actions%2Fused-by%3Faction%3Drlespinasse%2Fgithub-slug-action%26badge%3Dtrue
 [9]: https://github.com/search?o=desc&q=rlespinasse%2Frlespinasse/github-slug-action+path%3A.github%2Fworkflows+language%3AYAML&s=&type=Code
 [slugify-value]: https://github.com/rlespinasse/slugify-value
 [shortify-git-revision]: https://github.com/rlespinasse/shortify-git-revision
 [default-environment-variables]: https://docs.github.com/en/actions/reference/workflows-and-actions/variables#default-environment-variables
 [dependabot]: https://docs.github.com/en/code-security/dependabot/working-with-dependabot/keeping-your-actions-up-to-date-with-dependabot
 [article-1]: https://esensconsulting.medium.com/mettre-en-place-une-ci-cd-angular-avec-github-actions-netlify-ca0b59b99ed8
 [article-2]: https://michaelheap.com/github-slug-action/
 [article-3]: https://barstool.engineering/serverless-deploy-previews-on-github-actions/
 [article-4]: https://javascript.plainenglish.io/lets-build-a-continuous-delivery-and-branching-process-c27dae09f0b6
 [article-5]: https://eryajf.github.io/HowToStartOpenSource/views/03-github-tips/10-Use-github-slug-action-to-leak-key-variables-in-the-Github-Action-context.html
 [article-6]: https://www.sfeir.dev/5-ans-de-github-slug-action-une-aventure-open-source/
 [article-7]: https://www.romainlespinasse.dev/posts/celebrating-5-years-of-github-slug-action/
 [talk-1]: https://www.youtube.com/watch?v=F5mBDmOQcvE
--- a/SECURITY.md
+++ b/SECURITY.md
@@ -2,26 +2,22 @@
 ## Supported Versions and Branches
-| Version | Supported          | End of Support | Branch | Specific Tags |
+| Version | Branch | Supported          |
-| ------- | ------------------ | -------------- | ------ | ------------- |
+|---------|--------|--------------------|
-| 5.x     | :white_check_mark: |                | v5.x   | v5            |
+| 2.x     | v2.x   | :white_check_mark: |
-| 4.x     | :x:                | 2025-01-31     |        | v4.x, v4      |
+| 1.1.x   | v1.1.x | :white_check_mark: |
-| 3.x     | :x:                | 2024-01-31     |        | v3.x, v3      |
+| < 1.0.x | master | :x:                |
 | 2.x     | :x:                | 2021-04-05     |        | v2.x, 2.2.0   |
 | 1.x     | :x:                | 2021-04-05     |        | v1.1.x, 1.2.0 |
 | 1.0.x   | :x:                | 2019-11-07     |        | 1.0.2         |
-A GitHub repository can use one of the available branches as an action inside its workflows.
+A GitHub repository can used one of the available branches as action inside its workflows.
 ### End of Life of a branch
 Since `2023-10-20`, when a new major version is released,
 - The previous one will continue to receive security patches for 3 months,
 - After the 3 months, the branch is deleted, and only the tags remain.
 ## Reporting a Vulnerability
-In this project, you can report a Vulnerability by creating a [draft security advisory](https://github.com/rlespinasse/github-slug-action/security/advisories).
+You can report a Vulnerability by [my email](mailto:romain.lespinasse@gmail.com).
-If the vulnerability is confirmed, a fix will be produced and the advisory will be published.
+_Vulnerability stages :_
 - Reported,
 - Confirmed (or declined),
 - Fixed on maintained version series.
 After a vulnerability fix, an GitHub issue will be created as document this vulnerability.
--- a/action.yml
+++ b/action.yml
@@ -1,120 +1,9 @@
-name: "GitHub Slug Action"
+# action.yml
-description: "GitHub Action to expose slug value of environment variables inside your GitHub workflow"
+name: "GitHub Slug"
-author: "Romain Lespinasse"
+description: "Action to slug and expose some github variables"
 branding:
  icon: "minimize"
  color: "blue"
 inputs:
  prefix:
    description: "Value to prepend to each generated variable"
    default: ""
    required: false
  slug-maxlength:
    description: "Max length of the slugified values"
    default: "63"
    required: true
  short-length:
    description: "Length of the shortify values (git default if empty)"
    required: false
 runs:
-  using: "composite"
+  using: "docker"
-  steps:
+  image: "Dockerfile"
-    - run: $GITHUB_ACTION_PATH/preflight.sh
+branding:
-      id: prefligth
+  icon: "crop"
-      shell: bash
+  color: "orange"
      env:
        INPUT_SLUG_MAXLENGTH: ${{ inputs.slug-maxlength }}
        INPUT_SHORT_LENGTH: ${{ inputs.short-length }}
    # From Environment Variables
    - uses: rlespinasse/slugify-value@a4879db1eb3db9bbee01dca36f98a8236c2b8239 # v1.4.0
      with:
        key: GITHUB_REPOSITORY
        value: ${{ github.repository }}
        prefix: ${{ inputs.prefix }}
        slug-maxlength: ${{ inputs.slug-maxlength }}
    - uses: rlespinasse/slugify-value@a4879db1eb3db9bbee01dca36f98a8236c2b8239 # v1.4.0
      with:
        key: GITHUB_REF
        prefix: ${{ inputs.prefix }}
        slug-maxlength: ${{ inputs.slug-maxlength }}
    - uses: rlespinasse/slugify-value@a4879db1eb3db9bbee01dca36f98a8236c2b8239 # v1.4.0
      with:
        key: GITHUB_HEAD_REF
        prefix: ${{ inputs.prefix }}
        slug-maxlength: ${{ inputs.slug-maxlength }}
    - uses: rlespinasse/slugify-value@a4879db1eb3db9bbee01dca36f98a8236c2b8239 # v1.4.0
      with:
        key: GITHUB_BASE_REF
        prefix: ${{ inputs.prefix }}
        slug-maxlength: ${{ inputs.slug-maxlength }}
    # From Specific values
    - uses: rlespinasse/slugify-value@a4879db1eb3db9bbee01dca36f98a8236c2b8239 # v1.4.0
      with:
        key: GITHUB_EVENT_REF
        value: ${{ github.event.ref }}
        prefix: ${{ inputs.prefix }}
        slug-maxlength: ${{ inputs.slug-maxlength }}
    - uses: rlespinasse/slugify-value@a4879db1eb3db9bbee01dca36f98a8236c2b8239 # v1.4.0
      with:
        key: GITHUB_REF_NAME
        value: ${{ github.ref_name }}
        prefix: ${{ inputs.prefix }}
        slug-maxlength: ${{ inputs.slug-maxlength }}
    - uses: rlespinasse/slugify-value@a4879db1eb3db9bbee01dca36f98a8236c2b8239 # v1.4.0
      with:
        key: GITHUB_REF_POINT
        value: ${{ env.GITHUB_HEAD_REF_RAW || env.GITHUB_REF_NAME_RAW }}
        prefix: ${{ inputs.prefix }}
        slug-maxlength: ${{ inputs.slug-maxlength }}
      env:
        GITHUB_HEAD_REF_RAW: ${{ github.head_ref }}
        GITHUB_REF_NAME_RAW: ${{ github.ref_name }}
    # From Calculated values
    - id: get-github-repository-owner-part
      run: |
        ownerpart=$(echo $GITHUB_REPOSITORY | cut -d/ -f1)
        if [ -f "$GITHUB_OUTPUT" ]; then
          echo "github-repository-owner-part=${ownerpart}" >> "$GITHUB_OUTPUT"
        else
          echo "::set-output name=github-repository-owner-part::${ownerpart}"
        fi
      shell: bash
    - uses: rlespinasse/slugify-value@a4879db1eb3db9bbee01dca36f98a8236c2b8239 # v1.4.0
      with:
        key: GITHUB_REPOSITORY_OWNER_PART
        value: ${{ steps.get-github-repository-owner-part.outputs.github-repository-owner-part }}
        prefix: ${{ inputs.prefix }}
        slug-maxlength: ${{ inputs.slug-maxlength }}
    - id: get-github-repository-name-part
      run: |
        namepart=$(echo $GITHUB_REPOSITORY | cut -d/ -f2)
        if [ -f "$GITHUB_OUTPUT" ]; then
          echo "github-repository-name-part=${namepart}" >> "$GITHUB_OUTPUT"
        else
          echo "::set-output name=github-repository-name-part::${namepart}"
        fi
      shell: bash
    - uses: rlespinasse/slugify-value@a4879db1eb3db9bbee01dca36f98a8236c2b8239 # v1.4.0
      with:
        key: GITHUB_REPOSITORY_NAME_PART
        value: ${{ steps.get-github-repository-name-part.outputs.github-repository-name-part }}
        prefix: ${{ inputs.prefix }}
        slug-maxlength: ${{ inputs.slug-maxlength }}
    # From sha
    - uses: rlespinasse/shortify-git-revision@c90ba7007ef6c152254d10b9f1a327966ab13077 # v1.6.0
      with:
        name: GITHUB_SHA
        short-on-error: true
        length: ${{ steps.prefligth.outputs.PREFLIGHT_SHORT_LENGTH }}
        prefix: ${{ inputs.prefix }}
    - uses: rlespinasse/shortify-git-revision@c90ba7007ef6c152254d10b9f1a327966ab13077 # v1.6.0
      with:
        name: GITHUB_EVENT_PULL_REQUEST_HEAD_SHA
        revision: ${{ github.event.pull_request.head.sha }}
        short-on-error: true
        length: ${{ steps.prefligth.outputs.PREFLIGHT_SHORT_LENGTH }}
        prefix: ${{ inputs.prefix }}
--- a/docs/explanation/slug-transformation-rules.md
+++ b/docs/explanation/slug-transformation-rules.md
@@ -1,89 +0,0 @@
 # Slug Transformation Rules
 This page explains the transformation algorithms used by the GitHub Slug Action, why they exist, and how they differ from each other.
 ## What is a "slug"?
 A slug is a human-readable identifier derived from a string, safe for use in URLs, filenames, DNS labels, and other contexts where special characters are problematic. The term originates from publishing, where a "slug" is a short label used to identify a piece of content.
 In CI/CD workflows, branch names, tag names, and repository names often contain characters (`/`, `@`, spaces) that break when used in URLs, Docker tags, Kubernetes labels, or file paths. Slugifying these values makes them safe for such contexts.
 ## SLUG transformation
 The `SLUG` transformation applies the following steps in order:
 1. **Lowercase** the entire string
 2. **Replace** any character that is not `0-9`, `a-z`, `.`, or `_` with `-`
 3. **Remove** leading `-` characters
 4. **Truncate** to a maximum length (default: 63 characters)
 5. **Remove** trailing `-` characters
 ### SLUG examples
 | Input | Output |
 | ----- | ------ |
 | `refs/heads/feat/new_feature` | `feat-new-feature` |
 | `refs/tags/v1.0.0` | `v1.0.0` |
 | `refs/tags/product@1.0.0-rc.2` | `product-1.0.0-rc.2` |
 | `octocat/Hello-World` | `octocat-hello-world` |
 Note that `.` and `_` are preserved in SLUG output.
 ## SLUG_URL transformation
 The `SLUG_URL` transformation is identical to `SLUG` except that `.` and `_` are also replaced with `-` in step 2. This makes the result safe for use as a URL path segment or subdomain label, where dots and underscores can cause issues.
 ### SLUG_URL examples
 | Input | SLUG | SLUG_URL |
 | ----- | ---- | -------- |
 | `refs/tags/v1.0.0` | `v1.0.0` | `v1-0-0` |
 | `rlespinasse/Hello-World.go` | `rlespinasse-hello-world.go` | `rlespinasse-hello-world-go` |
 | `refs/heads/feat/new_feature` | `feat-new-feature` | `feat-new-feature` |
 ### When to use which
 - Use **SLUG** for Docker tags, file paths, and general identifiers (dots and underscores are allowed)
 - Use **SLUG_URL** for subdomains, URL path segments, and any context where dots or underscores are problematic
 ## Why 63 characters?
 The default maximum length of 63 comes from the [DNS label length limit](https://www.rfc-editor.org/rfc/rfc1035#section-2.3.4). This is also the maximum length for:
 - Kubernetes resource labels
 - Many cloud provider resource names
 - DNS subdomain components
 You can change this limit with the `slug-maxlength` input, or set it to `"nolimit"` to disable truncation entirely.
 ## SHORT transformation
 The `SHORT` transformation truncates Git commit SHAs to a shorter, still-unique prefix. By default, Git determines the optimal length based on your repository size using [`git rev-parse --short`][git-revparse].
 | Input | Output |
 | ----- | ------ |
 | `ffac537e6cbbf934b08745a378932722df287a53` | `ffac537e` |
 The length varies by repository because larger repositories need longer prefixes to avoid collisions. You can set a fixed length with the `short-length` input (minimum: 4).
 ## Case-sensitive variants (_CS)
 Every `SLUG` and `SLUG_URL` variable also has a `_CS` (case-sensitive) variant that skips the lowercase step. For example:
 | Input | SLUG | SLUG_CS |
 | ----- | ---- | ------- |
 | `refs/heads/New_Awesome_Product` | `new-awesome-product` | `New-Awesome-Product` |
 This is useful when the original casing carries meaning (e.g., product names).
 ## PART extraction
 The `PART` transformation splits a composite value and extracts a portion. Currently used for `GITHUB_REPOSITORY`:
 | Input | OWNER_PART | NAME_PART |
 | ----- | ---------- | --------- |
 | `octocat/Hello-World` | `octocat` | `Hello-World` |
 PART variables preserve the original casing. They can be further transformed using SLUG or SLUG_URL suffixes (e.g., `GITHUB_REPOSITORY_OWNER_PART_SLUG`).
 [git-revparse]: https://git-scm.com/docs/git-rev-parse#Documentation/git-rev-parse.txt---shortlength
--- a/docs/getting-started.md
+++ b/docs/getting-started.md
@@ -1,101 +0,0 @@
 # Getting Started with GitHub Slug Action
 This tutorial walks you through adding the GitHub Slug Action to a workflow and using slug variables for the first time.
 ## Prerequisites
 - A GitHub repository with [GitHub Actions enabled](https://docs.github.com/en/actions/using-workflows)
 ## Step 1: Add the action to your workflow
 Create or edit a workflow file (e.g., `.github/workflows/deploy.yml`) and add the action after checking out your code:
 ```yaml
 name: Deploy
 on: push
 jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6
      - name: Inject enhanced GitHub environment variables
        uses: rlespinasse/github-slug-action@v5
 ```
 > [!TIP]
 > The `actions/checkout` step is recommended so that Git can determine the optimal short SHA length for your repository. It is not strictly required for slug variables.
 ## Step 2: Use slug variables in subsequent steps
 After the action runs, all slug variables are available as environment variables. Add a step to use them:
 ```yaml
      - name: Print slug variables
        run: |
          echo "Repository slug: $GITHUB_REPOSITORY_SLUG"
          echo "Branch slug:     $GITHUB_REF_SLUG"
          echo "Short SHA:       $GITHUB_SHA_SHORT"
        shell: bash
 ```
 For a branch named `feat/new_feature` on repository `octocat/Hello-World`, this outputs:
 ```text
 Repository slug: octocat-hello-world
 Branch slug:     feat-new-feature
 Short SHA:       ffac537e
 ```
 ## Step 3: Use a slug variable for a practical purpose
 A common use case is naming deployment previews with a URL-safe branch identifier:
 ```yaml
      - name: Deploy preview
        run: |
          echo "Deploying to https://${GITHUB_REF_SLUG_URL}.preview.example.com"
        shell: bash
 ```
 The `SLUG_URL` variant replaces dots and underscores too, making it safe for subdomains.
 ## Complete workflow
 Here is the full workflow file:
 ```yaml
 name: Deploy
 on: push
 jobs:
  deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6
      - name: Inject enhanced GitHub environment variables
        uses: rlespinasse/github-slug-action@v5
      - name: Deploy preview
        run: |
          echo "Deploying to https://${GITHUB_REF_SLUG_URL}.preview.example.com"
          echo "Commit: ${GITHUB_SHA_SHORT}"
        shell: bash
 ```
 ## What you learned
 - **SLUG** variables convert values to lowercase and replace special characters with `-`
 - **SLUG_URL** variables also replace `.` and `_`, making values safe for URLs and subdomains
 - **SHORT** variables shorten SHA commit hashes
 - All variables are exposed as environment variables for use in subsequent steps
 ## Next steps
 - [How-to guides](how-to/) for specific configuration tasks (prefixes, custom lengths, URL usage)
 - [Variable reference](reference/variables.md) for the complete list of available variables
 - [Slug transformation rules](explanation/slug-transformation-rules.md) to understand how transformations work
--- a/docs/github-variables.md
+++ b/docs/github-variables.md
@@ -1,3 +0,0 @@
 # Available GitHub Variables
 This page has moved to [reference/github-variables.md](reference/github-variables.md).
--- a/docs/how-to/configure-short-length.md
+++ b/docs/how-to/configure-short-length.md
@@ -1,45 +0,0 @@
 # Configure the length of short SHA values
 Set a specific length for shortened commit SHA values instead of letting Git determine it automatically.
 ## Usage
 ```yaml
 steps:
  - name: Inject enhanced GitHub environment variables
    uses: rlespinasse/github-slug-action@v5
    with:
      short-length: 7
 ```
 ## Common values
 | Value | Use case |
 | ----- | -------- |
 | _(empty)_ | Let Git decide based on repository size (default) |
 | `7` | Common "small repository" length |
 | `8` | Reproduce `v3` action behaviour |
 | `4` | Minimum allowed length |
 ## Letting Git decide (default)
 When `short-length` is left empty, the action uses Git's [`git rev-parse --short`][git-revparse] behaviour. The length depends on the size of your repository and may change over time as the repository grows.
 > [!WARNING]
 > If you leave `short-length` empty, you need to checkout the source first so Git can determine the length:
 >
 > ```yaml
 > steps:
 >   - uses: actions/checkout@v6
 >   - uses: rlespinasse/github-slug-action@v5
 > ```
 >
 > Without a checkout step, the action falls back to the effective value of the [`core.abbrev`][git-core-abbrev] Git configuration variable, or `7` if unavailable.
 ## See also
 - [Inputs reference](../reference/inputs.md) for the full specification
 - [SHORT transformation](../explanation/slug-transformation-rules.md#short-transformation) for how short values are computed
 [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
--- a/docs/how-to/configure-slug-maxlength.md
+++ b/docs/how-to/configure-slug-maxlength.md
@@ -1,33 +0,0 @@
 # Configure the maximum length for slug values
 Change the maximum length of slugified values. The default is 63 characters (the DNS label length limit).
 ## Usage
 ```yaml
 steps:
  - name: Inject enhanced GitHub environment variables
    uses: rlespinasse/github-slug-action@v5
    with:
      slug-maxlength: 80
 ```
 ## Disable the length limit
 Set `slug-maxlength` to `"nolimit"` to disable truncation entirely:
 ```yaml
 steps:
  - name: Inject enhanced GitHub environment variables
    uses: rlespinasse/github-slug-action@v5
    with:
      slug-maxlength: nolimit
 ```
 > [!WARNING]
 > The `slug-maxlength` input must not be empty. If left empty, the action will fail during preflight validation.
 ## See also
 - [Inputs reference](../reference/inputs.md) for the full specification
 - [Why 63 characters?](../explanation/slug-transformation-rules.md#why-63-characters) for the rationale behind the default
--- a/docs/how-to/migrate-v3-to-v4.md
+++ b/docs/how-to/migrate-v3-to-v4.md
@@ -1,30 +0,0 @@
 # Migrate from v3 to v4
 The main breaking change in v4 is that **short SHA length** is now determined by Git instead of being fixed at 8 characters.
 ## What changed
 Since v4, Git manages the short variables using [`git rev-parse`][git-revparse] behaviour. The length of a short SHA depends on the size of your repository and can change over time as the repository grows.
 ## How to migrate
 To reproduce the previous fixed-length behaviour, set `short-length` to `8`:
 ```yaml
 steps:
  - name: Inject enhanced GitHub environment variables
    uses: rlespinasse/github-slug-action@v5
    with:
      short-length: 8 # Same as v3 and before
 ```
 Other options:
 - Set `7` to reproduce small repository behaviour
 - Leave empty to let Git decide (recommended)
 > [!WARNING]
 > The minimum length is `4`. The default is the effective value of the [`core.abbrev`][git-core-abbrev] Git configuration variable.
 [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
--- a/docs/how-to/migrate-v4-to-v5.md
+++ b/docs/how-to/migrate-v4-to-v5.md
@@ -1,30 +0,0 @@
 # Migrate from v4 to v5
 The main breaking change in v5 is that **GITHUB_REF_NAME** slug variables now match GitHub's native behaviour on `pull_request*` events.
 ## What changed
 Before v5, the action overrode `GITHUB_REF_NAME` to always contain the branch name, even on pull request events. Starting with v5, `GITHUB_REF_NAME` on pull request events contains `<PR-number>/merge` (matching GitHub's native behaviour). Read the [full story][issue-104].
 ## How to migrate
 If you used `GITHUB_REF_NAME_SLUG` to get the branch name on pull request events, switch to `GITHUB_REF_POINT_SLUG`:
 ```yaml
 steps:
  - name: Inject enhanced GitHub environment variables
    uses: rlespinasse/github-slug-action@v5
  - run: |
      echo "Branch Name: ${GITHUB_REF_POINT}"
    shell: bash
 ```
 `GITHUB_REF_POINT` provides the branch name on pull request events (via `GITHUB_HEAD_REF`) and the ref name on all other events (via `GITHUB_REF_NAME`). All slug suffixes are available: `GITHUB_REF_POINT_SLUG`, `GITHUB_REF_POINT_SLUG_URL`, etc.
 ## Expression syntax
 - `${{ env.GITHUB_REF_POINT }}` and `$GITHUB_REF_POINT` both serve the action's behaviour
 - `${{ env.GITHUB_REF_NAME }}` serves the action's behaviour
 - `$GITHUB_REF_NAME` serves GitHub Action's native behaviour
 [issue-104]: https://github.com/rlespinasse/github-slug-action/issues/104
--- a/docs/how-to/troubleshooting.md
+++ b/docs/how-to/troubleshooting.md
@@ -1,56 +0,0 @@
 # Troubleshooting
 ## One of the environment variables doesn't work as intended
 > [!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 starts to be used as a default environment variable by GitHub, the behaviour may differ depending on how you reference it:
 - `${{ env.GITHUB_AWESOME_VARIABLE }}` serves the behaviour of this action
 - `$GITHUB_AWESOME_VARIABLE` serves the behaviour of GitHub Actions
 If both expressions return the same value, the variable is not affected. Use the [`prefix` input](use-prefix.md) to avoid this issue entirely.
 > [!IMPORTANT]
 > If detected, the maintainers of this action will choose the best course of action depending on the impact.
 ## An action could not be found at the URI
 If your workflow fails on the `Set up job` task with this kind of log:
 ```text
 Download action repository 'rlespinasse/github-slug-action@GIT_REFERENCE'
 ##[error]An action could not be found at the URI 'https://api.github.com/repos/rlespinasse/github-slug-action/tarball/GIT_REFERENCE'
 ```
 If the `GIT_REFERENCE` value is:
 - `v4.x` or after: following the [end-of-life for a branch](../../SECURITY.md#end-of-life-of-a-branch) security process, this branch may have been deleted.
 - `master`: this branch no longer exists. Read more on the corresponding issue ([EOL issue][issue-15]).
 Use the current **major tag** `v5` or a specific version tag (see [releases][releases]) to fix your workflow.
 ## Short variables are empty or have unexpected length
 If `GITHUB_SHA_SHORT` is empty or shorter than expected, ensure you have checked out your repository before the action runs:
 ```yaml
 steps:
  - uses: actions/checkout@v6
  - uses: rlespinasse/github-slug-action@v5
 ```
 Without a checkout, Git cannot determine the optimal short length for your repository. Alternatively, set a fixed `short-length` to avoid depending on the checkout:
 ```yaml
 steps:
  - uses: rlespinasse/github-slug-action@v5
    with:
      short-length: 7
 ```
 [naming-conventions]: https://docs.github.com/en/actions/reference/workflows-and-actions/variables#naming-conventions-for-configuration-variables
 [default-environment-variables]: https://docs.github.com/en/actions/reference/workflows-and-actions/variables#default-environment-variables
 [issue-15]: https://github.com/rlespinasse/github-slug-action/issues/15
 [releases]: https://github.com/rlespinasse/github-slug-action/releases
--- a/docs/how-to/use-prefix.md
+++ b/docs/how-to/use-prefix.md
@@ -1,26 +0,0 @@
 # Use a prefix for generated variables
 Add a prefix to all generated environment variables to avoid naming conflicts with [GitHub's default environment variables](https://docs.github.com/en/actions/reference/workflows-and-actions/variables#default-environment-variables).
 ## Usage
 ```yaml
 steps:
  - name: Inject enhanced GitHub environment variables
    uses: rlespinasse/github-slug-action@v5
    with:
      prefix: CI_
 ```
 With this configuration, variables are named `CI_GITHUB_REPOSITORY_SLUG`, `CI_GITHUB_REF_SLUG`, `CI_GITHUB_SHA_SHORT`, etc.
 ## When to use a prefix
 - When a variable name collides with a GitHub default environment variable (the assignment would be silently ignored without a prefix)
 - When you want to distinguish slug variables from other environment variables in your workflow
 - As a preventive measure against future GitHub environment variable additions
 ## See also
 - [Inputs reference](../reference/inputs.md) for the full `prefix` input specification
 - [Troubleshooting](troubleshooting.md#one-of-the-environment-variables-doesnt-work-as-intended) for details on variable name collisions
--- a/docs/how-to/use-slugs-in-urls.md
+++ b/docs/how-to/use-slugs-in-urls.md
@@ -1,36 +0,0 @@
 # Use slug variables in URLs
 Use `SLUG_URL` variables (not `SLUG`) when building URLs, because `SLUG_URL` also replaces dots and underscores with hyphens, making values safe for subdomains and URL paths.
 ## As a subdomain
 ```yaml
 steps:
  - uses: actions/checkout@v6
  - uses: rlespinasse/github-slug-action@v5
  - run: |
      ./deploy-application.sh --url "https://${{ env.GITHUB_REF_SLUG_URL }}.staging.app.example.com"
 ```
 For a branch `feat/new_feature`, this produces `https://feat-new-feature.staging.app.example.com`.
 ## As a URL path segment
 ```yaml
 steps:
  - uses: actions/checkout@v6
  - uses: rlespinasse/github-slug-action@v5
  - run: |
      ./deploy-application.sh --url "https://staging.app.example.com/${{ env.GITHUB_REF_SLUG_URL }}"
 ```
 ## Why SLUG_URL instead of SLUG?
 The `SLUG` transformation preserves `.` and `_` characters. In a subdomain like `v1.0.0.staging.example.com`, the dots from the version tag would create invalid DNS resolution. `SLUG_URL` replaces them: `v1-0-0.staging.example.com`.
 See [Slug transformation rules](../explanation/slug-transformation-rules.md#slug_url-transformation) for the full comparison.
 ## See also
 - [Full example workflow](../../examples/url-use.yml)
 - [Variable reference](../reference/variables.md) for all available `SLUG_URL` variables
--- a/docs/partial-variables.md
+++ b/docs/partial-variables.md
@@ -1,3 +0,0 @@
 # Partial Variables
 This page has moved to [reference/variables.md](reference/variables.md#partial-variables).
--- a/docs/reference/github-variables.md
+++ b/docs/reference/github-variables.md
@@ -1,87 +0,0 @@
 # Available GitHub Variables
 All GitHub variables available in your workflow in addition to ones exposed by this action.
 ## Default Environment Variables
 Read the official documentation about [Default environment variables][1].
 ### Action-managed Environment Variables
 | Action-managed Variables | Can be suffixed by |
 | ------------------------ | ------------------ |
 | GITHUB_REPOSITORY | `_SLUG`, `_SLUG_URL` |
 | GITHUB_REF | `_SLUG`, `_SLUG_URL` |
 | GITHUB_REF_NAME | `_SLUG`, `_SLUG_URL` |
 | GITHUB_HEAD_REF | `_SLUG`, `_SLUG_URL` |
 | GITHUB_BASE_REF | `_SLUG`, `_SLUG_URL` |
 | GITHUB_SHA | `_SHORT` |
 ## Variables from Events
 Read the official documentation about [Events that trigger workflows][2].
 ### Action-managed Event Variables
 #### create
 Checkout [create][3] webhook payload content
 | Action-managed Variables | Available as |
 | ------------------------ | ------------ |
 | github.event.ref | GITHUB_EVENT_REF_SLUG |
 | github.event.ref | GITHUB_EVENT_REF_SLUG_URL |
 #### delete
 Checkout [delete][4] webhook payload content
 | Action-managed Variables | Available as |
 | ------------------------ | ------------ |
 | github.event.ref | GITHUB_EVENT_REF_SLUG |
 | github.event.ref | GITHUB_EVENT_REF_SLUG_URL |
 #### pull_request
 Checkout [pull_request][5] webhook payload content
 | Action-managed Variables | Available as |
 | ------------------------ | ------------ |
 | github.event.pull_request.head.sha | GITHUB_EVENT_PULL_REQUEST_HEAD_SHA_SHORT |
 #### pull_request_review
 Checkout [pull_request_review][6] webhook payload content
 | Action-managed Variables | Available as |
 | ------------------------ | ------------ |
 | github.event.pull_request.head.sha | GITHUB_EVENT_PULL_REQUEST_HEAD_SHA_SHORT |
 #### pull_request_review_comment
 Checkout [pull_request_review_comment][7] webhook payload content
 | Action-managed Variables | Available as |
 | ------------------------ | ------------ |
 | github.event.pull_request.head.sha | GITHUB_EVENT_PULL_REQUEST_HEAD_SHA_SHORT |
 #### pull_request_target
 Checkout [pull_request][5] webhook payload content
 | Action-managed Variables | Available as |
 | ------------------------ | ------------ |
 | github.event.pull_request.head.sha | GITHUB_EVENT_PULL_REQUEST_HEAD_SHA_SHORT |
 ## See also
 - [Variable reference](variables.md) for transformation examples
 - [Slug transformation rules](../explanation/slug-transformation-rules.md) for how transformations work
 [1]: https://docs.github.com/en/actions/reference/environment-variables#default-environment-variables
 [2]: https://docs.github.com/en/actions/reference/events-that-trigger-workflows
 [3]: https://docs.github.com/en/developers/webhooks-and-events/webhook-events-and-payloads#create
 [4]: https://docs.github.com/en/developers/webhooks-and-events/webhook-events-and-payloads#delete
 [5]: https://docs.github.com/en/developers/webhooks-and-events/webhook-events-and-payloads#pull_request
 [6]: https://docs.github.com/en/developers/webhooks-and-events/webhook-events-and-payloads#pull_request_review
 [7]: https://docs.github.com/en/developers/webhooks-and-events/webhook-events-and-payloads#pull_request_review_comment
--- a/docs/reference/inputs.md
+++ b/docs/reference/inputs.md
@@ -1,23 +0,0 @@
 # Inputs Reference
 The GitHub Slug Action accepts the following inputs in the `with:` block.
 | Input | Required | Default | Description |
 | ----- | -------- | ------- | ----------- |
 | `prefix` | No | `""` | Value prepended to each generated variable name. For example, `prefix: CI_` produces `CI_GITHUB_REPOSITORY_SLUG` instead of `GITHUB_REPOSITORY_SLUG`. |
 | `slug-maxlength` | Yes | `63` | Maximum length of slugified values. Accepts a number or `"nolimit"` to disable truncation. Must not be empty. |
 | `short-length` | No | _(Git default)_ | Length of shortened SHA values. Minimum `4`. When empty, Git determines the length based on your repository size using [`git rev-parse`][git-revparse]. |
 ## Notes
 - When `short-length` is left empty, the action uses the effective value of the [`core.abbrev`][git-core-abbrev] Git configuration variable. This requires your repository to be checked out first (via `actions/checkout`).
 - The `slug-maxlength` default of `63` matches the DNS label length limit, which is also the maximum length for Kubernetes labels.
 ## See also
 - [How to use a prefix](../how-to/use-prefix.md)
 - [How to configure slug max length](../how-to/configure-slug-maxlength.md)
 - [How to configure short length](../how-to/configure-short-length.md)
 [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
--- a/docs/reference/variables.md
+++ b/docs/reference/variables.md
@@ -1,312 +0,0 @@
 # Variable Reference
 Complete reference for all environment variables generated by the GitHub Slug Action.
 > [!TIP]
 > All slug and slug-url variables are also available in case-sensitive (`_CS`) variants. See [Case-sensitive variants](#case-sensitive-variants).
 ## Summary
 | Variable | Type | Description |
 | -------- | ---- | ----------- |
 | `GITHUB_REF_POINT` | Enhanced | Branch or tag name (consistent across event types) |
 | `GITHUB_REPOSITORY_OWNER_PART` | Partial | Owner extracted from `GITHUB_REPOSITORY` |
 | `GITHUB_REPOSITORY_NAME_PART` | Partial | Repository name extracted from `GITHUB_REPOSITORY` |
 | `GITHUB_REPOSITORY_SLUG` | Slug | Slugified owner/repository name |
 | `GITHUB_REPOSITORY_OWNER_PART_SLUG` | Slug | Slugified owner name |
 | `GITHUB_REPOSITORY_NAME_PART_SLUG` | Slug | Slugified repository name |
 | `GITHUB_REF_SLUG` | Slug | Slugified branch or tag ref |
 | `GITHUB_REF_NAME_SLUG` | Slug | Slugified branch or tag name |
 | `GITHUB_HEAD_REF_SLUG` | Slug | Slugified PR head branch |
 | `GITHUB_BASE_REF_SLUG` | Slug | Slugified PR base branch |
 | `GITHUB_EVENT_REF_SLUG` | Slug | Slugified webhook ref |
 | `GITHUB_REPOSITORY_SLUG_URL` | Slug URL | URL-safe owner/repository name |
 | `GITHUB_REPOSITORY_OWNER_PART_SLUG_URL` | Slug URL | URL-safe owner name |
 | `GITHUB_REPOSITORY_NAME_PART_SLUG_URL` | Slug URL | URL-safe repository name |
 | `GITHUB_REF_SLUG_URL` | Slug URL | URL-safe branch or tag ref |
 | `GITHUB_REF_NAME_SLUG_URL` | Slug URL | URL-safe branch or tag name |
 | `GITHUB_HEAD_REF_SLUG_URL` | Slug URL | URL-safe PR head branch |
 | `GITHUB_BASE_REF_SLUG_URL` | Slug URL | URL-safe PR base branch |
 | `GITHUB_EVENT_REF_SLUG_URL` | Slug URL | URL-safe webhook ref |
 | `GITHUB_SHA_SHORT` | Short | Shortened commit SHA |
 | `GITHUB_EVENT_PULL_REQUEST_HEAD_SHA_SHORT` | Short | Shortened PR head commit SHA |
 ---
 ## Enhanced Variables
 ### GITHUB_REF_POINT
 The reference name (branch or tag), consistent across all event types:
 - Uses `GITHUB_HEAD_REF` in [`pull_request*`][webhooks] event contexts
 - Uses `GITHUB_REF_NAME` in all other event contexts
 This provides a stable branch name regardless of event type. On pull request events, `GITHUB_REF_NAME` contains `<PR#>/merge`, while `GITHUB_REF_POINT` contains the actual branch name.
 Available with all slug suffixes: `GITHUB_REF_POINT_SLUG`, `GITHUB_REF_POINT_SLUG_URL`, `GITHUB_REF_POINT_SLUG_CS`, `GITHUB_REF_POINT_SLUG_URL_CS`.
 ---
 ## Partial Variables
 ### GITHUB_REPOSITORY_OWNER_PART
 Owner part of the environment variable **GITHUB_REPOSITORY**.
 | GITHUB_REPOSITORY | GITHUB_REPOSITORY_OWNER_PART |
 | ----------------- | ---------------------------- |
 | octocat/Hello-World | octocat |
 | rlespinasse/Hello-World.go | rlespinasse |
 | AnotherPerson/SomeRepository | AnotherPerson |
 ### GITHUB_REPOSITORY_NAME_PART
 Repository name part of the environment variable **GITHUB_REPOSITORY**.
 | GITHUB_REPOSITORY | GITHUB_REPOSITORY_NAME_PART |
 | ----------------- | --------------------------- |
 | octocat/Hello-World | Hello-World |
 | rlespinasse/Hello-World.go | Hello-World.go |
 | AnotherPerson/SomeRepository | SomeRepository |
 ---
 ## Slug Variables
 Slug variables apply the [SLUG transformation](../explanation/slug-transformation-rules.md#slug-transformation): lowercase, replace special characters with `-`, preserve `.` and `_`, truncate to max length.
 ### GITHUB_REPOSITORY_SLUG
 Slug of **GITHUB_REPOSITORY** -- the owner and repository name.
 | GITHUB_REPOSITORY | GITHUB_REPOSITORY_SLUG |
 | ----------------- | ---------------------- |
 | octocat/Hello-World | octocat-hello-world |
 | rlespinasse/Hello-World.go | rlespinasse-hello-world.go |
 | AnotherPerson/SomeRepository | anotherperson-somerepository |
 ### GITHUB_REPOSITORY_OWNER_PART_SLUG
 Slug of **GITHUB_REPOSITORY_OWNER_PART** -- the owner name.
 | GITHUB_REPOSITORY_OWNER_PART | GITHUB_REPOSITORY_OWNER_PART_SLUG |
 | ---------------------------- | --------------------------------- |
 | octocat | octocat |
 | rlespinasse | rlespinasse |
 | AnotherPerson | anotherperson |
 ### GITHUB_REPOSITORY_NAME_PART_SLUG
 Slug of **GITHUB_REPOSITORY_NAME_PART** -- the repository name.
 | GITHUB_REPOSITORY_NAME_PART | GITHUB_REPOSITORY_NAME_PART_SLUG |
 | --------------------------- | -------------------------------- |
 | Hello-World | hello-world |
 | Hello-World.go | hello-world.go |
 | SomeRepository | somerepository |
 ### GITHUB_REF_SLUG
 Slug of **GITHUB_REF** -- 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 | GITHUB_REF_SLUG |
 | ---------- | --------------- |
 | refs/heads/main | main |
 | refs/heads/feat/new_feature | feat-new-feature |
 | refs/tags/v1.0.0 | v1.0.0 |
 | refs/tags/product@1.0.0-rc.2 | product-1.0.0-rc.2 |
 | refs/heads/New_Awesome_Product | new-awesome-product |
 ### GITHUB_REF_NAME_SLUG
 Slug of **GITHUB_REF_NAME** -- the branch or tag name shown on GitHub.
 _If neither a branch or tag is available for the event type, the variable will not exist._
 | GITHUB_REF_NAME | GITHUB_REF_NAME_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
 Slug of **GITHUB_HEAD_REF** -- the branch of the head repository.
 _Only set for [`pull_request*`][webhooks] events and forked repositories._
 | GITHUB_HEAD_REF | GITHUB_HEAD_REF_SLUG |
 | --------------- | -------------------- |
 | main | main |
 | feat/new_feature | feat-new-feature |
 | New_Awesome_Product | new-awesome-product |
 ### GITHUB_BASE_REF_SLUG
 Slug of **GITHUB_BASE_REF** -- the branch of the base repository.
 _Only set for [`pull_request*`][webhooks] events and forked repositories._
 | GITHUB_BASE_REF | GITHUB_BASE_REF_SLUG |
 | --------------- | -------------------- |
 | main | main |
 | feat/new_feature | feat-new-feature |
 | New_Awesome_Product | new-awesome-product |
 ### GITHUB_EVENT_REF_SLUG
 Slug of **github.event.ref** -- the Git reference resource associated to the triggered webhook.
 _Only set for [`create` and `delete`][webhooks] events._
 | github.event.ref | GITHUB_EVENT_REF_SLUG |
 | ---------------- | --------------------- |
 | main | main |
 | feat/new_feature | feat-new-feature |
 | New_Awesome_Product | new-awesome-product |
 ---
 ## URL-Safe Slug Variables
 URL-safe slug variables apply the [SLUG_URL transformation](../explanation/slug-transformation-rules.md#slug_url-transformation): same as SLUG but `.` and `_` are also replaced with `-`.
 ### GITHUB_REPOSITORY_SLUG_URL
 URL-safe slug of **GITHUB_REPOSITORY** -- the owner and repository name.
 | GITHUB_REPOSITORY | GITHUB_REPOSITORY_SLUG_URL |
 | ----------------- | -------------------------- |
 | octocat/Hello-World | octocat-hello-world |
 | rlespinasse/Hello-World.go | rlespinasse-hello-world-go |
 | AnotherPerson/SomeRepository | anotherperson-somerepository |
 ### GITHUB_REPOSITORY_OWNER_PART_SLUG_URL
 URL-safe slug of **GITHUB_REPOSITORY_OWNER_PART** -- the owner name.
 | GITHUB_REPOSITORY_OWNER_PART | GITHUB_REPOSITORY_OWNER_PART_SLUG_URL |
 | ---------------------------- | ------------------------------------- |
 | octocat | octocat |
 | rlespinasse | rlespinasse |
 | AnotherPerson | anotherperson |
 ### GITHUB_REPOSITORY_NAME_PART_SLUG_URL
 URL-safe slug of **GITHUB_REPOSITORY_NAME_PART** -- the repository name.
 | GITHUB_REPOSITORY_NAME_PART | GITHUB_REPOSITORY_NAME_PART_SLUG_URL |
 | --------------------------- | ------------------------------------ |
 | Hello-World | hello-world |
 | Hello-World.go | hello-world-go |
 | SomeRepository | somerepository |
 ### GITHUB_REF_SLUG_URL
 URL-safe slug of **GITHUB_REF** -- 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 | 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_REF_NAME_SLUG_URL
 URL-safe slug of **GITHUB_REF_NAME** -- the branch or tag name shown on GitHub.
 _If neither a branch or tag is available for the event type, the variable will not exist._
 | GITHUB_REF_NAME | GITHUB_REF_NAME_SLUG_URL |
 | --------------- | ------------------------ |
 | main | main |
 | feat/new_feature | feat-new-feature |
 | v1.0.0 | v1-0-0 |
 | 42/merge | 42-merge |
 | product@1.0.0-rc.2 | product-1-0-0-rc-2 |
 | New_Awesome_Product | new-awesome-product |
 ### GITHUB_HEAD_REF_SLUG_URL
 URL-safe slug of **GITHUB_HEAD_REF** -- the branch of the head repository.
 _Only set for [`pull_request*`][webhooks] events and forked repositories._
 | GITHUB_HEAD_REF | GITHUB_HEAD_REF_SLUG_URL |
 | --------------- | ------------------------ |
 | main | main |
 | feat/new_feature | feat-new-feature |
 | New_Awesome_Product | new-awesome-product |
 ### GITHUB_BASE_REF_SLUG_URL
 URL-safe slug of **GITHUB_BASE_REF** -- the branch of the base repository.
 _Only set for [`pull_request*`][webhooks] events and forked repositories._
 | GITHUB_BASE_REF | GITHUB_BASE_REF_SLUG_URL |
 | --------------- | ------------------------ |
 | main | main |
 | feat/new_feature | feat-new-feature |
 | New_Awesome_Product | new-awesome-product |
 ### GITHUB_EVENT_REF_SLUG_URL
 URL-safe slug of **github.event.ref** -- the Git reference resource associated to the triggered webhook.
 _Only set for [`create` and `delete`][webhooks] events._
 | github.event.ref | GITHUB_EVENT_REF_SLUG_URL |
 | ---------------- | ------------------------- |
 | main | main |
 | feat/new_feature | feat-new-feature |
 | New_Awesome_Product | new-awesome-product |
 ---
 ## Short Variables
 ### GITHUB_SHA_SHORT
 Shortened **GITHUB_SHA** -- the commit SHA that triggered the workflow.
 | GITHUB_SHA | GITHUB_SHA_SHORT |
 | ---------- | ---------------- |
 | ffac537e6cbbf934b08745a378932722df287a53 | ffac537e |
 ### GITHUB_EVENT_PULL_REQUEST_HEAD_SHA_SHORT
 Shortened value of `github.event.pull_request.head.sha` -- the last commit on the pull request that triggered the workflow.
 | github.event.pull_request.head.sha | GITHUB_EVENT_PULL_REQUEST_HEAD_SHA_SHORT |
 | ---------------------------------- | ---------------------------------------- |
 | ffac537e6cbbf934b08745a378932722df287a53 | ffac537e |
 ---
 ## Case-Sensitive Variants
 All slug and slug-url variables have a `_CS` suffix variant that preserves the original casing. The `_CS` variant applies the same transformation but skips the lowercase step.
 | Standard | Case-Sensitive |
 | -------- | -------------- |
 | `GITHUB_REPOSITORY_SLUG` | `GITHUB_REPOSITORY_SLUG_CS` |
 | `GITHUB_REPOSITORY_SLUG_URL` | `GITHUB_REPOSITORY_SLUG_URL_CS` |
 | `GITHUB_REF_SLUG` | `GITHUB_REF_SLUG_CS` |
 | `GITHUB_REF_SLUG_URL` | `GITHUB_REF_SLUG_URL_CS` |
 | _(and so on for all slug/slug-url variables)_ | |
 Example:
 | Input | SLUG | SLUG_CS |
 | ----- | ---- | ------- |
 | `refs/heads/New_Awesome_Product` | `new-awesome-product` | `New-Awesome-Product` |
 ---
 ## Variable Availability by Event
 Not all variables are set for every event type. See [GitHub variables by event](github-variables.md) for the full matrix.
 [webhooks]: https://docs.github.com/en/developers/webhooks-and-events/webhook-events-and-payloads
--- a/docs/short-variables.md
+++ b/docs/short-variables.md
@@ -1,3 +0,0 @@
 # Short Variables
 This page has moved to [reference/variables.md](reference/variables.md#short-variables).
--- a/docs/slug-url-variables.md
+++ b/docs/slug-url-variables.md
@@ -1,3 +0,0 @@
 # Slug URL Variables
 This page has moved to [reference/variables.md](reference/variables.md#url-safe-slug-variables).
--- a/docs/slug-variables.md
+++ b/docs/slug-variables.md
@@ -1,3 +0,0 @@
 # Slug Variables
 This page has moved to [reference/variables.md](reference/variables.md#slug-variables).
--- a/entrypoint.sh
+++ b/entrypoint.sh
@@ -0,0 +1,56 @@
 #!/bin/sh -l
 slug() {
  echo "$1" |
    tr "[:upper:]" "[:lower:]" |
    sed -r 's/[~\^]+//g;s/[^a-zA-Z0-9.]+/-/g;s/^-+\|-+$//g;s/^-*//;s/-*$//' |
    cut -c1-63
 }
 slug_url() {
  echo "$1" |
    tr "[:upper:]" "[:lower:]" |
    sed -r 's/[~\^]+//g;s/[^a-zA-Z0-9]+/-/g;s/^-+\|-+$//g;s/^-*//;s/-*$//' |
    cut -c1-63
 }
 slug_ref() {
  echo "$1" |
    tr "[:upper:]" "[:lower:]" |
    sed -r 's#refs/[^\/]*/##;s/[~\^]+//g;s/[^a-zA-Z0-9.]+/-/g;s/^-+\|-+$//g;s/^-*//;s/-*$//' |
    cut -c1-63
 }
 slug_url_ref() {
  echo "$1" |
    tr "[:upper:]" "[:lower:]" |
    sed -r 's#refs/[^\/]*/##;s/[~\^]+//g;s/[^a-zA-Z0-9]+/-/g;s/^-+\|-+$//g;s/^-*//;s/-*$//' |
    cut -c1-63
 }
 short_sha() {
  echo "$1" |
    cut -c1-8
 }
 get_event_keyvalue() {
  if [ -f "$GITHUB_EVENT_PATH" ]; then
    jq -r ".$1" "$GITHUB_EVENT_PATH" | grep -v "null"
  fi
 }
 {
  echo "GITHUB_REPOSITORY_SLUG=$(slug "$GITHUB_REPOSITORY")"
  echo "GITHUB_REPOSITORY_SLUG_URL=$(slug_url "$GITHUB_REPOSITORY")"
  echo "GITHUB_REF_SLUG=$(slug_ref "$GITHUB_REF")"
  echo "GITHUB_HEAD_REF_SLUG=$(slug_ref "$GITHUB_HEAD_REF")"
  echo "GITHUB_BASE_REF_SLUG=$(slug_ref "$GITHUB_BASE_REF")"
  echo "GITHUB_EVENT_REF_SLUG=$(slug_ref "$(get_event_keyvalue "ref")")"
  echo "GITHUB_REF_SLUG_URL=$(slug_url_ref "$GITHUB_REF")"
  echo "GITHUB_HEAD_REF_SLUG_URL=$(slug_url_ref "$GITHUB_HEAD_REF")"
  echo "GITHUB_BASE_REF_SLUG_URL=$(slug_url_ref "$GITHUB_BASE_REF")"
  echo "GITHUB_EVENT_REF_SLUG_URL=$(slug_url_ref "$(get_event_keyvalue "ref")")"
  echo "GITHUB_SHA_SHORT=$(short_sha "$GITHUB_SHA")"
 } >>"$GITHUB_ENV"
 echo "::warning ::This version only support linux-based workflow, please use 'rlespinasse/github-slug-action@v3.x' instead"
--- a/examples/macos-usage.yml
+++ b/examples/macos-usage.yml
@@ -1,34 +0,0 @@
 name: MacOS usage
 on: push
 jobs:
  usage:
    runs-on: macos-latest
    steps:
      - uses: actions/checkout@v6
      - uses: rlespinasse/github-slug-action@v5
      - name: Output
        run: |
          echo "Partial variables"
          echo "   repository owner    : ${{ env.GITHUB_REPOSITORY_OWNER_PART }}"
          echo "   repository name     : ${{ env.GITHUB_REPOSITORY_NAME_PART }}"
          echo "Slug variables"
          echo "   repository          : ${{ env.GITHUB_REPOSITORY_SLUG }}"
          echo "   repository owner    : ${{ env.GITHUB_REPOSITORY_OWNER_PART_SLUG }}"
          echo "   repository name     : ${{ env.GITHUB_REPOSITORY_NAME_PART_SLUG }}"
          echo "   ref                 : ${{ env.GITHUB_REF_SLUG }}"
          echo "   head ref            : ${{ env.GITHUB_HEAD_REF_SLUG }}"
          echo "   base ref            : ${{ env.GITHUB_BASE_REF_SLUG }}"
          echo "   event ref           : ${{ env.GITHUB_EVENT_REF_SLUG }}"
          echo "Slug URL variables"
          echo "   repository          : ${{ env.GITHUB_REPOSITORY_SLUG_URL }}"
          echo "   repository owner    : ${{ env.GITHUB_REPOSITORY_OWNER_PART_SLUG_URL }}"
          echo "   repository name     : ${{ env.GITHUB_REPOSITORY_NAME_PART_SLUG_URL }}"
          echo "   ref                 : ${{ env.GITHUB_REF_SLUG_URL }}"
          echo "   head ref            : ${{ env.GITHUB_HEAD_REF_SLUG_URL }}"
          echo "   base ref            : ${{ env.GITHUB_BASE_REF_SLUG_URL }}"
          echo "   event ref           : ${{ env.GITHUB_EVENT_REF_SLUG_URL }}"
          echo "Short SHA variables"
          echo "   sha                 : ${{ env.GITHUB_SHA_SHORT }}"
          echo "   pull request sha    : ${{ env.GITHUB_EVENT_PULL_REQUEST_HEAD_SHA_SHORT }}"
--- a/examples/url-use.yml
+++ b/examples/url-use.yml
@@ -1,20 +0,0 @@
 name: URL use
 on: push
 jobs:
  as_subdomain:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6
      - uses: rlespinasse/github-slug-action@v5
      - run: |
          ./deploy-application.sh --url "https://${{ env.GITHUB_REF_SLUG_URL }}.staging.app.example.com"
  as_resource_path:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6
      - uses: rlespinasse/github-slug-action@v5
      - run: |
          ./deploy-application.sh --url "https://staging.app.example.com/${{ env.GITHUB_REF_SLUG_URL }}"
--- a/examples/windows-usage.yml
+++ b/examples/windows-usage.yml
@@ -1,34 +0,0 @@
 name: Windows usage
 on: push
 jobs:
  usage:
    runs-on: windows-latest
    steps:
      - uses: actions/checkout@v6
      - uses: rlespinasse/github-slug-action@v5
      - name: Output
        run: |
          echo "Partial variables"
          echo "   repository owner    : $env:GITHUB_REPOSITORY_OWNER_PART"
          echo "   repository name     : $env:GITHUB_REPOSITORY_NAME_PART"
          echo "Slug variables"
          echo "   repository          : $env:GITHUB_REPOSITORY_SLUG"
          echo "   repository owner    : $env:GITHUB_REPOSITORY_OWNER_PART_SLUG"
          echo "   repository name     : $env:GITHUB_REPOSITORY_NAME_PART_SLUG"
          echo "   ref                 : $env:GITHUB_REF_SLUG"
          echo "   head ref            : $env:GITHUB_HEAD_REF_SLUG"
          echo "   base ref            : $env:GITHUB_BASE_REF_SLUG"
          echo "   event ref           : $env:GITHUB_EVENT_REF_SLUG"
          echo "Slug URL variables"
          echo "   repository          : $env:GITHUB_REPOSITORY_SLUG_URL"
          echo "   repository owner    : $env:GITHUB_REPOSITORY_OWNER_PART_SLUG_URL"
          echo "   repository name     : $env:GITHUB_REPOSITORY_NAME_PART_SLUG_URL"
          echo "   ref                 : $env:GITHUB_REF_SLUG_URL"
          echo "   head ref            : $env:GITHUB_HEAD_REF_SLUG_URL"
          echo "   base ref            : $env:GITHUB_BASE_REF_SLUG_URL"
          echo "   event ref           : $env:GITHUB_EVENT_REF_SLUG_URL"
          echo "Short SHA variables"
          echo "   sha                 : $env:GITHUB_SHA_SHORT"
          echo "   pull request sha    : $env:GITHUB_EVENT_PULL_REQUEST_HEAD_SHA_SHORT"
--- a/package-lock.json
+++ b/package-lock.json
--- a/package.json
+++ b/package.json
@@ -0,0 +1,32 @@
 {
  "name": "github-slug-action",
  "version": "0.0.0",
  "license": "MIT",
  "scripts": {
    "test": "docker run -w /workdir -v $(pwd):/workdir ffurrer/bats:latest --recursive .",
    "release": "semantic-release"
  },
  "repository": {
    "type": "git",
    "url": "http://github.com/rlespinasse/github-slug-action.git"
  },
  "devDependencies": {
    "@semantic-release/changelog": "5.0.1",
    "@semantic-release/git": "9.0.0",
    "semantic-release": "17.0.7"
  },
  "release": {
    "tagFormat": "${version}",
    "plugins": [
      "@semantic-release/commit-analyzer",
      "@semantic-release/release-notes-generator",
      "@semantic-release/changelog",
      "@semantic-release/git",
      "@semantic-release/github"
    ],
    "branches": [
      "v1.1.x",
      "v2.x"
    ]
  }
 }
--- a/preflight.sh
+++ b/preflight.sh
@@ -1,38 +0,0 @@
 #!/usr/bin/env bash
 if [ -z "${INPUT_SLUG_MAXLENGTH}" ]; then
  echo "::error ::slug-maxlength cannot be empty"
  exit 1
 elif [ "${INPUT_SLUG_MAXLENGTH}" != "nolimit" ] && [ ! "${INPUT_SLUG_MAXLENGTH}" -eq "${INPUT_SLUG_MAXLENGTH}" ] 2>/dev/null; then
  echo "::error ::slug-maxlength must be a number or equals to 'nolimit'"
  exit 1
 fi
 if [ ! "${INPUT_SHORT_LENGTH}" -eq "${INPUT_SHORT_LENGTH}" ] 2>/dev/null; then
  echo "::error ::short-length must be a number"
  exit 1
 fi
 echo "::debug ::Control preflight short-length setup"
 PREFLIGHT_SHORT_LENGTH=""
 if [ -n "${INPUT_SHORT_LENGTH}" ]; then
  PREFLIGHT_SHORT_LENGTH="${INPUT_SHORT_LENGTH}"
  echo "::debug ::Use input value: $PREFLIGHT_SHORT_LENGTH"
 elif [ "$(git rev-parse --is-inside-work-tree)" == "true" ]; then
  echo "::debug ::The action run inside a git repository, short-length can be empty"
 else
  echo "::debug ::The action run outside a git repository, need to set short-length"
  PREFLIGHT_SHORT_LENGTH="$(git config --get core.abbrev)"
  if [ -n "${PREFLIGHT_SHORT_LENGTH}" ]; then
    echo "::debug ::Git Configuration 'core.abbrev' is set, using it as short-length"
  else
    PREFLIGHT_SHORT_LENGTH="7"
    echo "::debug ::Using fallback value for short-length"
  fi
 fi
 echo "::debug ::Set PREFLIGHT_SHORT_LENGTH=$PREFLIGHT_SHORT_LENGTH"
 if [ -f "$GITHUB_OUTPUT" ]; then
  echo "PREFLIGHT_SHORT_LENGTH=${PREFLIGHT_SHORT_LENGTH}" >> "$GITHUB_OUTPUT"
 else
  echo "::set-output name=PREFLIGHT_SHORT_LENGTH::${PREFLIGHT_SHORT_LENGTH}"
 fi
--- a/tests/short_sha.bats
+++ b/tests/short_sha.bats
@@ -0,0 +1,19 @@
 #!/usr/bin/env bats
@test "short_sha: long hash" {
  test_short_sha \
    "a35a1a486a260cfd99c5b6f8c6034a2929ba9b3f" \
    "a35a1a48"
 }
 # Load sluf_ref function
 source entrypoint.sh > /dev/null 2>&1
 test_short_sha(){
  given="${1}"
  expected="${2}"
  actual="$(short_sha ${given})"
  echo "expected : [${expected}], actual : [${actual}]"
  [ "${actual}" == "${expected}" ]
 }
--- a/tests/slug.bats
+++ b/tests/slug.bats
@@ -0,0 +1,49 @@
 #!/usr/bin/env bats
@test "slug: a word" {
  test_slug \
    "word" \
    "word"
 }
@test "slug: a string" {
  test_slug \
    "basic-string" \
    "basic-string"
 }
@test "slug: a string in camel case" {
  test_slug \
    "camelCase" \
    "camelcase"
 }
@test "slug: a path" {
  test_slug \
    "path/to/something" \
    "path-to-something"
 }
@test "slug: a number" {
  test_slug \
    "4.2" \
    "4.2"
 }
@test "slug: a very long string" {
  test_slug \
    "an-awesome-Feature-Very-Very-Very-Very-Very-Very-Very-Long-moreThan63Characters" \
    "an-awesome-feature-very-very-very-very-very-very-very-long-more"
 }
 # Load sluf_ref function
 source entrypoint.sh > /dev/null 2>&1
 test_slug() {
  given="${1}"
  expected="${2}"
  actual="$(slug \"${given}\")"
  echo "expected : [${expected}], actual : [${actual}]"
  [ "${actual}" == "${expected}" ]
 }
--- a/tests/slug_ref.bats
+++ b/tests/slug_ref.bats
@@ -0,0 +1,55 @@
 #!/usr/bin/env bats
@test "slug_ref:: master branch" {
  test_slug_ref \
    "refs/heads/master" \
    "master"
 }
@test "slug_ref: a feature branch" {
  test_slug_ref \
    "refs/heads/feat/new_feature" \
    "feat-new-feature"
 }
@test "slug_ref: a fix branch" {
  test_slug_ref \
    "refs/heads/fix/issue_number" \
    "fix-issue-number"
 }
@test "slug_ref: a simple tag" {
  test_slug_ref \
    "refs/tags/v1.0.0" \
    "v1.0.0"
 }
@test "slug_ref: a complex tag" {
  test_slug_ref \
    "refs/tags/product@1.0.0-rc.2" \
    "product-1.0.0-rc.2"
 }
@test "slug_ref: a reference with upper case letters" {
  test_slug_ref \
    "refs/heads/New_Awesome_Product" \
    "new-awesome-product"
 }
@test "slug_ref: a very long name" {
  test_slug_ref \
    "refs/heads/an-awesome-Feature-Very-Very-Very-Very-Very-Very-Very-Long-moreThan63Characters" \
    "an-awesome-feature-very-very-very-very-very-very-very-long-more"
 }
 # Load sluf_ref function
 source entrypoint.sh > /dev/null 2>&1
 test_slug_ref() {
  given="${1}"
  expected="${2}"
  actual="$(slug_ref \"${given}\")"
  echo "expected : [${expected}], actual : [${actual}]"
  [ "${actual}" == "${expected}" ]
 }
--- a/tests/slug_url.bats
+++ b/tests/slug_url.bats
@@ -0,0 +1,49 @@
 #!/usr/bin/env bats
@test "slug_url: a word" {
  test_slug_url \
    "word" \
    "word"
 }
@test "slug_url: a string" {
  test_slug_url \
    "basic-string" \
    "basic-string"
 }
@test "slug_url: a string in camel case" {
  test_slug_url \
    "camelCase" \
    "camelcase"
 }
@test "slug_url: a path" {
  test_slug_url \
    "path/to/something" \
    "path-to-something"
 }
@test "slug_url: a number" {
  test_slug_url \
    "4.2" \
    "4-2"
 }
@test "slug_url: a very long string" {
  test_slug_url \
    "an-awesome-Feature-Very-Very-Very-Very-Very-Very-Very-Long-moreThan63Characters" \
    "an-awesome-feature-very-very-very-very-very-very-very-long-more"
 }
 # Load sluf_ref function
 source entrypoint.sh > /dev/null 2>&1
 test_slug_url() {
  given="${1}"
  expected="${2}"
  actual="$(slug_url \"${given}\")"
  echo "expected : [${expected}], actual : [${actual}]"
  [ "${actual}" == "${expected}" ]
 }
--- a/tests/slug_url_ref.bats
+++ b/tests/slug_url_ref.bats
@@ -0,0 +1,55 @@
 #!/usr/bin/env bats
@test "slug_url_ref: master branch" {
  test_slug_url_ref \
    "refs/heads/master" \
    "master"
 }
@test "slug_url_ref: a feature branch" {
  test_slug_url_ref \
    "refs/heads/feat/new_feature" \
    "feat-new-feature"
 }
@test "slug_url_ref: a fix branch" {
  test_slug_url_ref \
    "refs/heads/fix/issue_number" \
    "fix-issue-number"
 }
@test "slug_url_ref: a simple tag" {
  test_slug_url_ref \
    "refs/tags/v1.0.0" \
    "v1-0-0"
 }
@test "slug_url_ref: a complex tag" {
  test_slug_url_ref \
    "refs/tags/product@1.0.0-rc.2" \
    "product-1-0-0-rc-2"
 }
@test "slug_url_ref: a reference with upper case letters" {
  test_slug_url_ref \
    "refs/heads/New_Awesome_Product" \
    "new-awesome-product"
 }
@test "slug_url_ref: a very long name" {
  test_slug_url_ref \
    "refs/heads/an-awesome-Feature-Very-Very-Very-Very-Very-Very-Very-Long-moreThan63Characters" \
    "an-awesome-feature-very-very-very-very-very-very-very-long-more"
 }
 # Load sluf_ref function
 source entrypoint.sh > /dev/null 2>&1
 test_slug_url_ref() {
  given="${1}"
  expected="${2}"
  actual="$(slug_url_ref \"${given}\")"
  echo "expected : [${expected}], actual : [${actual}]"
  [ "${actual}" == "${expected}" ]
 }
Author	SHA1	Message	Date
semantic-release-bot	9d2c65418d	chore(release): 2.2.0 [skip ci] # [2.2.0](http://github.com/rlespinasse/github-slug-action/compare/2.1.1...2.2.0) (2021-04-05) ### Features * add version warning ([`f536765`](`f536765da4`))	2021-04-05 18:00:05 +00:00
rlespinasse	f536765da4	feat: add version warning	2021-04-05 19:59:17 +02:00
semantic-release-bot	72cfc4cb1f	chore(release): 2.1.1 [skip ci] ## [2.1.1](http://github.com/rlespinasse/github-slug-action/compare/2.1.0...2.1.1) (2020-10-07) ### Bug Fixes * remove set-env due to CVE fix ([`d678898`](`d678898ce5`))	2020-10-07 20:54:07 +00:00
rlespinasse	d678898ce5	fix: remove set-env due to CVE fix	2020-10-07 22:53:24 +02:00
Romain Lespinasse	f527ed6e85	docs: add reference to the v3.x branch	2020-09-26 09:12:06 +02:00
		`@@ -1,3 +0,0 @@`
			`# Available GitHub Variables`

			`This page has moved to [reference/github-variables.md](reference/github-variables.md).`
		`@@ -1,3 +0,0 @@`
			`# Partial Variables`

			`This page has moved to [reference/variables.md](reference/variables.md#partial-variables).`
		`@@ -1,3 +0,0 @@`
			`# Short Variables`

			`This page has moved to [reference/variables.md](reference/variables.md#short-variables).`
		`@@ -1,3 +0,0 @@`
			`# Slug URL Variables`

			`This page has moved to [reference/variables.md](reference/variables.md#url-safe-slug-variables).`
		`@@ -1,3 +0,0 @@`
			`# Slug Variables`

			`This page has moved to [reference/variables.md](reference/variables.md#slug-variables).`