infinity_bus 1.3.1__tar.gz

infinity_bus-1.3.1/LICENSE.md

@@ -0,0 +1,9 @@
+# The MIT License (MIT)
+
+Copyright © 2026 YinBailiang
+
+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.

infinity_bus-1.3.1/PKG-INFO

@@ -0,0 +1,160 @@
+Metadata-Version: 2.4
+Name: infinity_bus
+Version: 1.3.1
+Summary: 基于 asyncio 的轻量级事件总线，支持发布/订阅、正则匹配、背压控制与优雅停机
+Author: EventBus Authors
+License: MIT
+Project-URL: Repository, https://github.com/yinbailiang/event_bus
+Keywords: event-bus,async,asyncio,pub-sub,publish-subscribe,event-driven
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Framework :: AsyncIO
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE.md
+Requires-Dist: aiosqlite
+Requires-Dist: pydantic
+Provides-Extra: test
+Requires-Dist: pytest; extra == "test"
+Requires-Dist: pytest-cov; extra == "test"
+Requires-Dist: pytest-asyncio; extra == "test"
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: pytest-asyncio; extra == "dev"
+Dynamic: license-file
+
+# InfinityBus — 异步事件总线
+
+[![Test](https://github.com/yinbailiang/event_bus/actions/workflows/test.yml/badge.svg)](https://github.com/yinbailiang/event_bus/actions/workflows/test.yml)
+[![Python](https://img.shields.io/badge/python-3.12%2B-blue)](https://www.python.org/)
+[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE.md)
+
+基于 **asyncio** 的轻量级事件总线，实现发布/订阅模式，用于在异步应用中解耦组件间的通信。
+
+## ✨ 特性
+
+- **强类型负载校验** — 基于 Pydantic，发布时自动校验数据类型与结构
+- **正则表达式订阅** — 支持灵活的事件名匹配规则
+- **背压控制** — 队列大小与并发信号量双重限流，防止过载
+- **超时保护** — 每个处理器可独立设置超时，避免单任务阻塞总线
+- **错误隔离** — 单个处理器异常不影响其他处理器，错误通过内置事件统一上报
+- **优雅停机** — 保证停止过程中已入队事件被完整处理，避免数据丢失
+- **可观测性** — 提供活跃任务数、队列长度等监控指标
+
+## 📦 安装
+
+```bash
+pip install git+https://github.com/yinbailiang/infinity_bus.git
+```
+
+或从源码安装：
+
+```bash
+git clone https://github.com/yinbailiang/infinity_bus.git
+cd event_bus
+pip install -e ".[test]"
+```
+
+## 🚀 快速开始
+
+### 基础发布/订阅
+
+```python
+import asyncio
+from pydantic import BaseModel
+from event_bus import (
+    EventBus, EventDeclaration, EventHandler,
+    EventRegistry, EventHandlerRegistry,
+)
+
+# 1. 定义负载
+class MyPayload(BaseModel):
+    message: str
+
+# 2. 声明事件
+class MyEvent(EventDeclaration):
+    name = "my.event"
+    payload_type = MyPayload
+
+# 3. 实现处理器
+class MyHandler(EventHandler):
+    def __init__(self):
+        super().__init__(subscriptions=["my.event"])
+
+    async def handle(self, payload, bus_proxy, raw_event):
+        print(f"Received: {payload.message}")
+
+# 4. 组装并运行
+async def main():
+    reg = EventRegistry()
+    reg.register(MyEvent)
+    h_reg = EventHandlerRegistry()
+    h_reg.register(MyHandler())
+
+    async with EventBus(reg, h_reg) as bus:
+        await bus.proxy("cli").publish("my.event", {"message": "Hello, EventBus!"})
+        await asyncio.sleep(1)  # 等待处理器输出
+
+asyncio.run(main())
+```
+
+### 请求-响应模式
+
+```python
+from event_bus.templates.request import request, RequestProtocol, ResponseProtocol
+
+# 定义请求/响应负载与事件（详见文档）
+# ...
+
+resp = await request(
+    bus_proxy=proxy,
+    req_event="user.get.request",
+    req_data={"user_id": 123},
+    resp_event="user.get.response",
+    timeout=10.0,
+)
+resp.raise_if_failed()
+```
+
+## 🧱 架构
+
+| 组件 | 职责 |
+| - | - |
+| **Event** | 运行时事件实例，含名称、负载、处理链追踪 |
+| **EventDeclaration** | 事件类型元数据声明（名称 + 可选 Pydantic 负载模型） |
+| **EventRegistry** | 集中管理已注册的事件声明，发布时校验 |
+| **EventHandler** | 处理器基类，实现 `handle` 方法定义业务逻辑 |
+| **EventHandlerRegistry** | 管理处理器实例，按事件名匹配处理器列表 |
+| **EventBus** | 事件分发中枢：任务队列、并发控制、错误上报、生命周期 |
+
+## 📚 文档
+
+- [EventBus 核心](docs/event_bus.md)
+- [Expect 一次性监听器](docs/templates/expect.md)
+- [Request 请求-响应模板](docs/templates/request.md)
+- [Pipe 双向管道](docs/templates/pipe.md)
+- [Register 模块事件注册器](docs/templates/register.md)
+
+## 🧪 测试
+
+```bash
+# 运行全部测试
+pytest --cov=src -v
+
+# 仅运行核心测试
+pytest tests/event_bus_test.py -v
+
+# 仅运行模板测试
+pytest tests/templates/ -v
+```
+
+## 📄 许可证
+
+[MIT](LICENSE.md)

infinity_bus-1.3.1/README.md

@@ -0,0 +1,128 @@
+# InfinityBus — 异步事件总线
+
+[![Test](https://github.com/yinbailiang/event_bus/actions/workflows/test.yml/badge.svg)](https://github.com/yinbailiang/event_bus/actions/workflows/test.yml)
+[![Python](https://img.shields.io/badge/python-3.12%2B-blue)](https://www.python.org/)
+[![License](https://img.shields.io/badge/license-MIT-green)](LICENSE.md)
+
+基于 **asyncio** 的轻量级事件总线，实现发布/订阅模式，用于在异步应用中解耦组件间的通信。
+
+## ✨ 特性
+
+- **强类型负载校验** — 基于 Pydantic，发布时自动校验数据类型与结构
+- **正则表达式订阅** — 支持灵活的事件名匹配规则
+- **背压控制** — 队列大小与并发信号量双重限流，防止过载
+- **超时保护** — 每个处理器可独立设置超时，避免单任务阻塞总线
+- **错误隔离** — 单个处理器异常不影响其他处理器，错误通过内置事件统一上报
+- **优雅停机** — 保证停止过程中已入队事件被完整处理，避免数据丢失
+- **可观测性** — 提供活跃任务数、队列长度等监控指标
+
+## 📦 安装
+
+```bash
+pip install git+https://github.com/yinbailiang/infinity_bus.git
+```
+
+或从源码安装：
+
+```bash
+git clone https://github.com/yinbailiang/infinity_bus.git
+cd event_bus
+pip install -e ".[test]"
+```
+
+## 🚀 快速开始
+
+### 基础发布/订阅
+
+```python
+import asyncio
+from pydantic import BaseModel
+from event_bus import (
+    EventBus, EventDeclaration, EventHandler,
+    EventRegistry, EventHandlerRegistry,
+)
+
+# 1. 定义负载
+class MyPayload(BaseModel):
+    message: str
+
+# 2. 声明事件
+class MyEvent(EventDeclaration):
+    name = "my.event"
+    payload_type = MyPayload
+
+# 3. 实现处理器
+class MyHandler(EventHandler):
+    def __init__(self):
+        super().__init__(subscriptions=["my.event"])
+
+    async def handle(self, payload, bus_proxy, raw_event):
+        print(f"Received: {payload.message}")
+
+# 4. 组装并运行
+async def main():
+    reg = EventRegistry()
+    reg.register(MyEvent)
+    h_reg = EventHandlerRegistry()
+    h_reg.register(MyHandler())
+
+    async with EventBus(reg, h_reg) as bus:
+        await bus.proxy("cli").publish("my.event", {"message": "Hello, EventBus!"})
+        await asyncio.sleep(1)  # 等待处理器输出
+
+asyncio.run(main())
+```
+
+### 请求-响应模式
+
+```python
+from event_bus.templates.request import request, RequestProtocol, ResponseProtocol
+
+# 定义请求/响应负载与事件（详见文档）
+# ...
+
+resp = await request(
+    bus_proxy=proxy,
+    req_event="user.get.request",
+    req_data={"user_id": 123},
+    resp_event="user.get.response",
+    timeout=10.0,
+)
+resp.raise_if_failed()
+```
+
+## 🧱 架构
+
+| 组件 | 职责 |
+| - | - |
+| **Event** | 运行时事件实例，含名称、负载、处理链追踪 |
+| **EventDeclaration** | 事件类型元数据声明（名称 + 可选 Pydantic 负载模型） |
+| **EventRegistry** | 集中管理已注册的事件声明，发布时校验 |
+| **EventHandler** | 处理器基类，实现 `handle` 方法定义业务逻辑 |
+| **EventHandlerRegistry** | 管理处理器实例，按事件名匹配处理器列表 |
+| **EventBus** | 事件分发中枢：任务队列、并发控制、错误上报、生命周期 |
+
+## 📚 文档
+
+- [EventBus 核心](docs/event_bus.md)
+- [Expect 一次性监听器](docs/templates/expect.md)
+- [Request 请求-响应模板](docs/templates/request.md)
+- [Pipe 双向管道](docs/templates/pipe.md)
+- [Register 模块事件注册器](docs/templates/register.md)
+
+## 🧪 测试
+
+```bash
+# 运行全部测试
+pytest --cov=src -v
+
+# 仅运行核心测试
+pytest tests/event_bus_test.py -v
+
+# 仅运行模板测试
+pytest tests/templates/ -v
+```
+
+## 📄 许可证
+
+[MIT](LICENSE.md)

infinity_bus-1.3.1/pyproject.toml

@@ -0,0 +1,69 @@
+[project]
+name = "infinity_bus"
+version = "1.3.1"
+description = "基于 asyncio 的轻量级事件总线，支持发布/订阅、正则匹配、背压控制与优雅停机"
+readme = "README.md"
+license = { text = "MIT" }
+authors = [
+    { name = "EventBus Authors" }
+]
+keywords = [
+    "event-bus",
+    "async",
+    "asyncio",
+    "pub-sub",
+    "publish-subscribe",
+    "event-driven",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Framework :: AsyncIO",
+]
+requires-python = ">=3.12"
+
+dependencies = [
+    # log
+    "aiosqlite",
+
+    # data
+    "pydantic",
+]
+
+[project.urls]
+Repository = "https://github.com/yinbailiang/event_bus"
+
+[project.optional-dependencies]
+test = [
+    "pytest",
+    "pytest-cov",
+    "pytest-asyncio",
+]
+dev = [
+    "pytest",
+    "pytest-cov",
+    "pytest-asyncio",
+]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+addopts = "-m 'not slow'"
+markers = [
+    "slow: long-running stress / stability tests",
+]
+
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]

infinity_bus-1.3.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

infinity_bus-1.3.1/src/event_bus/__init__.py

@@ -0,0 +1,45 @@
+"""event_bus - 基于 asyncio 的轻量级事件总线"""
+
+__version__ = "1.3.0"
+
+from .event import (
+    Event,
+    EventDeclaration,
+    EventRegistry,
+)
+
+from .handler import (
+    EventHandler,
+    EventHandlerRegistry,
+)
+
+from .middleware import (
+    Middleware,
+    MiddlewareChain,
+)
+
+from .bus import (
+    EventBus,
+    BusShuttingDown,
+    ShutdownEvent,
+    TaskErrorPayload,
+    TaskErrorEvent,
+    ShutdownConfig,
+)
+
+__all__: list[str] = [
+    "__version__",
+    "Event",
+    "EventDeclaration",
+    "EventRegistry",
+    "EventHandler",
+    "EventHandlerRegistry",
+    "Middleware",
+    "MiddlewareChain",
+    "EventBus",
+    "BusShuttingDown",
+    "ShutdownEvent",
+    "TaskErrorPayload",
+    "TaskErrorEvent",
+    "ShutdownConfig",
+]