API Reference - Exceptions

instapay_eg.exceptions

Custom exception hierarchy for instapay-eg.

All exceptions inherit from InstaPayError so callers can choose how granular their except clause needs to be:

.. code-block:: python

from instapay_eg import InstaPayError, PhishingLinkError

try:
    data = parse_text(raw_input)
except PhishingLinkError:
    log.warning("Phishing attempt blocked")
except InstaPayError as exc:
    log.error("InstaPay parsing failed: %s", exc)

InstaPayError

Bases: Exception

Base exception for all instapay-eg errors.

Catch this to handle any error raised by this library without caring about the specific failure mode.

Source code in src/instapay_eg/exceptions.py

class InstaPayError(Exception):
    """Base exception for all instapay-eg errors.

    Catch this to handle any error raised by this library without caring
    about the specific failure mode.
    """

LinkNotFoundError

Bases: InstaPayError

Raised when no https://ipn.eg URL is found in the input text.

Source code in src/instapay_eg/exceptions.py

class LinkNotFoundError(InstaPayError):
    """Raised when no ``https://ipn.eg`` URL is found in the input text."""

InvalidLinkError

Bases: InstaPayError

Raised when a URL is found but fails one or more validation checks.

Source code in src/instapay_eg/exceptions.py

class InvalidLinkError(InstaPayError):
    """Raised when a URL is found but fails one or more validation checks."""

PhishingLinkError

Bases: InvalidLinkError

Raised when the URL's domain does not exactly match ipn.eg.

This is a specialisation of InvalidLinkError that signals a likely phishing or lookalike-domain attack. Always log these occurrences.

Source code in src/instapay_eg/exceptions.py

class PhishingLinkError(InvalidLinkError):
    """Raised when the URL's domain does not exactly match ``ipn.eg``.

    This is a specialisation of ``InvalidLinkError`` that signals a likely
    phishing or lookalike-domain attack.  Always log these occurrences.
    """

InvalidHandleError

Bases: InstaPayError

Raised when the InstaPay handle extracted from a link is malformed.

Source code in src/instapay_eg/exceptions.py

class InvalidHandleError(InstaPayError):
    """Raised when the InstaPay handle extracted from a link is malformed."""