runtime 工具帶

ErisPulse.runtime 是框架的聚合導出層：把散落在各模組的運行時工具收進 單一入口，腳本、模組、適配器代碼統一 from ErisPulse.runtime import X 取用，不必記深層路徑。

能力速查表

dict_to_dataclass：dict → 類型安全物件

宣告式 dataclass 配置的「反方向」——將任意 dict（API 回應、webhook payload、使用者輸入）依照宣告解析成類型安全的實例，取代手寫 data.get("x", default) 鏈：

from dataclasses import dataclass, field
from ErisPulse.runtime import dict_to_dataclass

@dataclass
class WebhookPayload:
    order_id: str
    amount: float = 0.0
    tags: list = field(default_factory=list)
    remark: str = ""

payload = dict_to_dataclass(WebhookPayload, {
    "order_id": "A-1024",
    "amount": "99.5",          # str → float 自動轉換
    "unknown_key": "忽略",      # 未宣告欄位自動忽略
})
payload.amount                   # 99.5（float）

• 類型轉換（str → int/float 等）、預設值填充、巢狀 dataclass 的遞迴填充
• 環境變數覆蓋：欄位 metadata={"env": "NAME"} 時，優先順序為 環境變數 > 數據 > 預設值
• 宣告式配置類（ConfigClass / BaseConfig）的熱更新回調內部即由它完成 dict → 配置物件的轉換

相關文件

• 宣告式設定 - ConfigClass / BaseConfig 宣告式設定
• 歸屬權（owner）系統 - 資源歸屬與自動回收
• 生命週期管理 - 後台任務與主迴圈