AI Enhanced Engineer Aiee Team Unit Test Standards

Python Unit Test Standards

Standards for writing meaningful, maintainable tests that verify behavior.

Test Naming Convention

# Unit tests: test__<what>__<expected>
def test__batch_allocation__reduces_available_quantity():
    pass

# Integration tests: test__<component>__<behavior>
def test__repository__saves_and_retrieves_batch():
    pass

# E2E tests: test__<use_case>__<scenario>
def test__order_allocation__happy_path():
    pass

Quality Criteria

Coverage Requirements

File Organization

tests/
├── unit/           # Fast, isolated (<100ms each)
├── integration/    # Database, API, external services
├── e2e/           # Full workflow tests
└── conftest.py    # Shared fixtures

Tautological Test Detection

Tests that can't fail provide false confidence:

1. Mock assertion - Verifying mock returns what you told it to
2. Assignment test - Testing that x = 5 results in x == 5
3. Empty test - No assertions or only pass
4. Implementation test - Testing HOW not WHAT

See reference.md for detection patterns and examples.md for comparisons.

Converted and distributed by TomeVault — claim your Tome and manage your conversions.