From 72a95f8ffa5401649f70978e863dd3f21900a611 Mon Sep 17 00:00:00 2001
From: Frederick Muriuki Muriithi
Date: Tue, 21 Jan 2025 16:09:55 -0600
Subject: Add monadic_requests module.

---
 gn_libs/monadic_requests.py | 64 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 64 insertions(+)
 create mode 100644 gn_libs/monadic_requests.py

(limited to 'gn_libs')

diff --git a/gn_libs/monadic_requests.py b/gn_libs/monadic_requests.py
new file mode 100644
index 0000000..0a3c282
--- /dev/null
+++ b/gn_libs/monadic_requests.py
@@ -0,0 +1,64 @@
+"""Wrap requests functions with monads."""
+import logging
+
+import requests
+from requests.models import Response
+from pymonad.either import Left, Right, Either
+
+logger = logging.getLogger(__name__)
+
+# HTML Status codes indicating a successful request.
+SUCCESS_CODES = (200, 201, 202, 203, 204, 205, 206, 207, 208, 226)
+
+
+def get(url, params=None, **kwargs) -> Either:
+    """
+    A wrapper around `requests.get` function.
+
+    Takes the same arguments as `requests.get`.
+
+    :rtype: pymonad.either.Either
+    """
+    try:
+        resp = requests.get(url, params=params, **kwargs)
+        if resp.status_code in SUCCESS_CODES:
+            return Right(resp.json())
+        return Left(resp)
+    except requests.exceptions.RequestException as exc:
+        return Left(exc)
+
+
+def post(url, data=None, json=None, **kwargs) -> Either:
+    """
+    A wrapper around `requests.post` function.
+
+    Takes the same arguments as `requests.post`.
+
+    :rtype: pymonad.either.Either
+    """
+    try:
+        resp = requests.post(url, data=data, json=json, **kwargs)
+        if resp.status_code in SUCCESS_CODES:
+            return Right(resp.json())
+        return Left(resp)
+    except requests.exceptions.RequestException as exc:
+        return Left(exc)
+
+
+def make_either_error_handler(msg):
+    """Make generic error handler for pymonads Either objects."""
+    def __fail__(error):
+        if issubclass(type(error), Exception):
+            logger.debug("\n\n%s (Exception)\n\n", msg, exc_info=True)
+            raise error
+        if issubclass(type(error), Response):
+            try:
+                _data = error.json()
+            except Exception as _exc:
+                raise Exception(error.content) from _exc
+            raise Exception(_data)
+
+        logger.debug("\n\n%s\n\n", msg)
+        raise Exception(error)
+
+    return __fail__
-- 
cgit v1.2.3