Struct Config 

pub struct Config {
    pub slug: String,
    pub log_level: String,
    pub log_level_stdout: String,
    pub log_file: Option<PathBuf>,
    pub kubo_rpc_url: String,
    pub kubo_key_alias: String,
    pub secret_bundle: Option<PathBuf>,
    pub secret_bundle_passphrase: Option<String>,
    pub config_path: Option<PathBuf>,
    pub extra: Mapping,
}

Runtime configuration for a ma daemon.

Build via Config::from_args on native targets or via YAML/string serialization helpers on wasm.

Fields

slug: String

Short printable slug identifying this daemon instance. Used in default file names: <slug>.yaml, <slug>.bin, <slug>.log.

log_level: String

Log level written to the log file (e.g. "info", "debug").

log_level_stdout: String

Log level written to stdout.

log_file: Option<PathBuf>

Path to the log file. None → resolved to XDG_DATA_HOME/ma/<slug>.log on first use.

kubo_rpc_url: String

Kubo JSON-RPC API URL.

kubo_key_alias: String

IPNS key alias registered in Kubo for this daemon.

secret_bundle: Option<PathBuf>

Path to the encrypted secret bundle. None → XDG_CONFIG_HOME/ma/<slug>.bin.

secret_bundle_passphrase: Option<String>

Passphrase to unlock the secret bundle. In headless configs this is stored in cleartext in the YAML file.

config_path: Option<PathBuf>

Path where this config was loaded from or will be saved to.

extra: Mapping

Extra user-defined YAML keys that are not part of the core schema. Preserved during load and save so callers can extend the config freely.

Implementations

impl Config

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

Initialise the global tracing subscriber.

Sets up:

• A file appender writing at self.log_level to self.effective_log_file().
• A stdout writer writing at self.log_level_stdout.

Uses try_init so that calling this more than once (e.g. in tests) does not panic.

impl Config

pub fn new_for_storage(slug: impl AsRef<str>) -> Self

Construct a config value suitable for wasm/local storage workflows.

This constructor is storage-agnostic and does not touch the filesystem.

pub fn from_yaml_str(yaml_text: &str) -> Result<Self>

Deserialize a config value from YAML text without filesystem I/O.

pub fn to_yaml_string(&self) -> Result<String>

Serialize config to YAML text without filesystem I/O.

pub fn to_yaml_string_without_passphrase(&self) -> Result<String>

Serialize config to YAML text while excluding secret passphrase fields.

Useful for browser storage where passphrases should be provided by runtime user input instead of persisted state.

pub fn from_args(args: &MaArgs, default_slug: &'static str) -> Result<Self>

Build a Config by merging CLI arguments, environment variables, a YAML config file, and built-in defaults.

Required compile-time constant

Callers MUST pass a compile-time constant MA_DEFAULT_SLUG: &'static str. This determines BOTH the default slug for file naming AND the fixed env-var prefix MA_<MA_DEFAULT_SLUG>_*. The prefix cannot be changed at runtime; only file naming may be overridden via --slug.

use ma_core::config::{Config, MaArgs};
let args = MaArgs::default();
let config = Config::from_args(&args, "doctest")?;
assert_eq!(config.slug, "doctest");

Priority

For each field the resolution order is:

1. Explicit CLI argument
2. MA_<MA_DEFAULT_SLUG>_FIELD environment variable
3. MA_FIELD environment variable (static fallback)
4. Value from the YAML config file
5. Built-in default

pub fn effective_log_file(&self) -> Result<PathBuf>

The effective log file path: self.log_file if set, otherwise the XDG default XDG_DATA_HOME/ma/<slug>.log.

pub fn effective_secret_bundle(&self) -> Result<PathBuf>

The effective secret bundle path: self.secret_bundle if set, otherwise the XDG default XDG_CONFIG_HOME/ma/<slug>.bin.

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

Save this config to Self::config_path as YAML with 0600 permissions. Returns an error if config_path is not set.

Known fields are serialized explicitly; extra fields are merged in afterwards so user-defined keys are preserved.

pub fn gen_headless(args: &MaArgs, default_slug: &'static str) -> Result<()>

Generate a complete headless config:

1. Generate a fresh SecretBundle with four random 32-byte keys.
2. Encrypt the bundle (using args.secret_bundle_passphrase or a freshly generated random passphrase).
3. Write the encrypted bundle to XDG_CONFIG_HOME/ma/<slug>.bin (or the path from --secret-bundle) with mode 0600.
4. Write the YAML config to XDG_CONFIG_HOME/ma/<slug>.yaml (or the path from --config) with the passphrase in cleartext and mode 0600.
5. Print the paths of both files to stdout.

Returns an error if either file already exists.

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.