https://github.com/falcosuessgott/tago

interactively bumping SemVer git tags
https://github.com/falcosuessgott/tago

git semver tags versioning

Last synced: 3 months ago
JSON representation

interactively bumping SemVer git tags

• Host: GitHub
• URL: https://github.com/falcosuessgott/tago
• Owner: FalcoSuessgott
• License: mit
• Created: 2020-08-28T08:05:27.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2020-11-21T17:53:46.000Z (about 4 years ago)
• Last Synced: 2024-06-20T17:44:32.972Z (7 months ago)
• Topics: git, semver, tags, versioning
• Language: Go
• Homepage:
• Size: 2.85 MB
• Stars: 10
• Watchers: 2
• Forks: 2
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# tago [![Go Report Card](https://goreportcard.com/badge/github.com/FalcoSuessgott/tago)](https://goreportcard.com/badge/github.com/FalcoSuessgott/tago) 



  



`tago` lets you bump git tags using [semantic versioning](https://semver.org/).

# Features

* detecting and handling semver tags with or without "v"-prefix

* check if there are uncommited changes 

* creating initial tag if no tags exists

* add lightweight or annotated [tags](https://git-scm.com/book/en/v2/Git-Basics-Tagging)

* interactive user prompting

* automatable using cli params for scripting purposes

* automatically push after tag creation

# when to bump a version

`MAJOR.MINOR.PATCH`

* Major: when you make incompatible API changes,

* Minor: when you add functionality in a backwards compatible manner, and

* Patch: when you make backwards compatible bug fixes.

> [https://semver.org/](https://semver.org/)

# Installation

## using go 

```

go get github.com/FalcoSuessgott/tago

```

## using curl

```

 curl -sf https://gobinaries.com/FalcoSuessgott/tago | sh

```

# Usage

```

bumping semantic versioning git tags

Usage:

  tago [flags]

Flags:

  -h, --help            help for tago

  -x, --major           bump major version part

  -y, --minor           bump minor version part

  -m, --msg string      tag annotation message

  -z, --patch           bump patch version part

      --prefix          use "v" as prefix

  -p, --push            push tag afterwards

  -r, --remote string   remote (default "origin")

```

# Examples

## bump minor version

```

tago --minor -m "added update option"

```

## bump patch version and push created tag afterwards

```

tago -pz -m "fixed authentication bug"

```