gitcalver/gitcalver
Derive version numbers from git history using calendar versioning
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Stale
- License
- None
Inputs
| name | description | required | default |
|---|---|---|---|
| prefix | Literal string prepended to version (e.g., "0." for semver, "v0." for Go modules) | no | "" |
| dirty | Enable dirty versions with this suffix string (e.g., "-dirty", "+dirty", "-SNAPSHOT"). Empty (default) refuses dirty workspaces. | no | "" |
| dirty-hash | Append .HASH suffix on dirty versions | no | true |
| branch | Override default branch detection | no | "" |
| remote | Remote used for cached branch detection and tag publication | no | origin |
| tag-prefix | Literal string prepended to the version when naming the tag | no | "" |
| tag | Create and push a lightweight git tag with the computed version. Requires the version to be clean (not dirty) and contents: write permission. | no | false |
Outputs
| name | description |
|---|---|
| version | The computed version string |
| date | The YYYYMMDD date component |
| count | The N count component |
| dirty | Whether the workspace was dirty (true/false) |
| hash | Short SHA of HEAD |
| tag | Tag name formed from tag-prefix and version |