{project} Testing Patterns

Custom testing patterns, fixtures, and strategies for this project.

Variables

Variable	Default	Description
COVERAGE_TARGET	80	Minimum coverage percentage
E2E_TIMEOUT	30000	E2E test timeout in ms
PARALLEL_TESTS	true	Run tests in parallel when possible

Instructions

1. Identify test type needed (unit/integration/e2e)
2. Use appropriate fixtures and patterns
3. Follow project naming conventions
4. Ensure proper cleanup

Red Flags - STOP and Reconsider

If you're about to:

• Write a test without proper isolation
• Skip cleanup in fixtures
• Hardcode test data instead of using fixtures
• Write flaky tests (timing-dependent, order-dependent)

STOP -> Use proper fixtures -> Ensure isolation -> Then write test

Test Categories

Unit Tests

Location: tests/unit/

Patterns:

• Test single functions/methods in isolation
• Mock external dependencies
• Fast execution (< 100ms each)

Integration Tests

Location: tests/integration/

Patterns:

• Test component interactions
• Use test database/fixtures
• May have external dependencies

E2E Tests

Location: tests/e2e/ or playwright/

Patterns:

• Test full user workflows
• Use browser automation
• Longer execution time acceptable

Fixtures

Database Fixtures

Location: tests/fixtures/

Usage:

# Python example
from tests.fixtures import sample_user, sample_order

def test_order_creation(sample_user, sample_order):
    # Test uses pre-configured fixtures
    pass

Mock Services

Location: tests/mocks/

Available mocks:

• [TODO: List project-specific mocks]

Naming Conventions

Test Type	File Pattern	Function Pattern
Unit	test_*.py	test_<function>_<scenario>
Integration	test_*_integration.py	test_<component>_<action>
E2E	*.spec.ts	test('<feature> - <scenario>')

Coverage Requirements

Component	Minimum Coverage
Core logic	90%
API routes	80%
Utilities	70%

CI Integration

Tests run in CI:

• On PR: unit + integration
• On merge: all including E2E
• Nightly: full regression suite

Customization

Edit this file to add:

• New fixture definitions
• Additional mock services
• Custom test patterns
• Coverage exceptions