Documentation
¶
Overview ¶
Package testutil provides testing utilities for database integration tests.
Environment Variables:
Database connection strings can be customized via environment variables:
- TEST_POSTGRES_DSN: PostgreSQL connection string (default: postgres://testuser:testpassword@localhost:5433/testdb?sslmode=disable)
Database Setup:
db := testutil.SetupPostgresDB(t) defer testutil.TeardownDB(t, db) defer testutil.CleanupPostgresDB(t, db)
Test Fixtures (for foreign key constraints):
clientID := testutil.CreateTestClient(t, db, "postgres", "my-test-client") kekID := testutil.CreateTestKek(t, db, "postgres", "my-test-kek") // Or both: clientID, kekID := testutil.CreateTestClientAndKek(t, db, "postgres", "my-test")
Migration Path:
Migrations are automatically discovered by walking up from the current working directory until a "migrations" directory is found.
Index ¶
- func CleanupPostgresDB(t *testing.T, db *sql.DB)
- func CreateTestClient(t *testing.T, db *sql.DB, name string) uuid.UUID
- func CreateTestClientAndKek(t *testing.T, db *sql.DB, baseName string) (clientID, kekID uuid.UUID)
- func CreateTestDek(t *testing.T, db *sql.DB, name string, kekID uuid.UUID) uuid.UUID
- func CreateTestKek(t *testing.T, db *sql.DB, name string) uuid.UUID
- func GetPostgresTestDSN() string
- func SetupPostgresDB(t *testing.T) *sql.DB
- func SkipIfNoPostgres(t *testing.T)
- func TeardownDB(t *testing.T, db *sql.DB)
- func ValidateTestClient(t *testing.T, db *sql.DB, clientID uuid.UUID) bool
- func ValidateTestDek(t *testing.T, db *sql.DB, dekID uuid.UUID) bool
- func ValidateTestKek(t *testing.T, db *sql.DB, kekID uuid.UUID) bool
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func CleanupPostgresDB ¶
CleanupPostgresDB truncates all tables in the PostgreSQL database.
func CreateTestClient ¶ added in v0.9.0
CreateTestClient creates a minimal active test client for repository tests. Returns the client ID for use in foreign key relationships. The client is created with a wildcard policy allowing all capabilities on all paths.
func CreateTestClientAndKek ¶ added in v0.9.0
CreateTestClientAndKek creates both a test client and KEK, returning both IDs. Convenience wrapper for tests that need both fixtures.
func CreateTestDek ¶ added in v0.22.0
CreateTestDek creates a minimal test DEK (Data Encryption Key) for repository tests. Returns the DEK ID. The DEK is associated with the provided KEK ID.
func CreateTestKek ¶ added in v0.9.0
CreateTestKek creates a minimal test KEK for repository tests that need to reference a KEK (e.g., signed audit logs). Returns the KEK ID. The KEK is created with algorithm 'aes-gcm' and random encrypted key data.
func GetPostgresTestDSN ¶ added in v0.22.0
func GetPostgresTestDSN() string
GetPostgresTestDSN returns the PostgreSQL test DSN, checking environment variable first.
func SetupPostgresDB ¶
SetupPostgresDB creates a new PostgreSQL database connection and runs migrations.
func SkipIfNoPostgres ¶ added in v0.22.0
SkipIfNoPostgres skips the test if PostgreSQL test database is not available. Useful for running tests in environments without database access.
func TeardownDB ¶
TeardownDB closes the database connection and cleans up.
func ValidateTestClient ¶ added in v0.22.0
ValidateTestClient verifies that a test client was created with expected values. Returns true if the client exists and is active, false if it does not exist. Fails the test if a database error occurs.
func ValidateTestDek ¶ added in v0.23.0
ValidateTestDek verifies that a test DEK was created with expected values. Returns true if the DEK exists, false if it does not exist. Fails the test if a database error occurs.
Types ¶
This section is empty.
Source Files