aury-boot 0.0.25__py3-none-any.whl → 0.0.27__py3-none-any.whl

aury/boot/_version.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '0.0.25'
-__version_tuple__ = version_tuple = (0, 0, 25)
+__version__ = version = '0.0.27'
+__version_tuple__ = version_tuple = (0, 0, 27)
 
 __commit_id__ = commit_id = None

aury/boot/application/config/settings.py

@@ -246,6 +246,27 @@ class CacheSettings(BaseModel):
     )
 
 
+class ChannelSettings(BaseModel):
+    """流式通道配置（单实例）。
+    
+    环境变量格式: CHANNEL__{FIELD}
+    示例: CHANNEL__BACKEND, CHANNEL__URL
+    
+    支持的后端类型：
+    - memory: 内存后端（默认，单进程）
+    - redis: Redis Pub/Sub（多进程/分布式）
+    """
+    
+    backend: str = Field(
+        default="",
+        description="通道后端 (memory/redis)，空字符串表示不启用"
+    )
+    url: str | None = Field(
+        default=None,
+        description="Redis URL（当 backend=redis 时需要）"
+    )
+
+
 class StorageSettings(BaseModel):
     """对象存储组件接入配置（Application 层）。
 
@@ -779,6 +800,7 @@ class BaseConfig(BaseSettings):
     # ========== 数据与缓存 ==========
     database: DatabaseSettings = Field(default_factory=DatabaseSettings)
     cache: CacheSettings = Field(default_factory=CacheSettings)
+    channel: ChannelSettings = Field(default_factory=ChannelSettings)
     storage: StorageSettings = Field(default_factory=StorageSettings)
     
     # 迁移配置
@@ -879,10 +901,18 @@ class BaseConfig(BaseSettings):
         """获取所有通道实例配置。
         
         从环境变量解析 CHANNEL__{INSTANCE}__{FIELD} 格式的配置。
+        如果没有配置多实例，返回从单实例配置转换的 default 实例。
         """
         if self._channels is None:
             loader = MultiInstanceConfigLoader("CHANNEL", ChannelInstanceConfig)
             self._channels = loader.load()
+            if not self._channels and self.channel.backend:
+                self._channels = {
+                    "default": ChannelInstanceConfig(
+                        backend=self.channel.backend,
+                        url=self.channel.url,
+                    )
+                }
         return self._channels
     
     def get_mqs(self) -> dict[str, MQInstanceConfig]:
@@ -929,6 +959,7 @@ __all__ = [
     "CacheInstanceConfig",
     "CacheSettings",
     "ChannelInstanceConfig",
+    "ChannelSettings",
     "DatabaseInstanceConfig",
     "DatabaseSettings",
     "EventInstanceConfig",

aury/boot/commands/templates/project/aury_docs/13-channel.md.tpl

@@ -9,10 +9,34 @@
 
 ## 13.1 基本用法
 
+### 通过环境变量自动初始化（推荐）
+
+配置环境变量后，`ChannelComponent` 会在应用启动时自动初始化：
+
+```bash
+# .env
+CHANNEL__SSE__BACKEND=memory
+CHANNEL__NOTIFICATION__BACKEND=redis
+CHANNEL__NOTIFICATION__URL=redis://localhost:6379/3
+```
+
 ```python
 from aury.boot.infrastructure.channel import ChannelManager
 
-# 命名多实例（推荐）- 不同业务场景使用不同实例
+# 直接获取已初始化的实例
+sse_channel = ChannelManager.get_instance("sse")
+notification_channel = ChannelManager.get_instance("notification")
+
+# 直接使用
+await sse_channel.publish("user:123", {{"event": "hello"}})
+```
+
+### 手动初始化
+
+```python
+from aury.boot.infrastructure.channel import ChannelManager
+
+# 命名多实例 - 不同业务场景使用不同实例
 sse_channel = ChannelManager.get_instance("sse")
 notification_channel = ChannelManager.get_instance("notification")
 
@@ -112,29 +136,17 @@ await sse_channel.publish(f"space:{{space_id}}:comment_added", {{
 
 Redis 后端使用 Redis 原生 `PSUBSCRIBE`，内存后端使用 `fnmatch` 实现。
 
-## 13.5 应用场景示例
-
-```python
-# 不同业务场景使用不同的命名实例
-sse_channel = ChannelManager.get_instance("sse")           # 前端 SSE 推送
-chat_channel = ChannelManager.get_instance("chat")         # 聊天消息
-notify_channel = ChannelManager.get_instance("notify")     # 系统通知
-
-# 分别初始化（可使用不同后端）
-await sse_channel.initialize(backend="memory")  # 单进程即可
-await chat_channel.initialize(backend="redis", url="redis://localhost:6379/3")  # 需要跨进程
-await notify_channel.initialize(backend="redis", url="redis://localhost:6379/4")
-```
-
-## 13.6 环境变量
+## 13.5 环境变量
 
 ```bash
-# 默认实例
+# 单实例配置
 CHANNEL__BACKEND=memory
-
-# 多实例（格式：CHANNEL__{{INSTANCE}}__{{FIELD}}）
-CHANNEL__DEFAULT__BACKEND=redis
-CHANNEL__DEFAULT__URL=redis://localhost:6379/3
-CHANNEL__NOTIFICATIONS__BACKEND=redis
-CHANNEL__NOTIFICATIONS__URL=redis://localhost:6379/4
+# 或 Redis 后端
+CHANNEL__BACKEND=redis
+CHANNEL__URL=redis://localhost:6379/3
+
+# 多实例配置（格式：CHANNEL__{{INSTANCE}}__{{FIELD}}）
+CHANNEL__SSE__BACKEND=memory
+CHANNEL__NOTIFICATION__BACKEND=redis
+CHANNEL__NOTIFICATION__URL=redis://localhost:6379/4
 ```

aury/boot/commands/templates/project/env_templates/messaging.tpl

@@ -2,12 +2,15 @@
 # =============================================================================
 # 流式通道配置 (CHANNEL__) - SSE/实时通信
 # =============================================================================
+# 单实例配置:
+# CHANNEL__BACKEND=memory
+# CHANNEL__BACKEND=redis
+# CHANNEL__URL=redis://localhost:6379/3
+#
 # 多实例配置 (格式: CHANNEL__{{INSTANCE}}__{{FIELD}}):
-# CHANNEL__DEFAULT__BACKEND=memory
-# CHANNEL__SHARED__BACKEND=redis
-# CHANNEL__SHARED__URL=redis://localhost:6379/3
-# CHANNEL__SHARED__KEY_PREFIX=channel:
-# CHANNEL__SHARED__TTL=86400
+# CHANNEL__SSE__BACKEND=memory
+# CHANNEL__NOTIFICATION__BACKEND=redis
+# CHANNEL__NOTIFICATION__URL=redis://localhost:6379/3
 
 # =============================================================================
 # 消息队列配置 (MQ__)

{aury_boot-0.0.25.dist-info → aury_boot-0.0.27.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: aury-boot
-Version: 0.0.25
+Version: 0.0.27
 Summary: Aury Boot - 基于 FastAPI 生态的企业级 API 开发框架
 Requires-Python: >=3.13
 Requires-Dist: alembic>=1.17.2

{aury_boot-0.0.25.dist-info → aury_boot-0.0.27.dist-info}/RECORD

@@ -1,5 +1,5 @@
 aury/boot/__init__.py,sha256=pCno-EInnpIBa1OtxNYF-JWf9j95Cd2h6vmu0xqa_-4,1791
-aury/boot/_version.py,sha256=DspPu1FRRiGe5F0Nbz1wXOpsS5e-m6ETOzBjU5BFWRE,706
+aury/boot/_version.py,sha256=vq5GihUa4KrDz-Hix5Er9gtVMhfHNDBoLhzP1VsvNuE,706
 aury/boot/application/__init__.py,sha256=0o_XmiwFCeAu06VHggS8I1e7_nSMoRq0Hcm0fYfCywU,3071
 aury/boot/application/adapter/__init__.py,sha256=e1bcSb1bxUMfofTwiCuHBZJk5-STkMCWPF2EJXHQ7UU,3976
 aury/boot/application/adapter/base.py,sha256=Ar_66fiHPDEmV-1DKnqXKwc53p3pozG31bgTJTEUriY,15763
@@ -14,7 +14,7 @@ aury/boot/application/app/middlewares.py,sha256=BXe2H14FHzJUVpQM6DZUm-zfZRXSXIi1
 aury/boot/application/app/startup.py,sha256=DHKt3C2G7V5XfFr1SQMl14tNzcuDd9MqUVAxi274HDQ,7873
 aury/boot/application/config/__init__.py,sha256=Dd-myRSBCM18DXXsi863h0cJG5VFrI10xMRtjnvelGo,1894
 aury/boot/application/config/multi_instance.py,sha256=RXSp-xP8-bKMDEhq3SeL7T3lS8-vpRlvBEVBuZVjVK4,6475
-aury/boot/application/config/settings.py,sha256=o0SAwEpFqoHE7zB3lYyaSCm0cX2NZnTVqUWiSJ-Qdtk,30576
+aury/boot/application/config/settings.py,sha256=-afn5p9rIS4_63OLqfG-mrTl2UergOZb6z8I5GyYOAY,31621
 aury/boot/application/constants/__init__.py,sha256=DCXs13_VVaQWHqO-qpJoZwRd7HIexiirtw_nu8msTXE,340
 aury/boot/application/constants/components.py,sha256=VBCgxJ_iZXjEZyUkC13ZCdqPmdKq-lQmU7jQpXnTa2Y,1056
 aury/boot/application/constants/scheduler.py,sha256=S77FBIvHlyruvlabRWZJ2J1YAs2xWXPQI2yuGdGUDNA,471
@@ -81,7 +81,7 @@ aury/boot/commands/templates/project/aury_docs/09-tasks.md.tpl,sha256=swHOQ_pWPt
 aury/boot/commands/templates/project/aury_docs/10-storage.md.tpl,sha256=mhe0j0S51ndPJLjaQ6yD8OPYBEO02NHumJVbBvz2qkw,4320
 aury/boot/commands/templates/project/aury_docs/11-logging.md.tpl,sha256=bwxFCGQsO9cTEbwqJF1xcjsZKP82HRWhIMRUS0c9_ZI,2435
 aury/boot/commands/templates/project/aury_docs/12-admin.md.tpl,sha256=6z3mN54qP2jtpTFOJBLVexvEv0ZHXYKjncvpZG4yOdw,1883
-aury/boot/commands/templates/project/aury_docs/13-channel.md.tpl,sha256=SV0XpuzzF7YGwsGm9uswQf0-JQvbJ98rdXOUa2KJm5E,4428
+aury/boot/commands/templates/project/aury_docs/13-channel.md.tpl,sha256=aGpf2phQBMRs6Uh1DfjNl06pC_niea91Sm8sTq_NFec,4443
 aury/boot/commands/templates/project/aury_docs/14-mq.md.tpl,sha256=4bxLQBbCi0Fue0VQWOPt6acZ5P00BoLkCoLPQe_8k4U,2396
 aury/boot/commands/templates/project/aury_docs/15-events.md.tpl,sha256=a4wQRgVPuYUGTGmw_lX1HJH_yFTbD30mBz7Arc4zgfs,3361
 aury/boot/commands/templates/project/aury_docs/16-adapter.md.tpl,sha256=pkmJkZw2Ca6_uYk2jZvAb8DozjBa2tWq_t3gtq1lFSk,11456
@@ -91,7 +91,7 @@ aury/boot/commands/templates/project/env_templates/admin.tpl,sha256=wWt3iybOpBHt
 aury/boot/commands/templates/project/env_templates/cache.tpl,sha256=_sK-p_FECj4mVvggNvgb4Wu0yGii0Ocz560syG7DU2c,498
 aury/boot/commands/templates/project/env_templates/database.tpl,sha256=2lWzTKt4X0SpeBBCkrDV90Di4EfoAuqYzhVsh74vTUI,907
 aury/boot/commands/templates/project/env_templates/log.tpl,sha256=x5rkrEFJISH0gaCcr-wTCbDYtyFnlLNJpY789fqjZgc,754
-aury/boot/commands/templates/project/env_templates/messaging.tpl,sha256=ICRLGw2FtJ0bNtkHnpy0CFyILqxOfFLbfejdFLJuuo8,1719
+aury/boot/commands/templates/project/env_templates/messaging.tpl,sha256=ZaNBM4pq0pgkTXbCBx_sgjm8QKEBfW1nSnsKZfHu-HM,1771
 aury/boot/commands/templates/project/env_templates/rpc.tpl,sha256=FhweCFakawGLSs01a_BkmZo11UhWax2-VCBudHj68WA,1163
 aury/boot/commands/templates/project/env_templates/scheduler.tpl,sha256=c8Grcs1rgBB58RHlxqmDMPHQl8BnbcqNW473ctmsojU,752
 aury/boot/commands/templates/project/env_templates/service.tpl,sha256=b-a2GyRyoaunbDj_2kaSw3OFxcugscmPvUBG7w0XO8c,710
@@ -192,7 +192,7 @@ aury/boot/testing/client.py,sha256=KOg1EemuIVsBG68G5y0DjSxZGcIQVdWQ4ASaHE3o1R0,4
 aury/boot/testing/factory.py,sha256=8GvwX9qIDu0L65gzJMlrWB0xbmJ-7zPHuwk3eECULcg,5185
 aury/boot/toolkit/__init__.py,sha256=AcyVb9fDf3CaEmJPNkWC4iGv32qCPyk4BuFKSuNiJRQ,334
 aury/boot/toolkit/http/__init__.py,sha256=zIPmpIZ9Qbqe25VmEr7jixoY2fkRbLm7NkCB9vKpg6I,11039
-aury_boot-0.0.25.dist-info/METADATA,sha256=ph7zu8UJgX6_LBmEERNW8O6C7nc0afNhYEGz9Qm3rQs,7695
-aury_boot-0.0.25.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-aury_boot-0.0.25.dist-info/entry_points.txt,sha256=f9KXEkDIGc0BGkgBvsNx_HMz9VhDjNxu26q00jUpDwQ,49
-aury_boot-0.0.25.dist-info/RECORD,,
+aury_boot-0.0.27.dist-info/METADATA,sha256=qbe9mHwMgUyqjel4saqlfiZLtS2j_IAbMOqLkkr04ys,7695
+aury_boot-0.0.27.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+aury_boot-0.0.27.dist-info/entry_points.txt,sha256=f9KXEkDIGc0BGkgBvsNx_HMz9VhDjNxu26q00jUpDwQ,49
+aury_boot-0.0.27.dist-info/RECORD,,