csv-to-json v1.0.0

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

Highlights

• Type inference — automatically casts CSV values to int, float, bool, or null
• Nested key expansion — dot-notation headers (e.g. user.name) become nested JSON objects
• Streaming mode — process large CSV files record-by-record without loading into memory
• Flexible input — accepts file paths, raw CSV strings, or stdin
• CLI + library — use standalone from the command line or import into Python projects
• No external dependencies — pure Python 3.10+ standard library

Usage

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

See README.md for full API documentation and examples.