core/http_client.py

"""Shared HTTP client factory."""

import httpx
from typing import Optional, Dict


def create_http_client(

    timeout: float = 30.0,

    headers: Optional[Dict[str, str]] = None,

    follow_redirects: bool = True

) -> httpx.AsyncClient:
    """

    Create a configured async HTTP client.



    Args:

        timeout: Request timeout in seconds

        headers: Default headers to include

        follow_redirects: Whether to follow redirects



    Returns:

        Configured httpx.AsyncClient

    """
    default_headers = {
        "Accept": "application/json",
        "Content-Type": "application/json",
    }

    if headers:
        default_headers.update(headers)

    return httpx.AsyncClient(
        timeout=timeout,
        headers=default_headers,
        follow_redirects=follow_redirects
    )