---

File: README.md

# ArcoJson

A professional, feature-rich Python library for converting JSON data to CSV format with advanced capabilities.

## Features

- ✨ Convert JSON to CSV with ease
- 🔄 Handle nested JSON structures automatically
- 📊 Batch conversion support
- ✅ Data validation
- 🎨 Customizable delimiters and formatting
- 📝 Comprehensive documentation
- 🔍 Type hints for better IDE support
- ⚡ High performance

## Installation

```bash
pip install  ArcoJson

Quick Start

from ArcoJson import JSONConverter

# Create converter instance
converter = JSONConverter()

# Simple conversion
data = [
    {"name": "John", "age": 30, "city": "NYC"},
    {"name": "Jane", "age": 25, "city": "LA"}
]

converter.convert_to_csv(
    data=data,
    output_file="output.csv"
)

Advanced Usage

Handling Nested JSON

data = [
    {
        "name": "John",
        "age": 30,
        "address": {
            "city": "NYC",
            "country": "USA"
        }
    }
]

converter.convert_to_csv(
    data=data,
    output_file="output.csv",
    flatten_nested=True,
    delimiter=','
)

Batch Conversion

converter.convert_batch(
    input_files=["file1.json", "file2.json", "file3.json"],
    output_dir="output/",
    flatten_nested=True
)

Preview Before Converting

preview = converter.preview_conversion(
    data=data,
    rows=5
)
print(preview)

Documentation

Full documentation available at: Read the Docs

Contributing

Contributions are welcome! Please read our Contributing Guide.

License

MIT License - see LICENSE file for details.