Source code for aladhan.exceptions

__all__ = (
    "AladhanException",
    "HTTPException",
    "BadRequest",
    "TooManyRequests",
    "InternalServerError",
    "InvalidArgument",
    "InvalidMethod",
    "InvalidTune",
    "InvalidSchool",
    "InvalidMidnightMode",
    "InvalidTimezone",
    "InvalidLatAdjMethod",
    "InvalidAdjustment",
    "InvalidShafaq",
)


class AladhanException(Exception):
    """
    Base exception class for aladhan.py

    Ideally speaking, this could be caught to handle any exceptions
        thrown from this library.

    Attributes
    ----------

        message: str
            Exception's message.
    """

    __slots__ = ("message",)

    def __init__(self, message: str = ""):
        self.message = message
        super().__init__(message)


class HTTPException(AladhanException):
    """Exception that’s thrown when an HTTP request operation fails.

    Attributes
    ----------
        response: dict
            API's response.
        code: int
            Response's code.
    """

    __slots__ = "response", "code"

    def __init__(self, response, message: str = ""):
        self.response = response
        self.code = response.get("code", 0)
        super().__init__(message or response.get("message") or "")

    @classmethod
    def from_res(cls, res):
        return {
            400: BadRequest,
            429: TooManyRequests,
            500: InternalServerError,
        }.get(res.get("code"), cls)(res)


class BadRequest(HTTPException):
    """Exception that’s thrown for when status code 400 occurs."""


class TooManyRequests(HTTPException):
    """Exception that’s thrown for when status code 429 occurs.

    .. note::
        Current API's rate limit is 14 requests/s.

    *New in v1.2.0*"""


class InternalServerError(HTTPException):
    """Exception that’s thrown for when status code 500 occurs."""


class InvalidArgument(AladhanException, ValueError):
    """Exception that’s thrown when an argument to a function is invalid
    some way (e.g. wrong value or wrong type)."""


class InvalidMethod(InvalidArgument):
    """Exception that’s thrown when method argument is invalid."""


class InvalidTune(InvalidArgument):
    """Exception that’s thrown when tune argument is invalid."""


class InvalidSchool(InvalidArgument):
    """Exception that’s thrown when school argument is invalid."""


class InvalidMidnightMode(InvalidArgument):
    """Exception that’s thrown when midnight mode argument is invalid."""


class InvalidTimezone(InvalidArgument):
    """Exception that’s thrown when timezone argument is invalid."""


class InvalidLatAdjMethod(InvalidArgument):
    """Exception that’s thrown when latitude adjustment method argument
    is invalid."""


class InvalidAdjustment(InvalidArgument):
    """Exception that’s thrown when adjustment argument is invalid."""


class InvalidShafaq(InvalidArgument):
    """Exception that’s thrown when shafaq argument is invalid."""