git.cworth.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         }
  56         return types[status]
  57
  58     def __new__(cls, *args, **kwargs):
  59         """Return the correct subclass based on status."""
  60         # This is simplistic, but the actual __init__ will fail if the
  61         # signature is wrong anyway.
  62         if args:
  63             status = args[0]
  64         else:
  65             status = kwargs.get('status', None)
  66         if status and cls == NotmuchError:
  67             exc = cls.exc_type(status)
  68             return exc.__new__(exc, *args, **kwargs)
  69         else:
  70             return super().__new__(cls)
  71
  72     def __init__(self, status=None, message=None):
  73         self.status = status
  74         self.message = message
  75
  76     def __str__(self):
  77         if self.message:
  78             return self.message
  79         elif self.status:
  80             return capi.lib.notmuch_status_to_string(self.status)
  81         else:
  82             return 'Unknown error'
  83
  84
  85 class OutOfMemoryError(NotmuchError): pass
  86 class ReadOnlyDatabaseError(NotmuchError): pass
  87 class XapianError(NotmuchError): pass
  88 class FileError(NotmuchError): pass
  89 class FileNotEmailError(NotmuchError): pass
  90 class DuplicateMessageIdError(NotmuchError): pass
  91 class NullPointerError(NotmuchError): pass
  92 class TagTooLongError(NotmuchError): pass
  93 class UnbalancedFreezeThawError(NotmuchError): pass
  94 class UnbalancedAtomicError(NotmuchError): pass
  95 class UnsupportedOperationError(NotmuchError): pass
  96 class UpgradeRequiredError(NotmuchError): pass
  97 class PathError(NotmuchError): pass
  98 class IllegalArgumentError(NotmuchError): pass
  99 class NoConfigError(NotmuchError): pass
 100
 101 class ObjectDestroyedError(NotmuchError):
 102     """The object has already been destroyed and it's memory freed.
 103
 104     This occurs when :meth:`destroy` has been called on the object but
 105     you still happen to have access to the object.  This should not
 106     normally occur since you should never call :meth:`destroy` by
 107     hand.
 108     """
 109
 110     def __str__(self):
 111         if self.message:
 112             return self.message
 113         else:
 114             return 'Memory already freed'