dbtest

Documentation

Index

• type DB
  • func Postgres(t testing.TB) *DB
  • func (db *DB) Close()
  • func (db *DB) Load(sql string) *DB
  • func (db *DB) Open() *sqlx.DB
  • func (db *DB) Version() (major int)

Types

type DB

type DB struct {
	Dialect string
	DSN     string
	// contains filtered or unexported fields
}

DB represents an ephemeral database that starts blank and can be used to run tests against.

func Postgres

func Postgres(t testing.TB) *DB

Postgres provisions a new, blank database with a random name on the localhost of the running process. It assumes that you have postgres running on the default port, have the command line postgres tools installed, and that the current user has access to the server. It panics on the event of a failure.

func (*DB) Close

func (db *DB) Close()

Close closes and deletes the database represented by `db`

func (*DB) Load

func (db *DB) Load(sql string) *DB

Load executes all of the statements in the provided sql script against the test database, panicking if any fail. The receiver is returned allowing for chain-style calling within your test functions.

func (*DB) Open

func (db *DB) Open() *sqlx.DB

Open opens a sqlx connection to the db.

func (*DB) Version

func (db *DB) Version() (major int)