nsv
Installation
Entrypoint
Types
Nsv
- next()
- tag()

nsv

NSV (Next Semantic Version) is a convention-based semantic versioning tool that leans on the
power of conventional commits to make versioning your software a breeze!

There are many semantic versioning tools already out there! But they typically require some
configuration or custom scripting in your CI system to make them work. No one likes managing config;
it is error-prone, and the slightest tweak ultimately triggers a cascade of change across your projects.

Step in NSV. Designed to make intelligent semantic versioning decisions about your project without needing a
config file. Entirely convention-based, you can adapt your workflow from within your commit message.

The power is at your fingertips.

Installation

dagger install github.com/purpleclay/daggerverse/nsv@v0.6.0

Entrypoint

Return Type

Nsv !

Arguments

Name	Type	Description
base	Container	a custom base image containing an installation of nsv
src	Directory !	a path to a directory containing the projects source code
noLog	Boolean	silence all logging within nsv
logLevel	Enum !	the level of logging when printing to stderr

Example

dagger -m github.com/purpleclay/daggerverse/nsv@a528aadbb65dbc2afe1afae55bc0b9d3f4f78b32 call \
 --src DIR_PATH

func (m *myModule) example(src *Directory, logLevel ) *Nsv  {
	return dag.
			Nsv(src, logLevel)
}

@function
def example(src: dagger.Directory, log_level: ) -> dag.Nsv:
	return (
		dag.nsv(src, log_level)
	)

@func()
example(src: Directory, logLevel: ): Nsv {
	return dag
		.nsv(src, logLevel)
}

Types

Nsv 🔗

NSV dagger module

next() 🔗

Prints the next semantic version based on the commit history of your repository

Return Type

String !

Arguments

Name	Type	Default Value	Description
format	String	-	provide a go template for changing the default version format
majorPrefixes	[String ! ]	-	a comma separated list of conventional commit prefixes for triggering a major semantic version increment
minorPrefixes	[String ! ]	-	a comma separated list of conventional commit prefixes for triggering a minor semantic version increment
patchPrefixes	[String ! ]	-	a comma separated list of conventional commit prefixes for triggering a patch semantic version increment
paths	[String ! ]	-	a list of relative paths of projects to analyze
pretty	String	"full"	pretty-print the output of the next semantic version in a given format. Supported formats are (full, compact). Must be used in conjunction with the show flag
show	Boolean	-	show how the next semantic version was calculated

Example

dagger -m github.com/purpleclay/daggerverse/nsv@a528aadbb65dbc2afe1afae55bc0b9d3f4f78b32 call \
 --src DIR_PATH next

func (m *myModule) example(ctx context.Context, src *Directory, logLevel ) string  {
	return dag.
			Nsv(src, logLevel).
			Next(ctx)
}

@function
async def example(src: dagger.Directory, log_level: ) -> str:
	return await (
		dag.nsv(src, log_level)
		.next()
	)

@func()
async example(src: Directory, logLevel: ): Promise<string> {
	return dag
		.nsv(src, logLevel)
		.next()
}

tag() 🔗

Tags the next semantic version based on the commit history of your repository. Includes experimental support for patching files through a custom hook

Return Type

String !

Arguments

Name	Type	Default Value	Description
format	String	-	provide a go template for changing the default version format
gpgPassphrase	Secret	-	an optional passphrase to unlock the GPG private key used for signing the tag
gpgPrivateKey	Secret	-	a base64 encoded GPG private key (armored) used for signing the tag
hook	String	-	a user-defined hook that will be executed before the repository is tagged with the next semantic version. Can be inline shell or a path to a script
majorPrefixes	[String ! ]	-	a comma separated list of conventional commit prefixes for triggering a major semantic version increment
message	String	-	a custom message for the tag, supports go text templates
minorPrefixes	[String ! ]	-	a comma separated list of conventional commit prefixes for triggering a minor semantic version increment
patchPrefixes	[String ! ]	-	a comma separated list of conventional commit prefixes for triggering a patch semantic version increment
paths	[String ! ]	-	a list of relative paths of projects to analyze
pretty	String	"full"	pretty-print the output of the next semantic version in a given format. Supported formats are (full, compact). Must be used in conjunction with the show flag
show	Boolean	-	show how the next semantic version was calculated

Example

dagger -m github.com/purpleclay/daggerverse/nsv@a528aadbb65dbc2afe1afae55bc0b9d3f4f78b32 call \
 --src DIR_PATH tag

func (m *myModule) example(ctx context.Context, src *Directory, logLevel ) string  {
	return dag.
			Nsv(src, logLevel).
			Tag(ctx)
}

@function
async def example(src: dagger.Directory, log_level: ) -> str:
	return await (
		dag.nsv(src, log_level)
		.tag()
	)

@func()
async example(src: Directory, logLevel: ): Promise<string> {
	return dag
		.nsv(src, logLevel)
		.tag()
}