csv-to-json v1.0.0

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

What it does

Converts CSV data to structured JSON with these capabilities:

• Type inference — automatically casts numeric, boolean, and null values from string CSV cells
• Nested key expansion — dot-notation headers (e.g. user.name) become nested JSON objects
• Streaming mode — processes large files row-by-row without loading everything into memory
• Flexible input — accepts file paths, raw CSV strings, or stdin pipes
• CLI + library — use standalone from the command line or import as a Python module

Usage

python src/csv_converter.py data.csv -o output.json

from src.csv_converter import csv_to_json
result = csv_to_json("data.csv", expand_keys=True)

Requirements

• Python 3.10+
• No external packages needed

Full documentation in README.md.