a11-kit 0.2.2__tar.gz → 0.2.5__tar.gz

{a11_kit-0.2.2 → a11_kit-0.2.5}/AGENTS.md

@@ -20,6 +20,15 @@
   binary and schema values; they must not introduce a second public data model.
   Python serializers and deserializers continue to operate on those native
   values.
+- A serializable type carries the *same* wire tag in every language:
+  `a11.<Class>` for the runtime's own types, `a11.sdk.<Class>` for the SDKs,
+  subpackages omitted and the name chosen for what the type is. The table lives
+  once per language — `a11/data/serial_tags.py` (an `A11_SERIAL_TAG` ClassVar
+  per class), `cpp/a11/data/serial_tags.h` (returned by the `A11SerialTag` ADL
+  point), `js/src/serial_tags.ts`, `kotlin/.../SerialTags.kt` — and
+  `testdata/serial_tags.json` pins all four, with each suite asserting its own
+  constants against it. Renaming a tag is a wire change: add the old spelling to
+  the legacy alias map so readers keep accepting it, and never emit it again.
 
 ## Concurrency architecture
 

{a11_kit-0.2.2 → a11_kit-0.2.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: a11-kit
-Version: 0.2.2
+Version: 0.2.5
 Summary: Concurrent action and streaming runtime with a native C++ backend
 Requires-Python: >=3.11
 Requires-Dist: absl-py>=2.5.0

a11_kit-0.2.5/VERSION

@@ -0,0 +1 @@
+0.2.5

{a11_kit-0.2.2 → a11_kit-0.2.5}/a11/__init__.py

@@ -28,6 +28,7 @@ from .net.http2 import (
     Http2ResponseWriter,
     Http2Server,
     Http2TlsOptions,
+    HttpProtocolPreference,
     HttpRequest,
     HttpResponse,
     HttpResponseHead,
@@ -106,6 +107,13 @@ from .stores.redis_chunk_store import (
     RedisChunkStoreMetadata,
     RedisChunkStoreOptions,
 )
+from .stores.sqlite_chunk_store import (
+    SQLiteChunkStore,
+    SQLiteChunkStoreFactory,
+    SQLiteChunkStoreMetadata,
+    SQLiteChunkStoreOptions,
+    SQLiteSynchronous,
+)
 from .timing import (
     Duration,
     Time,
@@ -118,6 +126,12 @@ from .timing import (
 
 
 def get_deadline(action: Action) -> Time:
+    """Read the ``x-a11-deadline`` header as an absolute :class:`Time`.
+
+    The value is a base-10 count of **milliseconds** since the Unix epoch, or a
+    base-10 count of **nanoseconds** when suffixed with ``ns``. An absent header
+    means no deadline (:func:`infinite_future`).
+    """
     deadline_str = action.get_header("x-a11-deadline", decode=True)
     if deadline_str is None:
         return infinite_future()
@@ -130,29 +144,31 @@ def get_deadline(action: Action) -> Time:
     try:
         deadline = int(deadline_str)
     except ValueError:
-        raise Status(
-            code=StatusCode.INVALID_ARGUMENT,
-            message=(
-                "Deadline header must be an integer optionally followed by 'ns'"
-            ),
-        ).to_exception()
-
+        deadline = -1
     if deadline < 0:
         raise Status(
             code=StatusCode.INVALID_ARGUMENT,
             message=(
-                "Deadline header must be a non-negative integer optionally"
-                " followed by 'ns'"
+                "The x-a11-deadline header must be a non-negative base-10"
+                " integer of milliseconds since the epoch, or nanoseconds with"
+                " an 'ns' suffix."
             ),
         ).to_exception()
 
-    if nanos:
+    # Bare values are milliseconds; only the 'ns' form is already nanoseconds.
+    if not nanos:
         deadline *= 1000000
 
     return Time.from_nanoseconds_since_epoch(deadline)
 
 
 def set_deadline_header(action: Action, deadline: Time = infinite_future()):
+    """Write ``deadline`` to the ``x-a11-deadline`` header as milliseconds.
+
+    An infinite deadline clears the header. The value is emitted as a bare
+    base-10 millisecond count, the representation :func:`get_deadline` reads by
+    default.
+    """
     if deadline == infinite_future():
         try:
             action.remove_header("x-a11-deadline")