tigrbl-typing 0.1.12.dev1__tar.gz → 0.1.13.dev1__tar.gz

{tigrbl_typing-0.1.12.dev1 → tigrbl_typing-0.1.13.dev1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tigrbl-typing
-Version: 0.1.12.dev1
+Version: 0.1.13.dev1
 Summary: Typing protocols and shared type helpers for the Tigrbl framework.
 License-Expression: Apache-2.0
 Keywords: tigrbl,sdk,standards,framework
@@ -16,6 +16,9 @@ Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
 Requires-Dist: pydantic (>=2.10,<3)
+Project-URL: Homepage, https://github.com/swarmauri/tigrbl
+Project-URL: Issues, https://github.com/swarmauri/tigrbl/issues
+Project-URL: Repository, https://github.com/swarmauri/tigrbl/tree/main/pkgs/core/tigrbl_typing
 Description-Content-Type: text/markdown
 
 # tigrbl_typing

{tigrbl_typing-0.1.12.dev1 → tigrbl_typing-0.1.13.dev1}/pyproject.toml

@@ -1,10 +1,9 @@
 [project]
 name = "tigrbl-typing"
-version = "0.1.12.dev1"
+version = "0.1.13.dev1"
 description = "Typing protocols and shared type helpers for the Tigrbl framework."
 license = "Apache-2.0"
 readme = "README.md"
-repository = "http://github.com/swarmauri/swarmauri-sdk"
 requires-python = ">=3.10,<3.14"
 classifiers = [
     "Development Status :: 1 - Planning",
@@ -17,11 +16,18 @@ classifiers = [
     "Programming Language :: Python :: 3 :: Only",
 ]
 authors = [{ name = "Jacob Stewart", email = "jacob@swarmauri.com" }]
+
 dependencies = [
     "pydantic>=2.10,<3",
 ]
 keywords = ["tigrbl", "sdk", "standards", "framework"]
 
+
+[project.urls]
+Homepage = "https://github.com/swarmauri/tigrbl"
+Repository = "https://github.com/swarmauri/tigrbl/tree/main/pkgs/core/tigrbl_typing"
+Issues = "https://github.com/swarmauri/tigrbl/issues"
+
 [build-system]
 requires = ["poetry-core>=1.0.0"]
 build-backend = "poetry.core.masonry.api"

{tigrbl_typing-0.1.12.dev1 → tigrbl_typing-0.1.13.dev1}/tigrbl_typing/phases.py

@@ -3,6 +3,18 @@ from __future__ import annotations
 from enum import Enum
 from typing import Literal, Tuple
 
+PHASE_ALIASES: dict[str, str] = {
+    "END_TX": "TX_COMMIT",
+    "ON_END_TX_ERROR": "ON_TX_COMMIT_ERROR",
+    "ON_ROLLBACK": "TX_ROLLBACK",
+}
+
+
+def normalize_phase(name: str | None) -> str | None:
+    if name is None:
+        return None
+    return PHASE_ALIASES.get(str(name), str(name))
+
 HookPhase = Literal[
     "PRE_TX_BEGIN",
     "START_TX",
@@ -10,7 +22,7 @@ HookPhase = Literal[
     "HANDLER",
     "POST_HANDLER",
     "PRE_COMMIT",
-    "END_TX",
+    "TX_COMMIT",
     "POST_COMMIT",
     "POST_RESPONSE",
     "ON_ERROR",
@@ -20,26 +32,28 @@ HookPhase = Literal[
     "ON_HANDLER_ERROR",
     "ON_POST_HANDLER_ERROR",
     "ON_PRE_COMMIT_ERROR",
-    "ON_END_TX_ERROR",
+    "ON_TX_COMMIT_ERROR",
     "ON_POST_COMMIT_ERROR",
     "ON_POST_RESPONSE_ERROR",
-    "ON_ROLLBACK",
+    "TX_ROLLBACK",
 ]
 
 Phase = Literal[
     "INGRESS_BEGIN",
     "INGRESS_PARSE",
-    "INGRESS_ROUTE",
+    "INGRESS_DISPATCH",
     "PRE_TX_BEGIN",
     "START_TX",
     "PRE_HANDLER",
     "HANDLER",
     "POST_HANDLER",
     "PRE_COMMIT",
-    "END_TX",
+    "TX_COMMIT",
     "POST_COMMIT",
     "EGRESS_SHAPE",
     "EGRESS_FINALIZE",
+    "EMIT",
+    "POST_EMIT",
     "POST_RESPONSE",
     "ON_ERROR",
     "ON_PRE_TX_BEGIN_ERROR",
@@ -48,10 +62,10 @@ Phase = Literal[
     "ON_HANDLER_ERROR",
     "ON_POST_HANDLER_ERROR",
     "ON_PRE_COMMIT_ERROR",
-    "ON_END_TX_ERROR",
+    "ON_TX_COMMIT_ERROR",
     "ON_POST_COMMIT_ERROR",
     "ON_POST_RESPONSE_ERROR",
-    "ON_ROLLBACK",
+    "TX_ROLLBACK",
 ]
 
 
@@ -62,7 +76,7 @@ class PHASE(str, Enum):
     HANDLER = "HANDLER"
     POST_HANDLER = "POST_HANDLER"
     PRE_COMMIT = "PRE_COMMIT"
-    END_TX = "END_TX"
+    TX_COMMIT = "TX_COMMIT"
     POST_COMMIT = "POST_COMMIT"
     POST_RESPONSE = "POST_RESPONSE"
     ON_ERROR = "ON_ERROR"
@@ -72,27 +86,36 @@ class PHASE(str, Enum):
     ON_HANDLER_ERROR = "ON_HANDLER_ERROR"
     ON_POST_HANDLER_ERROR = "ON_POST_HANDLER_ERROR"
     ON_PRE_COMMIT_ERROR = "ON_PRE_COMMIT_ERROR"
-    ON_END_TX_ERROR = "ON_END_TX_ERROR"
+    ON_TX_COMMIT_ERROR = "ON_TX_COMMIT_ERROR"
     ON_POST_COMMIT_ERROR = "ON_POST_COMMIT_ERROR"
     ON_POST_RESPONSE_ERROR = "ON_POST_RESPONSE_ERROR"
-    ON_ROLLBACK = "ON_ROLLBACK"
+    TX_ROLLBACK = "TX_ROLLBACK"
+
+    @classmethod
+    def _missing_(cls, value: object):
+        normalized = normalize_phase(str(value)) if value is not None else None
+        if normalized != value:
+            return cls(normalized)
+        return None
 
 
 HOOK_PHASES: Tuple[HookPhase, ...] = tuple(p.value for p in PHASE)
 PHASES: Tuple[Phase, ...] = (
     "INGRESS_BEGIN",
     "INGRESS_PARSE",
-    "INGRESS_ROUTE",
+    "INGRESS_DISPATCH",
     "PRE_TX_BEGIN",
     "START_TX",
     "PRE_HANDLER",
     "HANDLER",
     "POST_HANDLER",
     "PRE_COMMIT",
-    "END_TX",
+    "TX_COMMIT",
     "POST_COMMIT",
     "EGRESS_SHAPE",
     "EGRESS_FINALIZE",
+    "EMIT",
+    "POST_EMIT",
     "POST_RESPONSE",
     "ON_ERROR",
     "ON_PRE_TX_BEGIN_ERROR",
@@ -101,10 +124,39 @@ PHASES: Tuple[Phase, ...] = (
     "ON_HANDLER_ERROR",
     "ON_POST_HANDLER_ERROR",
     "ON_PRE_COMMIT_ERROR",
-    "ON_END_TX_ERROR",
+    "ON_TX_COMMIT_ERROR",
     "ON_POST_COMMIT_ERROR",
     "ON_POST_RESPONSE_ERROR",
-    "ON_ROLLBACK",
+    "TX_ROLLBACK",
 )
 
-__all__ = ["PHASE", "PHASES", "HOOK_PHASES", "Phase", "HookPhase"]
+
+def compile_protocol_phase_projection(proto: str) -> dict[str, object]:
+    stream_like = proto in {"http.stream", "https.stream", "http.sse", "https.sse"}
+    phase_order = (
+        "INGRESS_PARSE",
+        "INGRESS_DISPATCH",
+        "PRE_HANDLER",
+        "HANDLER",
+        "POST_HANDLER",
+        "EMIT",
+        "POST_EMIT",
+    )
+    if not stream_like:
+        phase_order = phase_order[:5] + ("EGRESS_SHAPE", "EGRESS_FINALIZE") + phase_order[5:]
+    return {
+        "proto": proto,
+        "phase_order": phase_order,
+        "phases": tuple({"phase": phase} for phase in phase_order),
+    }
+
+__all__ = [
+    "PHASE",
+    "PHASES",
+    "HOOK_PHASES",
+    "Phase",
+    "HookPhase",
+    "PHASE_ALIASES",
+    "compile_protocol_phase_projection",
+    "normalize_phase",
+]

{tigrbl_typing-0.1.12.dev1 → tigrbl_typing-0.1.13.dev1}/tigrbl_typing/status/utils.py

@@ -44,6 +44,17 @@ def _is_asyncpg_constraint_error(exc: BaseException) -> bool:
     )
 
 
+def is_persistence_exception(exc: BaseException) -> bool:
+    if _is_asyncpg_constraint_error(exc):
+        return True
+    candidates = tuple(
+        typ
+        for typ in (DBAPIError, IntegrityError, OperationalError)
+        if isinstance(typ, type)
+    )
+    return bool(candidates) and isinstance(exc, candidates)
+
+
 def _limit(s: str, n: int = 4000) -> str:
     return s if len(s) <= n else s[: n - 3] + "..."
 
@@ -105,6 +116,7 @@ __all__ = [
     "OperationalError",
     "NoResultFound",
     "_is_asyncpg_constraint_error",
+    "is_persistence_exception",
     "_limit",
     "_stringify_exc",
     "_format_validation",