Struct git_credentials::helper::Cascade

pub struct Cascade {
    pub programs: Vec<Program>,
    pub stderr: bool,
    pub use_http_path: bool,
}

A list of helper programs to run in order to obtain credentials.

Fields

programs: Vec<Program>

The programs to run in order to obtain credentials

stderr: bool

If true, stderr is enabled when programs are run, which is the default.

use_http_path: bool

If true, http(s) urls will take their path portion into account when obtaining credentials. Default is false.

Implementations

impl Cascade

Initialization

pub fn platform_builtin() -> Vec<Program>

Return the programs to run for the current platform.

These are typically used as basis for all credential cascade invocations, with configured programs following afterwards.

Note

These defaults emulate what typical git installations may use these days, as in fact it’s a configurable which comes from installation-specific configuration files which we cannot know (or guess at best). This seems like an acceptable trade-off as helpers are ignored if they fail or are not existing.

impl Cascade

Builder

pub fn extend(self, programs: impl IntoIterator<Item = Program>) -> Self

Extend the list of programs to run programs.

pub fn use_http_path(self, toggle: bool) -> Self

If toggle is true, http(s) urls will use the path portions of the url to obtain a credential for.

Otherwise, they will only take the user name into account.

impl Cascade

Finalize

pub fn invoke(&mut self, action: Action, prompt: Options<'_>) -> Result

Invoke the cascade by invoking each program with action, and configuring potential prompts with prompt options. The latter can also be used to disable the prompt entirely when setting the mode to Disable;=.

When getting credentials, all programs are asked until the credentials are complete, stopping the cascade. When storing or erasing all programs are instructed in order.

Trait Implementations

impl Debug for Cascade

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

Formats the value using the given formatter.

impl Default for Cascade

fn default() -> Self

Returns the “default value” for a type.