Struct MaArgs 

pub struct MaArgs {
    pub config: Option<PathBuf>,
    pub slug: Option<String>,
    pub log_level: Option<String>,
    pub log_file: Option<PathBuf>,
    pub log_level_stdout: Option<String>,
    pub did_resolver_positive_ttl_secs: Option<u64>,
    pub did_resolver_negative_ttl_secs: Option<u64>,
    pub secret_bundle: Option<PathBuf>,
    pub secret_bundle_passphrase: Option<String>,
    pub kubo_rpc_url: Option<String>,
    pub kubo_key_alias: Option<String>,
    pub gen_headless_config: bool,
}

Standard ma-core CLI arguments.

Add these to your binary with #[command(flatten)].

All fields are resolved from MA_* environment variables, a YAML config file, and built-in defaults — in that priority order.

Fields

config: Option<PathBuf>

Path to the YAML config file. Overrides the slug-derived default (XDG_CONFIG_HOME/ma/<slug>.yaml).

Environment variable: MA_CONFIG

slug: Option<String>

Runtime slug. Overrides MA_DEFAULT_SLUG for file naming (<slug>.yaml, <slug>.bin, <slug>.log) only.

Environment variable: MA_SLUG

log_level: Option<String>

Log level for the log file (trace, debug, info, warn, error).

Environment variable: MA_LOG_LEVEL. Falls back to YAML → default "info".

log_file: Option<PathBuf>

Path to the log file. Defaults to XDG_DATA_HOME/ma/<slug>.log.

Environment variable: MA_LOG_FILE. Falls back to YAML → XDG default.

log_level_stdout: Option<String>

Log level for stdout output (trace, debug, info, warn, error).

Environment variable: MA_LOG_LEVEL_STDOUT. Falls back to YAML → default "warn".

did_resolver_positive_ttl_secs: Option<u64>

Positive DID cache TTL in seconds.

Set to 0 to disable caching successful DID resolutions. Environment variable: MA_DID_RESOLVER_POSITIVE_TTL_SECS. Falls back to YAML → default 60.

did_resolver_negative_ttl_secs: Option<u64>

Negative DID cache TTL in seconds.

Set to 0 to disable caching failed DID resolutions. Environment variable: MA_DID_RESOLVER_NEGATIVE_TTL_SECS. Falls back to YAML → default 10.

secret_bundle: Option<PathBuf>

Path to the encrypted secret bundle file. Defaults to XDG_CONFIG_HOME/ma/<slug>.bin.

Environment variable: MA_SECRET_BUNDLE. Falls back to YAML → XDG default.

secret_bundle_passphrase: Option<String>

Passphrase to unlock the secret bundle.

In headless configs this is stored in cleartext in the YAML file. Prefer setting via environment variable rather than CLI to avoid shell history exposure.

Environment variable: MA_SECRET_BUNDLE_PASSPHRASE. Falls back to YAML.

kubo_rpc_url: Option<String>

Kubo RPC API URL. Defaults to http://127.0.0.1:5001.

Environment variable: MA_KUBO_RPC_URL. Falls back to YAML → default.

kubo_key_alias: Option<String>

IPNS key alias used in Kubo. Defaults to the slug.

Environment variable: MA_KUBO_KEY_ALIAS. Falls back to YAML → slug.

gen_headless_config: bool

Generate a headless config with a fresh secret bundle, write both files with 0600 permissions, and exit.

If --secret-bundle-passphrase is not provided, a random passphrase is generated and written into the config file.

Trait Implementations

impl Args for MaArgs

fn group_id() -> Option<Id>

Report the ArgGroup::id for this set of arguments

fn augment_args<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate Self via FromArgMatches::from_arg_matches_mut

fn augment_args_for_update<'b>(__clap_app: Command) -> Command

Append to Command so it can instantiate self via FromArgMatches::update_from_arg_matches_mut

impl Clone for MaArgs

fn clone(&self) -> MaArgs

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MaArgs

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

Formats the value using the given formatter.

impl Default for MaArgs

fn default() -> MaArgs

Returns the “default value” for a type.

impl FromArgMatches for MaArgs

fn from_arg_matches(__clap_arg_matches: &ArgMatches) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn from_arg_matches_mut( __clap_arg_matches: &mut ArgMatches, ) -> Result<Self, Error>

Instantiate Self from ArgMatches, parsing the arguments as needed.

fn update_from_arg_matches( &mut self, __clap_arg_matches: &ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.

fn update_from_arg_matches_mut( &mut self, __clap_arg_matches: &mut ArgMatches, ) -> Result<(), Error>

Assign values from ArgMatches to self.