Регулярно требуется преобразовать какой-либо текст в максимально совместимый текст для 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
It’s May the 4th! Saving the earth is in your hands, so may the force be with you.
Like ice cream in this hot Singapore weather, the earth’s great ice caps are melting due to global warming! It’s time to ask ourselves if we have done enough for the earth. If not, start here: www.mewr.gov.sg/climateaction#ClimateActionSG
💰 Save around $80 annually when you upgrade your refrigerator from 1-tick to 3-tick or above!
🌱 Take climate action by switching to more energy- and water-efficient appliances with your Climate Vouchers!
The Climate Friendly Households Programme now offers:
🎉 Additional $100 in Climate Vouchers, on top of the $300 in 2024 for eligible HDB households (total $400!)
🏠 Now extended to all Singapore Citizen households in private properties too
⏰ Valid until 31 Dec 2027
👉 For more details: go.gov.sg/cfhp-info
#EnergyEfficiency#ClimateActionSG#SustainableSG
💡✨ Bright savings are just a switch away. Switch 5 compact fluorescent lamps for 2-tick LED bulbs and save $32 a year!
Take climate action by switching to more energy- and water-efficient appliances with your Climate Vouchers.
✅ The Climate Friendly Households Programme now offers an additional $100 in Climate Vouchers, on top of the $300 offered in 2024 for eligible HDB households.
✅ The programme has also been expanded to include Singapore Citizen households living in private residential properties in 2025.
✅ This means that all eligible HDB and private households have been issued $400 worth of Climate Vouchers.
These vouchers are valid until 31 Dec 2027.
More details at go.gov.sg/cfhp-info
#EnergyEfficiency#ClimateActionSG#SustainableSG
💰𝗖𝗼𝗼𝗹 𝘀𝗮𝘃𝗶𝗻𝗴𝘀 𝗮𝗹𝗲𝗿𝘁! Upgrade to a 5-tick air-conditioner and enjoy about $450 savings in utilities a year compared to a 1-tick model.
Take climate action by switching to more energy- and water-efficient appliances with your Climate Vouchers.
The Climate Friendly Households Programme now offers an additional $100 in Climate Vouchers, on top of the $300 offered in 2024 for eligible HDB households. The programme has also been expanded to include Singapore Citizen households living in private residential properties in 2025. This means that all eligible HDB and private households have been issued $400 worth of Climate Vouchers. These vouchers are valid until 31 Dec 2027. More details at go.gov.sg/cfhp-info
#EnergyEfficiency#ClimateActionSG#SustainableSG
The Climate Friendly Households Programme now offers an additional $100 in Climate Vouchers, on top of the $300 offered in 2024. It has been expanded to include Singapore Citizen households in private residential properties on top of eligible HDB households.
Take climate action by switching to more energy- and water-efficient appliances with your Climate Vouchers. The vouchers are valid until 31 Dec 2027.
Visit go.gov.sg/climatevouchers for more info.
#ClimateActionSG#SustainableSG#EnergyEfficiency
It's #EarthHour tonight! Don’t forget to turn off all your lights at 8.30pm today. And because we only have one earth, let’s ensure we use our resources wisely. Read more here: earthhour.org
#ClimateActionSG
#SGBudget2025 The enhanced Climate Friendly Households Programme will now cover around 90% of households in Singapore!
From 15 Apr 2025, eligible HDB households will receive an additional $100 in Climate Vouchers, on top of the existing $300 offered in 2024.
The programme will also be expanded to include Singapore Citizen households living in private residential properties.
This means that eligible households staying in HDB and private residential properties can claim a total of $400 worth of Climate Vouchers! These vouchers are valid until 31 Dec 2027.
More info at go.gov.sg/nea-cos2025-cv
#ClimateActionSG#SustainableSG
This year's theme, 'Creating Resilient Communities through Disaster Risk Reduction and Climate Change Mitigation and Adaptation’, highlights the urgent need to build stronger, more adaptable communities in the face of global challenges.
By taking climate actions such as practising the 3Rs and adopting energy-saving habits, all of us can play a part in building a more resilient and #SustainableSG🌱💪
#WorldEnvironmentalHealthDay#SustainableSG#ClimateActionSG
Building climate resilience will keep Singapore steady pom pi pi for the next 60 years! 💃🕺
Let’s take action for a #SustainableSG by adopting energy-saving and #ReduceReuseRecycle habits.
#SG60#ClimateActionSG