https://github.com/socialviolation/git-calver
git subcommand for helping do Calendar Versioning
https://github.com/socialviolation/git-calver
calver git golang
Last synced: 5 months ago
JSON representation
git subcommand for helping do Calendar Versioning
- Host: GitHub
- URL: https://github.com/socialviolation/git-calver
- Owner: socialviolation
- License: mit
- Created: 2024-02-28T09:11:38.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-09-22T12:21:34.000Z (9 months ago)
- Last Synced: 2025-09-22T13:09:29.055Z (9 months ago)
- Topics: calver, git, golang
- Language: Go
- Homepage:
- Size: 77.1 KB
- Stars: 6
- Watchers: 1
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# git-calver
`git calver` is intended as a git subcommand utility, to manipulate git tags using [CalVer](https://calver.org/).
## Installation
```bash
go install github.com/socialviolation/git-calver
```
## Set up
`calver` requires a CalVer format to be provided.
```bash
# .git/config setting - Lowest Priority
$ git calver format
YYYY.0M
# It can be set with calver
$ git calver format set --format="YYYY.0M"
# OR Environment Var - medium priority
export CALVER="YYYY.0M.0D"
# OR FLAG - highest priority
$ git calver tag --format="YY.0M.DD"
# specify `-AUTO` for auto-incrementing
$ git calver tag --format="YY.0M-AUTO"
```
## Usage
```bash
$ git calver help
CalVer is a git subcommand for managing a calendar versioning tag scheme.
Usage:
git-calver [flags]
git-calver [command]
Available Commands:
completion Generate the autocompletion script for the specified shell
format Get format from .gitconfig
help Help about any command
latest Get latest tag matching the provided format
list Will list all CalVer tags matching the provided format
next Output what the next calver tag will be
retag retag
tag tag
untag untag
Flags:
-d, --dry-run Dry run
-f, --format string format of calver (YYYY.0M.0D)
-h, --help help for git-calver
--micro uint Micro Version
--minor uint Minor Version
--modifier string Modifer (eg. DEV, RC, etc)
Use "git calver [command] --help" for more information about a command.
```
## Supported Formats
Review [calver.go](./ver/calver.go) for the calver format spec
Supported values are as follows:
```text
// FullYear notation - 2006, 2016, 2106
FullYear = "YYYY"
// ShortYear notation - 6, 16, 106
ShortYear = "YY"
// PaddedYear notation - 06, 16, 106
PaddedYear = "0Y"
// ShortMonth notation - 1, 2 ... 11, 12
ShortMonth = "MM"
// PaddedMonth notation - 01, 02 ... 11, 12
PaddedMonth = "0M"
// ShortWeek notation - 1, 2, 33, 52
ShortWeek = "WW"
// PaddedWeek notation - 01, 02, 33, 52
PaddedWeek = "0W"
// ShortDay notation - 1, 2 ... 30, 31
ShortDay = "DD"
// PaddedDay notation - 01, 02 ... 30, 31
PaddedDay = "0D"
// Auto Increment notation - `-AUTO`
Auto = "-AUTO"
Minor = "MINOR"
Micro = "MICRO"
```