Skip to content
info

GitHub Action

Extracts the version from github context

v2.3.1 Latest version

Extracts the version from github context

info

Extracts the version from github context

Extracts the version information from github.ref property

Installation

Copy and paste the following snippet into your .yml file.

              

- name: Extracts the version from github context

uses: thombashi/get-version-action@v2.3.1

Learn more about this action in thombashi/get-version-action

Choose a version

Get Version Action

Forked from battila7/get-version-action

A GitHub Action which extracts the version from github.ref.

Finally, you can reliably get the pushed version on every platform. Now includes support for semver!

Outputs

version

The pushed version. If github.ref was refs/tags/v1.2.7 or refs/heads/release/v1.2.7 then the value of this output will be v1.2.7.

version-without-v

The pushed version with the leading v stripped. If github.ref was refs/tags/v1.2.7 then the value of this output will be 1.2.7.

If the version does not start with a leading v character, then the value of this output is the same as that of version.

is-semver

Set to true if the pushed version is a valid semver value. If it's not, then this output will not be set.

major

The semver major version, for example 1 in the case of v1.2.3-ALPHA.0+BUILD.1.

minor

The semver minor version, for example 2 in the case of v1.2.3-ALPHA.0+BUILD.1.

patch

The semver patch version, for example 3 in the case of v1.2.3-ALPHA.0+BUILD.1.

prerelease

The semver prerelease version, for example ALPHA.0 in the case of v1.2.3-ALPHA.0+BUILD.1.

build

The semver build version, for example BUILD.1 in the case of v1.2.3-ALPHA.0+BUILD.1.

Example usage

name: Example Usage

on:
  push:
    tags:
      - "v*.*.*"

jobs:
  example:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v3

      - id: get_version
        uses: thombashi/get-version-action@v2

      - name: echo outputs
        run: |
          echo "version: ${{ steps.get_version.outputs.version }}"
          echo "version-without-v: ${{ steps.get_version.outputs.version-without-v }}"