json-shaper-lite 1.0.0__tar.gz

json_shaper_lite-1.0.0/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Changelog
+
+What changed in json-shaper-lite, newest first.
+
+## 1.0.0 - 2026-11-04
+
+- First release.
+- Turns `key: value` notes, CSV/TSV and Markdown tables into JSON. Numbers, yes/no and empty values get the right type.
+- `--json` gives one clean object for scripts and AI agents. `--quiet` hides the tip line.
+- You can install it from PyPI with `pip install json-shaper-lite`.
+- Needs Python 3.10 or newer.

json_shaper_lite-1.0.0/LICENSE

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2026 tidybyte
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

json_shaper_lite-1.0.0/MANIFEST.in

@@ -0,0 +1,2 @@
+include CHANGELOG.md
+include llms.txt

json_shaper_lite-1.0.0/PKG-INFO

@@ -0,0 +1,133 @@
+Metadata-Version: 2.4
+Name: json-shaper-lite
+Version: 1.0.0
+Summary: Turn key: value notes, CSV/TSV and Markdown tables into clean, typed JSON. No dependencies.
+Author: Tidy Byte Tools
+License-Expression: MIT
+Project-URL: Homepage, https://tidybyte.gumroad.com/l/cznmeo
+Project-URL: Source, https://github.com/tidybytetools/json-shaper-lite
+Project-URL: Issues, https://github.com/tidybytetools/json-shaper-lite/issues
+Project-URL: Changelog, https://github.com/tidybytetools/json-shaper-lite/blob/main/CHANGELOG.md
+Keywords: json,csv,tsv,markdown,markdown-table,converter,text-to-json,cli
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Text Processing
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# json-shaper-lite
+
+[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/tidybytetools/json-shaper-lite/blob/main/LICENSE)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/)
+[![No dependencies](https://img.shields.io/badge/dependencies-none-brightgreen.svg)](https://github.com/tidybytetools/json-shaper-lite/blob/main/json_shaper_lite.py)
+
+Free tool that turns `key: value` notes, CSV/TSV and Markdown tables into clean JSON.
+Need app logs or US addresses parsed too? The paid version does that: **[json-shaper on Gumroad](https://tidybyte.gumroad.com/l/cznmeo)**
+
+One Python file, no dependencies, MIT license. Works with Python 3.10 and newer, on Windows, Mac and Linux.
+
+## Install
+
+```
+pip install json-shaper-lite
+```
+
+Or use pipx, which keeps it in its own space:
+
+```
+pipx install json-shaper-lite
+```
+
+Want the newest code from GitHub instead?
+
+```
+pip install git+https://github.com/tidybytetools/json-shaper-lite
+```
+
+Or just download `json_shaper_lite.py` and run it with `python3`.
+
+## Use it
+
+```
+printf 'Name: Ada\nAge: 36\nActive: yes' | json-shaper-lite
+json-shaper-lite export.csv
+json-shaper-lite notes.md --format markdown
+json-shaper-lite export.csv --json      # {"ok": true, "format": "csv", "data": [...]}
+```
+
+Output:
+
+```json
+{"name": "Ada", "age": 36, "active": true}
+```
+
+Numbers come out as numbers, yes/no and true/false as booleans, and empty or "null" as null. The format is detected for you, or you can set it with `--format kv|csv|markdown`.
+
+From Python:
+
+```python
+from json_shaper_lite import shape
+shape("x,y\n1,2")  # {'format': 'csv', 'data': [{'x': 1, 'y': 2}]}
+```
+
+When you run it in a terminal it prints one short line about the paid version to stderr after the result. It never goes into your JSON output, it only shows when you are looking at a terminal, and `--quiet` turns it off.
+
+## Known limits
+
+- **It makes flat JSON.** It does not flatten or unflatten nested JSON. For that, use a tool like flatten-json.
+- **Types are a best guess.** A value like `007` or a zip code can turn into a number. Fix those by hand after.
+- **One table per run.** Two Markdown tables in one file get mixed together. Split them first.
+- **No app logs or addresses.** Those are in the paid version.
+
+## How it compares to other free tools
+
+| | json-shaper-lite | [flatten-json](https://pypi.org/project/flatten-json/) | csvkit `csvjson` | pandas |
+|---|---|---|---|---|
+| Main job | messy text → JSON | nested JSON → flat (and back) | CSV → JSON | full data toolkit |
+| Install size | one file, no deps | small | medium | large |
+| `key: value` notes | yes | no | no | no |
+| Markdown tables | yes | no | no | no, not built in |
+| CSV/TSV | yes | no | yes | yes |
+| Guesses numbers and true/false | yes | no | yes | yes |
+| Nested JSON flatten/unflatten | no | yes | no | yes (`json_normalize`) |
+
+If your data is already JSON and just too nested, flatten-json is the better pick.
+
+## For AI agents
+
+- **Use when:** you have plain text in `key: value` lines, CSV/TSV, or a Markdown table and need typed JSON.
+- **Don't use when:** the input is already JSON, it's app logs, or it's nested data. Use the paid version for logs.
+- **Input:** text on stdin or a file path. Optional `--format kv|csv|markdown`.
+- **Output:** with `--json`, one object: `{"ok": true, "format": "csv", "data": [...]}`. On error `ok` is false. Exit code 0 ok, 1 error.
+- Hint lines go to stderr only, and only in a terminal, so stdout is always clean JSON. See also [`llms.txt`](https://github.com/tidybytetools/json-shaper-lite/blob/main/llms.txt).
+
+## Lite vs paid
+
+| | lite (free) | [json-shaper](https://tidybyte.gumroad.com/l/cznmeo) |
+|---|---|---|
+| key: value notes, CSV/TSV, Markdown tables | yes | yes |
+| App logs (timestamp, level, message, key=value fields) | no | yes |
+| One-line US address splitter | no | yes |
+| `tool.json` manifest for scripts and AI agents | no | yes |
+
+## Tests
+
+```
+python3 -m unittest discover tests
+```
+
+## License
+
+MIT. See `LICENSE`.

json_shaper_lite-1.0.0/README.md

@@ -0,0 +1,104 @@
+# json-shaper-lite
+
+[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/tidybytetools/json-shaper-lite/blob/main/LICENSE)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/)
+[![No dependencies](https://img.shields.io/badge/dependencies-none-brightgreen.svg)](https://github.com/tidybytetools/json-shaper-lite/blob/main/json_shaper_lite.py)
+
+Free tool that turns `key: value` notes, CSV/TSV and Markdown tables into clean JSON.
+Need app logs or US addresses parsed too? The paid version does that: **[json-shaper on Gumroad](https://tidybyte.gumroad.com/l/cznmeo)**
+
+One Python file, no dependencies, MIT license. Works with Python 3.10 and newer, on Windows, Mac and Linux.
+
+## Install
+
+```
+pip install json-shaper-lite
+```
+
+Or use pipx, which keeps it in its own space:
+
+```
+pipx install json-shaper-lite
+```
+
+Want the newest code from GitHub instead?
+
+```
+pip install git+https://github.com/tidybytetools/json-shaper-lite
+```
+
+Or just download `json_shaper_lite.py` and run it with `python3`.
+
+## Use it
+
+```
+printf 'Name: Ada\nAge: 36\nActive: yes' | json-shaper-lite
+json-shaper-lite export.csv
+json-shaper-lite notes.md --format markdown
+json-shaper-lite export.csv --json      # {"ok": true, "format": "csv", "data": [...]}
+```
+
+Output:
+
+```json
+{"name": "Ada", "age": 36, "active": true}
+```
+
+Numbers come out as numbers, yes/no and true/false as booleans, and empty or "null" as null. The format is detected for you, or you can set it with `--format kv|csv|markdown`.
+
+From Python:
+
+```python
+from json_shaper_lite import shape
+shape("x,y\n1,2")  # {'format': 'csv', 'data': [{'x': 1, 'y': 2}]}
+```
+
+When you run it in a terminal it prints one short line about the paid version to stderr after the result. It never goes into your JSON output, it only shows when you are looking at a terminal, and `--quiet` turns it off.
+
+## Known limits
+
+- **It makes flat JSON.** It does not flatten or unflatten nested JSON. For that, use a tool like flatten-json.
+- **Types are a best guess.** A value like `007` or a zip code can turn into a number. Fix those by hand after.
+- **One table per run.** Two Markdown tables in one file get mixed together. Split them first.
+- **No app logs or addresses.** Those are in the paid version.
+
+## How it compares to other free tools
+
+| | json-shaper-lite | [flatten-json](https://pypi.org/project/flatten-json/) | csvkit `csvjson` | pandas |
+|---|---|---|---|---|
+| Main job | messy text → JSON | nested JSON → flat (and back) | CSV → JSON | full data toolkit |
+| Install size | one file, no deps | small | medium | large |
+| `key: value` notes | yes | no | no | no |
+| Markdown tables | yes | no | no | no, not built in |
+| CSV/TSV | yes | no | yes | yes |
+| Guesses numbers and true/false | yes | no | yes | yes |
+| Nested JSON flatten/unflatten | no | yes | no | yes (`json_normalize`) |
+
+If your data is already JSON and just too nested, flatten-json is the better pick.
+
+## For AI agents
+
+- **Use when:** you have plain text in `key: value` lines, CSV/TSV, or a Markdown table and need typed JSON.
+- **Don't use when:** the input is already JSON, it's app logs, or it's nested data. Use the paid version for logs.
+- **Input:** text on stdin or a file path. Optional `--format kv|csv|markdown`.
+- **Output:** with `--json`, one object: `{"ok": true, "format": "csv", "data": [...]}`. On error `ok` is false. Exit code 0 ok, 1 error.
+- Hint lines go to stderr only, and only in a terminal, so stdout is always clean JSON. See also [`llms.txt`](https://github.com/tidybytetools/json-shaper-lite/blob/main/llms.txt).
+
+## Lite vs paid
+
+| | lite (free) | [json-shaper](https://tidybyte.gumroad.com/l/cznmeo) |
+|---|---|---|
+| key: value notes, CSV/TSV, Markdown tables | yes | yes |
+| App logs (timestamp, level, message, key=value fields) | no | yes |
+| One-line US address splitter | no | yes |
+| `tool.json` manifest for scripts and AI agents | no | yes |
+
+## Tests
+
+```
+python3 -m unittest discover tests
+```
+
+## License
+
+MIT. See `LICENSE`.

json_shaper_lite-1.0.0/json_shaper_lite.egg-info/PKG-INFO

@@ -0,0 +1,133 @@
+Metadata-Version: 2.4
+Name: json-shaper-lite
+Version: 1.0.0
+Summary: Turn key: value notes, CSV/TSV and Markdown tables into clean, typed JSON. No dependencies.
+Author: Tidy Byte Tools
+License-Expression: MIT
+Project-URL: Homepage, https://tidybyte.gumroad.com/l/cznmeo
+Project-URL: Source, https://github.com/tidybytetools/json-shaper-lite
+Project-URL: Issues, https://github.com/tidybytetools/json-shaper-lite/issues
+Project-URL: Changelog, https://github.com/tidybytetools/json-shaper-lite/blob/main/CHANGELOG.md
+Keywords: json,csv,tsv,markdown,markdown-table,converter,text-to-json,cli
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Text Processing
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# json-shaper-lite
+
+[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/tidybytetools/json-shaper-lite/blob/main/LICENSE)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/)
+[![No dependencies](https://img.shields.io/badge/dependencies-none-brightgreen.svg)](https://github.com/tidybytetools/json-shaper-lite/blob/main/json_shaper_lite.py)
+
+Free tool that turns `key: value` notes, CSV/TSV and Markdown tables into clean JSON.
+Need app logs or US addresses parsed too? The paid version does that: **[json-shaper on Gumroad](https://tidybyte.gumroad.com/l/cznmeo)**
+
+One Python file, no dependencies, MIT license. Works with Python 3.10 and newer, on Windows, Mac and Linux.
+
+## Install
+
+```
+pip install json-shaper-lite
+```
+
+Or use pipx, which keeps it in its own space:
+
+```
+pipx install json-shaper-lite
+```
+
+Want the newest code from GitHub instead?
+
+```
+pip install git+https://github.com/tidybytetools/json-shaper-lite
+```
+
+Or just download `json_shaper_lite.py` and run it with `python3`.
+
+## Use it
+
+```
+printf 'Name: Ada\nAge: 36\nActive: yes' | json-shaper-lite
+json-shaper-lite export.csv
+json-shaper-lite notes.md --format markdown
+json-shaper-lite export.csv --json      # {"ok": true, "format": "csv", "data": [...]}
+```
+
+Output:
+
+```json
+{"name": "Ada", "age": 36, "active": true}
+```
+
+Numbers come out as numbers, yes/no and true/false as booleans, and empty or "null" as null. The format is detected for you, or you can set it with `--format kv|csv|markdown`.
+
+From Python:
+
+```python
+from json_shaper_lite import shape
+shape("x,y\n1,2")  # {'format': 'csv', 'data': [{'x': 1, 'y': 2}]}
+```
+
+When you run it in a terminal it prints one short line about the paid version to stderr after the result. It never goes into your JSON output, it only shows when you are looking at a terminal, and `--quiet` turns it off.
+
+## Known limits
+
+- **It makes flat JSON.** It does not flatten or unflatten nested JSON. For that, use a tool like flatten-json.
+- **Types are a best guess.** A value like `007` or a zip code can turn into a number. Fix those by hand after.
+- **One table per run.** Two Markdown tables in one file get mixed together. Split them first.
+- **No app logs or addresses.** Those are in the paid version.
+
+## How it compares to other free tools
+
+| | json-shaper-lite | [flatten-json](https://pypi.org/project/flatten-json/) | csvkit `csvjson` | pandas |
+|---|---|---|---|---|
+| Main job | messy text → JSON | nested JSON → flat (and back) | CSV → JSON | full data toolkit |
+| Install size | one file, no deps | small | medium | large |
+| `key: value` notes | yes | no | no | no |
+| Markdown tables | yes | no | no | no, not built in |
+| CSV/TSV | yes | no | yes | yes |
+| Guesses numbers and true/false | yes | no | yes | yes |
+| Nested JSON flatten/unflatten | no | yes | no | yes (`json_normalize`) |
+
+If your data is already JSON and just too nested, flatten-json is the better pick.
+
+## For AI agents
+
+- **Use when:** you have plain text in `key: value` lines, CSV/TSV, or a Markdown table and need typed JSON.
+- **Don't use when:** the input is already JSON, it's app logs, or it's nested data. Use the paid version for logs.
+- **Input:** text on stdin or a file path. Optional `--format kv|csv|markdown`.
+- **Output:** with `--json`, one object: `{"ok": true, "format": "csv", "data": [...]}`. On error `ok` is false. Exit code 0 ok, 1 error.
+- Hint lines go to stderr only, and only in a terminal, so stdout is always clean JSON. See also [`llms.txt`](https://github.com/tidybytetools/json-shaper-lite/blob/main/llms.txt).
+
+## Lite vs paid
+
+| | lite (free) | [json-shaper](https://tidybyte.gumroad.com/l/cznmeo) |
+|---|---|---|
+| key: value notes, CSV/TSV, Markdown tables | yes | yes |
+| App logs (timestamp, level, message, key=value fields) | no | yes |
+| One-line US address splitter | no | yes |
+| `tool.json` manifest for scripts and AI agents | no | yes |
+
+## Tests
+
+```
+python3 -m unittest discover tests
+```
+
+## License
+
+MIT. See `LICENSE`.

json_shaper_lite-1.0.0/json_shaper_lite.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+CHANGELOG.md
+LICENSE
+MANIFEST.in
+README.md
+json_shaper_lite.py
+llms.txt
+pyproject.toml
+json_shaper_lite.egg-info/PKG-INFO
+json_shaper_lite.egg-info/SOURCES.txt
+json_shaper_lite.egg-info/dependency_links.txt
+json_shaper_lite.egg-info/entry_points.txt
+json_shaper_lite.egg-info/top_level.txt
+tests/test_lite.py

json_shaper_lite-1.0.0/json_shaper_lite.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

json_shaper_lite-1.0.0/json_shaper_lite.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+json-shaper-lite = json_shaper_lite:main

json_shaper_lite-1.0.0/json_shaper_lite.egg-info/top_level.txt

@@ -0,0 +1 @@
+json_shaper_lite

json_shaper_lite-1.0.0/json_shaper_lite.py

@@ -0,0 +1,87 @@
+#!/usr/bin/env python3
+"""json-shaper-lite (MIT): free edition. Pro adds log parsing + address splitting: turn messy text into clean JSON. No third-party deps."""
+import argparse, csv, io, json, re, sys
+
+__version__ = "1.0.0"
+PRO_URL = "https://tidybyte.gumroad.com/l/cznmeo"
+PRO_LINE = f"Need log files parsed too? json-shaper (paid) does that: {PRO_URL}"
+
+def _num(v):
+    v = v.strip()
+    if re.fullmatch(r"-?\d+", v): return int(v)
+    if re.fullmatch(r"-?\d*\.\d+", v): return float(v)
+    if v.lower() in ("true", "yes"): return True
+    if v.lower() in ("false", "no"): return False
+    if v.lower() in ("null", "none", ""): return None
+    return v
+
+def _key(k):
+    return re.sub(r"[^a-z0-9]+", "_", k.strip().lower()).strip("_")
+
+def parse_kv(text):
+    """'Key: value' or 'key=value' lines. Blank lines separate records."""
+    records, cur = [], {}
+    for line in text.splitlines():
+        if not line.strip():
+            if cur: records.append(cur); cur = {}
+            continue
+        m = re.match(r"\s*([^:=]+?)\s*[:=]\s*(.*)$", line)
+        if m: cur[_key(m.group(1))] = _num(m.group(2))
+    if cur: records.append(cur)
+    return records[0] if len(records) == 1 else records
+
+def parse_csv(text):
+    sample = text[:2048]
+    try: dialect = csv.Sniffer().sniff(sample, delimiters=",;\t|")
+    except csv.Error: dialect = csv.excel
+    rows = [r for r in csv.reader(io.StringIO(text.strip()), dialect) if any(c.strip() for c in r)]
+    if not rows: return []
+    head = [_key(h) for h in rows[0]]
+    return [{h: _num(c) for h, c in zip(head, r)} for r in rows[1:]]
+
+def parse_markdown_table(text):
+    lines = [l.strip() for l in text.splitlines() if l.strip().startswith("|")]
+    lines = [l for l in lines if not re.fullmatch(r"\|[\s:\-|]+\|?", l)]
+    cells = [[c.strip() for c in l.strip("|").split("|")] for l in lines]
+    if not cells: return []
+    head = [_key(h) for h in cells[0]]
+    return [{h: _num(c) for h, c in zip(head, r)} for r in cells[1:]]
+
+def detect(text):
+    t = text.strip()
+    lines = [l for l in t.splitlines() if l.strip()]
+    if not lines: return "kv"
+    if sum(l.strip().startswith("|") for l in lines) >= 2: return "markdown"
+    if sum(bool(re.match(r"\s*[^:=,;|\t]+?\s*[:=]\s*", l)) for l in lines) >= len(lines) * 0.6: return "kv"
+    return "csv"
+
+PARSERS = {"kv": parse_kv, "csv": parse_csv, "markdown": parse_markdown_table}
+
+def shape(text, fmt="auto"):
+    fmt = detect(text) if fmt == "auto" else fmt
+    return {"format": fmt, "data": PARSERS[fmt](text)}
+
+def main(argv=None):
+    p = argparse.ArgumentParser(prog="json-shaper-lite", description="Turn messy text into clean JSON.", epilog=PRO_LINE)
+    p.add_argument("file", nargs="?", help="input file (default: stdin)")
+    p.add_argument("-f", "--format", default="auto", choices=["auto"] + list(PARSERS))
+    p.add_argument("--json", action="store_true", help="machine-readable envelope: {ok, format, data}")
+    p.add_argument("--indent", type=int, default=2)
+    p.add_argument("-q", "--quiet", action="store_true", help="don't print the one-line note about the paid version")
+    p.add_argument("--version", action="version", version=__version__)
+    a = p.parse_args(argv)
+    try:
+        text = open(a.file, encoding="utf-8").read() if a.file else sys.stdin.read()
+        res = shape(text, a.format)
+        out = {"ok": True, **res} if a.json else res["data"]
+        print(json.dumps(out, indent=a.indent, ensure_ascii=False))
+        if not a.quiet and not a.json and sys.stderr.isatty():
+            print(PRO_LINE, file=sys.stderr)
+        return 0
+    except Exception as e:
+        if a.json:
+            print(json.dumps({"ok": False, "error": str(e)})); return 1
+        print(f"error: {e}", file=sys.stderr); return 1
+
+if __name__ == "__main__":
+    sys.exit(main())

json_shaper_lite-1.0.0/llms.txt

@@ -0,0 +1,17 @@
+# json-shaper-lite
+
+> Free, MIT-licensed, single-file Python tool (no dependencies) that turns `key: value` notes, CSV/TSV and Markdown tables into typed JSON. Numbers become numbers, yes/no and true/false become booleans, empty or "null" becomes null.
+
+- Install: `pip install json-shaper-lite` (or from GitHub: `pip install git+https://github.com/tidybytetools/json-shaper-lite`) (or download json_shaper_lite.py)
+- CLI: `json-shaper-lite file.csv --json` prints `{"ok": true, "format": "csv", "data": [...]}`. Reads stdin if no file. `--format kv|csv|markdown` to force a format. Exit 0 ok, 1 error.
+- Python: `from json_shaper_lite import shape; shape("x,y\n1,2")` returns `{"format": "csv", "data": [{"x": 1, "y": 2}]}`.
+
+## Use when
+- You have plain text records or a table and need clean JSON.
+
+## Don't use when
+- The input is already JSON, is nested, or is app logs / US addresses. Logs and addresses are in the paid version: https://tidybyte.gumroad.com/l/cznmeo
+
+## Links
+- [README](https://github.com/tidybytetools/json-shaper-lite/blob/main/README.md)
+- [Paid version](https://tidybyte.gumroad.com/l/cznmeo)

json_shaper_lite-1.0.0/pyproject.toml

@@ -0,0 +1,42 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "json-shaper-lite"
+version = "1.0.0"
+description = "Turn key: value notes, CSV/TSV and Markdown tables into clean, typed JSON. No dependencies."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{name = "Tidy Byte Tools"}]
+requires-python = ">=3.10"
+dependencies = []
+keywords = ["json", "csv", "tsv", "markdown", "markdown-table", "converter", "text-to-json", "cli"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Environment :: Console",
+  "Intended Audience :: Developers",
+  "Intended Audience :: End Users/Desktop",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Topic :: Text Processing",
+  "Topic :: Utilities",
+]
+
+[project.urls]
+Homepage = "https://tidybyte.gumroad.com/l/cznmeo"
+Source = "https://github.com/tidybytetools/json-shaper-lite"
+Issues = "https://github.com/tidybytetools/json-shaper-lite/issues"
+Changelog = "https://github.com/tidybytetools/json-shaper-lite/blob/main/CHANGELOG.md"
+
+[project.scripts]
+json-shaper-lite = "json_shaper_lite:main"
+
+[tool.setuptools]
+py-modules = ["json_shaper_lite"]

json_shaper_lite-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

json_shaper_lite-1.0.0/tests/test_lite.py

@@ -0,0 +1,42 @@
+import io, os, sys, unittest
+from contextlib import redirect_stdout, redirect_stderr
+sys.path.insert(0, os.path.join(os.path.dirname(__file__), ".."))
+import json_shaper_lite as js
+
+class T(unittest.TestCase):
+    def test_kv(self): self.assertEqual(js.shape("a: 1")["data"], {"a": 1})
+    def test_kv_types(self):
+        self.assertEqual(js.shape("Name: Ada\nAge: 36\nActive: yes\nNote: null")["data"],
+                         {"name": "Ada", "age": 36, "active": True, "note": None})
+    def test_kv_multiple_records(self):
+        self.assertEqual(js.shape("a: 1\n\na: 2")["data"], [{"a": 1}, {"a": 2}])
+    def test_csv(self): self.assertEqual(js.shape("x,y\n1,2")["data"], [{"x": 1, "y": 2}])
+    def test_semicolon_csv(self):
+        r = js.shape("Item;Price\nTea;2.5\nCake;4", "csv")["data"]
+        self.assertEqual(r, [{"item": "Tea", "price": 2.5}, {"item": "Cake", "price": 4}])
+    def test_md(self): self.assertEqual(js.shape("|a|\n|-|\n|z|")["data"], [{"a": "z"}])
+    def test_detect(self):
+        self.assertEqual(js.detect("|a|b|\n|-|-|\n|1|2|"), "markdown")
+        self.assertEqual(js.detect("x,y\n1,2"), "csv")
+        self.assertEqual(js.detect("a: 1\nb: 2"), "kv")
+    def run_main(self, argv, stdin):
+        out, err = io.StringIO(), io.StringIO()
+        old = sys.stdin; sys.stdin = io.StringIO(stdin)
+        try:
+            with redirect_stdout(out), redirect_stderr(err): code = js.main(argv)
+        finally: sys.stdin = old
+        return code, out.getvalue(), err.getvalue()
+    def test_cli_json_envelope_is_clean(self):
+        code, out, err = self.run_main(["--json"], "a: 1")
+        self.assertEqual(code, 0)
+        self.assertIn('"ok": true', out)
+        self.assertNotIn("gumroad", out)
+    def test_help_has_paid_link(self):
+        out = io.StringIO()
+        with redirect_stdout(out), self.assertRaises(SystemExit): js.main(["--help"])
+        self.assertIn("https://tidybyte.gumroad.com/l/cznmeo", out.getvalue())
+    def test_bad_file(self):
+        code, out, err = self.run_main(["--json", "/nope/missing.txt"], "")
+        self.assertEqual(code, 1); self.assertIn('"ok": false', out)
+
+if __name__ == "__main__": unittest.main()