run-acceptance-tests

name	run-acceptance-tests
description	Guide for running acceptance tests for a Terraform provider. Use this when asked to run an acceptance test or to run a test with the prefix `TestAcc`.
license	MPL-2.0
metadata	{"copyright":"Copyright IBM Corp. 2026","version":"0.0.1"}

An acceptance test is a Go test function with the prefix TestAcc.

To run a focused acceptance test named TestAccFeatureHappyPath:

1. Run go test -run=TestAccFeatureHappyPath with TF_ACC=1. Default to non-verbose output.
2. Some providers require additional environment variables. If the test output reports missing variables, suggest secure setup steps.

To diagnose a failing test, apply these options cumulatively (each includes the previous):

1. Re-run with -count=1 to bypass the Go test cache.
2. Add -v for verbose output.
3. Set TF_LOG=debug for debug-level logging.
4. Set TF_ACC_WORKING_DIR_PERSIST=1 to preserve the Terraform workspace for inspection.

A passing test may be a false negative. To "flip" a passing test:

1. Edit a TestCheckFunc value in a TestStep of the TestCase.
2. Run the test — expect failure.
3. If it fails, undo the edit and report a successful flip. If it passes, keep the edit and report an unsuccessful flip.