aury-boot 0.0.31__tar.gz → 0.0.33__tar.gz

{aury_boot-0.0.31 → aury_boot-0.0.33}/PKG-INFO

@@ -1,11 +1,12 @@
 Metadata-Version: 2.4
 Name: aury-boot
-Version: 0.0.31
+Version: 0.0.33
 Summary: Aury Boot - 基于 FastAPI 生态的企业级 API 开发框架
 Requires-Python: >=3.13
 Requires-Dist: alembic>=1.17.2
 Requires-Dist: aury-sdk-storage[aws]>=0.0.6
 Requires-Dist: babel>=2.17.0
+Requires-Dist: broadcaster[redis]>=0.3.1
 Requires-Dist: faker>=38.2.0
 Requires-Dist: fastapi>=0.122.0
 Requires-Dist: greenlet>=3.2.4
@@ -30,6 +31,8 @@ Requires-Dist: aury-sdk-storage[aws]>=0.0.1; extra == 'all'
 Requires-Dist: dramatiq>=1.18.0; extra == 'all'
 Requires-Dist: pika>=1.3.2; extra == 'all'
 Requires-Dist: redis>=7.1.0; extra == 'all'
+Provides-Extra: broadcaster
+Requires-Dist: broadcaster[redis]>=0.3.1; extra == 'broadcaster'
 Provides-Extra: dev
 Requires-Dist: mypy>=1.19.0; extra == 'dev'
 Requires-Dist: pytest-asyncio>=1.3.0; extra == 'dev'

{aury_boot-0.0.31 → aury_boot-0.0.33}/aury/boot/_version.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '0.0.31'
-__version_tuple__ = version_tuple = (0, 0, 31)
+__version__ = version = '0.0.33'
+__version_tuple__ = version_tuple = (0, 0, 33)
 
 __commit_id__ = commit_id = None

{aury_boot-0.0.31 → aury_boot-0.0.33}/aury/boot/infrastructure/monitoring/alerting/__init__.py

@@ -27,7 +27,7 @@
 
 from .aggregator import AlertAggregator
 from .events import AlertEvent, AlertEventType, AlertNotification, AlertSeverity
-from .manager import AlertManager, emit_alert
+from .manager import AlertManager, emit_alert, emit_exception_alert
 from .notifiers import AlertNotifier, FeishuNotifier, WebhookNotifier
 from .rules import AlertRule, load_rules_from_dict
 
@@ -46,5 +46,6 @@ __all__ = [
     "WebhookNotifier",
     # 便捷函数
     "emit_alert",
+    "emit_exception_alert",
     "load_rules_from_dict",
 ]

{aury_boot-0.0.31 → aury_boot-0.0.33}/aury/boot/infrastructure/monitoring/alerting/manager.py

@@ -424,7 +424,61 @@ def _detect_source() -> str:
     return "unknown"
 
 
+async def emit_exception_alert(
+    exc: Exception,
+    message: str | None = None,
+    *,
+    severity: AlertSeverity = AlertSeverity.ERROR,
+    source: str | None = None,
+    **metadata: Any,
+) -> None:
+    """发送异常告警的便捷函数（带完整堆栈）。
+    
+    用于在 try/except 中捕获异常后手动发送告警。
+    框架只会自动告警未被捕获的异常，被 catch 的异常需要手动调用此函数。
+    
+    Args:
+        exc: 异常对象
+        message: 告警消息（默认使用异常信息）
+        severity: 严重级别（默认 ERROR）
+        source: 来源（可选，自动检测）
+        **metadata: 额外元数据（如 session_id, user_id 等）
+        
+    Example:
+        try:
+            await some_operation()
+        except Exception as e:
+            await emit_exception_alert(
+                e, 
+                source="task_stream",
+                session_id=session_id,
+            )
+            # 继续处理...
+    """
+    import traceback
+    
+    exc_type = type(exc).__name__
+    exc_msg = str(exc)
+    tb = traceback.format_exc()
+    
+    alert_message = message or f"{exc_type}: {exc_msg}"
+    
+    # 合并异常信息到 metadata
+    metadata["error_type"] = exc_type
+    metadata["error_message"] = exc_msg
+    metadata["stacktrace"] = tb
+    
+    await emit_alert(
+        AlertEventType.EXCEPTION,
+        alert_message,
+        severity=severity,
+        source=source,
+        **metadata,
+    )
+
+
 __all__ = [
     "AlertManager",
     "emit_alert",
+    "emit_exception_alert",
 ]

{aury_boot-0.0.31 → aury_boot-0.0.33}/pyproject.toml

@@ -20,6 +20,7 @@ dependencies = [
     "babel>=2.17.0",
     "faker>=38.2.0",
     "aury-sdk-storage[aws]>=0.0.6",
+    "broadcaster[redis]>=0.3.1",
 ]
 
 [project.optional-dependencies]
@@ -47,6 +48,9 @@ sqlite = ["aiosqlite>=0.21.0"]
 # ============ 缓存 ============
 redis = ["redis>=7.1.0"]
 
+# ============ 实时通信 (Pub/Sub) ============
+broadcaster = ["broadcaster[redis]>=0.3.1"]
+
 # ============ 对象存储 ============
 s3 = ["aury-sdk-storage[aws]>=0.0.1"]