Metadata-Version: 2.4
Name: tigrbl_tests
Version: 0.3.11.dev2
Summary: Test suite and fixtures for the Tigrbl framework.
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: tigrbl,tests,sdk,standards,pytest,fixtures,integration,performance
Author: Jacob Stewart
Author-email: jacob@swarmauri.com
Requires-Python: >=3.10,<3.13
Classifier: Development Status :: 1 - Planning
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Requires-Dist: asyncpg (>=0.30.0)
Requires-Dist: flake8 (>=7.0)
Requires-Dist: psycopg2-binary (>=2.9.9)
Requires-Dist: pytest (>=8.0)
Requires-Dist: pytest-asyncio (>=0.24.0)
Requires-Dist: pytest-benchmark (>=4.0.0)
Requires-Dist: pytest-json-report (>=1.5.0)
Requires-Dist: pytest-timeout (>=2.3.1)
Requires-Dist: pytest-xdist (>=3.6.1)
Requires-Dist: python-dotenv
Requires-Dist: requests (>=2.32.3)
Requires-Dist: ruff (>=0.9.9)
Requires-Dist: tigrbl
Requires-Dist: tigrbl_client
Description-Content-Type: text/markdown

![Tigrbl Logo](https://raw.githubusercontent.com/swarmauri/swarmauri-sdk/master/assets/tigrbl_full_logo.png)

<p align="center">
    <a href="https://pypi.org/project/tigrbl-tests/">
        <img src="https://img.shields.io/pypi/dm/tigrbl-tests" alt="PyPI - Downloads"/></a>
    <a href="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/standards/tigrbl_tests/">
        <img alt="Hits" src="https://hits.sh/github.com/swarmauri/swarmauri-sdk/tree/master/pkgs/standards/tigrbl_tests.svg"/></a>
    <a href="https://pypi.org/project/tigrbl-tests/">
        <img src="https://img.shields.io/pypi/pyversions/tigrbl-tests" alt="PyPI - Python Version"/></a>
    <a href="https://pypi.org/project/tigrbl-tests/">
        <img src="https://img.shields.io/pypi/l/tigrbl-tests" alt="PyPI - License"/></a>
    <a href="https://pypi.org/project/tigrbl-tests/">
        <img src="https://img.shields.io/pypi/v/tigrbl-tests?label=tigrbl-tests&color=green" alt="PyPI - tigrbl-tests"/></a>
</p>

---

# Tigrbl Tests 🧪

`tigrbl-tests` packages the test suite, fixtures, and examples used to validate
and teach the Tigrbl framework.

## Features ✨

- ✅ Includes tests used to validate framework behavior and API contracts.
- 📚 Includes example-first lesson tests for implementers.
- 🧰 Installs test dependencies for async API testing workflows.

## Installation 📦

**uv**

```bash
uv add "tigrbl[tests]"
```

**pip**

```bash
pip install "tigrbl[tests]"
```

Install `tigrbl-tests` directly when you only need the test package:

```bash
uv add tigrbl-tests
```

```bash
pip install tigrbl-tests
```

## Usage 🧭

### Maintainer-facing tests (framework validation)

These tests verify behavior for Tigrbl maintainers: model internals, routing,
hooks, diagnostics, and contract stability.

```bash
cd /workspace/swarmauri-sdk/pkgs
uv run --package tigrbl-tests --directory standards/tigrbl_tests pytest tests
```

### Implementer-facing tests (learning examples)

These tests are structured as lessons for implementers building Tigrbl apps.
They emphasize explicit model definitions, API setup, and client calls.

```bash
cd /workspace/swarmauri-sdk/pkgs
uv run --package tigrbl-tests --directory standards/tigrbl_tests pytest examples
```

## Tests at a glance

- `tests/`: maintainers' validation suite for the framework itself.
- `examples/`: implementers' learning lessons and pedagogical walkthroughs.

See `examples/README.md` for module-by-module lesson descriptions.

