tigrbl-runtime 0.4.2.dev3__tar.gz → 0.4.2.dev4__tar.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 (81) hide show
  1. tigrbl_runtime-0.4.2.dev4/NOTICE +7 -0
  2. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/PKG-INFO +112 -28
  3. tigrbl_runtime-0.4.2.dev4/README.md +157 -0
  4. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/pyproject.toml +1 -1
  5. tigrbl_runtime-0.4.2.dev3/README.md +0 -74
  6. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/LICENSE +0 -0
  7. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/__init__.py +0 -0
  8. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/callbacks.py +0 -0
  9. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/channel/__init__.py +0 -0
  10. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/channel/asgi.py +0 -0
  11. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/channel/capabilities.py +0 -0
  12. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/channel/state.py +0 -0
  13. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/channel/websocket.py +0 -0
  14. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/config/__init__.py +0 -0
  15. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/config/constants.py +0 -0
  16. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/executors/__init__.py +0 -0
  17. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/executors/base.py +0 -0
  18. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/executors/helpers.py +0 -0
  19. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/executors/invoke.py +0 -0
  20. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/executors/kernel_executor.py +0 -0
  21. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/executors/loop_regions.py +0 -0
  22. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/executors/numba_packed.py +0 -0
  23. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/executors/packed.py +0 -0
  24. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/executors/phase.py +0 -0
  25. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/executors/types.py +0 -0
  26. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/handle.py +0 -0
  27. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/protocol/__init__.py +0 -0
  28. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/protocol/_iterators.py +0 -0
  29. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/protocol/anchors.py +0 -0
  30. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/protocol/app_frame_codec.py +0 -0
  31. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/protocol/completion_fence.py +0 -0
  32. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/protocol/dispatch_atoms.py +0 -0
  33. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/protocol/framing_atoms.py +0 -0
  34. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/protocol/http_stream.py +0 -0
  35. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/protocol/http_unary.py +0 -0
  36. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/protocol/lifespan_chain.py +0 -0
  37. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/protocol/loop_modes.py +0 -0
  38. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/protocol/scope_schemas.py +0 -0
  39. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/protocol/sse.py +0 -0
  40. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/protocol/static_files.py +0 -0
  41. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/protocol/subevent_handlers.py +0 -0
  42. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/protocol/transport_atoms.py +0 -0
  43. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/protocol/websocket.py +0 -0
  44. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/protocol/webtransport.py +0 -0
  45. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/protocol/webtransport_session.py +0 -0
  46. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/runtime/__init__.py +0 -0
  47. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/runtime/_typing_aliases.py +0 -0
  48. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/runtime/base.py +0 -0
  49. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/runtime/channel.py +0 -0
  50. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/runtime/events.py +0 -0
  51. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/runtime/exceptions.py +0 -0
  52. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/runtime/executor/__init__.py +0 -0
  53. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/runtime/executor/invoke.py +0 -0
  54. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/runtime/hook_types.py +0 -0
  55. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/runtime/kernel.py +0 -0
  56. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/runtime/labels.py +0 -0
  57. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/runtime/response.py +0 -0
  58. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/runtime/runtime.py +0 -0
  59. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/runtime/status/__init__.py +0 -0
  60. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/runtime/status/converters.py +0 -0
  61. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/runtime/status/exceptions.py +0 -0
  62. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/runtime/status/mappings.py +0 -0
  63. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/runtime/status/utils.py +0 -0
  64. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/runtime/system.py +0 -0
  65. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/rust/__init__.py +0 -0
  66. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/rust/_fallback.py +0 -0
  67. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/rust/_load_rust.py +0 -0
  68. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/rust/_parity_contract.py +0 -0
  69. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/rust/availability.py +0 -0
  70. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/rust/backend.py +0 -0
  71. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/rust/callbacks.py +0 -0
  72. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/rust/codec.py +0 -0
  73. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/rust/compile.py +0 -0
  74. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/rust/errors.py +0 -0
  75. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/rust/parity.py +0 -0
  76. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/rust/request.py +0 -0
  77. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/rust/response.py +0 -0
  78. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/rust/runtime.py +0 -0
  79. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/rust/trace.py +0 -0
  80. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/transactions.py +0 -0
  81. {tigrbl_runtime-0.4.2.dev3 → tigrbl_runtime-0.4.2.dev4}/tigrbl_runtime/webhooks.py +0 -0
@@ -0,0 +1,7 @@
1
+ Tigrbl
2
+ Copyright 2026 Swarmauri
3
+
4
+ This product includes software developed by Swarmauri.
5
+
6
+ Tigrbl is licensed under the Apache License, Version 2.0.
7
+ See the LICENSE file distributed with this work for the full license text.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: tigrbl-runtime
3
- Version: 0.4.2.dev3
3
+ Version: 0.4.2.dev4
4
4
  Summary: Runtime pipeline helpers and execution bridge surfaces for Tigrbl ASGI applications, transports, and operation dispatch.
5
5
  License: Apache License
6
6
  Version 2.0, January 2004
@@ -204,6 +204,7 @@ License: Apache License
204
204
  See the License for the specific language governing permissions and
205
205
  limitations under the License.
206
206
  License-File: LICENSE
207
+ License-File: NOTICE
207
208
  Keywords: tigrbl,asgi,api,json-rpc,rest,sqlalchemy,pydantic,runtime,pipeline,bridge,openapi,openrpc,schema-first
208
209
  Author: Jacob Stewart
209
210
  Author-email: jacob@swarmauri.com
@@ -243,12 +244,45 @@ Description-Content-Type: text/markdown
243
244
  <p><strong>Runtime pipeline helpers and execution bridge surfaces for Tigrbl ASGI applications, transports, and operation dispatch.</strong></p>
244
245
  <a href="https://pypi.org/project/tigrbl-runtime/"><img src="https://img.shields.io/pypi/v/tigrbl-runtime?label=PyPI" alt="PyPI version for tigrbl-runtime"/></a>
245
246
  <a href="https://pypi.org/project/tigrbl-runtime/"><img src="https://static.pepy.tech/badge/tigrbl-runtime" alt="Downloads for tigrbl-runtime"/></a>
247
+ <a href="https://discord.gg/K4YTAPapjR"><img src="https://img.shields.io/badge/Discord-Join%20chat-5865F2?logo=discord&logoColor=white" alt="Discord community for tigrbl-runtime"/></a>
246
248
  <a href="https://github.com/tigrbl/tigrbl/blob/master/pkgs/core/tigrbl_runtime/README.md"><img src="https://hits.sh/github.com/tigrbl/tigrbl/blob/master/pkgs/core/tigrbl_runtime/README.md.svg?label=hits" alt="Repository hits for tigrbl-runtime README"/></a>
247
249
  <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-525252" alt="Apache 2.0 license"/></a>
248
- <a href="pyproject.toml"><img src="https://img.shields.io/badge/python-3.10%20to%203.15-3776ab" alt="Python requirement for tigrbl-runtime"/></a>
250
+ <a href="pyproject.toml"><img 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" alt="Python versions 3.10 | 3.11 | 3.12 | 3.13 | 3.14 for tigrbl-runtime"/></a>
249
251
  <a href="https://github.com/tigrbl/tigrbl/blob/master/docs/README.md"><img src="https://img.shields.io/badge/workspace-core-1f6feb" alt="Workspace group for tigrbl-runtime"/></a>
250
252
  </div>
251
253
 
254
+ ## What is tigrbl-runtime?
255
+
256
+ Runtime pipeline helpers and execution bridge surfaces for Tigrbl ASGI applications, transports, and operation dispatch.
257
+
258
+ ## Why use tigrbl-runtime?
259
+
260
+ Use it when you need this foundational Tigrbl layer directly as a small, focused dependency.
261
+
262
+ ## When should I install tigrbl-runtime?
263
+
264
+ Install it for extension packages, package-local tests, or internals that need this boundary without the whole facade.
265
+
266
+ ## Who is tigrbl-runtime for?
267
+
268
+ Framework maintainers, extension authors, and advanced users composing Tigrbl from split packages.
269
+
270
+ ## Where does tigrbl-runtime fit?
271
+
272
+ `tigrbl-runtime` lives at `pkgs/core/tigrbl_runtime` and serves a focused layer in the split Tigrbl framework.
273
+
274
+ ## How does tigrbl-runtime work?
275
+
276
+ It owns a narrow layer in the split workspace and is consumed by higher-level packages through explicit dependencies.
277
+
278
+ ## Certification Status
279
+
280
+ - Package status: governed package in the `tigrbl/tigrbl` workspace.
281
+ - Governance source: [SSOT registry](https://github.com/tigrbl/tigrbl/blob/master/.ssot/registry.json).
282
+ - Release evidence: [publish workflow](https://github.com/tigrbl/tigrbl/actions/workflows/publish.yml) validates package builds, tests, GitHub release assets, and PyPI publication for managed packages.
283
+ - Local certification guard: `pkgs/core/tigrbl_tests/tests/unit/test_package_badges_and_notices.py` verifies every package README keeps the Discord badge, Apache 2.0 badge, explicit Python-version badge, `LICENSE`, and `NOTICE`.
284
+ - Scope note: this README documents the package boundary. Runtime feature support remains governed by `.ssot/` entities and the conformance docs linked below.
285
+
252
286
  ## Install
253
287
 
254
288
  ```bash
@@ -259,56 +293,106 @@ uv add tigrbl-runtime
259
293
  pip install tigrbl-runtime
260
294
  ```
261
295
 
296
+ ## Surface Coverage
297
+
298
+ | Surface | Value |
299
+ |---|---|
300
+ | PyPI package | [`tigrbl-runtime`](https://pypi.org/project/tigrbl-runtime/) |
301
+ | Repository path | [`pkgs/core/tigrbl_runtime`](https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_runtime) |
302
+ | Python import root | `tigrbl_runtime` |
303
+ | Console scripts | none declared |
304
+ | Entry points | none declared |
305
+ | Optional extras | none declared |
306
+ | Legal files | `LICENSE`, `NOTICE` |
307
+ | Supported Python | `3.10 | 3.11 | 3.12 | 3.13 | 3.14` |
308
+
262
309
  ## What It Owns
263
310
 
264
- `tigrbl-runtime` owns the runtime boundary inside the split Python workspace.
265
- Rust crates and optional Python extension bindings have moved to the private `tigrbl/tigrbl_rs` repository.
311
+ `tigrbl-runtime` owns the `foundational framework package` boundary. It should be installed when you need this package's focused responsibility without assuming every other Tigrbl workspace package is present.
312
+
313
+ Implementation orientation:
314
+ - `tigrbl_runtime`: callbacks, channel/, config/, executors/, handle, protocol/, runtime/, rust/, transactions, webhooks
315
+
316
+ ## Public API and Import Surface
266
317
 
267
- ## Use It When
318
+ - Import roots: `tigrbl_runtime`.
319
+ - Public symbols: `ExecutionBackend`, `RustBackendConfig`, `RustBindingsUnavailableError`.
320
+ - Workspace dependencies: [`tigrbl-typing`](https://pypi.org/project/tigrbl-typing/), [`tigrbl-kernel`](https://pypi.org/project/tigrbl-kernel/), [`tigrbl-atoms`](https://pypi.org/project/tigrbl-atoms/), [`tigrbl-base`](https://pypi.org/project/tigrbl-base/), [`tigrbl-core`](https://pypi.org/project/tigrbl-core/).
321
+ - External runtime dependencies: `numba>=0.61.2`.
268
322
 
269
- Use `tigrbl-runtime` when you want this subsystem directly as a package boundary instead of consuming it only through the top-level `tigrbl` facade.
323
+ ## Usage Examples
270
324
 
271
- ## Public Surface
325
+ ### Verify the installed package
272
326
 
273
- - Package-local implementation lives under `pkgs/core/tigrbl_runtime` and is consumed as a distribution boundary rather than a single broad root re-export.
327
+ ```bash
328
+ python -m pip show tigrbl-runtime
329
+ python - <<'PY'
330
+ from importlib.metadata import version
331
+ print(version("tigrbl-runtime"))
332
+ PY
333
+ ```
274
334
 
275
- ## Internal Layout
335
+ ### Import the package boundary
276
336
 
277
- - Workspace path: `pkgs/core/tigrbl_runtime`.
278
- - Package class: `core framework package`.
279
- - Python requirement: `>=3.10,<3.15`.
337
+ ```python
338
+ import importlib
280
339
 
281
- ## Dependency Surface
340
+ module = importlib.import_module("tigrbl_runtime")
341
+ print(module.__name__)
342
+ ```
282
343
 
283
- - Workspace package dependencies: [`tigrbl-typing`](https://pypi.org/project/tigrbl-typing/), [`tigrbl-kernel`](https://pypi.org/project/tigrbl-kernel/), [`tigrbl-atoms`](https://pypi.org/project/tigrbl-atoms/), [`tigrbl-base`](https://pypi.org/project/tigrbl-base/), [`tigrbl-core`](https://pypi.org/project/tigrbl-core/).
284
- - External runtime dependencies: `numba>=0.61.2`.
285
- - Optional extras: none in this Python workspace.
344
+ ### Import a public symbol
345
+
346
+ ```python
347
+ from tigrbl_runtime import ExecutionBackend
348
+
349
+ print(ExecutionBackend)
350
+ ```
351
+
352
+ ### Use with the facade when building applications
353
+
354
+ ```bash
355
+ uv add tigrbl tigrbl-runtime
356
+ python - <<'PY'
357
+ import tigrbl
358
+ print(tigrbl.__name__)
359
+ PY
360
+ ```
361
+
362
+ ## How To Choose This Package
363
+
364
+ Choose `tigrbl-runtime` when the quick-answer table matches your use case. Choose [`tigrbl`](https://pypi.org/project/tigrbl/) instead when you want the full public facade. Choose a lower-level package such as [`tigrbl-core`](https://pypi.org/project/tigrbl-core/), [`tigrbl-base`](https://pypi.org/project/tigrbl-base/), or [`tigrbl-runtime`](https://pypi.org/project/tigrbl-runtime/) when you are building framework extensions or testing a specific internal boundary.
286
365
 
287
366
  ## Related Packages
288
367
 
289
- - [`tigrbl`](https://pypi.org/project/tigrbl/)
290
368
  - [`tigrbl-typing`](https://pypi.org/project/tigrbl-typing/)
291
369
  - [`tigrbl-kernel`](https://pypi.org/project/tigrbl-kernel/)
292
370
  - [`tigrbl-atoms`](https://pypi.org/project/tigrbl-atoms/)
293
371
  - [`tigrbl-base`](https://pypi.org/project/tigrbl-base/)
294
372
  - [`tigrbl-core`](https://pypi.org/project/tigrbl-core/)
373
+ - [`tigrbl`](https://pypi.org/project/tigrbl/)
374
+
375
+ ## Documentation Links
376
+
377
+ - [Workspace docs](https://github.com/tigrbl/tigrbl/blob/master/docs/README.md)
378
+ - [Package catalog](https://github.com/tigrbl/tigrbl/blob/master/docs/developer/PACKAGE_CATALOG.md)
379
+ - [Package layout](https://github.com/tigrbl/tigrbl/blob/master/docs/developer/PACKAGE_LAYOUT.md)
380
+ - [Current target](https://github.com/tigrbl/tigrbl/blob/master/docs/conformance/CURRENT_TARGET.md)
381
+ - [Current state](https://github.com/tigrbl/tigrbl/blob/master/docs/conformance/CURRENT_STATE.md)
382
+ - [SSOT registry](https://github.com/tigrbl/tigrbl/blob/master/.ssot/registry.json)
383
+ - [Release workflow](https://github.com/tigrbl/tigrbl/actions/workflows/publish.yml)
295
384
 
296
- ## Canonical Repository Docs
385
+ ## Support
297
386
 
298
- - `docs/README.md`
299
- - `docs/conformance/CURRENT_TARGET.md`
300
- - `docs/conformance/CURRENT_STATE.md`
301
- - `docs/conformance/NEXT_STEPS.md`
302
- - `docs/governance/DOC_POINTERS.md`
303
- - `docs/developer/PACKAGE_CATALOG.md`
304
- - `docs/developer/PACKAGE_LAYOUT.md`
387
+ - Community: [Discord](https://discord.gg/K4YTAPapjR).
388
+ - Issues: [GitHub Issues](https://github.com/tigrbl/tigrbl/issues).
389
+ - Repository: [pkgs/core/tigrbl_runtime](https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_runtime).
305
390
 
306
391
  ## Package-local Boundary
307
392
 
308
- This file is a package-local distribution entry point.
309
- Use this page for package installation and boundary orientation. Repository governance, conformance state, target status, and release evidence remain governed from `docs/` and `.ssot/`.
393
+ This README is the package-local distribution entry point for `tigrbl-runtime`. It answers install, usage, API, ownership, and certification-orientation questions for this package. Broader architectural decisions, release status, and cross-package proof chains remain in the repository-level docs and SSOT registry.
310
394
 
311
395
  ## License
312
396
 
313
- Licensed under the Apache License, Version 2.0. See `LICENSE` and the official [Apache 2.0 license text](https://www.apache.org/licenses/LICENSE-2.0).
397
+ Licensed under the Apache License, Version 2.0. See `LICENSE`, `NOTICE`, and the official [Apache 2.0 license text](https://www.apache.org/licenses/LICENSE-2.0).
314
398
 
@@ -0,0 +1,157 @@
1
+ <div align="center">
2
+ <h1>tigrbl-runtime</h1>
3
+ <img src="https://raw.githubusercontent.com/swarmauri/swarmauri-sdk/master/assets/tigrbl_full_logo.png" alt="Tigrbl logo" width="140"/>
4
+ <p><strong>Runtime pipeline helpers and execution bridge surfaces for Tigrbl ASGI applications, transports, and operation dispatch.</strong></p>
5
+ <a href="https://pypi.org/project/tigrbl-runtime/"><img src="https://img.shields.io/pypi/v/tigrbl-runtime?label=PyPI" alt="PyPI version for tigrbl-runtime"/></a>
6
+ <a href="https://pypi.org/project/tigrbl-runtime/"><img src="https://static.pepy.tech/badge/tigrbl-runtime" alt="Downloads for tigrbl-runtime"/></a>
7
+ <a href="https://discord.gg/K4YTAPapjR"><img src="https://img.shields.io/badge/Discord-Join%20chat-5865F2?logo=discord&logoColor=white" alt="Discord community for tigrbl-runtime"/></a>
8
+ <a href="https://github.com/tigrbl/tigrbl/blob/master/pkgs/core/tigrbl_runtime/README.md"><img src="https://hits.sh/github.com/tigrbl/tigrbl/blob/master/pkgs/core/tigrbl_runtime/README.md.svg?label=hits" alt="Repository hits for tigrbl-runtime README"/></a>
9
+ <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-525252" alt="Apache 2.0 license"/></a>
10
+ <a href="pyproject.toml"><img 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" alt="Python versions 3.10 | 3.11 | 3.12 | 3.13 | 3.14 for tigrbl-runtime"/></a>
11
+ <a href="https://github.com/tigrbl/tigrbl/blob/master/docs/README.md"><img src="https://img.shields.io/badge/workspace-core-1f6feb" alt="Workspace group for tigrbl-runtime"/></a>
12
+ </div>
13
+
14
+ ## What is tigrbl-runtime?
15
+
16
+ Runtime pipeline helpers and execution bridge surfaces for Tigrbl ASGI applications, transports, and operation dispatch.
17
+
18
+ ## Why use tigrbl-runtime?
19
+
20
+ Use it when you need this foundational Tigrbl layer directly as a small, focused dependency.
21
+
22
+ ## When should I install tigrbl-runtime?
23
+
24
+ Install it for extension packages, package-local tests, or internals that need this boundary without the whole facade.
25
+
26
+ ## Who is tigrbl-runtime for?
27
+
28
+ Framework maintainers, extension authors, and advanced users composing Tigrbl from split packages.
29
+
30
+ ## Where does tigrbl-runtime fit?
31
+
32
+ `tigrbl-runtime` lives at `pkgs/core/tigrbl_runtime` and serves a focused layer in the split Tigrbl framework.
33
+
34
+ ## How does tigrbl-runtime work?
35
+
36
+ It owns a narrow layer in the split workspace and is consumed by higher-level packages through explicit dependencies.
37
+
38
+ ## Certification Status
39
+
40
+ - Package status: governed package in the `tigrbl/tigrbl` workspace.
41
+ - Governance source: [SSOT registry](https://github.com/tigrbl/tigrbl/blob/master/.ssot/registry.json).
42
+ - Release evidence: [publish workflow](https://github.com/tigrbl/tigrbl/actions/workflows/publish.yml) validates package builds, tests, GitHub release assets, and PyPI publication for managed packages.
43
+ - Local certification guard: `pkgs/core/tigrbl_tests/tests/unit/test_package_badges_and_notices.py` verifies every package README keeps the Discord badge, Apache 2.0 badge, explicit Python-version badge, `LICENSE`, and `NOTICE`.
44
+ - Scope note: this README documents the package boundary. Runtime feature support remains governed by `.ssot/` entities and the conformance docs linked below.
45
+
46
+ ## Install
47
+
48
+ ```bash
49
+ uv add tigrbl-runtime
50
+ ```
51
+
52
+ ```bash
53
+ pip install tigrbl-runtime
54
+ ```
55
+
56
+ ## Surface Coverage
57
+
58
+ | Surface | Value |
59
+ |---|---|
60
+ | PyPI package | [`tigrbl-runtime`](https://pypi.org/project/tigrbl-runtime/) |
61
+ | Repository path | [`pkgs/core/tigrbl_runtime`](https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_runtime) |
62
+ | Python import root | `tigrbl_runtime` |
63
+ | Console scripts | none declared |
64
+ | Entry points | none declared |
65
+ | Optional extras | none declared |
66
+ | Legal files | `LICENSE`, `NOTICE` |
67
+ | Supported Python | `3.10 | 3.11 | 3.12 | 3.13 | 3.14` |
68
+
69
+ ## What It Owns
70
+
71
+ `tigrbl-runtime` owns the `foundational framework package` boundary. It should be installed when you need this package's focused responsibility without assuming every other Tigrbl workspace package is present.
72
+
73
+ Implementation orientation:
74
+ - `tigrbl_runtime`: callbacks, channel/, config/, executors/, handle, protocol/, runtime/, rust/, transactions, webhooks
75
+
76
+ ## Public API and Import Surface
77
+
78
+ - Import roots: `tigrbl_runtime`.
79
+ - Public symbols: `ExecutionBackend`, `RustBackendConfig`, `RustBindingsUnavailableError`.
80
+ - Workspace dependencies: [`tigrbl-typing`](https://pypi.org/project/tigrbl-typing/), [`tigrbl-kernel`](https://pypi.org/project/tigrbl-kernel/), [`tigrbl-atoms`](https://pypi.org/project/tigrbl-atoms/), [`tigrbl-base`](https://pypi.org/project/tigrbl-base/), [`tigrbl-core`](https://pypi.org/project/tigrbl-core/).
81
+ - External runtime dependencies: `numba>=0.61.2`.
82
+
83
+ ## Usage Examples
84
+
85
+ ### Verify the installed package
86
+
87
+ ```bash
88
+ python -m pip show tigrbl-runtime
89
+ python - <<'PY'
90
+ from importlib.metadata import version
91
+ print(version("tigrbl-runtime"))
92
+ PY
93
+ ```
94
+
95
+ ### Import the package boundary
96
+
97
+ ```python
98
+ import importlib
99
+
100
+ module = importlib.import_module("tigrbl_runtime")
101
+ print(module.__name__)
102
+ ```
103
+
104
+ ### Import a public symbol
105
+
106
+ ```python
107
+ from tigrbl_runtime import ExecutionBackend
108
+
109
+ print(ExecutionBackend)
110
+ ```
111
+
112
+ ### Use with the facade when building applications
113
+
114
+ ```bash
115
+ uv add tigrbl tigrbl-runtime
116
+ python - <<'PY'
117
+ import tigrbl
118
+ print(tigrbl.__name__)
119
+ PY
120
+ ```
121
+
122
+ ## How To Choose This Package
123
+
124
+ Choose `tigrbl-runtime` when the quick-answer table matches your use case. Choose [`tigrbl`](https://pypi.org/project/tigrbl/) instead when you want the full public facade. Choose a lower-level package such as [`tigrbl-core`](https://pypi.org/project/tigrbl-core/), [`tigrbl-base`](https://pypi.org/project/tigrbl-base/), or [`tigrbl-runtime`](https://pypi.org/project/tigrbl-runtime/) when you are building framework extensions or testing a specific internal boundary.
125
+
126
+ ## Related Packages
127
+
128
+ - [`tigrbl-typing`](https://pypi.org/project/tigrbl-typing/)
129
+ - [`tigrbl-kernel`](https://pypi.org/project/tigrbl-kernel/)
130
+ - [`tigrbl-atoms`](https://pypi.org/project/tigrbl-atoms/)
131
+ - [`tigrbl-base`](https://pypi.org/project/tigrbl-base/)
132
+ - [`tigrbl-core`](https://pypi.org/project/tigrbl-core/)
133
+ - [`tigrbl`](https://pypi.org/project/tigrbl/)
134
+
135
+ ## Documentation Links
136
+
137
+ - [Workspace docs](https://github.com/tigrbl/tigrbl/blob/master/docs/README.md)
138
+ - [Package catalog](https://github.com/tigrbl/tigrbl/blob/master/docs/developer/PACKAGE_CATALOG.md)
139
+ - [Package layout](https://github.com/tigrbl/tigrbl/blob/master/docs/developer/PACKAGE_LAYOUT.md)
140
+ - [Current target](https://github.com/tigrbl/tigrbl/blob/master/docs/conformance/CURRENT_TARGET.md)
141
+ - [Current state](https://github.com/tigrbl/tigrbl/blob/master/docs/conformance/CURRENT_STATE.md)
142
+ - [SSOT registry](https://github.com/tigrbl/tigrbl/blob/master/.ssot/registry.json)
143
+ - [Release workflow](https://github.com/tigrbl/tigrbl/actions/workflows/publish.yml)
144
+
145
+ ## Support
146
+
147
+ - Community: [Discord](https://discord.gg/K4YTAPapjR).
148
+ - Issues: [GitHub Issues](https://github.com/tigrbl/tigrbl/issues).
149
+ - Repository: [pkgs/core/tigrbl_runtime](https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_runtime).
150
+
151
+ ## Package-local Boundary
152
+
153
+ This README is the package-local distribution entry point for `tigrbl-runtime`. It answers install, usage, API, ownership, and certification-orientation questions for this package. Broader architectural decisions, release status, and cross-package proof chains remain in the repository-level docs and SSOT registry.
154
+
155
+ ## License
156
+
157
+ Licensed under the Apache License, Version 2.0. See `LICENSE`, `NOTICE`, and the official [Apache 2.0 license text](https://www.apache.org/licenses/LICENSE-2.0).
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "tigrbl-runtime"
3
- version = "0.4.2.dev3"
3
+ version = "0.4.2.dev4"
4
4
  description = "Runtime pipeline helpers and execution bridge surfaces for Tigrbl ASGI applications, transports, and operation dispatch."
5
5
  readme = "README.md"
6
6
  license = { file = "LICENSE" }
@@ -1,74 +0,0 @@
1
- <div align="center">
2
- <h1>tigrbl-runtime</h1>
3
- <img src="https://raw.githubusercontent.com/swarmauri/swarmauri-sdk/master/assets/tigrbl_full_logo.png" alt="Tigrbl logo" width="140"/>
4
- <p><strong>Runtime pipeline helpers and execution bridge surfaces for Tigrbl ASGI applications, transports, and operation dispatch.</strong></p>
5
- <a href="https://pypi.org/project/tigrbl-runtime/"><img src="https://img.shields.io/pypi/v/tigrbl-runtime?label=PyPI" alt="PyPI version for tigrbl-runtime"/></a>
6
- <a href="https://pypi.org/project/tigrbl-runtime/"><img src="https://static.pepy.tech/badge/tigrbl-runtime" alt="Downloads for tigrbl-runtime"/></a>
7
- <a href="https://github.com/tigrbl/tigrbl/blob/master/pkgs/core/tigrbl_runtime/README.md"><img src="https://hits.sh/github.com/tigrbl/tigrbl/blob/master/pkgs/core/tigrbl_runtime/README.md.svg?label=hits" alt="Repository hits for tigrbl-runtime README"/></a>
8
- <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-525252" alt="Apache 2.0 license"/></a>
9
- <a href="pyproject.toml"><img src="https://img.shields.io/badge/python-3.10%20to%203.15-3776ab" alt="Python requirement for tigrbl-runtime"/></a>
10
- <a href="https://github.com/tigrbl/tigrbl/blob/master/docs/README.md"><img src="https://img.shields.io/badge/workspace-core-1f6feb" alt="Workspace group for tigrbl-runtime"/></a>
11
- </div>
12
-
13
- ## Install
14
-
15
- ```bash
16
- uv add tigrbl-runtime
17
- ```
18
-
19
- ```bash
20
- pip install tigrbl-runtime
21
- ```
22
-
23
- ## What It Owns
24
-
25
- `tigrbl-runtime` owns the runtime boundary inside the split Python workspace.
26
- Rust crates and optional Python extension bindings have moved to the private `tigrbl/tigrbl_rs` repository.
27
-
28
- ## Use It When
29
-
30
- Use `tigrbl-runtime` when you want this subsystem directly as a package boundary instead of consuming it only through the top-level `tigrbl` facade.
31
-
32
- ## Public Surface
33
-
34
- - Package-local implementation lives under `pkgs/core/tigrbl_runtime` and is consumed as a distribution boundary rather than a single broad root re-export.
35
-
36
- ## Internal Layout
37
-
38
- - Workspace path: `pkgs/core/tigrbl_runtime`.
39
- - Package class: `core framework package`.
40
- - Python requirement: `>=3.10,<3.15`.
41
-
42
- ## Dependency Surface
43
-
44
- - Workspace package dependencies: [`tigrbl-typing`](https://pypi.org/project/tigrbl-typing/), [`tigrbl-kernel`](https://pypi.org/project/tigrbl-kernel/), [`tigrbl-atoms`](https://pypi.org/project/tigrbl-atoms/), [`tigrbl-base`](https://pypi.org/project/tigrbl-base/), [`tigrbl-core`](https://pypi.org/project/tigrbl-core/).
45
- - External runtime dependencies: `numba>=0.61.2`.
46
- - Optional extras: none in this Python workspace.
47
-
48
- ## Related Packages
49
-
50
- - [`tigrbl`](https://pypi.org/project/tigrbl/)
51
- - [`tigrbl-typing`](https://pypi.org/project/tigrbl-typing/)
52
- - [`tigrbl-kernel`](https://pypi.org/project/tigrbl-kernel/)
53
- - [`tigrbl-atoms`](https://pypi.org/project/tigrbl-atoms/)
54
- - [`tigrbl-base`](https://pypi.org/project/tigrbl-base/)
55
- - [`tigrbl-core`](https://pypi.org/project/tigrbl-core/)
56
-
57
- ## Canonical Repository Docs
58
-
59
- - `docs/README.md`
60
- - `docs/conformance/CURRENT_TARGET.md`
61
- - `docs/conformance/CURRENT_STATE.md`
62
- - `docs/conformance/NEXT_STEPS.md`
63
- - `docs/governance/DOC_POINTERS.md`
64
- - `docs/developer/PACKAGE_CATALOG.md`
65
- - `docs/developer/PACKAGE_LAYOUT.md`
66
-
67
- ## Package-local Boundary
68
-
69
- This file is a package-local distribution entry point.
70
- Use this page for package installation and boundary orientation. Repository governance, conformance state, target status, and release evidence remain governed from `docs/` and `.ssot/`.
71
-
72
- ## License
73
-
74
- Licensed under the Apache License, Version 2.0. See `LICENSE` and the official [Apache 2.0 license text](https://www.apache.org/licenses/LICENSE-2.0).