Enh/type hints revisit (#21)

* Remove duplicated type hints in subclasses

* revamp type hints

Author: ebram96

src/abstract_api/avatars/avatars.py

@@ -11,11 +11,11 @@ class Avatars(BaseService[AvatarsResponse]):
     Attributes:
         _subdomain: Avatars service subdomain.
     """
-    _subdomain: str = "avatars"
+    _subdomain = "avatars"
 
     def create(
         self,
-        name,
+        name: str,
         image_size: int | None = None,
         image_format: str | None = None,
         font_size: float | None = None,

src/abstract_api/company_enrichment/company_enrichment.py

@@ -17,7 +17,7 @@ class CompanyEnrichment(
     Attributes:
         _subdomain: Company enrichment service subdomain.
     """
-    _subdomain: str = "companyenrichment"
+    _subdomain = "companyenrichment"
     _response_fields = RESPONSE_FIELDS
 
     def check(

src/abstract_api/core/bases/_base_response.py

@@ -24,10 +24,18 @@ def body(self) -> bytes:
 
 
 class BaseResponse(ABC):
-    """Base Abstract API service response."""
+    """Base Abstract API service response.
+
+    Attributes:
+        _meta_class: Class (type) of meta.
+    """
     _meta_class: ClassVar[Type[BaseResponseMeta]]
-    meta: BaseResponseMeta
 
     def __init__(self, response: requests.models.Response) -> None:
         """Initialize a new BaseResponse."""
-        self.meta = self._meta_class(response)
+        self._meta: BaseResponseMeta = self._meta_class(response)
+
+    @property
+    def meta(self) -> BaseResponseMeta:
+        """Meta data about response."""
+        return self._meta

src/abstract_api/core/bases/base_service.py

@@ -34,7 +34,7 @@ def __init__(self, api_key: str) -> None:
         Args:
             api_key: API key to be used to authenticate with AbstractAPI.
         """
-        self._api_key = api_key
+        self._api_key: str = api_key
 
     def _service_url(self, action: str = "") -> str:
         """Builds and returns an API URL for a service using its subdomain.

src/abstract_api/core/bases/file_response.py

@@ -11,7 +11,7 @@ class FileResponseMeta(BaseResponseMeta):
 
 class FileResponse(BaseResponse):
     """TODO."""
-    _meta_class: ClassVar[Type] = FileResponseMeta
+    _meta_class: ClassVar[Type[FileResponseMeta]] = FileResponseMeta
     meta: FileResponseMeta
 
     def __init__(self, response: requests.models.Response) -> None:

src/abstract_api/core/bases/json_response.py

@@ -1,4 +1,4 @@
-from typing import TYPE_CHECKING, Any, ClassVar, Type, Union
+from typing import TYPE_CHECKING, Any, ClassVar, Type
 
 import requests
 
@@ -17,15 +17,15 @@ def __init__(self, response: requests.models.Response) -> None:
             self._body_json = None
 
     @property
-    def body_json(self) -> Union[dict[str, Any], list[dict[str, Any]]]:
+    def body_json(self) -> dict[str, Any] | list[dict[str, Any]]:
         """JSON representation of response body returned from API request."""
         return self._body_json
 
 
 class JSONResponse(BaseResponse):
     """TODO."""
     _response_fields: frozenset[str]
-    _meta_class: ClassVar[Type] = JSONResponseMeta
+    _meta_class: ClassVar[Type[JSONResponseMeta]] = JSONResponseMeta
     meta: JSONResponseMeta
 
     def _init_response_field(self, field: str, value: Any) -> None:
@@ -37,7 +37,7 @@ def __init__(
         response: requests.models.Response,
         response_fields: frozenset[str],
         list_response: bool = False
-    ):
+    ) -> None:
         """TODO."""
         super().__init__(response)
         self._response_fields = response_fields

src/abstract_api/email_validation/email_validation.py

@@ -10,7 +10,7 @@ class EmailValidation(BaseService[EmailValidationResponse]):
     Attributes:
         _subdomain: Email validation service subdomain.
     """
-    _subdomain: str = "emailvalidation"
+    _subdomain = "emailvalidation"
 
     def check(
         self,

src/abstract_api/email_validation/email_validation_response.py

@@ -1,4 +1,4 @@
-from typing import Any, ClassVar
+from typing import Any
 
 import requests
 
@@ -9,7 +9,7 @@
 class EmailValidationResponse(JSONResponse):
     """Email validation service response."""
 
-    _complex_bool_fields: ClassVar[frozenset[str]] = frozenset({
+    _complex_bool_fields = frozenset({
         "is_valid_format",
         "is_free_email",
         "is_disposable_email",

src/abstract_api/exchange_rates/exchange_rates.py

@@ -16,7 +16,7 @@ class ExchangeRates(BaseService):
     Attributes:
         _subdomain: Exchange rates service subdomain.
     """
-    _subdomain: str = "exchange-rates"
+    _subdomain = "exchange-rates"
 
     @staticmethod
     def _target_as_param(target: Iterable[str] | None = None) -> str | None:

src/abstract_api/holidays/holidays.py

@@ -11,7 +11,7 @@ class Holidays(BaseService[HolidaysResponse]):
     Attributes:
         _subdomain: Holidays service subdomain.
     """
-    _subdomain: str = "holidays"
+    _subdomain = "holidays"
 
     def lookup(
         self,