Releases

csv-to-json v1.0.0 — first stable release

A lightweight, dependency-free CSV-to-JSON converter (Python 3.10+, stdlib only), usable as a CLI or as a library.

What it does

• Type inference — casts CSV values to int, float, bool, and null automatically (opt out with --no-type-inference)
• Nested key expansion — dot-notation headers like user.address.city become nested JSON objects (--expand-keys)
• Streaming — stream_csv_to_json() yields one record at a time, so large files never load fully into memory
• Flexible input — file paths, raw CSV strings, or stdin; custom delimiters via -d
• Output options — pretty-printed (default) or --compact, to stdout or a file via -o

Usage

python src/csv_converter.py data.csv -o data.json --expand-keys

from src.csv_converter import csv_to_json
print(csv_to_json("name,age\nAlice,30"))

MIT licensed. See README.md for full CLI options and type-inference rules.