trodo-python 2.18.1__tar.gz → 2.18.2__tar.gz

{trodo_python-2.18.1 → trodo_python-2.18.2}/PKG-INFO

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

{trodo_python-2.18.1 → trodo_python-2.18.2}/pyproject.toml

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

trodo_python-2.18.2/tests/test_get_prompt_version_types.py

@@ -0,0 +1,54 @@
+"""The public get_prompt must accept a version_hash, not just an int.
+
+The manager has always taken ``Union[int, str]`` and documents hash support —
+the hash is the stable identity the dashboard shows and the SDK returns. But
+the top-level ``trodo.get_prompt`` wrapper narrowed the hint to ``int``, so a
+type checker flagged the documented usage, and the dashboard's own "Use this
+prompt" snippet emits ``version="<hash>"`` for Python.
+
+Checked by signature rather than by a network call: the wrapper only forwards,
+so the contract IS the signature.
+"""
+import inspect
+import typing
+
+import trodo
+from trodo.managers.prompt_manager import PromptManager
+
+
+def _version_annotation(fn):
+    return typing.get_type_hints(fn)["version"]
+
+
+def test_public_get_prompt_accepts_int_or_str():
+    ann = _version_annotation(trodo.get_prompt)
+    args = typing.get_args(ann)
+    assert int in args, f"version should accept int, got {ann}"
+    assert str in args, f"version should accept a version_hash (str), got {ann}"
+
+
+def test_matches_the_manager_it_forwards_to():
+    assert _version_annotation(trodo.get_prompt) == _version_annotation(PromptManager.get)
+
+
+def test_forwards_version_through_untouched():
+    """A hash must reach the manager as-is — not coerced, not dropped."""
+    seen = {}
+
+    class _Stub:
+        def get(self, name, **kwargs):
+            seen.update(kwargs, name=name)
+            return "sentinel"
+
+    class _Client:
+        prompts = _Stub()
+
+    original = trodo._get_client
+    trodo._get_client = lambda: _Client()
+    try:
+        assert trodo.get_prompt("p", version="a3f9c2") == "sentinel"
+    finally:
+        trodo._get_client = original
+
+    assert seen["version"] == "a3f9c2"
+    assert seen["label"] is None

{trodo_python-2.18.1 → trodo_python-2.18.2}/trodo/__init__.py

@@ -322,7 +322,7 @@ def reset(distinct_id: str) -> ResetResult:
 def get_prompt(
     name: str,
     label: Optional[str] = None,
-    version: Optional[int] = None,
+    version: Optional[Union[int, str]] = None,
     cache_ttl_seconds: Optional[float] = None,
     fallback: Optional[Dict[str, Any]] = None,
     max_retries: int = 2,
@@ -330,7 +330,9 @@ def get_prompt(
     """Fetch a managed prompt by name.
 
     Follows the ``production`` label by default; pass ``label`` for a different
-    one or ``version`` to pin exactly.
+    one or ``version`` to pin exactly. ``version`` may be the integer
+    ``version_no`` or a ``version_hash`` (full, or an unambiguous short prefix
+    like ``a3f9c2``) — the hash is the stable identity, so prefer it.
 
     Cached for 60s with stale-while-revalidate, so a Trodo outage degrades
     instead of taking your app down. Pass ``fallback`` to cover cold start::

{trodo_python-2.18.1 → trodo_python-2.18.2}/trodo_python.egg-info/PKG-INFO

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

{trodo_python-2.18.1 → trodo_python-2.18.2}/trodo_python.egg-info/SOURCES.txt

@@ -7,6 +7,7 @@ tests/test_datasets.py
 tests/test_end_run.py
 tests/test_error_enrichment.py
 tests/test_experiments.py
+tests/test_get_prompt_version_types.py
 tests/test_llm_usage_cost.py
 tests/test_multi_agent_shape.py
 tests/test_processor_methods.py