dbtest

Database testing made easy in Go.

Features

1. Declarative

   Define the minimum test specification in a YAML-based DSL, then all tests can be generated automatically.

2. Customizable

   You can specify your own Go template when generating tests.

3. Opinionated

   • The database is a detail, which means the database-related code should always implement a Go interface.
   • Run database tests against a real database, instead of relying on mocks.
     • The limitation is that running tests in parallel is not supported.
   • Use the same test fixture for all subtests of the same method under test.
   • Only test the public methods, thus the generated tests are in a separate _test package.
   • Leverage TestMain to do global setup and teardown.
   • Prefer table driven tests.

Installation

Make a custom build of protogo:

$ protogo build --plugin=github.com/protogodev/dbtest

Or build from a local fork:

$ protogo build --plugin=github.com/protogodev/dbtest=../my-fork

Usage

$ protogo dbtest -h
Usage: protogo dbtest <source-file><interface-name>
Arguments:
<source-file> source-file
<interface-name> interface-name
Flags:
-h, --help Show context-sensitive help.
--out=STRING output filename (default "./<srcPkgName>_test.go")
--fmt whether to make the test code formatted
--spec="./dbtest.spec.yaml" the test specification in YAML
--tmpl=STRING the template to render (default to builtin template)

Examples

See examples.

Documentation

Check out the Godoc.

License

MIT