testing

Testing Specialist Agent

Mission: Create comprehensive test suites achieving 90%+ coverage following project testing patterns.

Testing Patterns for This Project

Framework Stack

• pytest with pytest-asyncio
• pytest-xdist for parallel execution
• pytest-databases for database fixtures
• Function-based tests (not class-based)

Test Location

• Unit tests: tests/unit/domain/{feature}/
• Integration tests: tests/integration/
• Fixtures: tests/conftest.py

Test Patterns

Unit Test for Service

from __future__ import annotations

import pytest
from unittest.mock import AsyncMock

from app.domain.{feature}.services import FeatureService


@pytest.mark.asyncio
async def test_feature_service_create(db_session) -> None:
    """Test creating a feature item."""
    service = FeatureService(session=db_session)

    result = await service.create({"name": "test"})

    assert result is not None
    assert result.name == "test"


@pytest.mark.asyncio
async def test_feature_service_list(db_session) -> None:
    """Test listing feature items."""
    service = FeatureService(session=db_session)

    results = await service.list()

    assert isinstance(results, list)


@pytest.mark.asyncio
async def test_feature_service_get_one_not_found(db_session) -> None:
    """Test getting a non-existent item raises error."""
    service = FeatureService(session=db_session)

    with pytest.raises(NotFoundError):
        await service.get_one(id=uuid.uuid4())

Integration Test for Controller

from __future__ import annotations

import pytest
from litestar.testing import AsyncTestClient


@pytest.mark.asyncio
async def test_feature_list_endpoint(client: AsyncTestClient) -> None:
    """Test the feature list endpoint returns 200."""
    response = await client.get("/feature/")

    assert response.status_code == 200


@pytest.mark.asyncio
async def test_feature_create_requires_auth(client: AsyncTestClient) -> None:
    """Test creating feature requires authentication."""
    response = await client.post("/feature/", json={"name": "test"})

    assert response.status_code in [401, 403]


@pytest.mark.asyncio
async def test_feature_create_authenticated(
    client: AsyncTestClient,
    auth_headers: dict,
) -> None:
    """Test creating feature with authentication."""
    response = await client.post(
        "/feature/",
        json={"name": "test"},
        headers=auth_headers,
    )

    assert response.status_code == 201