runnerpool

func Build ¶

func Build(
	ctx context.Context,
	l log.Logger,
	terragruntOptions *options.TerragruntOptions,
	opts ...common.Option,
) (common.StackRunner, error)

Build stack runner using discovery and queueing mechanisms.

func BuildCanonicalConfigPath ¶ added in v0.97.0

func BuildCanonicalConfigPath(
	unit *component.Unit,
	basePath string,
) (canonicalConfigPath string, canonicalDir string, err error)

BuildCanonicalConfigPath computes the canonical config path for a unit. It handles .hcl/.json suffixes, joins an appropriate config filename when needed, converts to canonical absolute path, and updates the unit's path. Returns the canonical config path and the canonical unit directory.

func CloneUnitOptions ¶ added in v0.97.0

func CloneUnitOptions(
	stack *component.Stack,
	unit *component.Unit,
	canonicalConfigPath string,
	stackDefaultDownloadDir string,
	l log.Logger,
) (*options.TerragruntOptions, log.Logger, error)

CloneUnitOptions clones TerragruntOptions for a specific unit. It handles CloneWithConfigPath, per-unit DownloadDir fallback, and OriginalTerragruntConfigPath. Returns the cloned options and logger, or the original logger if stack has no options.

func FilterDiscoveredUnits ¶ added in v0.89.0

func FilterDiscoveredUnits(discovered component.Components, units []*component.Unit) component.Components

FilterDiscoveredUnits removes configs for units flagged as excluded and prunes dependencies that point to excluded units. This keeps the execution queue and any user-facing listings free from units not intended to run.

Inputs:

• discovered: raw discovery results (paths and dependency edges)
• units: resolved units (slice), where exclude rules have already been applied

Behavior:

• A config is included only if there's a corresponding unit and its FlagExcluded is false.
• For each included config, its Dependencies list is filtered to only include included configs.
• The function returns a new slice with shallow-copied entries so the original discovery results remain unchanged.

func NewRunnerPoolStack ¶

func NewRunnerPoolStack(
	ctx context.Context,
	l log.Logger,
	terragruntOptions *options.TerragruntOptions,
	discovered component.Components,
	opts ...common.Option,
) (common.StackRunner, error)

NewRunnerPoolStack creates a new stack from discovered units.

func ShouldSkipUnitWithoutTerraform ¶ added in v0.97.0

func ShouldSkipUnitWithoutTerraform(unit *component.Unit, dir string, l log.Logger) (bool, error)

ShouldSkipUnitWithoutTerraform checks if a unit should be skipped because it has neither a Terraform source nor any Terraform/OpenTofu files in its directory. Returns true if the unit should be skipped, false otherwise.