gomig

Documentation

Overview

Package gomig TODO: add documentation

Index

• Variables
• type BackendAdapter
• type Migration
• type Runner
  • func NewRunner(migs []Migration, storage BackendAdapter) *Runner
  • func (r *Runner) Auto() error
  • func (r *Runner) ForceVer(ver uint) error
  • func (r *Runner) Reset() error
  • func (r *Runner) SetVer(ver uint) error

Variables

var (
	// ErrNoBackend returned by runners if no BackendAdapter set
	ErrNoBackend = errors.New("NO_BACKEND")
	// ErrNoMigrations returns by NewRunner if no migrations provided
	ErrNoMigrations = errors.New("NO_MIGRATIONS")
	// ErrMigrationFailed returned by runners if migration was failed
	ErrMigrationFailed = errors.New("MIGRATION_FAILED")
)

Types

type BackendAdapter

type BackendAdapter interface {
	GetVersion() (uint, error)
	SaveVersion(ver uint, messages []string) error
	Reset() error
}

BackendAdapter TODO: Add documentation

type Migration

type Migration interface {
	Up() (messages []string, err error)
	Down() (messages []string, err error)
	Name() string
}

Migration TODO: Add documentation

type Runner

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

Runner the runner of migrations

func NewRunner

func NewRunner(migs []Migration, storage BackendAdapter) *Runner

NewRunner creates the runner

func (*Runner) Auto

func (r *Runner) Auto() error

Auto runs the migrations from the current version up to the latest

func (*Runner) ForceVer

func (r *Runner) ForceVer(ver uint) error

ForceVer calls Reset then runs migrations up to the ver number

func (*Runner) Reset

func (r *Runner) Reset() error

Reset runs all migrations down to the clean state and calls to Reset of storage

func (*Runner) SetVer

func (r *Runner) SetVer(ver uint) error

SetVer runs migrations up or down to the ver number