What is 'flipping' a test and why is it useful?

Flipping involves temporarily modifying a TestCheckFunc to ensure the test fails as expected, which confirms the test logic is actually validating the resource state.

Does this skill handle sensitive environment variables?

Yes, it identifies when provider-specific variables are missing and guides you through setting them up securely rather than hardcoding them.

How do I run a specific Terraform acceptance test?

The skill runs the test using 'go test' with the '-run' flag and ensures the 'TF_ACC=1' environment variable is correctly set.

How can I debug a failing Terraform test?

The skill offers a cumulative diagnostic approach: re-running without cache, enabling verbose output, turning on TF_LOG=debug, and finally persisting the Terraform workspace.

Terraform Acceptance Testing

Name: Terraform Acceptance Testing
Author: hashicorp

byhashicorp

•

329

•

Security & Testing

Automates and guides the execution of Go-based acceptance tests for Terraform providers.

This skill streamlines the development of Terraform providers by providing standardized workflows for running, diagnosing, and verifying acceptance tests. It manages environment variables like TF_ACC and TF_LOG, handles complex debugging scenarios through multi-level logging and workspace persistence, and implements the 'flipping' technique to ensure test reliability. It is an essential tool for developers working within the HashiCorp ecosystem who need to validate their provider code against real-world infrastructure APIs while maintaining high test integrity.

Key Features

01Implements 'test flipping' to verify test validity and prevent false positives in passing results.

02Provides a tiered diagnostic system including verbose output, debug-level logging, and workspace persistence.

03329 GitHub stars

04Executes focused Go acceptance tests using the TestAcc prefix and automated environment configuration.

05Detects missing provider-specific environment variables and suggests secure setup methods.

06Ensures clean test execution by bypassing caches using the -count=1 diagnostic flag.

Use Cases

01Running targeted acceptance tests for a new Terraform resource or data source during development.

02Debugging complex infrastructure-as-code failures with persistent workspaces and verbose logging.

03Verifying the integrity of passing tests by intentionally inducing failures to ensure assertions are working.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add hashicorp/agent-skills run-acceptance-tests

For use in Claude.ai and ChatGPT

Download Skill