pgtest

package

v0.18.0 Latest Latest Go to latest Published: Oct 20, 2026 License: MIT Imports: 9 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/plexusone/systemforge

Links

Open Source Insights

Documentation ¶

Overview ¶

Package pgtest provides throwaway PostgreSQL databases for integration tests. Tests are skipped unless SF_TEST_PG_DSN points at a server where the user may create databases, for example:

SF_TEST_PG_DSN='postgres://user@127.0.0.1:5432/postgres?sslmode=disable'

Constants ¶

View Source

const EnvDSN = "SF_TEST_PG_DSN"

EnvDSN names the environment variable holding the admin DSN.

View Source

const EnvRequired = "SF_TEST_PG_REQUIRED"

EnvRequired, when set to any value, makes a missing EnvDSN fail the test instead of skipping it, so a CI job meant to run PostgreSQL tests cannot pass without running them.

Variables ¶

This section is empty.

Functions ¶

func DSN ¶

func DSN(t testing.TB) string

DSN returns a DSN for a fresh scratch database that is dropped when the test ends. It skips the test when EnvDSN is unset.

func Open ¶

func Open(t testing.TB) *sql.DB

Open returns a *sql.DB for a fresh scratch database, closed and dropped when the test ends. It skips the test when EnvDSN is unset.

Types ¶

This section is empty.

Source Files ¶

View all Source files

pgtest.go

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL