Function needs_quoting

toon/utils.py:11–52

Check if a string value needs to be quoted. Quoting is needed when: - Value contains special characters (comma, colon, newline, quotes) - Value has leading or trailing whitespace - Value looks like a boolean or null literal - Value is empty Args: value:

(value: str)

def needs_quoting(value: str) -> bool:
    """
    Check if a string value needs to be quoted.
    
    Quoting is needed when:
    - Value contains special characters (comma, colon, newline, quotes)
    - Value has leading or trailing whitespace
    - Value looks like a boolean or null literal
    - Value is empty
    
    Args:
        value: String to check
        
    Returns:
        True if quoting is needed, False otherwise
    """
    if not value:
        return True
    
    # Check for leading/trailing whitespace
    if value != value.strip():
        return True
    
    # Check if it looks like a literal
    lower_value = value.lower()
    if lower_value in (TRUE_LITERAL, FALSE_LITERAL, NULL_LITERAL):
        return True
    
    # Check for special characters
    special_chars = {COMMA, COLON, NEWLINE, QUOTE, TAB, PIPE, BACKSLASH, '[', ']', '{', '}'}
    if any(char in value for char in special_chars):
        return True
    
    # Check if it looks like a number but has trailing content
    # This handles cases like "123abc" which should be quoted
    try:
        float(value)
        return False
    except ValueError:
        pass
    
    return False


def escape_string(value: str) -> str: