Enum AuthMode 

pub enum AuthMode {
    Prompt,
    PasswordlessOnly,
    Interactive,
}

What: Authentication strategy for privilege escalation.

Inputs: None (enum variant selection).

Output: Controls how Pacsea handles authentication before privileged operations.

Details:

• Prompt (default): Pacsea shows its own password modal/prompt and uses stdin password piping (sudo -S) for stdin-capable tools. For tools without stdin support (doas), resolver logic coerces this mode to Interactive.
• PasswordlessOnly: Skip password prompt only when {tool} -n true succeeds; fall back to Prompt otherwise.
• Interactive: Skip Pacsea’s password capture entirely and let the privilege tool handle authentication directly (fingerprint via PAM, terminal password, etc.). Works with both sudo and doas when PAM is configured.

Variants

Prompt

Pacsea captures the password for stdin-capable tools; non-stdin tools are coerced to interactive.

PasswordlessOnly

Skip password prompt only when passwordless escalation is available.

Interactive

Let the privilege tool handle authentication interactively (PAM fingerprint, etc.).

Implementations

impl AuthMode

pub fn from_config_key(val: &str) -> Option<Self>

What: Parse a config file value into an AuthMode.

Inputs:

• val: Raw config string (e.g. "prompt", "passwordless_only", "interactive").

Output: Some(mode) on recognized value, None otherwise.

Details: Case-insensitive matching after trim; accepts underscores and hyphens.

pub const fn as_config_key(self) -> &'static str

What: Return the canonical config key string for this mode.

Inputs: None.

Output: "prompt", "passwordless_only", or "interactive".

Details: Inverse of from_config_key.

pub const fn always_skips_password_modal(self) -> bool

What: Whether this mode skips Pacsea’s password modal entirely.

Inputs: None.

Output: true for Interactive, false for Prompt and PasswordlessOnly.

Details:

• PasswordlessOnly does not unconditionally skip — it still needs a runtime {tool} -n true check before skipping.
• Interactive always skips the modal because the tool handles auth directly.

Trait Implementations

impl Clone for AuthMode

fn clone(&self) -> AuthMode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AuthMode

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

Formats the value using the given formatter.

impl Default for AuthMode

fn default() -> AuthMode

Returns the “default value” for a type.

impl Display for AuthMode

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

Formats the value using the given formatter.

impl PartialEq for AuthMode

fn eq(&self, other: &AuthMode) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for AuthMode

impl Eq for AuthMode

impl StructuralPartialEq for AuthMode