Struct Config 

pub struct Config {

    pub provider: String,
    pub model: Option<String>,
    pub language: String,
    pub output: String,
    pub output_file: Option<PathBuf>,
    pub timestamps: bool,
    pub verbose: bool,
    pub openrouter_api_key: Option<SecretString>,
    pub openrouter_base_url: String,
    pub openrouter_default_model: String,
    pub openrouter_allow_custom_endpoint: bool,
    pub openrouter_stt_mode: String,
    pub openrouter_use_system_proxy: bool,
    pub cleanup_style: String,
    pub cleanup_provider: String,
    pub cleanup_openrouter_model: Option<String>,
    pub tts_provider: String,
    pub tts_model: String,
    pub tts_voice: String,
    pub tts_language: String,
    pub tts_max_chars: usize,
    pub tts_timeout_ms: u64,
    pub tts_pack_dir: Option<PathBuf>,
    pub tts_allow_unverified: bool,
    pub tts_custom_models: Vec<CustomTtsModelConfig>,
    pub config_path: Option<PathBuf>,
    pub cache_dir: PathBuf,
}

Fully-resolved runtime configuration after merging all sources.

Fields

provider: String

model: Option<String>

language: String

output: String

output_file: Option<PathBuf>

timestamps: bool

verbose: bool

openrouter_api_key: Option<SecretString>

Remote API key — redacted via crate::secret::SecretString Debug/Display (JOE-1779).

openrouter_base_url: String

openrouter_default_model: String

openrouter_allow_custom_endpoint: bool

Allow custom credentialed endpoints (JOE-1587).

openrouter_stt_mode: String

auto | chat | transcriptions (JOE-1586).

openrouter_use_system_proxy: bool

cleanup_style: String

Cleanup style name (raw, clean, …).

cleanup_provider: String

Cleanup backend name (rules, openrouter).

cleanup_openrouter_model: Option<String>

Optional dedicated model for OpenRouter cleanup.

tts_provider: String

TTS provider name (local only in MVP).

tts_model: String

tts_voice: String

tts_language: String

tts_max_chars: usize

tts_timeout_ms: u64

tts_pack_dir: Option<PathBuf>

Optional default pack directory for local override (JOE-1619).

tts_allow_unverified: bool

tts_custom_models: Vec<CustomTtsModelConfig>

Validated custom TTS catalogue entries (empty when packs not present yet).

config_path: Option<PathBuf>

cache_dir: PathBuf

Implementations

impl Config

pub fn default_config_path() -> Option<PathBuf>

Resolve the platform-appropriate config file path.

pub fn default_cache_dir() -> Result<PathBuf>

Resolve the platform-appropriate cache directory (models live under models/).

pub fn load() -> Result<Self>

Load config file from the default location (if present) and merge with env vars.

Always validates [[tts.custom_models]] so reserved/builtin IDs cannot silently shadow the catalogue (JOE-1576/1620).

pub fn load_from(path: &Path) -> Result<Self>

Load from an explicit config file path (used in tests / CLI --config).

When the path does not exist, returns defaults (historical behavior). Prefer Self::load_from_required when a missing file must be an error. Validates custom TTS catalogue entries when present.

pub fn load_from_required(path: &Path) -> Result<Self>

Load from an explicit path; error if the file is missing (JOE-1608).

pub fn openrouter_api_key_exposed(&self) -> Option<String>

Expose the OpenRouter API key as a plain string for provider construction. Prefer not logging the return value.

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

Validate provider/model/style/limit cross-fields (JOE-1608).

pub fn validate_tts_custom_models(&self) -> Result<()>

Validate [[tts.custom_models]] uniqueness and reserved namespaces. Full pack verification runs when pack_dir paths exist on disk.

pub fn effective_diagnostic(&self) -> EffectiveConfigDiagnostic

Redacted diagnostic view for --print-effective-config (JOE-1608).

pub fn apply_cli( &mut self, provider: Option<&str>, model: Option<&str>, language: Option<&str>, output: Option<&str>, output_file: Option<&Path>, timestamps: bool, verbose: bool, cleanup: Option<&str>, cleanup_provider: Option<&str>, cleanup_model: Option<&str>, )

Apply CLI overrides on top of the loaded config.

pub fn resolve_model(&self, model_explicitly_set: bool) -> Result<String>

Resolve the effective model for the active provider.

When model_explicitly_set is false and the provider is openrouter, a bare local whisper name (e.g. config default base) is replaced with the openrouter default model id. Resolve model for the active provider.

Returns Err if OpenRouter is selected with an explicit bare local whisper name (e.g. --provider openrouter --model tiny) — that cannot be a remote model id.

Trait Implementations

impl AsRef<Config> for ValidatedConfig

fn as_ref(&self) -> &Config

Converts this type into a shared reference of the (usually inferred) input type.

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.