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