sv4git

Semantic version for git

Getting Started

download the latest release and add the binary on your path

you can config using the environment variables

Variable	description	default
MAJOR_VERSION_TYPES	types used to bump major version
MINOR_VERSION_TYPES	types used to bump minor version	feat
PATCH_VERSION_TYPES	types used to bump patch version	build,ci,docs,fix,perf,refactor,style,test
INCLUDE_UNKNOWN_TYPE_AS_PATCH	force patch bump on unknown type	true
BRAKING_CHANGE_PREFIXES	list of prefixes that will be used to identify a breaking change	BREAKING CHANGE:,BREAKING CHANGES:
ISSUEID_PREFIXES	list of prefixes that will be used to identify an issue id	jira:,JIRA:,Jira:
TAG_PATTERN	tag version pattern	%d.%d.%d
RELEASE_NOTES_TAGS	release notes headers for each visible type	fix:Bug Fixes,feat:Features

run git-sv to get the list of available parameters

git-sv

if git-sv is configured on your path, you can use it like a git command

git sv
git sv current-version
git sv next-version

use --help or -h to get usage information, dont forget that some commands have unique options too

# sv help
git-sv -h

# sv release-notes command help
git-sv rn -h

Variable	description
current-version, cv	get last released version from git
next-version, nv	generate the next version based on git commit messages
commit-log, cl	list all commit logs since last version as jsons
release-notes, rn	generate release notes
tag, tg	generate tag with version based on git commit messages
help, h	Shows a list of commands or help for one command

run make to get the list of available actions

make

Parameters	description
args	parameters that will be used on run

#variables
BUILDOS="linux" BUILDARCH="amd64" make build

#parameters
make run args="-h"

make build

the binary will be created on bin/$BUILDOS_$BUILDARCH/git-sv

make test

#without args
make run

#with args
make run args="-h"