csv-to-json v1.0.0

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

Features

• Type inference — automatically converts CSV values to appropriate JSON types (int, float, bool, null)
• Nested key expansion — dot-notation headers like 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 and library — use standalone from the command line or import as a Python module
• 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 documentation and examples.