Struct Port 

pub struct Port {
    pub name: String,
    pub typ: PortType,
    pub lifecycle: Lifecycle,
    pub wire_cost: WireCost,
    pub constraint: Option<ConstConstraint>,
    pub accepts_any_type: bool,
}

Descriptor for a single input or output port on a node.

Fields

name: String

The port’s name, as bindings and diagnostics refer to it.

typ: PortType

The port’s declared type.

lifecycle: Lifecycle

When the port’s value changes: per cycle, at init, or as configuration.

wire_cost: WireCost

Cost class for input ports. Ignored for output ports.

constraint: Option<ConstConstraint>

Optional value contract this wire must satisfy at runtime (graph_compiler.md §2, strict-wire assertions). The compiler uses this to decide whether to auto-insert a value assertion when the upstream source can’t statically be proven to deliver a satisfying value. None = no constraint declared.

Constraints reuse the same vocabulary as crate::dsl::const_constraints::ConstConstraint — the difference is just where the value comes from (a literal for ConstU64, a wire for Slot::Wire).

accepts_any_type: bool

Whether this port takes the wire’s value as it is, whatever type the wire carries — in which case Self::typ is a nominal placeholder and the assembler inserts no adapter into this port.

The one shape that needs it is an element of a &[Value] variadic: the node inspects the Value variant itself, so converting the wire to the port’s declared type would change what the node sees — json_array(cycle) would hold the text of a number rather than the number. A plain Value argument does not need it, because the assembler resolves that port’s type from its wire and hands it to the constructor.

The flag is per port rather than per node or per node name: pick’s selector wires must be Bool while its value wires are polymorphic, and one flag per node cannot say that.

Implementations

impl Port

pub fn new(name: impl Into<String>, typ: PortType) -> Self

A cycle-lifecycle port of the given type with no constraint.

pub fn any_type(self) -> Self

This port, taking the wire as it is whatever its type. See Self::accepts_any_type.

pub fn with_lifecycle( name: impl Into<String>, typ: PortType, lifecycle: Lifecycle, ) -> Self

Create a port with explicit lifecycle.

pub fn u64(name: impl Into<String>) -> Self

A u64 port.

pub fn f64(name: impl Into<String>) -> Self

An f64 port.

pub fn str(name: impl Into<String>) -> Self

A string port.

pub fn bool(name: impl Into<String>) -> Self

A boolean port.

pub fn json(name: impl Into<String>) -> Self

A JSON port.

pub fn handle(name: impl Into<String>) -> Self

A handle port.

pub fn vec_f32(name: impl Into<String>) -> Self

An f32 vector port.

pub fn vec_i32(name: impl Into<String>) -> Self

An i32 vector port.

pub fn init(name: impl Into<String>, typ: PortType) -> Self

Create an init-time port (frozen at assembly).

pub fn with_constraint(self, c: ConstConstraint) -> Self

Attach a value constraint. Used by node authors that want to declare “this wire must satisfy X” so strict-wire-mode can auto-insert the right value assertion. See graph_compiler.md §2.

pub fn config(self) -> Self

Mark this port as a config wire (expensive to change).

pub fn with_cost(self, cost: WireCost) -> Self

Set the wire cost directly. Used by the macro to thread Wire::WIRE_COST from the trait through to the slot.

Trait Implementations

impl Clone for Port

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Port

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

Formats the value using the given formatter.