dunamai - Generate dynamic versions
Contents
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 dunamaifrom<VCS> to generate a version string from a particular VCS or use any to autodetect.
Use dunamaicheck<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
December 2024 DUNAMAI(1)
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]
