Struct FileConfig 

pub struct FileConfig {

    pub api_key: Option<String>,
    pub base_url: Option<String>,
    pub model_hint: Option<String>,
    pub timeout_secs: Option<u64>,
    pub max_retries: Option<u32>,
    pub extra_headers: Option<HashMap<String, String>>,
    pub cache: Option<FileCacheConfig>,
    pub budget: Option<FileBudgetConfig>,
    pub cooldown_secs: Option<u64>,
    pub rate_limit: Option<FileRateLimitConfig>,
    pub health_check_secs: Option<u64>,
    pub cost_tracking: Option<bool>,
    pub tracing: Option<bool>,
    pub providers: Option<Vec<FileProviderConfig>>,
}

TOML file representation of client configuration.

All fields are optional — missing fields use defaults from [ClientConfigBuilder]. Convert to a builder via FileConfig::into_builder.

Example liter-llm.toml

api_key = "sk-..."
base_url = "https://api.openai.com/v1"
timeout_secs = 120
max_retries = 5

[cache]
max_entries = 512
ttl_seconds = 600
backend = "memory"

[budget]
global_limit = 50.0
enforcement = "hard"

[[providers]]
name = "my-provider"
base_url = "https://my-llm.example.com/v1"
model_prefixes = ["my-provider/"]

Fields

api_key: Option<String>

base_url: Option<String>

model_hint: Option<String>

timeout_secs: Option<u64>

max_retries: Option<u32>

extra_headers: Option<HashMap<String, String>>

cache: Option<FileCacheConfig>

budget: Option<FileBudgetConfig>

cooldown_secs: Option<u64>

rate_limit: Option<FileRateLimitConfig>

health_check_secs: Option<u64>

cost_tracking: Option<bool>

tracing: Option<bool>

providers: Option<Vec<FileProviderConfig>>

Implementations

impl FileConfig

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

Load from a TOML file path.

pub fn from_toml_str(s: &str) -> Result<Self>

Parse from a TOML string.

pub fn discover() -> Result<Option<Self>>

Discover liter-llm.toml by walking from current directory to filesystem root.

Returns Ok(None) if no config file is found.

pub fn into_builder(self) -> ClientConfigBuilder

Convert into a ClientConfigBuilder, applying all fields that are set.

Fields not present in the TOML file use the builder’s defaults.

pub fn providers(&self) -> &[FileProviderConfig]

Get the custom provider configurations from this file config.

Trait Implementations

impl Clone for FileConfig

fn clone(&self) -> FileConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FileConfig

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for FileConfig

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.