Enum GraphError 

pub enum GraphError {
    ShapeMismatch,
    InvalidNodeId,
    IdCollision,
    CycleDetected,
}

Error types for Graph construction and validation.

These errors are returned by graph-building APIs when an operation cannot be represented safely in the current graph.

Examples

let mut g = Graph::new();
let a = g.input_node(vec![2, 3]);
let b = g.input_node(vec![2, 4]);

// add() requires identical shapes
assert!(matches!(g.add(a, b).unwrap_err(), GraphError::ShapeMismatch));

Variants

ShapeMismatch

Raised when connecting nodes whose tensor shapes are incompatible for the requested op.

Examples

• add(A, B) requires shape(A) == shape(B).
• matmul(L, R) requires L and R be 2-D and L.shape[1] == R.shape[0].

This error indicates the graph is not well-typed under the op’s shape rules.

InvalidNodeId

Raised when an operation references a NodeId that does not exist in the graph.

This typically happens when:

• A NodeId was produced by a different Graph instance, or
• A stale/invalid NodeId was stored and reused.

Example

let mut g1 = Graph::new();
let foreign = g1.input_node(vec![1, 1]);

let mut g2 = Graph::new();
assert!(matches!(g2.relu(foreign).unwrap_err(), GraphError::InvalidNodeId));

IdCollision

Raised when inserting a node whose ID already exists in the graph.

In this implementation, node IDs are expected to be monotonically increasing and unique. A collision indicates a serious invariant failure (e.g. ID overflow or a bug in node allocation), and should be treated as unrecoverable at the application level.

CycleDetected

Raised when the graph contains a cycle and no valid execution order exists.

Trait Implementations

impl Clone for GraphError

fn clone(&self) -> GraphError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

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

Formats the value using the given formatter.