libpwquality 0.2.0

libpwquality bindings for Rust
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58

# [libpwquality](https://github.com/libpwquality/libpwquality) bindings for Rust

[![Crates.io](https://img.shields.io/crates/v/libpwquality)](https://crates.io/crates/libpwquality)
[![Crates.io](https://img.shields.io/crates/d/libpwquality)](https://crates.io/crates/libpwquality)
[![License](https://img.shields.io/github/license/nibon7/libpwquality-rs)](LICENSE)
[![docs.rs](https://img.shields.io/docsrs/libpwquality)](https://docs.rs/libpwquality)
[![Build Status](https://img.shields.io/github/actions/workflow/status/nibon7/libpwquality-rs/ci.yml)](https://github.com/nibon7/libpwquality-rs/actions/workflows/ci.yml?query=branch%3Amain)

## Usage

```sh
cargo add libpwquality
```

If you need [cracklib](https://github.com/cracklib/cracklib) support, enable `crack` feature and install cracklib development library.

```sh
cargo add libpwquality --features crack
sudo pacman -S cracklib
```

## Examples

```rust
use libpwquality::{Error, PWQuality};

fn main() -> Result<(), Error> {
    let pwq = PWQuality::new()?;

    pwq.read_default_config()?;

    pwq.set_min_length(9);
    let minlen = pwq.get_min_length();
    println!("minlen={}", minlen);

    pwq.set_bad_words(["bad", "password"])?;
    let badwords = pwq.get_bad_words()?;
    println!("badwords={:?}", badwords);

    pwq.set_option("maxrepeat=2")?;
    let maxrepeat = pwq.get_max_repeat();
    println!("maxrepeat={}", maxrepeat);

    let password = pwq.generate(32)?;
    println!("password={}", password);

    let score = pwq.check(&password, None, None)?;
    println!("score={}", score);

    let score = pwq.check(&password, Some("password!"), None)?;
    println!("score1={}", score);

    let score = pwq.check(&password, Some("password!"), Some("root"))?;
    println!("score2={}", score);

    Ok(())
}
```