upgrade

type BackgroundContext struct {
	T    *testing.T
	Log  *zap.SugaredLogger
	Stop <-chan struct{}
}

type BackgroundOperation interface {
	// Name is a human readable operation title, and it will be used in t.Run.
	Name() string
	// Setup method may be used to set up environment before upgrade/downgrade is
	// performed.
	Setup() func(c Context)
	// Handler will be executed in background while upgrade/downgrade is being
	// executed. It can be used to constantly validate environment during that
	// time and/or wait for StopEvent being sent. After StopEvent is received
	// user should validate environment, clean up resources, and report found
	// issues to testing.T forwarded in StepEvent.
	Handler() func(bc BackgroundContext)
}

type Configuration struct {
	T *testing.T
	LogConfig
}

type Context struct {
	T   *testing.T
	Log *zap.SugaredLogger
}

type Installations struct {
	Base          []Operation
	UpgradeWith   []Operation
	DowngradeWith []Operation
}

type LogConfig struct {
	// Config from which the zap.Logger be created.
	// Deprecated: This config doesn't have effect. Use Options instead.
	Config zap.Config
	// Options holds options for the zap.Logger.
	Options []zap.Option
}

type Operation interface {
	// Name is a human readable operation title, and it will be used in t.Run.
	Name() string
	// Handler is a function that will be called to perform an operation.
	Handler() func(c Context)
}

type Suite struct {
	Tests         Tests
	Installations Installations
}

type SuiteExecutor interface {
	Execute(c Configuration)
}

type Tests struct {
	PreUpgrade    []Operation
	PostUpgrade   []Operation
	PostDowngrade []Operation
	Continual     []BackgroundOperation
}

type WaitForStopEventConfiguration struct {
	Name     string
	OnStop   func()
	OnWait   func(bc BackgroundContext, self WaitForStopEventConfiguration)
	WaitTime time.Duration
}