authentasdk 0.2.4__tar.gz → 0.2.5__tar.gz

{authentasdk-0.2.4 → authentasdk-0.2.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: authentasdk
-Version: 0.2.4
+Version: 0.2.5
 Summary: Python SDK for the Authenta API to detect deepfakes and manipulated media
 Home-page: https://github.com/phospheneai/authenta-python-sdk
 Author: Arjun Adhithya

{authentasdk-0.2.4 → authentasdk-0.2.5}/setup.cfg

@@ -1,6 +1,6 @@
 [metadata]
 name = authentasdk
-version = 0.2.4
+version = 0.2.5
 description = Python SDK for the Authenta API to detect deepfakes and manipulated media
 author = Arjun Adhithya
 author_email = rrarjunadhithya@gmail.com

{authentasdk-0.2.4 → authentasdk-0.2.5}/src/authenta/authenta_client.py

@@ -295,6 +295,33 @@ class AuthentaClient:
             raise RuntimeError("No 'mid' in upload response")
         return self.wait_for_media(mid, interval=interval, timeout=timeout)
 
+    def get_result(self, media: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Fetch the detection result JSON from the media's resultURL.
+
+        The resultURL is a presigned S3 URL returned after processing.
+        It contains the actual detection output (e.g. isLiveness, isDeepFake,
+        isSimilar, similarityScore, etc.).
+
+        Args:
+            media: A media dict returned by face_intelligence(), process(), or
+                   wait_for_media() — must contain a 'resultURL' key.
+
+        Returns:
+            Parsed detection result dict from resultURL.
+
+        Raises:
+            ValueError: If the media dict has no resultURL.
+            RuntimeError: If the resultURL fetch fails.
+        """
+        result_url = media.get("resultURL")
+        if not result_url:
+            raise ValueError("media dict has no 'resultURL'. Ensure processing is complete (status=PROCESSED).")
+        resp = requests.get(result_url, timeout=30)
+        if not resp.ok:
+            raise RuntimeError(f"Failed to fetch resultURL: HTTP {resp.status_code}")
+        return resp.json()
+
     def face_intelligence(
             self,
             path: str,
@@ -312,6 +339,7 @@ class AuthentaClient:
         High-level helper for Face Integrity (FI) model:
           1) upload_file(path, model_type) -> get mid
           2) wait_for_media(mid) (only if auto_polling=True)
+          3) get_result(media) to fetch detection output (only if auto_polling=True)
 
         Args:
             path: Local path to the media file.
@@ -321,13 +349,16 @@ class AuthentaClient:
             faceswapCheck: Whether to check for face swapping (video only).
             livenessCheck: Whether to check for liveness.
             faceSimilarityCheck: Whether to check for face similarity (image only).
-            auto_polling: If True (default), blocks until processing completes.
+            auto_polling: If True (default), blocks until processing completes and
+                automatically fetches the detection result from resultURL, merging
+                it into the returned dict under the key 'result'.
                 If False, returns immediately after upload with initial metadata.
             interval: Polling interval in seconds (used only when auto_polling=True).
             timeout: Timeout in seconds (used only when auto_polling=True).
 
         Returns:
-            If auto_polling=True: the final processed media JSON.
+            If auto_polling=True: media dict with an added 'result' key containing
+                the full detection output fetched from resultURL.
             If auto_polling=False: the initial upload metadata dict (includes 'mid').
         """
         if self._content_type(path).startswith("image/") and faceswapCheck:
@@ -351,7 +382,9 @@ class AuthentaClient:
         mid = meta.get("mid")
         if not mid:
             raise RuntimeError("No 'mid' in upload response")
-        return self.wait_for_media(mid, interval=interval, timeout=timeout)
+        media = self.wait_for_media(mid, interval=interval, timeout=timeout)
+        media["result"] = self.get_result(media)
+        return media
 
     def delete_media(self, mid: str) -> None:
         """DELETE /api/media/{mid}: delete a media record."""

{authentasdk-0.2.4 → authentasdk-0.2.5}/src/authentasdk.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: authentasdk
-Version: 0.2.4
+Version: 0.2.5
 Summary: Python SDK for the Authenta API to detect deepfakes and manipulated media
 Home-page: https://github.com/phospheneai/authenta-python-sdk
 Author: Arjun Adhithya