Migrating from python-slugify¶

translit's slugify() is parameter-compatible with python-slugify. In most cases, migration requires only changing the import.

Quick migration¶

# Before
from slugify import slugify

# After
from translit import slugify

All parameters are supported with identical names and defaults:

# These work identically in both libraries
slugify("Hello, World!")
slugify("My Post", separator="_")
slugify("Long Title", max_length=10, word_boundary=True)
slugify("the big fox", stopwords=["the"])
slugify("C++ Code", replacements=[("C++", "cpp")])

Parameter compatibility¶

Parameter	python-slugify	translit	Notes
`text`	✓	✓
`separator`	`"-"`	`"-"`
`lowercase`	`True`	`True`
`max_length`	`0`	`0`
`word_boundary`	`False`	`False`
`save_order`	`False`	`False`
`stopwords`	`()`	`()`
`regex_pattern`	`None`	`None`
`replacements`	`()`	`()`
`allow_unicode`	`False`	`False`
`entities`	`True`	`True`
`decimal`	`True`	`True`
`hexadecimal`	`True`	`True`
`lang`	✗	✓	New in translit

New features in translit¶

Language-aware slugification¶

from translit import slugify

# python-slugify can't do this
slugify("Ärger im Büro", lang="de")  # => "aerger-im-buero"

Reusable slugifiers¶

from translit import Slugifier, UniqueSlugifier

# Pre-configured slugifier
slug = Slugifier(lang="de", separator="_")

# Unique slug generation
unique = UniqueSlugifier()
unique("My Post")  # => "my-post"
unique("My Post")  # => "my-post-1"

awesome-slugify migration¶

awesome-slugify users can migrate with zero code changes — translit provides drop-in Slugify and UniqueSlugify classes that accept awesome-slugify's parameter names.

Drop-in replacement (no code changes needed)¶

# Before
from slugify import slugify, Slugify, UniqueSlugify

# After — same class names, same parameter names
from translit import Slugify, UniqueSlugify

custom = Slugify(to_lower=True)
custom("Hello World")  # => "hello-world"

unique = UniqueSlugify()
unique("My Post")   # => "My-Post"
unique("My Post")   # => "My-Post-1"

awesome-slugify parameter compatibility¶

awesome-slugify	translit `Slugify`	Notes
`to_lower`	✓ (maps to `lowercase`)	Both names accepted
`separator`	✓	Identical
`max_length`	✓	Identical
`stop_words`	✓ (maps to `stopwords`)	Both names accepted
`safe_chars`	✓ (best-effort)	Approximated via post-processing
`capitalize`	✓	Uppercases first letter of result
`pretranslate`	✓ (dict only)	Maps to `replacements`; callable form not supported
`translate`	⚠ ignored	translit uses built-in engine; use `lang` instead
`fold_abbrs`	⚠ ignored	Deprecated warning issued

awesome-slugify attribute-style configuration¶

awesome-slugify allows setting properties after construction. translit supports this:

from translit import Slugify

my_slugify = Slugify()
my_slugify.to_lower = True
my_slugify.stop_words = ("a", "an", "the")
my_slugify.max_length = 200
my_slugify.separator = "_"
my_slugify.pretranslate = {"©": "c", "®": "r"}

my_slugify("Hello © World")  # => "hello_c_world"

Preconfigured instances¶

awesome-slugify ships preconfigured instances. translit provides equivalent drop-in replacements:

# awesome-slugify                    # translit equivalent
from slugify import slugify_url      from translit import slugify_url
from slugify import slugify_filename from translit import slugify_filename
from slugify import slugify_unicode  from translit import slugify_unicode
from slugify import slugify_ru       from translit import slugify_ru
from slugify import slugify_de       from translit import slugify_de
from slugify import slugify_el       from translit import slugify_el

Instance	Configuration
`slugify_url`	`to_lower=True`, `stop_words=("a", "an", "the")`, `max_length=200`
`slugify_filename`	`separator="_"`, `safe_chars="-."`, `max_length=255`
`slugify_unicode`	`allow_unicode=True`
`slugify_ru`	Russian transliteration via `lang="ru"`
`slugify_de`	German transliteration via `lang="de"` (ä→ae, ö→oe, ü→ue)
`slugify_el`	Greek transliteration via `lang="el"`

Native translit classes¶

If you prefer translit's native API (which offers more features), use Slugifier and UniqueSlugifier:

from translit import Slugifier, UniqueSlugifier

custom = Slugifier(lowercase=True, lang="de")
custom("Ärger im Büro")  # => "aerger-im-buero"

unique = UniqueSlugifier()
unique("My Post")  # => "my-post"
unique("My Post")  # => "my-post-1"

What's different¶

translate parameter: awesome-slugify lets you swap in a custom transliteration function. translit always uses its built-in Rust transliteration engine, which is faster and covers more scripts. Use the lang parameter for language-specific rules.
pretranslate callables: awesome-slugify accepts both dicts and callables for pretranslate. translit only accepts dicts (mapped to replacements). Callable pretranslate triggers a deprecation warning.
safe_chars: awesome-slugify preserves these characters through the pipeline. translit approximates this with best-effort post-processing. For precise control, use regex_pattern instead.
Default to_lower: awesome-slugify defaults to to_lower=False; the translit Slugify class matches this for compatibility. Note that translit's native slugify() function and Slugifier class default to lowercase=True (matching python-slugify).