Регулярно требуется преобразовать какой-либо текст в максимально совместимый текст для 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
One of the ways cholera spreads quickly is through poor water storage.
Ensure safe drinking water: Avoid consuming water from contaminated sources.
Proper storage: Store drinking water in clean containers with tightly sealed lids.
Treat water: If unsure about the safety of your water source, boil it or use a water purification method.
#STOPcholera
Cholera spreads easily through contaminated food and water, especially during the rainy season.
If you notice symptoms like severe diarrhoea, vomiting, nausea and fever, seek medical help immediately!
Early treatment saves lives.
#STOPcholera
Unsafe practices such as improper disposal of refuse and open defecation endanger the safety of water used for drinking and personal use.
This rainy season:
✅Only consume water from safe sources
✅Stop open defaecation
✅Dispose of trash properly
✅Ensure proper drainage of sewage
#STOPCholera
ALWAYS boil your water before drinking.
Water from CONTAMINATED storage tanks are not safe for drinking.
Make your water safe: Boil and store in properly covered containers before drinking.
#STOPCholera
Prompt administration of oral rehydration solution (ORS) helps replace lost fluids while the person seeks treatment at the health facility.
ORS must always be prepared with safe, potable drinking water.
#STOPCholera
As the rainy season has started, ensure to practice proper environmental hygiene to prevent the spread of cholera at home and in your communities
❌Avoid open defaecation
✅Dispose of waste in designated areas
✅Keep sewers clear from refuse
#StopCholera
Unsafe practices such as improper disposal of refuse & defaecating in open places put the safety of water used for drinking & personal use at risk.
#STOPCholera, ensure to:
➡️Keep your environment clean
➡️Drink or use water that is boiled & stored safely
➡️STOP open defecation
#Cholera can spread through contaminated foods.
Make your foods safe before consumption:
➡️PREPARE your food in a clean area, away from sewage or waste bins
➡️WASH fruits and vegetables properly with clean water
➡️STORE your food in well-covered containers
➡️COOK your food properly before eating
➡️USE water from safe sources
#STOPcholera
UNCLEAN WATER, unwashed hands, and uncovered food are some of the ways #Cholera germs are spread.
Ensure your water is safe before use:
➡️BOIL water before drinking
➡️USE water from safe sources
➡️STORE water in properly covered containers
➡️STOP open defecation
#STOPCholera
Severe cases of #cholera can lead to death within hours due to massive loss of body fluid.
Ensure prompt administration of oral rehydration solution (ORS) to replace lost fluids and visit a health care facility immediately for proper treatment.
Do not self-medicate
#STOPcholera
The time between #cholera infection and the appearance of symptoms is 2 hours to 5 days
Please do not self-medicate.
Visit a healthcare facility immediately for proper diagnosis and treatment.
#STOPcholera