Function encode

toon/encoder.py:50–81

Encode Python data structure to TOON format. Args: data: Python object to encode (dict or list) options: Encoding options - delimiter: ',' (default), '\t', or '|' - indent: int (default 2) - key_folding: 'off' (default) or 'safe'

(data: Any, options: Optional[Dict[str, Any]] = None)

def encode(data: Any, options: Optional[Dict[str, Any]] = None) -> str:
    """
    Encode Python data structure to TOON format.
    
    Args:
        data: Python object to encode (dict or list)
        options: Encoding options
            - delimiter: ',' (default), '\t', or '|'
            - indent: int (default 2)
            - key_folding: 'off' (default) or 'safe'
            - flatten_depth: int or None
            
    Returns:
        TOON formatted string
        
    Example:
        >>> data = {'users': [{'id': 1, 'name': 'Alice'}]}
        >>> print(encode(data))
        users[1]{id,name}:
          1,Alice
    """
    if options is None:
        options = {}
    
    opts = EncoderOptions(
        delimiter=options.get('delimiter', DEFAULT_DELIMITER),
        indent=options.get('indent', DEFAULT_INDENT),
        key_folding=options.get('key_folding', KEY_FOLDING_OFF),
        flatten_depth=options.get('flatten_depth')
    )
    
    return _encode_value(data, 0, opts)


def _encode_value(value: Any, level: int, opts: EncoderOptions) -> str: