lfaoro / gtag

🐾 gTag is a $(git tag) workflow tool for semantic versioning (semver.org)

🐾 gTag

🐾 gTag is a $(git tag) workflow tool for semantic versioning (semver.org)

Examples

$ gtag zero
tag 0.0.0 created on commit c1788742

$ gtag minor
incremented 0.0.0 -> 0.1.0 on commit d846485e

$ gtag list
tag 0.0.0 [c1788742] by Leonardo on August 06 2019 at 16:12:46
tag 0.1.0 [d846485e] by Leonardo on August 08 2019 at 00:37:29

$ gtag major beta
tag 1.0.0-beta created on commit e894b051

$ gtag minor rc1
tag 1.1.0-rc1 created on commit 7706b9ad

$ gtag del
deleted 1.1.0-rc1 for commit 7706b9ad

$ gtag del --all
You're about to delete all tags, are you sure? y/n

Quick Start

Video Tutorial

macOS (Homebrew)

brew install lfaoro/tap/gtag

Linux & macOS

curl -fsSL https://raw.githubusercontent.com/lfaoro/gtag/master/hack/install.sh | bash

Developers

Go installer: https://golang.org/dl/

go get -d github.com/lfaoro/gtag
cd $GOPATH/src/github.com/lfaoro/gtag
make install
gtag -h

Contributing

Any help and suggestions are very welcome and appreciated. Start by opening an issue.

• Fork the project
• Create your feature branch git checkout -b my-new-feature
• Commit your changes git commit -am 'Add my feature'
• Push to the branch git push origin my-new-feature
• Create a new pull request against the master branch

gtag's Issues

add ability to define custom tag prefix

semver tags have the form 0.0.0 -- various conventions e.g. go modules require a v string in front the tag e.g. v0.0.0.

some projects have their own conventions for tag prefix/suffix.

In order to satisfy everybody, add the ability to define custom prefix/suffix for the semver tag.

Running against a new repo gives errror

Running 'gtag list' against a new repo with no existing tags displays an error message.

macOS 10.14.6
git version 2.20.1

`~/my-new-repo> gtag list
ERROR: usage: git cat-file (-t [--allow-unknown-type] | -s [--allow-unknown-type] | -e | -p | | --textconv | --filters) [--path=]
or: git cat-file (--batch | --batch-check) [--follow-symlinks] [--textconv | --filters]

can be one of: blob, tree, commit, tag
-t show object type
-s show object size
-e exit with zero when there's no error
-p pretty-print object's content
--textconv for blob objects, run textconv on object's content
--filters for blob objects, run filters on object's content
--path use a specific path for --textconv/--filters
--allow-unknown-type allow -s and -t to work with broken/corrupt objects
--buffer buffer --batch output
--batch[=] show info and content of objects fed from the standard input
--batch-check[=]
show info about objects fed from the standard input
--follow-symlinks follow in-tree symlinks (used with --batch or --batch-check)
--batch-all-objects show all objects with --batch or --batch-check
--unordered do not order --batch-all-objects output

: exit status 129`