Releases

First stable release of csv-to-json, a lightweight, dependency-free CSV-to-JSON converter built on Python's standard library.

What it does

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

Highlights

• Type inference — numeric, boolean (true/yes, false/no), and empty values become native JSON number/boolean/null
• Nested key expansion — dot-notation headers like user.address.city expand into nested JSON objects (--expand-keys)
• Streaming mode — stream_csv_to_json() yields records one at a time for large files without loading everything into memory
• Flexible input — file path, raw CSV string, or stdin; custom delimiters via -d
• Output options — pretty-printed (default) or --compact minified JSON, to stdout or a file (-o)

Requirements

Python 3.10+, no external packages.

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