gcubed.design_files

Strict, versioned design-file parsing and canonical YAML rendering.

class DesignFileError(builtins.ValueError):

Raised when a design document violates its serialization contract.

@dataclass(frozen=True)

class DesignLayerRecord:

One ordered layer entry before model-specific materialisation.

DesignLayerRecord( name: str, data_file: str, event_year: int, description: str | None = None)

name: str

data_file: str

event_year: int

description: str | None = None

effective_description: str

Return the display description, falling back to the layer name.

def load_design_yaml( filename: pathlib.Path) -> tuple[DesignLayerRecord, ...]:

Strictly parse and validate a version-1 YAML design document.

def render_design_yaml(layers: Iterable[DesignLayerRecord]) -> str:

Render ordered layer records as canonical version-1 YAML.

def write_design_yaml( filename: pathlib.Path, layers: Iterable[DesignLayerRecord], *, overwrite: bool = False) -> None:

Atomically write a canonical YAML design after public validation.