Releases

csv-to-json v1.0.0

A lightweight, zero-dependency CSV-to-JSON converter built for AI agent workflows.

Features

• Type inference — automatically converts numeric strings, booleans (true/yes/false/no), and empty values to their native JSON types
• Nested key expansion — dot-notation CSV headers (e.g. user.name) become nested JSON objects
• Streaming mode — process arbitrarily large CSV files one record at a time without loading into memory
• Flexible input — accepts file paths, raw CSV strings, or piped stdin
• CLI and library — use standalone from the command line or import into Python projects
• No external dependencies — Python 3.10+ standard library only

Usage

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

License

MIT