{"categories":[{"label":"Build Tools","url":"https://skillfed.io/packages/category/software-development-build-tools"},{"label":"Version Control","url":"https://skillfed.io/packages/category/software-development-version-control"},{"label":"Git","url":"https://skillfed.io/packages/category/software-development-version-control-git"}],"enrichment":{"capability":"Automatically determines your Python package's version from Git or Mercurial tags and writes it to your build system, with customizable version formatting and optional runtime file generation.","skillfed_tags":["build-automation","version-management","vcs-integration"],"use_cases":["Eliminate manual version bumping in setup.py or pyproject.toml by deriving version automatically from Git tags during build.","Customize version format via template strings without code changes to match your project's versioning scheme.","Write computed version to a file or inject it into source code at build time for runtime access without re-querying VCS.","Use custom version calculation logic by defining or registering entry-point functions for tag parsing, version bumping, and formatting.","Support non-Python projects via versioningit.toml or projects using setuptools, Hatch, or library-mode setup.py integration."],"what_it_does":"versioningit is a build-system plugin that derives your package version from version control tags instead of requiring you to maintain an explicit version string in setup.py, setup.cfg, or pyproject.toml. It works as a setuptools or Hatch plugin, configured via pyproject.toml or versioningit.toml, and supports Git, Git archives, and Mercurial repositories. The plugin queries your VCS for the latest tag, calculates the version based on distance from that tag and repository state (clean, dirty, or both), and formats the result using customizable template strings.\n\nThe package's main strength is its flexibility: you can define separate format templates for different repository states (e.g., \"1.2.3.post42+ge174a1f\" when ahead of a tag, \"1.2.3+d20230922\" when uncommitted changes exist), and you can override the individual functions that extract tags, calculate versions, bump versions, and write output. It can optionally write the computed version to a file for runtime inspection or inject it into source code at build time. All three runtime dependencies are standard and lightweight.","worth_installing":"Yes. versioningit is actively maintained, has no known vulnerabilities, installs with low friction, and solves a real problem for projects that want version-from-VCS automation without manual version strings. It is particularly valuable if you need flexible version formatting or custom version logic. The MIT license imposes no restrictions. Install it in your build-system.requires if you use setuptools or Hatch and have Git tags."},"id":"versioningit","links":{"html":"https://skillfed.io/packages/versioningit","md":"https://skillfed.io/packages/versioningit.md","pypi":"https://pypi.org/project/versioningit/"},"maintenance":{"status":"active"},"meta":{"latest_release":"2025-06-27","license_spdx":"MIT","license_treatment":"permissive","name":"versioningit","python_support":"supports_current","summary":"Versioning It with your Version In Git"},"popularity":{"monthly_downloads":2173943,"position":3231,"tier":"top_5000"},"security":{"n_vulnerabilities":0},"version":"3.3.0"}