PyEventEngine 0.6.2__cp315-cp315t-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,193 @@
+from libc.stdlib cimport calloc
+from libcpp cimport bool as c_bool
+
+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
+
+
+# -- Runtime config accessor (reads live cdef globals) --------------------
+class _RuntimeAllocatorConfig:
+    """Property-based accessor for live EE_CFG_* globals.
+
+    Unlike the compile-time CONFIG_VIEW mappingproxy, these properties read
+    the CURRENT value, which may change when an EEConfigContext is active.
+    """
+    @property
+    def EE_CFG_LOCKED(self):
+        return EE_CFG_LOCKED
+
+    @property
+    def EE_CFG_SHARED(self):
+        return EE_CFG_SHARED
+
+    @property
+    def EE_CFG_FREELIST(self):
+        return EE_CFG_FREELIST
+
+
+RUNTIME_ALLOCATOR_CONFIG = _RuntimeAllocatorConfig()
+
+
+cdef class AllocatorTestToolkit:
+    """Relays internal allocator-protocol state to Python for test validation.
+
+    Exposes the live ``EE_CFG_*`` globals, the allocator protocol struct
+    configurations (lock/shm/freelist flags and backing allocator presence),
+    and the ``EEConfigContext`` activation path — all of which are internal
+    C state that the public Python API does not otherwise expose.
+
+    Note:
+        Test-only class. Not declared in any ``.pxd``; not part of the
+        public package API.
+    """
+
+    @staticmethod
+    def get_cfg_locked() -> c_bool:
+        """Live value of the EE_CFG_LOCKED global."""
+        return EE_CFG_LOCKED
+
+    @staticmethod
+    def get_cfg_shared() -> c_bool:
+        """Live value of the EE_CFG_SHARED global."""
+        return EE_CFG_SHARED
+
+    @staticmethod
+    def get_cfg_freelist() -> c_bool:
+        """Live value of the EE_CFG_FREELIST global."""
+        return EE_CFG_FREELIST
+
+    @staticmethod
+    def get_default_allocator_config() -> dict:
+        """Flag/backing configuration of the EE_DEFAULT_ALLOCATOR protocol."""
+        if EE_DEFAULT_ALLOCATOR == NULL:
+            return None
+        return {
+            'with_lock': EE_DEFAULT_ALLOCATOR.with_lock,
+            'with_shm': EE_DEFAULT_ALLOCATOR.with_shm,
+            'with_freelist': EE_DEFAULT_ALLOCATOR.with_freelist,
+            'has_heap': EE_DEFAULT_ALLOCATOR.heap_allocator != NULL,
+            'has_shm': EE_DEFAULT_ALLOCATOR.shm_allocator != NULL,
+        }
+
+    @staticmethod
+    def get_heap_allocator_config() -> dict:
+        """Flag/backing configuration of the EE_HEAP_ALLOCATOR protocol."""
+        if EE_HEAP_ALLOCATOR == NULL:
+            return None
+        return {
+            'with_lock': EE_HEAP_ALLOCATOR.with_lock,
+            'with_shm': EE_HEAP_ALLOCATOR.with_shm,
+            'with_freelist': EE_HEAP_ALLOCATOR.with_freelist,
+            'has_heap': EE_HEAP_ALLOCATOR.heap_allocator != NULL,
+            'has_shm': EE_HEAP_ALLOCATOR.shm_allocator != NULL,
+        }
+
+    @staticmethod
+    def is_shm_available() -> bint:
+        """Whether the shared-memory allocator protocol is configured."""
+        return EE_SHM_ALLOCATOR != NULL
+
+    @staticmethod
+    def activate_context(EEConfigContext ctx) -> None:
+        """Activate an EEConfigContext (relay of the cdef c_activate)."""
+        ctx.c_activate()
+
+    @staticmethod
+    def deactivate_context(EEConfigContext ctx) -> None:
+        """Deactivate an EEConfigContext (relay of the cdef c_deactivate)."""
+        ctx.c_deactivate()

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'
+]