tigrbl-kernel 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.
- tigrbl_kernel-0.4.2.dev4/NOTICE +7 -0
- {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/PKG-INFO +114 -28
- tigrbl_kernel-0.4.2.dev4/README.md +157 -0
- {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/pyproject.toml +1 -1
- tigrbl_kernel-0.4.2.dev3/README.md +0 -72
- {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/LICENSE +0 -0
- {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/__init__.py +0 -0
- {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/_build.py +0 -0
- {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/_compile.py +0 -0
- {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/atoms.py +0 -0
- {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/cache.py +0 -0
- {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/callbacks.py +0 -0
- {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/contract_classification.py +0 -0
- {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/core.py +0 -0
- {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/eventkey.py +0 -0
- {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/eventkey_hooks.py +0 -0
- {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/events.py +0 -0
- {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/helpers.py +0 -0
- {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/hook_types.py +0 -0
- {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/labels.py +0 -0
- {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/lifecycle_matrix.py +0 -0
- {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/loop_modes.py +0 -0
- {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/loop_regions.py +0 -0
- {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/measure.py +0 -0
- {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/models.py +0 -0
- {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/opchannel_capabilities.py +0 -0
- {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/opview_compiler.py +0 -0
- {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/ordering.py +0 -0
- {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/payload.py +0 -0
- {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/protocol_bindings.py +0 -0
- {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/protocol_chains/__init__.py +0 -0
- {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/protocol_chains/http_stream.py +0 -0
- {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/protocol_chains/http_unary.py +0 -0
- {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/protocol_chains/lifespan.py +0 -0
- {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/protocol_chains/sse.py +0 -0
- {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/protocol_chains/static_files.py +0 -0
- {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/protocol_chains/websocket.py +0 -0
- {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/protocol_completion.py +0 -0
- {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/protocol_fusion.py +0 -0
- {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/protocol_legality_matrix.py +0 -0
- {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/protocol_phase_tree.py +0 -0
- {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/rust_compile.py +0 -0
- {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/rust_plan.py +0 -0
- {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/rust_spec.py +0 -0
- {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/segment_fusion.py +0 -0
- {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/subevent_handlers.py +0 -0
- {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/subevent_taxonomy.py +0 -0
- {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/trace.py +0 -0
- {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/transaction_units.py +0 -0
- {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/transport_atoms.py +0 -0
- {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/transport_events.py +0 -0
- {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/types.py +0 -0
- {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/utils.py +0 -0
- {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/webtransport_events.py +0 -0
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: tigrbl-kernel
|
|
3
|
-
Version: 0.4.2.
|
|
3
|
+
Version: 0.4.2.dev4
|
|
4
4
|
Summary: Kernel orchestration for composing Tigrbl runtime plans, bindings, operation dispatch, and optimized ASGI execution.
|
|
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,kernel,orchestration,dispatch,openapi,openrpc,schema-first
|
|
208
209
|
Author: Jacob Stewart
|
|
209
210
|
Author-email: jacob@swarmauri.com
|
|
@@ -240,12 +241,45 @@ Description-Content-Type: text/markdown
|
|
|
240
241
|
<p><strong>Kernel orchestration for composing Tigrbl runtime plans, bindings, operation dispatch, and optimized ASGI execution.</strong></p>
|
|
241
242
|
<a href="https://pypi.org/project/tigrbl-kernel/"><img src="https://img.shields.io/pypi/v/tigrbl-kernel?label=PyPI" alt="PyPI version for tigrbl-kernel"/></a>
|
|
242
243
|
<a href="https://pypi.org/project/tigrbl-kernel/"><img src="https://static.pepy.tech/badge/tigrbl-kernel" alt="Downloads for tigrbl-kernel"/></a>
|
|
244
|
+
<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-kernel"/></a>
|
|
243
245
|
<a href="https://github.com/tigrbl/tigrbl/blob/master/pkgs/core/tigrbl_kernel/README.md"><img src="https://hits.sh/github.com/tigrbl/tigrbl/blob/master/pkgs/core/tigrbl_kernel/README.md.svg?label=hits" alt="Repository hits for tigrbl-kernel README"/></a>
|
|
244
246
|
<a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-525252" alt="Apache 2.0 license"/></a>
|
|
245
|
-
<a href="pyproject.toml"><img src="https://img.shields.io/badge/python-3.10%
|
|
247
|
+
<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-kernel"/></a>
|
|
246
248
|
<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-kernel"/></a>
|
|
247
249
|
</div>
|
|
248
250
|
|
|
251
|
+
## What is tigrbl-kernel?
|
|
252
|
+
|
|
253
|
+
Kernel orchestration for composing Tigrbl runtime plans, bindings, operation dispatch, and optimized ASGI execution.
|
|
254
|
+
|
|
255
|
+
## Why use tigrbl-kernel?
|
|
256
|
+
|
|
257
|
+
Use it when you need this foundational Tigrbl layer directly as a small, focused dependency.
|
|
258
|
+
|
|
259
|
+
## When should I install tigrbl-kernel?
|
|
260
|
+
|
|
261
|
+
Install it for extension packages, package-local tests, or internals that need this boundary without the whole facade.
|
|
262
|
+
|
|
263
|
+
## Who is tigrbl-kernel for?
|
|
264
|
+
|
|
265
|
+
Framework maintainers, extension authors, and advanced users composing Tigrbl from split packages.
|
|
266
|
+
|
|
267
|
+
## Where does tigrbl-kernel fit?
|
|
268
|
+
|
|
269
|
+
`tigrbl-kernel` lives at `pkgs/core/tigrbl_kernel` and serves a focused layer in the split Tigrbl framework.
|
|
270
|
+
|
|
271
|
+
## How does tigrbl-kernel work?
|
|
272
|
+
|
|
273
|
+
It owns a narrow layer in the split workspace and is consumed by higher-level packages through explicit dependencies.
|
|
274
|
+
|
|
275
|
+
## Certification Status
|
|
276
|
+
|
|
277
|
+
- Package status: governed package in the `tigrbl/tigrbl` workspace.
|
|
278
|
+
- Governance source: [SSOT registry](https://github.com/tigrbl/tigrbl/blob/master/.ssot/registry.json).
|
|
279
|
+
- 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.
|
|
280
|
+
- 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`.
|
|
281
|
+
- Scope note: this README documents the package boundary. Runtime feature support remains governed by `.ssot/` entities and the conformance docs linked below.
|
|
282
|
+
|
|
249
283
|
## Install
|
|
250
284
|
|
|
251
285
|
```bash
|
|
@@ -256,54 +290,106 @@ uv add tigrbl-kernel
|
|
|
256
290
|
pip install tigrbl-kernel
|
|
257
291
|
```
|
|
258
292
|
|
|
293
|
+
## Surface Coverage
|
|
294
|
+
|
|
295
|
+
| Surface | Value |
|
|
296
|
+
|---|---|
|
|
297
|
+
| PyPI package | [`tigrbl-kernel`](https://pypi.org/project/tigrbl-kernel/) |
|
|
298
|
+
| Repository path | [`pkgs/core/tigrbl_kernel`](https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_kernel) |
|
|
299
|
+
| Python import root | `tigrbl_kernel` |
|
|
300
|
+
| Console scripts | none declared |
|
|
301
|
+
| Entry points | none declared |
|
|
302
|
+
| Optional extras | none declared |
|
|
303
|
+
| Legal files | `LICENSE`, `NOTICE` |
|
|
304
|
+
| Supported Python | `3.10 | 3.11 | 3.12 | 3.13 | 3.14` |
|
|
305
|
+
|
|
259
306
|
## What It Owns
|
|
260
307
|
|
|
261
|
-
`tigrbl-kernel` owns the
|
|
308
|
+
`tigrbl-kernel` 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.
|
|
309
|
+
|
|
310
|
+
Implementation orientation:
|
|
311
|
+
- `tigrbl_kernel`: _build, _compile, atoms, cache, callbacks, contract_classification, core, eventkey, eventkey_hooks, events, helpers, hook_types
|
|
312
|
+
|
|
313
|
+
## Public API and Import Surface
|
|
262
314
|
|
|
263
|
-
|
|
315
|
+
- Import roots: `tigrbl_kernel`.
|
|
316
|
+
- Public symbols: `BatchOpPlan`, `ExecutionBackend`, `Kernel`, `OpView`, `PackedKernel`, `RustBackendConfig`, `RustPlan`, `SchemaIn`, `SchemaOut`, `build_kernel_plan`, `build_packed_kernel`, `build_packed_kernel_measurement_view`.
|
|
317
|
+
- Workspace dependencies: [`tigrbl-typing`](https://pypi.org/project/tigrbl-typing/), [`tigrbl-atoms`](https://pypi.org/project/tigrbl-atoms/), [`tigrbl-core`](https://pypi.org/project/tigrbl-core/).
|
|
318
|
+
- External runtime dependencies: none declared.
|
|
264
319
|
|
|
265
|
-
|
|
320
|
+
## Usage Examples
|
|
266
321
|
|
|
267
|
-
|
|
322
|
+
### Verify the installed package
|
|
268
323
|
|
|
269
|
-
|
|
324
|
+
```bash
|
|
325
|
+
python -m pip show tigrbl-kernel
|
|
326
|
+
python - <<'PY'
|
|
327
|
+
from importlib.metadata import version
|
|
328
|
+
print(version("tigrbl-kernel"))
|
|
329
|
+
PY
|
|
330
|
+
```
|
|
270
331
|
|
|
271
|
-
|
|
332
|
+
### Import the package boundary
|
|
272
333
|
|
|
273
|
-
|
|
274
|
-
|
|
275
|
-
- Python requirement: `>=3.10,<3.15`.
|
|
276
|
-
- `tigrbl_kernel` modules: `_build, _compile, atoms, cache, callbacks, core, eventkey, eventkey_hooks, events, helpers`.
|
|
334
|
+
```python
|
|
335
|
+
import importlib
|
|
277
336
|
|
|
278
|
-
|
|
337
|
+
module = importlib.import_module("tigrbl_kernel")
|
|
338
|
+
print(module.__name__)
|
|
339
|
+
```
|
|
279
340
|
|
|
280
|
-
|
|
281
|
-
|
|
282
|
-
|
|
341
|
+
### Import a public symbol
|
|
342
|
+
|
|
343
|
+
```python
|
|
344
|
+
from tigrbl_kernel import BatchOpPlan
|
|
345
|
+
|
|
346
|
+
print(BatchOpPlan)
|
|
347
|
+
```
|
|
348
|
+
|
|
349
|
+
### Use with the facade when building applications
|
|
350
|
+
|
|
351
|
+
```bash
|
|
352
|
+
uv add tigrbl tigrbl-kernel
|
|
353
|
+
python - <<'PY'
|
|
354
|
+
import tigrbl
|
|
355
|
+
print(tigrbl.__name__)
|
|
356
|
+
PY
|
|
357
|
+
```
|
|
358
|
+
|
|
359
|
+
## How To Choose This Package
|
|
360
|
+
|
|
361
|
+
Choose `tigrbl-kernel` 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.
|
|
283
362
|
|
|
284
363
|
## Related Packages
|
|
285
364
|
|
|
286
|
-
- [`tigrbl`](https://pypi.org/project/tigrbl/)
|
|
287
365
|
- [`tigrbl-typing`](https://pypi.org/project/tigrbl-typing/)
|
|
288
366
|
- [`tigrbl-atoms`](https://pypi.org/project/tigrbl-atoms/)
|
|
289
367
|
- [`tigrbl-core`](https://pypi.org/project/tigrbl-core/)
|
|
368
|
+
- [`tigrbl`](https://pypi.org/project/tigrbl/)
|
|
369
|
+
- [`tigrbl-base`](https://pypi.org/project/tigrbl-base/)
|
|
370
|
+
- [`tigrbl-runtime`](https://pypi.org/project/tigrbl-runtime/)
|
|
371
|
+
|
|
372
|
+
## Documentation Links
|
|
373
|
+
|
|
374
|
+
- [Workspace docs](https://github.com/tigrbl/tigrbl/blob/master/docs/README.md)
|
|
375
|
+
- [Package catalog](https://github.com/tigrbl/tigrbl/blob/master/docs/developer/PACKAGE_CATALOG.md)
|
|
376
|
+
- [Package layout](https://github.com/tigrbl/tigrbl/blob/master/docs/developer/PACKAGE_LAYOUT.md)
|
|
377
|
+
- [Current target](https://github.com/tigrbl/tigrbl/blob/master/docs/conformance/CURRENT_TARGET.md)
|
|
378
|
+
- [Current state](https://github.com/tigrbl/tigrbl/blob/master/docs/conformance/CURRENT_STATE.md)
|
|
379
|
+
- [SSOT registry](https://github.com/tigrbl/tigrbl/blob/master/.ssot/registry.json)
|
|
380
|
+
- [Release workflow](https://github.com/tigrbl/tigrbl/actions/workflows/publish.yml)
|
|
290
381
|
|
|
291
|
-
##
|
|
382
|
+
## Support
|
|
292
383
|
|
|
293
|
-
-
|
|
294
|
-
-
|
|
295
|
-
-
|
|
296
|
-
- `docs/conformance/NEXT_STEPS.md`
|
|
297
|
-
- `docs/governance/DOC_POINTERS.md`
|
|
298
|
-
- `docs/developer/PACKAGE_CATALOG.md`
|
|
299
|
-
- `docs/developer/PACKAGE_LAYOUT.md`
|
|
384
|
+
- Community: [Discord](https://discord.gg/K4YTAPapjR).
|
|
385
|
+
- Issues: [GitHub Issues](https://github.com/tigrbl/tigrbl/issues).
|
|
386
|
+
- Repository: [pkgs/core/tigrbl_kernel](https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_kernel).
|
|
300
387
|
|
|
301
388
|
## Package-local Boundary
|
|
302
389
|
|
|
303
|
-
This
|
|
304
|
-
Use this page for package installation and boundary orientation. Repository governance, conformance state, target status, and release evidence remain governed from `docs/` and `.ssot/`.
|
|
390
|
+
This README is the package-local distribution entry point for `tigrbl-kernel`. 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.
|
|
305
391
|
|
|
306
392
|
## License
|
|
307
393
|
|
|
308
|
-
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).
|
|
394
|
+
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).
|
|
309
395
|
|
|
@@ -0,0 +1,157 @@
|
|
|
1
|
+
<div align="center">
|
|
2
|
+
<h1>tigrbl-kernel</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>Kernel orchestration for composing Tigrbl runtime plans, bindings, operation dispatch, and optimized ASGI execution.</strong></p>
|
|
5
|
+
<a href="https://pypi.org/project/tigrbl-kernel/"><img src="https://img.shields.io/pypi/v/tigrbl-kernel?label=PyPI" alt="PyPI version for tigrbl-kernel"/></a>
|
|
6
|
+
<a href="https://pypi.org/project/tigrbl-kernel/"><img src="https://static.pepy.tech/badge/tigrbl-kernel" alt="Downloads for tigrbl-kernel"/></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-kernel"/></a>
|
|
8
|
+
<a href="https://github.com/tigrbl/tigrbl/blob/master/pkgs/core/tigrbl_kernel/README.md"><img src="https://hits.sh/github.com/tigrbl/tigrbl/blob/master/pkgs/core/tigrbl_kernel/README.md.svg?label=hits" alt="Repository hits for tigrbl-kernel 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-kernel"/></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-kernel"/></a>
|
|
12
|
+
</div>
|
|
13
|
+
|
|
14
|
+
## What is tigrbl-kernel?
|
|
15
|
+
|
|
16
|
+
Kernel orchestration for composing Tigrbl runtime plans, bindings, operation dispatch, and optimized ASGI execution.
|
|
17
|
+
|
|
18
|
+
## Why use tigrbl-kernel?
|
|
19
|
+
|
|
20
|
+
Use it when you need this foundational Tigrbl layer directly as a small, focused dependency.
|
|
21
|
+
|
|
22
|
+
## When should I install tigrbl-kernel?
|
|
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-kernel for?
|
|
27
|
+
|
|
28
|
+
Framework maintainers, extension authors, and advanced users composing Tigrbl from split packages.
|
|
29
|
+
|
|
30
|
+
## Where does tigrbl-kernel fit?
|
|
31
|
+
|
|
32
|
+
`tigrbl-kernel` lives at `pkgs/core/tigrbl_kernel` and serves a focused layer in the split Tigrbl framework.
|
|
33
|
+
|
|
34
|
+
## How does tigrbl-kernel 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-kernel
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
```bash
|
|
53
|
+
pip install tigrbl-kernel
|
|
54
|
+
```
|
|
55
|
+
|
|
56
|
+
## Surface Coverage
|
|
57
|
+
|
|
58
|
+
| Surface | Value |
|
|
59
|
+
|---|---|
|
|
60
|
+
| PyPI package | [`tigrbl-kernel`](https://pypi.org/project/tigrbl-kernel/) |
|
|
61
|
+
| Repository path | [`pkgs/core/tigrbl_kernel`](https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_kernel) |
|
|
62
|
+
| Python import root | `tigrbl_kernel` |
|
|
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-kernel` 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_kernel`: _build, _compile, atoms, cache, callbacks, contract_classification, core, eventkey, eventkey_hooks, events, helpers, hook_types
|
|
75
|
+
|
|
76
|
+
## Public API and Import Surface
|
|
77
|
+
|
|
78
|
+
- Import roots: `tigrbl_kernel`.
|
|
79
|
+
- Public symbols: `BatchOpPlan`, `ExecutionBackend`, `Kernel`, `OpView`, `PackedKernel`, `RustBackendConfig`, `RustPlan`, `SchemaIn`, `SchemaOut`, `build_kernel_plan`, `build_packed_kernel`, `build_packed_kernel_measurement_view`.
|
|
80
|
+
- Workspace dependencies: [`tigrbl-typing`](https://pypi.org/project/tigrbl-typing/), [`tigrbl-atoms`](https://pypi.org/project/tigrbl-atoms/), [`tigrbl-core`](https://pypi.org/project/tigrbl-core/).
|
|
81
|
+
- External runtime dependencies: none declared.
|
|
82
|
+
|
|
83
|
+
## Usage Examples
|
|
84
|
+
|
|
85
|
+
### Verify the installed package
|
|
86
|
+
|
|
87
|
+
```bash
|
|
88
|
+
python -m pip show tigrbl-kernel
|
|
89
|
+
python - <<'PY'
|
|
90
|
+
from importlib.metadata import version
|
|
91
|
+
print(version("tigrbl-kernel"))
|
|
92
|
+
PY
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
### Import the package boundary
|
|
96
|
+
|
|
97
|
+
```python
|
|
98
|
+
import importlib
|
|
99
|
+
|
|
100
|
+
module = importlib.import_module("tigrbl_kernel")
|
|
101
|
+
print(module.__name__)
|
|
102
|
+
```
|
|
103
|
+
|
|
104
|
+
### Import a public symbol
|
|
105
|
+
|
|
106
|
+
```python
|
|
107
|
+
from tigrbl_kernel import BatchOpPlan
|
|
108
|
+
|
|
109
|
+
print(BatchOpPlan)
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
### Use with the facade when building applications
|
|
113
|
+
|
|
114
|
+
```bash
|
|
115
|
+
uv add tigrbl tigrbl-kernel
|
|
116
|
+
python - <<'PY'
|
|
117
|
+
import tigrbl
|
|
118
|
+
print(tigrbl.__name__)
|
|
119
|
+
PY
|
|
120
|
+
```
|
|
121
|
+
|
|
122
|
+
## How To Choose This Package
|
|
123
|
+
|
|
124
|
+
Choose `tigrbl-kernel` 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-atoms`](https://pypi.org/project/tigrbl-atoms/)
|
|
130
|
+
- [`tigrbl-core`](https://pypi.org/project/tigrbl-core/)
|
|
131
|
+
- [`tigrbl`](https://pypi.org/project/tigrbl/)
|
|
132
|
+
- [`tigrbl-base`](https://pypi.org/project/tigrbl-base/)
|
|
133
|
+
- [`tigrbl-runtime`](https://pypi.org/project/tigrbl-runtime/)
|
|
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_kernel](https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_kernel).
|
|
150
|
+
|
|
151
|
+
## Package-local Boundary
|
|
152
|
+
|
|
153
|
+
This README is the package-local distribution entry point for `tigrbl-kernel`. 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-kernel"
|
|
3
|
-
version = "0.4.2.
|
|
3
|
+
version = "0.4.2.dev4"
|
|
4
4
|
description = "Kernel orchestration for composing Tigrbl runtime plans, bindings, operation dispatch, and optimized ASGI execution."
|
|
5
5
|
readme = "README.md"
|
|
6
6
|
license = { file = "LICENSE" }
|
|
@@ -1,72 +0,0 @@
|
|
|
1
|
-
<div align="center">
|
|
2
|
-
<h1>tigrbl-kernel</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>Kernel orchestration for composing Tigrbl runtime plans, bindings, operation dispatch, and optimized ASGI execution.</strong></p>
|
|
5
|
-
<a href="https://pypi.org/project/tigrbl-kernel/"><img src="https://img.shields.io/pypi/v/tigrbl-kernel?label=PyPI" alt="PyPI version for tigrbl-kernel"/></a>
|
|
6
|
-
<a href="https://pypi.org/project/tigrbl-kernel/"><img src="https://static.pepy.tech/badge/tigrbl-kernel" alt="Downloads for tigrbl-kernel"/></a>
|
|
7
|
-
<a href="https://github.com/tigrbl/tigrbl/blob/master/pkgs/core/tigrbl_kernel/README.md"><img src="https://hits.sh/github.com/tigrbl/tigrbl/blob/master/pkgs/core/tigrbl_kernel/README.md.svg?label=hits" alt="Repository hits for tigrbl-kernel 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-kernel"/></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-kernel"/></a>
|
|
11
|
-
</div>
|
|
12
|
-
|
|
13
|
-
## Install
|
|
14
|
-
|
|
15
|
-
```bash
|
|
16
|
-
uv add tigrbl-kernel
|
|
17
|
-
```
|
|
18
|
-
|
|
19
|
-
```bash
|
|
20
|
-
pip install tigrbl-kernel
|
|
21
|
-
```
|
|
22
|
-
|
|
23
|
-
## What It Owns
|
|
24
|
-
|
|
25
|
-
`tigrbl-kernel` owns the kernel boundary inside the split Python workspace. Key implementation roots include `tigrbl_kernel` with `_build, _compile, atoms, cache, callbacks, core`.
|
|
26
|
-
|
|
27
|
-
## Use It When
|
|
28
|
-
|
|
29
|
-
Use `tigrbl-kernel` when you want this subsystem directly as a package boundary instead of consuming it only through the top-level `tigrbl` facade.
|
|
30
|
-
|
|
31
|
-
## Public Surface
|
|
32
|
-
|
|
33
|
-
- `tigrbl_kernel` exposes `import_module, Any, Dict, List, Mapping, build_rust_kernel, build_rust_parity_snapshot, normalize_rust_spec`.
|
|
34
|
-
|
|
35
|
-
## Internal Layout
|
|
36
|
-
|
|
37
|
-
- Workspace path: `pkgs/core/tigrbl_kernel`.
|
|
38
|
-
- Package class: `core framework package`.
|
|
39
|
-
- Python requirement: `>=3.10,<3.15`.
|
|
40
|
-
- `tigrbl_kernel` modules: `_build, _compile, atoms, cache, callbacks, core, eventkey, eventkey_hooks, events, helpers`.
|
|
41
|
-
|
|
42
|
-
## Dependency Surface
|
|
43
|
-
|
|
44
|
-
- Workspace package dependencies: [`tigrbl-typing`](https://pypi.org/project/tigrbl-typing/), [`tigrbl-atoms`](https://pypi.org/project/tigrbl-atoms/), [`tigrbl-core`](https://pypi.org/project/tigrbl-core/).
|
|
45
|
-
- External runtime dependencies: none declared.
|
|
46
|
-
- Optional extras: none declared.
|
|
47
|
-
|
|
48
|
-
## Related Packages
|
|
49
|
-
|
|
50
|
-
- [`tigrbl`](https://pypi.org/project/tigrbl/)
|
|
51
|
-
- [`tigrbl-typing`](https://pypi.org/project/tigrbl-typing/)
|
|
52
|
-
- [`tigrbl-atoms`](https://pypi.org/project/tigrbl-atoms/)
|
|
53
|
-
- [`tigrbl-core`](https://pypi.org/project/tigrbl-core/)
|
|
54
|
-
|
|
55
|
-
## Canonical Repository Docs
|
|
56
|
-
|
|
57
|
-
- `docs/README.md`
|
|
58
|
-
- `docs/conformance/CURRENT_TARGET.md`
|
|
59
|
-
- `docs/conformance/CURRENT_STATE.md`
|
|
60
|
-
- `docs/conformance/NEXT_STEPS.md`
|
|
61
|
-
- `docs/governance/DOC_POINTERS.md`
|
|
62
|
-
- `docs/developer/PACKAGE_CATALOG.md`
|
|
63
|
-
- `docs/developer/PACKAGE_LAYOUT.md`
|
|
64
|
-
|
|
65
|
-
## Package-local Boundary
|
|
66
|
-
|
|
67
|
-
This file is a package-local distribution entry point.
|
|
68
|
-
Use this page for package installation and boundary orientation. Repository governance, conformance state, target status, and release evidence remain governed from `docs/` and `.ssot/`.
|
|
69
|
-
|
|
70
|
-
## License
|
|
71
|
-
|
|
72
|
-
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).
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
{tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/contract_classification.py
RENAMED
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
{tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/opchannel_capabilities.py
RENAMED
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
{tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/protocol_chains/__init__.py
RENAMED
|
File without changes
|
{tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/protocol_chains/http_stream.py
RENAMED
|
File without changes
|
{tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/protocol_chains/http_unary.py
RENAMED
|
File without changes
|
{tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/protocol_chains/lifespan.py
RENAMED
|
File without changes
|
|
File without changes
|
{tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/protocol_chains/static_files.py
RENAMED
|
File without changes
|
{tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/protocol_chains/websocket.py
RENAMED
|
File without changes
|
|
File without changes
|
|
File without changes
|
{tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/protocol_legality_matrix.py
RENAMED
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|