Struct Config 

pub struct Config {
    pub api_url: Option<String>,
    pub org: Option<String>,
    pub preferences: Preferences,
}

Persistent CLI configuration at ~/.harmont/config.toml.

Fields

api_url: Option<String>

Base URL for the Harmont API.

org: Option<String>

Currently active organization slug.

preferences: Preferences

User preferences.

Implementations

impl Config

pub fn path() -> Result<PathBuf>

Returns the path to the config file (~/.harmont/config.toml).

Errors

Returns an error if user_config_dir fails (no home directory available).

pub fn load() -> Result<Self>

Load configuration from disk, returning defaults if the file does not exist.

Errors

Returns an error if the config path cannot be resolved, the file exists but cannot be read (permissions, I/O error), or the file contents are not valid TOML matching the Config shape.

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

Persist configuration to disk atomically, with the config directory (~/.harmont/) restricted to 0o700 so adjacent credential files are not exposed.

Errors

Returns an error if the config path cannot be resolved, the Config cannot be serialized to TOML (only happens for non-string map keys, which Config does not have), or the atomic write fails (out-of-space, permission denied, parent directory cannot be created).

pub fn api_url(&self) -> &str

Effective API URL (config value or default).

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 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.