nv-ingest-client 2025.10.9.dev20251009__tar.gz → 2025.10.11.dev20251011__tar.gz

{nv_ingest_client-2025.10.9.dev20251009/src/nv_ingest_client.egg-info → nv_ingest_client-2025.10.11.dev20251011}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nv-ingest-client
-Version: 2025.10.9.dev20251009
+Version: 2025.10.11.dev20251011
 Summary: Python client for the nv-ingest service
 Author-email: Jeremy Dyer <jdyer@nvidia.com>
 License:                                  Apache License

{nv_ingest_client-2025.10.9.dev20251009 → nv_ingest_client-2025.10.11.dev20251011}/src/nv_ingest_client/client/client.py

@@ -239,6 +239,9 @@ class _ConcurrentProcessor:
 
         is_failed, description = check_ingest_result(result_data)
 
+        if trace_id:
+            self.client.register_parent_trace_id(trace_id)
+
         if is_failed:
             failed_job_spec = self.client._job_index_to_job_spec.get(job_index)
             self.failures.append((f"{job_index}:{failed_job_spec.source_id}", description))
@@ -722,6 +725,7 @@ class NvIngestClient:
         except ValueError:
             self._telemetry_max_calls = 10000
         self._telemetry = {}
+        self._completed_parent_trace_ids: List[str] = []  # 1054
         self.reset_telemetry()
 
     def __str__(self) -> str:
@@ -1794,3 +1798,19 @@ class NvIngestClient:
             job_ids.append(job_id)
 
         return job_ids
+
+    def register_parent_trace_id(self, trace_id: Optional[str]) -> None:
+        """Record a parent trace identifier once its aggregation completed."""
+
+        if not trace_id:
+            return
+
+        if trace_id not in self._completed_parent_trace_ids:
+            self._completed_parent_trace_ids.append(trace_id)
+
+    def consume_completed_parent_trace_ids(self) -> List[str]:
+        """Return and clear the set of completed parent trace identifiers."""
+
+        trace_ids = list(self._completed_parent_trace_ids)
+        self._completed_parent_trace_ids.clear()
+        return trace_ids

{nv_ingest_client-2025.10.9.dev20251009 → nv_ingest_client-2025.10.11.dev20251011}/src/nv_ingest_client/client/interface.py

@@ -426,20 +426,25 @@ class Ingestor:
             'concurrency_limit', 'timeout', 'max_job_retries', 'retry_delay',
             'data_only', 'return_full_response', 'verbose'. Unrecognized keys are passed
             through to process_jobs_concurrently.
+            Optional flags include `include_parent_trace_ids=True` to also return
+            parent job trace identifiers gathered during ingestion.
 
         Returns
         -------
-        results : list
-            When `return_failures` is False:
-            - Default: List of response['data'] per job (list[list[dict]]).
-            - If `return_full_response=True`: List of full response envelopes (each dict
-              contains keys like 'data', 'trace', 'annotations').
+        results : list of dict
+            List of successful job results when `return_failures` is False.
+
         results, failures : tuple (list of dict, list of tuple of str)
             Tuple containing successful results and failure information when `return_failures` is True.
+
+        If `include_parent_trace_ids=True` is provided via kwargs, an additional
+        list of parent trace IDs is appended to the return value.
         """
         if save_to_disk and (not self._output_config):
             self.save_to_disk()
 
+        include_parent_trace_ids = bool(kwargs.pop("include_parent_trace_ids", False))
+
         self._prepare_ingest_run()
 
         # Add jobs locally first
@@ -641,7 +646,15 @@ class Ingestor:
             except Exception:
                 pass
 
-        return (results, failures) if return_failures else results
+        parent_trace_ids = self._client.consume_completed_parent_trace_ids() if include_parent_trace_ids else []
+
+        if return_failures and include_parent_trace_ids:
+            return results, failures, parent_trace_ids
+        if return_failures:
+            return results, failures
+        if include_parent_trace_ids:
+            return results, parent_trace_ids
+        return results
 
     def ingest_async(self, **kwargs: Any) -> Future:
         """

{nv_ingest_client-2025.10.9.dev20251009 → nv_ingest_client-2025.10.11.dev20251011/src/nv_ingest_client.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nv-ingest-client
-Version: 2025.10.9.dev20251009
+Version: 2025.10.11.dev20251011
 Summary: Python client for the nv-ingest service
 Author-email: Jeremy Dyer <jdyer@nvidia.com>
 License:                                  Apache License