Struct NirGraph 

pub struct NirGraph {
    pub nodes: IndexMap<String, NirNode>,
    pub edges: Vec<(String, String)>,
    pub metadata: HashMap<String, MetadataValue>,
    pub version: Option<String>,
}

Directed NIR computation graph.

Node insertion order is preserved via IndexMap (stable iteration for serialization and debugging). Edges are an ordered list of (src, dst) name pairs.

Fields

nodes: IndexMap<String, NirNode>

Named computational nodes (insertion-ordered).

edges: Vec<(String, String)>

Directed edges as (source_name, destination_name).

metadata: HashMap<String, MetadataValue>

Free-form graph metadata.

version: Option<String>

Optional NIR version string (set when loading from HDF5 in v0.3).

Implementations

impl NirGraph

pub fn new() -> Self

Create an empty graph.

pub fn insert_node( &mut self, name: impl Into<String>, node: NirNode, ) -> Result<()>

Insert a node under name.

Errors

Returns NirError::DuplicateNode if name is already present.

pub fn add_edge(&mut self, from: impl Into<String>, to: impl Into<String>)

Append a directed edge (from → to) without validating endpoints.

Call validate_structure to check that endpoints exist and that the edge is not duplicated.

pub fn get(&self, name: &str) -> Option<&NirNode>

Borrow the node named name, if present.

pub fn get_mut(&mut self, name: &str) -> Option<&mut NirNode>

Mutably borrow the node named name, if present.

pub fn len(&self) -> usize

Number of nodes.

pub fn is_empty(&self) -> bool

Whether the graph has no nodes.

pub fn validate_structure(&self) -> Result<()>

Validate structural integrity.

Checks:

• every edge endpoint names an existing node
• no duplicate directed edges (src, dst)
• nested NirNode::Graph subgraphs also validate

Cycles are allowed. Type/shape inference is out of scope for v0.2.

Errors

• NirError::MissingNode if an endpoint is unknown
• NirError::DuplicateEdge if the same directed edge appears twice
• NirError::InvalidGraph if a nested subgraph fails validation

Trait Implementations

impl Clone for NirGraph

fn clone(&self) -> NirGraph

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for NirGraph

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

Formats the value using the given formatter.

impl Default for NirGraph

fn default() -> NirGraph

Returns the “default value” for a type.

impl PartialEq for NirGraph

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for NirGraph