Documentation
¶
Overview ¶
Package testutils provides shared integration-test helpers.
Index ¶
- func DecodeData(t testing.TB, w *httptest.ResponseRecorder) map[string]any
- func Do(t testing.TB, r http.Handler, method, path, body string) *httptest.ResponseRecorder
- func DoForm(t testing.TB, r http.Handler, method, path string, values url.Values) *httptest.ResponseRecorder
- func SkipWithoutDocker(t testing.TB)
- func WithAdminHeader(req *http.Request) *http.Request
- func WithCookie(req *http.Request, name, token string) *http.Request
- type ContainerExecutor
- type Envelope
- type Mailpit
- type MinIO
- type Postgres
- func (p *Postgres) ContainerID() string
- func (p *Postgres) CopyFileFromContainer(ctx context.Context, containerPath, hostPath string) error
- func (p *Postgres) CopyFileToContainer(ctx context.Context, hostPath, containerPath string) error
- func (p *Postgres) Exec(ctx context.Context, cmd []string) (int, string, error)
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func DecodeData ¶
DecodeData parses the envelope and returns the data object.
func Do ¶
Do sends one request with an optional JSON body and returns the recorder. An empty body sends no body at all.
func DoForm ¶
func DoForm(t testing.TB, r http.Handler, method, path string, values url.Values) *httptest.ResponseRecorder
DoForm sends one form-encoded request (OAuth/OIDC endpoints).
func SkipWithoutDocker ¶
SkipWithoutDocker skips the test when no healthy Docker provider is available. This lets container-based integration tests skip on hosts without a daemon — e.g. GitHub-hosted macOS runners, which lack nested virtualization and cannot run a Linux VM for Docker. It mirrors testcontainers.SkipIfProviderIsNotHealthy but accepts testing.TB.
func WithAdminHeader ¶
WithAdminHeader marks a request for the stub admin guard used by handler tests.
Types ¶
type ContainerExecutor ¶
type ContainerExecutor struct {
PG *Postgres
}
ContainerExecutor runs the PostgreSQL client tools inside the test Postgres container. It structurally satisfies database.Executor, so tests can override database.DefaultExecutor without an import cycle.
Host/port flags are stripped so the tools connect over the container-local Unix socket (trusted auth); env is ignored for the same reason. Files cross the boundary via container copy.
func (*ContainerExecutor) PGDump ¶
func (e *ContainerExecutor) PGDump(ctx context.Context, _ []string, args []string, outputPath string) error
PGDump dumps to a path inside the container, then copies the file to the host output path.
type Envelope ¶
type Envelope struct {
Status string `json:"status"`
Message string `json:"message"`
Data json.RawMessage `json:"data"`
Error json.RawMessage `json:"error"`
Metadata struct {
StatusCode int `json:"status_code"`
RequestID string `json:"request_id"`
} `json:"metadata"`
}
Envelope is the standard response envelope shape.
func DecodeEnvelope ¶
func DecodeEnvelope(t testing.TB, w *httptest.ResponseRecorder) Envelope
DecodeEnvelope parses the standard response envelope.
type Mailpit ¶
type Mailpit struct {
// SMTPAddr is the host:port of the SMTP listener.
SMTPAddr string
// APIURL is the HTTP API base URL (http://host:port).
APIURL string
// Username and Password are the relay credentials.
Username string
Password string
}
Mailpit is a running Mailpit container.
type MinIO ¶
type MinIO struct {
// Endpoint is the S3 API address (http://host:port).
Endpoint string
// AccessKey and Secret are the root credentials.
AccessKey string
Secret string
}
MinIO is a running S3-compatible object store container.
type Postgres ¶
type Postgres struct {
// DSN is the connection string of the shared instance.
DSN string
// contains filtered or unexported fields
}
Postgres is a running Postgres container for integration tests.
func StartPostgres ¶
StartPostgres returns the shared Postgres container for the test binary.
func (*Postgres) ContainerID ¶
ContainerID returns the container ID for debugging.
func (*Postgres) CopyFileFromContainer ¶
CopyFileFromContainer copies a file from the container to the host.
func (*Postgres) CopyFileToContainer ¶
CopyFileToContainer copies a file from host to container.
Source Files