feat: Implement dynamic versioning using hatch-vcs and update Dockerfile to support injected versions.

Author: Zalfsten

docker/Dockerfile.sql_to_arc

@@ -10,9 +10,13 @@ COPY middleware ./middleware
 # Upgrade pip and install uv
 RUN pip install --no-cache-dir --upgrade pip==25.3 uv==0.9.27
 
+# Declare build argument for versioning
+ARG APP_VERSION=0.0.0
+
 # We prefer to build a wheel for our package first. This ensures we have a clean,
 # distributable artifact that contains only the necessary files.
-RUN uv build --package sql_to_arc --wheel
+# We set SETUPTOOLS_SCM_PRETEND_VERSION so hatch-vcs can work without .git folder.
+RUN SETUPTOOLS_SCM_PRETEND_VERSION=${APP_VERSION#v} uv build --package sql_to_arc --wheel
 
 
 # ---- Binary Build Stage ----
@@ -51,7 +55,8 @@ RUN uv sync --no-dev
 # 4. Finally, for packages like sql_to_arc that exist both as a workspace dependency
 #    and as a pre-built wheel, we explicitly 'uv pip install' the wheel. This ensures
 #    we use our optimized, pre-built package instead of the 'editable' source install.
-RUN uv pip install /tmp/wheels/*.whl pyinstaller
+ARG APP_VERSION=0.0.0
+RUN SETUPTOOLS_SCM_PRETEND_VERSION=${APP_VERSION#v} uv pip install /tmp/wheels/*.whl pyinstaller
 
 # Build standalone binary using the .venv's context.
 RUN . .venv/bin/activate && \

middleware/sql_to_arc/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "sql_to_arc"
-version = "0.0.0" # currently we disregard the version of this subpackage
+dynamic = ["version"]
 description = "The FAIRagro advanced middleware SQL-to-ARC converter"
 readme = "README.md"
 requires-python = ">=3.12"
@@ -17,9 +17,13 @@ dependencies = [
 api_client = { git = "https://github.com/fairagro/m4.2_advanced_middleware_api.git", branch = "main", subdirectory = "middleware/api_client" }
 shared = { git = "https://github.com/fairagro/m4.2_advanced_middleware_api.git", branch = "main", subdirectory = "middleware/shared" }
 
+[tool.hatch.version]
+source = "vcs"
+raw-options = { root = "../.." }
+
 [tool.hatch.build.targets.wheel]
 packages = ["src/middleware"]
 
 [build-system]
-requires = ["hatchling"]
+requires = ["hatchling", "hatch-vcs"]
 build-backend = "hatchling.build"

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "m4-2-sql-to-arc"
-version = "0.1.0"
+dynamic = ["version"]
 description = "The FAIRagro SQL-to-ARC client"
 readme = "README.md"
 requires-python = ">=3.12"
@@ -246,3 +246,13 @@ disable = [
     "C0301",  # line-too-long (handled by ruff formatter)
     "R0801",  # duplicate-code (can be noisy in tests)
 ]
+
+[tool.hatch.version]
+source = "vcs"
+
+[tool.hatch.build.targets.wheel]
+include = ["README.md"]
+
+[build-system]
+requires = ["hatchling", "hatch-vcs"]
+build-backend = "hatchling.build"