Source code for src.tetue_generic.generic_requests

"""Implement generic request function with own logging and return functionality"""

from __future__ import annotations
import requests
import environ
from .watcher import logger




@environ.config(prefix="GEN_REQ")
class GenReqConfiguration:
    """
    Configuration settings for generic HTTP requests.
    """

    request_timeout = environ.var(
        "30", converter=int, help="Timeout for HTTP requests in seconds"
    )





async def generic_http_request(
    url: str, header: dict, timeout: int
) -> requests.Response | None:
    """
    Performs an asynchronous HTTP GET request and handles potential exceptions.

    This function sends a GET request to the specified URL with given headers and timeout.
    It catches and logs common HTTP request exceptions using Loguru.

    Args:
        url (str): The URL to send the GET request to.
        header (dict): A dictionary of HTTP headers to include in the request.
        timeout (int): The timeout duration for the request in seconds.

    Returns:
        requests.Response | None: The response object if the request is successful, or
        None if an exception occurs.

    Raises:
        No exceptions are raised; they are caught and logged instead.

    Logs:
        - HTTP errors
        - Connection timeout errors
        - General connection errors

    Note:
        This function uses a global `logger` object for logging, which should be
        a configured Loguru logger instance.
    """
    try:
        return requests.get(url, headers=header, timeout=timeout)
    except requests.exceptions.HTTPError as err:
        logger.error(f"HTTP error occurred: {err}")
        return None
    except requests.exceptions.ConnectTimeout as err:
        logger.error(f"Connection timeout error occurred: {err}")
        return None
    except requests.exceptions.ConnectionError as err:
        logger.error(f"Connection error occurred: {err}")
        return None