Регулярно требуется преобразовать какой-либо текст в максимально совместимый текст для URL, имени файла, имени объекта в каком-то софте и тд. Требования совместимости простые: в тексте должны быть только допустимые символы. Обычно это a-z, 0-9 и "_" или "-". То есть, только прописные буквы латинского алфавита и цифры (как пример).
Допустим, нам нужно название статьи в блоге преобразовать в slug для добавления его в URL этой статьи. Как это лучше всего сделать?
В Django по умолчанию есть готовая функция slugify для таких случаев.
Но я её никогда не использую. Почему? Потому что её недостаточно!
Приведём пример
>>> from django.utils.text import slugify
>>> slugify('This is a Title')
'this-is-a-title'
Пока всё отлично
>>> slugify('This is a "Title!"')
'this-is-a-title'
Спец символы удалились, всё хорошо.
>>> slugify('Это заголовок статьи')
''
Вот и приехали 😢. Если текст не английский то буквы просто игнорируются. Можно это поправить
>>> slugify('Это заголовок статьи', allow_unicode=True)
'это-заголовок-статьи'
Но тогда мы не вписываемся в условие. У нас появилась кириллица в тексте.
Так как я часто пишу сайты для русскоязычных пользователей эта проблема весьма актуальна. Я не использую стандартную функцию и всегда пишу свою.
Оригинал я не беру в расчёт и пишу полностью свою функцию. И так, по порядку:
🔸1. Исходный текст:
>>> text = 'Мой заголовок №10 😁!'
Взял специально посложней со специальными символами.
🔸2. Транслит
Необходимо сделать транслит всех символов в латиницу. Здесь очень выручает библиотека unidecode. Помимо простого транслита кириллицы в латиницу она умеет преобразовывать спец символы и иероглифы в текстовые аналоги.
from unidecode import unidecode
>>> unidecode("Ñ Σ ® µ ¶ ¼ 月 山")
'N S (r) u P 1/4 Yue Shan'
Очень крутая библиотека, советую👍
В нашем случае получаем такое преобразование:
>>> text = unidecode(text)
>>> print(text)
'Moi zagolovok No. 10 !'
Отличный транслит. Смайл просто удалился, хотя я ждал что-то вроде :). Ну и ладно, всë равно невалидные символы.
А еще наш код уже поддерживает любой язык, будь то хинди или корейский.
🔸4. Фильтр символов
Unidecode не занимается фильтрацией по недопустимым символам. Это мы делаем в следующем шаге через regex. Просто заменим все символы на "_" если они вне указанного диапазона.
>>> text = re.sub(r'[^a-zA-Z0-9]+', '_', text)
>>> print(text)
'Moi_zagolovok_No_10_'
Символ "+" в паттерне выручает когда несколько недопустимых символов идут рядом. Все они заменяются на один символ "_".
🔸5. Slugify
Осталось удалить лишние символы по краям и сделать нижний регистр
>>> text = text.strip('_').lower()
>>> print(text)
'moi_zagolovok_no_10'
Получаем отличный slug! 😎
🌎 Полный код в виде функции.
______________
PS. Проверку что в строке остался хоть один допустимый символ я бы вынес в отдельную функцию.
#libs#tricks#django
Jugador del día 29/06/2025:
HUGO RODALLEGA 🇨🇴
#SantaFeCampeon de la mano de Hugol. Marcó el tanto del título estando lesionado y agranda su leyenda en el fútbol colombiano ⚽️
#WorldFootballMVP
#IndependienteMedellin
🗞Vía X:Jugador del Día
@LaGuiadelFutbol
Colombia Primera A🇨🇴
2026-04-22 23:20 UTC
Independiente Medellin vs. Chico
Predicted outcome: Independiente Medellin✅
Predicted score: 2:0
Actual: Independiente Medellin 2:0
#IndependienteMedellin#Chico
2026-04-23 01:30 UTC
Fortaleza FC vs. America de Cali
Predicted outcome: Draw❌
Predicted score: 1:1
Actual: America de Cali 1:2
#FortalezaFC#AmericadeCali
#Football#ColombiaPrimeraA
Colombia Primera A🇨🇴
2026-04-19 19:00 UTC
Santa Fe vs. Cucuta
Predicted outcome: Santa Fe✅
Predicted score: 2:1
Actual: Santa Fe 5:0
#SantaFe#Cucuta
2026-04-19 21:10 UTC
Alianza Valledupar vs. Independiente Medellin
Predicted outcome: Independiente Medellin✅
Predicted score: 1:2
Actual: Independiente Medellin 0:1
#AlianzaValledupar#IndependienteMedellin
2026-04-19 23:20 UTC
Junior vs. Llaneros
Predicted outcome: Junior✅
Predicted score: 2:1
Actual: Junior 2:0
#Junior#Llaneros
2026-04-20 01:30 UTC
America de Cali vs. Millonarios
Predicted outcome: America de Cali✅
Predicted score: 1:0
Actual: America de Cali 3:1
#AmericadeCali#Millonarios
#Football#ColombiaPrimeraA
Colombia Primera A🇨🇴
2026-04-02 19:00 UTC
Chico vs. Deportivo Pereira
Predicted outcome: Chico✅
Predicted score: 2:1
Actual: Chico 1:0
#Chico#DeportivoPereira
2026-04-02 21:10 UTC
America de Cali vs. Bucaramanga
Predicted outcome: America de Cali✅
Predicted score: 1:0
Actual: America de Cali 2:0
#AmericadeCali#Bucaramanga
2026-04-02 23:20 UTC
Jaguares vs. Millonarios
Predicted outcome: Millonarios❌
Predicted score: 1:2
Actual: Jaguares 1:0
#Jaguares#Millonarios
2026-04-03 01:30 UTC
Once Caldas vs. Independiente Medellin
Predicted outcome: Draw✅
Predicted score: 2:2
Actual: Draw 1:1
#OnceCaldas#IndependienteMedellin
#Football#ColombiaPrimeraA
Colombia Primera A🇨🇴
2026-05-01 23:00 UTC
Once Caldas vs. Atletico Nacional
Predicted outcome: Atletico Nacional❌
Predicted score: 1:2
Actual: Once Caldas 1:0
#OnceCaldas#AtleticoNacional
2026-05-02 19:00 UTC
Chico vs. Llaneros
Predicted outcome: Llaneros❌
Predicted score: 1:2
Actual: Chico 3:0
#Chico#Llaneros
2026-05-02 21:00 UTC
Jaguares vs. Cucuta
Predicted outcome: Jaguares✅
Predicted score: 3:2
Actual: Jaguares 2:0
#Jaguares#Cucuta
2026-05-03 20:30 UTC
Independiente Medellin vs. Águilas Doradas
Predicted outcome: Independiente Medellin❌
Predicted score: 2:1
Actual: Águilas Doradas 1:2
#IndependienteMedellin#guilasDoradas
2026-05-03 20:30 UTC
Santa Fe vs. Internacional de Bogota
Predicted outcome: Santa Fe✅
Predicted score: 2:1
Actual: Santa Fe 3:1
#SantaFe#InternacionaldeBogota
2026-05-03 20:30 UTC
Alianza Valledupar vs. Millonarios
Predicted outcome: Millonarios❌
Predicted score: 0:1
Actual: Draw 2:2
#AlianzaValledupar#Millonarios
2026-05-03 20:30 UTC
Deportes Tolima vs. Deportivo Cali
Predicted outcome: Deportes Tolima❌
Predicted score: 2:1
Actual: Draw 1:1
#DeportesTolima#DeportivoCali
2026-05-03 20:30 UTC
Fortaleza FC vs. Bucaramanga
Predicted outcome: Fortaleza FC✅
Predicted score: 2:1
Actual: Fortaleza FC 2:1
#FortalezaFC#Bucaramanga
2026-05-03 22:45 UTC
Junior vs. Deportivo Pasto
Predicted outcome: Junior✅
Predicted score: 2:1
Actual: Junior 4:3
#Junior#DeportivoPasto
2026-05-03 22:45 UTC
America de Cali vs. Deportivo Pereira
Predicted outcome: America de Cali✅
Predicted score: 3:0
Actual: America de Cali 1:0
#AmericadeCali#DeportivoPereira
#Football#ColombiaPrimeraA