lifecycletest

Documentation

Index

• func CloneSnapshot(t testing.TB, snap *deploy.Snapshot) *deploy.Snapshot
• type Result
  • func (res *Result) Then(do func(snap *deploy.Snapshot, err error))
• type TestOp
  • func ImportOp(imports []deploy.Import) TestOp
  • func (op TestOp) Plan(project workspace.Project, target deploy.Target, opts TestUpdateOptions, ...) (*deploy.Plan, error)
  • func (op TestOp) Run(project workspace.Project, target deploy.Target, opts TestUpdateOptions, ...) (*deploy.Snapshot, error)
  • func (op TestOp) RunWithContext(callerCtx context.Context, project workspace.Project, target deploy.Target, ...) (*deploy.Snapshot, error)
• type TestPlan
  • func (p *TestPlan) GetProject() workspace.Project
  • func (p *TestPlan) GetTarget(t testing.TB, snapshot *deploy.Snapshot) deploy.Target
  • func (p *TestPlan) NewProviderURN(pkg tokens.Package, name string, parent resource.URN) resource.URN
  • func (p *TestPlan) NewURN(typ tokens.Type, name string, parent resource.URN) resource.URN
  • func (p *TestPlan) Run(t testing.TB, snapshot *deploy.Snapshot) *deploy.Snapshot
• type TestStep
  • func MakeBasicLifecycleSteps(t *testing.T, resCount int) []TestStep
  • func (t *TestStep) ValidateAnd(f ValidateFunc)
• type TestUpdateOptions
  • func (o TestUpdateOptions) Options() UpdateOptions
• type ValidateFunc

Functions

func CloneSnapshot

func CloneSnapshot(t testing.TB, snap *deploy.Snapshot) *deploy.Snapshot

CloneSnapshot makes a deep copy of the given snapshot and returns a pointer to the clone.

Types

type Result

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

func (*Result) Then

func (res *Result) Then(do func(snap *deploy.Snapshot, err error))

Then() is used to convey dependence between program runs via program structure.

type TestOp

type TestOp func(UpdateInfo, *Context, UpdateOptions, bool) (*deploy.Plan, display.ResourceChanges, error)

func ImportOp

func ImportOp(imports []deploy.Import) TestOp

func (TestOp) Plan

func (op TestOp) Plan(project workspace.Project, target deploy.Target, opts TestUpdateOptions,
	backendClient deploy.BackendClient, validate ValidateFunc,
) (*deploy.Plan, error)

func (TestOp) Run

func (op TestOp) Run(project workspace.Project, target deploy.Target, opts TestUpdateOptions,
	dryRun bool, backendClient deploy.BackendClient, validate ValidateFunc,
) (*deploy.Snapshot, error)

func (TestOp) RunWithContext

func (op TestOp) RunWithContext(
	callerCtx context.Context, project workspace.Project,
	target deploy.Target, opts TestUpdateOptions, dryRun bool,
	backendClient deploy.BackendClient, validate ValidateFunc,
) (*deploy.Snapshot, error)

type TestPlan

type TestPlan struct {
	Project        string
	Stack          string
	Runtime        string
	RuntimeOptions map[string]interface{}
	Config         config.Map
	Decrypter      config.Decrypter
	BackendClient  deploy.BackendClient
	Options        TestUpdateOptions
	Steps          []TestStep
}

func (*TestPlan) GetProject

func (p *TestPlan) GetProject() workspace.Project

func (*TestPlan) GetTarget

func (p *TestPlan) GetTarget(t testing.TB, snapshot *deploy.Snapshot) deploy.Target

func (*TestPlan) NewProviderURN

func (p *TestPlan) NewProviderURN(pkg tokens.Package, name string, parent resource.URN) resource.URN

func (*TestPlan) NewURN

func (p *TestPlan) NewURN(typ tokens.Type, name string, parent resource.URN) resource.URN

func (*TestPlan) Run

func (p *TestPlan) Run(t testing.TB, snapshot *deploy.Snapshot) *deploy.Snapshot

type TestStep

type TestStep struct {
	Op            TestOp
	ExpectFailure bool
	SkipPreview   bool
	Validate      ValidateFunc
}

func MakeBasicLifecycleSteps

func MakeBasicLifecycleSteps(t *testing.T, resCount int) []TestStep

resCount is the expected number of resources registered during this test.

func (*TestStep) ValidateAnd

func (t *TestStep) ValidateAnd(f ValidateFunc)

type TestUpdateOptions

type TestUpdateOptions struct {
	UpdateOptions
	// a factory to produce a plugin host for an update operation.
	HostF deploytest.PluginHostFactory
}

TestUpdateOptions is UpdateOptions for a TestPlan.

func (TestUpdateOptions) Options

func (o TestUpdateOptions) Options() UpdateOptions

Options produces UpdateOptions for an update operation.

type ValidateFunc

type ValidateFunc func(project workspace.Project, target deploy.Target, entries JournalEntries,
	events []Event, err error) error