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 converts CSV values to int, float, bool, or null
• 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 into memory
• Flexible input: Accepts file paths, raw CSV strings, or stdin
• CLI and library: Use from the command line or import as a Python module
• Zero dependencies: Uses only Python 3.10+ standard library

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")