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）システム - リソースの帰属と自動回収
• ライフサイクル管理 - バックグラウンドタスクとメインループ