rpassword 0.4.1

Read passwords in console applications.
Documentation

Rustastic Password

Build Status Build status

This Rust package allows you to safely read passwords from standard input in a console application.

You can build the documentation with cargo doc or view it online.

The source code is released under the Apache 2.0 license.

I'd appreciate feedback if you use this library :-)

Usage

Add rpassword as a dependency in Cargo.toml:

[dependencies]
rpassword = "0.4"

Import the rpassword crate and use the promt_password_stdout() to show a message on stdout and read a password into a String:

extern crate rpassword;

fn main() {
    let pass = rpassword::prompt_password_stdout("Password: ").unwrap();
    println!("Your password is {}", pass);
}

You can also read a password without prompting:

extern crate rpassword;

fn main() {
    let pass = rpassword::read_password().unwrap();
    println!("Your password is {}", pass);
}

Finally, you can read strings with a single line, and without the terminating newline that read_line would add:

extern crate rpassword;

fn main() {
    let response = rpassword::read_response().unwrap();
    println!("Your response is {}", response);
}

Check examples/example.rs for a few more examples.

Contributors

We welcome contribution from everyone. Feel free to open an issue or a pull request at any time.

Check out the unassigned issues to get started. If you have any questions, just let us know and we'll jump in to help.

Here's a list of existing rpassword contributors:

Thank you very much for your help! :smiley: :heart:

Donations

rpassword is and will remain free for everyone. If you feel like making a donation, I appreciate it though. Here are a few ways you can donate to support rpassword development:

  • with Bitcoin: 13SPYbEZP9kvmtsKt6C9cYj4N6Ep7my6gL
  • with Litecoin: LN6K6fn9Mq94vbiLNzW1GZ1TvWkVihyn8T

If you cannot afford to donate, that's OK too. Just enjoy rpassword! :-)