Enum BuildError 

pub enum BuildError {
    OverlayCollision {
        project: ProjectName,
        task: TaskName,
        sources: BTreeSet<DefinitionSource>,
    },
    UnresolvedReference {
        bearing: TaskId,
        reference: TaskRef,
        source: ResolutionError,
    },
    SelfReference {
        bearing: TaskId,
        reference: TaskRef,
    },
    DepsWeakDepsOverlap {
        bearing: TaskId,
        overlap: TaskId,
    },
    Cycle {
        nodes: BTreeSet<TaskId>,
    },
    LiteralOutputCollision {
        path: String,
        tasks: BTreeSet<TaskId>,
    },
}

A single error encountered during build_task_graph.

Multiple instances are accumulated into BuildErrors per DAG-011: a workspace with N broken references and M overlap violations produces a BuildErrors with N + M + ... entries, not the first one.

Variants

OverlayCollision

More than one definition source supplies a body for the (project, task) pair AND no unique winner exists under the specialisation order (DAG-006). Surfaced from crate::effective::compute_effective_tasks.

Fields

project: ProjectName

The project the collision applies to.

task: TaskName

The task name the collision applies to.

sources: BTreeSet<DefinitionSource>

Every contributing definition source for the pair.

UnresolvedReference

A task reference could not be resolved against the workspace. The bearing task identifies WHERE in the workspace the unresolved reference lives.

Fields

bearing: TaskId

The bearing task (the task that owns the offending reference).

reference: TaskRef

The reference, as parsed.

source: ResolutionError

The resolution failure mode.

SelfReference

A reference in deps or weakDeps resolved to the bearing task itself (DAG-012). The whole reference is rejected: no edges from it are added to the graph.

The legitimate way to fan out across siblings without reaching the bearing is the sibling-modifier form (^~:<task> or [<tag>]~:<task>, per REF-008).

Fields

bearing: TaskId

The bearing task.

reference: TaskRef

The reference, as parsed.

DepsWeakDepsOverlap

A node resolved into BOTH deps and weakDeps of the same bearing task (DAG-010). The two fields are mutually exclusive by intent; the workspace MUST be rejected.

Fields

bearing: TaskId

The bearing task.

overlap: TaskId

The node that appears in both fields.

Cycle

A strongly-connected component of size two or more in the union of hard, soft, and producer-matching edges (DAG-014). Length-one cycles (a single task whose outputs intersect its own inputs per DAG-013) are permitted; this variant covers only length-two-or-more cycles.

Fields

nodes: BTreeSet<TaskId>

The tasks participating in the strongly-connected component. Always |nodes| >= 2.

LiteralOutputCollision

A literal output path is declared as an output by more than one task (DAG-015). Glob-output overlaps are deferred to runtime per DAG-016 and do NOT produce this variant.

Fields

path: String

Workspace-absolute string form of the colliding literal output path.

tasks: BTreeSet<TaskId>

Tasks that declared this path. Always |tasks| >= 2.

Trait Implementations

impl Clone for BuildError

fn clone(&self) -> BuildError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BuildError

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

Formats the value using the given formatter.

impl Display for BuildError

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

Formats the value using the given formatter.

impl Eq for BuildError

impl Error for BuildError

where Self: Debug + Display,

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl ErrorCompat for BuildError

fn backtrace(&self) -> Option<&Backtrace>

Returns a Backtrace that may be printed.

fn iter_chain(&self) -> ChainCompat<'_, '_>

where Self: AsErrorSource,

Returns an iterator for traversing the chain of errors, starting with the current error and continuing with recursive calls to Error::source.

impl PartialEq for BuildError

fn eq(&self, other: &BuildError) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for BuildError