trodo-python 2.18.2__py3-none-any.whl → 2.20.0__py3-none-any.whl

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.18.0"
+__version__ = "2.20.0"
 
 from typing import Any, Callable, Dict, List, Optional, Union
 

trodo/managers/prompt_manager.py

@@ -56,10 +56,12 @@ def _to_variables(raw: Any) -> List[PromptVariable]:
             out.append(v)
         elif isinstance(v, dict) and isinstance(v.get("name"), str):
             out.append(
+                # Named fields only — a stored version may carry keys this SDK
+                # no longer models (`required`, retired in 2.20.0), and fetching
+                # one must never raise.
                 PromptVariable(
                     name=v["name"],
                     type=v.get("type") or "string",
-                    required=bool(v.get("required")),
                     default=v.get("default"),
                     description=v.get("description"),
                 )

trodo/prompts/compile.py

@@ -74,8 +74,10 @@ def build_scope(
 ) -> Dict[str, Any]:
     """Build the render scope from declarations + caller values.
 
-    Resolution order: caller value → declared default → required-and-absent
-    raises → optional-and-absent renders empty.
+    Resolution order: caller value -> declared default -> empty.
+
+    A missing value never raises. The one thing this does reject is a value for
+    a variable the prompt does not declare, which is almost always a typo.
     """
     errors: List[str] = []
     scope: Dict[str, Any] = {}
@@ -100,8 +102,10 @@ def build_scope(
         has = name in values
         value = values.get(name) if has else None
 
-        # Missing value -> the declared default, or empty. Nothing is
-        # "required": compile always succeeds with whatever the caller provides.
+        # A missing value resolves, it never fails: the declared default, or
+        # empty. That IS the point of declaring a default -- there is no third
+        # case where the caller has to have supplied something, and adding one
+        # would turn an empty render into a crash for no gain.
         if not has or value is None:
             value = default if has_default else ([] if type_ == "messages" else "")
 

trodo/prompts/types.py

@@ -26,14 +26,18 @@ class PromptVariable:
     """A declared variable.
 
     Every competitor leaves variables undeclared and untyped — discovered by
-    regex, with no defaults and no required-ness. The declaration is what lets
-    ``compile()`` fail before the model call rather than shipping a literal
-    ``{{typo}}`` and finding out from the bill.
+    regex, and with no defaults. Knowing the declared set is what lets
+    ``compile()`` catch a value passed for a variable that doesn't exist,
+    instead of silently rendering the wrong prompt.
+
+    A missing value never fails. It resolves to the declared ``default``, or to
+    empty — that is what declaring a default is FOR. There is deliberately no
+    ``required`` flag: it would give the author a decision to get wrong and the
+    caller a crash where an empty render would do.
     """
 
     name: str
     type: str = "string"
-    required: bool = False
     default: Any = None
     description: Optional[str] = None
 

{trodo_python-2.18.2.dist-info → trodo_python-2.20.0.dist-info}/METADATA

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

{trodo_python-2.18.2.dist-info → trodo_python-2.20.0.dist-info}/RECORD

@@ -1,4 +1,4 @@
-trodo/__init__.py,sha256=LxN-qzeCDU_SpYs0gsZQxvdj5PuWd8cOBUqYGk9viLc,26928
+trodo/__init__.py,sha256=ueM-l4KXHdP42DzvCRN9Zc5d4OsCxOSjiT-NIGAiLyQ,26928
 trodo/client.py,sha256=9UYaHZtWPMYdlG2xWVf77PQJ9DfFgN-zobTh60i8_Cc,22453
 trodo/types.py,sha256=eySgUvCXROG2TxtxgiU0MNr5iH0DEcduK8bmYtTKG44,3138
 trodo/user_context.py,sha256=uHCI2WYoOI3cNwdIUEuZdX4VYSu14pzm348ksn6hn_c,8195
@@ -13,7 +13,7 @@ trodo/managers/dataset_manager.py,sha256=gx0S8ujG3cbw4IskBNMdceBjDbcEh_nebwKSzEv
 trodo/managers/experiment_manager.py,sha256=V-vemLtenfSI5VIcP0HPiXzEy8AyTrRrbJVCA9Z6wjo,10579
 trodo/managers/group_manager.py,sha256=ki3Se3qEoSZfREX63oeDeBmEfZF-ISHLE8azEtLg0tM,3542
 trodo/managers/people_manager.py,sha256=mMVnx40Mlifx6NGgChvohC9ViK6dQu2mkXNHbV8pK1E,2882
-trodo/managers/prompt_manager.py,sha256=jFHkdvDSxvvb9c53EQvBQygdDJ7X-ylNWEY_ag_SeC0,11227
+trodo/managers/prompt_manager.py,sha256=4xj_38b2qU31aTs5fIq-wNJnPisqf1zre0u8jvjZOF4,11375
 trodo/managers/user_manager.py,sha256=faJYX3CHrD7ulYiShV7FhThSMX9aJ3kdOgU4Qtdy5FM,2844
 trodo/otel/__init__.py,sha256=yiRFXWUU45bAM2CV37XeO7zf1hmnmjufdP4XO50yEyE,624
 trodo/otel/auto_instrument.py,sha256=Iae9A9lvh2PImE6gqnyEMXeRPRpjTxZcxx1zW2KDLac,21467
@@ -25,9 +25,9 @@ trodo/otel/register.py,sha256=bV_ePTfUvPugig2GZnylhzxi2QfoPWs96A9mGLPMrSQ,9387
 trodo/otel/transport.py,sha256=hzZz8gwSMGJ8CxdijmLn1Ljt18owr9XTWy13DLbwYbw,2441
 trodo/otel/wrap_agent.py,sha256=cJjrzlZNW2g6q_coLN7UR4uxn65h4u3-LNzMfE4dLVw,40999
 trodo/prompts/__init__.py,sha256=yunNc8WkTSfEEkRR-NZWXAt_ZB3Ee2INRh-4RE7uHj4,806
-trodo/prompts/compile.py,sha256=sEMl8EWdK0G9uOKGcgc39ujnA5RLCUtbk26TYVqK68Q,6345
+trodo/prompts/compile.py,sha256=UhJhu-BtVicaauDEKpAXB17KhgVs4jWos_I60I8kZFk,6583
 trodo/prompts/template.py,sha256=obQiivPCR6LEdz7q1cby7uL25tYHYui4aoEaiUNqWfs,9357
-trodo/prompts/types.py,sha256=3oyrEDb1jfnC4gF02mM3izhNHstJ-bu-8TxoF7Yk6mQ,4425
+trodo/prompts/types.py,sha256=A24njy6qcc8QNzWEfGu28BbBr360S7A5Pw7_ObIWNS4,4684
 trodo/queue/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 trodo/queue/batch_flusher.py,sha256=4Lg6T3Urwi9U0Q4FpFGPmjDYKg4ZliCTR-ND8BJvWaY,1298
 trodo/queue/event_queue.py,sha256=EVFZrhlq_kwC3jJ2GK0wMhHISf9UzLCZNDnT_aZ2I2A,872
@@ -36,7 +36,7 @@ trodo/session/server_session.py,sha256=McsudEiq33XDq3nqxgzBcUvIjQxCMscwEuAPnYXrT
 trodo/session/session_manager.py,sha256=7ht5LeeZX1HLLfPeNV_a8NkXGbHl3up0CRtCGr3EzjQ,2995
 trodo/util/__init__.py,sha256=Z9c4rPPdKg06Kk3byKheDqksSgR4WNvS475oQ5sNljc,54
 trodo/util/lru.py,sha256=QIsM7s6J_E9ZjiXatSyReZIEeGypTAcgrPWWy8YsRa4,2465
-trodo_python-2.18.2.dist-info/METADATA,sha256=UnFh9i8kRSmo6JfdHcRWy7dYGm7vGW714FgDC_5ckM8,25308
-trodo_python-2.18.2.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
-trodo_python-2.18.2.dist-info/top_level.txt,sha256=VCQu1CJWFmNsqTs1YxMcw4Mq35Tc3z3uI9RwHEXAayQ,6
-trodo_python-2.18.2.dist-info/RECORD,,
+trodo_python-2.20.0.dist-info/METADATA,sha256=EYdoY1cwgukIxmryCG6QadL0qiIz5J8harU3y7v6Q0Y,25308
+trodo_python-2.20.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+trodo_python-2.20.0.dist-info/top_level.txt,sha256=VCQu1CJWFmNsqTs1YxMcw4Mq35Tc3z3uI9RwHEXAayQ,6
+trodo_python-2.20.0.dist-info/RECORD,,