README
migration
The migration package provides a way to generate, list, and apply PostgreSQL database migrations. The package can be imported like so:
import (
"code.soquee.net/migration"
)
License
The package may be used under the terms of the BSD 2-Clause License a copy of
which may be found in the LICENSE
file.
Unless you explicitly state otherwise, any contribution submitted for inclusion in the work by you shall be licensed as above, without any additional terms or conditions.
Documentation
Overview ¶
Package migration contains functions for generating and finding PostgreSQL database migrations.
Index ¶
Constants ¶
Variables ¶
Functions ¶
Types ¶
type RunStatus ¶
type RunStatus int
RunStatus is a type that indicates if a migration has been run, not run, or if we can't determine the status.
type WalkFunc ¶
WalkFunc is the type of the function called for each file or directory visited by a Walker.
type Walker ¶
Walker is a function that can be used to walk a filesystem and calls WalkFunc for each migration.
func NewWalker ¶
NewWalker queries the database for migration status information and returns a function that walks the migrations it finds on the filesystem in lexical order (mostly, keep reading) and calls a function for each discovered migration, passing in its name, status, and file information.
If a migration exists in the database but not on the filesystem, info will be nil and f will be called for it after the migrations that exist on the filesystem. No particular order is guaranteed for calls to f for migrations that do not exist on the filesystem.
If NewWalker returns an error and a non-nil function, the function may still be used to walk the migrations on the filesystem but the status information may be wrong since the DB may not have been queried successfully.