db

package

v1.0.0 Latest Latest Go to latest Published: Jun 25, 2020 License: Unlicense Imports: 3 Imported by: 0

Details

Valid go.mod file

The Go module system was introduced in Go 1.11 and is the official dependency management solution for Go.
Redistributable license

Redistributable licenses place minimal restrictions on how software can be used, modified, and redistributed.
Tagged version

Modules with tagged versions give importers more predictable builds.
Stable version

When a project reaches major version v1 it is considered stable.
Learn more about best practices

Package db implements a Postgres client for applying, querying, and recording migrations.

This section is empty.

This section is empty.

This section is empty.

type Client struct {
	// contains filtered or unexported fields
}

Client is a migration database connection.

func Connect(uri string) (*Client, error)

Connect connects to the Postgres database at the given uri.

func (c *Client) Close() error

Close closes the underlying database connection.

func (c *Client) Exec(sql string) error

ApplyMigration executes the given statements against the database, and then records that the migration has been applied.

func (c *Client) GetMigrations() ([]*Migration, error)

GetMigrations returns all migrations that have been applied to the database.

func (c *Client) LogCompletedMigration(name string) error

func (c *Client) TryLock() (bool, error)

TryLock attempts to acquire an exclusive lock for running migrations on this database.

func (c *Client) Unlock() (bool, error)

Unlock unlocks the exclusive migration lock.

type Migration struct {
	Name string
}

Migration is a migration that's been applied to the database.