refactor: Add type annotations and type variables to improve type che…

…cking

gpytranslate/gpytranslate.py

@@ -13,12 +13,20 @@
     get_base_headers,
 )
 
-T = TypeVar("T", str, List[str], Dict[Any, str], Mapping)
+T = TypeVar("T", str, List[str], Dict[Any, str], Mapping[Any, str])
+K = TypeVar("K")
 
 
 class AsyncBufferedIOBase(Protocol):
     async def write(self, data: bytes) -> int: ...
     async def close(self) -> None: ...
+
+
+class TranslatorOptions(TypedDict, total=False):
+    timeout: Optional[float]
+    verify: bool
+    cert: Optional[str]
+    trust_env: bool
 
 
 class Translator(BaseTranslator):
@@ -27,9 +35,9 @@ def __init__(
         proxies: Optional[Dict[str, str]] = None,
         url: str = DEFAULT_TRANSLATION_ENDPOINT,
         tts_url: str = DEFAULT_TTS_ENDPOINT,
-        headers: Optional[Union[dict, Callable[[], dict]]] = None,
-        **options,
-    ):
+        headers: Optional[Union[Dict[str, str], Callable[[], Dict[str, str]]]] = None,
+        **options: Any,
+    ) -> None:
         self.url = url
         self.tts_url = tts_url
         self.proxies = proxies

gpytranslate/types/base_translator.py

@@ -1,8 +1,11 @@
 from collections.abc import Mapping
-from typing import Any, Callable, Dict, List, Optional, Union
+from typing import Any, Callable, Dict, List, Optional, TypeVar, Union
 
 from .translated_object import TranslatedObject
 
+K = TypeVar('K')
+V = TypeVar('V')
+
 
 class BaseTranslator:
     headers: Union[Dict[str, str], Callable[[], Dict[str, str]]]
@@ -24,11 +27,11 @@ def parse(raw: Dict[str, Any], translated: bool = True) -> Union[TranslatedObjec
 
     def check(
         self,
-        text: Union[str, Mapping, List[str]],
+        text: Union[str, Mapping[K, str], List[str]],
         raw: Union[Mapping[str, Any], List[Any]],
         client: str,
         dt: str,
-    ) -> Union[TranslatedObject, Dict[str, TranslatedObject], List[TranslatedObject]]:
+    ) -> Union[TranslatedObject, Dict[K, TranslatedObject], List[TranslatedObject]]:
         """Check and parse API response based on input type.
 
         Args:
@@ -59,9 +62,9 @@ def parse_tts(
         targetlang: str,
         idx: int,
         prev: str,
-        text: Union[str, List[str], Dict[Any, str], Mapping[Any, Any]],
+        text: Union[str, List[str], Dict[Any, str], Mapping[K, str]],
         textlen: Optional[int],
-        extra: dict,
+        extra: Dict[str, Any],
     ) -> Dict[str, Union[str, int]]:
         return {
             k: v