Init

app/utils/coerce.py

@@ -0,0 +1,44 @@
+"""站点 JSON 取值的类型收敛工具
+
+`__INITIAL_STATE__` 里同一字段在不同商品/店铺上可能是 null、数字或字符串
+（例如运费既可能是 0 也可能是 null，评分既可能是 4.5 也可能是 "4.5"），
+统一在这里做容错转换，避免解析器里到处写 isinstance 判断。
+"""
+from __future__ import annotations
+
+from typing import Any
+
+
+def as_dict(value: Any) -> dict[str, Any]:
+    """非 dict（含 None）一律收敛为空 dict"""
+    return value if isinstance(value, dict) else {}
+
+
+def as_list(value: Any) -> list[Any]:
+    """非 list（含 None）一律收敛为空 list"""
+    return value if isinstance(value, list) else []
+
+
+def as_str(value: Any) -> str:
+    """非字符串一律收敛为空串"""
+    return value if isinstance(value, str) else ""
+
+
+def as_int(value: Any, default: int = 0) -> int:
+    """尽力转成 int；布尔值不视为数字，避免 True 被当成 1"""
+    if isinstance(value, bool) or not isinstance(value, (int, float, str)):
+        return default
+    try:
+        return int(float(value))
+    except (TypeError, ValueError):
+        return default
+
+
+def as_float(value: Any, default: float = 0.0) -> float:
+    """尽力转成 float；布尔值不视为数字"""
+    if isinstance(value, bool) or not isinstance(value, (int, float, str)):
+        return default
+    try:
+        return float(value)
+    except (TypeError, ValueError):
+        return default