test_structure

package
v0.9.2 Latest Latest
Warning

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

Go to latest
Published: May 5, 2018 License: Apache-2.0 Imports: 12 Imported by: 0

Documentation

Index

Constants

View Source
const SKIP_STAGE_ENV_VAR_PREFIX = "SKIP_"

Variables

This section is empty.

Functions

func CleanupTestData

func CleanupTestData(t *testing.T, path string)

Clean up the test data at the given path

func CopyTerraformFolderToTemp

func CopyTerraformFolderToTemp(t *testing.T, rootFolder string, examplesFolder string) string

Copy the given root folder to a randomly-named temp folder and return the path to the given examples folder within the new temp root folder. This is useful when running multiple tests in parallel against the same set of Terraform files to ensure the tests don't overwrite each other's .terraform working directory and terraform.tfstate files. To ensure relative paths work, we copy over the entire root folder to a temp folder, and then return the path within that temp folder to the given example dir, which is where the actual test will be running.

Note that if any of the SKIP_<stage> environment variables is set, we assume this is a test in the local dev where there are no other concurrent tests running and we want to be able to cache test data between test stages, so in that case, we do NOT copy anything to a temp folder, and return the path to the original examples folder instead.

func FormatTestDataPath

func FormatTestDataPath(testFolder string, filename string) string

Format a path to save test data

func IsTestDataPresent

func IsTestDataPresent(t *testing.T, path string) bool

Return true if a file exists at $path and the test data there is non-empty.

func LoadAmiId

func LoadAmiId(t *testing.T, testFolder string) string

Load and unserialize an AMI ID from the given folder. This allows you to reuse an AMI that was created during an earlier setup step in later validation and teardown steps.

func LoadEc2KeyPair

func LoadEc2KeyPair(t *testing.T, testFolder string) *aws.Ec2Keypair

Load and unserialize an Ec2KeyPair from the given folder. This allows you to reuse an Ec2KeyPair that was created during an earlier setup step in later validation and teardown steps.

func LoadInt

func LoadInt(t *testing.T, testFolder string, name string) int

Load a uniquely named int value from the given folder. This allows you to reuse one or more int values that were created during an earlier setup step in later steps.

func LoadPackerOptions

func LoadPackerOptions(t *testing.T, testFolder string) *packer.Options

Load and unserialize PackerOptions from the given folder. This allows you to reuse a PackerOptions that was created during an earlier setup step in later validation and teardown steps.

func LoadString

func LoadString(t *testing.T, testFolder string, name string) string

Load and unserialize a uniquely named string value from the given folder. This allows you to reuse one or more string values that were created during an earlier setup step in later steps.

func LoadTerraformOptions

func LoadTerraformOptions(t *testing.T, testFolder string) *terraform.Options

Load and unserialize TerraformOptions from the given folder. This allows you to reuse a TerraformOptions that was created during an earlier setup step in later validation and teardown steps.

func LoadTestData

func LoadTestData(t *testing.T, path string, value interface{})

Load and unserialize a value stored at the given path. The value should be a pointer to a struct into which the value will be deserialized. This allows you to reuse some sort of test data (e.g., TerraformOptions) from earlier setup steps in later validation and teardown steps.

func RunTestStage

func RunTestStage(t *testing.T, stageName string, stage func())

Execute the given test stage (e.g., setup, teardown, validation) if an environment variable of the name `SKIP_<stageName>` (e.g., SKIP_teardown) is not set.

func SaveAmiId

func SaveAmiId(t *testing.T, testFolder string, amiId string)

Serialize and save an AMI ID into the given folder. This allows you to build an AMI during setup and to reuse that AMI later during validation and teardown.

func SaveEc2KeyPair

func SaveEc2KeyPair(t *testing.T, testFolder string, keyPair *aws.Ec2Keypair)

Serialize and save an Ec2KeyPair into the given folder. This allows you to create an Ec2KeyPair during setup and to reuse that Ec2KeyPair later during validation and teardown.

func SaveInt

func SaveInt(t *testing.T, testFolder string, name string, val int)

Save a uniquely named int value into the given folder. This allows you to create one or more int values during one stage -- each with a unique name -- and to reuse those values during later stages.

func SavePackerOptions

func SavePackerOptions(t *testing.T, testFolder string, packerOptions *packer.Options)

Serialize and save PackerOptions into the given folder. This allows you to create PackerOptions during setup and to reuse that PackerOptions later during validation and teardown.

func SaveString

func SaveString(t *testing.T, testFolder string, name string, val string)

Serialize and save a uniquely named string value into the given folder. This allows you to create one or more string values during one stage -- each with a unique name -- and to reuse those values during later stages.

func SaveTerraformOptions

func SaveTerraformOptions(t *testing.T, testFolder string, terraformOptions *terraform.Options)

Serialize and save TerraformOptions into the given folder. This allows you to create TerraformOptions during setup and to reuse that TerraformOptions later during validation and teardown.

func SaveTestData

func SaveTestData(t *testing.T, path string, value interface{})

Serialize and save a value used at test time to the given path. This allows you to create some sort of test data (e.g., TerraformOptions) during setup and to reuse this data later during validation and teardown.

func SkipStageEnvVarSet

func SkipStageEnvVarSet() bool

Returns true if an environment variable is set instructing Terratest to skip a test stage. This can be an easy way to tell if the tests are running in a local dev environment vs a CI server.

Types

This section is empty.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL