compat

type Adoption struct {
	// Tool is the migration tool whose history this replaces (ToolGoose).
	Tool string
	// Versions is every version that tool recorded for the history this
	// migration replaces: ascending, distinct, each positive.
	Versions []int64
	// Line is the 1-based line of the first directive, for messages.
	Line int
}

type AdoptionSyntaxError struct {
	Line   int
	Reason string
}

type Declaration struct {
	// Line is the 1-based line it is on.
	Line int
	// Reason is the text after the directive, with the separator a reader
	// types (`—`, `-`, `:`) trimmed; "" when there is none. A reason that
	// starts with `<` is a template placeholder (`<why …>`), not a reason,
	// and reads as "".
	Reason string
}

type Migration struct {
	// Version is the numeric prefix — the value golang-migrate records in
	// schema_migrations.
	Version uint
	// Name is the filename, for messages.
	Name string
	// Descriptor is the filename between the version prefix and `.up.` —
	// `retire_plan_compute_free` in `00091_retire_plan_compute_free.up.sql`.
	// It is what identifies WHICH migration a version is: two branches that
	// both claim 91 differ here, while a change of zero-padding does not.
	Descriptor string
	// BackwardCompatible is whether the file carries Directive (and not
	// BreaksRollbackDirective as well; see Declared).
	BackwardCompatible bool
	// BreaksRollback is whether the file carries BreaksRollbackDirective.
	BreaksRollback bool
	// Adopts is the foreign history this migration replaces, from its
	// AdoptsDirective lines; nil when it declares none. See adopt.go.
	Adopts *Adoption
	// Timeouts is the file's lock_timeout / statement_timeout override, from
	// its TimeoutDirectives lines; the zero value declares none. See
	// timeouts.go.
	Timeouts Timeouts
}

type TimeoutSyntaxError struct {
	Line   int
	Reason string
}

type Timeouts struct {
	Lock      *time.Duration
	Statement *time.Duration
}