Валидатор url-ссылок

middleware/validators/url_vld.py

@@ -0,0 +1,53 @@
+from re import Pattern, compile
+
+from ..loggers import logger
+
+
+# Настройка экспорта
+__all__ = ("valid_url", "url_to_text",)
+
+
+def valid_url(url: str) -> bool:
+    """
+    Проверяет, является ли строка валидной ссылкой (URL).
+
+    :param url: Строка для проверки.
+    :return: True, если строка является валидным URL, иначе False.
+    """
+    try:
+        url_pattern: Pattern[str] = compile(
+            r'^(https?://)?'  # Протокол (http или https, необязателен)
+            r'([a-zA-Z0-9-]+\.)+[a-zA-Z]{2,}'  # Домен
+            r'(:\d+)?'  # Порт (необязателен)
+            r'(/[-a-zA-Z0-9@:%_+.~#?&/=]*)?$'  # Путь, параметры и фрагменты
+        )
+        return bool(url_pattern.match(url))
+
+    except ValueError as error:
+        # Перебрасываем ошибку выше для дальнейшей обработки или уведомления
+        logger.error(text=f'Ошибка валидации ссылки: {error}')
+        raise error
+
+
+def url_to_text(text: str, url: str) -> str:
+    """
+    Преобразует текст в HTML ссылку с указанным URL.
+
+    Эта функция генерирует HTML-ссылку с переданным текстом и URL, используя тег `<а>`, и делает ссылку жирной.
+
+    :param text: Текст, который будет отображаться для ссылки.
+    :param url: URL, который будет привязан к тексту.
+    :return: Строка с HTML кодом для ссылки, если URL валиден.
+    :raises ValueError: Если URL невалиден.
+    """
+    try:
+        if not valid_url(url):  # Проверяем, является ли URL валидным
+            raise ValueError(f"Переданный URL '{url}' невалиден.")
+
+        # Генерация HTML-ссылки
+        return f'<b><a href="{url}">{text}</a></b>'
+
+    except ValueError as error:
+        # Перебрасываем ошибку выше для дальнейшей обработки или уведомления
+        logger.error(text=f'Ошибка валидации ссылки в текст: {error}')
+        raise error