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 tool or importable library.

What it does

• Type inference: automatically casts CSV values to int, float, bool (true/yes, false/no), and null (empty cells) — can be disabled 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 records one 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: -d flag for TSV or any other separator
• Output options: pretty-printed (default) or --compact minified JSON, to stdout or a file via -o

Usage

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

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