Регулярно требуется преобразовать какой-либо текст в максимально совместимый текст для 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
📣COMING UP
Join our Head of Health Emergency Preparedness, Dr Biodun Ogunniyi as he gives update on #Cholera response in Nigeria.
Tune in LIVE on NTA to join the conversation
📡DSTV: CH 251
📡GOTV: CH 114
🕥 9:00 pm
As of 29th September, over 10,000 suspected cases of #cholera have been recorded from the 36 States + FCT.
The ongoing cholera outbreak has been worsened by limited access to clean water, open defecation, & poor hygiene practices in affected communities.
🔗Download the situation report
https://ncdc.gov.ng/diseases/sitreps/?cat=7&name=An%20update%20of%20Cholera%20outbreak%20in%20Nigeria
In reporting week 32, the number of suspected cases of #cholera increased to 121 cases.
Our weekly situation report provides an update on the current #cholera epidemiological situation in Nigeria and our response activities.
🔗 Download via:
https://ncdc.gov.ng/diseases/sitreps/?cat=7&name=An%20update%20of%20Cholera%20outbreak%20in%20Nigeria
Our weekly #cholera situation report for weeks 28 and 29 has been uploaded.
The reports provide an update on the current #cholera epidemiological situation in Nigeria and our response activities.
🔗 Download via:
https://ncdc.gov.ng/diseases/sitreps/?cat=7&name=An%20update%20of%20Cholera%20outbreak%20in%20Nigeria
Your actions, no matter how small can limit the risk of #cholera infection.
🚫Do not defecate in open areas
🧤Clear your drainages
✅Only drink water from safe sources
✅Dispose of refuse properly in waste disposal sites
Public health advisory⬇️
🔗https://ncdc.gov.ng/news/513/stop-cholera%3A-public-health-advisory
Our weekly #cholera situation report for week 27 has been uploaded.
The report provides an update on the current #cholera epidemiological situation in Nigeria and our response activities.
🔗 Download via:
https://ncdc.gov.ng/diseases/sitreps/?cat=7&name=An%20update%20of%20Cholera%20outbreak%20in%20Nigeria
Our #cholera situation reports are now weekly.
The reports provide an update on the #cholera epidemiological situation in Nigeria and our response activities.
🔗 Download via:
https://ncdc.gov.ng/diseases/sitreps/?cat=7&name=An%20update%20of%20Cholera%20outbreak%20in%20Nigeria
The bacteria, Vibrio cholerae, that causes #cholera is commonly found in contaminated water and food.
Protect yourself.
Read our public health advisory on measures to take to prevent yourself from getting infected. ⬇️
🔗
https://ncdc.gov.ng/news/513/stop-cholera%3A-public-health-advisory
📣ICYMI
The Incident Manager of our National #Cholera Technical Working Group, Mr Sebastian Yennan, was live on Arise TV to discuss the ongoing #cholera outbreak.
🔗 Catch up and share via
https://youtu.be/rVHP5kRU4bw?si=aIMQiFD9Uo3qjCND
#Cholera Situation Report
Our monthly Cholera Situation Report for May 2024 has been published on our website.
🔗You can download, read and share via
https://ncdc.gov.ng/diseases/sitreps/?cat=7&name=An%20update%20of%20Cholera%20outbreak%20in%20Nigeria
Severe cases of #cholera can cause death within hours due to dehydration.
Recognise the signs and symptoms to ensure you seek early healthcare and treatment if suspected.
Unwashed hands, untreated water, and uncovered food are some of the ways #Cholera germs are spread.
Personal and environmental hygiene remains one of the best ways to STOP #Cholera.
Watch this little boy's story on cholera:
https://www.youtube.com/watch?v=jG1VNSCsP5Q