spot-sdk-python 1.2.0__tar.gz → 1.2.1__tar.gz

{spot_sdk_python-1.2.0 → spot_sdk_python-1.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: spot-sdk-python
-Version: 1.2.0
+Version: 1.2.1
 Summary: Python SDK for SPOT platform - API contracts, models, and utilities
 License: Apache-2.0
 Author: SPOT Project
@@ -247,7 +247,7 @@ where downstream analyzers can read it via `email.ctx.provider(...)`.
 
 The Knowledge Store is the platform's RAG layer: context providers
 deposit tagged documents, analyzers fetch them on demand. Neither side
-references the other — they share only the tag vocabulary.
+references the other ; they share only the tag vocabulary.
 
 ```python
 from spot_sdk import KnowledgeClient, KnowledgeDocument, KnowledgeTag, chunk_text
@@ -293,7 +293,7 @@ Tag-expression syntax: `a`, `a+b` (AND), `a|b` (OR), `a+b|c`
 no tag filter.
 
 Workflow-declared `retrieval_limits` (stage-level caps on `top_k` and
-`min_score`) are enforced transparently by `for_analysis()` — the
+`min_score`) are enforced transparently by `for_analysis()` ; the
 analyzer doesn't need to know about them.
 
 ### Testing

{spot_sdk_python-1.2.0 → spot_sdk_python-1.2.1}/README.md

@@ -226,7 +226,7 @@ where downstream analyzers can read it via `email.ctx.provider(...)`.
 
 The Knowledge Store is the platform's RAG layer: context providers
 deposit tagged documents, analyzers fetch them on demand. Neither side
-references the other — they share only the tag vocabulary.
+references the other ; they share only the tag vocabulary.
 
 ```python
 from spot_sdk import KnowledgeClient, KnowledgeDocument, KnowledgeTag, chunk_text
@@ -272,7 +272,7 @@ Tag-expression syntax: `a`, `a+b` (AND), `a|b` (OR), `a+b|c`
 no tag filter.
 
 Workflow-declared `retrieval_limits` (stage-level caps on `top_k` and
-`min_score`) are enforced transparently by `for_analysis()` — the
+`min_score`) are enforced transparently by `for_analysis()` ; the
 analyzer doesn't need to know about them.
 
 ### Testing

{spot_sdk_python-1.2.0 → spot_sdk_python-1.2.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "poetry.core.masonry.api"
 
 [tool.poetry]
 name = "spot-sdk-python"
-version = "1.2.0"
+version = "1.2.1"
 description = "Python SDK for SPOT platform - API contracts, models, and utilities"
 authors = ["SPOT Project <spot@sonn.lu>"]
 license = "Apache-2.0"

{spot_sdk_python-1.2.0 → spot_sdk_python-1.2.1}/spot_sdk/analyzer_base.py

@@ -120,18 +120,25 @@ def settings_singleton(func: Callable[[], T]) -> Callable[[], T]:
 def merge_settings(base: T, overrides: dict[str, Any]) -> T:
     """Merge base settings with central config overrides.
 
-    Only applies overrides for fields that actually exist in the Settings model.
-    Returns a new Settings instance (the original is not mutated).
+    Override keys match the Pydantic field names case-insensitively, so
+    the dashboard's uppercase convention (``MODEL_PATH``, ``USE_GPU``)
+    maps onto the lowercase Python field names. Keys with no
+    corresponding field are silently dropped.
 
     Args:
         base: Base Settings instance from local env/defaults
-        overrides: Dict of override values from central config
+        overrides: Dict of override values from central config (any case)
 
     Returns:
-        New Settings instance with overrides applied.
+        New Settings instance with overrides applied. The original is
+        not mutated.
     """
-    valid_keys = set(type(base).model_fields.keys())
-    filtered = {k: v for k, v in overrides.items() if k in valid_keys}
+    field_by_lower = {name.lower(): name for name in type(base).model_fields}
+    filtered: dict[str, Any] = {}
+    for key, value in overrides.items():
+        canonical = field_by_lower.get(key.lower())
+        if canonical is not None:
+            filtered[canonical] = value
     return base.model_copy(update=filtered)
 
 

spot_sdk_python-1.2.1/spot_sdk/config_helpers.py

@@ -0,0 +1,34 @@
+"""Shared configuration helpers for SPOT analyzers."""
+
+from typing import Any, TypeVar
+
+from pydantic_settings import BaseSettings
+
+T = TypeVar("T", bound=BaseSettings)
+
+
+def merge_settings(settings_class: type[T], base: T, overrides: dict[str, Any]) -> T:
+    """Merge base settings with central overrides.
+
+    Override keys are matched case-insensitively against the Pydantic
+    field names. This lets the dashboard / spot.yaml use the
+    operator-friendly uppercase convention (``MODEL_PATH``,
+    ``LISTEN_PORT``, ...) while the Settings class keeps the Python
+    lowercase convention (``model_path``, ``listen_port``).
+
+    Args:
+        settings_class: The Pydantic Settings class (used for field discovery).
+        base: Base Settings instance from local env/defaults.
+        overrides: Override values from central config (any case).
+
+    Returns:
+        New Settings instance with overrides applied. Keys that do not
+        match any field on ``settings_class`` are silently dropped.
+    """
+    field_by_lower = {name.lower(): name for name in settings_class.model_fields}
+    filtered: dict[str, Any] = {}
+    for key, value in overrides.items():
+        canonical = field_by_lower.get(key.lower())
+        if canonical is not None:
+            filtered[canonical] = value
+    return base.model_copy(update=filtered)

spot_sdk_python-1.2.0/spot_sdk/config_helpers.py

@@ -1,25 +0,0 @@
-"""Shared configuration helpers for SPOT analyzers."""
-
-from typing import Any, TypeVar
-
-from pydantic_settings import BaseSettings
-
-T = TypeVar("T", bound=BaseSettings)
-
-
-def merge_settings(settings_class: type[T], base: T, overrides: dict[str, Any]) -> T:
-    """Merge base settings with central overrides.
-
-    Only applies overrides for fields that exist in the Settings model.
-
-    Args:
-        settings_class: The Pydantic Settings class (used for field discovery).
-        base: Base Settings instance from local env/defaults.
-        overrides: Override values from central config.
-
-    Returns:
-        New Settings instance with overrides applied.
-    """
-    valid_keys = set(settings_class.model_fields.keys())
-    filtered = {k: v for k, v in overrides.items() if k in valid_keys}
-    return base.model_copy(update=filtered)