tigrbl_tests 0.4.2.dev3__py3-none-any.whl → 0.4.2.dev4__py3-none-any.whl

tests/unit/test_package_badges_and_notices.py

@@ -0,0 +1,72 @@
+from __future__ import annotations
+
+from pathlib import Path
+
+
+ROOT = Path(__file__).resolve().parents[5]
+PACKAGE_GLOBS = ("pkgs/core/*", "pkgs/engines/*", "pkgs/deprecated/*")
+PYTHON_BADGE_LABEL = "3.10 | 3.11 | 3.12 | 3.13 | 3.14"
+REQUIRED_SECTIONS = (
+    "## Certification Status",
+    "## Install",
+    "## Surface Coverage",
+    "## What It Owns",
+    "## Public API and Import Surface",
+    "## Usage Examples",
+    "## How To Choose This Package",
+    "## Related Packages",
+    "## Documentation Links",
+    "## Support",
+    "## License",
+)
+QUESTION_PREFIXES = (
+    "## What is ",
+    "## Why use ",
+    "## When should I install ",
+    "## Who is ",
+    "## Where does ",
+    "## How does ",
+)
+
+
+def _package_roots() -> list[Path]:
+    roots: list[Path] = []
+    for pattern in PACKAGE_GLOBS:
+        roots.extend(
+            path
+            for path in ROOT.glob(pattern)
+            if path.is_dir() and (path / "pyproject.toml").exists()
+        )
+    return sorted(roots)
+
+
+def test_all_package_roots_have_required_legal_files_and_badges() -> None:
+    package_roots = _package_roots()
+    assert len(package_roots) == 40
+
+    for package_root in package_roots:
+        readme = (package_root / "README.md").read_text(encoding="utf-8")
+
+        assert (package_root / "LICENSE").exists(), package_root
+        assert (package_root / "NOTICE").exists(), package_root
+        assert "license-Apache%202.0" in readme, package_root
+        assert "discord.gg/K4YTAPapjR" in readme, package_root
+        assert PYTHON_BADGE_LABEL in readme, package_root
+        assert "## Quick Answers" not in readme, package_root
+        for section in REQUIRED_SECTIONS:
+            assert section in readme, (package_root, section)
+        for prefix in QUESTION_PREFIXES:
+            assert prefix in readme, (package_root, prefix)
+
+
+def test_root_readme_and_facade_package_readme_are_distinct() -> None:
+    root_readme = (ROOT / "README.md").read_text(encoding="utf-8")
+    facade_readme = (ROOT / "pkgs/core/tigrbl/README.md").read_text(
+        encoding="utf-8"
+    )
+
+    assert "<h1>Tigrbl Workspace</h1>" in root_readme
+    assert "<h1>tigrbl</h1>" in facade_readme
+    assert "pkgs/core/tigrbl/README.md" in root_readme
+    assert "<h1>Tigrbl Workspace</h1>" not in facade_readme
+    assert "This root README is the repository and workspace entry point" in root_readme

{tigrbl_tests-0.4.2.dev3.dist-info → tigrbl_tests-0.4.2.dev4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tigrbl_tests
-Version: 0.4.2.dev3
+Version: 0.4.2.dev4
 Summary: Reusable Tigrbl pytest fixtures, conformance assertions, integration helpers, and package test utilities.
 License: Apache License
                                     Version 2.0, January 2004
@@ -204,6 +204,7 @@ License: Apache License
             See the License for the specific language governing permissions and
             limitations under the License.
 License-File: LICENSE
+License-File: NOTICE
 Keywords: tigrbl,asgi,api,json-rpc,rest,sqlalchemy,pydantic,pytest,testing,fixtures,tests,testkit,integration-testing,openapi,openrpc,schema-first
 Author: Jacob Stewart
 Author-email: jacob@swarmauri.com
@@ -254,12 +255,45 @@ Description-Content-Type: text/markdown
 <p><strong>Reusable Tigrbl pytest fixtures, conformance assertions, integration helpers, and package test utilities.</strong></p>
 <a href="https://pypi.org/project/tigrbl_tests/"><img src="https://img.shields.io/pypi/v/tigrbl_tests?label=PyPI" alt="PyPI version for tigrbl_tests"/></a>
 <a href="https://pypi.org/project/tigrbl_tests/"><img src="https://static.pepy.tech/badge/tigrbl_tests" alt="Downloads for tigrbl_tests"/></a>
+<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_tests"/></a>
 <a href="https://github.com/tigrbl/tigrbl/blob/master/pkgs/core/tigrbl_tests/README.md"><img src="https://hits.sh/github.com/tigrbl/tigrbl/blob/master/pkgs/core/tigrbl_tests/README.md.svg?label=hits" alt="Repository hits for tigrbl_tests README"/></a>
 <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-525252" alt="Apache 2.0 license"/></a>
-<a href="pyproject.toml"><img src="https://img.shields.io/badge/python-3.10%20to%203.15-3776ab" alt="Python requirement for tigrbl_tests"/></a>
+<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_tests"/></a>
 <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_tests"/></a>
 </div>
 
+## What is tigrbl_tests?
+
+Reusable Tigrbl pytest fixtures, conformance assertions, integration helpers, and package test utilities.
+
+## Why use tigrbl_tests?
+
+Use it when downstream packages need the same Tigrbl fixtures, conformance helpers, and regression assertions used by the workspace.
+
+## When should I install tigrbl_tests?
+
+Install it in CI, package-local validation, transport integration tests, and compatibility checks.
+
+## Who is tigrbl_tests for?
+
+Maintainers, extension authors, and integration teams validating Tigrbl-compatible packages.
+
+## Where does tigrbl_tests fit?
+
+`tigrbl_tests` lives at `pkgs/core/tigrbl_tests` and serves reusable test, conformance, and integration support for Tigrbl packages.
+
+## How does tigrbl_tests work?
+
+It packages reusable pytest assets and helper modules that exercise public Tigrbl behavior instead of relying on private workspace state.
+
+## Certification Status
+
+- Package status: governed package in the `tigrbl/tigrbl` workspace.
+- Governance source: [SSOT registry](https://github.com/tigrbl/tigrbl/blob/master/.ssot/registry.json).
+- 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.
+- 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`.
+- Scope note: this README documents the package boundary. Runtime feature support remains governed by `.ssot/` entities and the conformance docs linked below.
+
 ## Install
 
 ```bash
@@ -270,54 +304,99 @@ uv add tigrbl_tests
 pip install tigrbl_tests
 ```
 
+## Surface Coverage
+
+| Surface | Value |
+|---|---|
+| PyPI package | [`tigrbl_tests`](https://pypi.org/project/tigrbl_tests/) |
+| Repository path | [`pkgs/core/tigrbl_tests`](https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_tests) |
+| Python import root | `benchmarks`, `tigrbl_tests`, `triage_tests`, `v4` |
+| Console scripts | none declared |
+| Entry points | none declared |
+| Optional extras | none declared |
+| Legal files | `LICENSE`, `NOTICE` |
+| Supported Python | `3.10 | 3.11 | 3.12 | 3.13 | 3.14` |
+
 ## What It Owns
 
-`tigrbl_tests` owns the tests boundary inside the split Python workspace. Key implementation roots include `benchmarks` with `comparative_benchmark_verification, open_loop_load_patterns, run_hot_path_perf_suite, tigrbl_fastapi_surface_matrix_benchmark, tigrbl_kernel_plan_benchmark, tigrbl_request_response_benchmark`; `examples` with `01-beginner-foundations/, 01_beginner_fundamentals/, 02-beginner-columns/, 02_beginner_models/, 03-beginner-mixins/, 03_beginner_specs/`.
+`tigrbl_tests` owns the `test support package` boundary. It should be installed when you need this package's focused responsibility without assuming every other Tigrbl workspace package is present.
 
-## Use It When
+Implementation orientation:
+- `benchmarks`: comparative_benchmark_verification, open_loop_load_patterns, run_hot_path_perf_suite, tigrbl_fastapi_surface_matrix_benchmark, tigrbl_kernel_plan_benchmark, tigrbl_request_response_benchmark, tigrbl_sse_perf_suite, tigrbl_streaming_perf_suite, tigrbl_websocket_perf_suite, tigrbl_webtransport_perf_suite
+- `tigrbl_tests`: examples/, tests/
+- `v4`: tests/
 
-Use `tigrbl_tests` when you need reusable fixtures, conformance helpers, parity assets, and benchmark-oriented test surfaces for Tigrbl packages or downstream integrations.
+## Public API and Import Surface
 
-## Public Surface
+- Import roots: `benchmarks`, `tigrbl_tests`, `triage_tests`, `v4`.
+- Public symbols: public surface is module-oriented; import the package boundary and inspect submodules as needed.
+- Workspace dependencies: [`tigrbl`](https://pypi.org/project/tigrbl/), [`tigrbl_client`](https://pypi.org/project/tigrbl_client/).
+- External runtime dependencies: `psycopg2-binary>=2.9.9`, `asyncpg>=0.30.0`, `pytest>=8.0`, `pytest-asyncio>=0.24.0`, `pytest-xdist>=3.6.1`, `pytest-json-report>=1.5.0`, `python-dotenv`, `requests>=2.32.3`, `flake8>=7.0`, `pytest-timeout>=2.3.1`, `ruff>=0.9.9`, `pytest-benchmark>=4.0.0`, `jinja2>=3.1.0`.
 
-- Primary module root: `benchmarks` with module families `comparative_benchmark_verification, open_loop_load_patterns, run_hot_path_perf_suite, tigrbl_fastapi_surface_matrix_benchmark, tigrbl_kernel_plan_benchmark, tigrbl_request_response_benchmark, tigrbl_sse_perf_suite, tigrbl_streaming_perf_suite`.
-- Primary module root: `examples` with module families `01-beginner-foundations/, 01_beginner_fundamentals/, 02-beginner-columns/, 02_beginner_models/, 03-beginner-mixins/, 03_beginner_specs/, 04-beginner-app-api/, 04_beginner_tables_columns/`.
+## Usage Examples
 
-## Internal Layout
+### Verify the installed package
 
-- Workspace path: `pkgs/core/tigrbl_tests`.
-- Package class: `core framework package`.
-- Python requirement: `>=3.10,<3.15`.
-- `benchmarks` modules: `comparative_benchmark_verification, open_loop_load_patterns, run_hot_path_perf_suite, tigrbl_fastapi_surface_matrix_benchmark, tigrbl_kernel_plan_benchmark, tigrbl_request_response_benchmark, tigrbl_sse_perf_suite, tigrbl_streaming_perf_suite, tigrbl_websocket_perf_suite, tigrbl_webtransport_perf_suite`.
-- `examples` modules: `01-beginner-foundations/, 01_beginner_fundamentals/, 02-beginner-columns/, 02_beginner_models/, 03-beginner-mixins/, 03_beginner_specs/, 04-beginner-app-api/, 04_beginner_tables_columns/, 05-beginner-usage/, 05_beginner_app_api/`.
+```bash
+python -m pip show tigrbl_tests
+python - <<'PY'
+from importlib.metadata import version
+print(version("tigrbl_tests"))
+PY
+```
+
+### Run packaged Tigrbl tests
+
+```bash
+uv run pytest pkgs/core/tigrbl_tests/tests -q
+python -m pytest --pyargs tigrbl_tests
+```
+
+### Import reusable test helpers
+
+```python
+import tigrbl_tests
 
-## Dependency Surface
+print(tigrbl_tests.__name__)
+```
+
+### Use it in downstream CI
+
+```bash
+pip install tigrbl-tests pytest
+pytest -q
+```
+
+## How To Choose This Package
 
-- Workspace package dependencies: [`tigrbl`](https://pypi.org/project/tigrbl/), [`tigrbl_client`](https://pypi.org/project/tigrbl_client/).
-- External runtime dependencies: `psycopg2-binary>=2.9.9`, `asyncpg>=0.30.0`, `pytest>=8.0`, `pytest-asyncio>=0.24.0`, `pytest-xdist>=3.6.1`, `pytest-json-report>=1.5.0`, `python-dotenv`, `requests>=2.32.3`, `flake8>=7.0`, `pytest-timeout>=2.3.1`.
-- Optional extras: none declared.
+Choose `tigrbl_tests` 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.
 
 ## Related Packages
 
 - [`tigrbl`](https://pypi.org/project/tigrbl/)
 - [`tigrbl_client`](https://pypi.org/project/tigrbl_client/)
 
-## Canonical Repository Docs
+## Documentation Links
+
+- [Workspace docs](https://github.com/tigrbl/tigrbl/blob/master/docs/README.md)
+- [Package catalog](https://github.com/tigrbl/tigrbl/blob/master/docs/developer/PACKAGE_CATALOG.md)
+- [Package layout](https://github.com/tigrbl/tigrbl/blob/master/docs/developer/PACKAGE_LAYOUT.md)
+- [Current target](https://github.com/tigrbl/tigrbl/blob/master/docs/conformance/CURRENT_TARGET.md)
+- [Current state](https://github.com/tigrbl/tigrbl/blob/master/docs/conformance/CURRENT_STATE.md)
+- [SSOT registry](https://github.com/tigrbl/tigrbl/blob/master/.ssot/registry.json)
+- [Release workflow](https://github.com/tigrbl/tigrbl/actions/workflows/publish.yml)
+
+## Support
 
-- `docs/README.md`
-- `docs/conformance/CURRENT_TARGET.md`
-- `docs/conformance/CURRENT_STATE.md`
-- `docs/conformance/NEXT_STEPS.md`
-- `docs/governance/DOC_POINTERS.md`
-- `docs/developer/PACKAGE_CATALOG.md`
-- `docs/developer/PACKAGE_LAYOUT.md`
+- Community: [Discord](https://discord.gg/K4YTAPapjR).
+- Issues: [GitHub Issues](https://github.com/tigrbl/tigrbl/issues).
+- Repository: [pkgs/core/tigrbl_tests](https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_tests).
 
 ## Package-local Boundary
 
-This file is a package-local distribution entry point.
-Use this page for package installation and boundary orientation. Repository governance, conformance state, target status, and release evidence remain governed from `docs/` and `.ssot/`.
+This README is the package-local distribution entry point for `tigrbl_tests`. 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.
 
 ## License
 
-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).
+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).
 

{tigrbl_tests-0.4.2.dev3.dist-info → tigrbl_tests-0.4.2.dev4.dist-info}/RECORD

@@ -447,6 +447,7 @@ tests/unit/test_operator_surface_closure.py,sha256=DWCvS6VoGMLEwEGIJ3Lsn9b_8egEd
 tests/unit/test_operator_surface_docs_parity.py,sha256=ecwPRAbZZmvKeEo3YTyfmrKbXP5vkN0FPNDUX_QXl30,1623
 tests/unit/test_operator_websocket_route_contracts.py,sha256=RSG-0s407hz3K4nOIlgW1-k1czHpEIhlTuWJhUEpTl8,2854
 tests/unit/test_opspec_effects.py,sha256=QMRD0l91KGgXFOZtSd2KgsB5ErIVonIHBqE1gFwhgGg,4394
+tests/unit/test_package_badges_and_notices.py,sha256=aP5ebISyBwLLhOInrNmhPskhsMiFbdcnR3MB0QSeZ_U,2379
 tests/unit/test_postgres_engine_errors.py,sha256=IPpr0RldtVcnnIPl6KZQaP85Oz8ww49wcvzVbJJ-rWU,540
 tests/unit/test_postgres_env_vars.py,sha256=SPNMO5C5D4J8nQJGyaLFL_2lg2oX4RKnNn_MVLfidso,546
 tests/unit/test_relationship_alias_cols.py,sha256=XdYd-2u4t0dkI4t5RYECSxH7hMKVKvp99lncauRO2vQ,3757
@@ -545,7 +546,8 @@ tests/unit/test_v3_op_ctx_attributes.py,sha256=gp3C88to8gLn99EYMxAxgRpmjBcvGz3OH
 tests/unit/test_v3_schemas_and_decorators.py,sha256=e5DNBDe6w-3BW2lE_KJqiyGUL_Fi7kdaGRMm0TYhw1A,3970
 tests/unit/test_v3_storage_spec_attributes.py,sha256=SkPXrnK8oGaCirCA_MapmikykBv3IJkIvigp7G06ELM,6652
 tests/unit/test_verbosity.py,sha256=tL3gOhsfXBrHLPYboXyZ1Yo1emfKpHPpQercB0r93pc,1943
-tigrbl_tests-0.4.2.dev3.dist-info/METADATA,sha256=LpPIj1kBKt6EbjhjA5y3wMgF8AXZtlnCf58a3pxLp_4,19996
-tigrbl_tests-0.4.2.dev3.dist-info/WHEEL,sha256=eY7nduwzv-ldUxpzbRlxwvC693Hg6PX8bWDjEHjZ_dk,88
-tigrbl_tests-0.4.2.dev3.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-tigrbl_tests-0.4.2.dev3.dist-info/RECORD,,
+tigrbl_tests-0.4.2.dev4.dist-info/METADATA,sha256=3NwezXqd6StRLej9aDnXkiOcu4fHZSqMbRPi9X_25Lg,23047
+tigrbl_tests-0.4.2.dev4.dist-info/WHEEL,sha256=eY7nduwzv-ldUxpzbRlxwvC693Hg6PX8bWDjEHjZ_dk,88
+tigrbl_tests-0.4.2.dev4.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+tigrbl_tests-0.4.2.dev4.dist-info/licenses/NOTICE,sha256=EvJMTshzsWz43LiK-DeN2ZuLtrP49cxvlrFlJ8F_buc,221
+tigrbl_tests-0.4.2.dev4.dist-info/RECORD,,

tigrbl_tests-0.4.2.dev4.dist-info/licenses/NOTICE

@@ -0,0 +1,7 @@
+Tigrbl
+Copyright 2026 Swarmauri
+
+This product includes software developed by Swarmauri.
+
+Tigrbl is licensed under the Apache License, Version 2.0.
+See the LICENSE file distributed with this work for the full license text.