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

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

Built distributions (wheels)

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

Total release size: 18.9 MB

Release files / zerv_version-0.8.41.tar.gz

Download URL zerv_version-0.8.41.tar.gz
Size 1.3 MB
Tags Source
SHA-256 checksum
How to use checksums
4ed0b9d20915beed4e0f628e8bb52570862eb364f592d453c8726ea5f5e320f5
BLAKE2b-256 checksum
How to use checksums
241957d6fb048368e34980090a3f2e7f676900fa9542daecf0a643977793d644
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.41-py3-none-win_arm64.whl

Download URL zerv_version-0.8.41-py3-none-win_arm64.whl
Size 2.1 MB
Tags Python 3 Windows ARM64
SHA-256 checksum
How to use checksums
cf486b504e4e4adfa0cae7ed113d02ed0adad435305b528bcb5db072612fad9c
BLAKE2b-256 checksum
How to use checksums
88905d41225ca30fa548e01a47f3e1edd7ecbbf39411756d1b48c900fc0d503b
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.41-py3-none-win_amd64.whl

Download URL zerv_version-0.8.41-py3-none-win_amd64.whl
Size 2.2 MB
Tags Python 3 Windows x86-64
SHA-256 checksum
How to use checksums
88503cea608212da8a1fedec44b04ab8218d567d8d8e8c58a3d88a5663055fb0
BLAKE2b-256 checksum
How to use checksums
664626b4a648b9522c404940986cf66824fd28bcc980ca4e31cd5c0fa661e4ba
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.41-py3-none-musllinux_1_2_x86_64.whl

Download URL zerv_version-0.8.41-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
816f695d8ebce2f0b2a78a49558772596c0a10d626d8abc560187a28f3e6672e
BLAKE2b-256 checksum
How to use checksums
675cfe9d8225beee51b3781dfddc021df9f366e95a6084f4d3e7efb46f0ea0ed
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.41-py3-none-musllinux_1_2_aarch64.whl

Download URL zerv_version-0.8.41-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
28316c6ef160f354b5acd3631fe2af25697c60781361af6ba5548759887e22c2
BLAKE2b-256 checksum
How to use checksums
532917f4b2cd31129ffae43b2fc9968cf92d1906b802f2c4d3c4fa141e4ee2e3
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.41-py3-none-manylinux2014_x86_64.manylinux_2_17_x86_64.whl

Download URL zerv_version-0.8.41-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
c2df1a6291a5688108379641c38f296460c7ac67264bc285a51e9deca90c5bf5
BLAKE2b-256 checksum
How to use checksums
4de9bb7b20f781b5bc681f5b9ea40d08d1d9be21dcb7fdf9a81366536b35d9ab
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.41-py3-none-manylinux2014_aarch64.manylinux_2_17_aarch64.whl

Download URL zerv_version-0.8.41-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
edcfd461492954160d56e61328c0b02a8579eea14063e1343839c6f4591d3981
BLAKE2b-256 checksum
How to use checksums
cd0f2ee896a88402001de2de8aa3b44f266f0c25297c974a926b9aae314b7aa6
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.41-py3-none-macosx_11_0_arm64.whl

Download URL zerv_version-0.8.41-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
91fe433895800c4a4d1b68b179885893668df6e98822baeea76affe5281bebd1
BLAKE2b-256 checksum
How to use checksums
2608aa1ae5f5a69435c152366c70b3693ceb0a24e5d8046fef6090992db3506a
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.41-py3-none-macosx_10_12_x86_64.whl

Download URL zerv_version-0.8.41-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
72973fc65cbd26fed4c7a203e31541a385949d4a1ef6e646a2640d284fdc0898
BLAKE2b-256 checksum
How to use checksums
b80574b6e27a6d35a33ec17943a446ea609cc04024c0770b49185940f1c9c2d1
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.41

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