tests/
│
├── __init__.py
│
├── conftest.py                 # Global pytest fixtures (DB, clients, settings)
│
├── factories/                  # Data builders / model factories
│   ├── __init__.py
│   └── user_factory.py
│
├── utils/                      # Shared testing utilities
│   ├── __init__.py
│   └── jwt_helpers.py
│
├── unit/                       # Pure unit tests (no DB, no FastAPI)
│   ├── __init__.py
│   └── test_helpers.py
│
├── integration/                # API + DB tests, Async tests
│   ├── __init__.py
│   ├── test_users.py
│   └── test_auth.py
│
└── e2e/                        # End-to-end tests (simulate full behavior)
    ├── __init__.py
    └── test_full_flow.py

import pytest
from httpx import AsyncClient
from app.main import app

@pytest.fixture
async def client():
    async with AsyncClient(app=app, base_url="http://test") as c:
        yield c

def user_payload(username="alice", job="Engineer"):
    return {"username": username, "job": job}

from app.auth import create_access_token

def get_token(user="test_user"):
    return create_access_token({"sub": user})

from app.utils.math import add

def test_add():
    assert add(2, 3) == 5

import pytest

@pytest.mark.asyncio
async def test_create_user(client):
    response = await client.post("/users", params={"username": "bob", "job": "Manager"})
    assert response.status_code == 200

@pytest.mark.asyncio
async def test_user_full_flow(client):
    # Create user
    res = await client.post("/users", params={"username": "eva", "job": "Dev"})
    assert res.status_code == 200

    # Fetch user
    res = await client.get("/users/eva")
    assert res.json()["job"] == "Dev"