GitHub slug action

GitHub Action to expose slug values of branches, tags, or versions inside your GitHub workflow.

Overview

A slug applied to a variable will:

• Convert the variable content to lowercase
• Replace special characters like $ or % with dollar and percent, respectively
• Replace any character except 0-9, a-z, and - with -
• Remove leading, trailing, and duplicated - characters

Usage

Add this in your workflow:

jobs:
- uses: gacts/github-slug@v1id: slugwith:
to-slug: Hello ${{ github.actor }}! How are you? # feel free to use any variable or string here

In subsequent steps, you will be able to use the following variables:

Description	How to use in your workflow	Examples for branch/tag workflows
A slugged version of "to-slug" input	${{ steps.slug.outputs.slug }}	hello-username-how-are-you
The workflow was triggered on a branch	${{ steps.slug.outputs.is-branch }}	true/false
The workflow was triggered on a tag	${{ steps.slug.outputs.is-tag }}	false/true
Current branch name	${{ steps.slug.outputs.branch-name }}	fix/Foo_bar/<empty-value>
A slugged version of branch-name	${{ steps.slug.outputs.branch-name-slug }}	fix-foo-bar/<empty-value>
Current tag name	${{ steps.slug.outputs.tag-name }}	<empty-value>/v1.2-rc1_Lorem
A slugged version of tag-name	${{ steps.slug.outputs.tag-name-slug }}	<empty-value>/v1-2-rc1-lorem
The commit SHA hash that triggered the workflow	${{ steps.slug.outputs.commit-hash }}	ffac537e6cbbf934b08745a378932722df287a53
Short (7 first characters) commit SHA hash	${{ steps.slug.outputs.commit-hash-short }}	ffac537
Cleared and slugged version value *	${{ steps.slug.outputs.version }}	fix-foo-bar/1.2-rc1-lorem
Major version	${{ steps.slug.outputs.version-major }}	0/1
Minor version	${{ steps.slug.outputs.version-minor }}	0/2
Patch version	${{ steps.slug.outputs.version-patch }}	0/0
Semantic version value	${{ steps.slug.outputs.version-semantic }}	0.0.0-fix-foo-bar/1.2.0-rc1-lorem

^* A prefix v/ver/version[._-] will be removed

Usage examples

On a branch:

name: testson:
push:
branches: [master, main]paths-ignore: ['**.md']tags-ignore: ['**']pull_request:
paths-ignore: ['**.md']jobs:
build:
name: Build for ${{ matrix.os }} (${{ matrix.arch }})runs-on: ubuntu-lateststrategy:
fail-fast: falsematrix:
os: [linux, darwin]arch: [amd64]steps:
- name: Set up Gouses: actions/setup-go@v5with: {go-version: 1.22}
- name: Check out codeuses: actions/checkout@v4
- uses: gacts/github-slug@v1id: slug
- name: Build applicationenv:
GOOS: ${{ matrix.os }}GOARCH: ${{ matrix.arch }}CGO_ENABLED: 0LDFLAGS: -s -w -X internal/pkg/version.version=${{ steps.slug.outputs.branch-name-slug }}@${{ steps.slug.outputs.commit-hash-short }}run: go build -trimpath -ldflags "$LDFLAGS" -o ./app ./cmd/app/

On a tag:

name: releaseon:
release: # Docs: <https://help.github.com/en/articles/events-that-trigger-workflows#release-event-release>types: [published]jobs:
docker-image:
name: Build the docker imageruns-on: ubuntu-lateststeps:
- name: Check out codeuses: actions/checkout@v4
- uses: gacts/github-slug@v1id: slug
- name: Login to GitHub Container Registryuses: docker/login-action@v3 # Action page: <https://github.com/docker/login-action>with:
registry: ghcr.iousername: ${{ github.actor }}password: ${{ secrets.GHCR_PASSWORD }} # PAT token, generate new: <https://github.com/settings/tokens/new>
- uses: docker/build-push-action@v6 # Action page: <https://github.com/docker/build-push-action>with:
context: .file: Dockerfilepush: truetags: | ghcr.io/${{ github.actor }}/${{ github.event.repository.name }}:${{ steps.slug.outputs.version }} ghcr.io/${{ github.actor }}/${{ github.event.repository.name }}:latest

Releasing

To release a new version:

• Build the action distribution (make build or npm run build).
• Commit and push changes (including dist directory changes - this is important) to the master|main branch.
• Publish the new release using the repo releases page (the git tag should follow the vX.Y.Z format).

Major and minor git tags (v1 and v1.2 if you publish a v1.2.Z release) will be updated automatically.

Tip

Use Dependabot to keep this action updated in your repository.

Support

If you find any errors in the action, please create an issue in this repository.

License

This is open-source software licensed under the MIT License.