client.py

from enum import Enum
from typing import Any, Generic, TypedDict, TypeVar
from urllib.parse import urljoin

import requests
from requests import Response

T = TypeVar("T")


class GenericTypedDict(TypedDict, Generic[T]):
    pass


class HttpMethod(Enum):
    GET = "GET"
    PUT = "PUT"
    POST = "POST"
    PATCH = "PATCH"
    DELETE = "DELETE"


class HttpClient:
    def __init__(self, api_key: str) -> None:
        self._api_key = api_key
        self._base_url = "https://api.usemotion.com"
        self._api_version = "v1"

    def call_api(
        self,
        method: HttpMethod,
        path: str,
        data: GenericTypedDict[Any] | None = None,
        params: dict[str, Any] | None = None,
    ) -> Response:
        """
        Call the Motion API
        """
        path = path[1:] if path.startswith("/") else path
        url = urljoin(self._base_url, f"/{self._api_version}/{path}")
        response = requests.request(
            method=method.value,
            url=url,
            json=data,
            params=params,  # type: ignore
            headers={"X-API-Key": self._api_key},
        )
        response.raise_for_status()
        return response