feature: add __version__ attribute to python pkg

Author: d33bs

vortex-python/python/vortex/__init__.py

@@ -81,6 +81,17 @@
 
 assert _lib, "Ensure we eagerly import the Vortex native library"
 
+from importlib import metadata as _metadata
+
+# Resolve the installed distribution version so it is available as vortex.__version__.
+__version__ = "unknown"
+try:
+    # Try to read the installed distribution version for the Python package name.
+    __version__ = _metadata.version("vortex-data")
+except _metadata.PackageNotFoundError:
+    # If the distribution is not installed, keep the unknown fallback.
+    pass
+
 __all__ = [
     # --- Modules ---
     "arrays",
@@ -169,4 +180,6 @@
     "ArrayIterator",
     # Scan
     "RepeatedScan",
+    # Version
+    "__version__",
 ]

vortex-python/test/test_version.py

@@ -0,0 +1,17 @@
+# SPDX-License-Identifier: Apache-2.0
+# SPDX-FileCopyrightText: Copyright the Vortex contributors
+
+import importlib.metadata
+
+import pytest
+
+import vortex
+
+
+def test_version_matches_metadata():
+    try:
+        expected = importlib.metadata.version("vortex-data")
+    except importlib.metadata.PackageNotFoundError:
+        pytest.skip("vortex-data distribution metadata unavailable")
+    # Ensure the exported version matches the distribution metadata.
+    assert vortex.__version__ == expected