"Vibe-Trading: Your Personal Trading Agent"
Python ai-agentalgorithmic-tradingbacktestingfintechllmmcpmulti-agentpythonquantitative-financetrading
"""Shared coercion for tool arguments received from JSON callers."""
from __future__ import annotations
from typing import Any
def boolean_argument(value: Any, *, field: str) -> bool:
"""Parse an optional boolean without treating non-empty strings as true.
Args:
value: Boolean, null, zero/one, or an explicit boolean spelling.
field: Argument name to include in a validation error.
Returns:
The parsed boolean; null retains the historical false value.
Raises:
ValueError: If the input is ambiguous or malformed. In particular,
an unknown dry-run string must never silently enable writes.
"""
if value is None:
return False
if isinstance(value, bool):
return value
if isinstance(value, str):
token = value.strip().lower()
if token in {"true", "1", "yes", "on"}:
return True
if token in {"false", "0", "no", "off"}:
return False
elif isinstance(value, (int, float)) and value in (0, 1):
return bool(value)
raise ValueError(f"{field} must be a boolean (true or false)")