pwgenr/README.md

# 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).

## Security disclaimer

Unlike more popular alternatives, pwgenr has never been audited for security (although the source is only about 100 lines). However, this was only created because I believed that no hacker in the world would ever try any unicode characters besides emojis for password cracking.

## Example
```bash
$ pwgenr -c 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
    -V, --version      Prints version information

OPTIONS:
    -c <categories>...        Categories to be used [values: symbols, games, tech, box, arrows, dingbat, math, ascii]

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
```