https://github.com/ryanpz/genpass

A simple passphrase generator
https://github.com/ryanpz/genpass

Last synced: about 2 months ago
JSON representation

A simple passphrase generator

• Host: GitHub
• URL: https://github.com/ryanpz/genpass
• Owner: ryanpz
• License: 0bsd
• Created: 2024-11-06T09:34:40.000Z (2 months ago)
• Default Branch: main
• Last Pushed: 2024-11-06T09:35:27.000Z (2 months ago)
• Last Synced: 2024-11-06T10:32:16.635Z (about 2 months ago)
• Language: Zig
• Size: 0 Bytes
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# genpass

genpass is a command-line utility that generates a random passphrase.

## Usage

Running `genpass` outputs a passphrase consisting of six capitalized words suffixed with a single digit, separated by a single hyphen [-].

Example: `Hippopotamus0-Highlight2-Brainstorm9-Skeleton0-Extend7-Gallery3`

## Building

### Requirements

* `zig`

* `make`

### Make Targets

 * `build`: build the release version

 * `run`: build run the debug version

 * `test`: run all tests

 * `codegen-wordlist`: generate zig code representing [wordlist.txt](./data/wordlist.txt) (see below)

### Configuring the Word List

To configure the list of words genpass pulls from:

 1. replace the contents of [wordlist.txt](./data/wordlist.txt) with your list of newline-separated words

 2. run `make codegen-wordlist`

 3. rebuild with `make build` or `make run`

Note: `codegen-wordlist` embeds the word list into the executable, so `wordlist.txt` isn't required for the compiled program to run.

## License

0BSD