README
¶
terraform-plugin-testing
terraform-plugin-testing is a helper module for testing Terraform providers. Terraform acceptance tests use real Terraform configurations to exercise the code in real plan, apply, refresh, and destroy life cycles. When run from the root of a Terraform Provider codebase, Terraform’s testing framework compiles the current provider in-memory and executes the provided configuration in developer defined steps, creating infrastructure along the way.
Go Compatibility
This project follows the support policy of Go as its support policy. The two latest major releases of Go are supported by the project.
Currently, that means Go 1.19 or later must be used when including this project as a dependency.
Contributing
License
Directories
¶
| Path | Synopsis |
|---|---|
|
helper
|
|
|
internal
|
|
|
addrs
Package addrs contains types that represent "addresses", which are references to specific objects within a Terraform configuration or state.
|
Package addrs contains types that represent "addresses", which are references to specific objects within a Terraform configuration or state. |
|
configs/configschema
Package configschema contains types for describing the expected structure of a configuration block whose shape is not known until runtime.
|
Package configschema contains types for describing the expected structure of a configuration block whose shape is not known until runtime. |
|
errorshim
TODO: Once Go 1.20 is the minimum supported version delete this package, replace all usages with `errors` package - https://github.com/hashicorp/terraform-plugin-testing/issues/99
|
TODO: Once Go 1.20 is the minimum supported version delete this package, replace all usages with `errors` package - https://github.com/hashicorp/terraform-plugin-testing/issues/99 |
|
plugintest
Package plugintest contains utilities to help with writing tests for Terraform plugins.
|
Package plugintest contains utilities to help with writing tests for Terraform plugins. |
|
tfdiags
Package tfdiags is a utility package for representing errors and warnings in a manner that allows us to produce good messages for the user.
|
Package tfdiags is a utility package for representing errors and warnings in a manner that allows us to produce good messages for the user. |
|
Package plancheck contains the plan check interface, request/response structs, and common plan check implementations.
|
Package plancheck contains the plan check interface, request/response structs, and common plan check implementations. |
Click to show internal directories.
Click to hide internal directories.