flowno.core.mono_node

Type definitions for mono nodes in Flowno’s typechecking system.

A Mono Node is a node that returns a single value or tuple via return statement rather than streaming values via yield. This module defines Protocol classes that improve typechecking specificity for different node arities.

Examples

>>> @node
... def Add(a: int, b: int) -> int:
...     return a + b

>>> @node(multiple_outputs=True)
... def SumAndDiff(a: int, b: int):
...     return a + b, a - b

Warning

These classes are never instantiated directly - they exist solely for static type checking.

Naming Conventions

MonoNode: Base protocol for all mono nodes regardless of arity
MonoNodeX: Node with X inputs and any number of outputs
MonoNodeX_Y: Node with X inputs and Y outputs

See also

flowno.core.streaming_node: Type definitions for streaming nodes

class flowno.core.mono_node.MonoDraftOutputPortRef(node: DraftNode[Unpack, tuple[object, ...]], port_index: OutputPortIndex)[source]: Bases: DraftOutputPortRef[_Tout]

class flowno.core.mono_node.MonoNode(*args: Unpack)[source]

Bases: Protocol[Unpack[Ts], _ReturnTupleT_co]

Protocol for mono nodes that produce a single tuple return value.

A mono node is a node that returns a single value or tuple rather than streaming values via yield statements. This class serves as the base Protocol for all mono node arities.

Note: This class is never instantiated - it exists solely for typechecking.

class flowno.core.mono_node.MonoNode0[source]

Bases: DraftNode[_ReturnTupleT_co]

A mono node with 0 inputs that returns a tuple.