nyaf-csvjson 1.0.0__tar.gz

nyaf_csvjson-1.0.0/PKG-INFO

@@ -0,0 +1,80 @@
+Metadata-Version: 2.4
+Name: nyaf-csvjson
+Version: 1.0.0
+Summary: Bidirectional CSV ↔ JSON converter with nested JSON support
+License: MIT
+Keywords: cli,converter,csv,json,nested
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# csvjson
+
+Bidirectional CSV ↔ JSON converter with nested JSON support — zero dependencies, pure Python.
+
+## Install
+
+```bash
+# Recommended: uv tool install (isolated, globally available)
+uv tool install csvjson
+
+# Or: pip
+pip install csvjson
+```
+
+## Usage
+
+### Interactive mode
+```bash
+csvjson
+```
+
+### File mode
+```bash
+# CSV → JSON
+csvjson csv2json input.csv
+csvjson csv2json input.csv -o output.json
+
+# JSON → CSV
+csvjson json2csv input.json
+csvjson json2csv input.json -o output.csv
+```
+
+## Nested JSON via dot-notation
+
+CSV headers with dots become nested JSON — and flatten back automatically.
+
+**Input CSV:**
+```
+name,address.city,address.zip,scores.math
+Alice,NYC,10001,95
+Bob,LA,90001,88
+```
+
+**Output JSON:**
+```json
+[
+  { "name": "Alice", "address": { "city": "NYC", "zip": 10001 }, "scores": { "math": 95 } },
+  { "name": "Bob",   "address": { "city": "LA",  "zip": 90001 }, "scores": { "math": 88 } }
+]
+```
+
+## Type coercion
+
+| CSV value        | Python type |
+|------------------|-------------|
+| `42`             | `int`       |
+| `3.14`           | `float`     |
+| `true` / `false` | `bool`      |
+| empty            | `None`      |
+| anything else    | `str`       |
+
+## Publish to PyPI
+
+```bash
+uv build    # creates dist/
+uv publish  # uploads to PyPI (needs PYPI_TOKEN)
+```
+
+## License
+
+MIT

nyaf_csvjson-1.0.0/README.md

@@ -0,0 +1,71 @@
+# csvjson
+
+Bidirectional CSV ↔ JSON converter with nested JSON support — zero dependencies, pure Python.
+
+## Install
+
+```bash
+# Recommended: uv tool install (isolated, globally available)
+uv tool install csvjson
+
+# Or: pip
+pip install csvjson
+```
+
+## Usage
+
+### Interactive mode
+```bash
+csvjson
+```
+
+### File mode
+```bash
+# CSV → JSON
+csvjson csv2json input.csv
+csvjson csv2json input.csv -o output.json
+
+# JSON → CSV
+csvjson json2csv input.json
+csvjson json2csv input.json -o output.csv
+```
+
+## Nested JSON via dot-notation
+
+CSV headers with dots become nested JSON — and flatten back automatically.
+
+**Input CSV:**
+```
+name,address.city,address.zip,scores.math
+Alice,NYC,10001,95
+Bob,LA,90001,88
+```
+
+**Output JSON:**
+```json
+[
+  { "name": "Alice", "address": { "city": "NYC", "zip": 10001 }, "scores": { "math": 95 } },
+  { "name": "Bob",   "address": { "city": "LA",  "zip": 90001 }, "scores": { "math": 88 } }
+]
+```
+
+## Type coercion
+
+| CSV value        | Python type |
+|------------------|-------------|
+| `42`             | `int`       |
+| `3.14`           | `float`     |
+| `true` / `false` | `bool`      |
+| empty            | `None`      |
+| anything else    | `str`       |
+
+## Publish to PyPI
+
+```bash
+uv build    # creates dist/
+uv publish  # uploads to PyPI (needs PYPI_TOKEN)
+```
+
+## License
+
+MIT

nyaf_csvjson-1.0.0/pyproject.toml

@@ -0,0 +1,22 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/csvjson"]
+
+[project]
+name = "nyaf-csvjson"
+version = "1.0.0"
+description = "Bidirectional CSV ↔ JSON converter with nested JSON support"
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+keywords = ["csv", "json", "converter", "cli", "nested"]
+dependencies = []
+
+[project.scripts]
+csvjson = "csvjson.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]

nyaf_csvjson-1.0.0/src/csvjson/__init__.py

@@ -0,0 +1,3 @@
+"""csvjson — bidirectional CSV ↔ JSON converter."""
+
+__version__ = "1.0.0"

nyaf_csvjson-1.0.0/src/csvjson/cli.py

@@ -0,0 +1,190 @@
+"""CLI entrypoint for csvjson."""
+
+from __future__ import annotations
+
+import argparse
+import json
+import sys
+from pathlib import Path
+
+from csvjson.core import csv_to_json, json_to_csv
+
+
+# ── Colours ───────────────────────────────────────────────────────────────────
+
+RESET  = "\033[0m"
+BOLD   = "\033[1m"
+CYAN   = "\033[36m"
+GREEN  = "\033[32m"
+YELLOW = "\033[33m"
+RED    = "\033[31m"
+DIM    = "\033[2m"
+
+
+def c(color: str, text: str) -> str:
+    return f"{color}{text}{RESET}"
+
+
+# ── Helpers ───────────────────────────────────────────────────────────────────
+
+def read_file(path: str) -> str:
+    return Path(path).read_text(encoding="utf-8")
+
+
+def write_file(path: str, content: str) -> None:
+    Path(path).write_text(content, encoding="utf-8")
+    print(c(GREEN, f"✅  Saved → {path}"))
+
+
+def save_prompt(content: str) -> None:
+    ans = input(f"\n{YELLOW}Save to file? (Enter filename or press Enter to skip): {RESET}").strip()
+    if ans:
+        write_file(ans, content)
+
+
+def read_multiline(prompt: str) -> str:
+    print(c(DIM, f"{prompt} (type END on a new line when done)"))
+    lines = []
+    while True:
+        line = input()
+        if line.strip() == "END":
+            break
+        lines.append(line)
+    return "\n".join(lines)
+
+
+def show_examples() -> None:
+    print(f"""
+{BOLD}── CSV with flat keys ──────────────────────────────{RESET}
+name,age,city
+Alice,30,NYC
+Bob,25,LA
+
+{BOLD}↓  CSV → JSON:{RESET}
+[
+  {{"name": "Alice", "age": 30, "city": "NYC"}},
+  {{"name": "Bob",   "age": 25, "city": "LA" }}
+]
+
+{BOLD}── CSV with nested (dot-notation) keys ─────────────{RESET}
+name,address.city,address.zip,scores.math
+Alice,NYC,10001,95
+Bob,LA,90001,88
+
+{BOLD}↓  CSV → JSON:{RESET}
+[
+  {{"name":"Alice","address":{{"city":"NYC","zip":10001}},"scores":{{"math":95}}}},
+  {{"name":"Bob",  "address":{{"city":"LA", "zip":90001}},"scores":{{"math":88}}}}
+]
+
+{BOLD}── JSON → CSV flattens nested keys automatically ───{RESET}
+""")
+
+
+# ── Arg mode ──────────────────────────────────────────────────────────────────
+
+def run_arg_mode(args: argparse.Namespace) -> None:
+    raw = read_file(args.input)
+
+    if args.command == "csv2json":
+        result = json.dumps(csv_to_json(raw), indent=2, ensure_ascii=False)
+    else:
+        result = json_to_csv(json.loads(raw))
+
+    if args.output:
+        write_file(args.output, result)
+    else:
+        print(result)
+
+
+# ── Interactive mode ──────────────────────────────────────────────────────────
+
+def run_interactive() -> None:
+    print(f"""
+{CYAN}{BOLD}╔══════════════════════════════════════╗
+║    CSV ↔ JSON Bidirectional Tool     ║
+╚══════════════════════════════════════╝{RESET}
+{DIM}Supports nested JSON via dot-notation keys{RESET}
+""")
+
+    while True:
+        print(f"""{BOLD}What do you want to do?{RESET}
+  {CYAN}1{RESET}  CSV  → JSON  (from file)
+  {CYAN}2{RESET}  JSON → CSV   (from file)
+  {CYAN}3{RESET}  CSV  → JSON  (paste inline)
+  {CYAN}4{RESET}  JSON → CSV   (paste inline)
+  {CYAN}5{RESET}  Show examples
+  {CYAN}q{RESET}  Quit
+""")
+        choice = input(f"{CYAN}> {RESET}").strip()
+
+        if choice == "q":
+            print(c(DIM, "\nBye!\n"))
+            break
+
+        try:
+            if choice in ("1", "2"):
+                path = input(f"{YELLOW}Enter file path: {RESET}").strip()
+                raw = read_file(path)
+                if choice == "1":
+                    result = json.dumps(csv_to_json(raw), indent=2, ensure_ascii=False)
+                    print(f"\n{GREEN}{BOLD}── JSON Output ──{RESET}\n{result}\n")
+                else:
+                    result = json_to_csv(json.loads(raw))
+                    print(f"\n{GREEN}{BOLD}── CSV Output ──{RESET}\n{result}\n")
+                save_prompt(result)
+
+            elif choice == "3":
+                raw = read_multiline("Paste your CSV")
+                result = json.dumps(csv_to_json(raw), indent=2, ensure_ascii=False)
+                print(f"\n{GREEN}{BOLD}── JSON Output ──{RESET}\n{result}\n")
+                save_prompt(result)
+
+            elif choice == "4":
+                raw = read_multiline("Paste your JSON")
+                result = json_to_csv(json.loads(raw))
+                print(f"\n{GREEN}{BOLD}── CSV Output ──{RESET}\n{result}\n")
+                save_prompt(result)
+
+            elif choice == "5":
+                show_examples()
+
+            else:
+                print(c(RED, "Invalid choice.\n"))
+
+        except FileNotFoundError as e:
+            print(c(RED, f"File not found: {e}\n"))
+        except (json.JSONDecodeError, ValueError) as e:
+            print(c(RED, f"Parse error: {e}\n"))
+        except KeyboardInterrupt:
+            print(c(DIM, "\n\nBye!\n"))
+            break
+
+
+# ── Entry point ───────────────────────────────────────────────────────────────
+
+def main() -> None:
+    if len(sys.argv) < 2:
+        run_interactive()
+        return
+
+    parser = argparse.ArgumentParser(
+        prog="csvjson",
+        description="Bidirectional CSV ↔ JSON converter with nested JSON support",
+    )
+    sub = parser.add_subparsers(dest="command", required=True)
+
+    for cmd, help_text in [
+        ("csv2json", "Convert CSV file to JSON"),
+        ("json2csv", "Convert JSON file to CSV"),
+    ]:
+        p = sub.add_parser(cmd, help=help_text)
+        p.add_argument("input", help="Input file path")
+        p.add_argument("-o", "--output", help="Output file path (default: stdout)")
+
+    args = parser.parse_args()
+    run_arg_mode(args)
+
+
+if __name__ == "__main__":
+    main()

nyaf_csvjson-1.0.0/src/csvjson/core.py

@@ -0,0 +1,95 @@
+"""Core bidirectional CSV ↔ JSON conversion with nested support."""
+
+from __future__ import annotations
+
+import csv
+import io
+import json
+
+
+# ── Nested helpers ────────────────────────────────────────────────────────────
+
+def _set_nested(obj: dict, dot_key: str, value: str) -> None:
+    """Set 'address.city' = 'NYC' as nested keys on obj."""
+    keys = dot_key.split(".")
+    cur = obj
+    for key in keys[:-1]:
+        cur = cur.setdefault(key, {})
+    cur[keys[-1]] = _coerce(value)
+
+
+def _coerce(value: str):
+    """Convert CSV string to the most appropriate Python type."""
+    if value == "":
+        return None
+    if value.lower() == "true":
+        return True
+    if value.lower() == "false":
+        return False
+    try:
+        as_int = int(value)
+        # avoid coercing strings like "007" or "1e5"
+        if str(as_int) == value:
+            return as_int
+    except ValueError:
+        pass
+    try:
+        return float(value)
+    except ValueError:
+        pass
+    return value
+
+
+def _flatten(obj: dict, prefix: str = "", result: dict | None = None) -> dict:
+    """Flatten {'address': {'city': 'NYC'}} → {'address.city': 'NYC'}."""
+    if result is None:
+        result = {}
+    for k, v in obj.items():
+        key = f"{prefix}.{k}" if prefix else k
+        if isinstance(v, dict):
+            _flatten(v, key, result)
+        elif isinstance(v, list):
+            result[key] = json.dumps(v)
+        else:
+            result[key] = "" if v is None else str(v)
+    return result
+
+
+# ── CSV → JSON ────────────────────────────────────────────────────────────────
+
+def csv_to_json(text: str) -> list[dict]:
+    """Parse CSV text into a list of (possibly nested) dicts."""
+    reader = csv.DictReader(io.StringIO(text.strip()))
+    rows = []
+    for raw_row in reader:
+        obj: dict = {}
+        for key, value in raw_row.items():
+            _set_nested(obj, key.strip(), value or "")
+        rows.append(obj)
+    return rows
+
+
+# ── JSON → CSV ────────────────────────────────────────────────────────────────
+
+def json_to_csv(data: list | dict) -> str:
+    """Serialize a list of dicts (or a single dict) to CSV text."""
+    if isinstance(data, dict):
+        data = [data]
+    if not data:
+        return ""
+
+    flat_rows = [_flatten(row) for row in data]
+
+    # Union of all headers, preserving first-seen order
+    seen: dict[str, None] = {}
+    for row in flat_rows:
+        seen.update(dict.fromkeys(row))
+    headers = list(seen)
+
+    output = io.StringIO()
+    writer = csv.DictWriter(output, fieldnames=headers, extrasaction="ignore", lineterminator="\n")
+    writer.writeheader()
+    for row in flat_rows:
+        writer.writerow({h: row.get(h, "") for h in headers})
+
+    return output.getvalue()

nyaf_csvjson-1.0.0/src/csvjson.egg-info/PKG-INFO

@@ -0,0 +1,80 @@
+Metadata-Version: 2.4
+Name: csvjson
+Version: 1.0.0
+Summary: Bidirectional CSV ↔ JSON converter with nested JSON support
+License: MIT
+Keywords: csv,json,converter,cli,nested
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# csvjson
+
+Bidirectional CSV ↔ JSON converter with nested JSON support — zero dependencies, pure Python.
+
+## Install
+
+```bash
+# Recommended: uv tool install (isolated, globally available)
+uv tool install csvjson
+
+# Or: pip
+pip install csvjson
+```
+
+## Usage
+
+### Interactive mode
+```bash
+csvjson
+```
+
+### File mode
+```bash
+# CSV → JSON
+csvjson csv2json input.csv
+csvjson csv2json input.csv -o output.json
+
+# JSON → CSV
+csvjson json2csv input.json
+csvjson json2csv input.json -o output.csv
+```
+
+## Nested JSON via dot-notation
+
+CSV headers with dots become nested JSON — and flatten back automatically.
+
+**Input CSV:**
+```
+name,address.city,address.zip,scores.math
+Alice,NYC,10001,95
+Bob,LA,90001,88
+```
+
+**Output JSON:**
+```json
+[
+  { "name": "Alice", "address": { "city": "NYC", "zip": 10001 }, "scores": { "math": 95 } },
+  { "name": "Bob",   "address": { "city": "LA",  "zip": 90001 }, "scores": { "math": 88 } }
+]
+```
+
+## Type coercion
+
+| CSV value        | Python type |
+|------------------|-------------|
+| `42`             | `int`       |
+| `3.14`           | `float`     |
+| `true` / `false` | `bool`      |
+| empty            | `None`      |
+| anything else    | `str`       |
+
+## Publish to PyPI
+
+```bash
+uv build    # creates dist/
+uv publish  # uploads to PyPI (needs PYPI_TOKEN)
+```
+
+## License
+
+MIT

nyaf_csvjson-1.0.0/src/csvjson.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+README.md
+pyproject.toml
+src/csvjson/__init__.py
+src/csvjson/cli.py
+src/csvjson/core.py
+src/csvjson.egg-info/PKG-INFO
+src/csvjson.egg-info/SOURCES.txt
+src/csvjson.egg-info/dependency_links.txt
+src/csvjson.egg-info/entry_points.txt
+src/csvjson.egg-info/top_level.txt

nyaf_csvjson-1.0.0/src/csvjson.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

nyaf_csvjson-1.0.0/src/csvjson.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+csvjson = csvjson.cli:main

nyaf_csvjson-1.0.0/src/csvjson.egg-info/top_level.txt

@@ -0,0 +1 @@
+csvjson

nyaf_csvjson-1.0.0/test.py

@@ -0,0 +1,81 @@
+"""Tests for csvjson core logic."""
+
+import json
+import sys
+import os
+
+sys.path.insert(0, os.path.join(os.path.dirname(__file__), "src"))
+
+from csvjson.core import csv_to_json, json_to_csv
+
+passed = 0
+failed = 0
+
+def test(name, fn):
+    global passed, failed
+    try:
+        fn()
+        print(f"  ✅  {name}")
+        passed += 1
+    except AssertionError as e:
+        print(f"  ❌  {name}: {e}")
+        failed += 1
+
+FLAT_CSV = "name,age,city\nAlice,30,NYC\nBob,25,LA"
+NESTED_CSV = "name,address.city,address.zip,scores.math\nAlice,NYC,10001,95\nBob,LA,90001,88"
+
+print("\nRunning tests...\n")
+
+def test_flat_types():
+    out = csv_to_json(FLAT_CSV)
+    assert out[0]["name"] == "Alice"
+    assert out[0]["age"] == 30, f"expected int 30, got {out[0]['age']!r}"
+    assert out[1]["city"] == "LA"
+
+def test_nested_csv_to_json():
+    out = csv_to_json(NESTED_CSV)
+    assert out[0]["address"]["city"] == "NYC"
+    assert out[0]["address"]["zip"] == 10001
+    assert out[0]["scores"]["math"] == 95
+
+def test_json_to_csv_flat():
+    data = [{"name": "Alice", "age": 30}, {"name": "Bob", "age": 25}]
+    out = json_to_csv(data)
+    assert "name,age" in out
+    assert "Alice,30" in out
+
+def test_json_to_csv_nested():
+    data = [{"name": "Alice", "address": {"city": "NYC", "zip": 10001}}]
+    out = json_to_csv(data)
+    assert "address.city" in out
+    assert "NYC" in out
+
+def test_roundtrip():
+    original = csv_to_json(NESTED_CSV)
+    csv_out = json_to_csv(original)
+    back = csv_to_json(csv_out)
+    assert back[0]["address"]["city"] == "NYC"
+    assert back[1]["scores"]["math"] == 88
+
+def test_type_coercion():
+    csv_text = "flag,value,empty\ntrue,3.14,"
+    out = csv_to_json(csv_text)
+    assert out[0]["flag"] is True
+    assert out[0]["value"] == 3.14
+    assert out[0]["empty"] is None
+
+def test_single_object_json():
+    out = json_to_csv({"name": "Alice", "age": 30})
+    assert "Alice" in out
+
+test("flat CSV → JSON: type coercion", test_flat_types)
+test("nested CSV → JSON: nesting works", test_nested_csv_to_json)
+test("JSON → CSV: flat output", test_json_to_csv_flat)
+test("JSON → CSV: nested flattened", test_json_to_csv_nested)
+test("roundtrip CSV → JSON → CSV", test_roundtrip)
+test("type coercion: bool, float, None", test_type_coercion)
+test("single dict (not list) input", test_single_object_json)
+
+print(f"\n{passed} passed, {failed} failed\n")
+if failed:
+    sys.exit(1)

nyaf_csvjson-1.0.0/uv.lock

@@ -0,0 +1,8 @@
+version = 1
+revision = 3
+requires-python = ">=3.9"
+
+[[package]]
+name = "csvjson"
+version = "1.0.0"
+source = { editable = "." }