laga 0.1.1

Repair malformed JSON from language models and hand-written config.

laga

laga repairs malformed JSON and returns Python objects.

Why

Large language models and hand-written configuration often produce almost-JSON with trailing commas, missing commas, comments, code fences, single quotes, unquoted keys, or truncated containers. laga keeps the public surface small, tries json.loads first for valid input, and only enters the repair path when necessary.

Install

laga 0.1.1 supports Python 3.10 through 3.13.

python -m pip install -e ".[dev]"

Quickstart

import laga

text = """Here is the result:
```json
{
  'name': 'Ada',
  'active': True,
  'roles': ['admin', 'writer',],
}

"""

data = laga.repair(text) print(data) print(laga.repair_to_str(text))

## API Reference

| Function | Returns | Description |
| --- | --- | --- |
| `laga.repair(text, strict=False)` | Python object | Repairs malformed JSON and returns Python data. |
| `laga.repair_to_str(text, strict=False)` | `str` | Repairs malformed JSON and returns normalized JSON text. |
| `laga.loads(text, strict=False)` | Python object | Alias for `laga.repair`. |
| `laga.LagaError` | Exception type | Raised when repair fails or input is unrecoverable. |

## Repair Rules

| Rule | Before | After |
| --- | --- | --- |
| Trailing comma | `{"a": 1,}` | `{"a":1}` |
| Missing comma | `{"a": 1 "b": 2}` | `{"a":1,"b":2}` |
| Single quotes | `{'a': 'b'}` | `{"a":"b"}` |
| Unquoted keys | `{name: "Ada"}` | `{"name":"Ada"}` |
| Python literals | `{"ok": True, "none": None}` | `{"ok":true,"none":null}` |
| Comments | `{"a": 1 // note\n}` | `{"a":1}` |
| Markdown fences | <code>```json\n{"a":1}\n```</code> | `{"a":1}` |
| Smart quotes | `“a”` | `"a"` |
| Prose around JSON | `Result: {"a":1}` | `{"a":1}` |
| Truncated structure | `{"a": [1, 2` | `{"a":[1,2]}` |

## Limitations

`laga` is intentionally conservative. It does not evaluate expressions, it does not guess at arbitrary JavaScript syntax, and it does not try to recover malformed numbers or deeply ambiguous text in strict mode. If you already control the producer and the input is valid JSON, the standard library remains the best choice because `json.loads` is faster and stricter.

When an object contains duplicate keys, the last value wins, matching Python dict behavior.

## When To Use The Standard Library

Use `json.loads` when you control the producer and know the input is valid JSON. Use `laga` when the input is noisy, user-facing, or generated by a model and you need a predictable repair step before parsing.

## Development

```bash
make install
make lint
make typecheck
make test
make build