build: add setuptools_scm for git version tracking

Author: jaimeferj

.gitignore

@@ -44,3 +44,6 @@ htmlcov
 pyiceberg/avro/decoder_fast.c
 pyiceberg/avro/*.html
 pyiceberg/avro/*.so
+
+# Generated version file
+pyiceberg/_version.py

build-module.py

@@ -22,6 +22,19 @@
 allowed_to_fail = os.environ.get("CIBUILDWHEEL", "0") != "1"
 
 
+def generate_version_file() -> None:
+    """Generate the _version.py file using setuptools_scm."""
+    try:
+        from setuptools_scm import get_version  # type: ignore[import-not-found]
+
+        version = get_version(root=".", relative_to=__file__)
+        print(f"Generated version: {version}")
+    except Exception as e:
+        if not allowed_to_fail:
+            raise
+        print(f"Warning: Could not generate version file: {e}")
+
+
 def build_cython_extensions() -> None:
     import Cython.Compiler.Options
     from Cython.Build import build_ext, cythonize
@@ -65,6 +78,7 @@ def build_cython_extensions() -> None:
 
 
 try:
+    generate_version_file()
     build_cython_extensions()
 except Exception:
     if not allowed_to_fail:

pyproject.toml

@@ -295,13 +295,38 @@ ignore_missing_imports = true
 pyiceberg = "pyiceberg.cli.console:run"
 
 [build-system]
-requires = ["poetry-core>=1.0.0", "wheel", "Cython>=3.0.0", "setuptools"]
+requires = ["poetry-core>=1.0.0", "wheel", "Cython>=3.0.0", "setuptools", "setuptools-scm>=8.0"]
 build-backend = "poetry.core.masonry.api"
 
 [tool.poetry.build]
 generate-setup-file = false
 script = "build-module.py"
 
+[tool.setuptools_scm]
+write_to = "pyiceberg/_version.py"
+write_to_template = """# Licensed to the Apache Software Foundation (ASF) under one
+# or more contributor license agreements.  See the NOTICE file
+# distributed with this work for additional information
+# regarding copyright ownership.  The ASF licenses this file
+# to you under the Apache License, Version 2.0 (the
+# "License"); you may not use this file except in compliance
+# with the License.  You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing,
+# software distributed under the License is distributed on an
+# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+# KIND, either express or implied.  See the License for the
+# specific language governing permissions and limitations
+# under the License.
+# Generated by setuptools_scm
+
+__version__ = "{version}"
+__version_tuple__ = {version_tuple}
+"""
+git_describe_command = "git describe --dirty --tags --long --match '*[0-9]*'"
+
 [tool.poetry.extras]
 pyarrow = ["pyarrow", "pyiceberg-core"]
 pandas = ["pandas", "pyarrow"]
@@ -535,5 +560,9 @@ ignore_missing_imports = true
 module = "pyroaring.*"
 ignore_missing_imports = true
 
+[[tool.mypy.overrides]]
+module = "pyiceberg._version"
+ignore_missing_imports = true
+
 [tool.coverage.run]
 source = ['pyiceberg/']