tigrbl-canon 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 (67) hide show
  1. tigrbl_canon-0.4.2.dev4/NOTICE +7 -0
  2. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/PKG-INFO +103 -30
  3. tigrbl_canon-0.4.2.dev4/README.md +150 -0
  4. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/pyproject.toml +1 -1
  5. tigrbl_canon-0.4.2.dev3/README.md +0 -78
  6. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/LICENSE +0 -0
  7. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/tigrbl_canon/__init__.py +0 -0
  8. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/tigrbl_canon/column/infer/__init__.py +0 -0
  9. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/tigrbl_canon/column/infer/core.py +0 -0
  10. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/tigrbl_canon/column/infer/jsonhints.py +0 -0
  11. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/tigrbl_canon/column/infer/planning.py +0 -0
  12. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/tigrbl_canon/column/infer/types.py +0 -0
  13. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/tigrbl_canon/column/infer/utils.py +0 -0
  14. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/tigrbl_canon/mapping/__init__.py +0 -0
  15. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/tigrbl_canon/mapping/app_mro_collect.py +0 -0
  16. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/tigrbl_canon/mapping/apply.py +0 -0
  17. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/tigrbl_canon/mapping/collect.py +0 -0
  18. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/tigrbl_canon/mapping/collect_decorated_schemas.py +0 -0
  19. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/tigrbl_canon/mapping/column_mro_collect.py +0 -0
  20. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/tigrbl_canon/mapping/columns.py +0 -0
  21. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/tigrbl_canon/mapping/config_resolver.py +0 -0
  22. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/tigrbl_canon/mapping/context.py +0 -0
  23. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/tigrbl_canon/mapping/core_resolver.py +0 -0
  24. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/tigrbl_canon/mapping/defaults.py +0 -0
  25. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/tigrbl_canon/mapping/diagnostics.py +0 -0
  26. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/tigrbl_canon/mapping/engine_resolver.py +0 -0
  27. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/tigrbl_canon/mapping/handlers/__init__.py +0 -0
  28. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/tigrbl_canon/mapping/handlers/builder.py +0 -0
  29. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/tigrbl_canon/mapping/handlers/ctx.py +0 -0
  30. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/tigrbl_canon/mapping/handlers/identifiers.py +0 -0
  31. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/tigrbl_canon/mapping/handlers/namespaces.py +0 -0
  32. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/tigrbl_canon/mapping/handlers/steps.py +0 -0
  33. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/tigrbl_canon/mapping/hook_mro_collect.py +0 -0
  34. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/tigrbl_canon/mapping/hooks.py +0 -0
  35. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/tigrbl_canon/mapping/mapping_resolver.py +0 -0
  36. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/tigrbl_canon/mapping/model.py +0 -0
  37. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/tigrbl_canon/mapping/model_helpers.py +0 -0
  38. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/tigrbl_canon/mapping/model_registry.py +0 -0
  39. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/tigrbl_canon/mapping/op_mro_collect.py +0 -0
  40. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/tigrbl_canon/mapping/op_resolver.py +0 -0
  41. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/tigrbl_canon/mapping/passes.py +0 -0
  42. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/tigrbl_canon/mapping/plan.py +0 -0
  43. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/tigrbl_canon/mapping/precedence.py +0 -0
  44. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/tigrbl_canon/mapping/responses_resolver.py +0 -0
  45. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/tigrbl_canon/mapping/rest/__init__.py +0 -0
  46. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/tigrbl_canon/mapping/rest/attach.py +0 -0
  47. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/tigrbl_canon/mapping/rest/collection.py +0 -0
  48. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/tigrbl_canon/mapping/rest/common.py +0 -0
  49. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/tigrbl_canon/mapping/rest/helpers.py +0 -0
  50. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/tigrbl_canon/mapping/rest/io.py +0 -0
  51. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/tigrbl_canon/mapping/rest/io_headers.py +0 -0
  52. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/tigrbl_canon/mapping/rest/member.py +0 -0
  53. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/tigrbl_canon/mapping/rest/router.py +0 -0
  54. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/tigrbl_canon/mapping/rest/routing.py +0 -0
  55. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/tigrbl_canon/mapping/router/common.py +0 -0
  56. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/tigrbl_canon/mapping/router/include.py +0 -0
  57. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/tigrbl_canon/mapping/router/resource_proxy.py +0 -0
  58. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/tigrbl_canon/mapping/router/rpc.py +0 -0
  59. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/tigrbl_canon/mapping/router_mro_collect.py +0 -0
  60. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/tigrbl_canon/mapping/rpc.py +0 -0
  61. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/tigrbl_canon/mapping/schemas/__init__.py +0 -0
  62. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/tigrbl_canon/mapping/schemas/builder.py +0 -0
  63. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/tigrbl_canon/mapping/schemas/defaults.py +0 -0
  64. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/tigrbl_canon/mapping/schemas/utils.py +0 -0
  65. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/tigrbl_canon/mapping/table.py +0 -0
  66. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/tigrbl_canon/mapping/table_mro_collect.py +0 -0
  67. {tigrbl_canon-0.4.2.dev3 → tigrbl_canon-0.4.2.dev4}/tigrbl_canon/mapping/traversal.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-canon
3
- Version: 0.4.2.dev3
3
+ Version: 0.4.2.dev4
4
4
  Summary: Deprecated compatibility package for Tigrbl canonical mapping, router binding, schema attachment, RPC and REST exposure, and column inference utilities.
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,canonical mapping,compatibility,deprecated,router binding,schema attachment,column inference,json-rpc,rpc,rest,canon,canonicalization,routing,mapping,openapi,openrpc,schema-first,migration
208
209
  Author: Jacob Stewart
209
210
  Author-email: jacob@swarmauri.com
@@ -248,15 +249,44 @@ Description-Content-Type: text/markdown
248
249
  <p><strong>Deprecated compatibility package for Tigrbl canonical mapping, router binding, schema attachment, RPC and REST exposure, and column inference utilities.</strong></p>
249
250
  <a href="https://pypi.org/project/tigrbl-canon/"><img src="https://img.shields.io/pypi/v/tigrbl-canon?label=PyPI" alt="PyPI version for tigrbl-canon"/></a>
250
251
  <a href="https://pypi.org/project/tigrbl-canon/"><img src="https://static.pepy.tech/badge/tigrbl-canon" alt="Downloads for tigrbl-canon"/></a>
252
+ <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-canon"/></a>
251
253
  <a href="https://github.com/tigrbl/tigrbl/blob/master/pkgs/deprecated/tigrbl_canon/README.md"><img src="https://hits.sh/github.com/tigrbl/tigrbl/blob/master/pkgs/deprecated/tigrbl_canon/README.md.svg?label=hits" alt="Repository hits for tigrbl-canon README"/></a>
252
254
  <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-525252" alt="Apache 2.0 license"/></a>
253
- <a href="pyproject.toml"><img src="https://img.shields.io/badge/python-3.10%20to%203.15-3776ab" alt="Python requirement for tigrbl-canon"/></a>
255
+ <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-canon"/></a>
254
256
  <a href="https://github.com/tigrbl/tigrbl/blob/master/docs/README.md"><img src="https://img.shields.io/badge/workspace-deprecated-6b7280" alt="Workspace group for tigrbl-canon"/></a>
255
257
  </div>
256
258
 
257
- ## Deprecation Status
259
+ ## What is tigrbl-canon?
258
260
 
259
- `tigrbl-canon` is deprecated and kept only as a compatibility package while callers migrate to the maintained `tigrbl` facade and package-specific runtime surfaces.
261
+ Deprecated compatibility package for Tigrbl canonical mapping, router binding, schema attachment, RPC and REST exposure, and column inference utilities.
262
+
263
+ ## Why use tigrbl-canon?
264
+
265
+ Use it only when maintaining older integrations that still import the historical canonical package boundary.
266
+
267
+ ## When should I install tigrbl-canon?
268
+
269
+ Install it for compatibility migrations; prefer the current split packages for new work.
270
+
271
+ ## Who is tigrbl-canon for?
272
+
273
+ Maintainers carrying legacy Tigrbl integrations forward.
274
+
275
+ ## Where does tigrbl-canon fit?
276
+
277
+ `tigrbl-canon` lives at `pkgs/deprecated/tigrbl_canon` and serves legacy compatibility while migrating to current split packages.
278
+
279
+ ## How does tigrbl-canon work?
280
+
281
+ It depends on current split packages and keeps historical import paths available while newer package boundaries own active behavior.
282
+
283
+ ## Certification Status
284
+
285
+ - Package status: governed package in the `tigrbl/tigrbl` workspace.
286
+ - Governance source: [SSOT registry](https://github.com/tigrbl/tigrbl/blob/master/.ssot/registry.json).
287
+ - 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.
288
+ - 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`.
289
+ - Scope note: this README documents the package boundary. Runtime feature support remains governed by `.ssot/` entities and the conformance docs linked below.
260
290
 
261
291
  ## Install
262
292
 
@@ -268,56 +298,99 @@ uv add tigrbl-canon
268
298
  pip install tigrbl-canon
269
299
  ```
270
300
 
301
+ ## Surface Coverage
302
+
303
+ | Surface | Value |
304
+ |---|---|
305
+ | PyPI package | [`tigrbl-canon`](https://pypi.org/project/tigrbl-canon/) |
306
+ | Repository path | [`pkgs/deprecated/tigrbl_canon`](https://github.com/tigrbl/tigrbl/tree/master/pkgs/deprecated/tigrbl_canon) |
307
+ | Python import root | `tigrbl_canon` |
308
+ | Console scripts | none declared |
309
+ | Entry points | none declared |
310
+ | Optional extras | none declared |
311
+ | Legal files | `LICENSE`, `NOTICE` |
312
+ | Supported Python | `3.10 | 3.11 | 3.12 | 3.13 | 3.14` |
313
+
271
314
  ## What It Owns
272
315
 
273
- `tigrbl-canon` is a deprecated canon boundary inside the split Python workspace. Key implementation roots include `tigrbl_canon` with `tigrbl_canon/mapping/`.
316
+ `tigrbl-canon` owns the `deprecated compatibility package` boundary. It should be installed when you need this package's focused responsibility without assuming every other Tigrbl workspace package is present.
317
+
318
+ Implementation orientation:
319
+ - `tigrbl_canon`: column/, mapping/
320
+
321
+ ## Public API and Import Surface
322
+
323
+ - Import roots: `tigrbl_canon`.
324
+ - Public symbols: `_DEPRECATION_MESSAGE`.
325
+ - Workspace dependencies: [`tigrbl-ops-oltp`](https://pypi.org/project/tigrbl-ops-oltp/), [`tigrbl-base`](https://pypi.org/project/tigrbl-base/), [`tigrbl-core`](https://pypi.org/project/tigrbl-core/), [`tigrbl-runtime`](https://pypi.org/project/tigrbl-runtime/), [`tigrbl-atoms`](https://pypi.org/project/tigrbl-atoms/), [`tigrbl`](https://pypi.org/project/tigrbl/).
326
+ - External runtime dependencies: none declared.
274
327
 
275
- ## Use It When
328
+ ## Usage Examples
276
329
 
277
- Avoid new direct use of `tigrbl-canon`. Existing consumers should treat this package as a migration bridge and prefer the top-level `tigrbl` facade or maintained package-specific surfaces.
330
+ ### Verify the installed package
278
331
 
279
- ## Public Surface
332
+ ```bash
333
+ python -m pip show tigrbl-canon
334
+ python - <<'PY'
335
+ from importlib.metadata import version
336
+ print(version("tigrbl-canon"))
337
+ PY
338
+ ```
280
339
 
281
- - `tigrbl_canon` exposes `_DEPRECATION_MESSAGE`.
340
+ ### Import the compatibility boundary
282
341
 
283
- ## Internal Layout
342
+ ```python
343
+ import tigrbl_canon
284
344
 
285
- - Workspace path: `pkgs/deprecated/tigrbl_canon`.
286
- - Package class: `deprecated compatibility package`.
287
- - Python requirement: `>=3.10,<3.15`.
288
- - `tigrbl_canon` modules: `tigrbl_canon/mapping/`.
345
+ print(tigrbl_canon.__name__)
346
+ ```
289
347
 
290
- ## Dependency Surface
348
+ ### Prefer current split packages for new code
291
349
 
292
- - Workspace package dependencies: [`tigrbl-ops-oltp`](https://pypi.org/project/tigrbl-ops-oltp/), [`tigrbl-base`](https://pypi.org/project/tigrbl-base/), [`tigrbl-core`](https://pypi.org/project/tigrbl-core/), [`tigrbl-runtime`](https://pypi.org/project/tigrbl-runtime/), [`tigrbl-atoms`](https://pypi.org/project/tigrbl-atoms/), [`tigrbl`](https://pypi.org/project/tigrbl/).
293
- - External runtime dependencies: none declared.
294
- - Optional extras: none declared.
350
+ ```bash
351
+ uv add tigrbl tigrbl-core tigrbl-runtime
352
+ ```
353
+
354
+ ### Audit remaining legacy imports
355
+
356
+ ```bash
357
+ rg "tigrbl_canon|tigrbl-canon" .
358
+ ```
359
+
360
+ ## How To Choose This Package
361
+
362
+ Choose `tigrbl-canon` 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.
295
363
 
296
364
  ## Related Packages
297
365
 
298
- - [`tigrbl`](https://pypi.org/project/tigrbl/)
299
366
  - [`tigrbl-ops-oltp`](https://pypi.org/project/tigrbl-ops-oltp/)
300
367
  - [`tigrbl-base`](https://pypi.org/project/tigrbl-base/)
301
368
  - [`tigrbl-core`](https://pypi.org/project/tigrbl-core/)
302
369
  - [`tigrbl-runtime`](https://pypi.org/project/tigrbl-runtime/)
303
370
  - [`tigrbl-atoms`](https://pypi.org/project/tigrbl-atoms/)
371
+ - [`tigrbl`](https://pypi.org/project/tigrbl/)
372
+
373
+ ## Documentation Links
374
+
375
+ - [Workspace docs](https://github.com/tigrbl/tigrbl/blob/master/docs/README.md)
376
+ - [Package catalog](https://github.com/tigrbl/tigrbl/blob/master/docs/developer/PACKAGE_CATALOG.md)
377
+ - [Package layout](https://github.com/tigrbl/tigrbl/blob/master/docs/developer/PACKAGE_LAYOUT.md)
378
+ - [Current target](https://github.com/tigrbl/tigrbl/blob/master/docs/conformance/CURRENT_TARGET.md)
379
+ - [Current state](https://github.com/tigrbl/tigrbl/blob/master/docs/conformance/CURRENT_STATE.md)
380
+ - [SSOT registry](https://github.com/tigrbl/tigrbl/blob/master/.ssot/registry.json)
381
+ - [Release workflow](https://github.com/tigrbl/tigrbl/actions/workflows/publish.yml)
304
382
 
305
- ## Canonical Repository Docs
383
+ ## Support
306
384
 
307
- - `docs/README.md`
308
- - `docs/conformance/CURRENT_TARGET.md`
309
- - `docs/conformance/CURRENT_STATE.md`
310
- - `docs/conformance/NEXT_STEPS.md`
311
- - `docs/governance/DOC_POINTERS.md`
312
- - `docs/developer/PACKAGE_CATALOG.md`
313
- - `docs/developer/PACKAGE_LAYOUT.md`
385
+ - Community: [Discord](https://discord.gg/K4YTAPapjR).
386
+ - Issues: [GitHub Issues](https://github.com/tigrbl/tigrbl/issues).
387
+ - Repository: [pkgs/deprecated/tigrbl_canon](https://github.com/tigrbl/tigrbl/tree/master/pkgs/deprecated/tigrbl_canon).
314
388
 
315
389
  ## Package-local Boundary
316
390
 
317
- This file is a package-local distribution entry point.
318
- Use this page for package installation and boundary orientation. Repository governance, conformance state, target status, and release evidence remain governed from `docs/` and `.ssot/`.
391
+ This README is the package-local distribution entry point for `tigrbl-canon`. 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.
319
392
 
320
393
  ## License
321
394
 
322
- 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).
395
+ 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).
323
396
 
@@ -0,0 +1,150 @@
1
+ <div align="center">
2
+ <h1>tigrbl-canon</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>Deprecated compatibility package for Tigrbl canonical mapping, router binding, schema attachment, RPC and REST exposure, and column inference utilities.</strong></p>
5
+ <a href="https://pypi.org/project/tigrbl-canon/"><img src="https://img.shields.io/pypi/v/tigrbl-canon?label=PyPI" alt="PyPI version for tigrbl-canon"/></a>
6
+ <a href="https://pypi.org/project/tigrbl-canon/"><img src="https://static.pepy.tech/badge/tigrbl-canon" alt="Downloads for tigrbl-canon"/></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-canon"/></a>
8
+ <a href="https://github.com/tigrbl/tigrbl/blob/master/pkgs/deprecated/tigrbl_canon/README.md"><img src="https://hits.sh/github.com/tigrbl/tigrbl/blob/master/pkgs/deprecated/tigrbl_canon/README.md.svg?label=hits" alt="Repository hits for tigrbl-canon 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-canon"/></a>
11
+ <a href="https://github.com/tigrbl/tigrbl/blob/master/docs/README.md"><img src="https://img.shields.io/badge/workspace-deprecated-6b7280" alt="Workspace group for tigrbl-canon"/></a>
12
+ </div>
13
+
14
+ ## What is tigrbl-canon?
15
+
16
+ Deprecated compatibility package for Tigrbl canonical mapping, router binding, schema attachment, RPC and REST exposure, and column inference utilities.
17
+
18
+ ## Why use tigrbl-canon?
19
+
20
+ Use it only when maintaining older integrations that still import the historical canonical package boundary.
21
+
22
+ ## When should I install tigrbl-canon?
23
+
24
+ Install it for compatibility migrations; prefer the current split packages for new work.
25
+
26
+ ## Who is tigrbl-canon for?
27
+
28
+ Maintainers carrying legacy Tigrbl integrations forward.
29
+
30
+ ## Where does tigrbl-canon fit?
31
+
32
+ `tigrbl-canon` lives at `pkgs/deprecated/tigrbl_canon` and serves legacy compatibility while migrating to current split packages.
33
+
34
+ ## How does tigrbl-canon work?
35
+
36
+ It depends on current split packages and keeps historical import paths available while newer package boundaries own active behavior.
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-canon
50
+ ```
51
+
52
+ ```bash
53
+ pip install tigrbl-canon
54
+ ```
55
+
56
+ ## Surface Coverage
57
+
58
+ | Surface | Value |
59
+ |---|---|
60
+ | PyPI package | [`tigrbl-canon`](https://pypi.org/project/tigrbl-canon/) |
61
+ | Repository path | [`pkgs/deprecated/tigrbl_canon`](https://github.com/tigrbl/tigrbl/tree/master/pkgs/deprecated/tigrbl_canon) |
62
+ | Python import root | `tigrbl_canon` |
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-canon` owns the `deprecated compatibility 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_canon`: column/, mapping/
75
+
76
+ ## Public API and Import Surface
77
+
78
+ - Import roots: `tigrbl_canon`.
79
+ - Public symbols: `_DEPRECATION_MESSAGE`.
80
+ - Workspace dependencies: [`tigrbl-ops-oltp`](https://pypi.org/project/tigrbl-ops-oltp/), [`tigrbl-base`](https://pypi.org/project/tigrbl-base/), [`tigrbl-core`](https://pypi.org/project/tigrbl-core/), [`tigrbl-runtime`](https://pypi.org/project/tigrbl-runtime/), [`tigrbl-atoms`](https://pypi.org/project/tigrbl-atoms/), [`tigrbl`](https://pypi.org/project/tigrbl/).
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-canon
89
+ python - <<'PY'
90
+ from importlib.metadata import version
91
+ print(version("tigrbl-canon"))
92
+ PY
93
+ ```
94
+
95
+ ### Import the compatibility boundary
96
+
97
+ ```python
98
+ import tigrbl_canon
99
+
100
+ print(tigrbl_canon.__name__)
101
+ ```
102
+
103
+ ### Prefer current split packages for new code
104
+
105
+ ```bash
106
+ uv add tigrbl tigrbl-core tigrbl-runtime
107
+ ```
108
+
109
+ ### Audit remaining legacy imports
110
+
111
+ ```bash
112
+ rg "tigrbl_canon|tigrbl-canon" .
113
+ ```
114
+
115
+ ## How To Choose This Package
116
+
117
+ Choose `tigrbl-canon` 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.
118
+
119
+ ## Related Packages
120
+
121
+ - [`tigrbl-ops-oltp`](https://pypi.org/project/tigrbl-ops-oltp/)
122
+ - [`tigrbl-base`](https://pypi.org/project/tigrbl-base/)
123
+ - [`tigrbl-core`](https://pypi.org/project/tigrbl-core/)
124
+ - [`tigrbl-runtime`](https://pypi.org/project/tigrbl-runtime/)
125
+ - [`tigrbl-atoms`](https://pypi.org/project/tigrbl-atoms/)
126
+ - [`tigrbl`](https://pypi.org/project/tigrbl/)
127
+
128
+ ## Documentation Links
129
+
130
+ - [Workspace docs](https://github.com/tigrbl/tigrbl/blob/master/docs/README.md)
131
+ - [Package catalog](https://github.com/tigrbl/tigrbl/blob/master/docs/developer/PACKAGE_CATALOG.md)
132
+ - [Package layout](https://github.com/tigrbl/tigrbl/blob/master/docs/developer/PACKAGE_LAYOUT.md)
133
+ - [Current target](https://github.com/tigrbl/tigrbl/blob/master/docs/conformance/CURRENT_TARGET.md)
134
+ - [Current state](https://github.com/tigrbl/tigrbl/blob/master/docs/conformance/CURRENT_STATE.md)
135
+ - [SSOT registry](https://github.com/tigrbl/tigrbl/blob/master/.ssot/registry.json)
136
+ - [Release workflow](https://github.com/tigrbl/tigrbl/actions/workflows/publish.yml)
137
+
138
+ ## Support
139
+
140
+ - Community: [Discord](https://discord.gg/K4YTAPapjR).
141
+ - Issues: [GitHub Issues](https://github.com/tigrbl/tigrbl/issues).
142
+ - Repository: [pkgs/deprecated/tigrbl_canon](https://github.com/tigrbl/tigrbl/tree/master/pkgs/deprecated/tigrbl_canon).
143
+
144
+ ## Package-local Boundary
145
+
146
+ This README is the package-local distribution entry point for `tigrbl-canon`. 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.
147
+
148
+ ## License
149
+
150
+ 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-canon"
3
- version = "0.4.2.dev3"
3
+ version = "0.4.2.dev4"
4
4
  description = "Deprecated compatibility package for Tigrbl canonical mapping, router binding, schema attachment, RPC and REST exposure, and column inference utilities."
5
5
  readme = "README.md"
6
6
  license = { file = "LICENSE" }
@@ -1,78 +0,0 @@
1
- <div align="center">
2
- <h1>tigrbl-canon</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>Deprecated compatibility package for Tigrbl canonical mapping, router binding, schema attachment, RPC and REST exposure, and column inference utilities.</strong></p>
5
- <a href="https://pypi.org/project/tigrbl-canon/"><img src="https://img.shields.io/pypi/v/tigrbl-canon?label=PyPI" alt="PyPI version for tigrbl-canon"/></a>
6
- <a href="https://pypi.org/project/tigrbl-canon/"><img src="https://static.pepy.tech/badge/tigrbl-canon" alt="Downloads for tigrbl-canon"/></a>
7
- <a href="https://github.com/tigrbl/tigrbl/blob/master/pkgs/deprecated/tigrbl_canon/README.md"><img src="https://hits.sh/github.com/tigrbl/tigrbl/blob/master/pkgs/deprecated/tigrbl_canon/README.md.svg?label=hits" alt="Repository hits for tigrbl-canon 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-canon"/></a>
10
- <a href="https://github.com/tigrbl/tigrbl/blob/master/docs/README.md"><img src="https://img.shields.io/badge/workspace-deprecated-6b7280" alt="Workspace group for tigrbl-canon"/></a>
11
- </div>
12
-
13
- ## Deprecation Status
14
-
15
- `tigrbl-canon` is deprecated and kept only as a compatibility package while callers migrate to the maintained `tigrbl` facade and package-specific runtime surfaces.
16
-
17
- ## Install
18
-
19
- ```bash
20
- uv add tigrbl-canon
21
- ```
22
-
23
- ```bash
24
- pip install tigrbl-canon
25
- ```
26
-
27
- ## What It Owns
28
-
29
- `tigrbl-canon` is a deprecated canon boundary inside the split Python workspace. Key implementation roots include `tigrbl_canon` with `tigrbl_canon/mapping/`.
30
-
31
- ## Use It When
32
-
33
- Avoid new direct use of `tigrbl-canon`. Existing consumers should treat this package as a migration bridge and prefer the top-level `tigrbl` facade or maintained package-specific surfaces.
34
-
35
- ## Public Surface
36
-
37
- - `tigrbl_canon` exposes `_DEPRECATION_MESSAGE`.
38
-
39
- ## Internal Layout
40
-
41
- - Workspace path: `pkgs/deprecated/tigrbl_canon`.
42
- - Package class: `deprecated compatibility package`.
43
- - Python requirement: `>=3.10,<3.15`.
44
- - `tigrbl_canon` modules: `tigrbl_canon/mapping/`.
45
-
46
- ## Dependency Surface
47
-
48
- - Workspace package dependencies: [`tigrbl-ops-oltp`](https://pypi.org/project/tigrbl-ops-oltp/), [`tigrbl-base`](https://pypi.org/project/tigrbl-base/), [`tigrbl-core`](https://pypi.org/project/tigrbl-core/), [`tigrbl-runtime`](https://pypi.org/project/tigrbl-runtime/), [`tigrbl-atoms`](https://pypi.org/project/tigrbl-atoms/), [`tigrbl`](https://pypi.org/project/tigrbl/).
49
- - External runtime dependencies: none declared.
50
- - Optional extras: none declared.
51
-
52
- ## Related Packages
53
-
54
- - [`tigrbl`](https://pypi.org/project/tigrbl/)
55
- - [`tigrbl-ops-oltp`](https://pypi.org/project/tigrbl-ops-oltp/)
56
- - [`tigrbl-base`](https://pypi.org/project/tigrbl-base/)
57
- - [`tigrbl-core`](https://pypi.org/project/tigrbl-core/)
58
- - [`tigrbl-runtime`](https://pypi.org/project/tigrbl-runtime/)
59
- - [`tigrbl-atoms`](https://pypi.org/project/tigrbl-atoms/)
60
-
61
- ## Canonical Repository Docs
62
-
63
- - `docs/README.md`
64
- - `docs/conformance/CURRENT_TARGET.md`
65
- - `docs/conformance/CURRENT_STATE.md`
66
- - `docs/conformance/NEXT_STEPS.md`
67
- - `docs/governance/DOC_POINTERS.md`
68
- - `docs/developer/PACKAGE_CATALOG.md`
69
- - `docs/developer/PACKAGE_LAYOUT.md`
70
-
71
- ## Package-local Boundary
72
-
73
- This file is a package-local distribution entry point.
74
- Use this page for package installation and boundary orientation. Repository governance, conformance state, target status, and release evidence remain governed from `docs/` and `.ssot/`.
75
-
76
- ## License
77
-
78
- 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).