Testing¶

Testing strategies and commands for Go, Python, and TypeScript components.

Go Tests¶

Running Tests¶

# All Go tests
make test

# Specific package
go test ./internal/gateway/middleware/...

# With verbose output
go test -v ./...

# With race detection
go test -race ./...

Test Patterns¶

Table-driven tests with t.Run subtests:

func TestAuthMiddleware(t *testing.T) {
    tests := []struct {
        name       string
        token      string
        wantStatus int
    }{
        {"valid token", validJWT, http.StatusOK},
        {"expired token", expiredJWT, http.StatusUnauthorized},
        {"missing token", "", http.StatusUnauthorized},
    }

    for _, tt := range tests {
        t.Run(tt.name, func(t *testing.T) {
            t.Parallel()
            // ... test logic
        })
    }
}

Integration tests use httptest.NewServer:

func TestHealthEndpoint(t *testing.T) {
    srv := httptest.NewServer(router.New(testConfig))
    defer srv.Close()

    resp, err := http.Get(srv.URL + "/health")
    require.NoError(t, err)
    assert.Equal(t, http.StatusOK, resp.StatusCode)
}

Python Tests¶

Running Tests¶

# Per service
cd services/scout && pytest

# With coverage
cd services/scout && pytest --cov=src --cov-report=term-missing

# Specific test file
cd services/scout && pytest tests/test_trends.py

# Verbose
cd services/scout && pytest -v

Test Patterns¶

Fixtures for database sessions and test clients:

import pytest
from httpx import AsyncClient, ASGITransport
from src.main import app


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


@pytest.mark.asyncio
async def test_health(client: AsyncClient):
    resp = await client.get("/health")
    assert resp.status_code == 200
    assert resp.json()["status"] == "ok"

The project targets 80%+ code coverage for all Python services.

Dashboard Tests¶

Running Tests¶

cd dashboard && npm test

# Watch mode
cd dashboard && npm run test:watch

CLI Tests¶

# Run CLI tests
make cli-test

# Or directly
cd cli && uv run pytest

E2E Tests¶

End-to-end tests validate the full service stack using mock servers and Docker Compose:

# Run E2E test suite
make test-e2e

This uses deploy/docker-compose.e2e.yml with mock servers in tests/e2e/mocks/. Tests cover:

• Golden path — Full pipeline from trend detection to publishing
• Auth flow — Login, token refresh, and authorization
• Event flow — Redis pub/sub event propagation between services
• Error recovery — Service failure handling and retry logic

Performance Benchmarks¶

pytest-benchmark¶

# Run benchmark suite
make bench

Benchmarks in tests/benchmark/ measure:

• Gateway throughput (test_gateway_throughput.py)
• Event bus latency (test_event_bus_latency.py)
• Database query performance (test_db_query_perf.py)
• Pipeline end-to-end latency (test_pipeline_latency.py)

Baselines are stored in tests/benchmark/baselines.json.

Locust load testing¶

# Start Locust web UI at :8089
make load-test

Testing Checklist¶