pdate onoanager

Author: IhorSotnyk

README.md

@@ -13,5 +13,111 @@ This framework is published at the TestPyPI, install it with pip:
 ## Usage
 
 1. Request your token at https://api.monobank.ua/
-2. Use this token to obtain personal data of a monobank client
+2. Use that token to initialize client:
+
+    from monobank_api_client.managers import MonoManager
+
+    token = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
+
+    mng = MonoManager(token)
+
+### Methods
+
+Get currencies
+
+```python
+>>> mng.get_currency()
+[
+  200,
+  [
+    {
+      "currencyCodeA": 840,
+      "currencyCodeB": 980,
+      "date": 1702591273,
+      "rateBuy": 36.95,
+      "rateSell": 37.4406
+    },
+    {
+      "currencyCodeA": 978,
+      "currencyCodeB": 980,
+      "date": 1702623973,
+      "rateBuy": 40.35,
+      "rateSell": 41.1404
+    },
+    {
+      "currencyCodeA": 978,
+      "currencyCodeB": 840,
+      "date": 1702623973,
+      "rateBuy": 1.086,
+      "rateSell": 1.1025
+    },
+    ...
+  ]
+]
+```
+
+Get client info
+
+```python
+>>> mng.get_client_info()
+[
+  200,
+  {
+    "clientId": "xxxxxxxxxx",
+    "name": "Lastname Firstname",
+    "webHookUrl": "",
+    "permissions": "psfj",
+    "accounts": [
+      {
+        "id": "xxxxxxxxxxxxxxxxxxxxxx",
+        "sendId": "xxxxxxxxxx",
+        "currencyCode": 980,
+        "cashbackType": "UAH",
+        "balance": 1341,
+        "creditLimit": 0,
+        "maskedPan": [
+          "xxxxxx******xxxx"
+        ],
+        "type": "black",
+        "iban": "UAxxxxxxxxxxxxxxxxxxxxxxxxxxx"
+      }
+    ]
+  }
+]
+
+```
+
+Get statement
+```python
+>>> period = 31
+>>> mng.get_statement(period)
+[
+  200,
+  [
+    {
+      "id": "xxxxxxxxxxxxxxxxxx",
+      "time": 1702464077,
+      "description": "Файно Маркет",
+      "mcc": 5499,
+      "originalMcc": 5499,
+      "amount": -46030,
+      "operationAmount": -46030,
+      "currencyCode": 980,
+      "commissionRate": 0,
+      "cashbackAmount": 460,
+      "balance": 1341,
+      "hold": false,
+      "receiptId": "xxxx-xxxx-xxxx-xxxx"
+    },
+  ...
+  ]
+]
+```
+
+Create a Webhook
+```python
+>>> mng.create_webhook('https://myserver.com/hookpath')
+```
+
+    
 

monobank_api_client/managers.py

@@ -1,4 +1,4 @@
-from typing import Tuple, Dict
+from typing import Tuple, Dict, List
 import requests
 from datetime import datetime
 
@@ -12,14 +12,9 @@
 
 class MonoManager:
 
-    def __init__(self, request, token=None):
-        self.request = request
+    def __init__(self, token=None):
         self._token = token
 
-    _session = requests.Session()
-
-    _day_unix = 86400   # 1 day (UNIX)
-    
     _mono_currency_uri = MONOBANK_CURRENCY_URI
     _mono_client_info_uri = MONOBANK_CLIENT_INFO_URI
     _mono_statement_uri = MONOBANK_STATEMENT_URI
@@ -66,48 +61,62 @@ def mono_webhook_uri(self, new_uri):
         self._mono_webhook_uri = new_uri
 
     @classmethod
-    @property
-    def get_currency(cls) -> Tuple[int, Dict]:
+    def session(cls) -> requests.Session:
+        return requests.Session()
+    
+    @staticmethod
+    def __date(period: int) -> Tuple[int]:
+        _day = 86400   # 1 day (UNIX)
         try:
-            session = cls._session
-            uri = cls._mono_currency_uri
+            time_delta = int(datetime.now().timestamp()) - (period * _day)
+            return time_delta
+        except Exception as exc:
+            exception = {
+                'detail': str(exc)
+            }
+            return exception
+
+    def get_currency(self) -> Tuple[int, Dict | List[Dict]]:
+        try:
+            session = self.session()
+            uri = self.mono_currency_uri
             response = session.get(uri)
+            code = response.status_code
             response.raise_for_status()
-            return response.status_code, response.json()
+            return code, response.json()
         except requests.exceptions.HTTPError as exc:
             error_response = {
-                "code": response.status_code,
-                "detail": str(exc),
+                "detail": str(exc)
             }
-            return error_response
+            return code, error_response
         except Exception as exc:
             exception = {
                 "detail": str(exc)
             }
             return exception
 
-    def get_client_info(self) -> Tuple[int, Dict]:
+    def get_client_info(self) -> Tuple[int, Dict | List[Dict]]:
         try:
-            session = self._session
-            token = self._token
-            uri = self._mono_client_info_uri
+            session = self.session()
+            token = self.token
+            uri = self.mono_client_info_uri
             headers = {"X-Token": token}
             response = session.get(uri, headers=headers)
+            code = response.status_code
             response.raise_for_status()
-            return response.status_code, response.json()
+            return code, response.json()
         except requests.exceptions.HTTPError as exc:
             error_response = {
-                "code": response.status_code,
-                "detail": str(exc),
+                "detail": str(exc)
             }
-            return error_response
+            return code, error_response
         except Exception as exc:
             exception = {
                 "detail": str(exc)
             }
             return exception
 
-    def get_balance(self) -> Tuple[int, Dict]:
+    def get_balance(self) -> Tuple[int, Dict | List[Dict]]:
         try:
             response = self.get_client_info()
             code = response[0]
@@ -119,43 +128,43 @@ def get_balance(self) -> Tuple[int, Dict]:
         except Exception:
             return response
 
-    def get_statement(self, period: int) -> Tuple[int, Dict]:
+    def get_statement(self, period: int) -> Tuple[int, Dict | List[Dict]]:
         try:
-            session = self._session
-            token = self._token
-            uri = self._mono_statement_uri
+            session = self.session()
+            token = self.token
+            uri = self.mono_statement_uri
             headers = {"X-Token": token}
-            time_delta = int(datetime.now().timestamp()) - (period * self._day_unix)
+            time_delta = self.__date(period)
             response = session.get(f"{uri}{time_delta}/", headers=headers)
+            code = response.status_code
             response.raise_for_status()
-            return response.status_code, response.json()
+            return code, response.json()
         except requests.exceptions.HTTPError as exc:
             error_response = {
-                "code": response.status_code,
-                "detail": str(exc),
+                "detail": str(exc)
             }
-            return error_response
+            return code, error_response
         except Exception as exc:
             exception = {
                 "detail": str(exc)
             }
             return exception
 
-    def create_webhook(self, url: str) -> Tuple[int, Dict]:
+    def create_webhook(self, webhook: str) -> Tuple[int, Dict | List[Dict]]:
         try:            
-            session = self._session
-            token = self._token
-            uri = self._mono_webhook_uri
+            session = self.session()
+            token = self.token
+            uri = self.mono_webhook_uri
             headers = {"X-Token": token}
-            response = session.post(uri, headers=headers, data=url)
+            response = session.post(uri, headers=headers, data=webhook)
+            code = response.status_code
             response.raise_for_status()
-            return response.status_code, response.json()
+            return code, response.json()
         except requests.exceptions.HTTPError as exc:
             error_response = {
-                "code": response.status_code,
                 "detail": str(exc)
             }
-            return error_response
+            return code, error_response
         except Exception as exc:
             exception = {
                 "detail": str(exc)

requirements.txt

@@ -1 +1,2 @@
-requests
+requests
+python-dotenv==1.0.0

setup.py

@@ -8,7 +8,7 @@ def readme():
 
 setup(
   name='monobank_api_client',
-  version='0.1.5',
+  version='0.1.6',
   author='ihor.sotnyk',
   author_email='ihor.sotnyk@onix-systems.com',
   description='This module is designed for quick interaction with the monobank API.',