tson-bin 0.1.4

Terse JSON — compact binary JSON for microcontrollers

tson-bin — Terse JSON binary format for Python

TSON is a compact, schema-deduplicated binary format for JSON — field names are stored once, repeated strings are interned, giving 60–70% size reduction on repetitive data (API payloads, telemetry, config). These are the Python bindings (a native extension built in Rust via PyO3).

The PyPI distribution is tson-bin but it imports as tson.

Install

pip install tson-bin

import tson

Usage

import tson

# Compile a JSON string to TSON binary, and back
blob = tson.dumps('{"name": "Alice", "age": 30}')   # -> bytes
obj  = tson.loads(blob)                               # -> {"name": "Alice", "age": 30}

# Encode a Python object directly (no JSON string in between)
blob = tson.emit({"temp": 22.5, "status": "nominal"})

# File I/O
tson.dump('{"msg": "hello"}', "message.tson")
obj = tson.load("message.tson")

API

Function	Signature	Description
dumps(json_text)	str -> bytes	Compile a JSON string to TSON binary
loads(blob)	bytes -> object	Decode TSON binary to a Python object
dump(json_text, path)	(str, str) -> None	Compile a JSON string to a .tson file
load(path)	str -> object	Read and decode a .tson file
emit(obj)	object -> bytes	Encode a Python object directly to TSON

Invalid input raises ValueError.

Documentation

• Python usage guide
• Project README
• Binary format spec

License

MIT © SIKTEC Lab