toon-parser-async

Async wrapper for toon-parser - High-performance TOON format parser with asyncio support.

Installation

pip install toon-parser-async

This will automatically install toon-parser as a dependency.

Quick Start

import asyncio
from toon_parser_async import encode, decode, encode_batch, decode_batch

async def main():
    # Encode data
    data = {"name": "Alice", "age": 30}
    toon_str = await encode(data)
    print(toon_str)
    
    # Decode data
    decoded = await decode(toon_str)
    print(decoded)
    
    # Batch operations
    items = [{"id": i} for i in range(10)]
    encoded_items = await encode_batch(items)
    decoded_items = await decode_batch(encoded_items)

asyncio.run(main())

API

All functions are async and use asyncio.to_thread() to run the sync toon-parser functions in the thread pool:

• async encode(data, delimiter=None, strict=None) - Encode Python data to TOON format
• async decode(toon_str, delimiter=None, strict=None) - Decode TOON format to Python data
• async dumps(data, **kwargs) - Alias for encode
• async loads(toon_str, **kwargs) - Alias for decode
• async encode_batch(data_list, **kwargs) - Encode multiple items concurrently
• async decode_batch(toon_strs, **kwargs) - Decode multiple strings concurrently

Performance

toon-parser-async uses the high-performance toon-parser Rust library under the hood, which is 5.82x faster than other TOON implementations on average. The async wrapper adds minimal overhead while enabling concurrent I/O operations.

Credits

• Built on toon-parser by magi8101
• TOON format parser toon-rs by Jimmy Stridh

License

MIT License