action-git-version

A GitHub action to build a version number based on the Git tags and branches

Only uses CMake and Git to build the version number.

Basic usage

See action.yml for a complete list of options and outputs.

steps:
- uses: actions/checkout@v4
  with:
    # This action needs access to the history and tags.
    # With 'fetch-depth: 0' the action fetches the complete history and all tags.
    # You can also limit the depth to a certain number and run
    # with 'fetch-tags: true'. The produced version number might not
    # be accurate in that case.
    fetch-depth: 0

- name: Run Git Version
  id: gitversion
  uses: toitlang/action-git-version@v1.1.0

- name: Use the version
  shell: bash
  run: |
    echo ${{ steps.gitversion.outputs.version }}