Skip to main content

Graph

Struct Graph 

Source
pub struct Graph { /* private fields */ }
Expand description

A single-thread graph/concurrency-domain product surface (D22/B53).

Implementations§

Source§

impl Graph

Source

pub fn checkpoint(&self) -> GraphRestoreResult<GraphCheckpoint>

Updates or reads checkpoint.

Source§

impl Graph

Source

pub fn new(opts: GraphOptions) -> Self

Creates or computes new.

Source

pub fn name(&self) -> Option<&str>

Updates or reads name.

Source

pub fn topology_group(&self) -> TopologyGroup

D152 graph-owned topology/release group. Members are ordinary registered graph nodes and release is quiescent-only; no protocol messages are synthesized.

Source

pub fn topology_group_opts(&self, opts: TopologyGroupOptions) -> TopologyGroup

Updates or reads topology_group_opts.

Source

pub fn find(&self, id: &str) -> Option<GraphNode>

Look up a registered graph node by stable id.

Source

pub fn node<T: 'static, F: Fn(&Ctx) + 'static>( &self, deps: Vec<Core>, f: F, ) -> Node<T>

ctx-level power surface: the raw (ctx)=>void node factory.

Source

pub fn node_opts<T: 'static, F: Fn(&Ctx) + 'static>( &self, deps: Vec<Core>, f: F, opts: GraphNodeOpts, ) -> Node<T>

Updates or reads node_opts.

Source

pub fn state<T: 'static>(&self, initial: T) -> Node<T>

Graph-owned state node with an initial value.

Source

pub fn state_opts<T: 'static>(&self, initial: T, opts: GraphNodeOpts) -> Node<T>

Updates or reads state_opts.

Source

pub fn state_empty<T: 'static>(&self) -> Node<T>

Graph-owned SENTINEL state node.

Source

pub fn state_empty_opts<T: 'static>(&self, opts: GraphNodeOpts) -> Node<T>

Updates or reads state_empty_opts.

Source

pub fn producer<T: 'static, F: Fn(&Ctx) + 'static>(&self, f: F) -> Node<T>

ctx-level depless source; runs once on activation.

Source

pub fn producer_opts<T: 'static, F: Fn(&Ctx) + 'static>( &self, f: F, opts: GraphNodeOpts, ) -> Node<T>

Updates or reads producer_opts.

Source

pub fn derived<T: 'static, F: Fn(&Values<'_>) -> Option<T> + 'static>( &self, deps: Vec<Core>, f: F, ) -> Node<T>

Value-level derived sugar: return Some(value) to emit DATA, None for a no-emit/RESOLVED settle. Reads dep values through Values, not raw Ctx.

Source

pub fn derived_opts<T: 'static, F: Fn(&Values<'_>) -> Option<T> + 'static>( &self, deps: Vec<Core>, f: F, opts: GraphNodeOpts, ) -> Node<T>

Updates or reads derived_opts.

Source

pub fn effect<F: Fn(&Values<'_>) -> Option<Box<dyn FnOnce()>> + 'static>( &self, deps: Vec<Core>, f: F, ) -> Node<()>

Value-level sink sugar. A returned cleanup is registered as onDeactivation.

Source

pub fn effect_opts<F: Fn(&Values<'_>) -> Option<Box<dyn FnOnce()>> + 'static>( &self, deps: Vec<Core>, f: F, opts: GraphNodeOpts, ) -> Node<()>

Updates or reads effect_opts.

Source

pub fn batch<R>(&self, f: impl FnOnce(&BatchCtx) -> R) -> R

Declarative batch (D12): success commits, rollback/panic discards.

Source

pub fn init_node<T: 'static>( &self, op: Operator<T>, deps: Vec<Core>, opts: GraphNodeOpts, ) -> Node<T>

Instantiate a free-standing operator/source as a registered graph node (D43/D40).

Source

pub fn mount(&self, child: Graph, at: impl Into<String>)

Mount a child graph under a stable :: path prefix.

Source

pub fn describe(&self) -> DescribeSnapshot

Static point-in-time inspection snapshot (D39 first cut).

Source

pub fn describe_opts(&self, opts: DescribeOpts) -> DescribeSnapshot

Updates or reads describe_opts.

Source

pub fn observe(&self) -> ObserveStream

Read-only observation egress for every currently registered node in this graph.

Source

pub fn observe_path(&self, path: &str) -> ObserveStream

Read-only observation egress for a single registered id or a :: subtree prefix.

Source

pub fn observe_topology(&self) -> TopologyStream

D145 read-only topology lifecycle egress over the existing graph registry.

This is not a graph node, does not subscribe to nodes, and does not publish DATA.

Source

pub fn observe_topology_path(&self, path: &str) -> TopologyStream

Read-only topology lifecycle egress for one registered id or :: subtree prefix.

Source

pub fn profile(&self) -> Profile

Opt-in accumulated-counter snapshot (D39/R-profile).

Trait Implementations§

Source§

impl Clone for Graph

Source§

fn clone(&self) -> Graph

Returns a duplicate of the value. Read more
1.0.0 · Source§

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

Performs copy-assignment from source. Read more

Auto Trait Implementations§

§

impl Freeze for Graph

§

impl !RefUnwindSafe for Graph

§

impl !Send for Graph

§

impl !Sync for Graph

§

impl Unpin for Graph

§

impl UnsafeUnpin for Graph

§

impl !UnwindSafe for Graph

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

§

impl<T> Instrument for T

§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided [Span], returning an Instrumented wrapper. Read more
§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

§

impl<T> PolicyExt for T
where T: ?Sized,

§

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns [Action::Follow] only if self and other return Action::Follow. Read more
§

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Policy<B, E>, P: Policy<B, E>,

Create a new Policy that returns [Action::Follow] if either self or other returns Action::Follow. Read more
Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

§

fn vzip(self) -> V

§

impl<T> WithSubscriber for T

§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a [WithDispatch] wrapper. Read more
§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a [WithDispatch] wrapper. Read more
§

impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
where ST: ?Sized, DT: ?Sized,

§

impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
where ST: ?Sized, DT: ?Sized,

§

impl<T> Read<Exclusive, BecauseExclusive> for T
where T: ?Sized,