backend-testing.md

Backend Testing Guide

This guide covers how to test the Python API backend using pytest.

Overview

Backend tests use pytest to test the FastAPI application, services, and models.

Running Backend Tests

cd webapp/packages/api/user-service

# Run all tests
python -m pytest

# Run unit tests only
python -m pytest tests/unit/

# Run integration tests only
python -m pytest tests/integration/

# Run with coverage
python -m pytest --cov=. --cov-report=html

Test Structure

tests/
  conftest.py           # Shared fixtures
  factories/            # Test data factories
    agent_factory.py
    user_factory.py
  unit/                 # Unit tests
    test_user_service.py
    test_user_model.py
  integration/          # Integration tests
    test_health_endpoint.py

Writing Tests

import pytest
from services.user_service import UserService

def test_create_user():
    service = UserService()
    user = service.create_user(name="Test User")
    assert user.name == "Test User"

Using Factories

from tests.factories.user_factory import UserFactory

def test_user_with_factory():
    user = UserFactory.create()
    assert user.id is not None

Configuration

• pytest configuration: pytest.ini
• Coverage configuration: .coveragerc

Related Documentation

• Unit Testing Guide
• Integration Testing Guide
• Coverage Requirements