Struct ConfigShape 

pub struct ConfigShape {
    pub lib: Symbol,
    pub shape: Arc<dyn Shape>,
    pub defaults: ConfigTable,
    pub secret_keys: Vec<String>,
}

Shape-backed contract for one library’s configuration table.

Fields

lib: Symbol

Library id whose configuration this shape validates.

shape: Arc<dyn Shape>

Shape applied to the effective table after built-in defaults are bound.

defaults: ConfigTable

Built-in defaults for absent fields.

secret_keys: Vec<String>

Top-level keys whose values are secret-bearing.

Implementations

impl ConfigShape

pub fn new(lib: Symbol, shape: Arc<dyn Shape>, defaults: ConfigTable) -> Self

Creates a config shape with no secret keys.

pub fn with_secret_keys( self, keys: impl IntoIterator<Item = impl Into<String>>, ) -> Self

Adds secret keys, deduplicating them at the shape boundary.

pub fn validate( &self, cx: &mut Cx, table: &ConfigTable, ) -> ConfigShapeResult<ConfigTable>

Validates table against this shape and returns the default-bound table.

Built-in defaults are the lowest-precedence layer. The supplied table overlays them, then the configured shape checks the effective table. A closed table shape therefore reports unknown fields while defaults may satisfy required fields.

pub fn defaults_layer(&self) -> ConfigLayer

Returns this shape’s built-in defaults as a merge layer.

pub fn marks_secret(&self, key: &str) -> bool

Returns true when key is marked as secret-bearing by this shape.

pub fn secret_fields(&self) -> Vec<ConfigSecretField>

Returns secret field records for report and redaction code.

Trait Implementations

impl Clone for ConfigShape

fn clone(&self) -> ConfigShape

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.