trodo-python 2.10.2__tar.gz → 2.10.3__tar.gz

{trodo_python-2.10.2 → trodo_python-2.10.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: trodo-python
-Version: 2.10.2
+Version: 2.10.3
 Summary: Trodo Analytics SDK for Python — server-side event tracking
 License: ISC
 Keywords: analytics,tracking,trodo,server-side

{trodo_python-2.10.2 → trodo_python-2.10.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "trodo-python"
-version = "2.10.2"
+version = "2.10.3"
 description = "Trodo Analytics SDK for Python — server-side event tracking"
 readme = "README.md"
 license = { text = "ISC" }

{trodo_python-2.10.2 → trodo_python-2.10.3}/trodo/__init__.py

@@ -40,7 +40,7 @@ Downstream microservice (join the caller's run instead of making a new one):
 
 from __future__ import annotations
 
-__version__ = "2.10.2"
+__version__ = "2.10.3"
 
 from typing import Any, Callable, Dict, List, Optional, Union
 

{trodo_python-2.10.2 → trodo_python-2.10.3}/trodo/otel/auto_instrument.py

@@ -9,12 +9,25 @@ lazily and skip anything that isn't installed.
 
 from __future__ import annotations
 
+import sys
 from datetime import datetime, timezone
 from typing import Any, Callable, Dict, Iterable, List, Optional
 
 from .context import get_active_context
 from .processor import TrodoSpan, TrodoSpanProcessor
 
+# Always-on, one-shot warnings. Silent skips (missing opentelemetry-sdk) are the
+# #1 cause of "I installed Trodo but see no LLM spans" — surface them even
+# without debug, matching the Node SDK's warnOnce behaviour.
+_WARNED_ONCE: set = set()
+
+
+def _warn_once(key: str, msg: str) -> None:
+    if key in _WARNED_ONCE:
+        return
+    _WARNED_ONCE.add(key)
+    sys.stderr.write(f"[trodo-python] {msg}\n")
+
 
 def _hr_to_iso(nanos: Optional[int]) -> Optional[str]:
     if nanos is None:
@@ -341,14 +354,21 @@ def enable_auto_instrument(
     """Register OTel auto-instrumentations for installed packages.
 
     Returns the list of framework ids that were actually instrumented.
-    Skipped silently if opentelemetry-sdk or the per-framework
-    instrumentation package isn't installed.
+    Emits a one-shot stderr warning if opentelemetry-sdk isn't installed (the
+    #1 silent-failure mode); per-framework instrumentation packages that aren't
+    installed are skipped silently.
     """
     disabled = set(disable or [])
     try:
         from opentelemetry import trace  # type: ignore
         from opentelemetry.sdk.trace import TracerProvider  # type: ignore
     except Exception:
+        _warn_once(
+            "otel-sdk-missing",
+            "auto-instrument: opentelemetry-sdk is not installed — no LLM spans "
+            "will be auto-captured. Install: pip install opentelemetry-sdk "
+            "opentelemetry-api (plus opentelemetry-instrumentation-<provider> per framework).",
+        )
         return []
 
     provider = trace.get_tracer_provider()

{trodo_python-2.10.2 → trodo_python-2.10.3}/trodo/otel/wrap_agent.py

@@ -253,8 +253,14 @@ class RunHandle:
     def set_output(self, value: Any) -> None:
         self.output = _prepare_value(value)
 
-    def set_metadata(self, **kwargs: Any) -> None:
-        self.metadata.update(kwargs)
+    def set_metadata(self, metadata: Optional[Dict[str, Any]] = None, **kwargs: Any) -> None:
+        # Accept a dict (Node parity: setMetadata({...})) and/or keyword args
+        # (set_metadata(key=value)). Previously kwargs-only, which broke code
+        # copied from the Node SDK.
+        if metadata:
+            self.metadata.update(metadata)
+        if kwargs:
+            self.metadata.update(kwargs)
 
     def set_error_summary(self, summary: str, *, type: Optional[str] = None) -> None:
         """Mark the run as errored without raising — e.g. a soft failure the

{trodo_python-2.10.2 → trodo_python-2.10.3}/trodo_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: trodo-python
-Version: 2.10.2
+Version: 2.10.3
 Summary: Trodo Analytics SDK for Python — server-side event tracking
 License: ISC
 Keywords: analytics,tracking,trodo,server-side