vcs-versioning

the blessed package to manage your versions by vcs metadata

vcs-versioning Permissive license MIT Active ★ 951 v2.2.4 released 2026-08-07

Install

vcs-versioning on PyPI

pip

pip install vcs-versioning

uv

uv add vcs-versioning

poetry

poetry add vcs-versioning

Package facts

License	MIT (permissive)
Python support	supports the current Python release (>=3.8)
Install friction	low — pure-Python wheel
Runtime dependencies	3 — packaging, tomli, typing-extensions
Maintenance	actively maintained — 6 days since the last release
Last repo commit	2026-08-13
First released	2023-02-09
Popularity	one of the top 1,000 most-downloaded packages on PyPI (30-day window, as of 2026-08-13)
Known vulnerabilities	none known (OSV.dev, checked 2026-08-13)

Evidence: vcs_versioning-2.2.4-py3-none-any.whl

Development Status :: 4 - BetaProgramming Language :: PythonProgramming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.14Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9

About vcs-versioning

from the package's own PyPI description — quoted content, verbatim

vcs-versioning

PyPI - Version (image) PyPI - Python Version (image)

Table of Contents

Installation
License

Installation

pip install vcs-versioning

License

vcs-versioning is distributed under the terms of the MIT license.

Read as markdown · JSON record · Source repository · Docs

AI interpretation — verify before relying

AI-generated interpretation of the package facts above; every digit, version, license, or vulnerability id it cites is grounded in the facts already shown on this page

Automatically manages Python package versioning by extracting version information from version control system metadata, eliminating the need for manual version bumping in source code.

Low install friction with a pure-wheel distribution and only three lightweight runtime dependencies (packaging, tomli, typing-extensions). Active maintenance with a recent release 6 days ago and 951 repository stars.

Distributed under the MIT license, a permissive open-source license that allows free use, modification, and distribution with minimal restrictions.

Usage

pip install vcs-versioning

from vcs_versioning import get_version
version = get_version()

Requires Python 3.8 or later; version extraction depends on VCS metadata being present in the project directory.

Verdict: A well-maintained, actively developed package in the top 1000 PyPI tier with no known vulnerabilities, low install friction, and permissive licensing. Suitable for projects seeking automated version management tied to version control history.

Needs verification

Whether the package requires a specific VCS (git, hg, etc.) or supports multiple systems
How the package integrates with build systems beyond setuptools
Whether offline version extraction is supported or VCS access is mandatory

vcs version managementautomatic version from gitversion control metadatadynamic python versioninggit-based package versioningsetuptools version automation