dbwarden Test Harness

dbwarden Test Harness

Release confidence through real databases and public interfaces.

Documentation  |  Source Code  |  dbwarden

The dbwarden Test Harness is the release boundary between dbwarden development and dbwarden consumption.

It installs dbwarden as an external package, invokes public commands, runs against real disposable databases, and checks the resulting state. The harness is intentionally separate from the dbwarden source repository because source tests and consumer tests answer different questions.

Start here¶

• Read Why a Harness? for the design rationale.
• Follow Setup to install the locked environment.
• Use Running Tests for local and CI commands.
• Read Correctness to understand what a passing test means.
• Check Compatibility Findings before interpreting an experimental failure.

What is validated¶

The harness validates distribution installation, public CLI behavior, migration application, rollback, reverse engineering, semantic convergence, provider isolation, plugin discovery, adoption flows, offline state, and performance.

The primary unit of confidence is not a generated SQL string. It is a complete consumer flow that produces the expected live database state and can explain why it passed or failed.

Repository¶

The source repository is available at dbwarden-org/dbwarden-harness.

The product being tested is documented at dbwarden-org/dbwarden.

For machine-readable documentation, use