ulfblk-testing

Shared testing utilities and pytest fixtures for the Bloques ecosystem.

Installation

# Base (HTTP client factories + settings helpers)
uv add --dev ulfblk-testing

# With JWT auth fixtures
uv add --dev "ulfblk-testing[auth]"

# With database fixtures
uv add --dev "ulfblk-testing[db]"

# Everything
uv add --dev "ulfblk-testing[all]"

Auto-registered Fixtures (pytest plugin)

When installed, these fixtures are automatically available in your tests:

Helper Functions

HTTP Clients

from ulfblk_testing import create_test_client, create_authenticated_client

# Basic client
async with create_test_client(app) as client:
    resp = await client.get("/health")

# Authenticated client
token = create_test_token(jwt_manager)
async with create_authenticated_client(app, token) as client:
    resp = await client.get("/protected")

JWT Auth ([auth] extra)

from ulfblk_testing import generate_rsa_keys, create_jwt_manager, create_test_token

# Generate keys + manager
private_pem, public_pem = generate_rsa_keys()
manager = create_jwt_manager(private_pem, public_pem)

# Or auto-generate keys
manager = create_jwt_manager()

# Create test tokens with defaults
token = create_test_token(manager, user_id="u-1", tenant_id="t-1", roles=["admin"])

Database ([db] extra)

from ulfblk_testing import create_test_engine, create_test_session_factory, create_tables

engine = create_test_engine()
session_factory = create_test_session_factory(engine)
await create_tables(engine, Base)

async with session_factory() as session:
    # your test queries
    pass

Settings

from ulfblk_testing import create_test_settings, override_settings
from ulfblk_core import BloqueSettings

# Create settings with overrides
settings = create_test_settings(BloqueSettings, debug=True)

# Temporarily patch a settings object
with override_settings("myapp.config.settings", BloqueSettings, debug=True):
    # settings patched here
    pass