Switch to dynamic versioning from Git tags

- Use hatch-vcs for automatic version detection from Git tags
- Remove hardcoded version from pyproject.toml
- Add __version__ export to jqueue module
- Update release workflow to fetch full git history for versioning
- Add _version.py to .gitignore (auto-generated file)

This fixes the PyPI 'file already exists' error by ensuring each
release gets a unique version from its Git tag.

Author: janbjorge

.github/workflows/release.yml

@@ -60,6 +60,8 @@ jobs:
       id-token: write  # required for OIDC trusted publishing
     steps:
       - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0  # Required for hatch-vcs to access git history
 
       - name: Install uv
         uses: astral-sh/setup-uv@v5

.gitignore

@@ -15,6 +15,7 @@ dist/
 build/
 *.egg-info/
 *.egg
+jqueue/_version.py
 
 # uv
 .uv/

jqueue/__init__.py

@@ -73,7 +73,14 @@ async def write(content, if_match=None) -> str
 from jqueue.domain.models import Job, JobStatus, QueueState
 from jqueue.ports.storage import ObjectStoragePort
 
+try:
+    from jqueue._version import __version__
+except ImportError:
+    __version__ = "0.0.0+unknown"
+
 __all__ = [
+    # Version
+    "__version__",
     # Domain models
     "Job",
     "JobStatus",

pyproject.toml

@@ -1,10 +1,10 @@
 [build-system]
-requires = ["hatchling"]
+requires = ["hatchling", "hatch-vcs"]
 build-backend = "hatchling.build"
 
 [project]
 name = "jqueue"
-version = "0.1.0"
+dynamic = ["version"]
 description = "Storage-agnostic job queue using object storage with compare-and-set semantics"
 readme = "README.md"
 license = { text = "MIT" }
@@ -57,6 +57,16 @@ python_version = "3.12"
 module = ["aioboto3", "aioboto3.*", "google.cloud.storage", "google.cloud.*", "google.api_core", "google.api_core.*"]
 ignore_missing_imports = true
 
+[[tool.mypy.overrides]]
+module = ["jqueue._version"]
+ignore_missing_imports = true
+
 [[tool.mypy.overrides]]
 module = ["tests.*"]
 disallow_untyped_defs = false
+
+[tool.hatch.version]
+source = "vcs"
+
+[tool.hatch.build.hooks.vcs]
+version-file = "jqueue/_version.py"