dbtest

Documentation

Overview

Package dbtest has utilities to help with writing DB related tests in conjunction with sqlize.

Index

• Constants
• Variables
• func ColNoConst(t testing.TB, td bsq.TableDef, colNo int)
• func DriverName(t TB, fallback string) string
• func NewLogger(t interface{ ... }) sqlize.Logger
• func Open(t *testing.T, drv driver.Driver, source string, log sqlize.LogFlag) (*sql.DB, error)
• func OpenArgs(t TB, drvFallback, srcFallback string) (driver, source string)
• func ShallOpen(t *testing.T, drv driver.Driver, source string, log sqlize.LogFlag) *sql.DB
• func SourceName(t TB, fallback string) string
• func VerifyTable(t testing.TB, q sqlize.Querier, def bsq.TableDef, d Dialect) (ok bool)
• func VerifyTables(t testing.TB, q sqlize.Querier, d Dialect) (ok bool)
• type CRUDTest
  • func (crud CRUDTest[E, I]) Run(t *testing.T, db sqlize.Querier)
  • func (crud CRUDTest[E, I]) Update(name string, mod func(*E)) CRUDTest[E, I]
• type Dialect
• type FieldDiff
  • func FieldEq[F comparable](e FieldDiff, hint string, l, r F) FieldDiff
  • func FieldEqual[F interface{ ... }](e FieldDiff, hint string, l, r F) FieldDiff
  • func (d FieldDiff) Error() error
• type TB

Constants

const (
	ENV_DBDRIVER = "SQLIZE_TESTDB_DRIVER"
	ENV_DBSOURCE = "SQLIZE_TESTDB_SOURCE"
)

Variables

var ExampleTB exampleTB

Functions

func ColNoConst

func ColNoConst(t testing.TB, td bsq.TableDef, colNo int)

func DriverName

func DriverName(t TB, fallback string) string

func NewLogger

func NewLogger(t interface{ Logf(string, ...any) }) sqlize.Logger

NewLogger creates a new logger to be used with sqlize.LogDriver. For an example read the test TestNewLogger.

func Open

func Open(t *testing.T, drv driver.Driver, source string, log sqlize.LogFlag) (*sql.DB, error)

func OpenArgs

func OpenArgs(t TB, drvFallback, srcFallback string) (driver, source string)

func ShallOpen

func ShallOpen(t *testing.T, drv driver.Driver, source string, log sqlize.LogFlag) *sql.DB

func SourceName

func SourceName(t TB, fallback string) string

func VerifyTable

func VerifyTable(t testing.TB, q sqlize.Querier, def bsq.TableDef, d Dialect) (ok bool)

func VerifyTables

func VerifyTables(t testing.TB, q sqlize.Querier, d Dialect) (ok bool)

Types

type CRUDTest

type CRUDTest[E entity.Entity[I], I entity.ID] struct {
	Repo         entity.Repo[E, I]
	Create, Read *E
	Equal        func(e, f *E) error
	// contains filtered or unexported fields
}

func (CRUDTest[E, I]) Run

func (crud CRUDTest[E, I]) Run(t *testing.T, db sqlize.Querier)

func (CRUDTest[E, I]) Update

func (crud CRUDTest[E, I]) Update(name string, mod func(*E)) CRUDTest[E, I]

type Dialect

type Dialect interface {
	SQLSelect1Row(table string) string
}

type FieldDiff

type FieldDiff []error

func FieldEq

func FieldEq[F comparable](e FieldDiff, hint string, l, r F) FieldDiff

func FieldEqual

func FieldEqual[F interface{ Equal(F) bool }](e FieldDiff, hint string, l, r F) FieldDiff

func (FieldDiff) Error

func (d FieldDiff) Error() error

type TB

type TB interface {
	Log(args ...any)
	Error(args ...any)
}

TB has a subset of methods from testing.TB. It is implemented by [Errorer].