USAGE:
autotag LEVEL [-p] [-u] [-h]
HELP:
Increment git tag using given increment level.
Positional arguments:
LEVEL : 'M' for major, 'm' for minor or 'b' for bug.
Flags:
-h --help : Show help and exit.
-p --preview : Do a dry run to show the new tag label only, without creating it.
This must be used as the 2nd arg i.e. after the LEVEL.
-u --upgrade : Download latest script from GitHub, write over current script to
install it, then exit. Uses cURL and not Git. If using this flag,
not other options are needed or used.
As with tagging the normal way, it is recommended to be on the master branch before creating a tag. Otherwise, the tag may not be meaningful in a sequence (especially if the feature branch is behind master).
As an added precaution, the tool will always fetch the latest tags on the GitHub remote before creating a tag. Even if just doing a preview.
This is done to avoid accidentally creating a local tag with a name that already exists on the remote and therefore causing conflict.
Increment major version, minor version, or bug version respectively as follows:
$ autotag M
$ autotag m
$ autotag b
Output will be like this:
$ ./autotag b
🚛 Fetching tags...
🔍 Finding most recent tag...
👴 Last tag: v1.1.0
⭐ New tag: v1.1.1
Use the preview flag:
$ autotag m -p
Auto tagging...
Last tag: v0.1.1
New tag: v0.2.0
Skipping tag creation
If there are no tags yet, then v0.0.0 will be implied as the starting point for incrementing levels.
If you realize you don’t want that new tag anymore, delete it using git.
$ git tag -d TAG_NUMBER
If you are happy with the tag, you can push it. This will push all local tags.
$ git push --tags
The command above will not push the commits, so you should also do a standard push.
$ git push && git push --tags
See the Upgrade doc for more info.
$ ./autotag --upgrade