v3.1.0 (2026-05-15)

Features

• Added a dynamic-metadata provider compatible with scikit-build-core. (#130)

  Thanks to @ktbarrett.

• Add support for git archive builds via a tracked .git_archival.txt file. (#131)

  When the file is present and its $Format:...$ placeholders have been substituted, the version is derived from its contents instead of running git. See Supporting git archive builds.

  Thanks to @ktbarrett.

v3.0.1 (2026-01-16)

Bug Fixes

Fix OSErrorr exception raised if using setuptools-git-versioning in system without git installed (#126).
Thanks to @jeffawang.

v3.0.0 (2026-01-16)

Breaking

• Make most of args in version_from_git keyword-only.
• Change return type of version_from_git and infer_version from str to packaging.version.Version.
• Timestamps in version templates are now timezone-aware.

Refactoring

• Split setuptools_git_versioning.py into smaller set of files.
• Do not use Popen(shell=True) anymore.
• Switch from setup.py to pyproject.toml.
• Switch from pip to uv, use lock files.
• Switch from black + isort + pyupgrade to ruff format.
• Switch from flake8 to ruff.
• Switch from pre-commit to prek.

Bug Fixes

• Fix calling get_version(root=...) in combination with version-file strategy -
  relative file version was resolved against os.cwd, not explicitly passed root.
• Fix epoch versions like 0!2025.12.3 were wrongly converted to 0.2025.12.3 (#122).
• Using version_file-based schema with shallow git clone lead to version numbers like 1.2.3.postNone, now it is 1.2.3.post0 (#104).

v2.1.0

general

• [feature] Test Python 3.13 compatibility

dependency

• [bugfix] Replace outdated toml package with modern tomli. Thanks to @graingert

  References: #108

v2.0.0

core

• [breaking] Drop get_branch_tags function which was deprecated since 1.8.0.

• [breaking] version_file option now have precedence over any tags in the current branch.

  References: #94, #97

config

• [breaking] Drop version_config keyword from setup.py, which was deprecated since 1.8.0.

• [breaking] Does not allow passing setuptools_git_versioning=False and setuptools_git_versioning=True to config.
  Always use setuptools_git_versioning={"enabled": True}.

v1.13.6

general

• [feature] Test Python 3.12 compatibility

• [feature] Remove useless warning if tag_filter, tag_formatter or branch_formatter is a regexp instead of function reference.

  References: #93

v1.13.5

dependency

• [bugfix] Import setuptools before importing distutils. Thanks to @tjni

  References: #84

v1.13.4

general

• [feature] Test PyPy 3.10 support

docs

• [feature] Update documentation to mention shallow clone issues.

  References: #83

ci

• [feature] Push release using Trusted publishers feature of PyPI.org

v1.13.3

docs

• [bugfix] Move zip-safe option to tool.setuptools section of pyproject.toml.

  Thanks to @cclecle

  References: #78

v1.13.2

docs

• [feature] Recommend users to use file-based schema instead of tag-based due some cases.

  References: #77, #75

• [feature] Add small example of .gitignore file to common issues section. Thanks to @aram-eskandari

  References: #17

• [feature] Improve examples of fetching package version in runtime.

  References: #55