zerv render - zerv

zerv render [OPTIONS] <VERSION>

Parse an existing version string and render it. Useful for converting between formats, normalizing, and reshaping versions produced by other tools.

Format conversion

# Convert SemVer to PEP440
zerv render "1.2.3-alpha.1" --output-format pep440
# 1.2.3a1

# Convert PEP440 to SemVer
zerv render "1.2.3b2" --input-format pep440 --output-format semver
# 1.2.3-beta.2

# Auto-detect input format
zerv render "1.2.3a1" --output-format semver
# 1.2.3-alpha.1

Templates

Render through a Tera template for custom output:

# Custom format
zerv render "1.2.3" --output-template "v{{major}}.{{minor}}"
# v1.2

# With pre-release
zerv render "2.0.0-beta.2" --output-template "{{major}}.{{minor}}.{{patch}}-{{pre_release.label}}"
# 2.0.0-beta

Prefixes

zerv render "1.2.3" --output-prefix "v"
# v1.2.3

Options

Option	Description
`-f, --input-format <FORMAT>`	`auto` (default), `semver`, `pep440`, or `zerv`
`--output-format <FORMAT>`	Output format: `semver`, `pep440`, or `zerv`
`--output-template <TEMPLATE>`	Tera template; conflicts with `--output-prefix`
`--output-prefix <PREFIX>`	Prefix prepended to the rendered version

Where to go next

Formats and templates - the template language reference
zerv check - validate instead of convert

⌘I