Metadata-Version: 2.4
Name: forestwalker
Version: 0.1
Summary: A library for walking JSON-like trees, parsing and validating them.
Project-URL: Repository, https://github.com/gollux/forestwalker.git
Project-URL: Documentation, https://forestwalker.readthedocs.io/en/latest/
Project-URL: Issues, https://github.com/gollux/forestwalker/issues
Author-email: Martin Mareš <mj@ucw.cz>
License-Expression: MIT
License-File: LICENSE
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: File Formats :: JSON
Requires-Python: >=3.11
Description-Content-Type: text/markdown

# The Forest Walker

Python modules for parsing JSON, TOML, YAML, and similar formats
produce simple tree structures composed of numbers, strings, Booleans,
arrays, and dictionaries. These structures are then parsed for the second
time to produce more Pythonic data structures. This usually involves
validation of some kind.

We firmly believe that parsing and validation should not be separate
steps: structure of data should have a single source of truth (doing 
otherwise opens door to security issues). Also, existing formal descriptions
of syntax (e.g., JSON schema) are too weak for many purposes and unwieldy
for others.

Enters the ``forestwalker``. A Python module that makes it easy to traverse
trees, parse values while checking types, and report invalid data with
their precise location in the tree.

## License

The Forest Walker was written by Martin Mareš <mj@ucw.cz>.
It can be freely used and distributed under the MIT License.
