Releases

First stable release of csv-to-json, a lightweight CSV-to-JSON converter built entirely on the Python standard library (Python 3.10+, zero dependencies).

What it does

Converts CSV data into clean JSON, usable both as a CLI tool and as an importable library.

Highlights

• Type inference - numeric, boolean (true/yes, false/no), and empty values are cast to JSON numbers, booleans, and null; disable with --no-type-inference
• Nested key expansion - dot-notation headers like user.address.city become nested JSON objects via --expand-keys
• Streaming - stream_csv_to_json() yields one record at a time, so large files never need to fit in memory
• Flexible input - accepts file paths, raw CSV strings, open text streams, or stdin (-)
• Custom delimiters - handle TSV and other formats with -d
• Compact or pretty output - --compact for minified JSON, indented by default

Usage

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

See README.md for library usage and the full CLI reference.