testhelper

Documentation

Index

• Constants
• func Addr(t *testing.T, assert *require.Assertions) netip.AddrPort
• func Context(t *testing.T) context.Context
• func Minio(ctx context.Context, t *testing.T, assert *require.Assertions, ...) string
• func Mod[T any](v T, f func(*T)) T
• func Namespace(t *testing.T) string
• func Postgres(ctx context.Context, t *testing.T, assert *require.Assertions) string
• func UnusedTCPPort(t *testing.T, assert *require.Assertions, host string) uint16
• func WaitTCPPort(ctx context.Context, addr string) error

Constants

const (
	MinioImage           = `docker.io/bitnami/minio`
	MinioVersion         = `2023`
	MinioDefaultEndpoint = ``
	MinioDefaultHost     = `localhost`
)

Default values for making nats test container.

const (
	PostgresDBImage           = `postgres`
	PostgresDBVersion         = `16.1`
	PostgresDBDefaultEndpoint = ``
)

Default values for making postgres test container.

const Host = `127.0.0.1`

Host is std test host.

const MaxTimeout = time.Second * 120

MaxTimeout for tests.

Functions

func Addr

func Addr(t *testing.T, assert *require.Assertions) netip.AddrPort

Addr returns free test host:port.

func Context

func Context(t *testing.T) context.Context

Context build new context for tests and set cleanup cancel function.

func Minio

func Minio(
	ctx context.Context,
	t *testing.T,
	assert *require.Assertions,
	accessKey, secretKey, sessionToken string,
	secure bool,
	region string,
) string

Minio build and run test container with file storage.

Notice:

• Starts Minio container;
• Make connections by credentials;

func Mod

func Mod[T any](v T, f func(*T)) T

Mod applies given modification to any value.

func Namespace

func Namespace(t *testing.T) string

func Postgres

func Postgres(
	ctx context.Context,
	t *testing.T,
	assert *require.Assertions,
) string

Postgres build and run test container with database.

Notice:

• Starts postgres container.

func UnusedTCPPort

func UnusedTCPPort(t *testing.T, assert *require.Assertions, host string) uint16

UnusedTCPPort returns random unique unused TCP port at host.

func WaitTCPPort

func WaitTCPPort(ctx context.Context, addr string) error

WaitTCPPort tries to connect to addr until success or ctx.Done.