trodo-python 2.10.6__tar.gz → 2.10.8__tar.gz

{trodo_python-2.10.6 → trodo_python-2.10.8}/PKG-INFO

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

{trodo_python-2.10.6 → trodo_python-2.10.8}/pyproject.toml

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

{trodo_python-2.10.6 → trodo_python-2.10.8}/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.6"
+__version__ = "2.10.8"
 
 from typing import Any, Callable, Dict, List, Optional, Union
 
@@ -71,6 +71,8 @@ __all__ = [
     "for_user",
     "track",
     "identify",
+    "people_set",
+    "people_set_once",
     "wallet_address",
     "reset",
     "enable_auto_events",
@@ -130,6 +132,7 @@ def init(
     on_error: Optional[Any] = None,
     debug: bool = False,
     auto_instrument: bool = True,
+    disable_instrumentations: Optional[List[str]] = None,
     otel_mode: str = "trodo",
 ) -> TrodoClient:
     """Initialise the singleton SDK instance.
@@ -138,6 +141,11 @@ def init(
     Anthropic, OpenAI, LangChain, LlamaIndex, Google Generative AI and
     any other installed opentelemetry-instrumentation-* package, so
     LLM calls emit token/cost spans with no further code.
+
+    ``disable_instrumentations`` turns OFF specific instrumentors by id
+    (e.g. ``['openai']`` when LangChain is your primary framework, to avoid
+    double-counting the same model call). Mirrors Node's
+    ``disableInstrumentations``.
     """
     global _client
     _client = TrodoClient(
@@ -152,6 +160,7 @@ def init(
         on_error=on_error,
         debug=debug,
         auto_instrument=auto_instrument,
+        disable_instrumentations=disable_instrumentations,
         otel_mode=otel_mode,
     )
     return _client
@@ -219,6 +228,18 @@ def identify(identify_id: str, session_id: Optional[str] = None) -> UserContext:
     return _get_client().identify(identify_id, session_id)
 
 
+def people_set(distinct_id: str, properties: Dict[str, Any]):
+    """Set profile properties for a user — module-level convenience mirroring
+    ``trodo.people.set(distinctId, props)`` in trodo-node. Equivalent to
+    ``trodo.for_user(distinct_id).people.set(properties)``."""
+    return _get_client().people_set(distinct_id, properties)
+
+
+def people_set_once(distinct_id: str, properties: Dict[str, Any]):
+    """set_once variant of :func:`people_set` — only fills missing keys."""
+    return _get_client().people_set_once(distinct_id, properties)
+
+
 def wallet_address(distinct_id: str, wallet_addr: str) -> WalletAddressResult:
     return _get_client().wallet_address(distinct_id, wallet_addr)
 
@@ -400,6 +421,7 @@ def llm(
     provider: Optional[str] = None,
     temperature: Optional[float] = None,
     extract_usage: Optional[Callable[[Any], Any]] = None,
+    extract_usage_map: Optional[Callable[[Any], Optional[Dict[str, float]]]] = None,
 ) -> Any:
     """Wrap an LLM call — auto-captures tokens from OpenAI/Anthropic/Gemini
     response shapes. Dual-form helper and decorator."""
@@ -411,6 +433,7 @@ def llm(
         provider=provider,
         temperature=temperature,
         extract_usage=extract_usage,
+        extract_usage_map=extract_usage_map,
     )
 
 
@@ -448,6 +471,11 @@ def track_llm_call(
     provider: Optional[str] = None,
     input_tokens: Optional[int] = None,
     output_tokens: Optional[int] = None,
+    cache_read_tokens: Optional[int] = None,
+    cache_write_tokens: Optional[int] = None,
+    usage_details: Optional[Dict[str, float]] = None,
+    usage: Any = None,
+    cost_details: Optional[Dict[str, float]] = None,
     prompt: Any = None,
     completion: Any = None,
     temperature: Optional[float] = None,
@@ -462,6 +490,11 @@ def track_llm_call(
         provider=provider,
         input_tokens=input_tokens,
         output_tokens=output_tokens,
+        cache_read_tokens=cache_read_tokens,
+        cache_write_tokens=cache_write_tokens,
+        usage_details=usage_details,
+        usage=usage,
+        cost_details=cost_details,
         prompt=prompt,
         completion=completion,
         temperature=temperature,

{trodo_python-2.10.6 → trodo_python-2.10.8}/trodo/client.py

@@ -57,6 +57,7 @@ class TrodoClient:
         on_error: Optional[Any] = None,
         debug: bool = False,
         auto_instrument: bool = True,
+        disable_instrumentations: Optional[List[str]] = None,
         otel_mode: str = "trodo",
     ) -> None:
         if not site_id:
@@ -100,13 +101,14 @@ class TrodoClient:
             import os
             if os.environ.get("TRODO_LEGACY_INIT") == "1":
                 # Pre-2.4 escape hatch for one minor version.
-                enable_auto_instrument(self._span_processor)
+                enable_auto_instrument(self._span_processor, disable=disable_instrumentations)
             else:
                 _register_otel(
                     site_id=site_id,
                     processor=self._span_processor,
                     mode=otel_mode,
                     endpoint=api_base,
+                    disable_instrumentations=disable_instrumentations,
                 )
 
     def _get_span_processor(self) -> TrodoSpanProcessor:

{trodo_python-2.10.6 → trodo_python-2.10.8}/trodo/otel/register.py

@@ -93,7 +93,7 @@ def register_otel(
     endpoint = (endpoint or "https://sdkapi.trodo.ai").rstrip("/")
 
     if mode == "trodo":
-        active = enable_auto_instrument(processor)
+        active = enable_auto_instrument(processor, disable=disable_instrumentations)
     elif mode == "otlp":
         active = _setup_otlp_mode(
             site_id=site_id,

{trodo_python-2.10.6 → trodo_python-2.10.8}/trodo_python.egg-info/PKG-INFO

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