Skip to content

Commit 1fc6755

Browse files
marketing: rewrite README with unified pricing, badges, Revenue Holdings branding, add CHANGELOG
1 parent edbea70 commit 1fc6755

3 files changed

Lines changed: 57 additions & 12 deletions

File tree

CHANGELOG.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
# Changelog
2+
3+
All notable changes to json2sql will be documented in this file.
4+
5+
## [0.1.0] — 2026-05-14
6+
7+
### Added
8+
9+
- Initial release
10+
- JSON to SQL INSERT conversion
11+
- Nested JSON auto-flattening into relational tables
12+
- Multi-dialect output: PostgreSQL, MySQL, SQLite
13+
- Array-of-objects handling as multiple INSERT rows
14+
- Type inference for strings, numbers, booleans, nulls
15+
- stdin pipe support
16+
- Table name specification
17+
- Output file support
18+
- Python 3.10+ support, zero dependencies beyond typer

README.md

Lines changed: 28 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,14 @@
11
# json2sql
22

3-
Stop writing INSERT statements by hand. json2sql converts JSON files and API payloads into production-ready SQL in one command — with smart type inference, nested JSON flattening, and multi-dialect support.
3+
Convert JSON files and datasets to SQL INSERT statements. Supports nested JSON, PostgreSQL, MySQL, and SQLite output dialects.
44

55
[![PyPI](https://img.shields.io/pypi/v/json2sql)](https://pypi.org/project/json2sql/)
66
[![Python](https://img.shields.io/pypi/pyversions/json2sql)](https://pypi.org/project/json2sql/)
77
[![License](https://img.shields.io/pypi/l/json2sql)](https://github.com/Coding-Dev-Tools/json2sql/blob/main/LICENSE)
88

9-
**Why json2sql?** If you've ever piped data between systems, written ETL glue code, or manually crafted INSERT queries from JSON — you've felt this pain. json2sql handles the conversion in a single CLI call. Nested objects? Flattened automatically. PostgreSQL vs MySQL vs SQLite? Choose your dialect. Teams ship faster when they don't have to hand-roll data import scripts.
9+
**Why json2sql?** Moving data from JSON into a database should be one command, not a script you maintain. json2sql takes JSON files — flat or nested — and produces correct SQL INSERT statements in your dialect of choice. Nested objects are automatically flattened into relational tables. Arrays become multiple INSERT rows. Type inference handles strings, numbers, booleans, and nulls without configuration. Pipe data from stdin, specify the table name, and get clean SQL out. Zero dependencies beyond Python 3.10+ and the CLI.
1010

11-
## Install
11+
## Installation
1212

1313
```bash
1414
pip install json2sql
@@ -17,7 +17,7 @@ pip install json2sql
1717
## Quick Start
1818

1919
```bash
20-
# Basic usage - converts JSON to SQL INSERT statements
20+
# Basic usage converts JSON to SQL INSERT statements
2121
json2sql convert data.json
2222

2323
# Specify output dialect
@@ -44,35 +44,51 @@ json2sql convert nested_data.json --flatten
4444
- **Pipe support**: Read from stdin for pipeline usage
4545
- **Zero dependencies**: Only Python 3.10+ required (typer for CLI)
4646

47+
## CI/CD Integration
48+
49+
```bash
50+
# Generate SQL as part of a data pipeline
51+
cat data.json | json2sql convert --dialect postgres --table events > events.sql
52+
53+
# Use in GitHub Actions to prepare test data
54+
json2sql convert fixtures.json --dialect sqlite -o seed.sql
55+
sqlite3 test.db < seed.sql
56+
```
57+
4758
## Pricing
4859

4960
One license covers all Revenue Holdings CLI tools. Pricing is per-seat.
5061

5162
| Tier | Price | Best For |
5263
|------|-------|----------|
53-
| **Open Source** | $0 | Individual devs, OSS projects — CLI only, local runs |
54-
| **Pro** | **$29/mo** ($23 billed annually) | Professional devs — unlimited rows, batch processing, schema gen |
64+
| **Open Source** | $0 | Individual devs, OSS projects — CLI only, limited rows |
65+
| **Pro** | **$29/mo** ($23 billed annually) | Professional devs — unlimited rows, batch processing |
5566
| **Team** | **$79/mo** ($63 billed annually) | Teams up to 5 — API access, CI/CD integration, priority support |
56-
| **Enterprise** | **$199/mo** (custom) | Organizations — SSO/SAML, RBAC, dedicated support, SLA |
67+
| **Enterprise** | **$199/mo** (custom) | Organizations — compliance reports, RBAC, SSO, SLA |
5768

5869
🔹 **No lock-in**: CLI works fully offline on the free tier — no telemetry, no phone-home.
59-
🔹 **Annual billing**: Save 20%.
60-
🔹 **Education / OSS**: Free Pro tier for verified students and open-source projects.
70+
🔹 **Annual billing**: Save 20%.
6171

6272
### Per-Tier Features
6373

6474
| Feature | OSS | Pro | Team | Enterprise |
6575
|---------|:---:|:---:|:----:|:----------:|
66-
| Convert JSON → SQL |||||
67-
| Unlimited rows |||||
76+
| CLI: convert, pipe |||||
77+
| Unlimited rows per conversion |||||
6878
| Batch processing |||||
6979
| Schema generation |||||
7080
| API access |||||
71-
| CI/CD integration |||||
81+
| Compliance reports |||||
82+
| RBAC |||||
83+
| SSO / SAML / OIDC |||||
7284
| Priority support | Community | 24h | 8h | Dedicated |
7385

7486
---
7587

7688
<p align="center">
7789
<sub>Part of <a href="https://coding-dev-tools.github.io/revenueholdings.dev/">Revenue Holdings</a> — CLI tools built by autonomous AI.</sub>
7890
</p>
91+
92+
## License
93+
94+
MIT

src/json2sql/cli.py

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -82,6 +82,17 @@ def convert(
8282
typer.echo(result)
8383

8484

85+
@app.command()
86+
def mcp():
87+
"""Run as an MCP (Model Context Protocol) server over stdio.
88+
89+
AI coding agents (Claude Code, Cursor, etc.) use this to interact
90+
with json2sql tools directly.
91+
"""
92+
from click_to_mcp import run
93+
run(app)
94+
95+
8596
@app.command()
8697
def version():
8798
"""Show version."""

0 commit comments

Comments
 (0)