Struct PasswordOptions 

pub struct PasswordOptions { /* private fields */ }

Builder for password.

Implementations

impl PasswordOptions

pub fn length(self, n: u32) -> Self

Examples found in repository

examples/quickstart.rs (line 8)

fn main() -> Result<(), secretgenerator::Error> {
    let pw = password(
        PasswordOptions::default()
            .length(24)
            .charset("alphanum-symbols-v1")
            .require_classes("lower,upper,digit,symbol"),
    )?;
    println!("password:    {} ({:.1} bits)", pw.password, pw.entropy_bits);

    let phrase = passphrase(PassphraseOptions::default().words(8).separator("-"))?;
    println!("passphrase:  {}", phrase.password);

    let report = entropy("Tr0ub4dor&3")?;
    println!("Tr0ub4dor&3: {:.1} bits", report.entropy_bits);
    if let Some(ns) = report
        .crack_time_estimates
        .iter()
        .find(|e| e.profile_id == "nation-state-v1")
    {
        println!("crack:       {} (nation-state)", ns.human_readable);
    }
    Ok(())
}

pub fn charset(self, c: impl Into<String>) -> Self

Examples found in repository

examples/quickstart.rs (line 9)

fn main() -> Result<(), secretgenerator::Error> {
    let pw = password(
        PasswordOptions::default()
            .length(24)
            .charset("alphanum-symbols-v1")
            .require_classes("lower,upper,digit,symbol"),
    )?;
    println!("password:    {} ({:.1} bits)", pw.password, pw.entropy_bits);

    let phrase = passphrase(PassphraseOptions::default().words(8).separator("-"))?;
    println!("passphrase:  {}", phrase.password);

    let report = entropy("Tr0ub4dor&3")?;
    println!("Tr0ub4dor&3: {:.1} bits", report.entropy_bits);
    if let Some(ns) = report
        .crack_time_estimates
        .iter()
        .find(|e| e.profile_id == "nation-state-v1")
    {
        println!("crack:       {} (nation-state)", ns.human_readable);
    }
    Ok(())
}

pub fn require_classes(self, c: impl Into<String>) -> Self

Examples found in repository

examples/quickstart.rs (line 10)

fn main() -> Result<(), secretgenerator::Error> {
    let pw = password(
        PasswordOptions::default()
            .length(24)
            .charset("alphanum-symbols-v1")
            .require_classes("lower,upper,digit,symbol"),
    )?;
    println!("password:    {} ({:.1} bits)", pw.password, pw.entropy_bits);

    let phrase = passphrase(PassphraseOptions::default().words(8).separator("-"))?;
    println!("passphrase:  {}", phrase.password);

    let report = entropy("Tr0ub4dor&3")?;
    println!("Tr0ub4dor&3: {:.1} bits", report.entropy_bits);
    if let Some(ns) = report
        .crack_time_estimates
        .iter()
        .find(|e| e.profile_id == "nation-state-v1")
    {
        println!("crack:       {} (nation-state)", ns.human_readable);
    }
    Ok(())
}

pub fn exclude(self, e: impl Into<String>) -> Self

pub fn min_entropy_bits(self, b: f64) -> Self

pub fn allow_weak(self, a: bool) -> Self

pub fn show_crack_time(self, s: bool) -> Self

pub fn audit_log(self, p: impl Into<String>) -> Self

Trait Implementations

impl Clone for PasswordOptions

fn clone(&self) -> PasswordOptions

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PasswordOptions

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

Formats the value using the given formatter.

impl Default for PasswordOptions

fn default() -> Self

Returns the “default value” for a type.