golang-petname(1)

📦 version 2.12, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

🌸 golang-petname — the manual, but make it cute 🌸

okay bestie, welcome to golang-petname(1), the little Unix utility that hands you the most adorable names ever. it's a command-line tool that generates "pet names" — a random lil combo of adverbs, an adjective, and a proper name. iykyk 💅

✨ SYNOPSIS ✨

golang-petname [-w|--words INT] [-s|--separator STR]

that's it, that's the whole vibe. two flags, infinite cuteness 🎀

💖 OPTIONS 💖

  • --words — how many words you want in the name. default is 2. yes, you can go bigger, we'll get to that 👀
  • --separator — the string that goes between the name words. default is -, iconic choice honestly.

🦋 DESCRIPTION 🦋

so here's the tea: this utility generates "pet names", which are a random combination of an adverb, an adjective, and a proper name. lowkey perfect for unique hostnames, fr fr.

the default packaging ships with about 2000 names, 1300 adjectives, and 4000 adverbs — which stacks up to nearly 10 billion unique combinations, covering over 32 bits of unique namespace. not me doing math and being obsessed 😭🔥

because of all that, PetName tries to follow the tenets of Zooko's triangle. the names are:

  • human meaningful
  • decentralized
  • secure

no cap. all three. main character energy for a hostname, truly 👑

🎀 EXAMPLES 🎀

just you and the terminal, being adorable:

$ golang-petname
wiggly-Anna
$ golang-petname --words 1
Marco
$ golang-petname --words 3
quickly-scornful-Johnathan
$ golang-petname --words 4
dolorously-leisurely-wee-Susan
$ golang-petname --separator ":"
hospitable:Isla
$ golang-petname --separator "" --words 3
adeptlystaticNicole

see that last one? separator set to empty string and suddenly it's one long word. slay 🌈

🫶 SEE ALSO 🫶

petname(1) — the other one, go say hi 💜

🌟 AUTHOR 🌟

this manpage and the utility were written by Dustin Kirkland <dustin.kirkland@gmail.com> for Ubuntu systems (but may be used by others, we don't gatekeep). permission is granted to copy, distribute and/or modify this document and the utility under the terms of the Apache2 License.

the complete text of the Apache2 License can be found in /usr/share/common-licenses/Apache-2.0 on Debian/Ubuntu systems. go read it if you're a nerd about licensing (respect, honestly) 📜

ngl this whole thing was golang-petname manual page, version from 15 December 2014, in the golang-petname(1) section. and that's the whole page, bestie. periodt. 💅✨🎀
📦 where this page comes from