Skip to content

Latest commit

 

History

History
71 lines (60 loc) · 3.39 KB

README.md

File metadata and controls

71 lines (60 loc) · 3.39 KB
Raw

git-describe-semver

Replacement for git describe --tags that produces semver compatible versions that follow to semver sorting rules.

Comparison

Previous git tag git describe --tags git-describe-semver --fallback v0.0.0
v1.2.3 v1.2.3 v1.2.3
v1.2.3 v1.2.3-23-gabc1234 v1.2.4-dev.23.gabc1234
v1.3.0-rc.1 v1.3.0-rc.1-23-gabc1234 v1.3.0-rc.1.dev.23.gabc1234
v1.3.0-rc.1+info v1.3.0-rc.1+info-23-gabc1234 v1.3.0-rc.1.dev.23.gabc1234+info
none fail v0.0.0-dev.23.gabc1234

Next Release

Previous git tag git describe --tags git-describe-semver --fallback v0.0.0 --next-release
v1.2.3 v1.2.3 v1.2.4 patch
v1.2.3 v1.2.3-23-gabc1234 v1.2.4 patch
v1.3.0-rc.1 v1.3.0-rc.1-23-gabc1234 v1.3.0 patch / minor
v1.3.1-rc.1 v1.3.1-rc.1-23-gabc1234 v1.4.0 minor
v1.0.0-rc.1 v1.0.0-rc.1-23-gabc1234 v1.0.0 major
v1.0.0 v1.0.0 v2.0.0 major
v1.0.1-rc.1 v1.0.1-rc.1-23-gabc1234 v2.0.0 major
none fail v0.0.0 patch / minor / major

Usage

  • Flag --dir /some/git/worktree: Git worktree directory (defaults to current directory .)
  • Flag --fallback v0.0.0: Fallback to given tag name if no tag is available
  • Flag --drop-prefix: Drop any present prefix (like v) from the output
  • Flag --prerelease-suffix: Adds a dash-separated suffix to the prerelease part
  • Flag --prerelease-prefix: Adds a dash-separated prefix to the prerelease part (defaults to dev)
  • Flag --prerelease-timestamped: Use timestamp instead of commit count for prerelease
  • Flag --next-release: Bump current version to next release (choices: major, minor, patch)
  • Flag --format: Changes output (use <version> as placeholder)

Docker

cd my-git-directory
docker pull ghcr.io/choffmeister/git-describe-semver:latest
docker run --rm -v $PWD:/workdir ghcr.io/choffmeister/git-describe-semver:latest

GitHub action

# .github/workflows/build.yml
name: build
jobs:
  update:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v3
      with:
        fetch-depth: 0
    - id: git-describe-semver
      uses: choffmeister/git-describe-semver@main
      with:
        version: latest
        dir: .
        fallback: v0.0.0
        drop-prefix: true
        prerelease-prefix: dev
        prerelease-suffix: SNAPSHOT
        prerelease-timestamped: true
        next-release: ''
    - run: echo This is the version ${{ steps.git-describe-semver.outputs.version }}