Skip to main content

Simple Terraform test helper

Project description

Python Test Helper for Terraform

This simple helper facilitates testing Terraform modules from Python unit test. It does so by wrapping the Terraform executable, and exposing convenience methods to set up fixtures, execute terraform commands, and parse their output.

It allows for different types of tests: lightweight tests that only use Terraform init and plan to ensure code is syntactically correct, and the right number and type of resources should be created; or full-fledged tests that also run Terraform apply and output (destroying if needed), and can check created resources through outputs, state, and then running live tests (eg pinging an instance) against created resources.

This module is heavily inspired by two projects: Terragrunt for the lightweight approach to testing Terraform, and python-terraform for wrapping the Terraform command in Python.

Example Usage

The example folder contains one example for each test style. This is a snippet from the plan-based tests:

TF = tftest.TerraformTest(os.path.join(
    os.path.dirname(os.path.abspath(__file__)), 'foo'))

def setup():
  TF.setup(command='plan')

def test_resources():
  """Test that plan contains all expected resources."""
  values = re.findall(r'(?m)^\s*\+\s+(null_resource\S+)\s*^', TF.setup_output)
  assert values == ['null_resource.foo_resource'], values

And from the apply-based tests:

TF = tftest.TerraformTest(os.path.join(ROOT, 'foo'))

def setup():
  TF.setup(command='output', destroy=True)

def teardown():
  TF.teardown()

def test_output():
  """Test that apply creates the correct resources and outputs are correct."""
  assert TF.setup_output['foos'] == [
      {'foo': 'foo', 'index': '0'}], TF.setup_output['foos']

def test_state():
  """Test that state has the correct resources and attributes."""
  resources = TF.state_pull().modules['root'].resources
  assert resources['null_resource.foo_resource'].attributes['triggers.%'] == '2'

Testing

The simple tests in the tests folder require Python 3.x and can be run with nosetests3 or pytest.

Disclaimer

This is not an officially supported Google product.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

tftest-0.4.0.tar.gz (6.1 kB view hashes)

Uploaded Source

Built Distribution

tftest-0.4.0-py3-none-any.whl (10.4 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page