Struct dialoguer::Password

pub struct Password<'a> { /* private fields */ }

Renders a password input prompt.

Example

use dialoguer::Password;

fn main() {
    let password = Password::new()
        .with_prompt("New Password")
        .with_confirmation("Confirm password", "Passwords mismatching")
        .interact()
        .unwrap();

    println!("Your password length is: {}", password.len());
}

Implementations

impl Password<'static>

pub fn new() -> Password<'static>

Creates a password input prompt with default theme.

impl Password<'_>

pub fn with_prompt<S: Into<String>>(self, prompt: S) -> Self

Sets the password input prompt.

Examples found in repository

examples/password.rs (line 5)

fn main() {
    let password = Password::with_theme(&ColorfulTheme::default())
        .with_prompt("Password")
        .with_confirmation("Repeat password", "Error: the passwords don't match.")
        .validate_with(|input: &String| -> Result<(), &str> {
            if input.chars().count() > 3 {
                Ok(())
            } else {
                Err("Password must be longer than 3")
            }
        })
        .interact()
        .unwrap();

    println!(
        "Your password is {} characters long",
        password.chars().count()
    );
}

pub fn report(self, val: bool) -> Self

Indicates whether to report confirmation after interaction.

The default is to report.

pub fn with_confirmation<A, B>(self, prompt: A, mismatch_err: B) -> Selfwhere A: Into<String>, B: Into<String>,

Enables confirmation prompting.

Examples found in repository

examples/password.rs (line 6)

fn main() {
    let password = Password::with_theme(&ColorfulTheme::default())
        .with_prompt("Password")
        .with_confirmation("Repeat password", "Error: the passwords don't match.")
        .validate_with(|input: &String| -> Result<(), &str> {
            if input.chars().count() > 3 {
                Ok(())
            } else {
                Err("Password must be longer than 3")
            }
        })
        .interact()
        .unwrap();

    println!(
        "Your password is {} characters long",
        password.chars().count()
    );
}

pub fn allow_empty_password(self, allow_empty_password: bool) -> Self

Allows/Disables empty password.

By default this setting is set to false (i.e. password is not empty).

pub fn interact(self) -> Result<String>

Enables user interaction and returns the result.

If the user confirms the result is Ok(), Err() otherwise. The dialog is rendered on stderr.

Examples found in repository

examples/password.rs (line 14)

fn main() {
    let password = Password::with_theme(&ColorfulTheme::default())
        .with_prompt("Password")
        .with_confirmation("Repeat password", "Error: the passwords don't match.")
        .validate_with(|input: &String| -> Result<(), &str> {
            if input.chars().count() > 3 {
                Ok(())
            } else {
                Err("Password must be longer than 3")
            }
        })
        .interact()
        .unwrap();

    println!(
        "Your password is {} characters long",
        password.chars().count()
    );
}

pub fn interact_on(self, term: &Term) -> Result<String>

Like interact but allows a specific terminal to be set.

impl<'a> Password<'a>

pub fn validate_with<V>(self, validator: V) -> Selfwhere V: PasswordValidator + 'a, V::Err: ToString,

Registers a validator.

Example

use dialoguer::Password;

fn main() {
    let password: String = Password::new()
        .with_prompt("Enter password")
        .validate_with(|input: &String| -> Result<(), &str> {
            if input.chars().count() > 8 {
                Ok(())
            } else {
                Err("Password must be longer than 8")
            }
        })
        .interact()
        .unwrap();
}

Examples found in repository

examples/password.rs (lines 7-13)

fn main() {
    let password = Password::with_theme(&ColorfulTheme::default())
        .with_prompt("Password")
        .with_confirmation("Repeat password", "Error: the passwords don't match.")
        .validate_with(|input: &String| -> Result<(), &str> {
            if input.chars().count() > 3 {
                Ok(())
            } else {
                Err("Password must be longer than 3")
            }
        })
        .interact()
        .unwrap();

    println!(
        "Your password is {} characters long",
        password.chars().count()
    );
}

pub fn with_theme(theme: &'a dyn Theme) -> Self

Creates a password input prompt with a specific theme.

Example

use dialoguer::{theme::ColorfulTheme, Password};

fn main() {
    let password = Password::with_theme(&ColorfulTheme::default())
        .interact()
        .unwrap();
}

Examples found in repository

examples/password.rs (line 4)

fn main() {
    let password = Password::with_theme(&ColorfulTheme::default())
        .with_prompt("Password")
        .with_confirmation("Repeat password", "Error: the passwords don't match.")
        .validate_with(|input: &String| -> Result<(), &str> {
            if input.chars().count() > 3 {
                Ok(())
            } else {
                Err("Password must be longer than 3")
            }
        })
        .interact()
        .unwrap();

    println!(
        "Your password is {} characters long",
        password.chars().count()
    );
}

Trait Implementations

impl<'a> Clone for Password<'a>

fn clone(&self) -> Password<'a>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Default for Password<'static>

fn default() -> Password<'static>

Returns the “default value” for a type.