Enum GraphError 

pub enum GraphError {
    PadOutOfRange {
        index: usize,
        pad_count: usize,
    },
    PadAlreadyLinked(String),
    ParentNotAttached(ElementId),
    NodeAlreadyAttached(ElementId),
    BranchNotAttached(BranchId),
    TimelineOperationInProgress,
    EmptyBranch,
    IncompatibleLink {
        producer: Arc<str>,
        produced: PortContract,
        consumer: Arc<str>,
        accepted: PortContract,
    },
    NotSingleOutput {
        name: Arc<str>,
        count: usize,
    },
}

A rejected topology change.

Every variant here is a refusal, not a partial result: attachment validates before it mutates, so a graph that returns one of these is left exactly as it was.

Variants

PadOutOfRange

The requested source pad index does not exist.

Fields

index: usize

Requested zero-based source pad index.

pad_count: usize

Number of source pads available on the element.

PadAlreadyLinked(String)

Attachment targeted a source pad that already owns a downstream sink.

ParentNotAttached(ElementId)

A dynamic attachment named an element that is no longer in this graph.

NodeAlreadyAttached(ElementId)

An attachment plan attempted to publish an already-attached node.

BranchNotAttached(BranchId)

A detach operation named a branch that is no longer attached.

TimelineOperationInProgress

A branch cannot join while a seek/lifecycle transaction is taking its topology and control snapshots.

EmptyBranch

An attachment plan contained no terminal or processing element.

IncompatibleLink

Two elements were wired together even though what one produces can never reach the other — see crate::contract. Reported when the branch is built or attached, before anything runs, because no buffer could have made this link work.

Fields

producer: Arc<str>

Name of the element or pad on the producing side.

produced: PortContract

What that side emits.

consumer: Arc<str>

Caller-selected name of the element that rejected the link.

accepted: PortContract

What the consuming side accepts.

NotSingleOutput

crate::pipeline::ChainBuilder::pipe received a filter whose output shape cannot be represented as one linear chain stage.

Fields

name: Arc<str>

Caller-selected name of the rejected filter.

count: usize

Number of source pads exposed by the rejected filter.

Trait Implementations

impl Debug for GraphError

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

Formats the value using the given formatter.

impl Display for GraphError

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

Formats the value using the given formatter.

impl Eq for GraphError

impl Error for GraphError

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<GraphError> for Error

fn from(source: GraphError) -> Self

Converts to this type from the input type.

impl PartialEq for GraphError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for GraphError