PyEventEngine 0.6.0.post3__cp314-cp314t-win_amd64.whl

event_engine/base/c_allocator_protocol.h

@@ -0,0 +1,23 @@
+#ifndef C_EVENT_ENGINE_ALLOCATOR_PROTOCOL_H
+#define C_EVENT_ENGINE_ALLOCATOR_PROTOCOL_H
+
+/**
+ * @brief EventEngine-local allocator protocol header.
+ *
+ * Wraps PyCyBase's allocator_protocol with an EE_LOCAL_ONLY compile-time
+ * switch.  When EE_LOCAL_ONLY is 1 (default, thread-local engine), only the
+ * heap-allocator branch is available and SHM is excluded.  Set to 0 to
+ * enable the full shared-memory allocator stack.
+ */
+
+#ifndef EE_LOCAL_ONLY
+#define EE_LOCAL_ONLY 1
+#endif
+
+#include <cbase/allocator_protocol/c_allocator_protocol.h>
+
+#if !EE_LOCAL_ONLY
+#include <cbase/allocator_protocol/c_shm_comp.h>
+#endif
+
+#endif /* C_EVENT_ENGINE_ALLOCATOR_PROTOCOL_H */

event_engine/base/c_allocator_protocol.pxd

@@ -0,0 +1,31 @@
+from libcpp cimport bool as c_bool
+
+from cbase.allocator_protocol.c_allocator_protocol cimport AllocatorConfigContext, allocator_protocol
+from cbase.allocator_protocol.c_heap_allocator cimport heap_allocator
+from cbase.allocator_protocol.c_shm_comp cimport shm_allocator_ctx
+
+
+cdef extern from "event_engine/base/c_allocator_protocol.h":
+    const c_bool EE_LOCAL_ONLY
+
+
+cdef c_bool EE_CFG_LOCKED
+cdef c_bool EE_CFG_SHARED
+cdef c_bool EE_CFG_FREELIST
+
+
+cdef class EEConfigContext(AllocatorConfigContext):
+    pass
+
+
+cdef heap_allocator* EE_HEAP_ALLOCATOR_RAW
+cdef shm_allocator_ctx* EE_SHM_ALLOCATOR_RAW
+
+cdef allocator_protocol* EE_DEFAULT_ALLOCATOR
+cdef allocator_protocol* EE_SHM_ALLOCATOR
+cdef allocator_protocol* EE_HEAP_ALLOCATOR
+
+cdef EEConfigContext EE_SHARED
+cdef EEConfigContext EE_LOCKED
+cdef EEConfigContext EE_LOCKFREE
+cdef EEConfigContext EE_FREELIST

event_engine/base/c_allocator_protocol.pyx

@@ -0,0 +1,99 @@
+from libc.stdlib cimport calloc
+
+from cbase.allocator_protocol.c_heap_allocator cimport c_heap_allocator_new
+from cbase.allocator_protocol.c_shm_comp cimport c_shm_allocator_new, AP_SHM_ALLOCATOR_DEFAULT_REGION_SIZE
+
+
+cdef c_bool EE_CFG_LOCKED = False
+cdef c_bool EE_CFG_SHARED = False
+cdef c_bool EE_CFG_FREELIST = True
+
+
+cdef class EEConfigContext(AllocatorConfigContext):
+    cdef void c_bind(self, allocator_protocol* schematic=NULL):
+        self.allocator_schematic = schematic if schematic else EE_DEFAULT_ALLOCATOR
+
+    cdef void c_activate(self):
+        if 'locked' in self.overrides:
+            global EE_CFG_LOCKED
+            EE_CFG_LOCKED = self.overrides['locked']
+
+        if 'shared' in self.overrides:
+            global EE_CFG_SHARED
+            EE_CFG_SHARED = self.overrides['shared']
+
+        if 'freelist' in self.overrides:
+            global EE_CFG_FREELIST
+            EE_CFG_FREELIST = self.overrides['freelist']
+
+        AllocatorConfigContext.c_activate(self)
+
+    cdef void c_deactivate(self):
+        if 'locked' in self.originals:
+            global EE_CFG_LOCKED
+            EE_CFG_LOCKED = self.originals.get('locked')
+
+        if 'shared' in self.originals:
+            global EE_CFG_SHARED
+            EE_CFG_SHARED = self.originals.get('shared')
+
+        if 'freelist' in self.originals:
+            global EE_CFG_FREELIST
+            EE_CFG_FREELIST = self.originals.get('freelist')
+
+        AllocatorConfigContext.c_deactivate(self)
+
+
+# --- Module-level allocator singletons ---
+
+cdef heap_allocator* EE_HEAP_ALLOCATOR_RAW = c_heap_allocator_new()
+if not EE_HEAP_ALLOCATOR_RAW:
+    raise OSError("Initialize EE heap allocator failed")
+
+cdef shm_allocator_ctx* EE_SHM_ALLOCATOR_RAW = NULL
+
+if not EE_LOCAL_ONLY:
+    EE_SHM_ALLOCATOR_RAW = c_shm_allocator_new(AP_SHM_ALLOCATOR_DEFAULT_REGION_SIZE, <char*> b"c_ee_shm")
+    if not EE_SHM_ALLOCATOR_RAW:
+        raise OSError("Initialize EE SHM allocator failed (prefix='c_ee_shm')")
+
+
+cdef allocator_protocol* EE_DEFAULT_ALLOCATOR = <allocator_protocol*> calloc(1, sizeof(allocator_protocol))
+cdef allocator_protocol* EE_HEAP_ALLOCATOR    = <allocator_protocol*> calloc(1, sizeof(allocator_protocol))
+
+EE_DEFAULT_ALLOCATOR.with_lock          = EE_CFG_LOCKED
+EE_DEFAULT_ALLOCATOR.with_shm           = EE_CFG_SHARED
+EE_DEFAULT_ALLOCATOR.with_freelist      = EE_CFG_FREELIST
+EE_DEFAULT_ALLOCATOR.shm_allocator_ctx  = EE_SHM_ALLOCATOR_RAW
+EE_DEFAULT_ALLOCATOR.shm_allocator      = EE_SHM_ALLOCATOR_RAW.shm_allocator if EE_SHM_ALLOCATOR_RAW != NULL else NULL
+EE_DEFAULT_ALLOCATOR.heap_allocator     = EE_HEAP_ALLOCATOR_RAW
+
+EE_HEAP_ALLOCATOR.with_lock             = True
+EE_HEAP_ALLOCATOR.with_shm              = False
+EE_HEAP_ALLOCATOR.with_freelist         = True
+EE_HEAP_ALLOCATOR.shm_allocator_ctx     = NULL
+EE_HEAP_ALLOCATOR.shm_allocator         = NULL
+EE_HEAP_ALLOCATOR.heap_allocator        = EE_HEAP_ALLOCATOR_RAW
+
+cdef allocator_protocol* EE_SHM_ALLOCATOR = NULL
+
+if not EE_LOCAL_ONLY:
+    EE_SHM_ALLOCATOR = <allocator_protocol*> calloc(1, sizeof(allocator_protocol))
+
+    EE_SHM_ALLOCATOR.with_lock              = True
+    EE_SHM_ALLOCATOR.with_shm               = True
+    EE_SHM_ALLOCATOR.with_freelist          = True
+    EE_SHM_ALLOCATOR.shm_allocator_ctx      = EE_SHM_ALLOCATOR_RAW
+    EE_SHM_ALLOCATOR.shm_allocator          = EE_SHM_ALLOCATOR_RAW.shm_allocator
+    EE_SHM_ALLOCATOR.heap_allocator         = NULL
+
+
+cdef EEConfigContext EE_SHARED   = EEConfigContext(shared=True)
+cdef EEConfigContext EE_LOCKED   = EEConfigContext(locked=True)
+cdef EEConfigContext EE_LOCKFREE = EEConfigContext(locked=False)
+cdef EEConfigContext EE_FREELIST = EEConfigContext(freelist=True)
+
+globals()['EE_SHARED'] = EE_SHARED
+globals()['EE_LOCKED'] = EE_LOCKED
+globals()['EE_LOCKFREE'] = EE_LOCKFREE
+globals()['EE_FREELIST'] = EE_FREELIST

event_engine/capi/__infra__.pxd

@@ -0,0 +1,189 @@
+from .c_topic cimport (
+    DEFAULT_TOPIC_SEP,
+    DEFAULT_OPTION_SEP,
+    DEFAULT_RANGE_BRACKETS,
+    DEFAULT_WILDCARD_BRACKETS,
+    DEFAULT_WILDCARD_MARKER,
+    DEFAULT_PATTERN_DELIM,
+    GLOBAL_INTERNAL_MAP,
+
+    c_get_global_internal_map,
+    c_topic_new,
+    c_topic_free,
+    c_topic_internalize,
+    c_topic_append,
+    c_topic_parse,
+    c_topic_assign,
+    c_topic_update_literal,
+    c_topic_match,
+    c_topic_match_new,
+    c_topic_match_free,
+    c_topic_match_bool,
+
+    evt_topic_type, evt_topic_part,
+    TopicPartExact, evt_topic_exact,
+    TopicPartAny, evt_topic_any,
+    TopicPartRange, evt_topic_range,
+    TopicPartPattern, evt_topic_pattern,
+    TopicPart, evt_topic_part_variant,
+    TopicMatchResult, evt_topic_match,
+    Topic, evt_topic,
+
+    TOPIC_ALLOCATOR,
+    get_internal_topic,
+    get_internal_map,
+)
+
+from .c_event cimport (
+    evt_py_payload, evt_message_payload, MessagePayload,
+    c_evt_payload_new,
+    c_evt_payload_free,
+
+    evt_callback_bare,
+    evt_callback_with_args,
+    evt_callback_with_topic,
+    evt_callback_with_userdata,
+    evt_callback_with_args_topic,
+    evt_callback_with_args_userdata,
+    evt_callback_with_topic_userdata,
+    evt_callback_with_args_topic_userdata,
+    evt_callback_with_payload,
+    evt_callback_with_payload_userdata,
+
+    evt_callback_type,
+    evt_callback_variants,
+    evt_callback,
+    evt_py_callable,
+
+    evt_hook_watcher_type,
+    evt_hook_watcher_fn,
+    evt_hook_watcher,
+    evt_hook_stats, c_hook_enter, c_hook_exit,
+
+    evt_hook, EventHook, EventHookEx,
+
+    c_evt_callback_invoke,
+    c_evt_hook_new,
+    c_evt_hook_free,
+    c_evt_hook_add_watcher,
+    c_evt_hook_register_callback,
+    c_evt_hook_pop_callback,
+    c_evt_hook_invoke,
+    evt_hook_ret_code,
+
+    EMPTY_ARGS, TOPIC_FIELD_NAME
+)
+
+from .c_engine cimport (
+    DEFAULT_MQ_CAPACITY,
+    DEFAULT_MQ_SPIN_LIMIT,
+    DEFAULT_MQ_TIMEOUT_SECONDS,
+    message_queue,
+
+    c_mq_new,
+    c_mq_free,
+    c_mq_put,
+    c_mq_get,
+    c_mq_put_await,
+    c_mq_get_await,
+    c_mq_put_busy,
+    c_mq_get_busy,
+    c_mq_put_hybrid,
+    c_mq_get_hybrid,
+    c_mq_occupied,
+
+    EventEngine, EventEngineEx
+)
+
+__all__ = [
+    'DEFAULT_TOPIC_SEP',
+    'DEFAULT_OPTION_SEP',
+    'DEFAULT_RANGE_BRACKETS',
+    'DEFAULT_WILDCARD_BRACKETS',
+    'DEFAULT_WILDCARD_MARKER',
+    'DEFAULT_PATTERN_DELIM',
+    'GLOBAL_INTERNAL_MAP',
+
+    'c_get_global_internal_map',
+    'c_topic_new',
+    'c_topic_free',
+    'c_topic_internalize',
+    'c_topic_append',
+    'c_topic_parse',
+    'c_topic_assign',
+    'c_topic_update_literal',
+    'c_topic_match',
+    'c_topic_match_new',
+    'c_topic_match_free',
+    'c_topic_match_bool',
+
+    'evt_topic_type', 'evt_topic_part',
+    'TopicPartExact', 'evt_topic_exact',
+    'TopicPartAny', 'evt_topic_any',
+    'TopicPartRange', 'evt_topic_range',
+    'TopicPartPattern', 'evt_topic_pattern',
+    'TopicPart', 'evt_topic_part_variant',
+    'TopicMatchResult', 'evt_topic_match',
+    'Topic', 'evt_topic',
+
+    'TOPIC_ALLOCATOR',
+    'get_internal_topic',
+    'get_internal_map',
+
+    'evt_py_payload', 'evt_message_payload', 'MessagePayload',
+    'c_evt_payload_new',
+    'c_evt_payload_free',
+
+    'evt_callback_bare',
+    'evt_callback_with_args',
+    'evt_callback_with_topic',
+    'evt_callback_with_userdata',
+    'evt_callback_with_args_topic',
+    'evt_callback_with_args_userdata',
+    'evt_callback_with_topic_userdata',
+    'evt_callback_with_args_topic_userdata',
+    'evt_callback_with_payload',
+    'evt_callback_with_payload_userdata',
+
+    'evt_callback_type',
+    'evt_callback_variants',
+    'evt_callback',
+    'evt_py_callable',
+
+    'evt_hook_watcher_type',
+    'evt_hook_watcher_fn',
+    'evt_hook_watcher',
+    'evt_hook_stats', 'c_hook_enter', 'c_hook_exit',
+
+    'evt_hook', 'EventHook', 'EventHookEx',
+
+    'c_evt_callback_invoke',
+    'c_evt_hook_new',
+    'c_evt_hook_free',
+    'c_evt_hook_add_watcher',
+    'c_evt_hook_register_callback',
+    'c_evt_hook_pop_callback',
+    'c_evt_hook_invoke',
+    'evt_hook_ret_code',
+
+    'EMPTY_ARGS', 'TOPIC_FIELD_NAME',
+
+    'DEFAULT_MQ_CAPACITY',
+    'DEFAULT_MQ_SPIN_LIMIT',
+    'DEFAULT_MQ_TIMEOUT_SECONDS',
+    'message_queue',
+
+    'c_mq_new',
+    'c_mq_free',
+    'c_mq_put',
+    'c_mq_get',
+    'c_mq_put_await',
+    'c_mq_get_await',
+    'c_mq_put_busy',
+    'c_mq_get_busy',
+    'c_mq_put_hybrid',
+    'c_mq_get_hybrid',
+    'c_mq_occupied',
+
+    'EventEngine', 'EventEngineEx'
+]

event_engine/capi/__init__.pxd

@@ -0,0 +1,189 @@
+from .c_topic cimport (
+    DEFAULT_TOPIC_SEP,
+    DEFAULT_OPTION_SEP,
+    DEFAULT_RANGE_BRACKETS,
+    DEFAULT_WILDCARD_BRACKETS,
+    DEFAULT_WILDCARD_MARKER,
+    DEFAULT_PATTERN_DELIM,
+    GLOBAL_INTERNAL_MAP,
+
+    c_get_global_internal_map,
+    c_topic_new,
+    c_topic_free,
+    c_topic_internalize,
+    c_topic_append,
+    c_topic_parse,
+    c_topic_assign,
+    c_topic_update_literal,
+    c_topic_match,
+    c_topic_match_new,
+    c_topic_match_free,
+    c_topic_match_bool,
+
+    evt_topic_type, evt_topic_part,
+    TopicPartExact, evt_topic_exact,
+    TopicPartAny, evt_topic_any,
+    TopicPartRange, evt_topic_range,
+    TopicPartPattern, evt_topic_pattern,
+    TopicPart, evt_topic_part_variant,
+    TopicMatchResult, evt_topic_match,
+    Topic, evt_topic,
+
+    TOPIC_ALLOCATOR,
+    get_internal_topic,
+    get_internal_map,
+)
+
+from .c_event cimport (
+    evt_py_payload, evt_message_payload, MessagePayload,
+    c_evt_payload_new,
+    c_evt_payload_free,
+
+    evt_callback_bare,
+    evt_callback_with_args,
+    evt_callback_with_topic,
+    evt_callback_with_userdata,
+    evt_callback_with_args_topic,
+    evt_callback_with_args_userdata,
+    evt_callback_with_topic_userdata,
+    evt_callback_with_args_topic_userdata,
+    evt_callback_with_payload,
+    evt_callback_with_payload_userdata,
+
+    evt_callback_type,
+    evt_callback_variants,
+    evt_callback,
+    evt_py_callable,
+
+    evt_hook_watcher_type,
+    evt_hook_watcher_fn,
+    evt_hook_watcher,
+    evt_hook_stats, c_hook_enter, c_hook_exit,
+
+    evt_hook, EventHook, EventHookEx,
+
+    c_evt_callback_invoke,
+    c_evt_hook_new,
+    c_evt_hook_free,
+    c_evt_hook_add_watcher,
+    c_evt_hook_register_callback,
+    c_evt_hook_pop_callback,
+    c_evt_hook_invoke,
+    evt_hook_ret_code,
+
+    EMPTY_ARGS, TOPIC_FIELD_NAME
+)
+
+from .c_engine cimport (
+    DEFAULT_MQ_CAPACITY,
+    DEFAULT_MQ_SPIN_LIMIT,
+    DEFAULT_MQ_TIMEOUT_SECONDS,
+    message_queue,
+
+    c_mq_new,
+    c_mq_free,
+    c_mq_put,
+    c_mq_get,
+    c_mq_put_await,
+    c_mq_get_await,
+    c_mq_put_busy,
+    c_mq_get_busy,
+    c_mq_put_hybrid,
+    c_mq_get_hybrid,
+    c_mq_occupied,
+
+    EventEngine, EventEngineEx
+)
+
+__all__ = [
+    'DEFAULT_TOPIC_SEP',
+    'DEFAULT_OPTION_SEP',
+    'DEFAULT_RANGE_BRACKETS',
+    'DEFAULT_WILDCARD_BRACKETS',
+    'DEFAULT_WILDCARD_MARKER',
+    'DEFAULT_PATTERN_DELIM',
+    'GLOBAL_INTERNAL_MAP',
+
+    'c_get_global_internal_map',
+    'c_topic_new',
+    'c_topic_free',
+    'c_topic_internalize',
+    'c_topic_append',
+    'c_topic_parse',
+    'c_topic_assign',
+    'c_topic_update_literal',
+    'c_topic_match',
+    'c_topic_match_new',
+    'c_topic_match_free',
+    'c_topic_match_bool',
+
+    'evt_topic_type', 'evt_topic_part',
+    'TopicPartExact', 'evt_topic_exact',
+    'TopicPartAny', 'evt_topic_any',
+    'TopicPartRange', 'evt_topic_range',
+    'TopicPartPattern', 'evt_topic_pattern',
+    'TopicPart', 'evt_topic_part_variant',
+    'TopicMatchResult', 'evt_topic_match',
+    'Topic', 'evt_topic',
+
+    'TOPIC_ALLOCATOR',
+    'get_internal_topic',
+    'get_internal_map',
+
+    'evt_py_payload', 'evt_message_payload', 'MessagePayload',
+    'c_evt_payload_new',
+    'c_evt_payload_free',
+
+    'evt_callback_bare',
+    'evt_callback_with_args',
+    'evt_callback_with_topic',
+    'evt_callback_with_userdata',
+    'evt_callback_with_args_topic',
+    'evt_callback_with_args_userdata',
+    'evt_callback_with_topic_userdata',
+    'evt_callback_with_args_topic_userdata',
+    'evt_callback_with_payload',
+    'evt_callback_with_payload_userdata',
+
+    'evt_callback_type',
+    'evt_callback_variants',
+    'evt_callback',
+    'evt_py_callable',
+
+    'evt_hook_watcher_type',
+    'evt_hook_watcher_fn',
+    'evt_hook_watcher',
+    'evt_hook_stats', 'c_hook_enter', 'c_hook_exit',
+
+    'evt_hook', 'EventHook', 'EventHookEx',
+
+    'c_evt_callback_invoke',
+    'c_evt_hook_new',
+    'c_evt_hook_free',
+    'c_evt_hook_add_watcher',
+    'c_evt_hook_register_callback',
+    'c_evt_hook_pop_callback',
+    'c_evt_hook_invoke',
+    'evt_hook_ret_code',
+
+    'EMPTY_ARGS', 'TOPIC_FIELD_NAME',
+
+    'DEFAULT_MQ_CAPACITY',
+    'DEFAULT_MQ_SPIN_LIMIT',
+    'DEFAULT_MQ_TIMEOUT_SECONDS',
+    'message_queue',
+
+    'c_mq_new',
+    'c_mq_free',
+    'c_mq_put',
+    'c_mq_get',
+    'c_mq_put_await',
+    'c_mq_get_await',
+    'c_mq_put_busy',
+    'c_mq_get_busy',
+    'c_mq_put_hybrid',
+    'c_mq_get_hybrid',
+    'c_mq_occupied',
+
+    'EventEngine', 'EventEngineEx'
+]

event_engine/capi/__init__.py

@@ -0,0 +1,84 @@
+import logging
+
+LOGGER = None
+
+
+from .c_topic import (
+    TopicType,
+    TopicPart, TopicPartExact, TopicPartAny, TopicPartRange, TopicPartPattern,
+    TopicMatchResult, Topic,
+    get_internal_topic, get_internal_map
+)
+
+from .c_event import MessagePayload, EventHook, EventHookEx
+
+# Try to import the Cython implementation first, fall back to pure Python if unavailable
+USING_FALLBACK = False
+
+try:
+    assert not USING_FALLBACK
+    from .c_engine import Full, Empty, EventEngine, EventEngineEx
+
+    USING_FALLBACK = False
+except (ImportError, AssertionError) as e:
+    # Cython module not available (e.g., on Windows or not compiled)
+    # Use the pure Python fallback implementation
+    import warnings
+
+    warnings.warn(
+        f"Cython c_engine module not available ({e}), using pure Python fallback implementation. "
+        "Performance may be reduced compared to the Cython version.",
+        ImportWarning,
+        stacklevel=2
+    )
+    from .fallback_engine import Full, Empty, EventEngine, EventEngineEx
+
+    USING_FALLBACK = True
+
+
+def set_logger(logger: logging.Logger):
+    global LOGGER
+    from . import c_topic, c_event, c_engine
+    c_topic.LOGGER = logger
+    c_event.LOGGER = logger
+    c_engine.LOGGER = logger
+    LOGGER = logger
+
+    """Set the root EventEngine logger and propagate to submodules.
+
+    This updates event_engine.base.LOGGER and the module-level LOGGER used by
+    c_event/fallback_engine (if available) so subsequent logs use the provided logger.
+    """
+    import importlib
+    base_mod = importlib.import_module('event_engine.base')
+    base_mod.LOGGER = logger
+    # Try to update c_event module logger
+    try:
+        from . import c_event as _c_event
+        _c_event.LOGGER = logger.getChild('Event')
+    except Exception:
+        pass
+
+    # Try to update c_engine module logger
+    try:
+        from . import c_engine as _c_engine
+        _c_engine.LOGGER = logger.getChild('Engine')
+    except Exception:
+        pass
+
+    # If capi is using fallback engine internally, update its module logger as well
+    try:
+        from . import fallback_engine as _c_engine_fallback
+        _c_engine_fallback.LOGGER = logger.getChild('Engine')
+    except Exception:
+        pass
+
+
+__all__ = [
+    'TopicType', 'TopicPart', 'TopicPartExact', 'TopicPartAny', 'TopicPartRange', 'TopicPartPattern',
+    'TopicMatchResult', 'Topic',
+    'get_internal_topic', 'get_internal_map',
+    'MessagePayload', 'EventHook', 'EventHookEx',
+    'Full', 'Empty', 'EventEngine', 'EventEngineEx', 'USING_FALLBACK',
+    'set_logger'
+]