runnerpool

func Build ¶

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

Build stack runner using discovery and queueing mechanisms.

func BuildUnitOpts ¶ added in v1.0.0

func BuildUnitOpts(l log.Logger, stackOpts *options.TerragruntOptions, unit *component.Unit) (*options.TerragruntOptions, log.Logger, error)

BuildUnitOpts creates per-unit opts and logger for a single unit on demand. It computes the canonical config path, clones options, applies source overrides, and transfers discovery context command/args.

func CloneUnitOptions ¶ added in v0.97.0

func CloneUnitOptions(
	stackOpts *options.TerragruntOptions,
	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 stackOpts is nil.

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 it is not excluded.
• 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,
	opts *options.TerragruntOptions,
	discovered component.Components,
	runnerOpts ...common.Option,
) (common.StackRunner, error)

NewRunnerPoolStack creates a new stack from discovered units.

func NewUnitEarlyExitError ¶ added in v0.99.0

func NewUnitEarlyExitError(unitPath, failedDep string) error

NewUnitEarlyExitError creates a new UnitEarlyExitError.

func NewUnitFailedError ¶ added in v0.99.0

func NewUnitFailedError(unitPath string) error

NewUnitFailedError creates a new UnitFailedError.