randompass 0.2.1

🔑 A simple static password generator. https://github.com/mihaigalos/randompass
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

# randompass

[![CI](https://github.com/mihaigalos/randompass/actions/workflows/ci.yaml/badge.svg)](https://github.com/mihaigalos/randompass/actions/workflows/ci.yaml)
[![CD](https://github.com/mihaigalos/randompass/actions/workflows/cd.yaml/badge.svg)](https://github.com/mihaigalos/randompass/actions/workflows/cd.yaml)
[![test coverage](https://codecov.io/gh/mihaigalos/randompass/branch/main/graph/badge.svg?token=WZPOJXZKCY)](https://codecov.io/gh/mihaigalos/randompass)
[![crates.io](https://img.shields.io/crates/d/randompass.svg)](https://crates.io/crates/randompass)
[![docker pulls](https://img.shields.io/docker/pulls/mihaigalos/randompass)](https://hub.docker.com/r/mihaigalos/randompass)
[![LoC](https://tokei.rs/b1/github/mihaigalos/randompass)](https://github.com/mihaigalos/randompass)

A simple static password generator.
Generated passwords are 20 characters, lower and uppercase and contain special characters by default.

### Why?

I got frustrated with generating passwords which met the required complexity.

There are a few implementations around, but their licensing meant they cannot be used in a professional setting.

Moreover, they require explicit flags to _enable_ a specific complication (i.e.: special chars, uppercase); `randompass` has them enabled by default and the user can _disable_ them instead.

Finally, they do not guarantee that the required complexity has been met (i.e.: the password might not contain a required complication).

### Usage

##### Building from source

```bash
cargo install randompass
```

##### Using precompiled binaries

Precompiled binaries are available for multiple architectures in [Releases](https://github.com/mihaigalos/randompass/releases).

```bash
randompass
```

For a specific length of, say `32`, use:
```bash
randompass --length 32
```

For full options, run:
```bash
randompass --help
```

### Docker

`aarch64` and `amd64` dockers are available.

Run the following command to pull the image and just generate a random password.

```bash
docker run --rm mihaigalos/randompass
```

### Similar work

[`pass-rs`](https://github.com/Jarusk/pass-rs), [`randpas`](https://github.com/ProCode2/randpas), [`randompassword`](https://github.com/pshc/randompassword).