StrictYAML

StrictYAML is a type-safe YAML parser that parses and validates a restricted subset of the YAML specification.

Priorities:

Beautiful API
Refusing to parse the ugly, hard to read and insecure features of YAML like the Norway problem.
Strict validation of markup and straightforward type casting.
Clear, readable exceptions with code snippets and line numbers.
Acting as a near-drop in replacement for pyyaml, ruamel.yaml or poyo.
Ability to read in YAML, make changes and write it out again with comments preserved.
Not speed, currently.

Simple example:

# All about the character
name: Ford Prefect
age: 42
possessions:
- Towel

from strictyaml import load, Map, Str, Int, Seq, YAMLError

Default parse result:

>>> load(yaml_snippet)
YAML({'name': 'Ford Prefect', 'age': '42', 'possessions': ['Towel']})

All data is string, list or OrderedDict:

>>> load(yaml_snippet).data
{'name': 'Ford Prefect', 'age': '42', 'possessions': ['Towel']}

Quickstart with schema:

from strictyaml import load, Map, Str, Int, Seq, YAMLError

schema = Map({"name": Str(), "age": Int(), "possessions": Seq(Str())})

42 is now parsed as an integer:

>>> person = load(yaml_snippet, schema)
>>> person.data
{'name': 'Ford Prefect', 'age': 42, 'possessions': ['Towel']}

A YAMLError will be raised if there are syntactic problems, violations of your schema or use of disallowed YAML features:

# All about the character
name: Ford Prefect
age: 42

For example, a schema violation:

try:
    person = load(yaml_snippet, schema)
except YAMLError as error:
    print(error)

while parsing a mapping
  in "<unicode string>", line 1, column 1:
    # All about the character
     ^ (line: 1)
required key(s) 'possessions' not found
  in "<unicode string>", line 3, column 1:
    age: '42'
    ^ (line: 3)

If parsed correctly:

from strictyaml import load, Map, Str, Int, Seq, YAMLError, as_document

schema = Map({"name": Str(), "age": Int(), "possessions": Seq(Str())})

You can modify values and write out the YAML with comments preserved:

person = load(yaml_snippet, schema)
person['age'] = 43
print(person.as_yaml())

# All about the character
name: Ford Prefect
age: 43
possessions:
- Towel

As well as look up line numbers:

>>> person = load(yaml_snippet, schema)
>>> person['possessions'][0].start_line
5

And construct YAML documents from dicts or lists:

print(as_document({"x": 1}).as_yaml())

x: 1

Install

$ pip install strictyaml

Why StrictYAML?

There are a number of formats and approaches that can achieve more or less the same purpose as StrictYAML. I've tried to make it the best one. Below is a series of documented justifications:

Using StrictYAML

How to:

Compound validators:

Scalar validators:

Restrictions:

Design justifications

There are some design decisions in StrictYAML which are controversial and/or not obvious. Those are documented here:

Star Contributors

@wwoods
@chrisburr
@jnichols0

Other Contributors

@eulores
@WaltWoods
@ChristopherGS
@gvx
@AlexandreDecan
@lots0logs
@tobbez
@jaredsampson
@BoboTIG

StrictYAML also includes code from ruamel.yaml, Copyright Anthon van der Neut.

Contributing

Before writing any code, please read the tutorial on contributing to hitchdev libraries.
Before writing any code, if you're proposing a new feature, please raise it on github. If it's an existing feature / bug, please comment and briefly describe how you're going to implement it.
All code needs to come accompanied with a story that exercises it or a modification to an existing story. This is used both to test the code and build the documentation.

Release files for strictyaml 1.7.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for strictyaml 1.7.3
File	Size	Uploaded
strictyaml-1.7.3.tar.gz	115.2 kB	Mar 10, 2023	Details

Built distribution (wheel)

Table of built distributions (wheels) for strictyaml 1.7.3
File	Interpreter	ABI	Platform	Reset
strictyaml-1.7.3-py3-none-any.whl 123.9 kB Mar 10, 2023	Python 3	none	any	Details

Total release size: 239.1 kB

Release files / strictyaml-1.7.3.tar.gz

Download URL	strictyaml-1.7.3.tar.gz
Size	115.2 kB
Tags	Source
SHA-256 checksum How to use checksums	`22f854a5fcab42b5ddba8030a0e4be51ca89af0267961c8d6cfa86395586c407`
BLAKE2b-256 checksum How to use checksums	`b308efd28d49162ce89c2ad61a88bd80e11fb77bc9f6c145402589112d38f8af`
Upload date	Mar 10, 2023
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.6.0 importlib_metadata/3.10.0 pkginfo/1.8.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.8.10`

Release files / strictyaml-1.7.3-py3-none-any.whl

Download URL	strictyaml-1.7.3-py3-none-any.whl
Size	123.9 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`fb5c8a4edb43bebb765959e420f9b3978d7f1af88c80606c03fb420888f5d1c7`
BLAKE2b-256 checksum How to use checksums	`967ca81ef5ef10978dd073a854e0fa93b5d8021d0594b639cc8f6453c3c78a1d`
Upload date	Mar 10, 2023
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.6.0 importlib_metadata/3.10.0 pkginfo/1.8.1 requests/2.26.0 requests-toolbelt/0.9.1 tqdm/4.62.3 CPython/3.8.10`