Feat/testcontainers

database/sql/postgres/001_init.sql

@@ -0,0 +1,8 @@
+create table roster (
+    given_name text
+    , family_name text
+)
+
+---- create above / drop below ----
+
+drop table roster;

database/sql/postgres/fs.go

@@ -0,0 +1,97 @@
+package postgres
+
+import (
+	"context"
+	"fmt"
+	"io/fs"
+
+	"github.com/jackc/pgx/v5"
+	"github.com/jackc/tern/v2/migrate"
+)
+
+const defaultVersionTable string = "schema_version_non_default"
+
+var defaultMigrator = &migrate.MigratorOptions{
+	DisableTx: false,
+}
+
+type FS struct {
+	URL string
+	FS  fs.FS
+}
+
+// Up runs the up migrations on the database.
+func (fsys FS) Up(ctx context.Context) error {
+	conn, err := pgx.Connect(ctx, fsys.URL)
+	if err != nil {
+		return fmt.Errorf("failed to connect: %w", err)
+	}
+	defer func() {
+		ctx = context.WithoutCancel(ctx)
+		conn.Close(ctx)
+	}()
+	migrator, err := migrate.NewMigratorEx(ctx, conn, defaultVersionTable, defaultMigrator)
+	if err != nil {
+		return fmt.Errorf("failed to create migrator: %w", err)
+	}
+	err = migrator.LoadMigrations(fsys.FS)
+	if err != nil {
+		return fmt.Errorf("failed to load migration files: %w", err)
+	}
+	err = migrator.Migrate(ctx) // up
+	if err != nil {
+		return fmt.Errorf("failed to migrate: %w", err)
+	}
+	return nil
+}
+
+// Down runs the down migrations on the database.
+func (fsys FS) Down(ctx context.Context) error {
+	conn, err := pgx.Connect(ctx, fsys.URL)
+	if err != nil {
+		return err
+	}
+	defer func() {
+		ctx = context.WithoutCancel(ctx)
+		conn.Close(ctx)
+	}()
+	migrator, err := migrate.NewMigratorEx(ctx, conn, defaultVersionTable, defaultMigrator)
+	if err != nil {
+		return err
+	}
+	err = migrator.LoadMigrations(fsys.FS)
+	if err != nil {
+		return err
+	}
+	err = migrator.MigrateTo(ctx, 0) // down
+	if err != nil {
+		return err
+	}
+	return nil
+}
+
+// Version runs the migrations to a given target version.
+func (fsys FS) Version(ctx context.Context, ver int32) error {
+	conn, err := pgx.Connect(ctx, fsys.URL)
+	if err != nil {
+		return err
+	}
+	defer func() {
+		ctx = context.WithoutCancel(ctx)
+		conn.Close(ctx)
+	}()
+	migrator, err := migrate.NewMigratorEx(ctx, conn, defaultVersionTable, defaultMigrator)
+	if err != nil {
+		return err
+	}
+	// needed?
+	err = migrator.LoadMigrations(fsys.FS)
+	if err != nil {
+		return err
+	}
+	err = migrator.MigrateTo(ctx, ver) // down
+	if err != nil {
+		return err
+	}
+	return nil
+}

database/sql/postgres/fs_test.go

@@ -0,0 +1,71 @@
+package postgres_test
+
+import (
+	"context"
+	"embed"
+	"errors"
+	"fmt"
+	"os"
+	"testing"
+
+	"github.com/testcontainers/testcontainers-go"
+	. "go.adoublef.dev/database/sql/postgres"
+	"go.adoublef.dev/runtime/container/postgres"
+	"go.adoublef.dev/testing/is"
+)
+
+//go:embed all:*.sql
+var embedFS embed.FS
+
+func TestFS(t *testing.T) {
+	ctx := t.Context()
+
+	p, err := container.ConnectionPool(ctx)
+	is.OK(t, err) // container.ConnectionPool
+	t.Cleanup(func() { p.Close() })
+
+	fsys := &FS{
+		URL: p.Config().ConnString(),
+		FS:  embedFS,
+	}
+
+	is.OK(t, fsys.Up(ctx))   // fsys.Up
+	is.OK(t, fsys.Down(ctx)) // fsys.Down
+}
+
+func TestMain(m *testing.M) {
+	err := setup(context.Background())
+	if err != nil {
+		fmt.Fprintf(os.Stderr, "%v\n", err)
+		os.Exit(1)
+	}
+	code := m.Run()
+	err = cleanup(context.Background())
+	if err != nil {
+		fmt.Fprintf(os.Stderr, "%v\n", err)
+		os.Exit(1)
+	}
+	os.Exit(code)
+}
+
+var container *postgres.Container
+
+// setup initialises containers within the pacakge.
+func setup(ctx context.Context) (err error) {
+	container, err = postgres.Run(ctx, "")
+	if err != nil {
+		return
+	}
+	return
+}
+
+// cleanup stops all running containers for the pacakge.
+func cleanup(ctx context.Context) (err error) {
+	var cc = []testcontainers.Container{container}
+	for _, c := range cc {
+		if c != nil {
+			err = errors.Join(err, c.Terminate(ctx))
+		}
+	}
+	return err
+}

go.mod

@@ -6,38 +6,104 @@ require (
 	github.com/Shopify/toxiproxy/v2 v2.12.0
 	github.com/cenkalti/backoff/v5 v5.0.3
 	github.com/google/uuid v1.6.0
+	github.com/jackc/pgx/v5 v5.7.5
+	github.com/jackc/tern/v2 v2.3.3
 	github.com/matryer/is v1.4.1
 	github.com/mattn/go-sqlite3 v1.14.30
 	github.com/nats-io/nats-server/v2 v2.11.7
 	github.com/prometheus/client_golang v1.23.0
 	github.com/rs/zerolog v1.34.0
+	github.com/testcontainers/testcontainers-go v0.38.0
+	github.com/testcontainers/testcontainers-go/modules/postgres v0.38.0
 	github.com/vmihailenco/msgpack/v5 v5.4.1
 	golang.org/x/net v0.43.0
 	maragu.dev/migrate v0.6.0
 )
 
 require (
+	dario.cat/mergo v1.0.1 // indirect
+	github.com/Azure/go-ansiterm v0.0.0-20210617225240-d185dfc1b5a1 // indirect
+	github.com/Masterminds/goutils v1.1.1 // indirect
+	github.com/Masterminds/semver/v3 v3.3.0 // indirect
+	github.com/Masterminds/sprig/v3 v3.3.0 // indirect
+	github.com/Microsoft/go-winio v0.6.2 // indirect
 	github.com/beorn7/perks v1.0.1 // indirect
+	github.com/cenkalti/backoff/v4 v4.2.1 // indirect
 	github.com/cespare/xxhash/v2 v2.3.0 // indirect
+	github.com/containerd/errdefs v1.0.0 // indirect
+	github.com/containerd/errdefs/pkg v0.3.0 // indirect
+	github.com/containerd/log v0.1.0 // indirect
+	github.com/containerd/platforms v0.2.1 // indirect
+	github.com/cpuguy83/dockercfg v0.3.2 // indirect
+	github.com/davecgh/go-spew v1.1.1 // indirect
+	github.com/distribution/reference v0.6.0 // indirect
+	github.com/docker/docker v28.2.2+incompatible // indirect
+	github.com/docker/go-connections v0.5.0 // indirect
+	github.com/docker/go-units v0.5.0 // indirect
+	github.com/ebitengine/purego v0.8.4 // indirect
+	github.com/felixge/httpsnoop v1.0.4 // indirect
+	github.com/go-logr/logr v1.4.2 // indirect
+	github.com/go-logr/stdr v1.2.2 // indirect
+	github.com/go-ole/go-ole v1.2.6 // indirect
+	github.com/gogo/protobuf v1.3.2 // indirect
 	github.com/google/go-tpm v0.9.5 // indirect
 	github.com/gorilla/mux v1.8.1 // indirect
+	github.com/grpc-ecosystem/grpc-gateway/v2 v2.27.1 // indirect
+	github.com/huandu/xstrings v1.5.0 // indirect
+	github.com/jackc/pgpassfile v1.0.0 // indirect
+	github.com/jackc/pgservicefile v0.0.0-20240606120523-5a60cdf6a761 // indirect
+	github.com/jackc/puddle/v2 v2.2.2 // indirect
 	github.com/klauspost/compress v1.18.0 // indirect
+	github.com/lufia/plan9stats v0.0.0-20211012122336-39d0f177ccd0 // indirect
+	github.com/magiconair/properties v1.8.10 // indirect
 	github.com/mattn/go-colorable v0.1.14 // indirect
 	github.com/mattn/go-isatty v0.0.20 // indirect
 	github.com/minio/highwayhash v1.0.3 // indirect
+	github.com/mitchellh/copystructure v1.2.0 // indirect
+	github.com/mitchellh/reflectwalk v1.0.2 // indirect
+	github.com/moby/docker-image-spec v1.3.1 // indirect
+	github.com/moby/go-archive v0.1.0 // indirect
+	github.com/moby/patternmatcher v0.6.0 // indirect
+	github.com/moby/sys/sequential v0.6.0 // indirect
+	github.com/moby/sys/user v0.4.0 // indirect
+	github.com/moby/sys/userns v0.1.0 // indirect
+	github.com/moby/term v0.5.0 // indirect
+	github.com/morikuni/aec v1.0.0 // indirect
 	github.com/munnerz/goautoneg v0.0.0-20191010083416-a7dc8b61c822 // indirect
 	github.com/nats-io/jwt/v2 v2.8.0 // indirect
 	github.com/nats-io/nkeys v0.4.11 // indirect
 	github.com/nats-io/nuid v1.0.1 // indirect
+	github.com/opencontainers/go-digest v1.0.0 // indirect
+	github.com/opencontainers/image-spec v1.1.1 // indirect
+	github.com/pkg/errors v0.9.1 // indirect
+	github.com/pmezard/go-difflib v1.0.0 // indirect
+	github.com/power-devops/perfstat v0.0.0-20210106213030-5aafc221ea8c // indirect
 	github.com/prometheus/client_model v0.6.2 // indirect
 	github.com/prometheus/common v0.65.0 // indirect
 	github.com/prometheus/procfs v0.17.0 // indirect
 	github.com/rs/xid v1.6.0 // indirect
+	github.com/shirou/gopsutil/v4 v4.25.5 // indirect
+	github.com/shopspring/decimal v1.4.0 // indirect
+	github.com/sirupsen/logrus v1.9.3 // indirect
+	github.com/spf13/cast v1.7.0 // indirect
+	github.com/stretchr/testify v1.10.0 // indirect
+	github.com/tklauser/go-sysconf v0.3.12 // indirect
+	github.com/tklauser/numcpus v0.6.1 // indirect
 	github.com/vmihailenco/tagparser/v2 v2.0.0 // indirect
+	github.com/yusufpapurcu/wmi v1.2.4 // indirect
+	go.opentelemetry.io/auto/sdk v1.1.0 // indirect
+	go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp v0.49.0 // indirect
+	go.opentelemetry.io/otel v1.35.0 // indirect
+	go.opentelemetry.io/otel/metric v1.35.0 // indirect
+	go.opentelemetry.io/otel/sdk v1.35.0 // indirect
+	go.opentelemetry.io/otel/trace v1.35.0 // indirect
 	golang.org/x/crypto v0.41.0 // indirect
+	golang.org/x/sync v0.16.0 // indirect
 	golang.org/x/sys v0.35.0 // indirect
 	golang.org/x/text v0.28.0 // indirect
 	golang.org/x/time v0.12.0 // indirect
+	google.golang.org/grpc v1.73.0 // indirect
 	google.golang.org/protobuf v1.36.7 // indirect
 	gopkg.in/tomb.v1 v1.0.0-20141024135613-dd632973f1e7 // indirect
+	gopkg.in/yaml.v3 v3.0.1 // indirect
 )