Function _parse_cli_value

unity_cli/cli/helpers.py:76–111

Parse a CLI string value into an appropriate Python type. Parse order (JSON-first): 1. json.loads -- handles true/false, numbers, quoted strings, arrays, objects 2. Legacy bool -- Python-style "True"/"False" (case-insensitive) 3. int / float 4. bare string

(raw: str)

def _parse_cli_value(raw: str) -> int | float | bool | list[Any] | dict[str, Any] | str | None:
    """Parse a CLI string value into an appropriate Python type.

    Parse order (JSON-first):
      1. json.loads  -- handles true/false, numbers, quoted strings, arrays, objects
      2. Legacy bool -- Python-style "True"/"False" (case-insensitive)
      3. int / float
      4. bare string
    """
    import json

    # Skip json.loads for bare strings that cannot be valid JSON.
    # Valid JSON values start with: digit, '-', '"', '[', '{', 't', 'n', 'f'
    if raw and (raw[0].isdigit() or raw[0] == "-" or raw[0] in _JSON_START_CHARS):
        try:
            parsed: int | float | bool | list[Any] | dict[str, Any] | str | None = json.loads(raw)
            return parsed
        except (ValueError, json.JSONDecodeError):
            pass

    if raw.lower() == "true":
        return True
    if raw.lower() == "false":
        return False

    try:
        return int(raw)
    except ValueError:
        pass

    try:
        return float(raw)
    except ValueError:
        pass

    return raw