haive.core.graph.branches

Branch system for dynamic routing based on state values.

Submodules

• haive.core.graph.branches.branch
• haive.core.graph.branches.dynamic
• haive.core.graph.branches.send_mapping
• haive.core.graph.branches.types
• haive.core.graph.branches.utils

Functions

chain(*branches[, default])	Chain multiple branches together, evaluating them in sequence.
conditional(condition, if_true, if_false[, default])	Create a Branch with conditional evaluation.
create_from_send_function(mapper_function)	Create a Send mapper branch from a function that returns Send objects.
from_function(function[, destinations, default])	Create a Branch from a function.
key_equals(key, value[, true_dest, false_dest])	Create a Branch that checks if a key equals a value.
key_exists(key[, true_dest, false_dest])	Create a Branch that checks if a key exists in the state.
message_contains(text[, true_dest, false_dest, ...])	Create a Branch that checks if the last message contains specific text.
send_mapper([function, mappings, generators])	Create a Branch that generates Send objects.

Package Contents

haive.core.graph.branches.chain(*branches, default='END')

Chain multiple branches together, evaluating them in sequence.

Parameters:

• branches (branch.Branch)

• default (str)

Return type:

branch.Branch

haive.core.graph.branches.conditional(condition, if_true, if_false, default='END')

Create a Branch with conditional evaluation.

Parameters:

• condition (collections.abc.Callable[[haive.core.graph.common.types.StateLike], bool])

• if_true (str | branch.Branch)

• if_false (str | branch.Branch)

• default (str)

Return type:

branch.Branch

haive.core.graph.branches.create_from_send_function(mapper_function)

Create a Send mapper branch from a function that returns Send objects.

Parameters:

mapper_function (collections.abc.Callable[[haive.core.graph.common.types.StateLike], list[Any]])

Return type:

branch.Branch

haive.core.graph.branches.from_function(function, destinations=None, default='END')

Create a Branch from a function.

Parameters:

• function (collections.abc.Callable[[haive.core.graph.common.types.StateLike], bool | str])

• destinations (dict[bool | str, str] | None)

• default (str)

Return type:

branch.Branch

haive.core.graph.branches.key_equals(key, value, true_dest='continue', false_dest='END')

Create a Branch that checks if a key equals a value.

Parameters:

• key (str)

• value (Any)

• true_dest (str)

• false_dest (str)

Return type:

branch.Branch

haive.core.graph.branches.key_exists(key, true_dest='continue', false_dest='END')

Create a Branch that checks if a key exists in the state.

Parameters:

• key (str)

• true_dest (str)

• false_dest (str)

Return type:

branch.Branch

haive.core.graph.branches.message_contains(text, true_dest='continue', false_dest='END', message_key='messages')

Create a Branch that checks if the last message contains specific text.

Parameters:

• text (str)

• true_dest (str)

• false_dest (str)

• message_key (str)

Return type:

branch.Branch

haive.core.graph.branches.send_mapper(function=None, mappings=None, generators=None)

Create a Branch that generates Send objects.

Parameters:

• function (collections.abc.Callable[[haive.core.graph.common.types.StateLike], list[Any]] | None)

• mappings (list[send_mapping.SendMapping] | None)

• generators (list[send_mapping.SendGenerator] | None)

Return type:

branch.Branch