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 agent and developer workflows.

Features

  • Type inference — automatically converts CSV string values to integers, floats, booleans, and nulls
  • Nested key expansion — dot-notation headers (e.g., user.name) become nested JSON objects
  • Streaming support — process large CSV files record-by-record without loading everything into memory
  • Flexible input — accepts file paths, raw CSV strings, or stdin pipes
  • CLI and library usage — use standalone from the command line or import as a Python module
  • Zero external dependencies — relies only on 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
from src.csv_converter import csv_to_json
result = csv_to_json("data.csv", type_inference=True, expand_keys=True)

License

MIT