run-acceptance-tests
Run acceptance tests for Terraform providers using Go's test runner
Developer Setup
Setup & Installation
npx skills add https://github.com/hashicorp/agent-skills --skill run-acceptance-testsnpx skills add https://github.com/hashicorp/agent-skills --skill run-acceptance-testsOverview
What This Skill Does
Runs acceptance tests for Terraform providers using Go's test runner. Handles the `TestAcc` prefix convention, required environment variables like `TF_ACC`, and progressive debugging steps when tests fail. Also validates passing tests by flipping expected values to confirm they can actually catch regressions.
Application
When to use this Skill
- Configuring integration settings for custom agent workflows.
- Optimizing query execution and response latency in production.
- Developing clean, standard-compliant implementations for enterprise services.
- Troubleshooting connection timeouts and authentication handshakes.
- Monitoring API rate limits and execution pipelines programmatically.
Documentation
Show Skills.md file
An acceptance test is a Go test function with the prefix TestAcc.
To run a focussed acceptance test named TestAccFeatureHappyPath:
Run
go test -run=TestAccFeatureHappyPathwith the following environment variables:TF_ACC=1
Default to non-verbose test output.
The acceptance tests may require additional environment variables for specific providers. If the test output indicates missing environment variables, then suggest how to set up these environment variables securely.
To diagnose a failing acceptance test, use these options, in order. These options are cumulative: each option includes all the options above it.
- Run the test again. Use the
-count=1option to ensure thatgo testdoes not use a cached result. - Offer verbose
go testoutput. Use the-voption. - Offer debug-level logging. Enable debug-level logging with the environment
variable
TF_LOG=debug. - Offer to persist the acceptance test's Terraform workspace. Enable
persistance with the environment variable
TF_ACC_WORKING_DIR_PERSIST=1.
A passing acceptance test may be a false negative. To "flip" a passing
Recommendations