json-schema-utils 0.8__tar.gz

json_schema_utils-0.8/.gitignore

@@ -0,0 +1,171 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# UV
+#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#uv.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/latest/usage/project/#working-with-version-control
+.pdm.toml
+.pdm-python
+.pdm-build/
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/
+
+# PyPI configuration file
+.pypirc

json_schema_utils-0.8/LICENSE

@@ -0,0 +1 @@
+CC0: This code is Public Domain.

json_schema_utils-0.8/MANIFEST.in

@@ -0,0 +1 @@
+recursive-exclude tests *

json_schema_utils-0.8/Makefile

@@ -0,0 +1,76 @@
+SHELL   = /bin/bash
+.ONESHELL:
+
+.PHONY: clean
+clean:
+	$(RM) *~
+	$(RM) -r jsutils/__pycache__ dist/
+
+.PHONY: clean.dev
+clean.dev: clean
+	$(RM) -rf venv *.egg-info
+
+.PHONY: dev
+dev: venv
+
+venv:
+	python -m venv venv
+	source venv/bin/activate
+	pip install -e .[dev]
+
+.PHONY: check
+check: check.inline check.simpler check.src check.tests
+
+.PHONY: check.src
+check.src: check.ruff check.flake8 check.pyright
+
+.PHONY: check.tests
+check.tests: dev
+	source venv/bin/activate
+	$(MAKE) -C tests check
+
+IGNORE  = E201,E202,E227,E302,E402,E731
+
+.PHONY: check.ruff
+check.ruff: venv
+	source venv/bin/activate
+	ruff check --ignore=$(IGNORE) jsutils
+
+.PHONY: check.flake8
+check.flake8: venv
+	source venv/bin/activate
+	flake8 --ignore=$(IGNORE),W504 --max-line-length=100 jsutils
+
+.PHONY: check.pyright
+check.pyright: venv
+	source venv/bin/activate
+	pyright jsutils
+
+.PHONY: check.inline
+check.inline: venv
+	source venv/bin/activate
+	$(MAKE) -C tests inline
+
+.PHONY: check.simpler
+check.simpler: venv
+	source venv/bin/activate
+	$(MAKE) -C tests simpler
+
+.PHONY: check.stats
+check.stats: venv
+	source venv/bin/activate
+	$(MAKE) -C tests stats
+
+#
+# publication on pypi
+#
+# pip install -e .[dist]
+# make publish
+# twine upload dist/*
+#
+.PHONY: publish
+publish:
+	source venv/bin/activate
+	python -m build
+	twine check dist/*
+	echo "# twine upload dist/*"

json_schema_utils-0.8/PKG-INFO

@@ -0,0 +1,119 @@
+Metadata-Version: 2.4
+Name: json_schema_utils
+Version: 0.8
+Summary: JSON Schema Utils
+Author: Fabien Coelho, Claire Yannou-Medrala
+License-Expression: CC0-1.0
+Project-URL: repository, https://github.com/zx80/json-schema-utils
+Classifier: Topic :: Software Development
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests
+Requires-Dist: jschon
+Requires-Dist: jsonschema[format]
+Provides-Extra: dev
+Requires-Dist: ruff; extra == "dev"
+Requires-Dist: flake8; extra == "dev"
+Requires-Dist: pyright; extra == "dev"
+Provides-Extra: dist
+Requires-Dist: build; extra == "dist"
+Requires-Dist: twine; extra == "dist"
+Requires-Dist: wheel; extra == "dist"
+Dynamic: license-file
+
+# JSON Schema Utils
+
+Random utilities to analyze and manipulate JSON Schema.
+
+## Installation
+
+Install latest version with `pip` from PyPI or from GitHub:
+
+```sh
+python -m venv venv
+source venv/bin/activate
+# from PyPI:
+pip install json_schema_utils
+# OR from latest sources:
+pip install git+https://github.com/zx80/json-schema-utils.git
+```
+
+## Inline Schema References
+
+Replace references `$ref` by their definitions.
+
+```sh
+# no $id
+jsu-inline -m "file:// ./tests" tests/*.schema.json
+# with $id
+jsu-inline -a tests/foo.schema.json
+```
+
+## Simplify Schema
+
+Apply various schema simplifications:
+
+- remove type-incompatible keywords and formats, with warnings.
+- try to move up list-of-one-schema `*Of`.
+- simplify type lists.
+- change list-of-one `enum` to `const`.
+- detect some cases of infeasible schemas.
+- remove uneffective keywords in corner cases.
+
+```sh
+jsu-simpler tests/*.schema.json
+```
+
+## Check JSON Values against a Schema
+
+Check a JSON values match a given schema using either
+[jsonschema](https://github.com/python-jsonschema/jsonschema) or
+[jschon](https://github.com/marksparkza/jschon) implementations.
+
+```sh
+jsu-check tests/foo.schema.json tests/foo.*.value.json
+```
+
+## JSON Schema Stats and Issues
+
+Generate a report about JSON schemas, including possible bugs.
+
+```sh
+jsu-stats tests/*.schema.json
+```
+
+This script is extracted from [JSON Schema Stats](https://github.com/clairey-zx81/json-schema-stats)
+which has been updated to depend on this module.
+
+## JSON Prettyprinter
+
+```sh
+jsu-pretty --indent 2 --sort-keys tests/*.schema.json
+```
+
+You could also use `jq .` for this purpose.
+
+## JSON Schema to JSON Model Conversion
+
+Convert a subset of JSON Schema to JSON Model.
+The subset should comply with some restrictions described in Section 6 of
+[An Analysis of Defects in Public JSON Schemas](https://minesparis-psl.hal.science/hal-04415517/file/A-794-DepotHAL.pdf)
+by Claire Yannou-Medrala and Fabien Coelho:
+
+- `const`, `enum`, `$ref`, `type`, `allOf`, `anyOf`, `oneOf` should be exclusive.
+- some keywords are not supported: `multipleOf`, `contains`
+- conditions `if then else` are translated to the logical equivalent:
+  `{if: C, then: T, else: E}` is _(C and T) or (not C and E)_
+
+```sh
+jsu-model test/foo.schema.json
+```
+
+## TODO
+
+- Testing. CI.
+- stats: warn instead of errors on unsure issues under `if`/`then`/`else`/`not`.
+- propagate non type under containers (`*Of`, `if`, `then`, `else`, reference?)
+  to reduce false positive errors/warnings.
+- simplify: deduplicate constants in enum?

json_schema_utils-0.8/README.md

@@ -0,0 +1,95 @@
+# JSON Schema Utils
+
+Random utilities to analyze and manipulate JSON Schema.
+
+## Installation
+
+Install latest version with `pip` from PyPI or from GitHub:
+
+```sh
+python -m venv venv
+source venv/bin/activate
+# from PyPI:
+pip install json_schema_utils
+# OR from latest sources:
+pip install git+https://github.com/zx80/json-schema-utils.git
+```
+
+## Inline Schema References
+
+Replace references `$ref` by their definitions.
+
+```sh
+# no $id
+jsu-inline -m "file:// ./tests" tests/*.schema.json
+# with $id
+jsu-inline -a tests/foo.schema.json
+```
+
+## Simplify Schema
+
+Apply various schema simplifications:
+
+- remove type-incompatible keywords and formats, with warnings.
+- try to move up list-of-one-schema `*Of`.
+- simplify type lists.
+- change list-of-one `enum` to `const`.
+- detect some cases of infeasible schemas.
+- remove uneffective keywords in corner cases.
+
+```sh
+jsu-simpler tests/*.schema.json
+```
+
+## Check JSON Values against a Schema
+
+Check a JSON values match a given schema using either
+[jsonschema](https://github.com/python-jsonschema/jsonschema) or
+[jschon](https://github.com/marksparkza/jschon) implementations.
+
+```sh
+jsu-check tests/foo.schema.json tests/foo.*.value.json
+```
+
+## JSON Schema Stats and Issues
+
+Generate a report about JSON schemas, including possible bugs.
+
+```sh
+jsu-stats tests/*.schema.json
+```
+
+This script is extracted from [JSON Schema Stats](https://github.com/clairey-zx81/json-schema-stats)
+which has been updated to depend on this module.
+
+## JSON Prettyprinter
+
+```sh
+jsu-pretty --indent 2 --sort-keys tests/*.schema.json
+```
+
+You could also use `jq .` for this purpose.
+
+## JSON Schema to JSON Model Conversion
+
+Convert a subset of JSON Schema to JSON Model.
+The subset should comply with some restrictions described in Section 6 of
+[An Analysis of Defects in Public JSON Schemas](https://minesparis-psl.hal.science/hal-04415517/file/A-794-DepotHAL.pdf)
+by Claire Yannou-Medrala and Fabien Coelho:
+
+- `const`, `enum`, `$ref`, `type`, `allOf`, `anyOf`, `oneOf` should be exclusive.
+- some keywords are not supported: `multipleOf`, `contains`
+- conditions `if then else` are translated to the logical equivalent:
+  `{if: C, then: T, else: E}` is _(C and T) or (not C and E)_
+
+```sh
+jsu-model test/foo.schema.json
+```
+
+## TODO
+
+- Testing. CI.
+- stats: warn instead of errors on unsure issues under `if`/`then`/`else`/`not`.
+- propagate non type under containers (`*Of`, `if`, `then`, `else`, reference?)
+  to reduce false positive errors/warnings.
+- simplify: deduplicate constants in enum?

json_schema_utils-0.8/json_schema_utils.egg-info/PKG-INFO

@@ -0,0 +1,119 @@
+Metadata-Version: 2.4
+Name: json_schema_utils
+Version: 0.8
+Summary: JSON Schema Utils
+Author: Fabien Coelho, Claire Yannou-Medrala
+License-Expression: CC0-1.0
+Project-URL: repository, https://github.com/zx80/json-schema-utils
+Classifier: Topic :: Software Development
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests
+Requires-Dist: jschon
+Requires-Dist: jsonschema[format]
+Provides-Extra: dev
+Requires-Dist: ruff; extra == "dev"
+Requires-Dist: flake8; extra == "dev"
+Requires-Dist: pyright; extra == "dev"
+Provides-Extra: dist
+Requires-Dist: build; extra == "dist"
+Requires-Dist: twine; extra == "dist"
+Requires-Dist: wheel; extra == "dist"
+Dynamic: license-file
+
+# JSON Schema Utils
+
+Random utilities to analyze and manipulate JSON Schema.
+
+## Installation
+
+Install latest version with `pip` from PyPI or from GitHub:
+
+```sh
+python -m venv venv
+source venv/bin/activate
+# from PyPI:
+pip install json_schema_utils
+# OR from latest sources:
+pip install git+https://github.com/zx80/json-schema-utils.git
+```
+
+## Inline Schema References
+
+Replace references `$ref` by their definitions.
+
+```sh
+# no $id
+jsu-inline -m "file:// ./tests" tests/*.schema.json
+# with $id
+jsu-inline -a tests/foo.schema.json
+```
+
+## Simplify Schema
+
+Apply various schema simplifications:
+
+- remove type-incompatible keywords and formats, with warnings.
+- try to move up list-of-one-schema `*Of`.
+- simplify type lists.
+- change list-of-one `enum` to `const`.
+- detect some cases of infeasible schemas.
+- remove uneffective keywords in corner cases.
+
+```sh
+jsu-simpler tests/*.schema.json
+```
+
+## Check JSON Values against a Schema
+
+Check a JSON values match a given schema using either
+[jsonschema](https://github.com/python-jsonschema/jsonschema) or
+[jschon](https://github.com/marksparkza/jschon) implementations.
+
+```sh
+jsu-check tests/foo.schema.json tests/foo.*.value.json
+```
+
+## JSON Schema Stats and Issues
+
+Generate a report about JSON schemas, including possible bugs.
+
+```sh
+jsu-stats tests/*.schema.json
+```
+
+This script is extracted from [JSON Schema Stats](https://github.com/clairey-zx81/json-schema-stats)
+which has been updated to depend on this module.
+
+## JSON Prettyprinter
+
+```sh
+jsu-pretty --indent 2 --sort-keys tests/*.schema.json
+```
+
+You could also use `jq .` for this purpose.
+
+## JSON Schema to JSON Model Conversion
+
+Convert a subset of JSON Schema to JSON Model.
+The subset should comply with some restrictions described in Section 6 of
+[An Analysis of Defects in Public JSON Schemas](https://minesparis-psl.hal.science/hal-04415517/file/A-794-DepotHAL.pdf)
+by Claire Yannou-Medrala and Fabien Coelho:
+
+- `const`, `enum`, `$ref`, `type`, `allOf`, `anyOf`, `oneOf` should be exclusive.
+- some keywords are not supported: `multipleOf`, `contains`
+- conditions `if then else` are translated to the logical equivalent:
+  `{if: C, then: T, else: E}` is _(C and T) or (not C and E)_
+
+```sh
+jsu-model test/foo.schema.json
+```
+
+## TODO
+
+- Testing. CI.
+- stats: warn instead of errors on unsure issues under `if`/`then`/`else`/`not`.
+- propagate non type under containers (`*Of`, `if`, `then`, `else`, reference?)
+  to reduce false positive errors/warnings.
+- simplify: deduplicate constants in enum?

json_schema_utils-0.8/json_schema_utils.egg-info/SOURCES.txt

@@ -0,0 +1,21 @@
+.gitignore
+LICENSE
+MANIFEST.in
+Makefile
+README.md
+pyproject.toml
+json_schema_utils.egg-info/PKG-INFO
+json_schema_utils.egg-info/SOURCES.txt
+json_schema_utils.egg-info/dependency_links.txt
+json_schema_utils.egg-info/entry_points.txt
+json_schema_utils.egg-info/requires.txt
+json_schema_utils.egg-info/top_level.txt
+jsutils/__init__.py
+jsutils/convert.py
+jsutils/inline.py
+jsutils/recurse.py
+jsutils/schemas.py
+jsutils/scripts.py
+jsutils/simplify.py
+jsutils/stats.py
+jsutils/utils.py

json_schema_utils-0.8/json_schema_utils.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

json_schema_utils-0.8/json_schema_utils.egg-info/entry_points.txt

@@ -0,0 +1,7 @@
+[console_scripts]
+jsu-check = jsutils:jsu_check
+jsu-inline = jsutils:jsu_inline
+jsu-model = jsutils:jsu_model
+jsu-pretty = jsutils:jsu_pretty
+jsu-simpler = jsutils:jsu_simpler
+jsu-stats = jsutils:jsu_stats

json_schema_utils-0.8/json_schema_utils.egg-info/requires.txt

@@ -0,0 +1,13 @@
+requests
+jschon
+jsonschema[format]
+
+[dev]
+ruff
+flake8
+pyright
+
+[dist]
+build
+twine
+wheel

json_schema_utils-0.8/json_schema_utils.egg-info/top_level.txt

@@ -0,0 +1 @@
+jsutils

json_schema_utils-0.8/jsutils/__init__.py

@@ -0,0 +1,5 @@
+from jsutils.scripts import (
+    jsu_inline, jsu_simpler, jsu_check, jsu_stats, jsu_pretty, jsu_model
+)
+
+_ = [jsu_inline, jsu_simpler, jsu_check, jsu_stats, jsu_pretty, jsu_model]