Module config 

Engine config file and credential-storage selection. Engine configuration file and credential-storage selection.

cli-engine reads an optional per-application TOML config file at <config-base>/<app_id>/config.toml, where <config-base> is $XDG_CONFIG_HOME, $HOME/Library/Application Support (macOS), $HOME/.config (other Unix), or %APPDATA% (Windows) (see config_base_dir). Loading is best-effort: a missing file yields defaults, and a malformed file logs a warning and falls back to defaults rather than failing the command.

Two engine-reserved settings live here today:

• Where credentials are stored — see CredentialStore. The effective mode is resolved with the precedence

  --credential-store flag  >  ${PREFIX}_CREDENTIAL_STORE env  >  config file  >  default (Auto)

  See resolve_credential_store and the pure resolve_credential_store_with.

• The default output format for a user who never sets --output/--json/--human/--toon — see crate::config::OutputConfig. Resolved with the precedence

  --output/--json/--human/--toon flag  >  ${PREFIX}_OUTPUT env  >  config file  >  TTY-based default

  See crate::flags::default_output_format and the pure crate::flags::resolve_default_output_format.

where ${PREFIX} is the app id sanitized by app_id_env_prefix.

Structs

ConfigFile

A loaded per-application config file.

CredentialsConfig

The [credentials] table of the engine config file.

EngineConfig

Top-level engine configuration parsed from config.toml.

OutputConfig

The [output] table of the engine config file.

ParseCredentialStoreError

Error returned when a string does not name a CredentialStore variant.

Enums

CredentialStore

Where an auth provider stores credentials.

Functions

config_file_path

Returns the path to the engine config file for app_id, if a base config directory can be resolved and app_id is a safe single path component.

credential_store_env_var

Derives the credential-store override env var from an app id, e.g. godaddy -> GODADDY_CREDENTIAL_STORE.

load

Loads the engine-reserved config for app_id.

resolve_credential_store

Resolves the effective CredentialStore for app_id against process state.

resolve_credential_store_with

Resolves the effective CredentialStore from explicit inputs.