Releases

csv-to-json v1.0.0

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

Features

• Type inference: Automatically casts CSV string values to appropriate Python/JSON types (int, float, bool, null)
• Nested key expansion: Dot-notation headers like user.name are expanded into nested JSON objects
• Streaming mode: Process large CSV files record-by-record via a generator, without loading the entire file into memory
• Flexible input: Accepts file paths, raw CSV strings, or stdin streams
• Custom delimiters: Support for tabs, pipes, semicolons, or any single-character delimiter
• CLI and library usage: Works as a standalone command-line tool or as an importable Python module

Usage

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

Requirements

• Python 3.10+
• No external dependencies (stdlib only)

License

MIT