Skip to main content

tests release quality-gate-status security-rating vulnerabilities codecov ruff ty crates.io pypi status license downloads python

zerv logo

zerv

Dynamic versioning from git. Every commit gets its version. Keep semantic-release on main. Let zerv prerelease every other branch.

Documentation: zerv.wisl.dev

zerv flow on tagged main, develop, a feature branch, and a dirty working directory

Why zerv?

  • Runs next to semantic-release - semantic-release decides releases on main; zerv versions every other build: any commit on any branch, even with uncommitted changes. No build is ever unversioned.
  • Two modes - zerv flow automates pre-release management from Git branch patterns; zerv version gives full manual control with schemas, overrides, and templates.
  • Any output format - SemVer, PEP440, CalVer, or Tera templates. Generate every format your pipelines need from a single ZERV RON payload.

See how zerv compares to semantic-release, setuptools-scm, dunamai, and git describe in Why zerv.

Installation

# Python (uv) - Recommended
uv tool install zerv-version

# Python (pip)
pip install zerv-version

# Rust (cargo)
cargo install zerv

# Installation script (latest, or `bash -s vX.X.X` for a specific version)
curl -sSL https://raw.githubusercontent.com/wislertt/zerv/main/scripts/install.sh | bash

# Pre-built binaries
# https://github.com/wislertt/zerv/releases

The PyPI wheel also exposes a Python binding: import zerv.

Quick Start

Version any Git state: zerv flow generates meaningful SemVer versions from any Git state, no manual configuration required.

# The current branch determines the output
zerv flow
# → 1.0.0 (on main branch with tag v1.0.0)
# → 1.0.1-rc.1.post.3 (on release branch with pre-release tag)
# → 1.0.1-beta.1.post.3+develop.3.gf297dd0 (on develop branch)
# → 1.0.1-alpha.59394.post.1+feature.new.auth.1.g4e9af24 (on feature branch)
# → 1.0.1-alpha.17015.post.1.dev.1764382150+feature.dirty.work.1.g54c499a (on dirty feature branch)

Fan one ZERV RON payload out to every format your pipelines need in the quickstart.

Documentation

Full documentation lives at zerv.wisl.dev:

  • Why zerv - positioning vs semantic-release, setuptools-scm, dunamai, git describe
  • Quickstart - one ZERV RON payload to every format
  • Concepts - flow, version, schema system, formats and templates, config file
  • CI/CD - GitHub Actions usage, coexisting with semantic-release
  • CLI reference - zerv version, zerv flow, zerv check, zerv render
  • Python binding - import zerv from the PyPI wheel
  • Troubleshooting

Development

git clone https://github.com/wislertt/zerv.git
cd zerv

uv tool install bakefile

bake setup-dev        # Install pre-commit hooks and cargo-tarpaulin

bake test             # Full test suite (Docker Git + Docker tests enabled)
bake test-rust        # Rust tests only
bake test-python      # Python binding tests only
bake lint             # Formatting and clippy checks
bake docs             # Local Mintlify docs dev server

The project uses uv and mise for dependency and tool management.

Contributing

Contributions are welcome. See CLAUDE.md for development guidelines, including project structure, testing conventions, and the development workflow.

Author

Wisaroot Lertthaweedech – wisl.dev

License

Licensed under the Apache License 2.0. See LICENSE for the full text.

The wordmark in docs/img/brand/ uses outlined paths from Sora, licensed under the SIL Open Font License 1.1.

Metadata

Release files for zerv-version 0.8.42

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for zerv-version 0.8.42
File Size Uploaded Provenance Actions
zerv_version-0.8.42.tar.gz 1.3 MB Without provenance Details for zerv_version-0.8.42.tar.gz

Built distributions (wheels)

Table of built distributions (wheels) for zerv-version 0.8.42
File Actions
zerv_version-0.8.42-py3-none-win_arm64.whl Python 3 none Windows ARM64 Details for zerv_version-0.8.42-py3-none-win_arm64.whl
zerv_version-0.8.42-py3-none-win_amd64.whl Python 3 none Windows x86-64 Details for zerv_version-0.8.42-py3-none-win_amd64.whl
zerv_version-0.8.42-py3-none-musllinux_1_2_x86_64.whl Python 3 none Linux musl 1.2+ x86-64 Details for zerv_version-0.8.42-py3-none-musllinux_1_2_x86_64.whl
zerv_version-0.8.42-py3-none-musllinux_1_2_aarch64.whl Python 3 none Linux musl 1.2+ ARM64 Details for zerv_version-0.8.42-py3-none-musllinux_1_2_aarch64.whl
zerv_version-0.8.42-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl Python 3 none Linux glibc 2.17+ x86-64 Details for zerv_version-0.8.42-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
zerv_version-0.8.42-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl Python 3 none Linux glibc 2.17+ ARM64 Details for zerv_version-0.8.42-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
zerv_version-0.8.42-py3-none-macosx_11_0_arm64.whl Python 3 none macOS 11.0+ ARM64 Details for zerv_version-0.8.42-py3-none-macosx_11_0_arm64.whl
zerv_version-0.8.42-py3-none-macosx_10_12_x86_64.whl Python 3 none macOS 10.12+ x86-64 Details for zerv_version-0.8.42-py3-none-macosx_10_12_x86_64.whl

Total release size: 18.9 MB

Release files / zerv_version-0.8.42.tar.gz

Download URL zerv_version-0.8.42.tar.gz
Size 1.3 MB
Tags Source
SHA-256 checksum
How to use checksums
be57ab36cd005b8a00d4c9509f0773c1ae40724244406258764138a0fc40364e
BLAKE2b-256 checksum
How to use checksums
2643c2b2930d24414e937542b4e9a2f9883f31eec483d3e2965a3c76e878e077
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.8 {"installer":{"name":"uv","version":"0.13.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / zerv_version-0.8.42-py3-none-win_arm64.whl

Download URL zerv_version-0.8.42-py3-none-win_arm64.whl
Size 2.1 MB
Tags Python 3 Windows ARM64
SHA-256 checksum
How to use checksums
384dd893b333dd914eebfee95e32d3c5ded31af5edac308ce1c83f7c994077a9
BLAKE2b-256 checksum
How to use checksums
016f35210ec152e8d884327200c9b12a61bae0ca637a205a605a3ef64d4170ea
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.8 {"installer":{"name":"uv","version":"0.13.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / zerv_version-0.8.42-py3-none-win_amd64.whl

Download URL zerv_version-0.8.42-py3-none-win_amd64.whl
Size 2.2 MB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
e9d1d4b451136305d9c4a356c3952c0d963026b5d59dea81425a12c308fbf6d1
BLAKE2b-256 checksum
How to use checksums
96f7f81997270b3a9442b082e408d5584601e0dd32be172fe4eb732c079553da
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.8 {"installer":{"name":"uv","version":"0.13.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / zerv_version-0.8.42-py3-none-musllinux_1_2_x86_64.whl

Download URL zerv_version-0.8.42-py3-none-musllinux_1_2_x86_64.whl
Size 2.3 MB
Tags Linux musl 1.2+ x86-64 Python 3
SHA-256 checksum
How to use checksums
9fc797c971a7229af98028d050cffa736cd4c2da12c3e152cc9012c4f33a0e93
BLAKE2b-256 checksum
How to use checksums
99ddf15a988c6b226d84f4fe21ac9cef94550c499eb6d915b57480cacfbf89d6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.8 {"installer":{"name":"uv","version":"0.13.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / zerv_version-0.8.42-py3-none-musllinux_1_2_aarch64.whl

Download URL zerv_version-0.8.42-py3-none-musllinux_1_2_aarch64.whl
Size 2.2 MB
Tags Linux musl 1.2+ ARM64 Python 3
SHA-256 checksum
How to use checksums
e30cedbdea8599b0a522da6cca8c77e422243f3ab62dd13c046440ec22832f40
BLAKE2b-256 checksum
How to use checksums
476978f7b496483d554036814d82887b43865ec27e34d610c34b1675b767ab1f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.8 {"installer":{"name":"uv","version":"0.13.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / zerv_version-0.8.42-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl

Download URL zerv_version-0.8.42-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl
Size 2.3 MB
Tags Linux glibc 2.17+ x86-64 Python 3
SHA-256 checksum
How to use checksums
bb331bb72c6ffd449921c29a4e4a78032c0573aace0caaef2b87a6ea21e83aa0
BLAKE2b-256 checksum
How to use checksums
c6b97e30028015ca9368fbc498e41d80c7f096aa28e366a0295becc9ce0ea90b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.8 {"installer":{"name":"uv","version":"0.13.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / zerv_version-0.8.42-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl

Download URL zerv_version-0.8.42-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl
Size 2.2 MB
Tags Linux glibc 2.17+ ARM64 Python 3
SHA-256 checksum
How to use checksums
e13d2fcafa90eb30e3843854a596c9fa45cc0038f36e4e82700e0c3b948bb4e7
BLAKE2b-256 checksum
How to use checksums
a3135e5d5d09991dd1dd318ef262b85b355d2cd28d1c53277c9d2b27062cc2d0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.8 {"installer":{"name":"uv","version":"0.13.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / zerv_version-0.8.42-py3-none-macosx_11_0_arm64.whl

Download URL zerv_version-0.8.42-py3-none-macosx_11_0_arm64.whl
Size 2.1 MB
Tags Python 3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
6aab45de25c2df87b55b383e3ffe5b073a225db0b4d3d31a8ee001201522c6d5
BLAKE2b-256 checksum
How to use checksums
07b66721678e7404acc266f6dfcc06a83546dec57634fd7575cdbdc4e4cd78a7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.8 {"installer":{"name":"uv","version":"0.13.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / zerv_version-0.8.42-py3-none-macosx_10_12_x86_64.whl

Download URL zerv_version-0.8.42-py3-none-macosx_10_12_x86_64.whl
Size 2.2 MB
Tags Python 3 macOS 10.12+ x86-64
SHA-256 checksum
How to use checksums
1b13856300c99c09af744947eff6a2a80cd8f9cbf07dbac80e38cfb776700308
BLAKE2b-256 checksum
How to use checksums
c23c7c56a51b65580022ab322e4922a930d3ab2063f0a24f07ae4fb582163b4a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.8 {"installer":{"name":"uv","version":"0.13.8","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for zerv-version 0.8.42

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.8.42 This release

9 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page