NAME¶

dunamai - Generate dynamic versions

SYNOPSIS¶

dunamai [-h] {from,check} ...

dunamai from [-h] {any,git,mercurial,darcs,...} ...

dunamai check [-h] [--style {pep440,semver,pvp}] [version]

DESCRIPTION¶

Dunamai is a Python library and command line tool for producing dynamic, standards-compliant version strings, derived from tags in your version control system. This facilitates uniquely identifying nightly or per-commit builds in continuous integration and releasing new versions of your software simply by creating a tag.

Use dunamai from <VCS> to generate a version string from a particular VCS or use any to autodetect.

Use dunamai check <version> check if a version is valid for a style.

EXAMPLES¶

Get supported VCS:

$ dunamai from -h

Get full help for from command:

$ dunamai from any -h

Get version from any VCS:

$ dunamai from any

Get version from git, fail when there are no tags:

$ dunamai from git --strict

Get help for check command including supported styles:

$ dunamai check -h

Check if a version is valid according to PEP 440:

$ dunamai check 1.2.3

Check if a version is valid according to Semantic Versioning (SemVer):

$ dunamai check --style semver 1.2.3

Check if a version is valid according to Haskell Package Version Policy (PVP) using a pipe:

$ echo 1.2.3 | dunamai check --style pvp