Source code for storm.exceptions

#
# Copyright (c) 2006, 2007 Canonical
#
# Written by Gustavo Niemeyer <gustavo@niemeyer.net>
#
# This file is part of Storm Object Relational Mapper.
#
# Storm is free software; you can redistribute it and/or modify
# it under the terms of the GNU Lesser General Public License as
# published by the Free Software Foundation; either version 2.1 of
# the License, or (at your option) any later version.
#
# Storm is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public License
# along with this program.  If not, see <http://www.gnu.org/licenses/>.
#
from abc import ABCMeta
import types

from storm.compat import add_metaclass


@add_metaclass(ABCMeta)
class StormError(Exception):
    pass

class CompileError(StormError):
    pass


class NoTableError(CompileError):
    pass


class ExprError(StormError):
    pass


class NoneError(StormError):
    pass


class PropertyPathError(StormError):
    pass


class ClassInfoError(StormError):
    pass


class URIError(StormError):
    pass


class ClosedError(StormError):
    pass


class FeatureError(StormError):
    pass


class DatabaseModuleError(StormError):
    pass


class StoreError(StormError):
    pass


class NoStoreError(StormError):
    pass


class WrongStoreError(StoreError):
    pass


class NotFlushedError(StoreError):
    pass


class OrderLoopError(StoreError):
    pass


class NotOneError(StoreError):
    pass


class UnorderedError(StoreError):
    pass


class LostObjectError(StoreError):
    pass


class Error(StormError):
    pass


class Warning(StormError):
    pass


class InterfaceError(Error):
    pass


class DatabaseError(Error):
    pass


class InternalError(DatabaseError):
    pass


class OperationalError(DatabaseError):
    pass


class ProgrammingError(DatabaseError):
    pass


class IntegrityError(DatabaseError):
    pass


class DataError(DatabaseError):
    pass


class NotSupportedError(DatabaseError):
    pass


class DisconnectionError(OperationalError):
    pass


class TimeoutError(StormError):
    """Raised by timeout tracers when remining time is over."""

    def __init__(self, statement, params, message=None):
        self.statement = statement
        self.params = params
        self.message = message

    def __str__(self):
        return ', '.join(
            [repr(element) for element in
             (self.message, self.statement, self.params)
             if element is not None])


class ConnectionBlockedError(StormError):
    """Raised when an attempt is made to use a blocked connection."""


def install_exceptions(module):
    for exception in (Error, Warning, DatabaseError, InternalError,
                      OperationalError, ProgrammingError, IntegrityError,
                      DataError, NotSupportedError, InterfaceError):
        module_exception = getattr(module, exception.__name__, None)
        if (module_exception is not None and
            isinstance(module_exception, type)):
            # XXX This may need to be revisited when porting to Python 3 if
            # virtual subclasses are still ignored for exception handling
            # (https://bugs.python.org/issue12029).
            exception.register(module_exception)