testutil

Documentation

Index

• Constants
• func BeginAll() ([]*sql.Tx, error)
• func CreateTestDatabase(ctx context.Context, opts ...db.Option) (*db.Connection, error)
• func DefaultDB() *db.Connection
• func DefaultDBs() []*db.Connection
• func DropTestDatabase(ctx context.Context, conn *db.Connection, opts ...db.Option) error
• func RollbackAll(txs ...*sql.Tx) error
• type MockTransitClient
  • func (m MockTransitClient) Decrypt(ctx context.Context, key string, context []byte, ciphertext string) ([]byte, error)
  • func (m MockTransitClient) Encrypt(ctx context.Context, key string, context, data []byte) (string, error)
• type Option
  • func OptAfter(steps ...SuiteAction) Option
  • func OptBefore(steps ...SuiteAction) Option
  • func OptLog(log logger.Log) Option
  • func OptWithDefaultDB() Option
  • func OptWithDefaultDBs(count int) Option
• type Suite
  • func New(m *testing.M, opts ...Option) *Suite
  • func (s Suite) Run()
• type SuiteAction

Constants

const (
	SuiteFailureTests  = 1
	SuiteFailureBefore = 2
	SuiteFailureAfter  = 3
)

FailureCodes

Functions

func BeginAll

func BeginAll() ([]*sql.Tx, error)

BeginAll begins a transaction in each of the underlying connections. If an error is raised by *any* of the connections, t

func CreateTestDatabase

func CreateTestDatabase(ctx context.Context, opts ...db.Option) (*db.Connection, error)

CreateTestDatabase creates a randomized test database.

func DefaultDB

func DefaultDB() *db.Connection

DefaultDB returns a default database connection for tests.

func DefaultDBs

func DefaultDBs() []*db.Connection

DefaultDBs returns a default set database connections for tests.

func DropTestDatabase

func DropTestDatabase(ctx context.Context, conn *db.Connection, opts ...db.Option) error

DropTestDatabase drops a database.

func RollbackAll

func RollbackAll(txs ...*sql.Tx) error

RollbackAll calls `Rollback` on a set of transactions.

Types

type MockTransitClient

type MockTransitClient struct {
	vault.Client
}

MockTransitClient skips interactions with the vault for encryption/decryption

func (MockTransitClient) Decrypt

func (m MockTransitClient) Decrypt(ctx context.Context, key string, context []byte, ciphertext string) ([]byte, error)

Decrypt just returns the input in the mock

func (MockTransitClient) Encrypt

func (m MockTransitClient) Encrypt(ctx context.Context, key string, context, data []byte) (string, error)

Encrypt just returns the input in the mock

type Option

type Option func(*Suite)

Option is a mutator for a test suite.

func OptAfter

func OptAfter(steps ...SuiteAction) Option

OptAfter appends after run actions.

func OptBefore

func OptBefore(steps ...SuiteAction) Option

OptBefore appends before run actions.

func OptLog

func OptLog(log logger.Log) Option

OptLog sets the suite logger.

func OptWithDefaultDB

func OptWithDefaultDB() Option

OptWithDefaultDB runs a test suite with a dedicated database connection.

func OptWithDefaultDBs

func OptWithDefaultDBs(count int) Option

OptWithDefaultDBs runs a test suite with a count of database connections. Note: this type of connection pool is used in rare circumstances for performance reasons; you probably want to use `OptWithDefaultDB` for your tests.

type Suite

type Suite struct {
	M      *testing.M
	Log    logger.Log
	Before []SuiteAction
	After  []SuiteAction
}

Suite is a set of before and after actions for a given package tests.

func New

func New(m *testing.M, opts ...Option) *Suite

New returns a new test suite.

func (Suite) Run

func (s Suite) Run()

Run runs tests and returns the exit code.

type SuiteAction

type SuiteAction func(context.Context) error

SuiteAction is a step that can be run either before or after package tests.