manager

type Manager struct {
	// contains filtered or unexported fields
}

type Source interface {
	// ConfigDir is the directory .dmtlint.yaml is looked up from and the metrics
	// labels are derived from. It is read before Targets, to load the config Targets
	// is then handed.
	ConfigDir() string
	// Scopes are the scopes this source produces targets in. Answered without loading
	// anything, so a run that finds no modules still reports the sections it would
	// have linted with.
	Scopes() []scopes.Scope
	// Targets loads the modules to lint, handing each to yield as soon as it is
	// built. Targets are pushed rather than returned as a slice because a --matrix
	// run expands one module into many renders: yield blocks while the worker pool
	// is full, so the source builds the next render only once an earlier one has
	// been linted and freed, and a module that expands to thousands of renders never
	// has more than the worker count of them resident. A false from yield means the
	// run is over and the source must stop.
	//
	// Findings made while loading go into errorList; a returned error is one the run
	// could not fold into a finding, e.g. a registry failure, and is reported after
	// the findings are printed rather than instead of them.
	Targets(
		ctx context.Context,
		cfg *config.RootConfig,
		errorList *errors.LintRuleErrorsList,
		yield func(Target) bool,
	) error
	// Close releases what the source allocated, e.g. image extraction directories.
	// It runs after the findings are printed, so a finding must never name a path
	// that only exists until Close.
	Close()
}

type Target struct {
	Module *modules.Module
	Scope  scopes.Scope
	// ModuleID is what the source calls one module. Targets sharing it count as one
	// module in the summary, which is how a remote run reports the two images it read
	// as the single module they are. It is not the module's name: a tree can hold two
	// directories declaring the same name, and those are two modules.
	ModuleID string
	// ObjectID tags this target's findings. The remote source sets the scope name so
	// bundle and release findings stay apart in the output; empty means no tag.
	ObjectID string
	// Variant marks this target as one of several renders of the same module, which
	// is what a --matrix run produces. It turns on deduplication for the whole run:
	// a finding that does not depend on the value combination being rendered is
	// produced once per combination, and only one of those is worth printing.
	Variant bool
}