Struct RustdvComp 

pub struct RustdvComp { /* private fields */ }

A slot that holds any component. It says nothing about position in the tree and nothing about overridability; the build line decides that (new_comp() fixed, create_comp() overridable). Every child field a block may want to override is an RustdvComp.

Implementations

impl RustdvComp

pub fn fixed(node: Box<dyn ComponentNode>) -> RustdvComp

A fixed slot: new_comp(). Never overridden.

pub fn overridable( node: Box<dyn ComponentNode>, requested: &'static str, ) -> RustdvComp

A factory slot: create_comp(). The default is built now and may be swapped for an override during the walk.

pub fn as_node(&self) -> Option<&(dyn ComponentNode + 'static)>

The held component, shared, for asking it things — chiefly for one of its ports during connect. None before the slot is built.

pub fn as_node_mut(&mut self) -> Option<&mut (dyn ComponentNode + 'static)>

The held component, for the traversal. None before it is filled. The object lifetime is 'static (a boxed component always is), which matches ComponentNode::children_mut’s element type.

pub fn take_node(&mut self) -> Option<Box<dyn ComponentNode>>

Move the held component out of the slot, leaving it empty (D82b).

This is what lets a parent’s run be concurrent with its children’s. While the box sits in the slot it is part of the parent, so &mut parent and &mut child overlap and cannot both exist. Once moved out it is an independent value with no borrow relationship to the parent, so both futures can be driven together.

The slot is empty only for the duration of the run phase; RustdvComp::put_node restores it before the post-run phases walk the tree.

pub fn put_node(&mut self, node: Box<dyn ComponentNode>)

Put a component taken by RustdvComp::take_node back into the slot.

pub fn resolve(&mut self, ctx: &RustdvCtx, name: &str)

Called by the derive-generated resolver during the build walk, with this slot’s field name. If flagged and an override applies at the slot’s path, swap it in. The discarded default’s phases never ran — resolution happens before the walk descends into the child.

Trait Implementations

impl Default for RustdvComp

fn default() -> RustdvComp

Returns the “default value” for a type.

impl PortOwner for RustdvComp

A slot is a PortOwner, so connect(&self.producer, ..) works on an erased child exactly as connect(self, ..) works on the connecting component. Both questions are answered by a ComponentNode method, which is reachable through dyn — no cast to the child’s concrete type, which Rust would not allow anyway.

fn owner_port_slot(&self, name: &str) -> Option<Rc<dyn Any>>

The binding cell of the named port, erased.

fn owner_label(&self) -> &'static str

The component’s type name, for connection errors.