PyEventEngine 0.6.0.post3__cp314-cp314t-win_amd64.whl

pyeventengine-0.6.0.post3.dist-info/METADATA

@@ -0,0 +1,189 @@
+Metadata-Version: 2.4
+Name: PyEventEngine
+Version: 0.6.0.post3
+Summary: Python Basic EventEngine
+Author-email: Han Bolun <Bolun.Han@outlook.com>
+Project-URL: Homepage, https://github.com/BolunHan/PyEventEngine
+Project-URL: Repository, https://github.com/BolunHan/PyEventEngine
+Project-URL: Issues, https://github.com/BolunHan/PyEventEngine/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# PyEventEngine
+
+[![docs](https://github.com/BolunHan/PyEventEngine/actions/workflows/build-page-docs.yml/badge.svg)](https://github.com/BolunHan/PyEventEngine/actions/workflows/build-page-docs.yml)
+[![pypi-linux](https://github.com/BolunHan/PyEventEngine/actions/workflows/publish-posix-to-pypi.yml/badge.svg)](https://github.com/BolunHan/PyEventEngine/actions/workflows/publish-posix-to-pypi.yml)
+[![pypi-windows](https://github.com/BolunHan/PyEventEngine/actions/workflows/publish-nt-to-pypi.yml/badge.svg)](https://github.com/BolunHan/PyEventEngine/actions/workflows/publish-nt-to-pypi.yml)
+
+High-performance, topic-driven event engine for Python with a Cython-accelerated core and a native Python fallback.
+
+- Fast publish/subscribe event routing by topic (exact + generic wildcard/pattern matching)
+- Clean, typed API with drop-in fallback when C extensions are unavailable
+- Built-in timers, handler stats (EventHookEx), and convenient formatting helpers
+
+## Installation
+
+```bash
+# From PyPI (pre-compiled wheels available)
+pip install PyEventEngine
+
+# From source (requires C compiler + Cython ≥ 3.0)
+git clone https://github.com/BolunHan/PyEventEngine.git
+cd PyEventEngine
+
+# Build + install
+./build.sh -i
+
+# Or via Makefile:
+make build && pip install -U . --no-build-isolation
+
+# Or step by step:
+python setup.py build_ext --inplace --verbose --force
+pip install -U . --no-build-isolation
+```
+
+See the [Installation Guide](https://bolunhan.github.io/PyEventEngine/installation.html) for platform-specific prerequisites, compile-time macros, and troubleshooting.
+
+## Quick Start
+
+```python
+import time
+from event_engine import EventEngine, Topic
+
+# Create and start the engine
+engine = EventEngine(capacity=8192)
+engine.start()
+
+# Register a handler for an exact topic
+exact = Topic('Demo.Hello')
+
+def hello_handler(name: str, topic=None):
+    print(f"Hello {name} from {topic.value if topic else 'N/A'}")
+
+engine.register_handler(exact, hello_handler)
+
+# Publish a message
+engine.put(exact, 'World')
+
+# Clean up
+time.sleep(0.1)
+engine.stop()
+engine.clear()
+```
+
+### Generic topics (wildcards/patterns)
+
+```python
+import time
+from event_engine import Topic, EventEngine
+
+engine = EventEngine()
+pattern = Topic('Demo.{what}')
+
+calls = []
+
+def f(what: str, topic=None):
+    calls.append((what, topic.value))
+
+engine.register_handler(pattern, f)
+
+engine.start()
+engine.put(Topic('Demo.Test'), 'a test sub-topic')
+engine.put(Topic('Demo.Live'), 'a live sub-topic')
+time.sleep(0.1)  # allow time for processing
+engine.stop()
+
+print(calls)  # [('a test sub-topic', 'Demo.Test'), ('a live sub-topic', 'Demo.Live')]
+```
+
+### Timers (EventEngineEx)
+
+```python
+import time
+from event_engine import EventEngineEx, Topic
+
+engine = EventEngineEx(capacity=4096)
+engine.start()
+
+# Create a 1-second timer topic and subscribe
+timer_topic = engine.get_timer(1.0)
+engine.register_handler(timer_topic, lambda **kw: print('tick', kw))
+
+time.sleep(3)
+engine.stop()
+engine.clear()
+```
+
+### Logging
+
+By default, the package uses a colored logger under `event_engine.base`. To integrate with your
+application's logging, call `set_logger` once after import — it propagates to submodules.
+
+```python
+import logging
+from event_engine import set_logger
+
+logger = logging.getLogger('MyApp')
+logger.setLevel(logging.INFO)
+set_logger(logger)
+```
+
+### Fallback behavior
+
+On import, the package tries to use the Cython implementation (`event_engine.capi`). If that fails
+(e.g., no compiler available), it automatically falls back to the native Python implementation
+(`event_engine.native`). Check the active backend:
+
+```python
+from event_engine import USING_FALLBACK
+print('Using native fallback?', USING_FALLBACK)
+```
+
+## Development
+
+```bash
+# Clone and build in-place
+git clone https://github.com/BolunHan/PyEventEngine.git
+cd PyEventEngine
+./build.sh -i
+
+# Run tests
+python -m pytest demo/
+
+# Performance benchmarks
+python demo/native_performance_test.py
+python demo/capi_performance_test.py       # requires compiled extensions
+```
+
+### Build scripts
+
+| Command | Effect |
+|---|---|
+| `./build.sh -i` | Clean + build + install |
+| `./build.sh -l` | List compile-time macros |
+| `make build` | Clean + build in-place |
+| `make clean-all` | Deep clean (removes `.c`/`.so`) |
+
+## Documentation
+
+Full documentation: **https://bolunhan.github.io/PyEventEngine/**
+
+Build locally:
+
+```bash
+pip install sphinx furo sphinx-autodoc-typehints
+cd docs
+sphinx-build -M html . _build
+# Open _build/html/index.html
+```
+
+## License
+
+MIT — see [LICENSE](LICENSE).

pyeventengine-0.6.0.post3.dist-info/RECORD

@@ -0,0 +1,52 @@
+event_engine/__infra__.pxd,sha256=mkSbWvhdjeO2QB9DK60VxK8IKoMjxIX42XCPy7ZHyLM,44
+event_engine/__init__.pxd,sha256=mkSbWvhdjeO2QB9DK60VxK8IKoMjxIX42XCPy7ZHyLM,44
+event_engine/__init__.py,sha256=hZKxHrA9fBg8Tl2EBFKE-u-JVrNdTY9fdRpwnRdgE7c,945
+event_engine/base/__infra__.pxd,sha256=1oNFIPAoOiMw3kNVcRR0vvbMSfsc-baH9vGTO-awut4,304
+event_engine/base/__init__.pxd,sha256=1oNFIPAoOiMw3kNVcRR0vvbMSfsc-baH9vGTO-awut4,304
+event_engine/base/__init__.py,sha256=inHjf2pLIXNIcJzoyviHS-yY001b8zKMtjyaVpNPNl8,2785
+event_engine/base/c_allocator_protocol.c,sha256=3iAEsog5ks7leI4UGtQQ5GcDvcMpPFyB3jsRTogp_54,473067
+event_engine/base/c_allocator_protocol.cp314t-win_amd64.pyd,sha256=Yz5moNDJ2l7UtChl90I8JlzRTMImQDQTVujdUlQw5-M,54272
+event_engine/base/c_allocator_protocol.h,sha256=6iYXcv6eBOrt-sVuaRPqOkpBmttp_wgxsyxeL9DXeOw,691
+event_engine/base/c_allocator_protocol.pxd,sha256=ZuWU_xplWqRzMYnzZjeTaJFARM7x8veQLcu5v9NrlFw,896
+event_engine/base/c_allocator_protocol.pyx,sha256=ADyuqpMiulJyQ-XaXWK5JNYWlSOLguo3LCw-6xIIMqY,3924
+event_engine/capi/__infra__.pxd,sha256=CyqVdnondUr_u1zrObZEDC70XhECp5lhJh8b69Fu5rM,4618
+event_engine/capi/__init__.pxd,sha256=CyqVdnondUr_u1zrObZEDC70XhECp5lhJh8b69Fu5rM,4618
+event_engine/capi/__init__.py,sha256=89snKU4TlUOqpLfjOzcABxBCeU0lBCQpYZ9DTF9n2Lw,2643
+event_engine/capi/c_engine.c,sha256=cze38juojiBlvS2fGpSATXoDFFW9RrNitqkORpQFw64,1293075
+event_engine/capi/c_engine.cp314t-win_amd64.pyd,sha256=lMLPBJcOARmwb4UVwdNoXFB0U4o_VzA-JvcZujYdPVU,188928
+event_engine/capi/c_engine.h,sha256=UkqXF0qi9gL-DgdkCzr2wP6_1Omi488LnwhPu6-l09E,13904
+event_engine/capi/c_engine.pxd,sha256=Z4BEj3iNussS4zjWLJHNbB4PyT7_zpaVfmtdw8grbo4,3223
+event_engine/capi/c_engine.pyi,sha256=3JU3HD-Z4k2UA5ThQoZwAhOauX1fm4dJ0abQeFZe98s,14128
+event_engine/capi/c_engine.pyx,sha256=ArJRVYabhpvrjUQH3W_2yOt3USG2MiY7NW9sNZbz2wo,21694
+event_engine/capi/c_event.c,sha256=JLoWUUPE13sU7hyMAqueTxYUb9a-nw1EtYxRJ-v2HX8,884830
+event_engine/capi/c_event.cp314t-win_amd64.pyd,sha256=gob_IBIpKTv3BizeZOe7NIBEuG8HaLurOEDXpoZKi_M,108032
+event_engine/capi/c_event.h,sha256=eEV9K_yPWQvs1B5eJxGsTJp-2pefD9z3rlieDalRh2E,13428
+event_engine/capi/c_event.pxd,sha256=jbso3p_ztQRzFWNHefNPGIm1SAz44UKl2JEgJwI1QPg,5992
+event_engine/capi/c_event.pyi,sha256=3raoTHbPP3Y7tQwkOCmYB9KU_uD8kgQTJIwLtfGq-zc,6139
+event_engine/capi/c_event.pyx,sha256=9LpJ9ZxVtvOi_hiTGIOGCI_QZjuYlNTzPWCNPwaoAXg,14848
+event_engine/capi/c_topic.c,sha256=n4O2QhSFQ3RIGS9_yz3KihSDuLy_Vf7uN2olLXtA2Cg,1380594
+event_engine/capi/c_topic.cp314t-win_amd64.pyd,sha256=mJ9Hb1ZSuXKo9LSyHbwXtH5cDOZAio6v6xcRQqyX-Iw,197632
+event_engine/capi/c_topic.h,sha256=iPrpEWaXifbE2jhtL1vA4xIs5b1eZ3Xlt_mZ4pNi9OM,35077
+event_engine/capi/c_topic.pxd,sha256=uLn4PTEXFOEBXE5wWq2ya4fS9Xl1oANV4q5ZO_dSL8A,4277
+event_engine/capi/c_topic.pyi,sha256=ygFi7IP7vdw2NwbF8v8K-TVM_d8M1YBzfp0RXFeWsU4,20624
+event_engine/capi/c_topic.pyx,sha256=VOTw7XDWG_kHRddzGmeXPJMThlPSXFNTgdbkoCkib04,26855
+event_engine/capi/fallback_engine.py,sha256=NXLTFBUOdN3IS3uhs3n3n5b_7UuLOl29ek0OWiEG7tU,22236
+event_engine/includes/event_engine/base/c_allocator_protocol.c,sha256=3iAEsog5ks7leI4UGtQQ5GcDvcMpPFyB3jsRTogp_54,473067
+event_engine/includes/event_engine/base/c_allocator_protocol.h,sha256=6iYXcv6eBOrt-sVuaRPqOkpBmttp_wgxsyxeL9DXeOw,691
+event_engine/includes/event_engine/capi/c_engine.c,sha256=cze38juojiBlvS2fGpSATXoDFFW9RrNitqkORpQFw64,1293075
+event_engine/includes/event_engine/capi/c_engine.h,sha256=UkqXF0qi9gL-DgdkCzr2wP6_1Omi488LnwhPu6-l09E,13904
+event_engine/includes/event_engine/capi/c_event.c,sha256=JLoWUUPE13sU7hyMAqueTxYUb9a-nw1EtYxRJ-v2HX8,884830
+event_engine/includes/event_engine/capi/c_event.h,sha256=eEV9K_yPWQvs1B5eJxGsTJp-2pefD9z3rlieDalRh2E,13428
+event_engine/includes/event_engine/capi/c_topic.c,sha256=n4O2QhSFQ3RIGS9_yz3KihSDuLy_Vf7uN2olLXtA2Cg,1380594
+event_engine/includes/event_engine/capi/c_topic.h,sha256=iPrpEWaXifbE2jhtL1vA4xIs5b1eZ3Xlt_mZ4pNi9OM,35077
+event_engine/native/__init__.py,sha256=bbbBlekcobSXwToov7Uk71ns9ziGrj1Aw_nO3FjZ844,1932
+event_engine/native/_event.py,sha256=VS6JRK8pLR6neFzboivTh0N-BEblM0-0TFioW8UAvyg,15224
+event_engine/native/_topic.py,sha256=HReVjvnHBoxVPemEpoDL_TzFtMoI_aHYtI836epWZ2w,5355
+event_engine/native/engine.py,sha256=7H_oM_CEp-XuLnPqbS1fMIr-37VX6hXTHbHxMUFsBYw,25661
+event_engine/native/event.py,sha256=15aCQoJ6388J4gbNCwh6GChbbPeA9AIOgfUIQloJuxg,16358
+event_engine/native/topic.py,sha256=T0dVOo4JUT91Vu_bJFhlMZDx46lspSwAplGApQ0jzuc,35352
+pyeventengine-0.6.0.post3.dist-info/licenses/LICENSE,sha256=BvUA2EP_6vsOvstZaraqnwzshM9CeDAqXSZEa5WxdEg,1087
+pyeventengine-0.6.0.post3.dist-info/METADATA,sha256=rDg_cSap2NvrsDTSz9EBGjMPjOpGFjbN4y4AwGUlzhc,5429
+pyeventengine-0.6.0.post3.dist-info/WHEEL,sha256=1E0gszQps7BnHucFFSWKxP1l1R1l3Xb3HouMURv4ztU,102
+pyeventengine-0.6.0.post3.dist-info/top_level.txt,sha256=rIh2LcDfofRLIIqMSlulp5yAXTf1DNOmlofiyIHuylQ,13
+pyeventengine-0.6.0.post3.dist-info/RECORD,,

pyeventengine-0.6.0.post3.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (83.0.0)
+Root-Is-Purelib: false
+Tag: cp314-cp314t-win_amd64
+

pyeventengine-0.6.0.post3.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 Bolun Han
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pyeventengine-0.6.0.post3.dist-info/top_level.txt

@@ -0,0 +1 @@
+event_engine