# -*- coding: UTF-8 -*-
"""defines the exception classes for db api 2.0
"""
# $Id: dbapi20error.py,v 1.1 2003/10/02 16:37:36 moellenbeck Exp $
from exceptions import StandardError
class Warning(StandardError):
"""Exception raised for important warnings like data
truncations while inserting, etc.
"""
class Error(StandardError):
"""Exception that is the base class of all other error
exceptions. You can use this to catch all errors with one
single 'except' statement. Warnings are not considered
errors and thus should not use this class as base.
"""
class InterfaceError(Error):
"""Exception raised for errors that are related to the
database interface rather than the database itself.
"""
class DatabaseError(Error):
"""Exception raised for errors that are related to the
database.
"""
class DataError(DatabaseError):
"""Exception raised for errors that are due to problems with
the processed data like division by zero, numeric value
out of range, etc.
"""
class OperationalError(DatabaseError):
"""Exception raised for errors that are related to the
database's operation and not necessarily under the control
of the programmer, e.g. an unexpected disconnect occurs,
the data source name is not found, a transaction could not
be processed, a memory allocation error occurred during
processing, etc.
"""
class IntegrityError(DatabaseError):
"""Exception raised when the relational integrity of the
database is affected, e.g. a foreign key check fails.
"""
class InternalError(DatabaseError):
"""Exception raised when the database encounters an internal
error, e.g. the cursor is not valid anymore, the
transaction is out of sync, etc
"""
class ProgrammingError(DatabaseError):
"""Exception raised for programming errors, e.g. table not
found or already exists, syntax error in the SQL
statement, wrong number of parameters specified, etc.
"""
class NotSupportedError(DatabaseError):
"""Exception raised in case a method or database API was used
which is not supported by the database, e.g. requesting a
.rollback() on a connection that does not support
transaction or has transactions turned off.
"""
|