StrictYAML is a type-safe YAML parser that parses a restricted subset of the YAML specificaton.
Priorities:
Readability of YAML.
Ease of use of API.
Secure by default.
Strict validation of markup and straightforward type casting.
Clear, human readable exceptions with line numbers.
Acting as a near-drop in replacement for pyyaml, ruamel.yaml or poyo.
Roundtripping - reading in (commented) YAML and writing it out with comments.
Letting you worry about more interesting things than parsing or writing config files.
Simple example:
# All about the character
name: Ford Prefect
age: 42
possessions:
- TowelDefault parse result:
>>> strictyaml.load(yaml)
YAML({'possessions': ['Towel'], 'age': '42', 'name': 'Ford Prefect'})
>>> strictyaml.load(yaml).data
{"name": "Ford Prefect", "age": "42", "possessions": ["Towel", ]} # All data is str, list or dictUsing a schema:
>>> from strictyaml import load, Map, Str, Int, Seq
>>> person = load(yaml, Map({"name": Str(), "age": Int(), "possessions": Seq(Str())})) \
>>> person.data == {"name": "Ford Prefect", "age": 42, "possessions": ["Towel", ]} # 42 is now an intOnce parsed you can change values and roundtrip the whole YAML, with comments preserved:
>>> person['age'] = load('43')
>>> print(person.as_yaml())
# All about the character
name: Ford Prefect
age: 43
possessions:
- TowelAs well as look up line numbers:
>>> person['possessions'][0].start_line
5See more example driven documentation.
Install It
$ pip install strictyamlFAQ
From learning programmers:
If you’re looking at this and thinking “why not do/use X instead?” that’s a healthy response, and you deserve answers. These are probably the questions you’re asking:
Breaking changes
0.5: Data is now parsed by default as a YAML object instead of directly to dict/list. To get dict/list and ordinary values as before, get yaml_object.data.
0.7: Roundtripping now requires that you only assign YAML objects to index: e.g. yaml_object[‘x’] = another_yaml_obj
Contributors
@gvx
@AlexandreDecan
@lots0logs
1 maintainer
Metadata
1 maintainer
Release files for strictyaml 0.7.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| strictyaml-0.7.0.tar.gz | 11.0 kB | Details |
Release files / strictyaml-0.7.0.tar.gz
| Download URL | strictyaml-0.7.0.tar.gz |
|---|---|
| Size | 11.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e0fddfc2a2a0f8735363a488ae80d62aeb433c7605ac36c3c47b66822db2bb6c
|
|
BLAKE2b-256 checksum How to use checksums |
63acea0520ea4b36e5bfe497658543e478b52c698645c439066e947ac915a144
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
