Регулярно требуется преобразовать какой-либо текст в максимально совместимый текст для 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
Take our quiz to test your HDB knowledge ⬇️ Are you ready to #BTOgether? Let’s see how much you know about buying a BTO flat!
P.S. No stress, this is an open book quiz 😉 You can check out these BTO-related guides on MyNiceHome first:
💰CPF Housing Grants for HDB Flat Buyers
🔍HDB Flat Types and Classification
🏠How to Buy a BTO Flat
How will your 2024 look like? If you’re planning to apply for a BTO flat in 2024, you can look forward to 3 sales launches this year – with the first sales launch happening in February!
Apply for your HFE letter by 15 January, if you’re thinking of to participating in the upcoming February sales launch. Get ready to #BTOgether🏠 Find out more at https://homes.hdb.gov.sg.
Planning to purchase a new home at the December sales launch? Check out which flats you can consider according to your monthly household income!
Work out your housing budget with HDB’s online calculators at
https://homes.hdb.gov.sg#BTOgether
Looking for a 4-room flat this sales launch? Here’s what the sums could look like.
Head over to https://homes.hdb.gov.sg to find out more about the grants and schemes available for first-timer families, and use our financial calculators to plan your purchase. #BTOgether
Looking for a 3-room flat this sales launch? Here’s what the sums could look like.
Head over to https://homes.hdb.gov.sg to find out more about the grants and schemes available for first-timer families, and use our financial calculators to plan your purchase. #BTOgether
Check out the prices of each flat type on offer this sales launch! Work out your housing budget with HDB’s online calculators at https://homes.hdb.gov.sg#BTOgether
JUST IN: 6,057 flats on offer at the December BTO sales launch! Find out more about the projects at Bedok, Bishan, Bukit Merah, Bukit Panjang, Jurong West, Queenstown, and Woodlands.
About 50% of the BTO flats launched this sales launch have a wait time of 4 years or less – for those who are looking to move into their flats sooner, the flats at Sin Ming Residences have wait time of about 2 years and 8 months, while Jurong Arcadia has a wait time of about 3 years and 1 month.
Get your HFE letter ready, and apply for your new home at https://homes.hdb.gov.sg by 11 December. #BTOgether
It’s 11/11 and we did not forget you 💖 In the second half of 2024, singles can apply for 2-room Flexi flats across all HDB projects islandwide, not just in non-mature estates! We will also launch up to 14,000 2-room Flexi BTO flats from 2024 to 2026 to meet demand. #BTOgether
Ready to #BTOgether at the upcoming sales launch? It’s as easy as 🔤!
To plan your budget, use our online calculators at https://homes.hdb.gov.sg. Simply input the info from your approved HFE letter, and you will be able to work out your flat budget.
More about the new First-Timer (Parents & Married Couples) category and priority schemes.
🏠 Gearing up to #BTOgether?
💰 Learn how to assess your financial fitness, plan for a home purchase, and plan ahead for your life as a couple at the Institute of Financial Literacy’s free financial planning workshop!