http.py

"""HTTP helper abstraction layer."""

from __future__ import annotations

from abc import ABC, abstractmethod
from typing import Any, Literal

from astroapi.utils.http_client import HttpClient


class HttpHelper(ABC):
    """Abstract HTTP helper interface.

    This abstraction allows for easier testing and potential alternative
    HTTP client implementations.
    """

    @abstractmethod
    def get(
        self,
        url: str,
        params: dict[str, Any] | None = None,
        response_type: Literal["json", "text"] = "json",
    ) -> Any:
        """Make GET request.

        Args:
            url: Request URL
            params: Query parameters
            response_type: Expected response type

        Returns:
            Response data
        """

    @abstractmethod
    def post(
        self,
        url: str,
        json: dict[str, Any] | None = None,
        response_type: Literal["json", "text"] = "json",
    ) -> Any:
        """Make POST request.

        Args:
            url: Request URL
            json: JSON request body
            response_type: Expected response type

        Returns:
            Response data
        """


class HttpxHttpHelper(HttpHelper):
    """Concrete HTTP helper implementation using httpx.

    Wraps HttpClient to provide the HttpHelper interface.
    """

    def __init__(self, client: HttpClient) -> None:
        """Initialize helper with HTTP client.

        Args:
            client: HttpClient instance
        """
        self._client = client

    def get(
        self,
        url: str,
        params: dict[str, Any] | None = None,
        response_type: Literal["json", "text"] = "json",
    ) -> Any:
        """Make GET request.

        Args:
            url: Request URL
            params: Query parameters
            response_type: Expected response type

        Returns:
            Response data
        """
        return self._client.get(url, params=params, response_type=response_type)

    def post(
        self,
        url: str,
        json: dict[str, Any] | None = None,
        response_type: Literal["json", "text"] = "json",
    ) -> Any:
        """Make POST request.

        Args:
            url: Request URL
            json: JSON request body
            response_type: Expected response type

        Returns:
            Response data
        """
        return self._client.post(url, json=json, response_type=response_type)