Struct RuntimoConfig 

pub struct RuntimoConfig {
    pub allowed_paths: Vec<String>,
}

Runtimo persistent configuration.

Fields

allowed_paths: Vec<String>

Additional allowed path prefixes (merged with defaults + env var).

Implementations

impl RuntimoConfig

pub fn config_path() -> PathBuf

Returns the config file path following XDG spec.

Uses XDG_CONFIG_HOME if set, otherwise ~/.config/runtimo/config.toml.

Falls back to /tmp/runtimo/config.toml with a stderr warning when neither XDG_CONFIG_HOME nor HOME is set. Configuration in /tmp is not persistent across reboots.

pub fn load() -> Self

Loads config from disk, returning defaults if the file doesn’t exist or is invalid.

Logs a warning to stderr when the file exists but cannot be read or parsed. Prefer [load_result] for new code — it propagates errors so callers can distinguish “file doesn’t exist” from “file is corrupt.”

pub fn load_result() -> Result<Self, String>

Loads config from disk, propagating read and parse errors.

Input

Reads from the path returned by [config_path] if it exists.

Output

Ok(RuntimoConfig) — Successfully deserialized config, or default if file doesn’t exist.

Errors

Returns Err(String) when the config file:

• Exists but cannot be opened (permission denied, filesystem error)
• Can be opened but contains invalid TOML syntax
• Contains TOML that deserializes to a different type (schema mismatch)

Returns Ok(Self::default()) when:

• The config file does not exist (first run / clean install)
• The config file is empty (no config needed)

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

Saves config to disk, creating parent directories as needed.

Errors

Returns an error if parent directories cannot be created or if the config file cannot be serialized/written to disk.

pub fn get_allowed_prefixes() -> Vec<String>

Returns merged prefixes: defaults + env var + config file.

Priority (lowest to highest):

1. Built-in defaults
2. RUNTIMO_ALLOWED_PATHS env var
3. Config file allowed_paths

Trait Implementations

impl Clone for RuntimoConfig

fn clone(&self) -> RuntimoConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RuntimoConfig

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

Formats the value using the given formatter.

impl Default for RuntimoConfig

fn default() -> RuntimoConfig

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for RuntimoConfig

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for RuntimoConfig

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

where __S: Serializer,

Serialize this value into the given Serde serializer.