voyager

type Migration struct {
	Name       string
	Version    int
	Direction  string
	Statements []string
	Strategy   Strategy
}

type Migrator interface {
	// CurrentVersion reports the current migration version
	// of the database.
	CurrentVersion(lager.Logger, *sql.DB) (int, error)

	// SupportedVersion reports the latest possible migration
	// version that can be applied.
	SupportedVersion(lager.Logger) (int, error)

	// Migrate migrates the database to the given migration version.
	// Implementations must also updates the migrations_history table'
	// with the status of each migration that is run.
	Migrate(lager.Logger, *sql.DB, int) error

	// Up is equivalent to calling Migrate with the latest supported
	// version.
	Up(lager.Logger, *sql.DB) error
}

type Parser interface {
	// ParseMigrationFilename is used to populate metadata into a Migration,
	// e.g. whether the given migration is a Go or SQL migration. It is used
	// to determine the Migration strategy
	ParseMigrationFilename(lager.Logger, string) (Migration, error)

	// ParseFileToMigration is used to parse the actual contents of a given
	// migration file into a runnable Migration.
	ParseFileToMigration(lager.Logger, string) (Migration, error)
}

type SchemaAdapter interface {
	// MigrateFromOldSchema converts from an old database schema to
	// Voyager's migrations_history schema.
	// It returns the latest successful migration version recorded by
	// the old schema, or 0 if the old schema does not exist.
	//
	// The version returned by MigrateFromOldSchema will be used as the
	// first version in the migrations_history table.
	//
	// It is called every time an `up` migration is run, so implementations
	// are responsible for returning a sane default version in the case that
	// the old schema is no longer used.
	MigrateFromOldSchema(*sql.DB, int) (int, error)

	// MigrateToOldSchema converts from the new migrations_history schema
	// to the old schema. It exists to support migrating back down to a
	// previous migration version.
	//
	// It is called every time a `down` migration is run.
	MigrateToOldSchema(*sql.DB, int) error

	// CurrentVersion reports the current successful migration version
	// as recorded by the old schema. It is called only if the
	// migrations_history schema does not exist.
	CurrentVersion(*sql.DB) (int, error)
}

type Source interface {
	AssetNames() []string
	Asset(name string) ([]byte, error)
}

type Strategy int