aboutsummaryrefslogtreecommitdiff
"""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
    """
    timeout = kwargs.get("timeout")
    kwargs = {key: val for key,val in kwargs.items() if key != "timeout"}
    if timeout is None:
        timeout = (9.13, 20)

    try:
        resp = requests.get(url, params=params, timeout=timeout, **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
    """
    timeout = kwargs.get("timeout")
    kwargs = {key: val for key,val in kwargs.items() if key != "timeout"}
    if timeout is None:
        timeout = (9.13, 20)

    try:
        resp = requests.post(url, data=data, json=json, timeout=timeout, **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# pylint: disable=[broad-exception-raised]
            raise Exception(_data)# pylint: disable=[broad-exception-raised]

        logger.debug("\n\n%s\n\n", msg)
        raise Exception(error)# pylint: disable=[broad-exception-raised]

    return __fail__