acceptance

Documentation

Index

• func AccountLevel(t *testing.T, steps ...Step)
• func BuildImportStateIdFunc(resourceId, attr string) func(*terraform.State) (string, error)
• func GetEnvInt64OrSkipTest(t *testing.T, name string) int64
• func GetEnvOrSkipTest(t *testing.T, name string) string
• func RandomEmail(prefix ...string) string
• func RandomHex(prefix string, randLen int) string
• func RandomName(prefix ...string) string
• func UnityAccountLevel(t *testing.T, steps ...Step)
• func UnityWorkspaceLevel(t *testing.T, steps ...Step)
• func WorkspaceLevel(t *testing.T, steps ...Step)
• type Step

Functions

func AccountLevel

func AccountLevel(t *testing.T, steps ...Step)

func BuildImportStateIdFunc

func BuildImportStateIdFunc(resourceId, attr string) func(*terraform.State) (string, error)

BuildImportStateIdFunc constructs a function that returns the id attribute of a target resouce from the terraform state. This is a helper function for conveniently constructing the ImportStateIdFunc field for a test step.

func GetEnvInt64OrSkipTest

func GetEnvInt64OrSkipTest(t *testing.T, name string) int64

func GetEnvOrSkipTest

func GetEnvOrSkipTest(t *testing.T, name string) string

GetEnvOrSkipTest proceeds with test only with that env variable

func RandomEmail

func RandomEmail(prefix ...string) string

RandomEmail generates random email

func RandomHex

func RandomHex(prefix string, randLen int) string

func RandomName

func RandomName(prefix ...string) string

RandomName gives random name with optional prefix. e.g. qa.RandomName("tf-")

func UnityAccountLevel

func UnityAccountLevel(t *testing.T, steps ...Step)

func UnityWorkspaceLevel

func UnityWorkspaceLevel(t *testing.T, steps ...Step)

func WorkspaceLevel

func WorkspaceLevel(t *testing.T, steps ...Step)

Types

type Step

type Step struct {
	// Terraform HCL for resources to materialize in this test step.
	Template string

	// This function is called after the template is applied. Useful for making assertions
	// or doing cleanup.
	Check func(*terraform.State) error

	// Setup function called before the template is materialized.
	PreConfig func()

	Destroy                   bool
	ExpectNonEmptyPlan        bool
	ExpectError               *regexp.Regexp
	PlanOnly                  bool
	PreventDiskCleanup        bool
	PreventPostDestroyRefresh bool

	// If true, will test the functionality of ImportState by importing the resource with ResourceName (must be set) and the ID of that resource.
	// ID can be supplied with either ImportStateId or ImportStateIdFunc.
	ImportState                          bool
	ImportStateId                        string
	ImportStateIdFunc                    func(*terraform.State) (string, error)
	ImportStateVerify                    bool
	ImportStateVerifyIdentifierAttribute string
	ResourceName                         string

	ProtoV6ProviderFactories map[string]func() (tfprotov6.ProviderServer, error)
}

A step in a terraform acceptance test