Struct Config 

pub struct Config {
    pub embeddings: EmbeddingsConfig,
    pub search: SearchConfig,
    pub maintenance: MaintenanceConfig,
    pub runtime: RuntimeConfig,
    pub sources: BTreeMap<String, Value>,
    pub storage: StorageConfig,
    pub creds: BTreeMap<String, CredsSet>,
}

Top-level config.toml shape.

Fields

embeddings: EmbeddingsConfig

search: SearchConfig

maintenance: MaintenanceConfig

runtime: RuntimeConfig

sources: BTreeMap<String, Value>

[sources.<adapter>] map: per-adapter config blobs the matching factory deserializes inside its open(). The shape is adapter-defined (filesystem adapters expect { path = "..." }; API-backed adapters expect endpoint + auth keys), so this layer stays opaque. Empty by default; pond sync runs discovery into this map on first use.

storage: StorageConfig

[storage]: the default destination URL (spec.md#storage-url-grammar). None = the platform-local data dir.

creds: BTreeMap<String, CredsSet>

[creds.<name>]: URL-scoped credential sets. Every storage URL resolves its own set by longest-prefix scope match (spec.md#creds-scope-match); the resolver lives in pond::substrate.

Implementations

impl Config

pub fn load(path: impl AsRef<Path>) -> Result<Self>

Load config.toml from path (if it exists) layered under the POND_* env mirror, and validate. A missing file yields the built-in defaults - env vars alone are a complete config (spec.md#storage-configless). On success the resolved embedding model id + dim are installed into the process (OnceLock-backed; only the first call per process sticks), so all downstream code paths see a consistent pair without per-handler plumbing.

pub fn load_str(body: &str) -> Result<Self>

Config::load over an in-memory TOML body (still layered under the POND_* env mirror). pond init uses this to validate and resolve the config it is composing BEFORE anything touches disk - the wizard writes exactly once, at the end.

pub fn load_with_provenance(path: impl AsRef<Path>) -> Result<(Self, Figment)>

Config::load that also returns the figment, so pond config show can attribute each value to its source layer (file / env / default).

pub fn resolve_sources( &self, adapter: Option<&str>, ) -> Result<Vec<(String, Value)>>

Resolve the [sources.<adapter>] entries to drive pond sync. Only sections with enabled = true flow through; sections with enabled = false (or absent) are treated as opt-out and the per-adapter blob (minus enabled) is handed to the factory’s open(). With adapter = None returns every enabled entry; with Some(name) returns just that one - and errors if it’s not in config OR if it’s currently disabled (the caller should then re-prompt or report).

pub fn disabled_source_names(&self) -> Vec<&str>

Names that are configured but currently enabled = false. Used by pond sync post-import to know not to re-probe an adapter the user already declined (the decline persists; re-prompt only via the positional override pond sync <name>).

Trait Implementations

impl Clone for Config

fn clone(&self) -> Config

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Config

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

Formats the value using the given formatter.

impl Default for Config

fn default() -> Config

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Config

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for Config

fn eq(&self, other: &Config) -> 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 Config

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Config