passgen-lib 1.3.0

Library for generating cryptographically secure passwords/tokens and other sets and sequences with password strength validation and multilingual support.
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
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138

![alt text](./McDev_thin_900x70.png "McDev_thin_900x70.png")

[![Latest version](https://img.shields.io/crates/v/passgen-lib.svg)](https://crates.io/crates/passgen-lib)
[![Download](https://img.shields.io/crates/d/passgen-lib.svg)](https://crates.io/crates/passgen-lib)
[![docs.rs](https://docs.rs/passgen-lib/badge.svg)](https://docs.rs/passgen-lib/)
[![MIT](https://img.shields.io/badge/license-MIT-blue.svg)](https://choosealicense.com/licenses/mit/)
[![Build Status](https://github.com/mammothcoding/passgen-lib/actions/workflows/rust.yml/badge.svg?event=push)](https://github.com/mammothcoding/passgen-lib/actions/workflows/rust.yml)
[![made-with-rust](https://img.shields.io/badge/Made%20with-Rust-1f425f.svg)](https://www.rust-lang.org/)

Readme in different languages:
[EN](https://github.com/mammothcoding/passgen-lib/blob/master/README.md)
[RU](https://github.com/mammothcoding/passgen-lib/blob/master/README.ru.md)

# ⚙ Passgen-lib

Library for generating cryptographically secure passwords/tokens and other sets and sequences.

[CSPRNGs](https://rust-random.github.io/book/guide-rngs.html#cryptographically-secure-pseudo-random-number-generators-csprngs) Isaac64Rng and Hc128Rng are used.

![alt text](./passgen-lib_demo.gif "passgen-lib_demo.gif")

## Usage

#### Include library to your project `Cargo.toml`:
```toml
[dependencies]
passgen-lib = "1.3.0"
```

#### You can create a token that includes lowercase letters and numbers up to 30 characters long:
```rust
use passgenlib::Passgen;
let result = Passgen::new().set_enabled_letters(true).set_enabled_numbers(true).generate(30);
```

#### You can create a default strong password including all literals, numbers and symbols:
```rust
use passgenlib::Passgen;
let result = Passgen::default().generate(12);
```

#### You can create a strong and usability password with 8 characters long. Including all characters, but the first position in the password is a capital or small letter, the last position is the symbol.

🔸 Excluded ambiguous characters `"0oOiIlL1"`.
```rust
use passgenlib::Passgen;
let result = Passgen::default_strong_and_usab().generate(8);
```

#### You can create a set from your custom charset 12 characters long:
```rust
use passgenlib::Passgen;
let result = Passgen::new().set_custom_charset("abcABC123⭕➖❎⚫⬛п₼⁂🙂").generate(12);
```

#### You can validate the existing password against the added rules:
```rust
use passgenlib::Passgen;
let mut generator = Passgen::default();
generator.set_enabled_letters(true).set_enabled_numbers(true);
generator.set_password("MyP@ssw0rd");
assert!(generator.validate_password());
```

#### You can get password strength score:
```rust
use passgenlib::Passgen;
let mut generator = Passgen::default();
generator.set_password("MyP@ssw0rd");
let score = generator.password_strength_score();
assert!(score >= 0 && score <= 100);
```

#### You can get password strength level in multiple languages:
```rust
use passgenlib::Passgen;
use passgenlib::lang::lang::{Language, StrengthTranslations};
let mut generator = Passgen::default();
generator.set_password("MyP@ssw0rd");

// English (default)
assert_eq!(generator.password_strength_level(), "Strong");

// Russian
generator.set_language(Language::Russian);
assert_eq!(generator.password_strength_level(), "Сильный");

// Spanish
generator.set_language(Language::Spanish);
assert_eq!(generator.password_strength_level(), "Fuerte");
```

#### You can generate password and immediately get its strength score:
```rust
use passgenlib::Passgen;
let mut generator = Passgen::default();
let password = generator.generate(12);

// The generated password is stored in the password field
assert_eq!(generator.get_password(), password);

// You can immediately get the strength score
let score = generator.password_strength_score();
assert!(score > 0);
```
#### Supported languages for displaying strength level descriptions:
🔸English (default)
🔸Chinese (简体中文)
🔸Spanish (Español)
🔸Hindi (हिन्दी)
🔸Arabic (العربية)
🔸Portuguese (Português)
🔸Bengali (বাংলা)
🔸Russian (Русский)
🔸Japanese (日本語)
🔸Punjabi (ਪੰਜਾਬੀ)
🔸German (Deutsch)
🔸Korean (한국어)
🔸French (Français)
🔸Turkish (Türkçe)
🔸Italian (Italiano)

### Example of library integration in the [passgen-cmd](https://github.com/mammothcoding/passgen-cmd) tool and [passgen-telegram](https://github.com/mammothcoding/passgen-telegram) service.

### Library [doc](https://docs.rs/passgen-lib/).

## License

[MIT](https://choosealicense.com/licenses/mit/)

### Our other passgen projects:
[passgen-desktop](https://github.com/mammothcoding/passgen-desktop)

[passgen-console-linuxwin](https://github.com/mammothcoding/passgen-console-linuxwin)

[passgen-cmd](https://github.com/mammothcoding/passgen-cmd)

[passgen-telegram](https://github.com/mammothcoding/passgen-telegram)