configuration_yaml
Full name: ase2sprkkr.configuration_yaml
Description
YAML persistence helpers for the ASE2SPRKKR configuration.
The YAML document is kept separate from the typed configuration. Loading first tries the whole document atomically; if a user-data error is found, valid fragments are recovered while invalid/unknown raw nodes remain available for round-trip persistence.
Functions
|
|
|
Return the subset of |
|
|
|
|
|
Recover valid logical units after an atomic load has failed. |
|
|
|
Recover a normal section, then fall back to individual options. |
|
Apply persisted data atomically through the privileged profile path. |
|
Serialize an argv-like value as one shell-escaped command string. |
|
Stage persisted data, including the private legacy profile. |
|
Convert command argv values to the canonical YAML representation. |
|
Convert shell-string YAML values to the typed configuration shape. |
|
Synchronize known values while leaving unaccepted raw nodes untouched. |
|
Return an error if the configured implicit profile cannot be resolved. |
|
|
|
|
|
Apply a complete YAML mapping atomically to a configuration object. |
|
Atomically replace a YAML document, retaining existing symlinks and mode. |
|
Return explicitly stored values in their canonical YAML representation. |
|
Load YAML strictly first, then recover independent valid fragments. |
|
Load a YAML mapping while retaining comments and formatting metadata. |
|
Persist explicit values without destroying unknown or invalid YAML. |
Exceptions
The YAML document has no usable top-level mapping. |
|
Problems found while reading an invalid user YAML config. |