Releases

First stable release of csv-to-json, a lightweight, dependency-free CSV-to-JSON converter (Python 3.10+, stdlib only).

What it does

Converts CSV data to clean JSON, usable as a CLI tool or imported as a Python library. Accepts file paths, raw CSV strings, or stdin.

Highlights

• Type inference — casts values to int/float/bool/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 records one at a time for large files without loading everything into memory
• Custom delimiters — handle TSV or any delimiter via -d
• Flexible output — pretty-printed by default, --compact for minified JSON, -o to write to a file

Usage

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

MIT licensed. See README.md for full CLI reference and library examples.