larzslug

Slugify text into clean, URL/filename-safe slugs. Pure Python, zero deps.

Turn any title into a-clean-url-safe-slug, correctly handling accented and non-ASCII characters, with a helper to guarantee uniqueness against slugs you've already used.

from larzslug import slugify, unique_slug

slugify("Héllo, World! (2026)")            # 'hello-world-2026'
slugify("Straße")                          # 'strasse'
slugify("Café & Bar", separator="_")       # 'cafe_and_bar'
unique_slug("My Post", {"my-post", "my-post-2"})   # 'my-post-3'

Why

• Real transliteration. Héllo → hello, Straße → strasse, Øystein → oystein — via Unicode decomposition plus a map for letters that don't decompose (ß, æ, ø, þ, …). Not just "drop non-ASCII".
• Uniqueness built in. unique_slug(text, existing) appends -2, -3, … so you never collide — exactly what you need for permalinks and filenames.
• Word-safe truncation. max_length trims back to a word boundary instead of cutting mid-word.
• Zero dependencies. No python-slugify, no unidecode.

Install

pip install larzslug

Usage

from larzslug import slugify, unique_slug, transliterate

slugify("Top 10 Tips 2026")                       # 'top-10-tips-2026'
slugify("Hello World", separator="_")             # 'hello_world'
slugify("Keep Case", lowercase=False)             # 'Keep-Case'
slugify("very long title ...", max_length=30)     # word-safe cut
transliterate("naïve café")                       # 'naive cafe'
unique_slug("My Post", existing_slugs)            # collision-free

Tests

python -m unittest discover -s tests -v   # 17 tests

The Larz stack

One of 30+ pure-Python, zero-dependency libraries at github.com/larz-scripter — pairs with larzmark.

License

MIT © larz-scripter