Struct Graph 

pub struct Graph<C = ()> { /* private fields */ }

Trellis graph skeleton with transactional input mutation.

Implementations

impl<C> Graph<C>

pub fn why_changed<H: NodeHandle>( &self, node: H, ) -> Option<&NodeChangeExplanation>

Explains why a typed node last changed.

pub fn why_changed_by_id(&self, node: NodeId) -> Option<&NodeChangeExplanation>

Explains why a node id last changed.

pub fn why_resource_command( &self, key: &ResourceKey, ) -> Option<&ResourceCommandExplanation>

Explains the latest resource command for a resource key.

pub fn why_output_frame( &self, key: OutputKey, ) -> Option<&OutputFrameExplanation>

Explains the latest output frame for an output key.

pub fn dependency_path(&self, from: NodeId, to: NodeId) -> Option<Vec<NodeId>>

Returns a dependency path from an upstream node to a downstream node.

pub fn scope_resource_inventory( &self, scope: ScopeId, ) -> GraphResult<ScopeResourceInventory>

Returns resources currently owned by a scope.

impl<C> Graph<C>

pub fn debug_dump(&self) -> String

Returns a deterministic text dump of graph metadata.

impl<C> Graph<C>

pub fn new_with_command_type() -> Self

Creates an empty graph.

pub fn revision(&self) -> Revision

Returns the graph revision.

pub fn begin_transaction(&mut self) -> GraphResult<Transaction<'_, C>>

where C: Clone,

Begins an input transaction with default options.

pub fn begin_transaction_with_options( &mut self, options: TransactionOptions, ) -> GraphResult<Transaction<'_, C>>

where C: Clone,

Begins an input transaction with explicit options.

pub fn node_meta<H: NodeHandle>(&self, node: H) -> Option<&NodeMeta>

Returns metadata for a node.

pub fn node_meta_by_id(&self, id: NodeId) -> Option<&NodeMeta>

Returns metadata for a node id.

pub fn scope_meta(&self, id: ScopeId) -> Option<&ScopeMeta>

Returns metadata for a scope.

pub fn output_meta(&self, key: OutputKey) -> Option<&OutputMeta>

Returns metadata for a materialized output.

pub fn dependencies<H: NodeHandle>(&self, node: H) -> Option<&DependencyList>

Returns declared dependencies for a node.

pub fn nodes(&self) -> impl Iterator<Item = &NodeMeta>

Returns all node metadata in stable id order.

pub fn scopes(&self) -> impl Iterator<Item = &ScopeMeta>

Returns all scope metadata in stable id order.

impl Graph<()>

pub fn new() -> Self

Creates an empty graph with no resource command payload type.

impl<C: Clone + PartialEq> Graph<C>

pub fn full_recompute(&self) -> GraphResult<FullRecomputeCheck>

Recomputes supported graph state from canonical inputs and compares it.

pub fn assert_incremental_equals_full(&self) -> GraphResult<FullRecomputeCheck>

Asserts that incremental state equals a supported full recompute.

pub fn full_recompute_check(&self) -> GraphResult<FullRecomputeCheck>

Compares committed incremental state against full recompute.

impl<C> Graph<C>

pub fn input_value<T>(&self, input: InputNode<T>) -> GraphResult<Option<&T>>

where T: Clone + PartialEq + Send + Sync + 'static,

Returns the committed value for a typed input node.

pub fn input_value_by_id<T>(&self, node: NodeId) -> GraphResult<Option<&T>>

where T: Clone + PartialEq + Send + Sync + 'static,

Returns the committed value for an input node id.

pub fn derived_value<T>( &self, derived: DerivedNode<T>, ) -> GraphResult<Option<&T>>

where T: Clone + PartialEq + Send + Sync + 'static,

Returns the committed value for a typed derived node.

pub fn derived_value_by_id<T>(&self, node: NodeId) -> GraphResult<Option<&T>>

where T: Clone + PartialEq + Send + Sync + 'static,

Returns the committed value for a derived node id.

pub fn map_collection<K, V>( &self, collection: CollectionNode<K, V>, ) -> GraphResult<Option<&BTreeMap<K, V>>>

where K: Clone + Ord + Send + Sync + 'static, V: Clone + PartialEq + Send + Sync + 'static,

Returns the committed map for a collection node.

pub fn set_collection<K>( &self, collection: CollectionNode<K, ()>, ) -> GraphResult<Option<&BTreeSet<K>>>

where K: Clone + Ord + Send + Sync + 'static,

Returns the committed set for a collection node.

pub fn map_diff<K, V>( &self, collection: CollectionNode<K, V>, ) -> GraphResult<Option<&MapDiff<K, V>>>

where K: Clone + Ord + Send + Sync + 'static, V: Clone + PartialEq + Send + Sync + 'static,

Returns the last committed map diff for the current transaction.

pub fn set_diff<K>( &self, collection: CollectionNode<K, ()>, ) -> GraphResult<Option<&SetDiff<K>>>

where K: Clone + Ord + Send + Sync + 'static,

Returns the last committed set diff for the current transaction.

pub fn map_collection_by_id<K, V>( &self, node: NodeId, ) -> GraphResult<Option<&BTreeMap<K, V>>>

where K: Clone + Ord + Send + Sync + 'static, V: Clone + PartialEq + Send + Sync + 'static,

Returns the committed map for a collection node id.

pub fn set_collection_by_id<K>( &self, node: NodeId, ) -> GraphResult<Option<&BTreeSet<K>>>

where K: Clone + Ord + Send + Sync + 'static,

Returns the committed set for a collection node id.

pub fn map_diff_by_id<K, V>( &self, node: NodeId, ) -> GraphResult<Option<&MapDiff<K, V>>>

where K: Clone + Ord + Send + Sync + 'static, V: Clone + PartialEq + Send + Sync + 'static,

Returns the current transaction’s map diff for a collection node id.

pub fn set_diff_by_id<K>( &self, node: NodeId, ) -> GraphResult<Option<&SetDiff<K>>>

where K: Clone + Ord + Send + Sync + 'static,

Returns the current transaction’s set diff for a collection node id.

impl<C> Graph<C>

pub fn resource_owners(&self, key: &ResourceKey) -> Option<&BTreeSet<ScopeId>>

Returns resource owners in deterministic resource-key order.

impl<C> Graph<C>

pub fn child_scopes(&self, scope: ScopeId) -> GraphResult<Vec<ScopeId>>

Returns child scopes in stable id order.

pub fn orphan_resources(&self) -> Vec<ResourceKey>

Returns resources whose owner set is empty or contains no live scope.

Trait Implementations

impl<C: Clone> Clone for Graph<C>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<C> Default for Graph<C>

fn default() -> Self

Returns the “default value” for a type.