iil-testkit 0.4.0

Shared test factory package for IIL Platform Django repos

iil-testkit

Shared test factory package for all IIL Platform Django repositories.

Installation

pip install "iil-testkit[smoke]>=0.4.0,<1"

Features

• Fixtures: auth_client, staff_client, api_client, db_user, staff_user, admin_user
• Assertions: assert_htmx_response, assert_data_testids, assert_redirects_to_login, assert_no_n_plus_one, assert_form_error
• Smoke Testing: discover_smoke_urls() — auto-discovers all parameterless Django views
• ADR-048 Enforcement: assert_data_testids() — verifies all hx-* elements have data-testid
• Naming Convention: Auto-enforces test_should_* prefix (ADR-057)

Quick Start

# tests/conftest.py
pytest_plugins = ["iil_testkit.fixtures"]

# tests/test_views_smoke.py
import pytest
from iil_testkit.smoke import discover_smoke_urls

_SMOKE_URLS: list[str] = discover_smoke_urls()

@pytest.mark.parametrize("url", _SMOKE_URLS)
@pytest.mark.django_db
def test_should_view_return_200(url: str, auth_client) -> None:
    response = auth_client.get(url)
    assert response.status_code in (200, 302)

Scaffold Generator

python3 platform/scripts/gen_test_scaffold.py <repo-name>