git.notmuchmail.org Git - notmuch/blob - bindings/python-cffi/notmuch2/_errors.py

   1 from notmuch2 import _capi as capi
   2
   3
   4 class NotmuchError(Exception):
   5     """Base exception for errors originating from the notmuch library.
   6
   7     Usually this will have two attributes:
   8
   9     :status: This is a numeric status code corresponding to the error
  10        code in the notmuch library.  This is normally fairly
  11        meaningless, it can also often be ``None``.  This exists mostly
  12        to easily create new errors from notmuch status codes and
  13        should not normally be used by users.
  14
  15     :message: A user-facing message for the error.  This can
  16        occasionally also be ``None``.  Usually you'll want to call
  17        ``str()`` on the error object instead to get a sensible
  18        message.
  19     """
  20
  21     @classmethod
  22     def exc_type(cls, status):
  23         """Return correct exception type for notmuch status."""
  24         types = {
  25             capi.lib.NOTMUCH_STATUS_OUT_OF_MEMORY:
  26                 OutOfMemoryError,
  27             capi.lib.NOTMUCH_STATUS_READ_ONLY_DATABASE:
  28                 ReadOnlyDatabaseError,
  29             capi.lib.NOTMUCH_STATUS_XAPIAN_EXCEPTION:
  30                 XapianError,
  31             capi.lib.NOTMUCH_STATUS_FILE_ERROR:
  32                 FileError,
  33             capi.lib.NOTMUCH_STATUS_FILE_NOT_EMAIL:
  34                 FileNotEmailError,
  35             capi.lib.NOTMUCH_STATUS_DUPLICATE_MESSAGE_ID:
  36                 DuplicateMessageIdError,
  37             capi.lib.NOTMUCH_STATUS_NULL_POINTER:
  38                 NullPointerError,
  39             capi.lib.NOTMUCH_STATUS_TAG_TOO_LONG:
  40                 TagTooLongError,
  41             capi.lib.NOTMUCH_STATUS_UNBALANCED_FREEZE_THAW:
  42                 UnbalancedFreezeThawError,
  43             capi.lib.NOTMUCH_STATUS_UNBALANCED_ATOMIC:
  44                 UnbalancedAtomicError,
  45             capi.lib.NOTMUCH_STATUS_UNSUPPORTED_OPERATION:
  46                 UnsupportedOperationError,
  47             capi.lib.NOTMUCH_STATUS_UPGRADE_REQUIRED:
  48                 UpgradeRequiredError,
  49             capi.lib.NOTMUCH_STATUS_PATH_ERROR:
  50                 PathError,
  51             capi.lib.NOTMUCH_STATUS_ILLEGAL_ARGUMENT:
  52                 IllegalArgumentError,
  53             capi.lib.NOTMUCH_STATUS_NO_CONFIG:
  54                 NoConfigError,
  55             capi.lib.NOTMUCH_STATUS_DATABASE_EXISTS:
  56                 DatabaseExistsError,
  57         }
  58         return types[status]
  59
  60     def __new__(cls, *args, **kwargs):
  61         """Return the correct subclass based on status."""
  62         # This is simplistic, but the actual __init__ will fail if the
  63         # signature is wrong anyway.
  64         if args:
  65             status = args[0]
  66         else:
  67             status = kwargs.get('status', None)
  68         if status and cls == NotmuchError:
  69             exc = cls.exc_type(status)
  70             return exc.__new__(exc, *args, **kwargs)
  71         else:
  72             return super().__new__(cls)
  73
  74     def __init__(self, status=None, message=None):
  75         self.status = status
  76         self.message = message
  77
  78     def __str__(self):
  79         if self.message:
  80             return self.message
  81         elif self.status:
  82             return capi.lib.notmuch_status_to_string(self.status)
  83         else:
  84             return 'Unknown error'
  85
  86
  87 class OutOfMemoryError(NotmuchError): pass
  88 class ReadOnlyDatabaseError(NotmuchError): pass
  89 class XapianError(NotmuchError): pass
  90 class FileError(NotmuchError): pass
  91 class FileNotEmailError(NotmuchError): pass
  92 class DuplicateMessageIdError(NotmuchError): pass
  93 class NullPointerError(NotmuchError): pass
  94 class TagTooLongError(NotmuchError): pass
  95 class UnbalancedFreezeThawError(NotmuchError): pass
  96 class UnbalancedAtomicError(NotmuchError): pass
  97 class UnsupportedOperationError(NotmuchError): pass
  98 class UpgradeRequiredError(NotmuchError): pass
  99 class PathError(NotmuchError): pass
 100 class IllegalArgumentError(NotmuchError): pass
 101 class NoConfigError(NotmuchError): pass
 102 class DatabaseExistsError(NotmuchError): pass
 103
 104 class ObjectDestroyedError(NotmuchError):
 105     """The object has already been destroyed and it's memory freed.
 106
 107     This occurs when :meth:`destroy` has been called on the object but
 108     you still happen to have access to the object.  This should not
 109     normally occur since you should never call :meth:`destroy` by
 110     hand.
 111     """
 112
 113     def __str__(self):
 114         if self.message:
 115             return self.message
 116         else:
 117             return 'Memory already freed'