Skip to main content

A CLI tool to convert files to/from JSON efficiently with large file support

Project description

🔄 Universal JSON Converter CLI

Convert files to/from JSON effortlessly — with streaming support for large datasets! 🚀📈

Universal JSON Converter Logo

Python License Platform Open Source File Size Limit PyPI version Stars


✨ Features

✅ Supports bi-directional conversion:

  • .csv, .jsonl, .xml, .xlsx, .yaml, .parquet.json
  • .json.csv, .jsonl, .xlsx, .yaml, .parquet

🧠 Optimized for large files with:

  • Streaming (for JSONL)
  • Chunked processing (for CSV & Excel)

💪 No file size limits — convert files of gigabytes or even terabytes as long as your hardware supports it.

🔧 Built as a lightweight CLI tool — no GUI needed

📂 Easy folder management & file safety

📦 Installable via pip or GitHub repo


🔧 Installation Guide

📦 Option 1: Install via pip (Recommended)

pip install universal-json-converter

Then run it from any terminal:

ujconvert tojson yourfile.csv output_folder/

💡 Make sure your Python is version 3.7 or above.


🖥 Option 2: Run from GitHub (Developer Mode)

🖥 Windows / macOS / Linux

1. Clone the Repository:

git clone https://github.com/your-username/universal-json-converter.git
cd universal-json-converter

2. Install Requirements:

pip install -r requirements.txt

3. Run from terminal:

python main.py tojson path/to/input.csv output_folder/

🧠 This mode is great for editing or contributing to the tool.


💻 CLI Usage

🔄 Convert TO JSON

ujconvert tojson path/to/input_file.csv output_folder/

🔁 Convert FROM JSON

ujconvert fromjson path/to/input_file.json path/to/output_file.csv csv

📌 Supported formats: csv, jsonl, yaml, xls, xlsx, parquet


🧠 Practical Applications

This tool is perfect for:

📊 Data Science & Machine Learning

  • Preprocessing raw CSV/Excel/JSONL data to feed into ML models
  • Generating JSON configs and structured logs

🔍 Big Data Analytics

  • Handling multi-GB to terabyte-scale files using chunking or streaming

📁 Data Engineering

  • Simplifying ingestion pipelines with standard formats

🧪 ETL Automation

  • Format normalization in scripts and cron jobs

📈 Visualization & Dashboards

  • Easy input conversion for tools like Plotly, Dash, and Streamlit

❤️ Support & Customization

This tool is open source and free to use, but if you'd like:

  • A custom version for your organization
  • A web GUI/API integration
  • Help integrating it into your data pipeline

📩 Email me at: siddharthlal99@gmail.com


🌍 Share & Credit

If you use this project, please ⭐ it on GitHub and link to:

Built using Universal JSON Converter by Siddharth Lal
https://github.com/Siddharth-lal-13/universal-json-converter

📄 License

MIT License – You're free to use, modify, and share with proper credit.

Please give credit if you use it publicly. For commercial licensing or collaboration, email me.


👤 Author

Developed by Siddharth Lal

🤝 I'm open to collaboration, internships, remote freelance/contract and research work!

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

universal_json_converter-1.0.0.tar.gz (6.0 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

universal_json_converter-1.0.0-py3-none-any.whl (5.9 kB view details)

Uploaded Python 3

File details

Details for the file universal_json_converter-1.0.0.tar.gz.

File metadata

  • Download URL: universal_json_converter-1.0.0.tar.gz
  • Upload date:
  • Size: 6.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.10.10

File hashes

Hashes for universal_json_converter-1.0.0.tar.gz
Algorithm Hash digest
SHA256 ee5abda78abbbcbe56c04e0b6179fd108a75639b061b31e37d5e8bb3873bc394
MD5 a807472113e763adc5793bf19bdedff0
BLAKE2b-256 4f15d31056e76b8fb05dc589a534b2fa8a3272580cc77d27c9faab3402d70bd1

See more details on using hashes here.

File details

Details for the file universal_json_converter-1.0.0-py3-none-any.whl.

File metadata

File hashes

Hashes for universal_json_converter-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 908b4e3a5d8f132732c423e92d2813fac0aa13235b3c3bdf6ec5574a071084e2
MD5 d72e2c3e4fda1f434bd6f954516518bc
BLAKE2b-256 a643d1c49682083fdf2190721e8fdb63ead658ff44b786ce9072deda7160e69b

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page