"CLI-Anything: Making ALL Software Agent-Native" -- CLI-Hub: https://clianything.cc/
Python
"""OBS Studio CLI - JSON helpers and utilities."""
import json
import math
import os
import copy
from typing import Dict, Any, List, Optional
def _finite_number(value: Any, name: str) -> float | int:
"""Reject non-finite values without float-rounding large ints or integer strings."""
if isinstance(value, bool):
raise ValueError(f"{name} must be a finite number, got {value!r}")
if isinstance(value, int):
return value
if isinstance(value, float):
if not math.isfinite(value):
raise ValueError(f"{name} must be a finite number, got {value!r}")
return value
if isinstance(value, str):
try:
return int(value)
except (TypeError, ValueError):
pass
try:
num = float(value)
except (TypeError, ValueError) as exc:
raise ValueError(f"{name} must be a finite number, got {value!r}") from exc
if not math.isfinite(num):
raise ValueError(f"{name} must be a finite number, got {value!r}")
return num
try:
ival = int(value)
if ival == value:
return ival
except Exception:
pass
try:
num = float(value)
except Exception as exc:
raise ValueError(f"{name} must be a finite number, got {value!r}") from exc
if not math.isfinite(num):
raise ValueError(f"{name} must be a finite number, got {value!r}")
return num
def _finite_int(value: Any, name: str) -> int:
"""Reject non-finite or non-integer-form values without float rounding."""
if isinstance(value, bool):
raise ValueError(f"{name} must be a finite integer, got {value!r}")
if isinstance(value, int):
return value
if isinstance(value, float):
if not math.isfinite(value):
raise ValueError(f"{name} must be a finite integer, got {value!r}")
return int(value)
if isinstance(value, str):
try:
return int(value)
except (TypeError, ValueError) as exc:
raise ValueError(f"{name} must be a finite integer, got {value!r}") from exc
try:
val = int(value)
except (TypeError, ValueError, ArithmeticError) as exc:
raise ValueError(f"{name} must be a finite integer, got {value!r}") from exc
return val
def generate_id(items: List[Dict[str, Any]]) -> int:
"""Generate the next unique ID for a list of items."""
if not items:
return 0
return max(item.get("id", 0) for item in items) + 1
def unique_name(name: str, items: List[Dict[str, Any]], key: str = "name") -> str:
"""Ensure a unique name among existing items."""
existing = {item.get(key, "") for item in items}
if name not in existing:
return name
i = 1
while f"{name}.{i:03d}" in existing:
i += 1
return f"{name}.{i:03d}"
def validate_range(value: float, min_val: float, max_val: float, name: str) -> float:
"""Validate that a value is within range."""
val = float(value)
if not math.isfinite(val):
raise ValueError(f"{name} must be a finite number, got {val}")
if val < min_val or val > max_val:
raise ValueError(f"{name} must be between {min_val} and {max_val}, got {val}")
return val
def validate_position(pos: Dict[str, Any]) -> Dict[str, Any]:
"""Validate and normalize a position dict."""
x = _finite_number(pos.get("x", 0), "Position x")
y = _finite_number(pos.get("y", 0), "Position y")
return {"x": x, "y": y}
def validate_size(size: Dict[str, Any]) -> Dict[str, Any]:
"""Validate and normalize a size dict."""
w = _finite_int(size.get("width", 1920), "Size width")
h = _finite_int(size.get("height", 1080), "Size height")
if w < 1:
raise ValueError(f"Width must be positive, got {w}")
if h < 1:
raise ValueError(f"Height must be positive, got {h}")
return {"width": w, "height": h}
def validate_crop(crop: Dict[str, Any]) -> Dict[str, Any]:
"""Validate and normalize a crop dict."""
result = {}
for key in ("top", "bottom", "left", "right"):
val = _finite_int(crop.get(key, 0), f"Crop {key}")
if val < 0:
raise ValueError(f"Crop {key} must be non-negative, got {val}")
result[key] = val
return result
def deep_merge(base: Dict[str, Any], override: Dict[str, Any]) -> Dict[str, Any]:
"""Deep merge two dicts, override takes precedence."""
result = copy.deepcopy(base)
for k, v in override.items():
if k in result and isinstance(result[k], dict) and isinstance(v, dict):
result[k] = deep_merge(result[k], v)
else:
result[k] = copy.deepcopy(v)
return result
def load_json(path: str) -> Dict[str, Any]:
"""Load a JSON file."""
if not os.path.exists(path):
raise FileNotFoundError(f"File not found: {path}")
with open(path, "r") as f:
return json.load(f)
def save_json(data: Dict[str, Any], path: str) -> str:
"""Save data to a JSON file."""
os.makedirs(os.path.dirname(os.path.abspath(path)), exist_ok=True)
with open(path, "w") as f:
json.dump(data, f, indent=2, default=str)
return path
def find_by_name(items: List[Dict[str, Any]], name: str) -> Optional[int]:
"""Find an item index by name."""
for i, item in enumerate(items):
if item.get("name") == name:
return i
return None
def get_item(items: List[Dict[str, Any]], index: int, label: str = "item") -> Dict[str, Any]:
"""Get an item by index with bounds checking."""
if not items:
raise ValueError(f"No {label}s exist.")
if index < 0 or index >= len(items):
raise IndexError(f"{label} index {index} out of range (0-{len(items) - 1})")
return items[index]