Enum BuildError 

#[non_exhaustive]
pub enum BuildError {
    InvalidId {
        id: String,
        reason: &'static str,
    },
    DuplicateKnotId {
        knot_id: String,
    },
    ForeignHandle,
    UnknownPort {
        knot_id: String,
        port: String,
        expected: Vec<String>,
    },
    WrongPortDirection {
        knot_id: String,
        port: String,
        expected: PortDir,
        actual: PortDir,
    },
    UnknownExport {
        instance_id: String,
        export: String,
        direction: PortDir,
    },
    NumericMismatch {
        expected: NumericPath,
        actual: NumericPath,
    },
    SignalDomainMismatch {
        from_knot: String,
        from_port: String,
        from_domain: SignalDomain,
        to_knot: String,
        to_port: String,
        to_domain: SignalDomain,
    },
    RepresentationOverflow {
        what: &'static str,
        actual: usize,
        limit: usize,
    },
    Validation(ValidationError),
}

An authoring operation failed before final graph validation.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

InvalidId

A weave, knot, or pattern instance id fails non-empty / character rules during authoring.

Fields

id: String

Author id that failed naming rules.

reason: &'static str

Which naming rule the id violated.

DuplicateKnotId

WeaveBuilder::knot or include would introduce a duplicate knot id.

Fields

knot_id: String

Knot id already present in the builder.

ForeignHandle

A knot handle or port belongs to a different crate::WeaveBuilder than the current one.

UnknownPort

input, output, or slot_of names a port not declared for that knot kind.

Fields

knot_id: String

Knot whose catalog was consulted.

port: String

Port name that is not declared for this kind.

expected: Vec<String>

Catalog port names valid for this knot kind.

WrongPortDirection

The named port exists but was requested with the wrong direction.

Fields

knot_id: String

Knot that owns the referenced port.

port: String

Port name used with the wrong direction.

expected: PortDir

Direction requested by the authoring call.

actual: PortDir

Direction declared by the knot catalog for this port.

UnknownExport

PatternInstance::input or output names an export not defined by the pattern.

Fields

instance_id: String

Pattern instance prefix from include.

export: String

Export name missing from the pattern definition.

direction: PortDir

Whether an input or output export was requested.

NumericMismatch

include finds the pattern’s numeric path differs from the parent builder.

Fields

expected: NumericPath

Numeric path configured on the parent builder.

actual: NumericPath

Numeric path stored on the included pattern.

SignalDomainMismatch

connect would join ports with incompatible fixed signal domains.

Fields

from_knot: String

Source knot of the rejected connection.

from_port: String

Source port of the rejected connection.

from_domain: SignalDomain

Fixed domain on the output side.

to_knot: String

Sink knot of the rejected connection.

to_port: String

Sink port of the rejected connection.

to_domain: SignalDomain

Fixed domain required on the input side.

RepresentationOverflow

Authoring would exceed knot-index or owner-token representation limits.

Fields

what: &'static str

Representation resource kind (knot or builder owner token).

actual: usize

Count or token value that crossed the limit.

limit: usize

Maximum storable in the authoring representation.

Validation(ValidationError)

A fallible authoring step failed graph validation (via From<ValidationError>).

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, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for BuildError

impl Error for BuildError

Available on crate feature std only.

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 From<BuildError> for ComposeError

fn from(value: BuildError) -> Self

Converts to this type from the input type.

impl From<BuildError> for RecipeError

fn from(value: BuildError) -> Self

Converts to this type from the input type.

impl From<ValidationError> for BuildError

fn from(value: ValidationError) -> Self

Converts to this type from the input type.

impl PartialEq for BuildError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for BuildError