A lightweight and efficient JSON to CSV converter written in Go. It reads a JSON array of objects, dynamically extracts headers, and writes correct tabular CSV output—ideal for data processing workflows and automation scripts.

1. Overview
2. Features
3. Requirements
4. Installation
5. Usage
6. Code Structure
7. Error Handling
8. Contributing
9. License

This Go-based CLI tool—complete with reusable package code—automatically:

• Finds the first JSON file in the working directory
• Parses it into a slice of Go maps
• Extracts dynamic headers from keys
• Converts and exports as a .csv file
• Supports both direct go run usage and go build for installing the binary :contentReference[oaicite:1]{index=1}

• 🔍 Auto-detection: Identifies the first .json file in the directory :contentReference[oaicite:2]{index=2}
• 🧩 Dynamic Headers: Builds CSV headers based on JSON keys from first entry :contentReference[oaicite:3]{index=3}
• 💾 CSV Export: Writes a .csv file with the same base name as input :contentReference[oaicite:4]{index=4}
• 🚫 Handles Missing Fields: Missing keys render as empty CSV values :contentReference[oaicite:5]{index=5}
• 🚨 Error Reporting: Simple messages for missing files or malformed JSON :contentReference[oaicite:6]{index=6}

• Go 1.18+ (modules enabled)
• No external dependencies—uses Go standard encoding/json and encoding/csv

git clone https://github.com/MisaghMomeniB/JSON2CSV-Go.git
cd JSON2CSV-Go/src
go build -o json2csv main.go

go run src/main.go

Place a JSON file (array of objects) in your folder and execute:

# e.g. data.json → data.csv
./json2csv

The tool reads *.json, converts it to CSV, and writes *.csv.

JSON2CSV-Go/
├── src/
│   └── main.go         # CLI entrypoint and conversion logic
├── README.md           # This file
└── LICENSE             # MIT License

• main.go:

  • Finds JSON file via filepath.Glob("*.json")
  • Loads JSON into []map[string]interface{}
  • Extracts keys from first element
  • Outputs CSV using encoding/csv

• Exits with a message if no JSON files found
• Reports parsing errors for invalid JSON
• Gracefully handles write failures

Improvements welcome! Consider adding:

• Support for nested JSON arrays or pointers
• CLI flags (e.g., custom file paths, headers)
• Batch file processing

To contribute:

1. Fork the repo
2. Create a feature branch
3. Submit a PR with clear descriptions

Distributed under the MIT License. See LICENSE for details.