piphi-runtime-kit-python 0.4.4__py3-none-any.whl → 0.4.6__py3-none-any.whl

piphi_runtime_kit_python/runtime/starter.py

@@ -3,15 +3,25 @@ from __future__ import annotations
 """Opinionated beginner-friendly starter helpers for PiPhi runtimes."""
 
 from dataclasses import dataclass, field
+from pathlib import Path
 from typing import Any
 
-from .config_sync import ConfigSyncCoordinator
+import httpx
+
+from .config_sync import (
+    DEFAULT_RUNTIME_VOLUME_DIR,
+    ConfigSyncCoordinator,
+    RuntimeConfigRehydrateResult,
+    SnapshotApplyCallable,
+    rehydrate_runtime_configs,
+)
 from .context import RuntimeContext
 from .events import DEFAULT_CORE_BASE_URL as DEFAULT_EVENTS_CORE_BASE_URL, EventClient
 from .health import build_runtime_diagnostics_response, build_runtime_health_response
+from .lifespan import DEFAULT_CORE_CLIENT_TIMEOUT_SECONDS
 from .registry import RuntimeRegistry
 from .telemetry import DEFAULT_CORE_BASE_URL as DEFAULT_TELEMETRY_CORE_BASE_URL, TelemetryClient
-from ..schemas import RuntimeEntitiesResponse
+from ..schemas import RuntimeConfig, RuntimeConfigSnapshot, RuntimeEntitiesResponse
 
 
 @dataclass(slots=True)
@@ -92,6 +102,37 @@ class RuntimeStarter:
             commands=commands,
         )
 
+    async def rehydrate_configs(
+        self,
+        *,
+        client: httpx.AsyncClient,
+        apply_snapshot: SnapshotApplyCallable,
+        config_model: type[RuntimeConfig] = RuntimeConfig,
+        snapshot_model: type[Any] = RuntimeConfigSnapshot,
+        timeout_seconds: float = DEFAULT_CORE_CLIENT_TIMEOUT_SECONDS,
+        snapshot_path: str | Path | None = None,
+        snapshot_volume_dir: str | Path = DEFAULT_RUNTIME_VOLUME_DIR,
+        raise_core_errors: bool = False,
+    ) -> RuntimeConfigRehydrateResult:
+        """Load startup configs from the mounted snapshot and then Core.
+
+        This is the recommended starter-level entry point. Integration authors
+        provide their typed config model and apply callback; the starter supplies
+        the shared runtime context and Core base URL.
+        """
+        return await rehydrate_runtime_configs(
+            runtime_context=self.runtime,
+            client=client,
+            apply_snapshot=apply_snapshot,
+            config_model=config_model,
+            snapshot_model=snapshot_model,
+            core_base_url=self.core_base_url,
+            timeout_seconds=timeout_seconds,
+            snapshot_path=snapshot_path,
+            snapshot_volume_dir=snapshot_volume_dir,
+            raise_core_errors=raise_core_errors,
+        )
+
 
 def build_entities_response(
     *,

{piphi_runtime_kit_python-0.4.4.dist-info → piphi_runtime_kit_python-0.4.6.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: piphi-runtime-kit-python
-Version: 0.4.4
+Version: 0.4.6
 Summary: PiPhi Network runtime integration helpers
 Keywords: piphi,runtime,integration,iot
 Author-Email: KelvinSan <support@piphi.network>

{piphi_runtime_kit_python-0.4.4.dist-info → piphi_runtime_kit_python-0.4.6.dist-info}/RECORD

@@ -1,7 +1,7 @@
-piphi_runtime_kit_python-0.4.4.dist-info/METADATA,sha256=itnYk2BZoSxO2w_x--KH4i937xkqhT4_HT5GZZKy-cA,30849
-piphi_runtime_kit_python-0.4.4.dist-info/WHEEL,sha256=Z36eTX6lG3PITRleSd5hAZHCcz52yg3c0JQVxKBbLW0,90
-piphi_runtime_kit_python-0.4.4.dist-info/entry_points.txt,sha256=6OYgBcLyFCUgeqLgnvMyOJxPCWzgy7se4rLPKtNonMs,34
-piphi_runtime_kit_python-0.4.4.dist-info/licenses/LICENSE,sha256=pS6szQI4X7qAin1ODdoDp-XwZvsFy6ZZ28-JAwGHgzo,1070
+piphi_runtime_kit_python-0.4.6.dist-info/METADATA,sha256=yQj3dR1JQDK4GyTFWfgoV7uGAHYUd2Qg1V_TXjNQujg,30849
+piphi_runtime_kit_python-0.4.6.dist-info/WHEEL,sha256=Z36eTX6lG3PITRleSd5hAZHCcz52yg3c0JQVxKBbLW0,90
+piphi_runtime_kit_python-0.4.6.dist-info/entry_points.txt,sha256=6OYgBcLyFCUgeqLgnvMyOJxPCWzgy7se4rLPKtNonMs,34
+piphi_runtime_kit_python-0.4.6.dist-info/licenses/LICENSE,sha256=pS6szQI4X7qAin1ODdoDp-XwZvsFy6ZZ28-JAwGHgzo,1070
 piphi_runtime_kit_python/__init__.py,sha256=nw9We1D1bN6aucvw2mlgux3rs4znSIH-RyagYSbDgWE,6866
 piphi_runtime_kit_python/adapters/__init__.py,sha256=3jBhPZSBN3Qo7MKHlxAol2jPU3cK23BXHR2oTlircsw,361
 piphi_runtime_kit_python/adapters/fastapi.py,sha256=1QcOBYprg6AmQVrkI8g61NIelBB_7BTbdvNaMvG2-s8,2098
@@ -20,9 +20,9 @@ piphi_runtime_kit_python/runtime/identity.py,sha256=cth0_QHR9R5LTdp-6DPD1IhM8cYJ
 piphi_runtime_kit_python/runtime/lifespan.py,sha256=mVSdZZAS66xlcnlzAwkztFjzw_l2pyLrJqULJsb0Ezk,2850
 piphi_runtime_kit_python/runtime/mqtt.py,sha256=JKMN5zxg1BcOidu7TaYnuRD3HuoAJ_WcvXMTTSlAteo,6069
 piphi_runtime_kit_python/runtime/registry.py,sha256=8rKLCWt1_0SlDm3TepEUGDliOhVEDTv_zYR0kxLpSHM,3373
-piphi_runtime_kit_python/runtime/starter.py,sha256=j5C4GOOcRHNLJ-HYu8fmf3bE00baDOzAfuq1MefT-Jg,4651
+piphi_runtime_kit_python/runtime/starter.py,sha256=VECNCPAleIrDoaA1AEXX7Jp5RFNtjNWkKthIGkOGRIM,6234
 piphi_runtime_kit_python/runtime/state.py,sha256=4xvQGTT59DF9rXHAtM3kDyV_UGg2a9tLPvGiCp_PFMc,674
 piphi_runtime_kit_python/runtime/tasks.py,sha256=gMd-2K96jMU8tCPvI12xdWxuyNt5gsLDss2QWOoM94k,1241
 piphi_runtime_kit_python/runtime/telemetry.py,sha256=RN6SFrhmAZ7aJLyioQMBzJEFsxQgOjjA1pV5qNeaR4E,4279
 piphi_runtime_kit_python/schemas.py,sha256=9jlsfmvz-O2YeoB0SVopXY7NhFlb1zgynez0NXEZkVE,9849
-piphi_runtime_kit_python-0.4.4.dist-info/RECORD,,
+piphi_runtime_kit_python-0.4.6.dist-info/RECORD,,