novaposhta-python-client 0.1.9__tar.gz → 0.1.11__tar.gz

{novaposhta_python_client-0.1.9 → novaposhta_python_client-0.1.11}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: novaposhta-python-client
-Version: 0.1.9
+Version: 0.1.11
 Summary: Python client for Nova Poshta API
 Home-page: https://github.com/semolex/novaposhta-python-client
 License: MIT
@@ -8,17 +8,23 @@ Keywords: api,nova-poshta,novaposhta,nova-poshta-api,novaposhta-api
 Author: Oleksii
 Author-email: semolex@live.com
 Requires-Python: >=3.9,<4.0
-Classifier: Development Status :: 4 - Beta
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: English
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Topic :: Software Development :: Build Tools
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Dist: h11 (>=0.16.0,<0.17.0)
 Requires-Dist: httpx (>=0.24.0)
 Project-URL: Repository, https://github.com/semolex/novaposhta-python-client
 Description-Content-Type: text/markdown
@@ -28,8 +34,14 @@ Description-Content-Type: text/markdown
 A Python client for interfacing with the Nova Poshta API. Designed to provide easy access to all API functionalities
 with emphasis on consistency and usability.
 
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-
+[![Tests](https://github.com/semolex/novaposhta-python-client/actions/workflows/tests.yml/badge.svg)](https://github.com/semolex/novaposhta-python-client/actions/workflows/tests.yml)
+[![License](https://img.shields.io/github/license/semolex/novaposhta-python-client)](https://github.com/semolex/novaposhta-python-client/blob/master/LICENSE.md)
+[![PyPI](https://img.shields.io/pypi/v/novaposhta-python-client)](https://pypi.org/project/novaposhta-python-client/)
+[![Downloads](https://pepy.tech/badge/novaposhta-python-client)](https://pepy.tech/project/novaposhta-python-client)
+[![Downloads](https://pepy.tech/badge/novaposhta-python-client/month)](https://pepy.tech/project/novaposhta-python-client)
+[![Python Versions](https://img.shields.io/pypi/pyversions/novaposhta-python-client.svg)](https://pypi.org/project/novaposhta-python-client/)
+[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
+[![Imports: isort](https://img.shields.io/badge/%20imports-isort-%231674b1)](https://pycqa.github.io/isort/)
 
 ## Description
 
@@ -161,17 +173,98 @@ To get your custom model instance, use the get method:
 my_custom_model = client.get(MyCustomModel.name)
 ```
 
-## Testing and linting
+## Experimental: Chain Operations
+
+The chain functionality allows you to sequence multiple API operations, where each operation's output can be transformed and passed to the next operation. This is particularly useful for scenarios that require multiple dependent API calls, like searching for addresses or creating shipments.
+Each result of `prepare_next` is passed to the next operation as updated `kwargs`.
+> ⚠️ **Note**: This feature is experimental and currently optimized for async usage.
+
+### Basic Usage
+
+```python
+from novaposhta.client import NovaPoshtaApi
+from novaposhta.chains import Chain 
+
+# Initialize client in async mode
+client = NovaPoshtaApi("API_KEY", async_mode=True)
+
+# Create a chain of operations
+chain = (
+    Chain(
+        client.address.get_areas,
+        prepare_next=lambda x: {'ref': x['data'][0]['AreasCenter']}
+    ) |
+    Chain(
+        client.address.get_cities,
+        prepare_next=lambda x: {'city_ref': x['data'][0]['Ref']}
+    ) |
+    Chain(
+        client.address.get_street,
+        kwargs={'find_by_string': 'Street Name'}
+    )
+)
+
+# Execute chain
+results = await chain.execute_async()
+```
+
+### Features
+
+- Chain multiple API operations using the `|` operator
+- Transform operation results for next operation using `prepare_next`
+- Automatic error handling and chain interruption on failure
+- Preserve both original API responses and transformed data
+- Initial parameters via `kwargs`
+
+### Common Patterns
 
+```python
+# Address search chain
+from novaposhta.client import NovaPoshtaApi
+
+client = NovaPoshtaApi("API_KEY", async_mode=True)
+from novaposhta.chains import Chain
+address = client.address
+chain = (
+    Chain(
+        address.search_settlements,
+        kwargs={'city_name': 'Київ'},
+        prepare_next=lambda x: {'settlement_ref': x['data'][0]['Ref']}
+    ) |
+    Chain(
+        address.search_settlement_streets,
+        kwargs={'street_name': 'Main'}
+    )
+)
+
+# Execute and process results
+results = await chain.execute_async()
+for result in results:
+    print(f"Success: {result.success}")
+    print(f"Data: {result.data}")
+    print(f"Next kwargs: {result.next_kwargs}")
+```
+
+### Limitations
+
+- Currently optimized for async usage
+- Experimental API that may change
+- Sequential execution only (no parallel operations)
+
+
+
+## Testing and linting
+Note: install dev dependencies first
 ```bash
-poetry run black novaposhta
+poetry run black novaposhta/
+poetry run isort novaposhta/
 poetry run mypy novaposhta/
-poetry run pytest tests/
+poetry run pytest --cov=novaposhta tests/
 ```
 
 ## Contributing
 
 We welcome contributions that can help in enhancing the functionality and improving the consistency of the client. For
 bugs or feature requests, please open an issue on the GitHub repository.
-Please, use `black` and `mypy` as your instrument for code formatting and type checking.
+Please, use `black`, `isort` and `mypy` as your instrument for code formatting and type checking.
 

{novaposhta_python_client-0.1.9 → novaposhta_python_client-0.1.11}/README.md

@@ -3,8 +3,14 @@
 A Python client for interfacing with the Nova Poshta API. Designed to provide easy access to all API functionalities
 with emphasis on consistency and usability.
 
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
-
+[![Tests](https://github.com/semolex/novaposhta-python-client/actions/workflows/tests.yml/badge.svg)](https://github.com/semolex/novaposhta-python-client/actions/workflows/tests.yml)
+[![License](https://img.shields.io/github/license/semolex/novaposhta-python-client)](https://github.com/semolex/novaposhta-python-client/blob/master/LICENSE.md)
+[![PyPI](https://img.shields.io/pypi/v/novaposhta-python-client)](https://pypi.org/project/novaposhta-python-client/)
+[![Downloads](https://pepy.tech/badge/novaposhta-python-client)](https://pepy.tech/project/novaposhta-python-client)
+[![Downloads](https://pepy.tech/badge/novaposhta-python-client/month)](https://pepy.tech/project/novaposhta-python-client)
+[![Python Versions](https://img.shields.io/pypi/pyversions/novaposhta-python-client.svg)](https://pypi.org/project/novaposhta-python-client/)
+[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
+[![Imports: isort](https://img.shields.io/badge/%20imports-isort-%231674b1)](https://pycqa.github.io/isort/)
 
 ## Description
 
@@ -136,16 +142,97 @@ To get your custom model instance, use the get method:
 my_custom_model = client.get(MyCustomModel.name)
 ```
 
-## Testing and linting
+## Experimental: Chain Operations
+
+The chain functionality allows you to sequence multiple API operations, where each operation's output can be transformed and passed to the next operation. This is particularly useful for scenarios that require multiple dependent API calls, like searching for addresses or creating shipments.
+Each result of `prepare_next` is passed to the next operation as updated `kwargs`.
+> ⚠️ **Note**: This feature is experimental and currently optimized for async usage.
+
+### Basic Usage
+
+```python
+from novaposhta.client import NovaPoshtaApi
+from novaposhta.chains import Chain 
+
+# Initialize client in async mode
+client = NovaPoshtaApi("API_KEY", async_mode=True)
+
+# Create a chain of operations
+chain = (
+    Chain(
+        client.address.get_areas,
+        prepare_next=lambda x: {'ref': x['data'][0]['AreasCenter']}
+    ) |
+    Chain(
+        client.address.get_cities,
+        prepare_next=lambda x: {'city_ref': x['data'][0]['Ref']}
+    ) |
+    Chain(
+        client.address.get_street,
+        kwargs={'find_by_string': 'Street Name'}
+    )
+)
+
+# Execute chain
+results = await chain.execute_async()
+```
+
+### Features
+
+- Chain multiple API operations using the `|` operator
+- Transform operation results for next operation using `prepare_next`
+- Automatic error handling and chain interruption on failure
+- Preserve both original API responses and transformed data
+- Initial parameters via `kwargs`
+
+### Common Patterns
 
+```python
+# Address search chain
+from novaposhta.client import NovaPoshtaApi
+
+client = NovaPoshtaApi("API_KEY", async_mode=True)
+from novaposhta.chains import Chain
+address = client.address
+chain = (
+    Chain(
+        address.search_settlements,
+        kwargs={'city_name': 'Київ'},
+        prepare_next=lambda x: {'settlement_ref': x['data'][0]['Ref']}
+    ) |
+    Chain(
+        address.search_settlement_streets,
+        kwargs={'street_name': 'Main'}
+    )
+)
+
+# Execute and process results
+results = await chain.execute_async()
+for result in results:
+    print(f"Success: {result.success}")
+    print(f"Data: {result.data}")
+    print(f"Next kwargs: {result.next_kwargs}")
+```
+
+### Limitations
+
+- Currently optimized for async usage
+- Experimental API that may change
+- Sequential execution only (no parallel operations)
+
+
+
+## Testing and linting
+Note: install dev dependencies first
 ```bash
-poetry run black novaposhta
+poetry run black novaposhta/
+poetry run isort novaposhta/
 poetry run mypy novaposhta/
-poetry run pytest tests/
+poetry run pytest --cov=novaposhta tests/
 ```
 
 ## Contributing
 
 We welcome contributions that can help in enhancing the functionality and improving the consistency of the client. For
 bugs or feature requests, please open an issue on the GitHub repository.
-Please, use `black` and `mypy` as your instrument for code formatting and type checking.
+Please, use `black`, `isort` and `mypy` as your instrument for code formatting and type checking.

novaposhta_python_client-0.1.11/novaposhta/chains.py

@@ -0,0 +1,104 @@
+"""Chain of calls with error handling and data passing between calls. """
+
+import asyncio
+from dataclasses import dataclass
+from typing import Any, Callable, Dict, List, Optional, TypeVar, Union
+
+T = TypeVar("T")
+
+
+@dataclass
+class ChainResult:
+    """
+    Result of a single chain execution.
+    """
+
+    success: bool
+    data: Optional[Any]
+    error: Optional[str]
+    next_kwargs: Optional[Dict[str, Any]] = None
+
+
+@dataclass
+class Chain:
+    """
+    Chain object that represents a single call in the chain.
+    """
+
+    method: Callable
+    kwargs: Optional[Dict[str, Any]] = None
+    prepare_next: Optional[Callable[[Any], Dict[str, Any]]] = None
+
+    async def execute(self, prev_result: Optional[ChainResult] = None) -> ChainResult:
+        """
+        Execute the chain.
+
+        :param prev_result: result of the previous chain.
+        :return: result of the current chain.
+        """
+        try:
+            execution_kwargs = {**(self.kwargs or {})}
+            if prev_result and prev_result.next_kwargs:
+                execution_kwargs.update(prev_result.next_kwargs)
+
+            result = self.method(**execution_kwargs)
+            if asyncio.iscoroutine(result):
+                result = await result
+
+            next_kwargs = self.prepare_next(result) if self.prepare_next else {}
+
+            return ChainResult(
+                success=result.get("success", False),
+                data=result.get("data"),
+                error=None,
+                next_kwargs=next_kwargs,
+            )
+        except Exception as e:
+            return ChainResult(success=False, data=None, error=str(e), next_kwargs=None)
+
+    def __or__(self, other: "Chain") -> "ChainExecutor":
+        """
+        Create a chain executor with the current chain and another chain.
+        Allows chaining multiple chains together via the `|` operator.
+
+        :param other: another chain.
+        :return ChainExecutor: chain executor with the current chain and another chain.
+        """
+        return ChainExecutor([self, other])
+
+
+class ChainExecutor:
+    """
+    Chain executor that executes multiple chains in a sequence.
+    """
+
+    def __init__(self, chains: Optional[List[Chain]] = None):
+        self.chains = chains or []
+
+    def __or__(self, chain: Chain) -> "ChainExecutor":
+        """
+        Add a chain to the chain executor.
+
+        :param chain: chain to add.
+        :return ChainExecutor: chain executor with the added chain.
+        """
+        self.chains.append(chain)
+        return self
+
+    async def execute_async(self) -> List[ChainResult]:
+        """
+        Execute all chains in the chain executor asynchronously.
+
+        :return: list of results of each chain execution
+        """
+        results = []
+        prev_result = None
+
+        for chain in self.chains:
+            result = await chain.execute(prev_result)
+            results.append(result)
+            if not result.success:
+                break
+            prev_result = result
+
+        return results

{novaposhta_python_client-0.1.9 → novaposhta_python_client-0.1.11}/novaposhta/client.py

@@ -1,6 +1,6 @@
 """Client for Nova Poshta API. """
 
-from typing import Type, TypeVar, Optional, Callable
+from typing import Final, Optional, Type, TypeVar
 
 import httpx
 
@@ -13,9 +13,11 @@ from .models.counterparty import Counterparty
 from .models.internet_document import InternetDocument
 from .models.scan_sheet import ScanSheet
 from .models.tracking_document import TrackingDocument
-from .types import DictStrAny, MaybeAsync
+from .types import DictStrAny, HttpRequest, MaybeAsync, RequestData, RequestSender
 
-HEADERS = {"Content-Type": "application/json"}
+HEADERS: Final[dict[str, str]] = {"Content-Type": "application/json"}
+API_DEFAULT_ENDPOINT: Final[str] = "https://api.novaposhta.ua/v2.0/json/"
+DEFAULT_TIMEOUT: Final[int] = 10
 
 BaseModelType = TypeVar("BaseModelType", bound=BaseModel)
 
@@ -35,7 +37,7 @@ class NovaPoshtaApi:
     def __init__(
         self,
         api_key: str,
-        api_endpoint: str = "https://api.novaposhta.ua/v2.0/json/",
+        api_endpoint: str = API_DEFAULT_ENDPOINT,
         http_client=httpx,
         timeout: int = 10,
         raise_for_errors: bool = False,
@@ -51,10 +53,17 @@ class NovaPoshtaApi:
         :param raise_for_errors: Whether to check and raise errors as exceptions.
         :param async_mode: Whether to use async mode.
         """
+        if not api_key:
+            raise ValueError("API key is required")
+        if timeout <= 0:
+            raise ValueError("Timeout must be positive")
+        if not api_endpoint or not api_endpoint.startswith(("http://", "https://")):
+            raise ValueError("Invalid API endpoint URL")
+
         self.api_key = api_key
         self.api_endpoint = api_endpoint
         self.timeout = timeout
-        self._send: Callable[[DictStrAny], MaybeAsync]
+        self._send: RequestSender
         if async_mode:
             self.async_http_client: Optional[httpx.AsyncClient] = (
                 http_client.AsyncClient(timeout=timeout)
@@ -65,11 +74,12 @@ class NovaPoshtaApi:
                 timeout=timeout
             )
             self._send = self._send_sync
+            self._send = self._send_sync
         self.raise_for_errors = raise_for_errors
         self.async_mode = async_mode
         self._models_pool: DictStrAny = {}
 
-    def _send_sync(self, request: DictStrAny) -> DictStrAny:
+    def _send_sync(self, request: HttpRequest) -> DictStrAny:
         """
         Sends sync request to the API.
 
@@ -81,7 +91,7 @@ class NovaPoshtaApi:
         response = self.sync_http_client.post(**request)
         return self._maybe_check_errors(response.json())
 
-    async def _send_async(self, request: DictStrAny) -> DictStrAny:
+    async def _send_async(self, request: HttpRequest) -> DictStrAny:
         """
         Sends async request to the API.
 
@@ -104,13 +114,13 @@ class NovaPoshtaApi:
         :param method_props: properties to pass to the method.
         :return: response dict.
         """
-        data = {
+        data: RequestData = {
             "apiKey": self.api_key,
             "modelName": model_name,
             "calledMethod": api_method,
             "methodProperties": method_props,
         }
-        request = {
+        request: HttpRequest = {
             "url": self.api_endpoint,
             "headers": HEADERS,
             "json": data,
@@ -147,23 +157,29 @@ class NovaPoshtaApi:
 
         :param response: response dict.
         :return: response dict.
+        :raises InvalidAPIKeyError: if API key is invalid
+        :raises APIRequestError: if any other API error occurs
         """
         if not self.raise_for_errors:
             return response
 
         if response["success"]:
             return response
+
         errors = response["errors"]
-        error = ""
-        if isinstance(errors, list):
-            error = ", ".join(errors)
-        elif isinstance(errors, dict):
-            error = ", ".join([f"{k}: {v}" for k, v in errors.items()])
-
-        if "API key" in error:
-            raise InvalidAPIKeyError(error)
-        else:
-            raise APIRequestError(error)
+        error_msg = (
+            ", ".join(errors)
+            if isinstance(errors, list)
+            else (
+                ", ".join(f"{k}: {v}" for k, v in errors.items())
+                if isinstance(errors, dict)
+                else str(errors)
+            )
+        )
+
+        if "API key" in error_msg:
+            raise InvalidAPIKeyError(error_msg)
+        raise APIRequestError(error_msg)
 
     def close_sync(self):
         """

{novaposhta_python_client-0.1.9 → novaposhta_python_client-0.1.11}/novaposhta/models/additional_service.py

@@ -1,8 +1,7 @@
 """AdditionalService model module."""
 
-from .base import BaseModel, api_method
-
 from ..types import OptStr, StrOrNum
+from .base import BaseModel, api_method
 
 
 class AdditionalService(BaseModel):

{novaposhta_python_client-0.1.9 → novaposhta_python_client-0.1.11}/novaposhta/models/address.py

@@ -1,9 +1,8 @@
 """Address model module."""
 
+from ..types import OptBool, OptStr
 from .base import BaseModel, api_method
 
-from ..types import OptStr, OptBool
-
 
 class Address(BaseModel):
     """

{novaposhta_python_client-0.1.9 → novaposhta_python_client-0.1.11}/novaposhta/models/common.py

@@ -1,9 +1,8 @@
 """Common model module."""
 
+from ..types import OptInt, OptStr
 from .base import BaseModel, api_method
 
-from ..types import OptStr, OptInt
-
 
 class Common(BaseModel):
     """

{novaposhta_python_client-0.1.9 → novaposhta_python_client-0.1.11}/novaposhta/models/counterparty.py

@@ -1,8 +1,7 @@
 """Counterparty model module."""
 
-from .base import BaseModel, api_method
-
 from ..types import OptStr
+from .base import BaseModel, api_method
 
 
 class Counterparty(BaseModel):

{novaposhta_python_client-0.1.9 → novaposhta_python_client-0.1.11}/novaposhta/models/internet_document.py

@@ -2,15 +2,8 @@
 
 from typing import List
 
+from ..types import OptDict, OptInt, OptListOfDicts, OptStr, OptStrOrNum, StrOrNum
 from .base import BaseModel, api_method
-from ..types import (
-    OptStr,
-    StrOrNum,
-    OptListOfDicts,
-    OptDict,
-    OptInt,
-    OptStrOrNum,
-)
 
 
 class InternetDocument(BaseModel):

{novaposhta_python_client-0.1.9 → novaposhta_python_client-0.1.11}/novaposhta/models/scan_sheet.py

@@ -1,8 +1,9 @@
 """ScanSheet model module."""
 
-from .base import BaseModel, api_method
 from typing import List
 
+from .base import BaseModel, api_method
+
 
 class ScanSheet(BaseModel):
     """

{novaposhta_python_client-0.1.9 → novaposhta_python_client-0.1.11}/novaposhta/models/tracking_document.py

@@ -1,8 +1,8 @@
 """TrackingDocument model module."""
 
-from .base import BaseModel, api_method
+from typing import Dict, List
 
-from typing import List, Dict
+from .base import BaseModel, api_method
 
 
 class TrackingDocument(BaseModel):

novaposhta_python_client-0.1.11/novaposhta/types.py

@@ -0,0 +1,41 @@
+"""Type aliases for novaposhta package."""
+
+from typing import Any, Callable, Coroutine, Dict, List, Optional, TypedDict, Union
+
+
+class RequestData(TypedDict):
+    """
+    Request data for Nova Poshta API.
+    """
+
+    apiKey: str
+    modelName: str
+    calledMethod: str
+    methodProperties: Dict[str, Any]
+
+
+class HttpRequest(TypedDict):
+    """
+    Request data for HTTP client.
+    """
+
+    url: str
+    headers: Dict[str, str]
+    json: RequestData
+    timeout: int
+
+
+OptStr = Optional[str]
+StrOrNum = Union[str, float, int]
+DictStrAny = Dict[str, Any]
+MaybeAsync = Union[Dict[str, Any], Coroutine[Any, Any, Dict[str, Any]]]
+SyncSender = Callable[[HttpRequest], Dict[str, Any]]
+AsyncSender = Callable[[HttpRequest], Coroutine[Any, Any, Dict[str, Any]]]
+RequestSender = Union[SyncSender, AsyncSender]
+OptStrOrNum = Optional[StrOrNum]
+OptDict = Optional[Dict[str, str]]
+OptListOfDicts = Optional[List[Dict[str, Any]]]
+OptInt = Optional[int]
+OptBool = Optional[
+    Union[bool, int]
+]  # assume that support for cases: 0 is False, 1 is True

{novaposhta_python_client-0.1.9 → novaposhta_python_client-0.1.11}/pyproject.toml

@@ -3,7 +3,7 @@ name = "novaposhta-python-client"
 packages = [
     { include = "novaposhta"}
 ]
-version = "0.1.9"
+version = "0.1.11"
 description = "Python client for Nova Poshta API"
 authors = ["Oleksii <semolex@live.com>"]
 license = "MIT"
@@ -12,19 +12,31 @@ homepage = "https://github.com/semolex/novaposhta-python-client"
 repository = "https://github.com/semolex/novaposhta-python-client"
 keywords = [ "api", "nova-poshta", "novaposhta", "nova-poshta-api", "novaposhta-api"]
 classifiers = [
-    "Development Status :: 4 - Beta",
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: Developers",
     "Topic :: Software Development :: Build Tools",
     "Topic :: Software Development :: Libraries :: Python Modules",
     "Operating System :: OS Independent",
     "Programming Language :: Python :: 3 :: Only",
     "Programming Language :: Python :: 3.9",
-    "License :: OSI Approved :: MIT License"
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: Implementation :: CPython",
+    "License :: OSI Approved :: MIT License",
+    "Natural Language :: English",
+    "Typing :: Typed"
+]
+
+exclude = [
+    "tests/*",
+    "tests/**/*",
+    "**/tests/*",
 ]
 
 [tool.poetry.dependencies]
 python = "^3.9"
 httpx = ">=0.24.0"
-
+h11 = "^0.16.0"
 
 [tool.poetry.group.dev.dependencies]
 mypy = "^1.5.1"
@@ -33,6 +45,8 @@ pytest = "^7.4.2"
 pytest-httpx = "^0.26.0"
 coverage = "^7.3.2"
 pytest-asyncio = "^0.21.1"
+isort = "^5.13.2"
+pytest-cov = "^6.0.0"
 
 [build-system]
 requires = ["poetry-core"]

novaposhta_python_client-0.1.9/novaposhta/types.py

@@ -1,15 +0,0 @@
-"""Type aliases for novaposhta package."""
-
-from typing import List, Optional, Dict, Union, Any, Coroutine
-
-OptStr = Optional[str]
-StrOrNum = Union[str, float, int]
-DictStrAny = Dict[str, Any]
-MaybeAsync = Union[DictStrAny, Coroutine[Any, Any, Any]]
-OptStrOrNum = Optional[StrOrNum]
-OptDict = Optional[Dict[str, str]]
-OptListOfDicts = Optional[List[Dict[str, Any]]]
-OptInt = Optional[int]
-OptBool = Optional[
-    Union[bool, int]
-]  # assume that support for cases: 0 is False, 1 is True