dataerai-sdk 0.2.0b59__tar.gz → 0.2.0b60__tar.gz

{dataerai_sdk-0.2.0b59 → dataerai_sdk-0.2.0b60}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dataerai-sdk
-Version: 0.2.0b59
+Version: 0.2.0b60
 Summary: Python SDK for the Dataerai transfer daemon
 Author: Dataerai
 License: DATAERAI PROPRIETARY SOFTWARE LICENSE AGREEMENT

{dataerai_sdk-0.2.0b59 → dataerai_sdk-0.2.0b60}/dataerai/_version.py

@@ -9,4 +9,4 @@ See ``packaging/version.py`` (the ``compute_version`` brain) and
 ``doc/runbooks/20260616_SDK_CLI_PyPI_Release_Runbook.md``.
 """
 
-__version__ = "0.2.0b59"
+__version__ = "0.2.0b60"

{dataerai_sdk-0.2.0b59 → dataerai_sdk-0.2.0b60}/dataerai/metaextract/__init__.py

@@ -77,6 +77,10 @@ from .api import (
     get_supported_formats,
     process_file,
 )
+from .feature_access import (
+    LocalMetadataExtractionAccess,
+    LocalMetadataExtractionUnavailable,
+)
 
 # Import checksum utilities
 from .checksum import (

dataerai_sdk-0.2.0b60/dataerai/metaextract/feature_access.py

@@ -0,0 +1,48 @@
+"""Live feature decision for connected local metadata extraction."""
+
+from __future__ import annotations
+
+from typing import Any, Callable
+
+
+class LocalMetadataExtractionUnavailable(RuntimeError):
+    """A live Dataerai decision did not authorize local extraction."""
+
+
+class LocalMetadataExtractionAccess:
+    """Require a fresh server decision immediately before local parsing."""
+
+    endpoint = "/api/integrations/metadata-extraction-local/access/"
+
+    def __init__(
+        self,
+        client: Any,
+        *,
+        extractor: Callable[..., dict[str, Any]] | None = None,
+    ) -> None:
+        self.client = client
+        self._extractor = extractor
+
+    def require(self) -> None:
+        try:
+            payload = self.client.get_json("GET", self.endpoint)
+        except Exception:
+            raise LocalMetadataExtractionUnavailable(
+                "Local metadata extraction is unavailable; no file was parsed.",
+            ) from None
+        if payload != {
+            "feature": "metadata_extraction_local",
+            "enabled": True,
+        }:
+            raise LocalMetadataExtractionUnavailable(
+                "Local metadata extraction is unavailable; no file was parsed.",
+            )
+
+    def extract(self, file_path: Any, *, format: str | None = None) -> dict[str, Any]:
+        self.require()
+        extractor = self._extractor
+        if extractor is None:
+            from .api import extract_metadata
+
+            extractor = extract_metadata
+        return extractor(file_path, format=format)

{dataerai_sdk-0.2.0b59 → dataerai_sdk-0.2.0b60}/dataerai_sdk.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dataerai-sdk
-Version: 0.2.0b59
+Version: 0.2.0b60
 Summary: Python SDK for the Dataerai transfer daemon
 Author: Dataerai
 License: DATAERAI PROPRIETARY SOFTWARE LICENSE AGREEMENT

{dataerai_sdk-0.2.0b59 → dataerai_sdk-0.2.0b60}/dataerai_sdk.egg-info/SOURCES.txt

@@ -34,6 +34,7 @@ dataerai/metaextract/converter.py
 dataerai/metaextract/core.py
 dataerai/metaextract/data_type.py
 dataerai/metaextract/data_type_definitions.py
+dataerai/metaextract/feature_access.py
 dataerai/metaextract/registry.py
 dataerai/metaextract/text_metadata.py
 dataerai/metaextract/units.py