acceptance

package
v2.96.0 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Feb 14, 2022 License: MPL-2.0 Imports: 24 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func ComposeAggregateTestCheckFunc 

func ComposeAggregateTestCheckFunc(fs ...resource.TestCheckFunc) pluginsdk.TestCheckFunc

func ComposeTestCheckFunc 

func ComposeTestCheckFunc(fs ...resource.TestCheckFunc) pluginsdk.TestCheckFunc

func Environment 

func Environment() (*azure.Environment, error)

func EnvironmentName 

func EnvironmentName() string

func GetAuthConfig 

func GetAuthConfig(t *testing.T) *authentication.Config

func PreCheck 

func PreCheck(t *testing.T)

func RandString 

func RandString(strlen int) string

RandString generates a random alphanumeric string of the length specified

func RandStringFromCharSet 

func RandStringFromCharSet(strlen int, charSet string) string

func RandTimeInt 

func RandTimeInt() int

func RequiresImportError 

func RequiresImportError(resourceName string) *regexp.Regexp

func RunTestsInSequence 

func RunTestsInSequence(t *testing.T, tests map[string]map[string]func(t *testing.T))

func TestCheckNoResourceAttr 

func TestCheckNoResourceAttr(name, key string) resource.TestCheckFunc

TestCheckNoResourceAttr is a TestCheckFunc which ensures that NO value exists in state for the given name/key combination.

func TestCheckOutput 

func TestCheckOutput(name, value string) pluginsdk.TestCheckFunc

TestCheckOutput is a wrapper to enable builds to continue

func TestCheckResourceAttr 

func TestCheckResourceAttr(name, key, value string) pluginsdk.TestCheckFunc

TestCheckResourceAttr is a wrapper to enable builds to continue

func TestCheckResourceAttrPair 

func TestCheckResourceAttrPair(nameFirst, keyFirst, nameSecond, keySecond string) resource.TestCheckFunc

TestCheckResourceAttrPair is a TestCheckFunc which validates that the values in state for a pair of name/key combinations are equal.

func TestCheckResourceAttrSet 

func TestCheckResourceAttrSet(name, key string) pluginsdk.TestCheckFunc

func TestMatchOutput 

func TestMatchOutput(name string, r *regexp.Regexp) pluginsdk.TestCheckFunc

TestMatchOutput is a wrapper to enable builds to continue

func TestMatchResourceAttr 

func TestMatchResourceAttr(name, key string, r *regexp.Regexp) pluginsdk.TestCheckFunc

TestMatchResourceAttr is a TestCheckFunc which checks that the value in state for the given name/key combination matches the given regex.

Types

type ClientAuthDetails 

type ClientAuthDetails struct {
	// ClientID is the UUID of the Service Principal being used to connect to Azure
	ClientID string

	// ClientSecret is the Client Secret being used to connect to Azure
	ClientSecret string
}

type ClientCheckFunc 

type ClientCheckFunc func(ctx context.Context, clients *clients.Client, state *terraform.InstanceState) error

type ClientData 

type ClientData struct {
	// Default is the Default Credentials being used to connect to Azure
	Default ClientAuthDetails

	// Alternate is an alternate set of Credentials being used to connect to Azure
	Alternate ClientAuthDetails

	// SubscriptionID is the UUID of the Azure Subscription where tests are being run
	SubscriptionID string

	// SubscriptionIDAlt is the UUID of the Alternate Azure Subscription where tests are being run
	SubscriptionIDAlt string

	// TenantID is the UUID of the Azure Tenant where tests are being run
	TenantID string

	// Are we connected as a Service Principal
	// this exists for allowing folks to run the test suite via other
	// credentials in the future; but requires code changes first
	IsServicePrincipal bool
}

type DisappearsStepData 

type DisappearsStepData struct {
	// Config is a function which returns the Terraform Configuration which should be used for this step
	Config func(data TestData) string

	// TestResource is a reference to a TestResource which can destroy the resource
	// to enable a Disappears step
	TestResource types.TestResourceVerifyingRemoved
}

type InstanceState 

type InstanceState = terraform.InstanceState

type Regions 

type Regions struct {
	// Primary is the Primary/Default Azure Region which should be used for testing
	Primary string

	// Secondary is the Secondary Azure Region which should be used for testing
	Secondary string

	// Ternary is the Ternary Azure Region which should be used for testing
	Ternary string
}

Regions is a list of Azure Regions which can be used for test purposes

type State 

type State = terraform.State

type StateChangeConf 

type StateChangeConf = resource.StateChangeConf

type TestCheckFunc 

type TestCheckFunc = resource.TestCheckFunc

type TestData 

type TestData struct {
	// Locations is a set of Azure Regions which should be used for this Test
	Locations Regions

	// RandomInteger is a random integer which is unique to this test case
	RandomInteger int

	// RandomString is a random 5 character string is unique to this test case
	RandomString string

	// ResourceName is the fully qualified resource name, comprising of the
	// resource type and then the resource label
	// e.g. `azurerm_resource_group.test`
	ResourceName string

	// ResourceType is the Terraform Resource Type - `azurerm_resource_group`
	ResourceType string

	// Environment is a struct containing Details about the Azure Environment
	// that we're running against
	Environment azure.Environment

	// EnvironmentName is the name of the Azure Environment where we're running
	EnvironmentName string

	// MetadataURL is the url of the endpoint where the environment is obtained
	MetadataURL string
	// contains filtered or unexported fields
}

func BuildTestData 

func BuildTestData(t *testing.T, resourceType string, resourceLabel string) TestData

BuildTestData generates some test data for the given resource

func (TestData) ApplyStep 

func (td TestData) ApplyStep(config func(data TestData) string, testResource types.TestResource) resource.TestStep

ApplyStep returns a Test Step which applies a Configuration and then check that the resource exists. This doesn't do any other assertions since it's expected that an ImportStep will be called afterwards to validate that.

func (TestData) CheckWithClient 

func (td TestData) CheckWithClient(check ClientCheckFunc) resource.TestCheckFunc

CheckWithClient returns a TestCheckFunc which will call a ClientCheckFunc with the provider context and clients

func (TestData) CheckWithClientForResource 

func (td TestData) CheckWithClientForResource(check ClientCheckFunc, resourceName string) resource.TestCheckFunc

CheckWithClientForResource returns a TestCheckFunc which will call a ClientCheckFunc with the provider context and clients for the named resource

func (TestData) CheckWithClientWithoutResource 

func (td TestData) CheckWithClientWithoutResource(check ClientCheckFunc) resource.TestCheckFunc

CheckWithClientWithoutResource returns a TestCheckFunc which will call a ClientCheckFunc with the provider context and clients to find if a resource exists when the resource that created it is destroyed.

func (TestData) Client 

func (td TestData) Client() ClientData

Client returns a struct containing information about the Client being used to connect to Azure

func (TestData) DataSourceTest 

func (td TestData) DataSourceTest(t *testing.T, steps []TestStep)

func (TestData) DataSourceTestInSequence 

func (td TestData) DataSourceTestInSequence(t *testing.T, steps []TestStep)

func (TestData) DisappearsStep 

func (td TestData) DisappearsStep(data DisappearsStepData) resource.TestStep

DisappearsStep returns a Test Step which first confirms the resource exists then destroys it, and expects that the plan at the end of this should show that the resource needs to be created (since it's been destroyed)

func (TestData) ImportStep 

func (td TestData) ImportStep(ignore ...string) resource.TestStep

ImportStep returns a Test Step which Imports the Resource, optionally ignoring any fields which may not be imported (for example, as they're not returned from the API)

func (TestData) ImportStepFor 

func (td TestData) ImportStepFor(resourceName string, ignore ...string) resource.TestStep

ImportStepFor returns a Test Step which Imports a given resource by name, optionally ignoring any fields which may not be imported (for example, as they're not returned from the API)

func (*TestData) RandomIntOfLength 

func (td *TestData) RandomIntOfLength(len int) int

RandomIntOfLength is a random 8 to 18 digit integer which is unique to this test case

func (*TestData) RandomStringOfLength 

func (td *TestData) RandomStringOfLength(len int) string

RandomStringOfLength is a random 1 to 1024 character string which is unique to this test case

func (TestData) RequiresImportErrorStep 

func (td TestData) RequiresImportErrorStep(configBuilder func(data TestData) string) resource.TestStep

RequiresImportErrorStep returns a Test Step which expects a Requires Import error to be returned when running this step

func (TestData) ResourceSequentialTest 

func (td TestData) ResourceSequentialTest(t *testing.T, testResource types.TestResource, steps []TestStep)

func (TestData) ResourceSequentialTestSkipCheckDestroyed 

func (td TestData) ResourceSequentialTestSkipCheckDestroyed(t *testing.T, steps []TestStep)

func (TestData) ResourceTest 

func (td TestData) ResourceTest(t *testing.T, testResource types.TestResource, steps []TestStep)

func (TestData) ResourceTestSkipCheckDestroyed 

func (td TestData) ResourceTestSkipCheckDestroyed(t *testing.T, steps []TestStep)

ResourceTestIgnoreCheckDestroyed skips the check to confirm the resource test has been destroyed. This is done because certain resources can't actually be deleted.

type TestStep 

type TestStep = resource.TestStep

Source Files

View all Source files

Directories

Path Synopsis

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.