numeronym-cli

Crates.ionumeronym-cli
lib.rsnumeronym-cli
version0.1.0
created_at2025-10-01 16:14:10.205603+00
updated_at2025-10-01 16:14:10.205603+00
descriptionA CLI tool that generates numeronym abbreviations from text
homepage
repositoryhttps://github.com/noahp/numeronym-cli
max_upload_size
id1862832
size13,139
Noah Pendleton (noahp)

documentation

README

numeronym-cli

A Rust CLI tool that generates numeronym abbreviations because apparently we needed to make text even less readable than it already is.

What is this abomination?

A numeronym is when you take a perfectly good word and replace the middle letters with a number representing how many letters you brutally removed. Because why write "internationalization" when you can write the much more "intuitive" "i18n"? It's like abbreviations, but with extra steps and mathematical anxiety.

Examples of this linguistic vandalism:

  • internationalizationi18n (18 letters between 'i' and 'n')
  • accessibilitya11y (11 letters between 'a' and 'y')
  • kubernetesk8s (8 letters between 'k' and 's')

Installation

cargo build --release
# The binary will be at target/release/numeronym-cli

Or install it globally:

cargo install --path .

Usage

Pass one or more words as arguments. The tool preserves punctuation and whitespace because even chaos needs some order:

❯ numeronym-cli "it's super fun making idiotic abbreviations!"
zsh: command not found: numeronym-cli

Wait, you need to actually build it first. Try again:

❯ ./target/release/numeronym-cli "it's super fun making idiotic abbreviations!"
i1s s3r f1n m5g i5c a11s!
❯ numeronym-cli internationalization accessibility kubernetes
i18n a11y k8s
❯ numeronym-cli "Hello, world!"
H3o, w3d!

Why does this exist?

Great question! I ask myself the same thing every day. Apparently the tech industry decided that normal abbreviations weren't confusing enough, so we needed to add arithmetic to reading comprehension.

But hey, at least now you can make your documentation 15% more cryptic while still technically using "real words." Your future self will thank you when trying to remember what l10n means at 2 AM.

Features

  • ✅ Converts words to numeronyms (unfortunately)
  • ✅ Preserves punctuation (the only good thing here)
  • ✅ Handles multiple words in a single command
  • ✅ Makes your text objectively worse to read
  • ✅ Adds unnecessary complexity to simple abbreviations

License

MIT - Because even terrible ideas deserve freedom.

Commit count: 0

cargo fmt