Регулярно требуется преобразовать какой-либо текст в максимально совместимый текст для 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
News: #AU Chairperson calls for maximum restraint amid renewed tensions in #Tigray
The Chairperson of the African Union Commission, Mahmoud Ali Youssouf, has urged all parties in #Ethiopia’s Tigray region to exercise maximum restraint as tensions rise and reports emerge of renewed clashes in parts of the region.
In a statement issued on Friday, the AU Commission said its Chairperson is closely monitoring developments in Tigray and expressed deep concern over recent developments. He re-emphasized the paramount importance of preserving the “hard-won gains” achieved under the African Union-led Permanent Cessation of Hostilities Agreement (#COHA) signed between the federal government and the Tigray People’s Liberation Front (#TPLF) in Pretoria on 2 November 2022.
The Chairperson called on all parties to refrain from actions that could undermine confidence and to resolve outstanding issues through constructive dialogue, in full adherence to both the .....
Read more: https://addisstandard.com/?p=54840
News: #AU monitoring team returns to #Mekelle after tensions renew focus on #Pretoria agreement
An advance team of African experts under the African Union’s Monitoring, Verification and Compliance Mechanism (#AU-MVCM) has arrived in Mekelle, resuming its “mandate of monitoring the implementation” of the Permanent Cessation of Hostilities Agreement (#COHA), the AU Commission’s Political Affairs, Peace and Security Department said on today.
According to the Commission, the team redeployed after an “administrative break” to resume their mandate the office said was “crucial” to the implementation of the of the COHA, signed between the federal government and the #Tigray People’s Liberation Front (#TPLF) in November 2022.
The resumption of the task comes amid concerns over renewed tensions, clashes and drone strikes in parts of Tigray.
Last week, the AU Commission Chairperson Mahmoud Ali Youssouf ....
Read more: https://addisstandard.com/?p=54994
News: #TPLF says it ‘will not stay idle’ if #Pretoria deal is breached, urges AU, US, EU to move beyond concern statements
The chairman of the Tigray People’s Liberation Front (TPLF), Debretsion Gebremichael (PhD), has warned that the party “will not stay idle” if the Pretoria Cessation of Hostilities Agreement (#CoHA) is breached and the group comes under attack, while dismissing claims that it has been “weakened and dispersed.”
He also urged international actors including the African Union (#AU), the #United_States, and the European Union (#EU) to move beyond expressions of concern and take concrete action to safeguard the fragile peace process.
Speaking at a press briefing today, Debretsion rejected assertions that the TPLF has lost cohesion. “They say we are weakened and dispersed. But our answer is: we are not dispersed when it comes to our survival and security,” he said.
Debretsion also said he has been in frequent contact with representatives....
Read more: https://addisstandard.com/?p=55172
News: #Tigray opposition parties urge international mediators to intervene as tensions raise fears of renewed war
Several Tigray-based opposition political parties have issued separate open letters warning of an imminent risk of renewed conflict in the region and calling on international mediators and guarantors of the Cessation of Hostilities Agreement (#CoHA) to take urgent preventive action.
Salsay Weyane Tigray (#SaWeT) and the Tigray Independence Party (#TIP), in letters addressed to the #United_Nations, the African Union (#AU), the #United_States, the #European_Union, and other guarantors and facilitators of the Pretoria peace agreement, expressed deep concern over what they described as escalating political and military tensions that could unravel the fragile peace in Tigray.
In its open letter, SaWeT warned that the region is “on the brink of an absolutely preventable disaster,” saying that a growing military confrontation threatens the collapse of …..
Read more: https://addisstandard.com/?p=54847