ensure-json 0.1.1

A <3kB, dependency-free toolkit to repair 'almost-JSON' text from LLMs and return a valid Python object—or raise JsonFixError.

ensure-json

Repair and parse "almost-JSON" from LLMs (like GPT, Claude) into valid Python objects, or raise a clear error. Works in any Python 3.7+ environment. Zero dependencies (Pydantic optional for schema validation).

---

Install

pip install ensure-json

---

Usage

As a Python Library

from ensure_json import ensure_json, JsonFixError

try:
    obj = ensure_json('{ name: "Alice", age: 42, }')
    print(obj)  # {'name': 'Alice', 'age': 42}
except JsonFixError as err:
    print("Could not parse JSON:", err)

With Pydantic Schema (optional)

from ensure_json import ensure_json
from pydantic import BaseModel

class User(BaseModel):
    name: str
    age: int

user = ensure_json('{ name: "Alice", age: 42 }', schema=User)
print(user)  # User(name='Alice', age=42)

Command Line

echo '{ name: "Alice", age: 42, }' | ensure-json
# or
echo '{ name: "Alice", age: 42, }' | python -m ensure_py.cli

---

Features

• Repairs and parses "almost-JSON" from LLMs (extra commas, unquoted keys, etc.)
• Returns a valid Python object or raises JsonFixError
• Optional Pydantic schema validation
• Minimal CLI for quick fixes
• No dependencies required (Pydantic optional)

---

License

MIT