dawn

type Events interface {
	// Print logs a line of output associated with a module or target.
	Print(label *label.Label, line string)

	// RequirementLoading is called when a referenced project is being loaded.
	RequirementLoading(label *label.Label, version string)
	// RequirementLoaded is called when a referenced project has finished loading.
	RequirementLoaded(label *label.Label, version string)
	// RequirementLoadFailed is called when a referenced project fails to load.
	RequirementLoadFailed(label *label.Label, version string, err error)

	// ModuleLoading is called when the given module begins loading.
	ModuleLoading(label *label.Label)
	// ModuleLoaded is called when the given module finishes loading successfully.
	ModuleLoaded(label *label.Label)
	// ModuleLoadFailed is called when the given module fails to load.
	ModuleLoadFailed(label *label.Label, err error)
	// LoadDone is called when a project finishes loading.
	LoadDone(err error)

	// TargetUpToDate is called when a target is found to be up-to-date.
	TargetUpToDate(label *label.Label)
	// TargetWaiting is called when a target begins waiting for dependencies.
	TargetWaiting(label *label.Label, dependencies []string)
	// TargetEvaluating is called when a target begins executing.
	TargetEvaluating(label *label.Label, reason string, diff diff.ValueDiff)
	// TargetFailed is called when a target fails.
	TargetFailed(label *label.Label, err error)
	// TargetSucceeded is called when a target succeeds.
	TargetSucceeded(label *label.Label, changed bool)
	// RunDone is called when a run finishes.
	RunDone(err error)

	// FileChanged is called during Watch when a file changes and triggers a reload.
	FileChanged(label *label.Label)
}

type Flag struct {
	// Name holds the flag's name.
	Name string `json:"name"`
	// Default holds the string representation of the flag's default value.
	Default string `json:"default,omitempty"`
	// FlagType holds the string representation of the flag's type.
	FlagType string `json:"type"`
	// Choices holds string representations of the flag's vlaid values.
	Choices []string `json:"choices,omitempty"`
	// Required is true if the flag is required.
	Required bool `json:"required,omitempty"`
	// Help holds the flag's help message.
	Help string `json:"help,omitempty"`
	// Value holds the flag's value.
	Value starlark.Value `json:"-"`
}

type LoadOptions struct {
	Args   []string
	Events Events

	Builtins starlark.StringDict

	PreferIndex bool
}

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

type RunOptions struct {
	Always bool
	DryRun bool
}

type Target interface {
	starlark.Value

	// Project returns the project that owns the target.
	Project() *Project
	// Label returns the target's label.
	Label() *label.Label
	// Dependencies returns the labels of the targets the target depends upon.
	Dependencies() []*label.Label
	// Name returns the target's name, which is its stringified label.
	Name() string
	// Doc returns the target's documentation string.
	Doc() string
	// Pos returns the position in the target's module where the target is defined.
	Pos() string
	// contains filtered or unexported methods
}

type TargetSummary struct {
	// Label is the target's label.
	Label *label.Label `json:"label"`
	// Summary is a summary of the target's docstring (as returned by DocSummary(t)).
	Summary string `json:"summary,omitempty"`
	// Pos is the position in the target's module that defines the target.
	Pos string `json:"pos,omitempty"`
}

type UnknownTargetError string