x4d-devkit 0.48.0rc8__tar.gz → 0.48.0rc9__tar.gz

{x4d_devkit-0.48.0rc8 → x4d_devkit-0.48.0rc9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: x4d-devkit
-Version: 0.48.0rc8
+Version: 0.48.0rc9
 Summary: Official X-4D external SDK and CLI for datasets, platform APIs, training bridges, and automation
 Author: windzu
 License-Expression: Apache-2.0

{x4d_devkit-0.48.0rc8 → x4d_devkit-0.48.0rc9}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "x4d-devkit"
-version = "0.48.0rc8"
+version = "0.48.0rc9"
 description = "Official X-4D external SDK and CLI for datasets, platform APIs, training bridges, and automation"
 readme = "README.md"
 license = "Apache-2.0"

{x4d_devkit-0.48.0rc8 → x4d_devkit-0.48.0rc9}/tests/test_image_clip.py

@@ -308,6 +308,40 @@ def test_typed_client_validates_metadata_then_reads_one_authorized_verified_imag
         assert len(requests) == 3
 
 
+@pytest.mark.parametrize("failure", [None, "source", "descriptor", "origin", "contract"])
+def test_reference_only_read_validates_context_without_requesting_media(failure):
+    value, requests = clip_payload(), []
+
+    def handler(request):
+        requests.append(request)
+        assert request.url.path.endswith("/images/image_a")
+        result = {
+            "contract_version": "x4d-image-asset-reference-v1",
+            "clip_id": "clip_test", "image_id": "image_a",
+            "source_revision": value["identity"]["source_revision"],
+            "asset": dict(value["sample_data"][0]["asset"]),
+            "uri": "/api/v1/files/clips/clip_test/samples/cam_a/10000000020.jpg",
+        }
+        if failure == "source":
+            result["source_revision"] = "sha256:" + "f" * 64
+        elif failure == "descriptor":
+            result["asset"]["size"] += 1
+        elif failure == "origin":
+            result["uri"] = "https://untrusted.example/api/v1/files/private"
+        elif failure == "contract":
+            result["contract_version"] = "other"
+        return httpx.Response(200, json=result)
+
+    with client_for(handler) as client:
+        clip = parse_image_clip(value)
+        if failure:
+            with pytest.raises(ValueError):
+                client.image_clips.get_asset(clip, "image_a")
+        else:
+            assert client.image_clips.get_asset(clip, "image_a")["asset"] == clip.images[0]["asset"]
+        assert len(requests) == 1
+
+
 @pytest.mark.parametrize(
     "failure",
     [

{x4d_devkit-0.48.0rc8 → x4d_devkit-0.48.0rc9}/tests/test_sdk_api.py

@@ -11,7 +11,7 @@ from x4d_devkit.eval.matching import MetricData
 
 
 def test_package_version_is_current_release():
-    assert x4d_devkit.__version__ == "0.48.0rc8"
+    assert x4d_devkit.__version__ == "0.48.0rc9"
 
 
 def test_loader_exposes_and_enforces_only_current_schema(tmp_path):

{x4d_devkit-0.48.0rc8 → x4d_devkit-0.48.0rc9}/x4d_devkit/client/image_clips.py

@@ -7,6 +7,7 @@ from urllib.parse import quote
 
 from x4d_devkit._image_contract import fields, identifier, integer, require
 from x4d_devkit.client.assets import PlatformAsset
+from x4d_devkit.client.assets import _validated_file_uri
 from x4d_devkit.image_clip import ImageClip, parse_image_clip
 
 
@@ -47,22 +48,15 @@ class ImageClipsAPI:
         value = self._client.get(f"/image-clips/{quote(clip_id, safe='')}")
         return parse_image_clip(value, expected_clip_id=clip_id)
 
-    def read_image(
-        self, clip: ImageClip, image_id: str, *, max_bytes: int = 32 * 1024 * 1024
-    ) -> PlatformAsset:
+    def get_asset(self, clip: ImageClip, image_id: str) -> dict:
+        """Validate an authorized reference without downloading original bytes."""
         require(
             type(clip) is ImageClip, "expected a validated native image Clip", "clip"
         )
         identifier(image_id, "image_id")
-        integer(max_bytes, "max_bytes", minimum=1)
         image = next((item for item in clip.images if item["id"] == image_id), None)
         require(image is not None, "image does not belong to this Clip", "image_id")
         expected = image["asset"]
-        require(
-            expected["size"] <= max_bytes,
-            "image exceeds the configured read budget",
-            "image.asset.size",
-        )
         value = self._client.get(
             f"/image-clips/{quote(clip.clip_id, safe='')}/images/{quote(image_id, safe='')}"
         )
@@ -82,12 +76,33 @@ class ImageClipsAPI:
             value["contract_version"] == IMAGE_ASSET_REFERENCE_VERSION
             and value["clip_id"] == clip.clip_id
             and value["image_id"] == image_id
-            and value["source_revision"]
-            == clip.to_dict()["identity"]["source_revision"]
             and value["asset"] == expected,
             "image asset context changed",
             "image_asset",
         )
+        require(
+            value["source_revision"] == clip.to_dict()["identity"]["source_revision"],
+            "image source revision changed",
+            "image_asset.source_revision",
+        )
+        _validated_file_uri(value["uri"], api_url=self._client.api_url)
+        return value
+
+    def read_image(
+        self, clip: ImageClip, image_id: str, *, max_bytes: int = 32 * 1024 * 1024
+    ) -> PlatformAsset:
+        require(type(clip) is ImageClip, "expected a validated native image Clip", "clip")
+        identifier(image_id, "image_id")
+        integer(max_bytes, "max_bytes", minimum=1)
+        image = next((item for item in clip.images if item["id"] == image_id), None)
+        require(image is not None, "image does not belong to this Clip", "image_id")
+        expected = image["asset"]
+        require(
+            expected["size"] <= max_bytes,
+            "image exceeds the configured read budget",
+            "image.asset.size",
+        )
+        value = self.get_asset(clip, image_id)
         asset = self._client.assets.fetch(value["uri"], max_bytes=expected["size"])
         require(
             len(asset.content) == expected["size"]

{x4d_devkit-0.48.0rc8 → x4d_devkit-0.48.0rc9}/x4d_devkit.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: x4d-devkit
-Version: 0.48.0rc8
+Version: 0.48.0rc9
 Summary: Official X-4D external SDK and CLI for datasets, platform APIs, training bridges, and automation
 Author: windzu
 License-Expression: Apache-2.0