PyPI - tigrcorn-runtime - Versions diffs - 0.3.16.dev5__tar.gz → 0.3.16.dev12__tar.gz - Mend

tigrcorn-runtime 0.3.16.dev5tar.gz → 0.3.16.dev12tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (33) hide show

{tigrcorn_runtime-0.3.16.dev5/src/tigrcorn_runtime.egg-info → tigrcorn_runtime-0.3.16.dev12}/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tigrcorn-runtime
-Version: 0.3.16.dev5
+Version: 0.3.16.dev12
 Summary: Server runner, app loading, lifecycle hooks, workers, reload, and embedded runtime for the Tigrcorn ASGI3 web server.
 Author-email: Jacob Stewart <jacob@swarmauri.com>
 License: Apache License
@@ -175,22 +175,24 @@ Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Internet :: WWW/HTTP
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: System :: Networking
 Classifier: Typing :: Typed
-Requires-Python: >=3.11
+Requires-Python: <3.15,>=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: tigrcorn-core==0.3.16.dev5
-Requires-Dist: tigrcorn-config==0.3.16.dev5
-Requires-Dist: tigrcorn-asgi==0.3.16.dev5
-Requires-Dist: tigrcorn-transports==0.3.16.dev5
-Requires-Dist: tigrcorn-protocols==0.3.16.dev5
-Requires-Dist: tigrcorn-security==0.3.16.dev5
+Requires-Dist: tigrcorn-core==0.3.16.dev12
+Requires-Dist: tigrcorn-config==0.3.16.dev12
+Requires-Dist: tigrcorn-asgi==0.3.16.dev12
+Requires-Dist: tigrcorn-transports==0.3.16.dev12
+Requires-Dist: tigrcorn-protocols==0.3.16.dev12
+Requires-Dist: tigrcorn-security==0.3.16.dev12
 Provides-Extra: uvloop
 Requires-Dist: uvloop>=0.19.0; platform_system != "Windows" and extra == "uvloop"
 Provides-Extra: trio
@@ -199,47 +201,106 @@ Dynamic: license-file
 <div align="center">
 <h1>tigrcorn-runtime</h1>
+<img
+  src="https://raw.githubusercontent.com/Tigrbl/tigrcorn/master/assets/tigrcorn_logo.png"
+  alt="Tigrcorn tiger-unicorn logo"
+  width="140"
+/>
 <p><strong>Server runner, app loading, lifecycle hooks, workers, reload, and embedded runtime for the Tigrcorn ASGI3 web server.</strong></p>
 <a href="https://pypi.org/project/tigrcorn-runtime/"><img alt="PyPI version for tigrcorn-runtime" src="https://img.shields.io/pypi/v/tigrcorn-runtime?label=PyPI"></a>
 <a href="https://pypi.org/project/tigrcorn-runtime/"><img alt="tigrcorn-runtime package on PyPI" src="https://img.shields.io/badge/package-PyPI-blue"></a>
+<a href="https://pepy.tech/project/tigrcorn-runtime"><img alt="Downloads for tigrcorn-runtime" src="https://static.pepy.tech/badge/tigrcorn-runtime"></a>
+<a href="https://github.com/tigrbl/tigrcorn/blob/master/pkgs/tigrcorn-runtime/README.md"><img alt="Hits for tigrcorn-runtime README" src="https://hits.sh/github.com/tigrbl/tigrcorn/blob/master/pkgs/tigrcorn-runtime/README.md.svg?label=hits"></a>
 <a href="LICENSE"><img alt="Apache 2.0 license" src="https://img.shields.io/badge/license-Apache%202.0-525252"></a>
-<a href="pyproject.toml"><img alt="Python 3.11 supported" src="https://img.shields.io/badge/python-3.11-3776ab"></a>
-<a href="pyproject.toml"><img alt="Python 3.12 supported" src="https://img.shields.io/badge/python-3.12-3776ab"></a>
-<a href="pyproject.toml"><img alt="Python 3.13 supported" src="https://img.shields.io/badge/python-3.13-3776ab"></a>
-<a href="src/tigrcorn_runtime/py.typed"><img alt="typed package" src="https://img.shields.io/badge/typed-py.typed-2f7ed8"></a>
+<a href="pyproject.toml"><img alt="Python 3.10 | 3.11 | 3.12 | 3.13 | 3.14 supported" src="https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-3776ab"></a>
 <a href="https://pypi.org/project/tigrcorn-runtime/"><img alt="runtime role package" src="https://img.shields.io/badge/role-runtime-0a7f5a"></a>
 </div>
+<p align="center"><a href="https://github.com/Tigrbl/tigrcorn/blob/master/.ssot/registry.json"><img alt="SSOT governed" src="https://img.shields.io/badge/SSOT-governed-2f6f4e.svg"></a> <a href="https://discord.gg/jzvrbEtTtt"><img alt="Discord" src="https://img.shields.io/badge/Discord-Join%20chat-5865F2?logo=discord&amp;logoColor=white"></a></p>
 ## Install
-~~~bash
+```bash
+uv add tigrcorn-runtime
+```
+```bash
 pip install tigrcorn-runtime
-~~~
+```
 Use the aggregate [tigrcorn](https://pypi.org/project/tigrcorn/) distribution when you want the full ASGI3 Python web server stack. Install <code>tigrcorn-runtime</code> directly when you want only this package boundary and its declared dependencies.
 ## What It Owns
-<code>tigrcorn-runtime</code> owns server runner, app loading, bootstrap, signals, shutdown, workers, embedding, reload, and CLI-facing runtime orchestration. Its import package is <code>tigrcorn_runtime</code>, and its declared package dependencies are: tigrcorn-core, tigrcorn-config, tigrcorn-asgi, tigrcorn-transports, tigrcorn-protocols, tigrcorn-security.
+<code>tigrcorn-runtime</code> owns server runner, app loading, bootstrap, signals, shutdown, workers, embedding, and cli. Its import package is <code>tigrcorn_runtime</code>, and its declared package dependencies are: tigrcorn-core, tigrcorn-config, tigrcorn-asgi, tigrcorn-transports, tigrcorn-protocols, tigrcorn-security.
+This package page is written for developers searching for Tigrcorn ASGI3 server components, Python web server packages, HTTP/3 and QUIC support, WebSocket and WebTransport-adjacent surfaces, and Apache 2.0 licensed infrastructure.
+## Why Use This?
+Use <code>tigrcorn-runtime</code> when you want the runtime layer as a direct install target instead of the full server bundle. It lets application, operator, or certification workflows depend on this boundary explicitly while keeping the broader Tigrcorn runtime assembled from smaller repo-owned package surfaces.
+## FAQ
+### What does this package export?
+The package exports through the <code>tigrcorn_runtime</code> namespace and keeps the root <code>tigrcorn</code> package as the compatibility umbrella.
+### Which boundary does this package own?
+It is the package boundary for server runner, app loading, bootstrap, signals, shutdown, workers, embedding, and cli in the Tigrcorn package graph.
-This package page is written for developers searching for Tigrcorn ASGI3 server components, Python web server packages, HTTP/3 and QUIC support, WebSocket and WebTransport runtime surfaces, typed package boundaries, and Apache 2.0 licensed infrastructure.
+### What should be imported from the runtime package first?
+Start with run, serve, or serve_import_string when you need the packaged server entrypoints, embedded runtime orchestration, bootstrap flow, or worker lifecycle management.
+## Features
+- Owns server runner, app loading, bootstrap, signals, shutdown, workers, embedding, and cli inside the Tigrcorn split-package architecture.
+- Publishes the <code>tigrcorn_runtime</code> import surface for named public helpers and entrypoints.
+- Declared runtime dependencies: tigrcorn-core, tigrcorn-config, tigrcorn-asgi, tigrcorn-transports, tigrcorn-protocols, tigrcorn-security.
+- Optional dependency surface: uvloop, trio.
+- Supports Python 3.10, 3.11, 3.12, 3.13, and 3.14.
 ## Use It When
-Use <code>tigrcorn-runtime</code> when you need to run, embed, supervise, or lifecycle-manage Tigrcorn as an ASGI3 Python web server. It is part of Tigrcorn's split-package architecture, so it can be installed independently while remaining linked to the rest of the Tigrcorn package family on PyPI.
+Use <code>tigrcorn-runtime</code> when you need runtime-level behavior without pulling the entire server stack into the import surface. It is part of Tigrcorn's split-package architecture, so it can be installed independently while remaining linked to the rest of the Tigrcorn package family on PyPI.
 ## Import Surface
-~~~python
-import tigrcorn_runtime
+```python
+from tigrcorn_runtime import run
-print(tigrcorn_runtime.__name__)
-~~~
+print(run.__name__)
+```
+Namespace discovery starts with `import tigrcorn_runtime`.
 The package exposes its supported public surface through the <code>tigrcorn_runtime</code> namespace. The root [tigrcorn](https://pypi.org/project/tigrcorn/) package keeps compatibility shims for users who install the full server distribution.
+## Related Packages
+- [tigrcorn-core](https://pypi.org/project/tigrcorn-core/)
+- [tigrcorn-config](https://pypi.org/project/tigrcorn-config/)
+- [tigrcorn-asgi](https://pypi.org/project/tigrcorn-asgi/)
+- [tigrcorn-transports](https://pypi.org/project/tigrcorn-transports/)
+- [tigrcorn-protocols](https://pypi.org/project/tigrcorn-protocols/)
+- [tigrcorn-security](https://pypi.org/project/tigrcorn-security/)
+- [tigrcorn](https://pypi.org/project/tigrcorn/)
+- [tigrcorn-compat](https://pypi.org/project/tigrcorn-compat/)
 ## Package Graph
-[tigrcorn](https://pypi.org/project/tigrcorn/) | [tigrcorn-core](https://pypi.org/project/tigrcorn-core/) | [tigrcorn-config](https://pypi.org/project/tigrcorn-config/) | [tigrcorn-asgi](https://pypi.org/project/tigrcorn-asgi/) | [tigrcorn-contract](https://pypi.org/project/tigrcorn-contract/) | [tigrcorn-transports](https://pypi.org/project/tigrcorn-transports/) | [tigrcorn-protocols](https://pypi.org/project/tigrcorn-protocols/) | [tigrcorn-http](https://pypi.org/project/tigrcorn-http/) | [tigrcorn-security](https://pypi.org/project/tigrcorn-security/) | [tigrcorn-runtime](https://pypi.org/project/tigrcorn-runtime/) | [tigrcorn-static](https://pypi.org/project/tigrcorn-static/) | [tigrcorn-observability](https://pypi.org/project/tigrcorn-observability/) | [tigrcorn-compat](https://pypi.org/project/tigrcorn-compat/) | [tigrcorn-certification](https://pypi.org/project/tigrcorn-certification/)
+[tigrcorn-core](https://pypi.org/project/tigrcorn-core/) | [tigrcorn-config](https://pypi.org/project/tigrcorn-config/) | [tigrcorn-http](https://pypi.org/project/tigrcorn-http/) | [tigrcorn-asgi](https://pypi.org/project/tigrcorn-asgi/) | [tigrcorn-contract](https://pypi.org/project/tigrcorn-contract/) | [tigrcorn-transports](https://pypi.org/project/tigrcorn-transports/) | [tigrcorn-security](https://pypi.org/project/tigrcorn-security/) | [tigrcorn-protocols](https://pypi.org/project/tigrcorn-protocols/) | [tigrcorn-static](https://pypi.org/project/tigrcorn-static/) | [tigrcorn-observability](https://pypi.org/project/tigrcorn-observability/) | [tigrcorn-runtime](https://pypi.org/project/tigrcorn-runtime/) | [tigrcorn-compat](https://pypi.org/project/tigrcorn-compat/) | [tigrcorn-certification](https://pypi.org/project/tigrcorn-certification/)
+## Best Practices
+- Use this package when you need the packaged server entrypoints or embedded runtime orchestration.
+- Keep worker, reload, and bootstrap behavior documented here before surfacing it at the repo root.
+- Use config, protocol, transport, and security packages as inputs instead of re-owning those concerns in runtime code.
+## License
+Apache-2.0

tigrcorn_runtime-0.3.16.dev12/README.md ADDED Viewed

@@ -0,0 +1,105 @@
+<div align="center">
+<h1>tigrcorn-runtime</h1>
+<img
+  src="https://raw.githubusercontent.com/Tigrbl/tigrcorn/master/assets/tigrcorn_logo.png"
+  alt="Tigrcorn tiger-unicorn logo"
+  width="140"
+/>
+<p><strong>Server runner, app loading, lifecycle hooks, workers, reload, and embedded runtime for the Tigrcorn ASGI3 web server.</strong></p>
+<a href="https://pypi.org/project/tigrcorn-runtime/"><img alt="PyPI version for tigrcorn-runtime" src="https://img.shields.io/pypi/v/tigrcorn-runtime?label=PyPI"></a>
+<a href="https://pypi.org/project/tigrcorn-runtime/"><img alt="tigrcorn-runtime package on PyPI" src="https://img.shields.io/badge/package-PyPI-blue"></a>
+<a href="https://pepy.tech/project/tigrcorn-runtime"><img alt="Downloads for tigrcorn-runtime" src="https://static.pepy.tech/badge/tigrcorn-runtime"></a>
+<a href="https://github.com/tigrbl/tigrcorn/blob/master/pkgs/tigrcorn-runtime/README.md"><img alt="Hits for tigrcorn-runtime README" src="https://hits.sh/github.com/tigrbl/tigrcorn/blob/master/pkgs/tigrcorn-runtime/README.md.svg?label=hits"></a>
+<a href="LICENSE"><img alt="Apache 2.0 license" src="https://img.shields.io/badge/license-Apache%202.0-525252"></a>
+<a href="pyproject.toml"><img alt="Python 3.10 | 3.11 | 3.12 | 3.13 | 3.14 supported" src="https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-3776ab"></a>
+<a href="https://pypi.org/project/tigrcorn-runtime/"><img alt="runtime role package" src="https://img.shields.io/badge/role-runtime-0a7f5a"></a>
+</div>
+<p align="center"><a href="https://github.com/Tigrbl/tigrcorn/blob/master/.ssot/registry.json"><img alt="SSOT governed" src="https://img.shields.io/badge/SSOT-governed-2f6f4e.svg"></a> <a href="https://discord.gg/jzvrbEtTtt"><img alt="Discord" src="https://img.shields.io/badge/Discord-Join%20chat-5865F2?logo=discord&amp;logoColor=white"></a></p>
+## Install
+```bash
+uv add tigrcorn-runtime
+```
+```bash
+pip install tigrcorn-runtime
+```
+Use the aggregate [tigrcorn](https://pypi.org/project/tigrcorn/) distribution when you want the full ASGI3 Python web server stack. Install <code>tigrcorn-runtime</code> directly when you want only this package boundary and its declared dependencies.
+## What It Owns
+<code>tigrcorn-runtime</code> owns server runner, app loading, bootstrap, signals, shutdown, workers, embedding, and cli. Its import package is <code>tigrcorn_runtime</code>, and its declared package dependencies are: tigrcorn-core, tigrcorn-config, tigrcorn-asgi, tigrcorn-transports, tigrcorn-protocols, tigrcorn-security.
+This package page is written for developers searching for Tigrcorn ASGI3 server components, Python web server packages, HTTP/3 and QUIC support, WebSocket and WebTransport-adjacent surfaces, and Apache 2.0 licensed infrastructure.
+## Why Use This?
+Use <code>tigrcorn-runtime</code> when you want the runtime layer as a direct install target instead of the full server bundle. It lets application, operator, or certification workflows depend on this boundary explicitly while keeping the broader Tigrcorn runtime assembled from smaller repo-owned package surfaces.
+## FAQ
+### What does this package export?
+The package exports through the <code>tigrcorn_runtime</code> namespace and keeps the root <code>tigrcorn</code> package as the compatibility umbrella.
+### Which boundary does this package own?
+It is the package boundary for server runner, app loading, bootstrap, signals, shutdown, workers, embedding, and cli in the Tigrcorn package graph.
+### What should be imported from the runtime package first?
+Start with run, serve, or serve_import_string when you need the packaged server entrypoints, embedded runtime orchestration, bootstrap flow, or worker lifecycle management.
+## Features
+- Owns server runner, app loading, bootstrap, signals, shutdown, workers, embedding, and cli inside the Tigrcorn split-package architecture.
+- Publishes the <code>tigrcorn_runtime</code> import surface for named public helpers and entrypoints.
+- Declared runtime dependencies: tigrcorn-core, tigrcorn-config, tigrcorn-asgi, tigrcorn-transports, tigrcorn-protocols, tigrcorn-security.
+- Optional dependency surface: uvloop, trio.
+- Supports Python 3.10, 3.11, 3.12, 3.13, and 3.14.
+## Use It When
+Use <code>tigrcorn-runtime</code> when you need runtime-level behavior without pulling the entire server stack into the import surface. It is part of Tigrcorn's split-package architecture, so it can be installed independently while remaining linked to the rest of the Tigrcorn package family on PyPI.
+## Import Surface
+```python
+from tigrcorn_runtime import run
+print(run.__name__)
+```
+Namespace discovery starts with `import tigrcorn_runtime`.
+The package exposes its supported public surface through the <code>tigrcorn_runtime</code> namespace. The root [tigrcorn](https://pypi.org/project/tigrcorn/) package keeps compatibility shims for users who install the full server distribution.
+## Related Packages
+- [tigrcorn-core](https://pypi.org/project/tigrcorn-core/)
+- [tigrcorn-config](https://pypi.org/project/tigrcorn-config/)
+- [tigrcorn-asgi](https://pypi.org/project/tigrcorn-asgi/)
+- [tigrcorn-transports](https://pypi.org/project/tigrcorn-transports/)
+- [tigrcorn-protocols](https://pypi.org/project/tigrcorn-protocols/)
+- [tigrcorn-security](https://pypi.org/project/tigrcorn-security/)
+- [tigrcorn](https://pypi.org/project/tigrcorn/)
+- [tigrcorn-compat](https://pypi.org/project/tigrcorn-compat/)
+## Package Graph
+[tigrcorn-core](https://pypi.org/project/tigrcorn-core/) | [tigrcorn-config](https://pypi.org/project/tigrcorn-config/) | [tigrcorn-http](https://pypi.org/project/tigrcorn-http/) | [tigrcorn-asgi](https://pypi.org/project/tigrcorn-asgi/) | [tigrcorn-contract](https://pypi.org/project/tigrcorn-contract/) | [tigrcorn-transports](https://pypi.org/project/tigrcorn-transports/) | [tigrcorn-security](https://pypi.org/project/tigrcorn-security/) | [tigrcorn-protocols](https://pypi.org/project/tigrcorn-protocols/) | [tigrcorn-static](https://pypi.org/project/tigrcorn-static/) | [tigrcorn-observability](https://pypi.org/project/tigrcorn-observability/) | [tigrcorn-runtime](https://pypi.org/project/tigrcorn-runtime/) | [tigrcorn-compat](https://pypi.org/project/tigrcorn-compat/) | [tigrcorn-certification](https://pypi.org/project/tigrcorn-certification/)
+## Best Practices
+- Use this package when you need the packaged server entrypoints or embedded runtime orchestration.
+- Keep worker, reload, and bootstrap behavior documented here before surfacing it at the repo root.
+- Use config, protocol, transport, and security packages as inputs instead of re-owning those concerns in runtime code.
+## License
+Apache-2.0

{tigrcorn_runtime-0.3.16.dev5 → tigrcorn_runtime-0.3.16.dev12}/pyproject.toml RENAMED Viewed

@@ -4,10 +4,10 @@ build-backend = "setuptools.build_meta"
 [project]
 name = "tigrcorn-runtime"
-version = "0.3.16.dev5"
+version = "0.3.16.dev12"
 description = "Server runner, app loading, lifecycle hooks, workers, reload, and embedded runtime for the Tigrcorn ASGI3 web server."
 readme = "README.md"
-requires-python = ">=3.11"
+requires-python = ">=3.10,<3.15"
 license = {file = "LICENSE"}
 authors = [{name = "Jacob Stewart", email = "jacob@swarmauri.com"}]
 keywords = ["tigrcorn", "asgi-server", "server-runtime", "lifespan", "workers", "reload", "python-web-server"]
@@ -19,21 +19,23 @@ classifiers = [
   "Operating System :: OS Independent",
   "Programming Language :: Python :: 3",
   "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.10",
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
   "Topic :: Internet :: WWW/HTTP",
   "Topic :: Software Development :: Libraries :: Python Modules",
   "Topic :: System :: Networking",
   "Typing :: Typed",
 ]
 dependencies = [
-  "tigrcorn-core==0.3.16.dev5",
-  "tigrcorn-config==0.3.16.dev5",
-  "tigrcorn-asgi==0.3.16.dev5",
-  "tigrcorn-transports==0.3.16.dev5",
-  "tigrcorn-protocols==0.3.16.dev5",
-  "tigrcorn-security==0.3.16.dev5",
+  "tigrcorn-core==0.3.16.dev12",
+  "tigrcorn-config==0.3.16.dev12",
+  "tigrcorn-asgi==0.3.16.dev12",
+  "tigrcorn-transports==0.3.16.dev12",
+  "tigrcorn-protocols==0.3.16.dev12",
+  "tigrcorn-security==0.3.16.dev12",
 ]
 [project.optional-dependencies]

{tigrcorn_runtime-0.3.16.dev5 → tigrcorn_runtime-0.3.16.dev12}/src/tigrcorn_runtime/app_interfaces.py RENAMED Viewed

@@ -9,6 +9,8 @@ from tigrcorn_core.types import ASGIApp, Message, Scope
 AppInterface = Literal["auto", "tigr-asgi-contract", "asgi3"]
 APP_INTERFACE_VALUES: tuple[AppInterface, ...] = ("auto", "tigr-asgi-contract", "asgi3")
+ResolvedAppInterface = Literal["tigr-asgi-contract", "asgi3"]
+DispatchSource = Literal["explicit", "auto-marker", "auto-signature"]
 Receive = Callable[[], Awaitable[Message]]
 Send = Callable[[Message], Awaitable[None]]
@@ -34,9 +36,21 @@ class NativeContractApp:
 @dataclass(frozen=True, slots=True)
 class DispatchSelection:
-    interface: Literal["tigr-asgi-contract", "asgi3"]
+    interface: ResolvedAppInterface
     app: ASGIApp
     native: bool
+    requested_interface: AppInterface = "auto"
+    source: DispatchSource = "explicit"
+    reason: str = ""
+    def as_metadata(self) -> dict[str, str | bool]:
+        return {
+            "interface": self.interface,
+            "requested_interface": self.requested_interface,
+            "source": self.source,
+            "native": self.native,
+            "reason": self.reason,
+        }
 def native_contract_app(
@@ -68,6 +82,13 @@ def is_native_contract_app(app: Any) -> bool:
     return isinstance(app, NativeContractApp) or getattr(app, "__tigrcorn_app_interface__", None) == "tigr-asgi-contract"
+def normalize_app_interface(value: str | None) -> AppInterface:
+    normalized = str(value or "auto").strip().lower().replace("_", "-")
+    if normalized not in APP_INTERFACE_VALUES:
+        raise AppInterfaceError(f"unsupported app interface: {value!r}")
+    return normalized  # type: ignore[return-value]
 def _as_native(app: Any) -> NativeContractApp:
     if isinstance(app, NativeContractApp):
         return app
@@ -84,22 +105,49 @@ def _is_unambiguous_asgi3(app: Any) -> bool:
 def resolve_app_dispatch(app: Any, interface: AppInterface = "auto") -> DispatchSelection:
-    if interface not in APP_INTERFACE_VALUES:
-        raise AppInterfaceError(f"unsupported app interface: {interface!r}")
-    if interface == "tigr-asgi-contract":
+    requested = normalize_app_interface(interface)
+    if requested == "tigr-asgi-contract":
         if not is_native_contract_app(app):
             raise AppInterfaceError("explicit tigr-asgi-contract selection requires a native contract app marker or wrapper")
-        return DispatchSelection("tigr-asgi-contract", _as_native(app), True)
-    if interface == "asgi3":
+        return DispatchSelection(
+            "tigr-asgi-contract",
+            _as_native(app),
+            True,
+            requested_interface=requested,
+            source="explicit",
+            reason="explicit native contract interface selection",
+        )
+    if requested == "asgi3":
         try:
             assert_asgi3_app(app)
         except Exception as exc:
             raise AppInterfaceError("explicit asgi3 selection requires an ASGI 3 callable") from exc
-        return DispatchSelection("asgi3", app, False)
+        return DispatchSelection(
+            "asgi3",
+            app,
+            False,
+            requested_interface=requested,
+            source="explicit",
+            reason="explicit ASGI 3 interface selection",
+        )
     if is_native_contract_app(app):
-        return DispatchSelection("tigr-asgi-contract", _as_native(app), True)
+        return DispatchSelection(
+            "tigr-asgi-contract",
+            _as_native(app),
+            True,
+            requested_interface=requested,
+            source="auto-marker",
+            reason="native contract app marker selected before signature introspection",
+        )
     if _is_unambiguous_asgi3(app):
         assert_asgi3_app(app)
-        return DispatchSelection("asgi3", app, False)
+        return DispatchSelection(
+            "asgi3",
+            app,
+            False,
+            requested_interface=requested,
+            source="auto-signature",
+            reason="unambiguous ASGI 3 callable signature",
+        )
     raise AppInterfaceError("ambiguous or unsupported application interface; select asgi3 or tigr-asgi-contract explicitly")

{tigrcorn_runtime-0.3.16.dev5 → tigrcorn_runtime-0.3.16.dev12}/src/tigrcorn_runtime/server/runner.py RENAMED Viewed

@@ -47,7 +47,10 @@ class TigrCornServer:
     def __init__(self, app: ASGIApp, config: ServerConfig) -> None:
         selection = resolve_app_dispatch(app, config.app.interface)
         self.app = selection.app
+        self.app_dispatch_selection = selection
         self.app_interface = selection.interface
+        self.app_interface_source = selection.source
+        self.app_interface_reason = selection.reason
         self.config = config
         self._resolved_logging = resolve_logging_config(config.log_level, config=config.logging)
         self.logger = configure_logging(config.log_level, config=config.logging)

{tigrcorn_runtime-0.3.16.dev5 → tigrcorn_runtime-0.3.16.dev12/src/tigrcorn_runtime.egg-info}/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tigrcorn-runtime
-Version: 0.3.16.dev5
+Version: 0.3.16.dev12
 Summary: Server runner, app loading, lifecycle hooks, workers, reload, and embedded runtime for the Tigrcorn ASGI3 web server.
 Author-email: Jacob Stewart <jacob@swarmauri.com>
 License: Apache License
@@ -175,22 +175,24 @@ Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Internet :: WWW/HTTP
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: System :: Networking
 Classifier: Typing :: Typed
-Requires-Python: >=3.11
+Requires-Python: <3.15,>=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: tigrcorn-core==0.3.16.dev5
-Requires-Dist: tigrcorn-config==0.3.16.dev5
-Requires-Dist: tigrcorn-asgi==0.3.16.dev5
-Requires-Dist: tigrcorn-transports==0.3.16.dev5
-Requires-Dist: tigrcorn-protocols==0.3.16.dev5
-Requires-Dist: tigrcorn-security==0.3.16.dev5
+Requires-Dist: tigrcorn-core==0.3.16.dev12
+Requires-Dist: tigrcorn-config==0.3.16.dev12
+Requires-Dist: tigrcorn-asgi==0.3.16.dev12
+Requires-Dist: tigrcorn-transports==0.3.16.dev12
+Requires-Dist: tigrcorn-protocols==0.3.16.dev12
+Requires-Dist: tigrcorn-security==0.3.16.dev12
 Provides-Extra: uvloop
 Requires-Dist: uvloop>=0.19.0; platform_system != "Windows" and extra == "uvloop"
 Provides-Extra: trio
@@ -199,47 +201,106 @@ Dynamic: license-file
 <div align="center">
 <h1>tigrcorn-runtime</h1>
+<img
+  src="https://raw.githubusercontent.com/Tigrbl/tigrcorn/master/assets/tigrcorn_logo.png"
+  alt="Tigrcorn tiger-unicorn logo"
+  width="140"
+/>
 <p><strong>Server runner, app loading, lifecycle hooks, workers, reload, and embedded runtime for the Tigrcorn ASGI3 web server.</strong></p>
 <a href="https://pypi.org/project/tigrcorn-runtime/"><img alt="PyPI version for tigrcorn-runtime" src="https://img.shields.io/pypi/v/tigrcorn-runtime?label=PyPI"></a>
 <a href="https://pypi.org/project/tigrcorn-runtime/"><img alt="tigrcorn-runtime package on PyPI" src="https://img.shields.io/badge/package-PyPI-blue"></a>
+<a href="https://pepy.tech/project/tigrcorn-runtime"><img alt="Downloads for tigrcorn-runtime" src="https://static.pepy.tech/badge/tigrcorn-runtime"></a>
+<a href="https://github.com/tigrbl/tigrcorn/blob/master/pkgs/tigrcorn-runtime/README.md"><img alt="Hits for tigrcorn-runtime README" src="https://hits.sh/github.com/tigrbl/tigrcorn/blob/master/pkgs/tigrcorn-runtime/README.md.svg?label=hits"></a>
 <a href="LICENSE"><img alt="Apache 2.0 license" src="https://img.shields.io/badge/license-Apache%202.0-525252"></a>
-<a href="pyproject.toml"><img alt="Python 3.11 supported" src="https://img.shields.io/badge/python-3.11-3776ab"></a>
-<a href="pyproject.toml"><img alt="Python 3.12 supported" src="https://img.shields.io/badge/python-3.12-3776ab"></a>
-<a href="pyproject.toml"><img alt="Python 3.13 supported" src="https://img.shields.io/badge/python-3.13-3776ab"></a>
-<a href="src/tigrcorn_runtime/py.typed"><img alt="typed package" src="https://img.shields.io/badge/typed-py.typed-2f7ed8"></a>
+<a href="pyproject.toml"><img alt="Python 3.10 | 3.11 | 3.12 | 3.13 | 3.14 supported" src="https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-3776ab"></a>
 <a href="https://pypi.org/project/tigrcorn-runtime/"><img alt="runtime role package" src="https://img.shields.io/badge/role-runtime-0a7f5a"></a>
 </div>
+<p align="center"><a href="https://github.com/Tigrbl/tigrcorn/blob/master/.ssot/registry.json"><img alt="SSOT governed" src="https://img.shields.io/badge/SSOT-governed-2f6f4e.svg"></a> <a href="https://discord.gg/jzvrbEtTtt"><img alt="Discord" src="https://img.shields.io/badge/Discord-Join%20chat-5865F2?logo=discord&amp;logoColor=white"></a></p>
 ## Install
-~~~bash
+```bash
+uv add tigrcorn-runtime
+```
+```bash
 pip install tigrcorn-runtime
-~~~
+```
 Use the aggregate [tigrcorn](https://pypi.org/project/tigrcorn/) distribution when you want the full ASGI3 Python web server stack. Install <code>tigrcorn-runtime</code> directly when you want only this package boundary and its declared dependencies.
 ## What It Owns
-<code>tigrcorn-runtime</code> owns server runner, app loading, bootstrap, signals, shutdown, workers, embedding, reload, and CLI-facing runtime orchestration. Its import package is <code>tigrcorn_runtime</code>, and its declared package dependencies are: tigrcorn-core, tigrcorn-config, tigrcorn-asgi, tigrcorn-transports, tigrcorn-protocols, tigrcorn-security.
+<code>tigrcorn-runtime</code> owns server runner, app loading, bootstrap, signals, shutdown, workers, embedding, and cli. Its import package is <code>tigrcorn_runtime</code>, and its declared package dependencies are: tigrcorn-core, tigrcorn-config, tigrcorn-asgi, tigrcorn-transports, tigrcorn-protocols, tigrcorn-security.
+This package page is written for developers searching for Tigrcorn ASGI3 server components, Python web server packages, HTTP/3 and QUIC support, WebSocket and WebTransport-adjacent surfaces, and Apache 2.0 licensed infrastructure.
+## Why Use This?
+Use <code>tigrcorn-runtime</code> when you want the runtime layer as a direct install target instead of the full server bundle. It lets application, operator, or certification workflows depend on this boundary explicitly while keeping the broader Tigrcorn runtime assembled from smaller repo-owned package surfaces.
+## FAQ
+### What does this package export?
+The package exports through the <code>tigrcorn_runtime</code> namespace and keeps the root <code>tigrcorn</code> package as the compatibility umbrella.
+### Which boundary does this package own?
+It is the package boundary for server runner, app loading, bootstrap, signals, shutdown, workers, embedding, and cli in the Tigrcorn package graph.
-This package page is written for developers searching for Tigrcorn ASGI3 server components, Python web server packages, HTTP/3 and QUIC support, WebSocket and WebTransport runtime surfaces, typed package boundaries, and Apache 2.0 licensed infrastructure.
+### What should be imported from the runtime package first?
+Start with run, serve, or serve_import_string when you need the packaged server entrypoints, embedded runtime orchestration, bootstrap flow, or worker lifecycle management.
+## Features
+- Owns server runner, app loading, bootstrap, signals, shutdown, workers, embedding, and cli inside the Tigrcorn split-package architecture.
+- Publishes the <code>tigrcorn_runtime</code> import surface for named public helpers and entrypoints.
+- Declared runtime dependencies: tigrcorn-core, tigrcorn-config, tigrcorn-asgi, tigrcorn-transports, tigrcorn-protocols, tigrcorn-security.
+- Optional dependency surface: uvloop, trio.
+- Supports Python 3.10, 3.11, 3.12, 3.13, and 3.14.
 ## Use It When
-Use <code>tigrcorn-runtime</code> when you need to run, embed, supervise, or lifecycle-manage Tigrcorn as an ASGI3 Python web server. It is part of Tigrcorn's split-package architecture, so it can be installed independently while remaining linked to the rest of the Tigrcorn package family on PyPI.
+Use <code>tigrcorn-runtime</code> when you need runtime-level behavior without pulling the entire server stack into the import surface. It is part of Tigrcorn's split-package architecture, so it can be installed independently while remaining linked to the rest of the Tigrcorn package family on PyPI.
 ## Import Surface
-~~~python
-import tigrcorn_runtime
+```python
+from tigrcorn_runtime import run
-print(tigrcorn_runtime.__name__)
-~~~
+print(run.__name__)
+```
+Namespace discovery starts with `import tigrcorn_runtime`.
 The package exposes its supported public surface through the <code>tigrcorn_runtime</code> namespace. The root [tigrcorn](https://pypi.org/project/tigrcorn/) package keeps compatibility shims for users who install the full server distribution.
+## Related Packages
+- [tigrcorn-core](https://pypi.org/project/tigrcorn-core/)
+- [tigrcorn-config](https://pypi.org/project/tigrcorn-config/)
+- [tigrcorn-asgi](https://pypi.org/project/tigrcorn-asgi/)
+- [tigrcorn-transports](https://pypi.org/project/tigrcorn-transports/)
+- [tigrcorn-protocols](https://pypi.org/project/tigrcorn-protocols/)
+- [tigrcorn-security](https://pypi.org/project/tigrcorn-security/)
+- [tigrcorn](https://pypi.org/project/tigrcorn/)
+- [tigrcorn-compat](https://pypi.org/project/tigrcorn-compat/)
 ## Package Graph
-[tigrcorn](https://pypi.org/project/tigrcorn/) | [tigrcorn-core](https://pypi.org/project/tigrcorn-core/) | [tigrcorn-config](https://pypi.org/project/tigrcorn-config/) | [tigrcorn-asgi](https://pypi.org/project/tigrcorn-asgi/) | [tigrcorn-contract](https://pypi.org/project/tigrcorn-contract/) | [tigrcorn-transports](https://pypi.org/project/tigrcorn-transports/) | [tigrcorn-protocols](https://pypi.org/project/tigrcorn-protocols/) | [tigrcorn-http](https://pypi.org/project/tigrcorn-http/) | [tigrcorn-security](https://pypi.org/project/tigrcorn-security/) | [tigrcorn-runtime](https://pypi.org/project/tigrcorn-runtime/) | [tigrcorn-static](https://pypi.org/project/tigrcorn-static/) | [tigrcorn-observability](https://pypi.org/project/tigrcorn-observability/) | [tigrcorn-compat](https://pypi.org/project/tigrcorn-compat/) | [tigrcorn-certification](https://pypi.org/project/tigrcorn-certification/)
+[tigrcorn-core](https://pypi.org/project/tigrcorn-core/) | [tigrcorn-config](https://pypi.org/project/tigrcorn-config/) | [tigrcorn-http](https://pypi.org/project/tigrcorn-http/) | [tigrcorn-asgi](https://pypi.org/project/tigrcorn-asgi/) | [tigrcorn-contract](https://pypi.org/project/tigrcorn-contract/) | [tigrcorn-transports](https://pypi.org/project/tigrcorn-transports/) | [tigrcorn-security](https://pypi.org/project/tigrcorn-security/) | [tigrcorn-protocols](https://pypi.org/project/tigrcorn-protocols/) | [tigrcorn-static](https://pypi.org/project/tigrcorn-static/) | [tigrcorn-observability](https://pypi.org/project/tigrcorn-observability/) | [tigrcorn-runtime](https://pypi.org/project/tigrcorn-runtime/) | [tigrcorn-compat](https://pypi.org/project/tigrcorn-compat/) | [tigrcorn-certification](https://pypi.org/project/tigrcorn-certification/)
+## Best Practices
+- Use this package when you need the packaged server entrypoints or embedded runtime orchestration.
+- Keep worker, reload, and bootstrap behavior documented here before surfacing it at the repo root.
+- Use config, protocol, transport, and security packages as inputs instead of re-owning those concerns in runtime code.
+## License
+Apache-2.0

tigrcorn_runtime-0.3.16.dev12/src/tigrcorn_runtime.egg-info/requires.txt ADDED Viewed

@@ -0,0 +1,14 @@
+tigrcorn-core==0.3.16.dev12
+tigrcorn-config==0.3.16.dev12
+tigrcorn-asgi==0.3.16.dev12
+tigrcorn-transports==0.3.16.dev12
+tigrcorn-protocols==0.3.16.dev12
+tigrcorn-security==0.3.16.dev12
+[trio]
+trio>=0.25.0
+[uvloop]
+[uvloop:platform_system != "Windows"]
+uvloop>=0.19.0

tigrcorn_runtime-0.3.16.dev5/README.md DELETED Viewed

@@ -1,46 +0,0 @@
-<div align="center">
-<h1>tigrcorn-runtime</h1>
-<p><strong>Server runner, app loading, lifecycle hooks, workers, reload, and embedded runtime for the Tigrcorn ASGI3 web server.</strong></p>
-<a href="https://pypi.org/project/tigrcorn-runtime/"><img alt="PyPI version for tigrcorn-runtime" src="https://img.shields.io/pypi/v/tigrcorn-runtime?label=PyPI"></a>
-<a href="https://pypi.org/project/tigrcorn-runtime/"><img alt="tigrcorn-runtime package on PyPI" src="https://img.shields.io/badge/package-PyPI-blue"></a>
-<a href="LICENSE"><img alt="Apache 2.0 license" src="https://img.shields.io/badge/license-Apache%202.0-525252"></a>
-<a href="pyproject.toml"><img alt="Python 3.11 supported" src="https://img.shields.io/badge/python-3.11-3776ab"></a>
-<a href="pyproject.toml"><img alt="Python 3.12 supported" src="https://img.shields.io/badge/python-3.12-3776ab"></a>
-<a href="pyproject.toml"><img alt="Python 3.13 supported" src="https://img.shields.io/badge/python-3.13-3776ab"></a>
-<a href="src/tigrcorn_runtime/py.typed"><img alt="typed package" src="https://img.shields.io/badge/typed-py.typed-2f7ed8"></a>
-<a href="https://pypi.org/project/tigrcorn-runtime/"><img alt="runtime role package" src="https://img.shields.io/badge/role-runtime-0a7f5a"></a>
-</div>
-## Install
-~~~bash
-pip install tigrcorn-runtime
-~~~
-Use the aggregate [tigrcorn](https://pypi.org/project/tigrcorn/) distribution when you want the full ASGI3 Python web server stack. Install <code>tigrcorn-runtime</code> directly when you want only this package boundary and its declared dependencies.
-## What It Owns
-<code>tigrcorn-runtime</code> owns server runner, app loading, bootstrap, signals, shutdown, workers, embedding, reload, and CLI-facing runtime orchestration. Its import package is <code>tigrcorn_runtime</code>, and its declared package dependencies are: tigrcorn-core, tigrcorn-config, tigrcorn-asgi, tigrcorn-transports, tigrcorn-protocols, tigrcorn-security.
-This package page is written for developers searching for Tigrcorn ASGI3 server components, Python web server packages, HTTP/3 and QUIC support, WebSocket and WebTransport runtime surfaces, typed package boundaries, and Apache 2.0 licensed infrastructure.
-## Use It When
-Use <code>tigrcorn-runtime</code> when you need to run, embed, supervise, or lifecycle-manage Tigrcorn as an ASGI3 Python web server. It is part of Tigrcorn's split-package architecture, so it can be installed independently while remaining linked to the rest of the Tigrcorn package family on PyPI.
-## Import Surface
-~~~python
-import tigrcorn_runtime
-print(tigrcorn_runtime.__name__)
-~~~
-The package exposes its supported public surface through the <code>tigrcorn_runtime</code> namespace. The root [tigrcorn](https://pypi.org/project/tigrcorn/) package keeps compatibility shims for users who install the full server distribution.
-## Package Graph
-[tigrcorn](https://pypi.org/project/tigrcorn/) | [tigrcorn-core](https://pypi.org/project/tigrcorn-core/) | [tigrcorn-config](https://pypi.org/project/tigrcorn-config/) | [tigrcorn-asgi](https://pypi.org/project/tigrcorn-asgi/) | [tigrcorn-contract](https://pypi.org/project/tigrcorn-contract/) | [tigrcorn-transports](https://pypi.org/project/tigrcorn-transports/) | [tigrcorn-protocols](https://pypi.org/project/tigrcorn-protocols/) | [tigrcorn-http](https://pypi.org/project/tigrcorn-http/) | [tigrcorn-security](https://pypi.org/project/tigrcorn-security/) | [tigrcorn-runtime](https://pypi.org/project/tigrcorn-runtime/) | [tigrcorn-static](https://pypi.org/project/tigrcorn-static/) | [tigrcorn-observability](https://pypi.org/project/tigrcorn-observability/) | [tigrcorn-compat](https://pypi.org/project/tigrcorn-compat/) | [tigrcorn-certification](https://pypi.org/project/tigrcorn-certification/)

tigrcorn_runtime-0.3.16.dev5/src/tigrcorn_runtime.egg-info/requires.txt DELETED Viewed

@@ -1,14 +0,0 @@
-tigrcorn-core==0.3.16.dev5
-tigrcorn-config==0.3.16.dev5
-tigrcorn-asgi==0.3.16.dev5
-tigrcorn-transports==0.3.16.dev5
-tigrcorn-protocols==0.3.16.dev5
-tigrcorn-security==0.3.16.dev5
-[trio]
-trio>=0.25.0
-[uvloop]
-[uvloop:platform_system != "Windows"]
-uvloop>=0.19.0