trodo-python 2.26.0__tar.gz → 2.26.1__tar.gz

{trodo_python-2.26.0 → trodo_python-2.26.1}/PKG-INFO

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

{trodo_python-2.26.0 → trodo_python-2.26.1}/pyproject.toml

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

{trodo_python-2.26.0 → trodo_python-2.26.1}/tests/test_datasets.py

@@ -128,3 +128,19 @@ def test_export_requires_a_token_and_raises_on_http_errors():
         DatasetManager(FakeExportHttp({})).export("ds", "")
     with pytest.raises(RuntimeError, match="HTTP 404"):
         DatasetManager(FakeExportHttp({"__error": True, "status": 404, "error": "not_found"})).export("ds", "trodo_dx_abc")
+
+
+def test_append_accepts_unit_references_without_input():
+    http = FakeHttp()
+    DatasetManager(http).append("ds", [
+        {"span_id": "s1", "tags": ["hard"]},
+        {"run_id": "r1"},
+        {"conversation_id": "c1", "metadata": {"k": 1}},
+        {"eval_run_id": "v1"},
+    ])
+    assert http.last_body["items"] == [
+        {"span_id": "s1", "tags": ["hard"]},
+        {"run_id": "r1"},
+        {"conversation_id": "c1", "metadata": {"k": 1}},
+        {"eval_run_id": "v1"},
+    ]

{trodo_python-2.26.0 → trodo_python-2.26.1}/trodo/__init__.py

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

{trodo_python-2.26.0 → trodo_python-2.26.1}/trodo/managers/dataset_manager.py

@@ -17,16 +17,28 @@ from typing import Any, Dict, List, Optional, Union
 
 __all__ = ["DatasetManager"]
 
-# The optional per-item fields, in wire order. ``input`` is always required.
-_ITEM_OPTIONAL = ("expected_output", "metadata", "source_trace_ref")
+# The optional per-item fields, in wire order. ``input`` is required on a row.
+_ITEM_OPTIONAL = ("output", "expected_output", "metadata", "source_trace_ref", "tags")
+# A reference to production instead of content: the item becomes that unit's
+# row (Input, Output and Evaluations filled by Trodo). ``eval_run_id`` names a
+# verdict: Output is what the eval said, Expected its correction.
+_UNIT_REF_KEYS = ("span_id", "run_id", "conversation_id", "eval_run_id")
+_UNIT_REF_OPTIONAL = ("tags", "metadata")
 
 
 def _clean_item(item: Dict[str, Any]) -> Dict[str, Any]:
     if not isinstance(item, dict):
         raise ValueError("trodo: each dataset item must be a dict")
+    ref = [k for k in _UNIT_REF_KEYS if item.get(k)]
+    if ref and ("input" not in item or item["input"] is None):
+        out: Dict[str, Any] = {ref[0]: str(item[ref[0]])}
+        for key in _UNIT_REF_OPTIONAL:
+            if item.get(key) is not None:
+                out[key] = item[key]
+        return out
     if "input" not in item or item["input"] is None:
-        raise ValueError("trodo: each dataset item requires an 'input' dict")
-    out: Dict[str, Any] = {"input": item["input"]}
+        raise ValueError("trodo: each dataset item requires an 'input' dict, or a span_id / run_id / conversation_id / eval_run_id")
+    out = {"input": item["input"]}
     for key in _ITEM_OPTIONAL:
         if item.get(key) is not None:
             out[key] = item[key]

{trodo_python-2.26.0 → trodo_python-2.26.1}/trodo_python.egg-info/PKG-INFO

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