testing.md

Testing

The project uses pytest for automated testing.

Running the Tests

Run the regular test suite in tests/ with:

uv run pytest

The test suite covers:

• Public Python API behavior (seriousdb.api)
• CRUD operations
• Error handling
• Concurrent database access
• Logging

Each test uses an isolated temporary database so the test suite does not modify the local .sdb database.

The benchmark scenarios run separately using the commands below.

Performance benchmarks

From the repository root, run the benchmark suite with compact output and saved results:

uv run --locked --group benchmark -m benchmarks

See the benchmark guide for run instructions and guidance on comparing results. Individual benchmark functions document their workloads and timing boundaries.