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

Extra	Additional deps	Purpose
`drf`	djangorestframework>=3.14	DRF `APIClient` fixtures (`drf_api_client`, `drf_auth_client`)
`django`	django>=4.2, pytest-django>=4.8	Explicit Django pin (normally pulled transitively)
`smoke`	django, beautifulsoup4>=4.12	HTML smoke assertions

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

Fixture	Description
`db_user`	Standard active user, saved to DB
`staff_user`	User with `is_staff=True`
`admin_user`	User with `is_superuser=True`
`api_client`	Unauthenticated Django `Client`
`auth_client`	Django `Client` logged in as `db_user`
`staff_client`	Django `Client` logged in as `staff_user`
`drf_api_client`	Unauthenticated DRF `APIClient` (skips if DRF missing)
`drf_auth_client`	DRF `APIClient` authenticated as `db_user` (skips if DRF missing)

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,
)

Helper	Description
`assert_redirects_to_login(response)`	Asserts 301/302 to `/login` or `/accounts/login`
`assert_htmx_response(response)`	Asserts no full `<html>` page in HTMX partial
`assert_no_n_plus_one(queries, threshold=5)`	Asserts query count within threshold
`assert_form_error(response, field, message)`	Asserts form field error in context

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.

Development Status
- 3 - Alpha
Framework
- Django
- Pytest
Intended Audience
- Developers
License
- OSI Approved :: MIT License
Programming Language
- Python :: 3
- Python :: 3.12
Topic
- Software Development :: Testing
Typing
- Typed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

iil_testkit-0.6.1.tar.gz (47.4 kB view details)

Uploaded Aug 27, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

iil_testkit-0.6.1-py3-none-any.whl (26.8 kB view details)

Uploaded Aug 27, 2026 Python 3

File details

Details for the file iil_testkit-0.6.1.tar.gz.

File metadata

Download URL: iil_testkit-0.6.1.tar.gz
Upload date: Aug 27, 2026
Size: 47.4 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for iil_testkit-0.6.1.tar.gz
Algorithm	Hash digest
SHA256	`885b5a4ae207d411956d68123beafd0d95ef4f487ce862bdf04d7f09acf00262`
MD5	`dc27a329f1aa4e500b2026f2c52771b2`
BLAKE2b-256	`6eb8b0425b76b20073023c6271537e6b287ca2a2055970111eac0ac9a237b09c`

See more details on using hashes here.

Provenance

The following attestation bundles were made for iil_testkit-0.6.1.tar.gz:

Publisher: publish.yml on achimdehnert/iil-testkit

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: iil_testkit-0.6.1.tar.gz
- Subject digest: 885b5a4ae207d411956d68123beafd0d95ef4f487ce862bdf04d7f09acf00262
- Sigstore transparency entry: 2616508432
- Sigstore integration time: Aug 27, 2026
Source repository:
- Permalink: achimdehnert/iil-testkit@4850e118d9df3f3c9d338cf5202fdc6d56d6f975
- Branch / Tag: refs/tags/v0.6.1
- Owner: https://github.com/achimdehnert
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@4850e118d9df3f3c9d338cf5202fdc6d56d6f975
- Trigger Event: push