utg-base 1.1.1__py3-none-any.whl → 1.2.0__py3-none-any.whl

utg_base/services/__init__.py

@@ -0,0 +1 @@
+from .base_api import BaseServiceAPI

utg_base/services/base_api.py

@@ -0,0 +1,128 @@
+from typing import Callable, Any
+
+import requests
+import urllib3
+from requests import Response
+
+from utg_base.utils import call_processor
+
+urllib3.disable_warnings(urllib3.exceptions.InsecureRequestWarning)
+
+
+class BaseServiceAPI:
+    name: str = None
+    base_url: str = None
+    default_response_processor: Callable[[Response], Any] = None
+
+    def request(self, method, path, data=None, json=None, params=None, headers=None,
+                authenticator: Callable[[dict], dict] | None = 'default',
+                response_processor: Callable[[Response], Any] | None = 'default',
+                **kwargs):
+        """
+        Make an HTTP request using the requests' library.
+
+        Args:
+            method: The HTTP method (GET, POST, PUT, DELETE, etc.).
+            path: The API endpoint path.
+            data: Dictionary or bytes to be sent in the body of the request (for form data).
+            json: JSON serializable data to be sent in the body of the request (for JSON data).
+            params: Query parameters as a dictionary.
+            headers: Headers to be included in the request.
+            authenticator: Optional authenticator function to handle authentication with headers.
+                This function should modify the headers for authentication purposes.
+                Example authenticator function:
+                def my_authenticator(headers):
+                    headers['Authorization'] = 'Bearer YOUR_ACCESS_TOKEN'
+                    return headers
+
+            response_processor: Optional function to process the response data.
+                This function should take the requests.Response object as input and return processed data.
+                Example response processor function:
+                def process_response(response):
+                    return response.json()
+        Kwargs:
+            auth: (optional) Auth tuple to enable Basic/Digest/Custom HTTP Auth.
+
+        Returns:
+            The response data, processed if a response processor is provided.
+        """
+
+        if headers is None:
+            headers = {}
+
+        if callable(authenticator):
+            headers = authenticator(headers)
+
+        if authenticator == 'default' and hasattr(self, 'authenticate') and callable(self.authenticate):
+            headers = self.authenticate(headers)
+
+        response = requests.request(
+            method=method,
+            url=self.base_url + path,
+            data=data,
+            json=json,
+            params=params,
+            headers=headers,
+            verify=False,
+            **kwargs
+        )
+
+        if response_processor == 'default':
+            if hasattr(self, 'default_response_processor') and callable(self.default_response_processor):
+                return self.default_response_processor(response)
+            return response
+
+        if response_processor is not None:
+            return response_processor(response)
+
+        return response
+
+    def call(self, method, path, data=None, json=None, params=None, headers=None):
+        data = self.request(
+            method=method,
+            path=path,
+            data=data,
+            json=json,
+            params=params,
+            headers=headers,
+            response_processor=call_processor
+        )
+        return {
+            'path': self.base_url + path,
+            'method': method,
+            'status': data['status'],
+            'reason': data['reason'],
+            'request': params if method == 'get' else json,
+            'response': data['response'],
+        }
+
+    def authenticate(self, headers: dict) -> dict:
+        """
+        Example authenticate method:
+            authenticate(self, headers):
+                headers['Authorization'] = 'Bearer YOUR_ACCESS_TOKEN'
+                return headers
+        :param headers:
+        :return:
+        """
+        return headers
+
+    def get(self, path, data=None, json=None, params=None, headers=None,
+            authenticator: Callable[[dict], dict] | None = 'default',
+            response_processor: Callable[[Response], Any] | None = 'default'):
+        return self.request('get', path, data, json, params, headers, authenticator, response_processor)
+
+    def post(self, path, data=None, json=None, params=None, headers=None,
+             authenticator: Callable[[dict], dict] | None = 'default',
+             response_processor: Callable[[Response], Any] | None = 'default'):
+        return self.request('post', path, data, json, params, headers, authenticator, response_processor)
+
+    def put(self, path, data=None, json=None, params=None, headers=None,
+            authenticator: Callable[[dict], dict] | None = 'default',
+            response_processor: Callable[[Response], Any] | None = 'default'):
+        return self.request('put', path, data, json, params, headers, authenticator, response_processor)
+
+    def patch(self, path, data=None, json=None, params=None, headers=None,
+              authenticator: Callable[[dict], dict] | None = 'default',
+              response_processor: Callable[[Response], Any] | None = 'default'):
+        return self.request('patch', path, data, json, params, headers, authenticator, response_processor)

utg_base/utils/__init__.py

@@ -0,0 +1 @@
+from .response_processors import call_processor, data_processor

utg_base/utils/response_processors.py

@@ -0,0 +1,27 @@
+from requests import Response
+
+
+def call_processor(response: Response):
+    try:
+        data = response.json()
+    except Exception as e:
+        data = response.text
+    return {
+        'status': response.status_code,
+        'reason': response.reason,
+        'response': data,
+    }
+
+
+def data_processor(response: Response):
+    try:
+        data = response.json()
+    except Exception as e:
+        raise Exception({
+            'status': response.status_code,
+            'reason': response.reason,
+            'response': response.text,
+            'exception': str(e)
+        })
+
+    return data

{utg_base-1.1.1.dist-info → utg_base-1.2.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: utg-base
-Version: 1.1.1
+Version: 1.2.0
 Summary: UTG Base Package
 Author: Rovshen
 Author-email: rovshenashirov1619@gmail.com

{utg_base-1.1.1.dist-info → utg_base-1.2.0.dist-info}/RECORD

@@ -17,6 +17,10 @@ utg_base/references_api/migrations/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQe
 utg_base/references_api/models.py,sha256=Vjc0p2XbAPgE6HyTF6vll98A4eDhA5AvaQqsc4kQ9AQ,57
 utg_base/references_api/urls.py,sha256=WkLACQ8GfK5pJkvt8FuYdOxcqSZHj7pYRw51M9WluGw,390
 utg_base/references_api/utils.py,sha256=VzQMnGeWC0I-6BkK_9Lo9eSH6wd4C766oQ84n7SBWyc,5818
-utg_base-1.1.1.dist-info/METADATA,sha256=E1h80NzMbq-KXo5kWFlv-sGVZeKqlihucjvSJt_w2YM,660
-utg_base-1.1.1.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-utg_base-1.1.1.dist-info/RECORD,,
+utg_base/services/__init__.py,sha256=LqtwUiqEZPIbKRGJfve5D5m3ucV6Kw1Nbo5Jnj_hPhY,37
+utg_base/services/base_api.py,sha256=fxwy7VagfyngvcbNdk7b3G5XOyykaJQQyDMub1EyCLA,5187
+utg_base/utils/__init__.py,sha256=wpQYZVF_uF7tVm3tPkyyvZPibPMRKaG4ebe3WPA68uc,63
+utg_base/utils/response_processors.py,sha256=Eim0NIbCt2GH_grzrD6DHqr5iczCHfu1wr9lqThlX3U,605
+utg_base-1.2.0.dist-info/METADATA,sha256=ta_caUY5Jm94LtCn66BJynhRxHUyt99l-JG2hj2HvpY,660
+utg_base-1.2.0.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+utg_base-1.2.0.dist-info/RECORD,,