testutil

Documentation

Overview

Package testutil provides testing helpers.

Index

• 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 CreateTable(ctx context.Context, tb testing.TB, pool *pg.Pool, db string) string
• func Ctx(tb testing.TB) context.Context
• func Dump[T types.Type](tb testing.TB, o T) string
• 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) *pg.Pool
• func Schema(ctx context.Context, tb testing.TB, pool *pg.Pool) string
• func SchemaName(tb testing.TB) string
• func SetByPath[T types.CompositeTypeInterface](tb testing.TB, comp T, value any, path ...string)
• func TableName(tb testing.TB) string
• type PoolOpts

Functions

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 CreateTable

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

CreateTable creates FerretDB collection / PostgreSQL table for testing.

Name is stable for that test.

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 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) *pg.Pool

Pool creates a new connection connection pool for testing.

func Schema

func Schema(ctx context.Context, tb testing.TB, pool *pg.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 TableName

func TableName(tb testing.TB) string

TableName returns a stable table name for that test.

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.