Releases

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

A lightweight, dependency-free CSV-to-JSON converter built on the Python standard library. Works as a CLI tool or as an importable library.

What it does

• Type inference — automatically casts values to integers, floats, booleans, and nulls (42 → 42, yes → true, empty → 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, or stdin; custom delimiters via -d
• Output options — pretty-printed (default) or --compact minified JSON, to stdout or a file

Usage

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

Requirements

Python 3.10+, no external packages. MIT licensed.