PyDecisionGraph 0.3.1.post2__cp312-cp312-win_amd64.whl

decision_graph/__init__.py

@@ -0,0 +1,26 @@
+__version__ = "0.3.1.post2"
+
+import functools
+import logging
+import os
+import sys
+
+LOGGER = logging.getLogger("DecisionGraph")
+LOGGER.setLevel(logging.INFO)
+
+if not LOGGER.hasHandlers():
+    ch = logging.StreamHandler(sys.stdout)
+    ch.setLevel(logging.INFO)  # Set handler level
+    formatter = logging.Formatter("%(asctime)s - %(levelname)s - %(message)s")
+    ch.setFormatter(formatter)
+    LOGGER.addHandler(ch)
+
+from . import decision_tree
+from . import logic_group
+
+
+@functools.cache
+def get_include():
+    res_dir = os.path.dirname(__file__)
+    LOGGER.info(f'Building with <PyDecisionGraph> version: "{__version__}", resource directory: "{res_dir}".')
+    return res_dir

decision_graph/decision_tree/__init__.py

@@ -0,0 +1,85 @@
+import logging
+
+from .. import LOGGER
+
+LOGGER = LOGGER.getChild("DecisionTree")
+
+from .exc import *
+
+USING_CAPI = False
+try:
+    # Attempt to import the C API module
+    from . import capi
+    from .capi import c_abc
+    from .capi import c_node
+    from .capi import c_collection
+
+    USING_CAPI = True
+except Exception:
+    # Fallback to the python node model
+    from . import native
+    from .native import abc
+    from .native import node
+    from .native import collection
+
+    USING_CAPI = False
+
+if not USING_CAPI:
+    from .native import *
+    from ..webui.native import DecisionTreeWebUi, show, to_html
+    from ..webui import native as webui
+else:
+    from .capi import *
+    from ..webui.capi import DecisionTreeWebUi, show, to_html
+    from ..webui import capi as webui
+
+
+def set_logger(logger: logging.Logger):
+    global LOGGER
+    LOGGER = logger
+
+    # ensure abc module (imported above) receives logger
+    if USING_CAPI:
+        capi.set_logger(logger.getChild('CAPI'))
+    else:
+        native.set_logger(logger.getChild('Native'))
+
+    webui.set_logger(logger.getChild('WebUI'))
+
+
+__all__ = [
+    'USING_CAPI',
+
+    # .exc
+    'NO_DEFAULT',
+    'EmptyBlock', 'BreakBlock',
+    'NodeError', 'TooManyChildren', 'TooFewChildren', 'NodeNotFountError', 'NodeValueError', 'NodeTypeError', 'NodeContextError',
+    'EdgeValueError',
+    'EvalFailureError',
+    'BakeFailureError',
+    'ResolutionError', 'ExpressFalse', 'ExpressEvaluationError', 'ContextsNotFound',
+
+    # .capi.c_abc or .native.abc
+    'LOGGER', 'set_logger',
+    'Singleton',
+    'NodeEdgeCondition', 'ConditionElse', 'ConditionAny', 'ConditionAuto', 'BinaryCondition', 'ConditionTrue', 'ConditionFalse',
+    'NO_CONDITION', 'ELSE_CONDITION', 'AUTO_CONDITION', 'TRUE_CONDITION', 'FALSE_CONDITION',
+    'SkipContextsBlock', 'LogicExpression', 'LogicNode',
+    'LogicGroupManager', 'LGM', 'LogicGroup',
+    'ActionNode', 'BreakpointNode', 'PlaceholderNode',
+    'NoAction', 'LongAction', 'ShortAction',
+
+    # .capi.c_node or .native.node
+    'RootLogicNode', 'ContextLogicExpression',
+    'AttrExpression', 'AttrNestedExpression',
+    'GetterExpression', 'GetterNestedExpression',
+    'MathExpressionOperator', 'MathExpression',
+    'ComparisonExpressionOperator', 'ComparisonExpression',
+    'LogicalExpressionOperator', 'LogicalExpression',
+
+    # .capi.c_collection or .native.collection
+    'LogicMapping', 'LogicSequence', 'LogicGenerator',
+
+    # ..webui.capi or ..webui.native
+    'DecisionTreeWebUi', 'show', 'to_html'
+]

decision_graph/decision_tree/bake/__infra__.pxd

@@ -0,0 +1,502 @@
+from .c_var cimport (
+    DCG_VAR_HAS_SESSION_TIME,
+    DCG_VAR_STRING_MAXLEN,
+    DCG_VIGILANT,
+    dcg_ret_code,
+    dcg_var_numeric,
+    dcg_var_type_mask,
+    dcg_var_type,
+    dcg_d_vector_t,
+    dcg_d_matrix_t,
+    dcg_var_variant,
+    dcg_var_t,
+    dcg_node,
+    c_dcg_d_vector_new,
+    c_dcg_d_vector_new_child,
+    c_dcg_d_vector_free,
+    c_dcg_d_vector_data,
+    c_dcg_d_vector_size,
+    c_dcg_d_vector_at,
+    c_dcg_d_vector_set,
+    c_dcg_d_matrix_new,
+    c_dcg_d_matrix_new_child,
+    c_dcg_d_matrix_free,
+    c_dcg_d_matrix_data,
+    c_dcg_d_matrix_rows,
+    c_dcg_d_matrix_cols,
+    c_dcg_d_matrix_at,
+    c_dcg_d_matrix_set,
+    c_dcg_var_new,
+    c_dcg_var_new_bool,
+    c_dcg_var_new_double,
+    c_dcg_var_new_int,
+    c_dcg_var_new_offset,
+    c_dcg_var_new_string,
+    c_dcg_var_new_ptr,
+    c_dcg_var_new_dvector,
+    c_dcg_var_new_dmatrix,
+    c_dcg_var_new_ref,
+    c_dcg_var_free,
+    c_dcg_var_dealloc,
+    c_dcg_var_init,
+    c_dcg_var_init_reserved,
+    c_dcg_var_init_bool,
+    c_dcg_var_init_double,
+    c_dcg_var_init_int,
+    c_dcg_var_init_offset,
+    c_dcg_var_init_string,
+    c_dcg_var_init_ref_raw,
+    c_dcg_var_init_ref,
+    c_dcg_var_init_ptr,
+    c_dcg_var_init_node,
+    c_dcg_var_init_dvector,
+    c_dcg_var_init_dmatrix,
+    c_dcg_var_ref_level,
+    c_dcg_var_is_ref,
+    c_dcg_var_ref_base,
+    c_dcg_var_numeric_of,
+    c_dcg_ret_code_name,
+    c_dcg_var_type_name,
+    c_dcg_var_is_numeric,
+    c_dcg_var_is_container,
+    c_dcg_var_is_null,
+    c_dcg_var_is_truthy,
+    c_dcg_var_equals,
+    c_dcg_var_vigilant_abort,
+    c_dcg_var_ref_slot,
+    c_dcg_var_as_bool,
+    c_dcg_var_as_double,
+    c_dcg_var_as_int,
+    c_dcg_var_as_offset,
+    c_dcg_var_as_string,
+    c_dcg_var_as_ref,
+    c_dcg_var_as_ptr,
+    c_dcg_var_as_node,
+    c_dcg_var_as_dvector,
+    c_dcg_var_as_dmatrix,
+    c_dcg_var_cast,
+    c_dcg_var_snapshot,
+    c_dcg_var_format,
+    c_dcg_var_print,
+    c_dcg_var_pypack,
+    c_dcg_var_pyunpack
+)
+
+from .c_edge cimport (
+    DCG_NODE_STRING_MAXLEN,
+    C_NO_CONDITION,
+    C_ELSE_CONDITION,
+    C_AUTO_CONDITION,
+    C_TRUE_CONDITION,
+    C_FALSE_CONDITION,
+    EDGE_REGISTRY,
+    DCG_EDGE_REPR_MAXLEN,
+    dcg_node_edge_type,
+    dcg_node_edge_condition,
+    c_dcg_condition_init_globals,
+    c_dcg_condition_is_sentinel,
+    c_dcg_condition_is_none,
+    c_dcg_condition_is_else,
+    c_dcg_condition_is_auto,
+    c_dcg_condition_is_true,
+    c_dcg_condition_is_false,
+    c_dcg_condition_is_binary,
+    c_dcg_condition_equals,
+    c_dcg_condition_matches,
+    c_dcg_condition_init,
+    c_dcg_edge_new,
+    c_dcg_condition_dealloc,
+    c_dcg_condition_free,
+    c_dcg_condition_repr,
+    c_dcg_condition_format,
+    c_dcg_condition_print,
+    ConditionAny,
+    ConditionElse,
+    ConditionAuto,
+    BinaryCondition,
+    ConditionTrue,
+    ConditionFalse,
+    NO_CONDITION,
+    ELSE_CONDITION,
+    AUTO_CONDITION,
+    TRUE_CONDITION,
+    FALSE_CONDITION
+)
+
+from .c_node cimport (
+    dcg_node_ctx_ops,
+    dcg_logic_group_manager,
+    c_dcg_lgm_enter_node,
+    c_dcg_lgm_exit_node,
+    c_dcg_node_free_generic,
+    c_dcg_node_get_placeholder,
+    C_LGM,
+    NODE_REGISTRY,
+    DCG_NODE_STRING_MAXLEN,
+    DCG_NODE_RENDER_MAX_DEPTH,
+    DCG_DEF_REPR_NOACTION,
+    dcg_node_type,
+    dcg_node_mask,
+    dcg_node_flag,
+    dcg_node_label,
+    dcg_eval_flag,
+    dcg_node_hook_type,
+    dcg_node_hook_fn,
+    dcg_node_eval_ctx,
+    dcg_eval_stage,
+    dcg_node_event,
+    dcg_node_callback_fn,
+    dcg_node_callback_ctx,
+    dcg_node,
+    uuid_t,
+    dcg_validate_report,
+    dcg_render_style,
+    dcg_render_opts,
+    dcg_strbuf,
+    c_dcg_node_type_name,
+    c_dcg_node_type_is_input,
+    c_dcg_node_type_is_op,
+    c_dcg_node_type_is_flat,
+    c_dcg_node_type_is_action,
+    c_dcg_node_type_is_special,
+    c_dcg_node_type_arity,
+    c_dcg_node_gen_seq_id,
+    c_dcg_node_unlink,
+    c_dcg_node_adopt_condition,
+    c_dcg_node_init,
+    c_dcg_node_new,
+    c_dcg_node_dealloc,
+    c_dcg_node_free,
+    c_dcg_node_set_repr,
+    c_dcg_node_set_string,
+    c_dcg_node_register_eval_hook,
+    c_dcg_node_unregister_eval_hooks,
+    c_dcg_node_register_callback,
+    c_dcg_node_unregister_callback,
+    c_dcg_node_invoke_callbacks,
+    c_dcg_node_callback_count,
+    c_dcg_node_append,
+    c_dcg_node_append_auto,
+    c_dcg_node_append_at,
+    c_dcg_node_append_at_binary,
+    c_dcg_node_detach,
+    c_dcg_node_replace,
+    c_dcg_node_replace_shared,
+    c_dcg_node_new_placeholder,
+    c_dcg_node_consolidate_placeholder,
+    c_dcg_node_child_count,
+    c_dcg_node_first_child,
+    c_dcg_node_last_child,
+    c_dcg_node_child_at,
+    c_dcg_node_child_index,
+    c_dcg_node_child_by_condition,
+    c_dcg_node_next_sibling,
+    c_dcg_node_prev_sibling,
+    c_dcg_node_root,
+    c_dcg_node_depth,
+    c_dcg_node_height,
+    c_dcg_node_subtree_size,
+    c_dcg_node_leaf_count,
+    c_dcg_node_is_leaf,
+    c_dcg_node_is_root,
+    c_dcg_node_is_ancestor,
+    c_dcg_node_find_by_uid,
+    c_dcg_node_collect_leaves,
+    c_dcg_node_collect_descendants,
+    c_dcg_node_path_to,
+    c_dcg_node_add_label,
+    c_dcg_node_has_label,
+    c_dcg_node_remove_label,
+    c_dcg_node_label_count,
+    c_dcg_node_validate,
+    c_dcg_node_validate_print,
+    c_dcg_render_opts_default,
+    c_dcg_node_render,
+    c_dcg_node_print,
+    c_dcg_node_render_to_string,
+    c_dcg_node_arm_uuid,
+    c_dcg_node_format_uid,
+    c_dcg_node_getpid,
+    c_dcg_sb_init,
+    c_dcg_sb_puts,
+    c_dcg_sb_printf,
+    c_dcg_node_infer_condition,
+    c_dcg_node_link,
+    c_dcg_validate_fail,
+    c_dcg_node_validate_walk,
+    c_dcg_node_format_flags,
+    c_dcg_node_format_line,
+    c_dcg_node_render_walk,
+    c_dcg_node_collect_leaves_walk,
+    c_dcg_node_collect_descendants_walk
+)
+
+from .c_eval cimport (
+    DCG_EVAL_PATH_INITIAL_CAPACITY,
+    dcg_eval_run,
+
+    c_dcg_node_eval_path_new,
+    c_dcg_node_eval_path_free,
+    c_dcg_eval_path_reset,
+    c_dcg_eval_path_append,
+    c_dcg_root_node_eval_path_reserve,
+    c_dcg_root_node_eval_path_append,
+
+    c_dcg_node_eval_default,
+    c_dcg_node_eval_hooks,
+    c_dcg_node_eval,
+    c_dcg_node_dryrun,
+
+    c_dcg_eval_gen_seq_id,
+    c_dcg_eval_select_child,
+    c_dcg_node_eval_visit,
+    c_dcg_eval_path_outcome,
+    c_dcg_eval_walk,
+    c_dcg_node_eval_graph,
+    c_dcg_root_node_eval
+)
+
+from .c_const cimport (
+    dcg_logic_group,
+    dcg_logic_group_manager,
+    c_dcg_lgm_active_group,
+    c_dcg_node_var_bind,
+    dcg_constant_node,
+    dcg_variable_node,
+    c_dcg_node_pypack,
+    c_dcg_node_new_const,
+    c_dcg_node_free_const,
+    c_dcg_node_new_const_value,
+    c_dcg_node_new_const_bool,
+    c_dcg_node_new_const_double,
+    c_dcg_node_new_const_int,
+    c_dcg_node_new_const_string,
+    c_dcg_node_const_get,
+    c_dcg_node_const_set,
+    c_dcg_node_new_var,
+    c_dcg_node_free_var
+)
+
+from .c_expr cimport (
+    DCG_EXPR_DEFAULT_ARGS,
+    dcg_op_code,
+    dcg_expr_apply_fn,
+    dcg_op_mask,
+    dcg_expression_node,
+    c_dcg_node_new_expr,
+    c_dcg_node_free_expr,
+    c_dcg_node_new_expr_unary,
+    c_dcg_node_new_expr_binary,
+    c_dcg_node_new_expr_ternary,
+    c_dcg_node_new_expr_call,
+    c_dcg_node_expr_bind,
+
+    c_dcg_node_expr_set_op,
+    c_dcg_node_expr_apply_fn_of,
+    c_dcg_node_expr_apply_refuse,
+    c_dcg_node_expr_apply_neg,
+    c_dcg_node_expr_apply_not,
+    c_dcg_node_expr_apply_add,
+    c_dcg_node_expr_apply_sub,
+    c_dcg_node_expr_apply_mul,
+    c_dcg_node_expr_apply_div,
+    c_dcg_node_expr_apply_floordiv,
+    c_dcg_node_expr_apply_pow,
+    c_dcg_node_expr_apply_eq,
+    c_dcg_node_expr_apply_ne,
+    c_dcg_node_expr_apply_gt,
+    c_dcg_node_expr_apply_ge,
+    c_dcg_node_expr_apply_lt,
+    c_dcg_node_expr_apply_le,
+    c_dcg_node_expr_apply_and,
+    c_dcg_node_expr_apply_or,
+    c_dcg_node_expr_apply_unary,
+    c_dcg_node_expr_apply_binary,
+    c_dcg_node_expr_eval_operand,
+    c_dcg_node_expr_eval,
+    c_dcg_node_expr_eval_refuse,
+    c_dcg_node_expr_eval_unknown,
+    c_dcg_node_expr_eval_ternary,
+    c_dcg_node_expr_eval_call,
+    c_dcg_node_expr_eval_neg,
+    c_dcg_node_expr_eval_not,
+    c_dcg_node_expr_eval_add,
+    c_dcg_node_expr_eval_sub,
+    c_dcg_node_expr_eval_mul,
+    c_dcg_node_expr_eval_div,
+    c_dcg_node_expr_eval_floordiv,
+    c_dcg_node_expr_eval_pow,
+    c_dcg_node_expr_eval_eq,
+    c_dcg_node_expr_eval_ne,
+    c_dcg_node_expr_eval_gt,
+    c_dcg_node_expr_eval_ge,
+    c_dcg_node_expr_eval_lt,
+    c_dcg_node_expr_eval_le,
+    c_dcg_node_expr_eval_and,
+    c_dcg_node_expr_eval_or,
+    c_dcg_node_expr_alias,
+    c_dcg_node_expr_op_style,
+    c_dcg_node_expr_func_style
+)
+
+from .c_action cimport (
+    dcg_logic_group_manager,
+    c_dcg_node_connect_new_action,
+    c_dcg_node_connect_new_action_clear,
+    c_dcg_node_connect_new_action_trade,
+    dcg_action_node,
+    c_dcg_node_new_action,
+    c_dcg_node_free_action,
+    c_dcg_node_new_action_trade,
+    c_dcg_node_new_action_clear,
+    c_dcg_node_auto_fill
+)
+
+from .c_hierarchy cimport (
+    dcg_logic_group,
+    dcg_node_eval_path,
+    dcg_root_node,
+    dcg_breakpoint_node,
+    c_dcg_node_new_root,
+    c_dcg_node_new_breakpoint,
+    c_dcg_node_ctx_enter_breakpoint,
+    c_dcg_node_get_breakpoint,
+    c_dcg_node_free_root,
+    c_dcg_node_free_breakpoint,
+    c_dcg_node_free_generic,
+    c_dcg_node_teardown_root,
+    c_dcg_node_remove,
+    c_dcg_node_clear_children,
+    c_dcg_node_clean,
+
+    NodeEvalPathView
+)
+
+
+from .c_logic_group cimport (
+    dcg_node_type,
+    dcg_action_node,
+    GROUP_REGISTRY,
+    DCG_LGM_DEFAULT_CAPACITY,
+    dcg_logic_group_type,
+    dcg_logic_group,
+    dcg_lgm_state,
+    dcg_logic_group_manager,
+    c_dcg_logic_group_type_name,
+    c_dcg_lgm_reserve,
+    c_dcg_lgm_push_group,
+    c_dcg_lgm_push_node,
+    c_dcg_lgm_push_breakpoint,
+    c_dcg_logic_group_init,
+    c_dcg_logic_group_new,
+    c_dcg_logic_group_dealloc,
+    c_dcg_logic_group_free,
+    c_dcg_lgm_new,
+    c_dcg_lgm_init,
+    c_dcg_lgm_dealloc,
+    c_dcg_lgm_free,
+    c_dcg_lgm_clear,
+    c_dcg_lgm_register,
+    c_dcg_lgm_find,
+    c_dcg_lgm_enter_group,
+    c_dcg_lgm_exit_group,
+    c_dcg_lgm_enter_node,
+    c_dcg_lgm_connect_awaiting,
+    c_dcg_lgm_exit_node,
+    c_dcg_lgm_label_node,
+    c_dcg_lgm_break_inspection,
+    c_dcg_lgm_install_breakpoint,
+    c_dcg_node_root_ctx_shelve,
+    c_dcg_node_root_ctx_unshelve,
+    c_dcg_lgm_shelve,
+    c_dcg_lgm_unshelve,
+    c_dcg_lgm_active_group,
+    c_dcg_lgm_active_node,
+    c_dcg_lgm_breakpoint_count,
+    c_dcg_node_auto_connect,
+    c_dcg_node_connect_new_action,
+    c_dcg_node_connect_new_action_trade,
+    c_dcg_node_connect_new_action_clear,
+    c_dcg_node_connect_new_placeholder,
+    LogicGroupNameRegistry,
+    LGM
+)
+
+from .c_collections cimport (
+    c_dcg_node_mapping_var_node_eval_hook,
+    DCG_MAPPING_DEFAULT_CAPACITY,
+    c_dcg_mapping_lgroup_dealloc,
+    dcg_mapping_lgroup,
+    c_dcg_mapping_lgroup_new,
+    c_dcg_mapping_lgroup_free,
+    c_dcg_mapping_lgroup_clear,
+    c_dcg_mapping_lgroup_set,
+    c_dcg_mapping_lgroup_set_ref,
+    c_dcg_mapping_lgroup_set_ptr,
+    c_dcg_mapping_lgroup_set_double,
+    c_dcg_mapping_lgroup_set_int,
+    c_dcg_mapping_lgroup_set_offset,
+    c_dcg_mapping_lgroup_set_bool,
+    c_dcg_mapping_lgroup_get_var_idx,
+    c_dcg_mapping_lgroup_get_node,
+    c_dcg_mapping_lgroup_get_slot,
+    c_dcg_mapping_lgroup_get_create_slot
+)
+
+from .c_allocator_protocol cimport (
+    DCG_CFG_LOCKED,
+    DCG_CFG_SHARED,
+    DCG_CFG_FREELIST,
+    ConfigContext,
+    HEAP_ALLOCATOR,
+    SHM_ALLOCATOR,
+    DCG_DEFAULT_ALLOCATOR,
+    DCG_SHM_ALLOCATOR,
+    DCG_HEAP_ALLOCATOR,
+    DCG_SHARED,
+    DCG_LOCKED,
+    DCG_LOCKFREE,
+    DCG_FREELIST
+)
+from .c_reconstruct cimport (
+    c_dcg_node_reconstruct,
+    c_dcg_node_reconstruct_const,
+    c_dcg_node_reconstruct_variable,
+    c_dcg_node_reconstruct_attr,
+    c_dcg_node_reconstruct_expr,
+    c_dcg_node_reconstruct_unary,
+    c_dcg_node_reconstruct_binary,
+    c_dcg_node_reconstruct_ternary,
+    c_dcg_node_reconstruct_action,
+    c_dcg_node_reconstruct_noaction,
+    c_dcg_node_reconstruct_longaction,
+    c_dcg_node_reconstruct_shortaction,
+    c_dcg_node_reconstruct_cancelaction,
+    c_dcg_node_reconstruct_clearaction,
+    c_dcg_node_reconstruct_placeholder,
+    c_dcg_node_reconstruct_root,
+    c_dcg_node_reconstruct_breakpoint,
+    c_dcg_node_reconstruct_from_address,
+    c_dcg_node_root_from_address
+)
+
+from .c_bake cimport (
+    dcg_bake_flag,
+    dcg_bake_input,
+    dcg_bake_report,
+
+    c_dcg_bake_input_init,
+    c_dcg_bake_report_new,
+    c_dcg_bake_report_free,
+    c_dcg_bake_fail,
+    c_dcg_bake_node_check,
+    c_dcg_bake_node_lock,
+    c_dcg_bake_walk,
+    c_dcg_bake_lock_walk,
+    c_dcg_bake_unmark_walk,
+    c_dcg_bake_prepare_record,
+    c_dcg_root_node_bake,
+
+    BakeReport,
+    c_dcg_bake_root
+)