Struct SourceReplacementSettings 

pub struct SourceReplacementSettings {
    pub entries: BTreeMap<SourceLocator, SourceReplacementEntry>,
}

Collection of source-replacement entries plus typed resolution / cycle detection.

Built by cabin-config’s merger from the highest-priority config file’s [source-replacement] table; lower-priority files contribute additional entries when their original key is not already covered, so the resulting map preserves the same “higher level overrides” semantics the rest of the config layer uses.

Fields

entries: BTreeMap<SourceLocator, SourceReplacementEntry>

(original -> entry) keyed by the source being replaced. BTreeMap keeps iteration deterministic for metadata + lockfile serialization.

Implementations

impl SourceReplacementSettings

pub fn is_empty(&self) -> bool

Whether the table carries no entries. Used by the workspace loader / metadata view to skip emitting empty blocks.

pub fn resolve( &self, initial: &SourceLocator, ) -> Result<SourceReplacementResolution, SourceReplacementError>

Resolve initial through the replacement chain. Returns the terminal source plus the chain of intermediate originals (in walk order) so the lockfile / metadata view can record the full hop list.

Cycles surface a SourceReplacementError::Cycle carrying the offending hop list so users see exactly which entries form the loop.

Errors

Returns SourceReplacementError::Cycle when the replacement chain revisits a source, carrying the hop list up to and including the repeated entry.

pub fn replaces(&self, original: &SourceLocator) -> bool

Whether the supplied original source has a replacement declared. Useful when the orchestration layer wants to know if applying replacement changed anything (so the metadata / lockfile view can show “unchanged” cleanly).

Trait Implementations

impl Clone for SourceReplacementSettings

fn clone(&self) -> SourceReplacementSettings

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SourceReplacementSettings

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

Formats the value using the given formatter.

impl Default for SourceReplacementSettings

fn default() -> SourceReplacementSettings

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for SourceReplacementSettings

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for SourceReplacementSettings

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for SourceReplacementSettings

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for SourceReplacementSettings

impl StructuralPartialEq for SourceReplacementSettings