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 (SRD 15 §“Strict Wire Mode”). 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 assembler used to decide this from a list of thirteen node names, which was both a name-keyed table and the wrong granularity: 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 SRD 15 §“Strict Wire Mode”.

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.