randpass
| Crates.io | randpass |
| lib.rs | randpass |
| version | 0.1.1 |
| source | src |
| created_at | 2024-09-30 09:42:10.194447 |
| updated_at | 2024-09-30 10:38:27.935374 |
| description | Secure password generator featuring a customizable character set, entropy calculation, and more. |
| homepage | |
| repository | https://github.com/okada9/randpass |
| max_upload_size | |
| id | 1391508 |
| size | 53,906 |
Hiroki Okada (okada9)
documentation
README
randpass
randpass is a secure password generator written in Rust, featuring a
customizable character set, entropy calculation, and more.
Usage
randpass [OPTIONS]
Options
| Option | Description |
|---|---|
-l, --length <PASSWORD_LENGTH> |
Length of the password [default: 20] |
-u, --uppercase |
Use uppercase letters and digits only |
-L, --lowercase |
Use lowercase letters and digits only |
-d, --digits |
Use digits only |
-s, --symbols |
Use all letters, digits, and symbols |
-b, --base <BASE_CHARSET> |
Custom base character set to use |
-r, --regex <REGEX_PATTERN> |
Regex pattern for allowed characters [default: [A-Za-z0-9]] |
-e, --extra <EXTRA_CHARSET> |
Extra characters to include |
-n, --number <PASSWORD_QUANTITY> |
Number of passwords to generate [default: 1] |
-f, --format <FORMAT_STRING> |
Customize the output format of the password |
-N, --no-newline |
Do not print the trailing newline character |
-D, --delimiter <DELIMITER> |
Use a custom delimiter |
-q, --quiet |
Do not warn about weak passwords |
-v, --verbose |
Always output the strength of the password |
-F, --fail |
Terminate if the password is weak |
Examples
-l, --length <PASSWORD_LENGTH>
Create a password of a specific length:
randpass -l 15
-u, --uppercase
Create a password that consists only of uppercase letters and digits:
randpass -u
-L, --lowercase
Create a password that consists only of lowercase letters and digits:
randpass -L
-d, --digits
Create a password that consists only of digits:
randpass -d
-s, --symbols
Create a password that consists of all letters, digits, and symbols:
randpass -s
-b, --base <BASE_CHARSET>
Create a password using a custom base character set:
randpass -b 'abc123!@#'
The above command produces 1acb@a3b132c#aa3a3@1. The default character
set includes all alphanumeric characters (A–Z, a–z, and 0–9).
-r, --regex <REGEX_PATTERN>
Create a password with characters that match a specific regex pattern:
randpass -r '[A-Z0-9]'
The above command produces 7F3X2EQKMS6R7H1O07AY.
-e, --extra <EXTRA_CHARSET>
Create a password that contains one or more instances of specific characters:
randpass -e '!@#$%'
The above command produces O$DqiC@$E#rR#y!I1A%D. Every letter in the
extra character set will occur at least once.
-n, --number <PASSWORD_QUANTITY>
Create multiple passwords at once:
randpass -n 10
-f, --format <FORMAT_STRING>
Customize the output format of the password. Use {} as a placeholder
for the password:
randpass -f 'Your password is: {}'
Any other text will be included as-is.