testutil

Documentation

Overview

Package testutil provides testing helpers.

Index

• func AssertEqual[T types.Type](t testing.TB, expected, actual T) bool
• func AssertNotEqual[T types.Type](t testing.TB, expected, actual T) bool
• func CompareAndSetByPathNum[T types.CompositeTypeInterface](tb testing.TB, expected, actual T, delta float64, path ...string)
• func CompareAndSetByPathTime[T types.CompositeTypeInterface](tb testing.TB, expected, actual T, delta time.Duration, path ...string)
• func Ctx(tb testing.TB) context.Context
• func Dump[T types.Type](tb testing.TB, o T) string
• func Equal[T types.Type](v1, v2 T) bool
• func GetByPath[T types.CompositeTypeInterface](tb testing.TB, comp T, path ...string) any
• func MustParseDumpFile(path ...string) []byte
• func ParseDump(tb testing.TB, s string) []byte
• func ParseDumpFile(tb testing.TB, path ...string) []byte
• func Pool(_ context.Context, tb testing.TB, opts *PoolOpts, l *zap.Logger) *pgdb.Pool
• func Schema(ctx context.Context, tb testing.TB, pool *pgdb.Pool) string
• func SchemaName(tb testing.TB) string
• func SetByPath[T types.CompositeTypeInterface](tb testing.TB, comp T, value any, path ...string)
• func Table(ctx context.Context, tb testing.TB, pool *pgdb.Pool, db string) string
• func TableName(tb testing.TB) string
• func WriteSeedCorpusFile(tb testing.TB, funcName string, b []byte)
• type PoolOpts

Functions

func AssertEqual

func AssertEqual[T types.Type](t testing.TB, expected, actual T) bool

AssertEqual asserts that two BSON values are equal.

func AssertNotEqual

func AssertNotEqual[T types.Type](t testing.TB, expected, actual T) bool

AssertNotEqual asserts that two BSON values are not equal.

func CompareAndSetByPathNum

func CompareAndSetByPathNum[T types.CompositeTypeInterface](tb testing.TB, expected, actual T, delta float64, path ...string)

CompareAndSetByPathNum asserts that two values with the same path in two objects (documents or arrays) are within a given numerical delta, then updates the expected object with the actual value.

func CompareAndSetByPathTime

func CompareAndSetByPathTime[T types.CompositeTypeInterface](tb testing.TB, expected, actual T, delta time.Duration, path ...string)

CompareAndSetByPathTime asserts that two values with the same path in two objects (documents or arrays) are within a given time delta, then updates the expected object with the actual value.

func Ctx

func Ctx(tb testing.TB) context.Context

func Dump

func Dump[T types.Type](tb testing.TB, o T) string

Dump returns string representation for debugging.

func Equal

func Equal[T types.Type](v1, v2 T) bool

Equal compares any BSON values.

func GetByPath

func GetByPath[T types.CompositeTypeInterface](tb testing.TB, comp T, path ...string) any

GetByPath returns a value by path - a sequence of indexes and keys.

func MustParseDumpFile

func MustParseDumpFile(path ...string) []byte

func ParseDump

func ParseDump(tb testing.TB, s string) []byte

func ParseDumpFile

func ParseDumpFile(tb testing.TB, path ...string) []byte

func Pool

func Pool(_ context.Context, tb testing.TB, opts *PoolOpts, l *zap.Logger) *pgdb.Pool

Pool creates a new connection connection pool for testing.

func Schema

func Schema(ctx context.Context, tb testing.TB, pool *pgdb.Pool) string

Schema creates a new FerretDB database / PostgreSQL schema for testing.

Name is stable for that test. It is automatically dropped if test pass.

func SchemaName

func SchemaName(tb testing.TB) string

SchemaName returns a stable schema name for that test.

func SetByPath

func SetByPath[T types.CompositeTypeInterface](tb testing.TB, comp T, value any, path ...string)

SetByPath sets the value by path - a sequence of indexes and keys.

The path must exist.

func Table

func Table(ctx context.Context, tb testing.TB, pool *pgdb.Pool, db string) string

Table creates FerretDB collection / PostgreSQL table for testing.

Name is stable for that test.

func TableName

func TableName(tb testing.TB) string

TableName returns a stable table name for that test.

func WriteSeedCorpusFile

func WriteSeedCorpusFile(tb testing.TB, funcName string, b []byte)

WriteSeedCorpusFile adds given data to the fuzzing seed corpus for given fuzz function.

It can be an alternative to using f.Add.

Types

type PoolOpts

type PoolOpts struct {
	// If set, the pool will use read-only user.
	ReadOnly bool
}

PoolOpts represents options for creating a connection pool.