pwgenr/README.md

56 lines
1.5 KiB
Markdown
Raw Normal View History

2017-01-26 11:59:05 +00:00
pwgenr
====
[![Crates.io](https://img.shields.io/crates/v/pwgenr.svg)](https://crates.io/crates/pwgenr)
Random password generator (mainly for use with a password manager).
## Example
```bash
$ pwgenr -lc box -- 12 6
◭┫▹◨┒◳┟┰┒┴┷○
╓┭◷▱╙▙╼○▒┆◌╰
▯◳▥◱◛═▉◆┴◽▌╓
◶◓┆│┓╰┶◑▶◉◁┓
┶┬◪◶◞┼▰▏┞╳╋▩
▌┖╅┺┶◫┺┹◪┲┧┦
```
## Options
You can check by typing `pwgenr -h`:
```
USAGE:
pwgenr [FLAGS] [OPTIONS] [--] [ARGS]
FLAGS:
-a, --ascii Only use ASCII characters
-b, --clipboard Copy first password to clipboard (requires xclip)
-h, --help Prints help information
-l, --list Print the generated passwords in a list (default: columns)
-v Set the logging level
-V, --version Prints version information
OPTIONS:
-c <categories>... Categories to be used [values: ascii, symbols, math, arrows, dingbat, games, box, tech]
-s, --column-separator <column-separator> Separator between columns [default: ]
ARGS:
<LENGTH> The length of the generated passwords [default: 64]
<AMOUNT> How many passwords should be generated [default: 12]
```
## Installation
You can use the `cargo install` command:
$ cargo install pwgenr
or a classic build and run:
```bash
$ git clone https://gitlab.com/Sakuhl/pwgenr
$ cd pwgenr
$ cargo build --release
$ cp target/release/pwgenr ~/.bin # assuming .bin is in your path
```