Struct RagrigConfig 

pub struct RagrigConfig {
    pub workspace: PathBuf,
    pub chat: ChatConfig,
    pub embed: EmbedConfig,
    pub parse: ParseConfig,
    pub memory: MemoryConfig,
    pub corpus_dirs: Vec<String>,
    pub corpus_urls: Vec<String>,
    pub semantic_scholar_api_key: Option<String>,
}

Top-level configuration for a ragrig session.

Composes ChatConfig, EmbedConfig, ParseConfig, and MemoryConfig into a single format-agnostic tree. Serde support enables JSON/TOML profile files; the CLI binary converts clap arguments into this struct via From.

Entry points

// 1. From CLI (binary only)
let config = RagrigConfig::from(Cli::parse());

// 2. From a profile file (TOML / JSON)
let config: RagrigConfig = toml::from_str(&fs::read_to_string("profile.toml")?)?;

// 3. Programmatic construction
let config = RagrigConfig {
    workspace: "./workspace".into(),
    ..Default::default()
};

Fields

workspace: PathBuf

Workspace directory holding the vector store (.ragrig_store), history, sessions, and profiles. Not a document corpus by itself — documents come from corpus_dirs and corpus_urls. Deserialised from "folder" in older profiles.

chat: ChatConfig

Chat / generation settings.

embed: EmbedConfig

Embedding / search settings.

parse: ParseConfig

Document parsing and chunking settings.

memory: MemoryConfig

Memory / query-rewrite settings.

corpus_dirs: Vec<String>

Named directory corpora in name=path form (repeatable --corpus-dir). Deserialised from "source_dirs" in older profiles.

corpus_urls: Vec<String>

Named URL corpora in name=url form (repeatable --corpus-urls; repeating a name accumulates URLs into one curated list). Deserialised from "source_urls" in older profiles.

semantic_scholar_api_key: Option<String>

Semantic Scholar API key for higher rate limits (free). See https://www.semanticscholar.org/product/api#api-key-form for a key.

Implementations

impl RagrigConfig

pub fn from_toml(src: &str) -> Result<Self>

Parse a RagrigConfig from a TOML document (file contents or an inline string). Missing sub-tables and fields fall back to the library defaults.

pub fn from_json(src: &str) -> Result<Self>

Parse a RagrigConfig from a JSON document. Missing sub-tables and fields fall back to the library defaults.

pub fn override_with(&mut self, cli: &RagrigConfig)

Merge cli overrides on top of this config (typically loaded from a profile).

Fields where cli equals RagrigConfig::default() are left untouched — they were not explicitly set by the user. Only explicitly-changed fields from the CLI override the profile base.

pub fn profiles_dir(folder: &Path) -> PathBuf

Directory where profile JSON files live for a given document folder.

pub fn save_to_profile(&self, folder: &Path, name: &str) -> Result<(), Error>

Save this config as a named profile under folder.

Creates .ragrig/profiles/<name>.json. The workspace field of the config is not written — profiles are portable across machines; the caller’s folder argument (the workspace) is what counts and is supplied again at load time.

pub fn load_from_profile(folder: &Path, name: &str) -> Result<Self, Error>

Load a named profile from .ragrig/profiles/<name>.json.

The caller’s folder (the workspace) is authoritative: a workspace value written into the file by an older version is ignored, so a profile copied from another machine can never re-point the workspace.

pub fn list_profiles(folder: &Path) -> Result<Vec<String>, Error>

List all saved profile names under folder.

Trait Implementations

impl Clone for RagrigConfig

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RagrigConfig

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

Formats the value using the given formatter.

impl Default for RagrigConfig

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for RagrigConfig

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for RagrigConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.