tigrbl_tests 0.4.4.dev1

Reusable Tigrbl pytest fixtures, conformance assertions, integration helpers, and package test utilities.

tigrbl_tests

Reusable Tigrbl pytest fixtures, conformance assertions, integration helpers, and package test utilities.

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.
• Release evidence: publish workflow 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

uv add tigrbl_tests

pip install tigrbl_tests

Surface Coverage

Surface	Value
PyPI package	tigrbl_tests
Repository path	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

What It Owns

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.

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/

Public API and Import 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, 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.

Usage Examples

Verify the installed package

python -m pip show tigrbl_tests
python - <<'PY'
from importlib.metadata import version
print(version("tigrbl_tests"))
PY

Run packaged Tigrbl tests

uv run pytest pkgs/core/tigrbl_tests/tests -q
python -m pytest --pyargs tigrbl_tests

Import reusable test helpers

import tigrbl_tests

print(tigrbl_tests.__name__)

Use it in downstream CI

pip install tigrbl-tests pytest
pytest -q

How To Choose This Package

Choose tigrbl_tests when the quick-answer table matches your use case. Choose tigrbl instead when you want the full public facade. Choose a lower-level package such as tigrbl-core, tigrbl-base, or tigrbl-runtime when you are building framework extensions or testing a specific internal boundary.

Related Packages

• tigrbl
• tigrbl_client

Documentation Links

• Workspace docs
• Package catalog
• Package layout
• Current target
• Current state
• SSOT registry
• Release workflow

Support

• Community: Discord.
• Issues: GitHub Issues.
• Repository: pkgs/core/tigrbl_tests.

Package-local Boundary

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, NOTICE, and the official Apache 2.0 license text.