json-repair 0.55.1__py3-none-any.whl → 0.56.0__py3-none-any.whl

{json_repair-0.55.1.dist-info → json_repair-0.56.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: json_repair
-Version: 0.55.1
+Version: 0.56.0
 Summary: A package to repair broken json strings
 Author-email: Stefano Baccianella <4247706+mangiucugna@users.noreply.github.com>
 License-Expression: MIT
@@ -13,6 +13,9 @@ Classifier: Operating System :: OS Independent
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
+Provides-Extra: schema
+Requires-Dist: jsonschema>=4.21; extra == "schema"
+Requires-Dist: pydantic>=2; extra == "schema"
 Dynamic: license-file
 
 [![PyPI](https://img.shields.io/pypi/v/json-repair)](https://pypi.org/project/json-repair/)
@@ -190,6 +193,58 @@ In strict mode the parser raises `ValueError` as soon as it encounters structura
 
 Strict mode still honors `skip_json_loads=True`; combining them lets you skip the initial `json.loads` check but still enforce strict parsing rules.
 
+### Schema-guided repairs
+
+**Alpha feature (not yet in stable releases).** Schema-guided repairs are currently shipped only in alpha builds (e.g., `0.56.0-alpha.*`). The API and behavior may change or break between alpha releases.
+
+You can guide repairs with a JSON Schema (or a Pydantic v2 model). When enabled, the parser will:
+
+- Fill missing values (defaults, required fields).
+- Coerce scalars where safe (e.g., `"1"` → `1` for integer fields).
+- Drop properties/items that the schema disallows.
+
+This is especially useful when you need deterministic, schema-valid outputs for downstream validation, storage, or typed processing. If the input cannot be repaired to satisfy the schema, `json_repair` raises `ValueError`.
+
+Install the optional dependencies:
+
+    pip install 'json-repair[schema]'
+
+(For CLI usage, you can also use `pipx install 'json-repair[schema]'`.)
+
+Schema guidance is skipped for already-valid JSON unless you pass `skip_json_loads=True` (this forces the parser to run even on valid JSON). Schema guidance is mutually exclusive with `strict=True`.
+
+```
+from json_repair import repair_json
+
+schema = {
+    "type": "object",
+    "properties": {"value": {"type": "integer"}},
+    "required": ["value"],
+}
+
+repair_json('{"value": "1"}', schema=schema, skip_json_loads=True, return_objects=True)
+```
+
+Pydantic v2 model example:
+
+```
+from pydantic import BaseModel, Field
+from json_repair import repair_json
+
+
+class Payload(BaseModel):
+    value: int
+    tags: list[str] = Field(default_factory=list)
+
+
+repair_json(
+    '{"value": "1", "tags": }',
+    schema=Payload,
+    skip_json_loads=True,
+    return_objects=True,
+)
+```
+
 ### Use json_repair with streaming
 
 Sometimes you are streaming some data and want to repair the JSON coming from it. Normally this won't work but you can pass `stream_stable` to `repair_json()` or `loads()` to make it work:
@@ -207,7 +262,9 @@ pipx install json-repair
 to know all options available:
 ```
 $ json_repair -h
-usage: json_repair [-h] [-i] [-o TARGET] [--ensure_ascii] [--indent INDENT] [filename]
+usage: json_repair [-h] [-i] [-o TARGET] [--ensure_ascii] [--indent INDENT]
+                   [--skip-json-loads] [--schema SCHEMA] [--schema-model MODEL]
+                   [--strict] [filename]
 
 Repair and parse JSON files.
 
@@ -221,6 +278,9 @@ options:
                         If specified, the output will be written to TARGET filename instead of stdout
   --ensure_ascii        Pass ensure_ascii=True to json.dumps()
   --indent INDENT       Number of spaces for indentation (Default 2)
+  --skip-json-loads     Skip initial json.loads validation (needed to force schema on valid JSON)
+  --schema SCHEMA       Path to a JSON Schema file that guides repairs
+  --schema-model MODEL  Pydantic v2 model in 'module:ClassName' form that guides repairs
   --strict              Raise on duplicate keys, missing separators, empty keys/values, and similar structural issues instead of repairing them
 ```
 
@@ -274,8 +334,15 @@ If something is wrong (a missing parentheses or quotes for example) it will use
 
 I am sure some corner cases will be missing, if you have examples please open an issue or even better push a PR
 
+# Contributing
+If you want to contribute, start with `CONTRIBUTING.md` and read the Code Wiki writeup for a tour of the codebase and key entry points: https://codewiki.google/github.com/mangiucugna/json_repair
+
 # How to develop
-Just create a virtual environment with `requirements.txt`, the setup uses [pre-commit](https://pre-commit.com/) to make sure all tests are run.
+Use `uv` to set up the dev environment and run tooling:
+
+    uv sync --group dev
+    uv run pre-commit run --all-files
+    uv run pytest
 
 Make sure that the Github Actions running after pushing a new commit don't fail as well.
 

json_repair-0.56.0.dist-info/RECORD

@@ -0,0 +1,23 @@
+json_repair/__init__.py,sha256=JQ4Nm8YzR8Id2a527Ql0Az-rKapTp8DCMPKybLtQ620,180
+json_repair/__main__.py,sha256=EsJb-y89uZEvGQQg1GdIDWzfDwfOMvVekKEtdguQXCM,67
+json_repair/json_parser.py,sha256=IoS2HohE-qAMEDml960NT9L494wnkvTbWySmSSNp7bE,10503
+json_repair/json_repair.py,sha256=mpzQi6ZfrZd8WqZX9aXIe-19LB8gTPtxy8QZRpDjT3o,16506
+json_repair/parse_array.py,sha256=zuqE33NePib4c1U1RIrw0qlB0MNGMzCZVCXnUqPoNFA,4973
+json_repair/parse_comment.py,sha256=ozOPPZBI1pyHxN98vTtmtMNNbdg4dOjvC06dkuXSzMs,2646
+json_repair/parse_number.py,sha256=j-tYSnQbXOVENk4aJEeNY6wfAGUEjgLzQz5T5Nnvuj0,1296
+json_repair/parse_object.py,sha256=Z89mqZ2Mm84OH_WZs61hxTNeJY9QXRcw6gZ6MrxeWqw,15224
+json_repair/parse_string.py,sha256=Kq_u7Ya5ioctsOueQh1eY_fpXHWGLfW2193tJ7yesB4,26151
+json_repair/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+json_repair/schema_repair.py,sha256=_mvpLs2xaiTdwZzJmV-FxzWVH6jdyPNuSYIU_ZufITo,22820
+json_repair/parse_string_helpers/parse_boolean_or_null.py,sha256=pGmH1QATBls70kTvUlJv4F8NiPaBWcyGhRL03sTOnto,871
+json_repair/parse_string_helpers/parse_json_llm_block.py,sha256=wPSm-8RY30Ek8HxzjCkCRtdLq4-Cez-PJB3vOk_vP3w,670
+json_repair/utils/constants.py,sha256=MtvxHhcCq3jpgIThLUPjmH7nVeXSq6HjHDyQBntjVyY,378
+json_repair/utils/json_context.py,sha256=WsMOjqpGSr6aaDONcrk8UFtTurzWon2Qq9AoBBYseoI,934
+json_repair/utils/object_comparer.py,sha256=eKpIi9pMitZ3T_X1gIDlZv0-aPuvZqxSTphjIYD-8ys,1714
+json_repair/utils/string_file_wrapper.py,sha256=dUYoSaMn1ahl72B1BfnNe0iqlV1wsxiZQK3gB0oHcyg,7054
+json_repair-0.56.0.dist-info/licenses/LICENSE,sha256=wrjQo8MhNrNCicXtMe3MHmS-fx8AmQk1ue8AQwiiFV8,1076
+json_repair-0.56.0.dist-info/METADATA,sha256=8bHNoTqQJKzul8dPrbkA_NGJHQWkJ3NW0Qq2w03vcG8,14915
+json_repair-0.56.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+json_repair-0.56.0.dist-info/entry_points.txt,sha256=SNfge3zPSP-ASqriYU9r3NAPaXdseYr7ciPMKdV2uSw,57
+json_repair-0.56.0.dist-info/top_level.txt,sha256=7-VZwZN2CgB_n0NlSLk-rEUFh8ug21lESbsblOYuZqw,12
+json_repair-0.56.0.dist-info/RECORD,,

{json_repair-0.55.1.dist-info → json_repair-0.56.0.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (80.10.1)
+Generator: setuptools (80.10.2)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

json_repair-0.55.1.dist-info/RECORD

@@ -1,22 +0,0 @@
-json_repair/__init__.py,sha256=JQ4Nm8YzR8Id2a527Ql0Az-rKapTp8DCMPKybLtQ620,180
-json_repair/__main__.py,sha256=EsJb-y89uZEvGQQg1GdIDWzfDwfOMvVekKEtdguQXCM,67
-json_repair/json_parser.py,sha256=1C24BNRNOg-hwJzLsCWuW75xYctm0haSynrDsGCy3d8,8595
-json_repair/json_repair.py,sha256=iT-OJgpBnKUJVIV4IUlXmMUkOyW6bNnKCZLB7Fys8hk,12758
-json_repair/parse_array.py,sha256=rZfnRiS86vBATOUHqSx2T5fE79Ndlk2NoTsg9Wek7l4,2239
-json_repair/parse_comment.py,sha256=MUDxrx8BFfAaKvx6x4gWviJNvwRi2yv5qnrR6honmas,2660
-json_repair/parse_number.py,sha256=zSsOZeJb-UTQkOrUSMsLKJJIJ0A9tGdwbQwQCWVOc4o,1314
-json_repair/parse_object.py,sha256=DH5xAqXIAM0hBhUUblfADuEs2JM8jnvd73h-KbFDcbQ,7859
-json_repair/parse_string.py,sha256=Dad1iQZDhF5MGAQ5eYs55O810yV1HCYPBkcHYH5AVBU,26275
-json_repair/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-json_repair/parse_string_helpers/parse_boolean_or_null.py,sha256=pGmH1QATBls70kTvUlJv4F8NiPaBWcyGhRL03sTOnto,871
-json_repair/parse_string_helpers/parse_json_llm_block.py,sha256=wPSm-8RY30Ek8HxzjCkCRtdLq4-Cez-PJB3vOk_vP3w,670
-json_repair/utils/constants.py,sha256=cv2gvyosuq0me0600WyTysM9avrtfXPuXYR26tawcuo,158
-json_repair/utils/json_context.py,sha256=WsMOjqpGSr6aaDONcrk8UFtTurzWon2Qq9AoBBYseoI,934
-json_repair/utils/object_comparer.py,sha256=XKV3MRab8H7_v4sm-wpEa5le0XX9OeycWo5S-MFm-GI,1716
-json_repair/utils/string_file_wrapper.py,sha256=jaS1vl_6qRQLJ-r37wZgMRtUJR6MLgNIGMVLqeGYBSk,6901
-json_repair-0.55.1.dist-info/licenses/LICENSE,sha256=wrjQo8MhNrNCicXtMe3MHmS-fx8AmQk1ue8AQwiiFV8,1076
-json_repair-0.55.1.dist-info/METADATA,sha256=3usfVWz8_EMYrgdV3ZkPQ79NPvGYcA6Mpv9nhcjIuK8,12576
-json_repair-0.55.1.dist-info/WHEEL,sha256=qELbo2s1Yzl39ZmrAibXA2jjPLUYfnVhUNTlyF1rq0Y,92
-json_repair-0.55.1.dist-info/entry_points.txt,sha256=SNfge3zPSP-ASqriYU9r3NAPaXdseYr7ciPMKdV2uSw,57
-json_repair-0.55.1.dist-info/top_level.txt,sha256=7-VZwZN2CgB_n0NlSLk-rEUFh8ug21lESbsblOYuZqw,12
-json_repair-0.55.1.dist-info/RECORD,,