Struct TestCommand 

pub struct TestCommand { /* private fields */ }

Command for running Terraform module integration tests.

Runs .tftest.hcl test files. Available in Terraform 1.6+.

use terraform_wrapper::{Terraform, TerraformCommand};
use terraform_wrapper::commands::test::TestCommand;

let tf = Terraform::builder().working_dir("/tmp/infra").build()?;
let output = TestCommand::new()
    .filter("my_test")
    .verbose()
    .execute(&tf)
    .await?;

Implementations

impl TestCommand

pub fn new() -> Self

Create a new test command with default options.

pub fn filter(self, name: &str) -> Self

Filter to a specific test (-filter).

pub fn json(self) -> Self

Enable machine-readable JSON output (-json).

pub fn test_directory(self, path: &str) -> Self

Set the directory containing test files (-test-directory).

Defaults to tests if not specified.

pub fn verbose(self) -> Self

Enable verbose output (-verbose).

pub fn var(self, name: &str, value: &str) -> Self

Set a variable value (-var="name=value").

pub fn var_file(self, path: &str) -> Self

Add a variable definitions file (-var-file).

pub fn parallelism(self, n: u32) -> Self

Limit the number of concurrent operations (-parallelism).

pub fn junit_xml(self, path: &str) -> Self

Write test results to a JUnit XML file (-junit-xml).

pub fn arg(self, arg: impl Into<String>) -> Self

Add a raw argument (escape hatch for unsupported options).

Trait Implementations

impl Clone for TestCommand

fn clone(&self) -> TestCommand

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TestCommand

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for TestCommand

fn default() -> TestCommand

Returns the “default value” for a type.

impl TerraformCommand for TestCommand

type Output = CommandOutput

The output type produced by this command.

fn args(&self) -> Vec<String>

Build the argument list for this command.

async fn execute(&self, tf: &Terraform) -> Result<CommandOutput>

Execute this command against the given Terraform client.

fn supports_input(&self) -> bool

Whether this command supports the -input=false flag.

fn prepare_args(&self, tf: &Terraform) -> Vec<String>

Build the argument list with -input=false injected when appropriate.