query-cache-common 1.9.1__tar.gz → 1.9.2__tar.gz

{query_cache_common-1.9.1 → query_cache_common-1.9.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: query-cache-common
-Version: 1.9.1
+Version: 1.9.2
 Summary: Common code for Query Cache shared across client and server
 License: 
                                          Apache License

{query_cache_common-1.9.1 → query_cache_common-1.9.2}/src/query_cache_common/utils.py

@@ -26,6 +26,25 @@ def str_to_bool(s: str | None) -> bool:
     return s.lower() in ("true", "1", "t", "y", "yes", "on")
 
 
+def to_bool(value: t.Any) -> bool:
+    """Coerce a bool, int, or string to a boolean.
+
+    Unlike str_to_bool, this accepts bools and ints directly (strings are delegated to
+    str_to_bool) and raises ValueError for any other type rather than silently
+    returning False.
+    """
+    if isinstance(value, bool):
+        return value
+    if isinstance(value, str):
+        return str_to_bool(value)
+    if isinstance(value, int):
+        return bool(value)
+    raise ValueError(
+        f"Cannot convert value of type {type(value).__name__} to bool: {value!r}. "
+        "Expected bool, int, or string (e.g., 'true', 'false', 'yes', 'no')."
+    )
+
+
 def current_epoch_millis() -> int:
     """Return the current time in milliseconds since Unix epoch."""
     return time.time_ns() // 1_000_000