zettcode-engine 0.3.4__py3-none-any.whl

zettcode/_compat.py

@@ -0,0 +1,35 @@
+"""Small shims for the language versions this project supports.
+
+ZettCode runs on Python 3.10 through 3.15, so the few things the standard
+library grew in between live here instead of behind version checks at each use.
+"""
+
+from __future__ import annotations
+
+import sys
+from enum import Enum
+
+if sys.version_info >= (3, 11):
+    from builtins import BaseExceptionGroup, ExceptionGroup
+
+    import tomllib
+else:  # pragma: no cover - the branch only the 3.10 runtime takes
+    import tomli as tomllib
+    from exceptiongroup import BaseExceptionGroup, ExceptionGroup
+
+
+__all__ = ["BaseExceptionGroup", "ExceptionGroup", "StrEnum", "tomllib"]
+
+
+class StrEnum(str, Enum):
+    """A string-valued enum, for the versions before ``enum.StrEnum``.
+
+    The standard library's version formats as its value, so ``f"{member}"`` is
+    ``"ready"`` rather than ``"Activity.READY"``; the status line and the stored
+    metadata rely on that, so every interpreter uses this class instead of the
+    standard one and the wording cannot drift with the version.
+    """
+
+    def __str__(self) -> str:
+        """Return the member's value, as ``enum.StrEnum`` does."""
+        return str(self.value)

zettcode/budget.py

@@ -0,0 +1,24 @@
+"""What a context budget is made of: the vocabulary the engine measures with and the views draw with.
+
+A leaf with no imports, shared like :mod:`zettcode.statusline` and :mod:`zettcode.providers`, so the engine that counts
+the request and the page that shows the count agree on the names without either importing the other.
+"""
+
+from __future__ import annotations
+
+__all__ = ["CHARS_PER_TOKEN", "SOURCES"]
+
+#: Characters per token when no tokenizer is available. The rule of thumb is close for English prose and low for CJK,
+#: which is why a report names the estimate it used instead of presenting it as exact.
+CHARS_PER_TOKEN = 4
+
+#: One row per source, in the order the request is assembled.
+SOURCES = (
+    "System prompt",
+    "Environment notes",
+    "Tool schemas",
+    "User messages",
+    "Assistant messages",
+    "Tool output",
+    "Compaction summary",
+)