#name #utility

app readable-name-generator

Generate a readable name for throwaway infrastructure

100 stable releases

new 4.1.32 Feb 15, 2025
4.1.26 Jan 27, 2025
4.1.24 Dec 23, 2024
4.1.19 Nov 2, 2024
2.100.22 Mar 31, 2022

#48 in Testing

Download history 288/week @ 2024-10-27 63/week @ 2024-11-03 3/week @ 2024-11-10 3/week @ 2024-11-17 1/week @ 2024-11-24 476/week @ 2024-12-01 257/week @ 2024-12-08 5/week @ 2024-12-15 144/week @ 2024-12-22 4/week @ 2024-12-29 62/week @ 2025-01-05 61/week @ 2025-01-12 6/week @ 2025-01-19 104/week @ 2025-01-26 19/week @ 2025-02-02 296/week @ 2025-02-09

426 downloads per month

CC0 license

48KB
175 lines

Readable Name Generator

Generate a readable name for throwaway infrastructure

Usage

Basic Usage

readable-name-generator
capable_munson

Reproducing names

readable-name-generator --initial-seed 1
flexible_briseglace

Changing the separator

readable-name-generator --initial-seed 1 --separator "###"
flexible###briseglace

Full usage

readable-name-generator --help
Generate a readable name for throwaway infrastructure

Usage: readable-name-generator [OPTIONS]

Options:
  -s, --separator <SEPARATOR>
          The separator to use [env: READABLE_NAME_GENERATOR_SEPARATOR=] [default: _]
  -i, --initial-seed <INITIAL_SEED>
          Use a known seed to generate the readable name for repeatability [env:
          READABLE_NAME_GENERATOR_INITIAL_SEED=]
  -c, --completion-shell <COMPLETION_SHELL>
          Generate completion for your shell [env: COMPLETION_SHELL=] [possible values: bash,
          elvish, fish, powershell, zsh]
  -h, --help
          Print help
  -V, --version
          Print version

Docker

We also have a docker image

docker run --rm -it ghcr.io/purplebooth/readable-name-generator:latest -i 1
flexible_briseglace

Installing

Download the latest release and run it. I install it with homebrew. Or you could use docker.

Binaries

Binaries for Windows, Linux and MacOS are available on the releases page

Packages

Packages are available for various platforms, including Debian, Arch Linux, RPM-based distributions, Alpine, and Docker.

You can access them on the packages page.

Additionally, a Homebrew repository is provided:

brew install PurpleBooth/repo/readable-name-generator

Development

Testing

To run the tests, run

just test

To run the end-to-end tests, run

just specdown

Automatic Code Formatting

To automatically tidy up the code in whatever way possible run

just fmt

Building docker

We have a docker container

docker build -t "codeberg.org/purplebooth/readable-name-generator:latest"
docker run --rm -it codeberg.org/purplebooth/readable-name-generator:latest -i 1
flexible_briseglace

License

CC0 1.0 Universal.

Dependencies

~9–19MB
~268K SLoC