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.40

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.40
File Size Uploaded Provenance Actions
zerv_version-0.8.40.tar.gz 1.3 MB Without provenance Details for zerv_version-0.8.40.tar.gz

Built distributions (wheels)

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

Total release size: 18.9 MB

Release files / zerv_version-0.8.40.tar.gz

Download URL zerv_version-0.8.40.tar.gz
Size 1.3 MB
Tags Source
SHA-256 checksum
How to use checksums
9a392b879ec80d4074b702a39221ad2ee350ee4a712a94a449cf8c0399b74e1d
BLAKE2b-256 checksum
How to use checksums
ace1439c85492bafbd00fc3b69d5db6f8b924d2b58c67b91078fa262dc9249b4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","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.40-py3-none-win_arm64.whl

Download URL zerv_version-0.8.40-py3-none-win_arm64.whl
Size 2.1 MB
Tags Python 3 Windows ARM64
SHA-256 checksum
How to use checksums
493b7bfe0fb080f871434b928ad5de4f8eb117b33a9da42a3cace8472ca91497
BLAKE2b-256 checksum
How to use checksums
48bfdbc3783fa0dfcc55fca1e94708bd397381b32ff9524907b7b4da060a658e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","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.40-py3-none-win_amd64.whl

Download URL zerv_version-0.8.40-py3-none-win_amd64.whl
Size 2.2 MB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
fd8929cc23c34a9b3983096255066cdfd47a103cabbb75e90233cd803419788c
BLAKE2b-256 checksum
How to use checksums
ddd062d9925aa7588cc21a37d57cc710ad7911b121bc254e833baca17e0516b5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","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.40-py3-none-musllinux_1_2_x86_64.whl

Download URL zerv_version-0.8.40-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
92f64eae5602c28f91ba457f1ce6b7e4265e15ab9f5bcf2c24f3943412ed49f3
BLAKE2b-256 checksum
How to use checksums
81a676e695238467f2d2fd655d1278d511bcb48bd356d9ac5705547cf3895068
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","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.40-py3-none-musllinux_1_2_aarch64.whl

Download URL zerv_version-0.8.40-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
432b3efd30a8accb983ee2a3e0c02fcae98fa7d1f8b62619c55b3ba63d86317b
BLAKE2b-256 checksum
How to use checksums
bedb60b690030ea3263150c8ec74073d52b3778ca355e875b4ee96cd4f562df8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","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.40-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl

Download URL zerv_version-0.8.40-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
7a541643620b1bc942e941d471b02e3f7d42505844941384261f64d0219abdc4
BLAKE2b-256 checksum
How to use checksums
640d57273bb456fff65e2a6b0f068528fadb697fb0684826e3ed8492fc6c27cc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","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.40-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl

Download URL zerv_version-0.8.40-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
df4ccda76d94298d75b1b29d39dfe99e5d7ac5472a5b1963dc843380c73786c0
BLAKE2b-256 checksum
How to use checksums
c534e28e7c6790b90970278154d8806998797a2b612bab56b4554f96285d9c19
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","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.40-py3-none-macosx_11_0_arm64.whl

Download URL zerv_version-0.8.40-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
ee23c18efc50f762da19d629212c964636b984e619d0496b4979e8d7781e67ee
BLAKE2b-256 checksum
How to use checksums
a94cee9a647af5ba9d073e36d2abdc8821f96c31d662b52ddcb857aa22627396
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","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.40-py3-none-macosx_10_12_x86_64.whl

Download URL zerv_version-0.8.40-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
b01718f903c18579845c467a9c0e00bda30b9a7b0a03f7abe6ffe77fec236560
BLAKE2b-256 checksum
How to use checksums
36734d356557b9a450ca9a581e2bc6e0a5a84e3e65cce3dd0a741484cf726d21
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.7 {"installer":{"name":"uv","version":"0.13.7","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.40

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.40 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