csv-to-json v1.0.0

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

Features

• Zero dependencies – uses only Python's standard library
• Type inference – automatically casts numeric, boolean, and null values (e.g., "42" → 42, "true" → true, empty → null)
• Nested key expansion – dot-notation headers like user.name become nested JSON objects
• Streaming support – process large CSV files without loading entirely into memory via stream_csv_to_json
• Flexible I/O – accepts file paths, raw CSV strings, or stdin; CLI and library usage
• CLI options: custom delimiters, --no-type-inference, --expand-keys, --compact

Quick Start

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

Library

from src.csv_converter import csv_to_json
json_str = csv_to_json("data.csv")

This initial release provides a fully functional converter with comprehensive README and tests-ready structure.