Code Issues Releases

Releases

v1.0.0 — Initial Release

v1.0.0 · August 26, 2026

main

csv-to-json v1.0.0

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

Highlights

  • Type inference: Automatically casts CSV values to int, float, bool, or null — no manual schema needed
  • Nested key expansion: Headers with dot notation (e.g., user.address.city) become deeply nested JSON objects
  • Streaming for large files: Generator-based processing keeps memory usage constant regardless of file size
  • Flexible input: Accepts file paths, raw CSV strings, or piped stdin
  • Dual interface: Works as both a CLI tool and an importable Python library

Usage

python src/csv_converter.py data.csv -o output.json
python src/csv_converter.py data.tsv -d '\t' --expand-keys --compact
cat data.csv | python src/csv_converter.py -

Requirements

  • Python 3.10+
  • No external packages

License

MIT