iil-testkit

Shared Test Factory Package for all Platform Django repos — ADR-100

Installation

pip install iil-testkit

In requirements-test.txt:

iil-testkit>=0.4.0

With DRF support:

iil-testkit[drf]>=0.4.0

Extras / Optional Dependencies

Quick Setup

In your tests/conftest.py:

pytest_plugins = ["iil_testkit.fixtures"]

Factories

# tests/factories.py — import shared, extend repo-specific
from iil_testkit.factories import UserFactory  # noqa: F401
import factory

class MyModelFactory(factory.django.DjangoModelFactory):
    class Meta:
        model = "myapp.MyModel"
    user = factory.SubFactory(UserFactory)

For multi-tenant repos:

from iil_testkit.contrib.tenants import TenantFactory  # noqa: F401

Fixtures

def test_should_view_dashboard(auth_client):
    response = auth_client.get("/dashboard/")
    assert response.status_code == 200

def test_should_require_auth(api_client):
    from iil_testkit.assertions import assert_redirects_to_login
    response = api_client.get("/protected/")
    assert_redirects_to_login(response)

Assertion Helpers

from iil_testkit.assertions import (
    assert_redirects_to_login,
    assert_htmx_response,
    assert_no_n_plus_one,
    assert_form_error,
)

Naming Convention Plugin (ADR-057)

Auto-registered when installed. All test functions must follow test_should_*:

Naming convention violations — 1 test(s) must start with 'test_should_':
  tests/test_foo.py::test_login

Opt-out per test:

@pytest.mark.no_naming_convention
def test_legacy_name(): ...

Opt-out globally: pytest --relax-naming

Warn instead of error: iil_naming_mode = "warn" in pyproject.toml

Architecture

See ADR-100.