Releases

csv-to-json v1.0.0 — Initial release

A lightweight, dependency-free CSV-to-JSON converter (Python 3.10+, stdlib only) for developer and AI-agent workflows.

What it does

• Type inference — casts CSV values to int, float, bool, or 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 need to fit in memory
• Flexible I/O — accepts file paths, raw CSV strings, or stdin; writes to a file or stdout; custom delimiters (-d '\t'); pretty or --compact output
• Dual interface — run as a CLI (python src/csv_converter.py data.csv -o out.json) or import csv_to_json() as a library

Contents

• src/csv_converter.py — the converter (CLI + library)
• README.md — quick start, CLI reference, type-inference rules

MIT licensed.