https://github.com/hkionline/verso.cli
Simple semantic version extractor CLI
https://github.com/hkionline/verso.cli
changelog cli semver
Last synced: 6 months ago
JSON representation
Simple semantic version extractor CLI
- Host: GitHub
- URL: https://github.com/hkionline/verso.cli
- Owner: HKiOnline
- License: mit
- Created: 2025-04-08T16:01:04.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-08-17T09:15:54.000Z (11 months ago)
- Last Synced: 2025-08-17T09:24:41.837Z (11 months ago)
- Topics: changelog, cli, semver
- Language: Go
- Homepage:
- Size: 537 KB
- Stars: 4
- Watchers: 3
- Forks: 1
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# verso.cli
Simple [CHANGELOG](https://keepachangelog.com) [semver](https://semver.org/) extractor CLI. If you'd like to use verso as a Go library module, have a look at the [hkionline/verso](https://github.com/hkionline/verso) -project.
## Installation
At the moment you need to have Go lang installed. Please make sure you have your GOPATH environmental variable set and exported as well. If you have these requirements fullfilled you can install Verso CLI with the following command:
```bash
go install github.com/hkionline/verso.cli/cmd/verso@latest
```
After Installation you should now have the verso command available from your favorite terminal emulator.
## Usage
Verso CLI expects to find a CHANGELOG-file from the working directory you are in. Alternatively you can pipe a CHANGELOG-file from a path.
### Latest version
Get the latest version in the CHANGELOG.
```bash
> verso latest
0.3.0
```
### List all version
Get list of versions found from the CHANGELOG. Each version will be in its own line.
```bash
> verso list
0.3.0
0.2.5
0.2.4
0.2.3
0.2.2
0.2.1
0.2.0
0.1.0
```
### Bump version
Bump (increment) the latest found version. Assume the latest version is 0.3.0.
```bash
> verso bump major
1.0.0
> verso bump minor
0.4.0
> verso bump patch
0.3.1
```
### Piping a changelog to verso
Pipe a CHANGELOG-file from a path using e.g. cat
```bash
> cat CHANGELOG.md | verso latest
0.3.0
```
### Bonus: Changelog ready version header
Use verso and sed to produce CHANGELOG.md ready version header. Assume the latest version is 0.3.0.
```bash
> verso bump minor | sed "s/\(.*\)/\## [\1] $(date +%Y-%m-%d)/"
## [0.4.0] 2025-05-21
```