nano-slug

Tiny text → URL slug converter — ~1 KB, zero deps. Lowercases, strips accents, replaces whitespace/punct with -, collapses dashes. Perfect for code-golf, minimal containers, or just for fun.

✨ Features

• ✅ Unicode → ASCII (Café au lait → cafe-au-lait)
• ✅ Punctuation/whitespace → -, multi-dash collapse, trim ends
• ✅ Returns slug if result would be empty
• ✅ Zero dependencies • single tiny file • CLI included

🚀 Usage

# Local (from repo)
python app_min.py "Hello, World!"                        # hello-world
python app_min.py "Türkçe Çalışma — Şaşırtıcı!"          # turkce-calisma-sasirtici

After installing:

# CLI
pip install nano-slug
nano-slug "Café au lait"                                  # cafe-au-lait
echo "  multiple   spaces  " | nano-slug                  # multiple-spaces

🤓 Why so small?

• Pure stdlib: unicodedata (NFKD) + tiny re replacements
• No transliteration tables, no locale deps
• Single tiny file + tiny CLI: perfect for scripts, containers, CI.

🎉 Fun Ideas

• Batch rename files

for f in *.md; do mv "$f" "$(nano-slug "${f%.md}").md"; done

• Make anchors for headings

awk '/^#/{sub(/^#* /,""); cmd="nano-slug \""$0"\""; cmd | getline s; close(cmd); print "- ["$0"]( #"s")"}' README.md

• Slug from git branch

nano-slug "$(git rev-parse --abbrev-ref HEAD)"

Notes: ASCII-only output by design. Non-Latin scripts may collapse to empty → returns "slug".

📜 License

MIT © 2025