PyEventEngine 0.6.2__cp315-cp315t-win_amd64.whl

event_engine/__infra__.pxd

@@ -0,0 +1,2 @@
+from .base cimport *
+from .capi cimport *

event_engine/__init__.pxd

@@ -0,0 +1,2 @@
+from .base cimport *
+from .capi cimport *

event_engine/__init__.py

@@ -0,0 +1,62 @@
+__version__ = '0.6.2'
+
+import functools
+import pathlib
+from collections.abc import Mapping
+
+from .config_view import CONFIG_VIEW
+from .base import LOGGER
+
+try:
+    from .capi import *  # noqa: F401,F403
+except Exception as e:
+    import warnings
+
+    warnings.warn(
+        f"Failed to import event_engine.capi ({e!r}); falling back to event_engine.native.",
+        ImportWarning,
+        stacklevel=2,
+    )
+    from .native import *  # noqa: F401,F403
+
+
+def _format_config_view(config: Mapping, indent: int = 0) -> str:
+    """Render a (possibly nested) config view as indented bullet lines."""
+    lines = []
+    for key, value in config.items():
+        if isinstance(value, Mapping):
+            lines.append(f"{'  ' * indent}- {key}:")
+            lines.append(_format_config_view(value, indent + 1))
+        else:
+            lines.append(f"{'  ' * indent}- {key}: {value}")
+    return "\n".join(lines)
+
+
+@functools.cache
+def get_include() -> list[str]:
+    import os
+
+    res_dir = pathlib.Path(__file__).parent
+    LOGGER.info(
+        f'Building with <PyEventEngine> version: "{__version__}", resource directory: "{res_dir}", '
+        f"config:\n{_format_config_view(CONFIG_VIEW)}"
+    )
+
+    scr_dir = [
+        os.path.realpath(res_dir),
+        os.path.realpath(res_dir / 'base'),
+        os.path.realpath(res_dir / 'capi'),
+    ]
+
+    include_root = os.path.realpath(res_dir / 'includes')
+    if os.path.isdir(include_root):
+        scr_dir.append(include_root)
+
+    return scr_dir
+
+
+__all__ = [
+    'CONFIG_VIEW',
+    'get_include',
+    'LOGGER',
+]

event_engine/base/__infra__.pxd

@@ -0,0 +1,9 @@
+from .c_allocator_protocol cimport (
+    EE_LOCAL_ONLY,
+
+    EE_CFG_LOCKED, EE_CFG_SHARED, EE_CFG_FREELIST,
+    EEConfigContext,
+    EE_HEAP_ALLOCATOR_RAW, EE_SHM_ALLOCATOR_RAW,
+    EE_DEFAULT_ALLOCATOR, EE_SHM_ALLOCATOR, EE_HEAP_ALLOCATOR,
+    EE_SHARED, EE_LOCKED, EE_LOCKFREE, EE_FREELIST,
+)

event_engine/base/__init__.pxd

@@ -0,0 +1,9 @@
+from .c_allocator_protocol cimport (
+    EE_LOCAL_ONLY,
+
+    EE_CFG_LOCKED, EE_CFG_SHARED, EE_CFG_FREELIST,
+    EEConfigContext,
+    EE_HEAP_ALLOCATOR_RAW, EE_SHM_ALLOCATOR_RAW,
+    EE_DEFAULT_ALLOCATOR, EE_SHM_ALLOCATOR, EE_HEAP_ALLOCATOR,
+    EE_SHARED, EE_LOCKED, EE_LOCKFREE, EE_FREELIST,
+)

event_engine/base/__init__.py

@@ -0,0 +1,31 @@
+import logging
+
+from cbase.backports.telemetrics import (
+    ColoredFormatter,
+    DuplicateWarningFilter,
+    LOG_LEVEL,
+    get_logger as _get_logger,
+)
+
+LOG_LEVEL_EVENT = LOG_LEVEL - 5
+
+
+def get_logger(**kwargs) -> logging.Logger:
+    """Return the process-wide singleton EventEngine logger.
+
+    First call configures the logger via PyCyBase's telemetrics; subsequent
+    calls return the same cached instance.
+    """
+    return _get_logger(name='EventEngine', level=kwargs.get('level', LOG_LEVEL), **kwargs)
+
+
+LOGGER = get_logger()
+
+__all__ = [
+    'ColoredFormatter',
+    'DuplicateWarningFilter',
+    'LOG_LEVEL',
+    'LOG_LEVEL_EVENT',
+    'LOGGER',
+    'get_logger',
+]