Skip to content

specs

sqllocks_spindle.specs

Generation Spec Language (GSL) parser.

Classes

GenerationSpec dataclass

Complete Generation Spec Language document.

Represents a fully resolved GSL YAML file that ties together a schema, a scenario pack, chaos configuration, output targets, and validation gates.

Methods:
resolve_path(relative)

Resolve a relative path against the spec file's directory.

GSLParser

Parse Generation Spec Language (GSL) YAML files.

Example::

parser = GSLParser()
spec = parser.parse("my_estate.gsl.yaml")
print(spec.name, spec.scenario.scale)
Methods:
parse(path)

Parse a GSL YAML file and return a GenerationSpec.

Relative paths in the spec are resolved relative to the spec file's parent directory.

parse_dict(raw, base_dir='.')

Parse a GSL spec from a raw dict (useful for tests).