tigrbl 0.3.7.dev2__tar.gz → 0.3.7.dev3__tar.gz

{tigrbl-0.3.7.dev2 → tigrbl-0.3.7.dev3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tigrbl
-Version: 0.3.7.dev2
+Version: 0.3.7.dev3
 Summary: A modern pure ASGI/WSGI Python framework for building schema-first REST and JSON-RPC APIs with SQLAlchemy models, typed validation, lifecycle hooks, and engine extension support.
 License-Expression: Apache-2.0
 License-File: LICENSE

{tigrbl-0.3.7.dev2 → tigrbl-0.3.7.dev3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "tigrbl"
-version = "0.3.7.dev2"
+version = "0.3.7.dev3"
 description = "A modern pure ASGI/WSGI Python framework for building schema-first REST and JSON-RPC APIs with SQLAlchemy models, typed validation, lifecycle hooks, and engine extension support."
 license = "Apache-2.0"
 readme = "README.md"

{tigrbl-0.3.7.dev2 → tigrbl-0.3.7.dev3}/tigrbl/__init__.py

@@ -43,8 +43,8 @@ from .op import alias_ctx, op_ctx, alias, op_alias
 from .hook import hook_ctx
 from .engine.decorators import engine_ctx
 from .schema.decorators import schema_ctx
-from .response.decorators import response_ctx
-from .response.types import ResponseSpec
+from .responses.decorators import response_ctx
+from .responses.types import ResponseSpec
 
 # ── Bindings (model + API orchestration) ───────────────────────────────────────
 from .bindings import (

{tigrbl-0.3.7.dev2 → tigrbl-0.3.7.dev3}/tigrbl/api/_router.py

@@ -37,7 +37,7 @@ from tigrbl.transport.httpx import ensure_httpx_sync_transport
 from ._route import Route
 from ..system.docs.openapi import build_openapi, mount_openapi
 from ..system.docs.swagger import mount_swagger
-from ..requests._request import Request
+from ..requests import Request
 from ..transport.rest.decorators import (
     delete as rest_delete,
     get as rest_get,

{tigrbl-0.3.7.dev2 → tigrbl-0.3.7.dev3}/tigrbl/api/api_spec.py

@@ -3,7 +3,7 @@ from __future__ import annotations
 from dataclasses import dataclass, field
 from typing import Any, Callable, Optional, Sequence
 from ..engine.engine_spec import EngineCfg
-from ..response.types import ResponseSpec
+from ..responses.types import ResponseSpec
 
 
 @dataclass

{tigrbl-0.3.7.dev2 → tigrbl-0.3.7.dev3}/tigrbl/app/app_spec.py

@@ -4,7 +4,7 @@ from dataclasses import dataclass, field
 from typing import Any, Callable, Optional, Sequence
 
 from ..engine.engine_spec import EngineCfg
-from ..response.types import ResponseSpec
+from ..responses.types import ResponseSpec
 
 
 @dataclass(eq=False)

{tigrbl-0.3.7.dev2 → tigrbl-0.3.7.dev3}/tigrbl/bindings/__init__.py

@@ -46,7 +46,7 @@ from .hooks import normalize_and_attach as build_hooks
 from .handlers import build_and_attach as build_handlers
 from .rpc import register_and_attach as register_rpc
 from .rest import build_router_and_attach as build_rest
-from ..response.bind import bind as bind_response
+from ..responses.bind import bind as bind_response
 
 # API facade integration
 from .api import include_model, include_models, rpc_call

{tigrbl-0.3.7.dev2 → tigrbl-0.3.7.dev3}/tigrbl/bindings/rest/common.py

@@ -13,11 +13,11 @@ from pydantic import BaseModel
 
 from ...api._api import APIRouter as Router
 from ...core.crud.params import Body, Path, Query
-from ...responses._response import Response
+from ...responses import Response
 from ...runtime.status.exceptions import HTTPException
 from ...runtime.status.mappings import status as _status
 from ...security.dependencies import Depends, Security
-from ...requests._request import Request
+from ...requests import Request
 from .helpers import (
     _Key,
     _coerce_parent_kw,

{tigrbl-0.3.7.dev2 → tigrbl-0.3.7.dev3}/tigrbl/bindings/rest/fastapi.py

@@ -1,9 +1,9 @@
 """Deprecated compatibility module for REST ASGI-style primitives.
 
 Prefer importing directly from:
-- ``tigrbl.response`` for response classes
+- ``tigrbl.responses`` for response classes
 - ``tigrbl.runtime.status`` for ``status`` and ``HTTPException``
-- ``tigrbl.api._api`` / ``tigrbl.requests._request`` / ``tigrbl.security.dependencies``
+- ``tigrbl.api._api`` / ``tigrbl.requests`` / ``tigrbl.security.dependencies``
 """
 
 from __future__ import annotations
@@ -21,11 +21,11 @@ from ...response import (
 )
 from ...runtime.status import HTTPException, status
 from ...security.dependencies import Depends, Security
-from ...requests._request import Request
+from ...requests import Request
 
 warnings.warn(
     "tigrbl.bindings.rest.asgi is deprecated; import from "
-    "tigrbl.response, tigrbl.runtime.status, and concrete modules instead.",
+    "tigrbl.responses, tigrbl.runtime.status, and concrete modules instead.",
     DeprecationWarning,
     stacklevel=2,
 )

{tigrbl-0.3.7.dev2 → tigrbl-0.3.7.dev3}/tigrbl/bindings/rest/helpers.py

@@ -4,7 +4,7 @@ import logging
 from types import SimpleNamespace
 from typing import Any, Awaitable, Callable, Dict, Mapping, Sequence, Tuple
 
-from ...requests._request import Request
+from ...requests import Request
 from ...op.types import PHASES
 
 try:

{tigrbl-0.3.7.dev2 → tigrbl-0.3.7.dev3}/tigrbl/bindings/rest/io.py

@@ -12,7 +12,7 @@ from pydantic import BaseModel, Field, create_model
 from ...core.crud.params import Query
 from ...runtime.status.exceptions import HTTPException
 from ...runtime.status.mappings import status as _status
-from ...requests._request import Request
+from ...requests import Request
 from .helpers import _ensure_jsonable
 from ...op import OpSpec
 

{tigrbl-0.3.7.dev2 → tigrbl-0.3.7.dev3}/tigrbl/bindings/rest/routing.py

@@ -9,7 +9,7 @@ from typing import Any, Dict, Optional, Sequence, Tuple
 from ...runtime.status.exceptions import HTTPException
 from ...runtime.status.mappings import status as _status
 from ...security.dependencies import Depends, Security
-from ...requests._request import Request
+from ...requests import Request
 from ...op import OpSpec
 from ...security import HTTPBearer
 from ...op.types import CANON

{tigrbl-0.3.7.dev2 → tigrbl-0.3.7.dev3}/tigrbl/core/resolver.py

@@ -7,7 +7,7 @@ from typing import Annotated, Any, Iterable, get_args, get_origin
 from ..core.crud.params import Param
 from ..runtime.status.exceptions import HTTPException
 from ..runtime.status.mappings import status
-from ..requests._request import Request
+from ..requests import Request
 
 
 def split_annotated(annotation: Any) -> tuple[Any, tuple[Any, ...]]:

{tigrbl-0.3.7.dev2 → tigrbl-0.3.7.dev3}/tigrbl/core/router_runtime.py

@@ -10,10 +10,10 @@ from ..api.resolve import (
     resolve_handler_kwargs,
     resolve_route_dependencies,
 )
-from ..responses._response import Response
+from ..responses import Response
 from ..runtime.status.exceptions import HTTPException
 from ..runtime.status.mappings import status
-from ..requests._request import Request
+from ..requests import Request
 
 
 def _is_http_response_like(obj: Any) -> bool:

tigrbl-0.3.7.dev3/tigrbl/headers/__init__.py

@@ -0,0 +1,3 @@
+from ._header import HeaderCookies, Headers
+
+__all__ = ["Headers", "HeaderCookies"]

{tigrbl-0.3.7.dev2 → tigrbl-0.3.7.dev3}/tigrbl/headers/_header.py

@@ -3,6 +3,17 @@
 from __future__ import annotations
 
 from collections.abc import Iterable, Mapping, MutableMapping
+from http.cookies import SimpleCookie
+
+
+class HeaderCookies(dict[str, str]):
+    """Dot-addressable cookie mapping parsed from a Cookie header value."""
+
+    def __getattr__(self, name: str) -> str:
+        try:
+            return self[name]
+        except KeyError as exc:  # pragma: no cover - defensive
+            raise AttributeError(name) from exc
 
 
 class Headers(MutableMapping[str, str]):
@@ -24,6 +35,12 @@ class Headers(MutableMapping[str, str]):
     def _attribute_key(name: str) -> str:
         return name.replace("_", "-").lower()
 
+    @staticmethod
+    def _parse_cookie_header(value: str) -> HeaderCookies:
+        parsed = SimpleCookie()
+        parsed.load(value)
+        return HeaderCookies({name: morsel.value for name, morsel in parsed.items()})
+
     def __getitem__(self, key: str) -> str:
         return self._data[key.lower()][1]
 
@@ -53,11 +70,14 @@ class Headers(MutableMapping[str, str]):
             return default
         return item[1]
 
-    def __getattr__(self, name: str) -> str:
+    def __getattr__(self, name: str) -> str | HeaderCookies:
         key = self._attribute_key(name)
-        if key in self._data:
-            return self._data[key][1]
-        raise AttributeError(name)
+        if key not in self._data:
+            raise AttributeError(name)
+        value = self._data[key][1]
+        if key == "cookie":
+            return self._parse_cookie_header(value)
+        return value
 
     def __setattr__(self, name: str, value: str) -> None:
         if name.startswith("_"):
@@ -66,4 +86,4 @@ class Headers(MutableMapping[str, str]):
         self[self._attribute_key(name)] = value
 
 
-__all__ = ["Headers"]
+__all__ = ["Headers", "HeaderCookies"]

{tigrbl-0.3.7.dev2 → tigrbl-0.3.7.dev3}/tigrbl/op/types.py

@@ -8,7 +8,7 @@ from typing import Any, Literal, Mapping, Optional, Tuple, cast
 from ..config.constants import CANON as CANONICAL_VERB_TUPLE
 from ..hook.types import PHASE, HookPhase, PHASES, Ctx, StepFn, HookPredicate
 from ..hook import HookSpec as OpHook
-from ..response.types import ResponseSpec
+from ..responses.types import ResponseSpec
 from ..engine.engine_spec import EngineCfg
 from typing import TYPE_CHECKING
 

tigrbl-0.3.7.dev3/tigrbl/requests/__init__.py

@@ -0,0 +1,5 @@
+from tigrbl.headers import Headers
+
+from ._request import AwaitableValue, Request, URL
+
+__all__ = ["Headers", "Request", "AwaitableValue", "URL"]

{tigrbl-0.3.7.dev2 → tigrbl-0.3.7.dev3}/tigrbl/requests/_request.py

@@ -2,13 +2,14 @@
 
 from __future__ import annotations
 
+import base64
 import json as json_module
 from dataclasses import dataclass, field
 from http.cookies import SimpleCookie
 from types import SimpleNamespace
 from typing import Any
 
-from tigrbl.headers import Headers
+from tigrbl.headers import HeaderCookies, Headers
 
 
 @dataclass(frozen=True)
@@ -64,6 +65,15 @@ class AwaitableValue:
         return len(self.value)
 
 
+def _b64url_encode(data: bytes) -> str:
+    return base64.urlsafe_b64encode(data).decode("ascii").rstrip("=")
+
+
+def _b64url_decode(data: str) -> bytes:
+    pad = "=" * (-len(data) % 4)
+    return base64.urlsafe_b64decode((data + pad).encode("ascii"))
+
+
 @dataclass
 class Request:
     method: str
@@ -111,11 +121,45 @@ class Request:
         return {name: vals[0] for name, vals in self.query.items() if vals}
 
     @property
-    def cookies(self) -> dict[str, str]:
+    def cookies(self) -> HeaderCookies:
         raw = self.headers.get("cookie", "") or ""
         parsed = SimpleCookie()
         parsed.load(raw)
-        return {name: morsel.value for name, morsel in parsed.items()}
+        return HeaderCookies({name: morsel.value for name, morsel in parsed.items()})
 
+    @property
+    def bearer_token(self) -> str | None:
+        authorization = self.headers.get("authorization", "") or ""
+        scheme, _, token = authorization.partition(" ")
+        if scheme.lower() == "bearer" and token:
+            return token
+        return None
+
+    @property
+    def session_token(self) -> str | None:
+        bearer = self.bearer_token
+        if bearer:
+            return bearer
+        return self.cookies.get("sid")
 
-__all__ = ["Request", "AwaitableValue", "URL"]
+    @property
+    def client(self) -> SimpleNamespace:
+        host = ""
+        try:
+            client = self.scope.get("client")
+        except AttributeError:
+            client = None
+        if isinstance(client, tuple) and client:
+            host = str(client[0])
+        return SimpleNamespace(ip=host, host=host)
+
+    @staticmethod
+    def b64url_encode(data: bytes) -> str:
+        return _b64url_encode(data)
+
+    @staticmethod
+    def b64url_decode(data: str) -> bytes:
+        return _b64url_decode(data)
+
+
+__all__ = ["Request", "AwaitableValue", "URL", "_b64url_encode", "_b64url_decode"]

{tigrbl-0.3.7.dev2/tigrbl/response → tigrbl-0.3.7.dev3/tigrbl/responses}/__init__.py

@@ -1,31 +1,29 @@
-from ..responses._response import (
-    Response as StdApiResponse,
-    JSONResponse,
+from tigrbl.headers import Headers
+
+from ._response import (
+    FileResponse,
     HTMLResponse,
+    JSONResponse,
     PlainTextResponse,
-    StreamingResponse,
-    FileResponse,
     RedirectResponse,
+    Response,
+    StreamingResponse,
 )
 from .decorators import (
-    response_ctx,
-    get_attached_response_spec,
     get_attached_response_alias,
+    get_attached_response_spec,
+    response_ctx,
 )
-from .types import (
-    Response,
-    ResponseKind,
-    ResponseSpec,
-    Template,
-    TemplateSpec,
-)
-from .resolver import resolve_response_spec, infer_hints
-from .shortcuts import as_json, as_html, as_text, as_redirect, as_stream, as_file
+from .resolver import infer_hints, resolve_response_spec
+from .shortcuts import as_file, as_html, as_json, as_redirect, as_stream, as_text
+from .types import Response as ResponseConfig
+from .types import ResponseKind, ResponseSpec, Template, TemplateSpec
 from ..runtime.atoms.response.renderer import ResponseHints, render
 from ..runtime.atoms.response.templates import render_template
 
 __all__ = [
-    "StdApiResponse",
+    "Headers",
+    "Response",
     "JSONResponse",
     "HTMLResponse",
     "PlainTextResponse",
@@ -38,7 +36,7 @@ __all__ = [
     "ResponseSpec",
     "ResponseKind",
     "TemplateSpec",
-    "Response",
+    "ResponseConfig",
     "Template",
     "resolve_response_spec",
     "infer_hints",

{tigrbl-0.3.7.dev2 → tigrbl-0.3.7.dev3}/tigrbl/responses/_response.py

@@ -9,7 +9,26 @@ from http.cookies import SimpleCookie
 from pathlib import Path
 from typing import Any, AsyncIterator, Iterable, Mapping
 
-from tigrbl.headers import Headers
+from tigrbl.headers import HeaderCookies, Headers
+
+
+class _JSONDualMethod:
+    def __get__(self, obj: "Response" | None, owner: type["Response"]):
+        if obj is None:
+
+            def _factory(
+                data: Any,
+                status_code: int = 200,
+                headers: Mapping[str, str] | None = None,
+            ) -> "Response":
+                return owner.from_json(data, status_code=status_code, headers=headers)
+
+            return _factory
+
+        def _instance_json() -> Any:
+            return obj.json_body()
+
+        return _instance_json
 
 
 @dataclass
@@ -20,6 +39,8 @@ class Response:
     media_type: str | None = None
     _headers: Headers = field(init=False, repr=False)
 
+    json = _JSONDualMethod()
+
     def __post_init__(self) -> None:
         self._headers = Headers(self.headers)
 
@@ -28,6 +49,7 @@ class Response:
         return {
             200: "OK",
             201: "Created",
+            205: "Reset Content",
             204: "No Content",
             301: "Moved Permanently",
             302: "Found",
@@ -65,12 +87,12 @@ class Response:
         return json_module.loads(self.body.decode("utf-8"))
 
     @property
-    def cookies(self) -> dict[str, str]:
+    def cookies(self) -> HeaderCookies:
         cookie = SimpleCookie()
         for name, value in self._headers.items():
             if name == "set-cookie":
                 cookie.load(value)
-        return {name: morsel.value for name, morsel in cookie.items()}
+        return HeaderCookies({name: morsel.value for name, morsel in cookie.items()})
 
     def set_cookie(self, key: str, value: str, *, path: str = "/") -> None:
         cookie = SimpleCookie()
@@ -80,7 +102,7 @@ class Response:
         self.headers = self._headers.as_list()
 
     @classmethod
-    def json(
+    def from_json(
         cls,
         data: Any,
         status_code: int = 200,

{tigrbl-0.3.7.dev2/tigrbl/response → tigrbl-0.3.7.dev3/tigrbl/responses}/shortcuts.py

@@ -8,7 +8,7 @@ from datetime import datetime, timezone
 from pathlib import Path
 from typing import Any, AsyncIterable, Iterable, Mapping, Optional, Union
 
-from .stdapi import (
+from ._response import (
     FileResponse,
     HTMLResponse,
     JSONResponse,

{tigrbl-0.3.7.dev2 → tigrbl-0.3.7.dev3}/tigrbl/runtime/atoms/response/headers_from_payload.py

@@ -13,7 +13,7 @@ def run(_, ctx) -> None:
     - Honors op-specific exposure via ``io.out_verbs``.
     Complexity: O(#fields in opview).
     """
-    from tigrbl.response import ResponseHints
+    from tigrbl.responses import ResponseHints
 
     resp = getattr(ctx, "response", None)
     if resp is None:

{tigrbl-0.3.7.dev2 → tigrbl-0.3.7.dev3}/tigrbl/runtime/atoms/response/renderer.py

@@ -4,10 +4,10 @@ from pathlib import Path
 from typing import Any, AsyncIterable, Iterable, Mapping, Optional, Union, cast
 import logging
 
-from ....responses._response import Response
+from ....responses import Response
 from ....transport.background import BackgroundTask
 
-from ....response.shortcuts import (
+from ....responses.shortcuts import (
     as_file,
     as_html,
     as_json,

{tigrbl-0.3.7.dev2 → tigrbl-0.3.7.dev3}/tigrbl/runtime/atoms/response/templates.py

@@ -3,7 +3,7 @@ from functools import lru_cache
 import logging
 from typing import Any, Dict, Iterable, Optional, Tuple
 
-from ....requests._request import Request
+from ....requests import Request
 from ....deps.jinja import (
     Environment,
     FileSystemLoader,

{tigrbl-0.3.7.dev2 → tigrbl-0.3.7.dev3}/tigrbl/runtime/executor/types.py

@@ -14,7 +14,7 @@ from typing import (
     runtime_checkable,
 )
 
-from ...requests._request import Request
+from ...requests import Request
 from sqlalchemy.ext.asyncio import AsyncSession
 from sqlalchemy.orm import Session
 

{tigrbl-0.3.7.dev2 → tigrbl-0.3.7.dev3}/tigrbl/system/diagnostics/compat.py

@@ -4,7 +4,7 @@ from typing import Any, Callable, Sequence
 from types import SimpleNamespace
 
 try:
-    from ...responses._response import JSONResponse
+    from ...responses import JSONResponse
     from ...types import Depends, Request, Router
 except Exception:  # pragma: no cover
 

{tigrbl-0.3.7.dev2 → tigrbl-0.3.7.dev3}/tigrbl/system/docs/lens.py

@@ -3,7 +3,7 @@ from __future__ import annotations
 from typing import Any
 from urllib.parse import quote
 
-from ...responses._response import Response
+from ...responses import Response
 
 
 TIGRBL_LENS_VERSION = "0.0.14"

{tigrbl-0.3.7.dev2 → tigrbl-0.3.7.dev3}/tigrbl/system/docs/openapi/mount.py

@@ -2,7 +2,7 @@ from __future__ import annotations
 
 from typing import Any
 
-from ....responses._response import Response
+from ....responses import Response
 from .schema import openapi
 
 

{tigrbl-0.3.7.dev2 → tigrbl-0.3.7.dev3}/tigrbl/system/docs/openrpc.py

@@ -4,7 +4,7 @@ from typing import Any, Dict, Iterable, List, Mapping, Sequence
 
 from pydantic import BaseModel
 
-from ...responses._response import Response
+from ...responses import Response
 from ...op import OpSpec
 
 JsonObject = Dict[str, Any]

{tigrbl-0.3.7.dev2 → tigrbl-0.3.7.dev3}/tigrbl/system/docs/swagger.py

@@ -2,7 +2,7 @@ from __future__ import annotations
 
 from typing import Any
 
-from ...responses._response import Response
+from ...responses import Response
 
 
 def build_swagger_html(router: Any, request: Any) -> str:

{tigrbl-0.3.7.dev2 → tigrbl-0.3.7.dev3}/tigrbl/system/favicon/__init__.py

@@ -3,7 +3,7 @@ from __future__ import annotations
 from pathlib import Path
 from typing import Any
 
-from ...responses._response import FileResponse
+from ...responses import FileResponse
 
 FAVICON_PATH = Path(__file__).with_name("assets") / "favicon.svg"
 

{tigrbl-0.3.7.dev2 → tigrbl-0.3.7.dev3}/tigrbl/table/_base.py

@@ -379,7 +379,7 @@ class Base(DeclarativeBase):
 
         # 2.6) Collect response specs declared via @response_ctx
         try:
-            from tigrbl.response import (
+            from tigrbl.responses import (
                 get_attached_response_spec,
                 get_attached_response_alias,
             )

{tigrbl-0.3.7.dev2 → tigrbl-0.3.7.dev3}/tigrbl/table/table_spec.py

@@ -4,7 +4,7 @@ from dataclasses import dataclass, field
 from typing import Any, Callable, Optional, Sequence
 
 from ..engine.engine_spec import EngineCfg
-from ..response.types import ResponseSpec
+from ..responses.types import ResponseSpec
 
 
 @dataclass