chore: switch to versioningit

I have been finding hatch-vcs (built on top of setuptools-scm) to be a
bit too finicky, so I am switching to versioningit.

Signed-off-by: JP-Ellis <josh@jpellis.me>

Author: JP-Ellis

docs/releases.md

@@ -17,10 +17,10 @@ There are a couple of exceptions to the [semantic versioning](https://semver.org
 
 Any deviation from the the standard semantic versioning rules will be clearly documented in the release notes.
 
-The version is stored in `pact/__version__.py`. This file is automatically generated by [`hatch-vcs`](https://pypi.org/project/hatch-vcs/) and generates a version based on the latest version tag and the number of commits since that tag. Specifically:
+The version is stored in `pact/__version__.py`. This file is automatically generated by [`versioningit`](https://versioningit.readthedocs.io/en/stable/) and generates a version based on the latest version tag and the number of commits since that tag. Specifically:
 
 -   If the latest tag is `v1.2.3` and there have been no commits since then and the repository is clean, the version will be `1.2.3`.
--   Otherwise, the version will take the form of `1.2.3.dev{N}+g{hash}` (or `1.2.3.dev{N}+g{hash}.d{date}` if there's a dirty repository) where `N` is the number of commits since the latest tag, `hash` is the short hash of the latest commit.
+-   Otherwise, the version will take the form of a post-release based on the last version.
 
 ## Build Pipeline
 

pact-python-cli/pyproject.toml

@@ -63,38 +63,19 @@ types = ["mypy==1.19.0"]
 ################################################################################
 [build-system]
 build-backend = "hatchling.build"
-requires      = ["hatch-vcs", "hatchling", "packaging"]
+requires      = ["hatchling", "packaging", "versioningit"]
 
 [tool.hatch]
 
   [tool.hatch.version]
-  source      = "vcs"
-  tag-pattern = '^pact-python-cli/(?P<version>\d+(?:\.\d+)*(?:(?:a|b|rc|\.post)\d+)?)$'
-
-    [tool.hatch.version.raw-options]
-    git_describe_command = [
-      "git",
-      "describe",
-      "--tags",
-      "--dirty",
-      "--always",
-      "--long",
-      "--match",
-      "pact-python-cli/*",
-    ]
-    root = ".."
-    version_scheme = "no-guess-dev"
+  source = "versioningit"
 
   [tool.hatch.build]
+  artifacts = ["src/pact_cli/__version__.py"]
+  packages  = ["src/pact_cli"]
 
-    [tool.hatch.build.hooks.vcs]
-    version-file = "src/pact_cli/__version__.py"
-
-    [tool.hatch.build.targets.wheel]
-    packages = ["src/pact_cli"]
-
-      [tool.hatch.build.targets.wheel.hooks.custom]
-      patch = "hatch_build.py"
+    [tool.hatch.build.targets.wheel.hooks.custom]
+    patch = "hatch_build.py"
 
   ########################################
   ## Hatch Environment Configuration
@@ -133,6 +114,26 @@ requires      = ["hatch-vcs", "hatchling", "packaging"]
       [[tool.hatch.envs.test.matrix]]
       python = ["3.10", "3.11", "3.12", "3.13", "3.14"]
 
+################################################################################
+## Versioningit Configuration
+################################################################################
+[tool.versioningit]
+  [tool.versioningit.vcs]
+  match  = ["pact-python-cli/*"]
+  method = "git"
+
+  [tool.versioningit.tag2version]
+  rmprefix = "pact-python-cli/"
+
+  [tool.versioningit.write]
+  file = "src/pact_cli/__version__.py"
+  template = '''\
+# This file is auto-generated by versioningit. Do not edit.
+__version__ = "{version}"
+__version_tuple__ = {version_tuple}
+__commit_id__ = "{revision}"
+'''
+
 ################################################################################
 ## PyTest Configuration
 ################################################################################

pact-python-ffi/pyproject.toml

@@ -50,38 +50,19 @@ types = ["mypy==1.19.0", "typing-extensions~=4.0"]
 ################################################################################
 [build-system]
 build-backend = "hatchling.build"
-requires      = ["hatch-vcs", "hatchling", "packaging", "cffi"]
+requires      = ["hatchling", "packaging", "cffi", "setuptools", "versioningit"]
 
 [tool.hatch]
 
   [tool.hatch.version]
-  source      = "vcs"
-  tag-pattern = '^pact-python-ffi/(?P<version>\d+(?:\.\d+)*(?:(?:a|b|rc|\.post)\d+)?)$'
-
-    [tool.hatch.version.raw-options]
-    git_describe_command = [
-      "git",
-      "describe",
-      "--tags",
-      "--dirty",
-      "--always",
-      "--long",
-      "--match",
-      "pact-python-ffi/*",
-    ]
-    root = ".."
-    version_scheme = "no-guess-dev"
+  source = "versioningit"
 
   [tool.hatch.build]
+  artifacts = ["src/pact_ffi/__version__.py"]
+  packages  = ["src/pact_ffi"]
 
-    [tool.hatch.build.hooks.vcs]
-    version-file = "src/pact_ffi/__version__.py"
-
-    [tool.hatch.build.targets.wheel]
-    packages = ["src/pact_ffi"]
-
-      [tool.hatch.build.targets.wheel.hooks.custom]
-      patch = "hatch_build.py"
+    [tool.hatch.build.targets.wheel.hooks.custom]
+    patch = "hatch_build.py"
 
   ########################################
   ## Hatch Environment Configuration
@@ -91,7 +72,7 @@ requires      = ["hatch-vcs", "hatchling", "packaging", "cffi"]
     # Install dev dependencies in the default environment to simplify the developer
     # workflow.
     [tool.hatch.envs.default]
-    extra-dependencies   = ["hatch-vcs", "hatchling", "packaging", "cffi"]
+    extra-dependencies   = ["hatchling", "packaging", "cffi"]
     installer            = "uv"
     path                 = ".venv"
     pre-install-commands = ["uv pip install --group dev -e ."]
@@ -127,6 +108,26 @@ requires      = ["hatch-vcs", "hatchling", "packaging", "cffi"]
       [[tool.hatch.envs.test.matrix]]
       python = ["3.10", "3.11", "3.12", "3.13", "3.14"]
 
+################################################################################
+## Versioningit Configuration
+################################################################################
+[tool.versioningit]
+  [tool.versioningit.vcs]
+  match  = ["pact-python-ffi/*"]
+  method = "git"
+
+  [tool.versioningit.tag2version]
+  rmprefix = "pact-python-ffi/"
+
+  [tool.versioningit.write]
+  file = "src/pact_ffi/__version__.py"
+  template = '''\
+# This file is auto-generated by versioningit. Do not edit.
+__version__ = "{version}"
+__version_tuple__ = {version_tuple}
+__commit_id__ = "{revision}"
+'''
+
 ################################################################################
 ## PyTest Configuration
 ################################################################################

pyproject.toml

@@ -150,40 +150,21 @@ test-v2 = [
   "uvicorn[standard]~=0.0",
 ]
 
-[build-system]
-build-backend = "hatchling.build"
-requires      = ["hatch-vcs", "hatchling"]
-
 ################################################################################
 ## Hatch Configuration
 ################################################################################
+[build-system]
+build-backend = "hatchling.build"
+requires      = ["hatchling", "versioningit"]
+
 [tool.hatch]
 
   [tool.hatch.version]
-  source      = "vcs"
-  tag-pattern = '^pact-python/(?P<version>\d+(?:\.\d+)*(?:(?:a|b|rc|\.post)\d+)?)$'
-
-    [tool.hatch.version.raw-options]
-    git_describe_command = [
-      "git",
-      "describe",
-      "--tags",
-      "--dirty",
-      "--always",
-      "--long",
-      "--match",
-      "pact-python/*",
-    ]
-    root = "."
-    version_scheme = "no-guess-dev"
+  source = "versioningit"
 
   [tool.hatch.build]
-
-    [tool.hatch.build.hooks.vcs]
-    version-file = "src/pact/__version__.py"
-
-    [tool.hatch.build.targets.wheel]
-    packages = ["/src/pact"]
+  artifacts = ["src/pact/__version__.py"]
+  packages  = ["src/pact"]
 
   ########################################
   ## Hatch Environment Configuration
@@ -193,7 +174,7 @@ requires      = ["hatch-vcs", "hatchling"]
     # Install dev dependencies in the default environment to simplify the developer
     # workflow.
     [tool.hatch.envs.default]
-    extra-dependencies = ["hatchling", "hatch-vcs"]
+    extra-dependencies = ["hatchling", "packaging"]
     installer          = "uv"
     path               = ".venv"
     # This is require to get around an incompatibility between hatch and uv
@@ -272,6 +253,26 @@ requires      = ["hatch-vcs", "hatchling"]
       [[tool.hatch.envs.v2-example.matrix]]
       python = ["3.10", "3.11", "3.12", "3.13", "3.14"]
 
+################################################################################
+## Versioningit Configuration
+################################################################################
+[tool.versioningit]
+  [tool.versioningit.vcs]
+  match  = ["pact-python/*"]
+  method = "git"
+
+  [tool.versioningit.tag2version]
+  rmprefix = "pact-python/"
+
+  [tool.versioningit.write]
+  file = "src/pact/__version__.py"
+  template = '''\
+# This file is auto-generated by versioningit. Do not edit.
+__version__ = "{version}"
+__version_tuple__ = {version_tuple}
+__commit_id__ = "{revision}"
+'''
+
 ################################################################################
 ## UV Workspace
 ################################################################################