Struct ConfigLayerStack 

pub struct ConfigLayerStack { /* private fields */ }

Implementations

impl ConfigLayerStack

pub fn new( layers: Vec<ConfigLayerEntry>, requirements: ConfigRequirements, requirements_toml: ConfigRequirementsToml, ) -> Result<Self>

pub fn with_user_and_project_exec_policy_rules_ignored( self, ignore_user_and_project_exec_policy_rules: bool, ) -> Self

pub fn ignore_user_and_project_exec_policy_rules(&self) -> bool

pub fn startup_warnings(&self) -> Option<&[String]>

pub fn get_active_user_layer(&self) -> Option<&ConfigLayerEntry>

Returns the active raw user config layer, if any.

This does not merge other config layers or apply any requirements. When a profile-v2 layer is active, this returns that profile layer rather than the base $CODEX_HOME/config.toml layer because the active layer is the writable target for profile-aware edits.

pub fn get_user_config_file(&self) -> Option<&AbsolutePathBuf>

pub fn get_user_layers( &self, ordering: ConfigLayerStackOrdering, include_disabled: bool, ) -> Vec<&ConfigLayerEntry>

Returns all user config layers in the requested precedence order.

With profile-v2 enabled, LowestPrecedenceFirst returns the base user config before the profile overlay, while HighestPrecedenceFirst returns the profile overlay before the base user config.

pub fn effective_user_config(&self) -> Option<TomlValue>

Returns the merged config from enabled user layers only.

When profile config is active, this includes the base user config followed by the profile override config.

pub fn requirements(&self) -> &ConfigRequirements

pub fn requirements_toml(&self) -> &ConfigRequirementsToml

pub fn with_user_config( &self, config_toml: &AbsolutePathBuf, user_config: TomlValue, ) -> Result<Self>

Creates a new ConfigLayerStack using the specified values to inject one user layer into the stack. If such a layer already exists, it is replaced; otherwise, it is inserted into the stack at the appropriate position based on precedence rules. When the stack has both base and profile-v2 user layers, this updates only the layer whose file matches config_toml.

pub fn with_user_config_profile( &self, config_toml: &AbsolutePathBuf, profile: Option<&ProfileV2Name>, user_config: TomlValue, ) -> Result<Self>

pub fn with_user_layer_from(&self, other: &Self) -> Self

Returns a new stack with the user layer copied from other, preserving every non-user layer already present in this stack.

pub fn effective_config(&self) -> TomlValue

Returns the merged config-layer view.

This only merges ordinary config layers. Requirements are composed and tracked separately.

pub fn origins(&self) -> HashMap<String, ConfigLayerMetadata>

Returns field origins for the merged config-layer view.

Requirement sources are tracked separately and are not included here.

pub fn layers_high_to_low(&self) -> Vec<&ConfigLayerEntry>

Returns config layers from highest precedence to lowest precedence.

Requirement sources are tracked separately and are not included here.

pub fn get_layers( &self, ordering: ConfigLayerStackOrdering, include_disabled: bool, ) -> Vec<&ConfigLayerEntry>

Returns config layers in the requested precedence order.

Requirement sources are tracked separately and are not included here.

Trait Implementations

impl Clone for ConfigLayerStack

fn clone(&self) -> ConfigLayerStack

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ConfigLayerStack

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ConfigLayerStack

fn default() -> ConfigLayerStack

Returns the “default value” for a type.

impl PartialEq for ConfigLayerStack

fn eq(&self, other: &ConfigLayerStack) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for ConfigLayerStack