Struct SourcesConfig 

pub struct SourcesConfig {
    pub sources: Vec<SourceDefinition>,
    pub disabled_agents: Vec<String>,
}

Root configuration containing all source definitions.

Fields

sources: Vec<SourceDefinition>

List of configured sources.

disabled_agents: Vec<String>

Connectors to skip during indexing even if their files exist locally or in configured remote mirrors.

Implementations

impl SourcesConfig

pub fn load() -> Result<Self, ConfigError>

Load configuration from the default location.

Returns an empty config if the file doesn’t exist.

pub fn load_from(path: &PathBuf) -> Result<Self, ConfigError>

Load configuration from a specific path.

pub fn save(&self) -> Result<(), ConfigError>

Save configuration to the default location.

pub fn save_to(&self, path: &Path) -> Result<(), ConfigError>

Save configuration to a specific path.

pub fn config_path() -> Result<PathBuf, ConfigError>

Get the default configuration file path.

Uses XDG conventions:

• Primary: $XDG_CONFIG_HOME/cass/sources.toml
• Fallback: platform-specific config dir (e.g., ~/.config/cass/sources.toml on Linux)

pub fn validate(&self) -> Result<(), ConfigError>

Validate all sources in the configuration.

pub fn find_source(&self, name: &str) -> Option<&SourceDefinition>

Find a source by name.

pub fn find_source_mut(&mut self, name: &str) -> Option<&mut SourceDefinition>

Find a source by name (mutable).

pub fn add_source( &mut self, source: SourceDefinition, ) -> Result<(), ConfigError>

Add a new source. Returns error if name already exists.

pub fn remove_source(&mut self, name: &str) -> bool

Remove a source by name. Returns true if found and removed.

pub fn remote_sources(&self) -> impl Iterator<Item = &SourceDefinition>

Get all remote sources (SSH type).

pub fn configured_disabled_agents(&self) -> Vec<String>

pub fn is_agent_disabled(&self, agent: &str) -> bool

pub fn exclude_agent_from_indexing( &mut self, agent: &str, ) -> Result<bool, ConfigError>

pub fn include_agent_in_indexing( &mut self, agent: &str, ) -> Result<bool, ConfigError>

impl SourcesConfig

pub fn write_with_backup(&self) -> Result<BackupInfo, ConfigError>

Write configuration with backup.

Creates a uniquely named backup of the existing config (if any) before writing the new configuration atomically.

pub fn merge_source( &mut self, source: SourceDefinition, ) -> Result<MergeResult, ConfigError>

Merge a source into the configuration.

Returns MergeResult::Added if the source was added, or MergeResult::AlreadyExists if a source with the same name exists.

pub fn merge_preview( &mut self, preview: &ConfigPreview, ) -> Result<(usize, Vec<String>), ConfigError>

Merge multiple sources from a preview.

Returns a tuple of (added_count, skipped_names).

pub fn configured_names(&self) -> HashSet<String>

Get set of configured source names.

pub fn configured_name_keys(&self) -> HashSet<String>

Get normalized source-name keys for duplicate detection and lookups.

Trait Implementations

impl Clone for SourcesConfig

fn clone(&self) -> SourcesConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SourcesConfig

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

Formats the value using the given formatter.

impl Default for SourcesConfig

fn default() -> SourcesConfig

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for SourcesConfig

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for SourcesConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.