From 8c46c38c1839366da0471722093f11569e682ba2 Mon Sep 17 00:00:00 2001
From: Whyverum <whyverum@gmail.com>
Date: Mon, 8 Dec 2025 16:43:16 +0700
Subject: [PATCH] =?UTF-8?q?=D0=92=D0=B0=D0=BB=D0=B8=D0=B4=D0=B0=D1=82?=
 =?UTF-8?q?=D0=BE=D1=80=20url-=D1=81=D1=81=D1=8B=D0=BB=D0=BE=D0=BA?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 middleware/validators/url_vld.py | 53 ++++++++++++++++++++++++++++++++
 1 file changed, 53 insertions(+)
 create mode 100644 middleware/validators/url_vld.py

diff --git a/middleware/validators/url_vld.py b/middleware/validators/url_vld.py
new file mode 100644
index 0000000..8466d69
--- /dev/null
+++ b/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