PGen-Rust
Getting Started
You can get the latest version of PGen from the github actions artifacts or from one of these links: linux, windows, macos
Usage
From the command line you can use ./pgen-rust generate this will run PGen with the default rules and generate a new configuration file according to your operating system
Windows: {FOLDERID_RoamingAppData} # eg: C:\Users\{USERNAME}\AppData\Roaming
Linux: $HOME/.config # or $XDG_CONFIG_HOME
Mac: $HOME/Library/Preferences
Arguments
USAGE:
pgen-rust [OPTIONS]
OPTIONS:
-a, --amount
The number of passwords to generate (default: 3)
-d, --digits-before
The number of digits before the words (default: 0)
-D, --digits-after
The number of digits after the words (default: 3)
--debug
Enable debug logging
-h, --help
Print help information
-m, --min-length
The minimum length of each word (default: 5, min: 3)
-M, --max-length
The maximum length of each word (default: 7, max: 9)
-r, --match-random-char
Do not use the same random character for each separator rather than a new random each
time (default: true)
-s, --separator-char
The character to use to separate the words (default: "RANDOM")
-S, --separator-alphabet
The array of characters as separators (default: "!@$%.&*-+=?:;")
-t, --transform
What transformation mode to use, Options are [NONE, CAPITALISE, ALL_EXCEPT_FIRST,
UPPERCASE, RANDOM, ALTERNATING] (default: CAPITALISE)
-V, --version
Print version information
-w, --words
The number of words to generate for each password (default: 2)
SUBCOMMANDS:
generate Generate some new passwords.
help Print this message or the help of the given subcommand(s)
Configuration file
When using the configuration file not all values must be present, the default values will be used in their place.
Below you will find the default configuration file.
words = 2
min_length = 5
max_length = 7
transform = 'CAPITALISE'
separator_char = 'RANDOM'
separator_alphabet = '!@$%.&*-+=?:;'
match_random_char = true
digits_before = 0
digits_after = 3
amount = 3
Using a configuration file in another location
When running the generate subcommand you can specify a configuration file to use. This path will first be treated as an absolute path and if not found looked for in the current working directory.
Some examples of this would be:
./pgen-rust generate /home/racci/Documents/config.toml
./pgen-rust generate config.toml
./pgen-rust generate ../config.toml
Rule hierarchy
When running PGen rules will be assigned with the last checked value as the final value. Meaning that rules are assigned in an order of default, config file, supplied config file and finally cli arguments.
Running from a script
Instead of writing ./pgen-rust and whatever options you need, you can instead use a batch, powershell or shell file like these:
- Shell script (Assuming you have
pgen-rustin your path):
#!/bin/bash
pgen-rust -w 10 -m 5 -r -t ALTERNATING -s RANDOM -S =-;. -d 5 -D 0 -a 50 generate ~/Documents/config
- Powershell / Batch script
"C:\Users\Racci\Programs\PGen\pgen-rust" generate "C:\Users\Racci\Programs\PGen\rules.toml"
43 Dec 17, 2022
1.5k Jan 1, 2023
26 Nov 28, 2022
0 Nov 29, 2022
4 Oct 5, 2022
9 Nov 9, 2022
6 Sep 29, 2022
1 Nov 6, 2021
1 Oct 11, 2022
4 Nov 9, 2022
548 Dec 26, 2022
203 Nov 9, 2022
1.1k Jan 4, 2023
0 Dec 24, 2021
253 Dec 31, 2022
35 Sep 24, 2022
3.6k Dec 30, 2022
427 Dec 24, 2022
26 Dec 4, 2022