psycopg/psycopg2
1
1
Fork 0
mirror of https://github.com/psycopg/psycopg2.git synced 2024-11-28 20:03:43 +03:00
Code Issues Packages Projects Releases Wiki Activity

Fixed doc example about Error attributes

Browse Source 
Catch the Error, not everything!

Also, whitespaces.
This commit is contained in:
Daniele Varrazzo 2014-08-24 14:57:26 +01:00
parent cafae16072
commit 3775a9d95d
1 changed files with 22 additions and 21 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

43
doc/src/module.rst
View File

@ -111,7 +111,7 @@ The module interface respects the standard defined in the |DBAPI|_.
.. index:: .. index::
single: Exceptions; DB API single: Exceptions; DB API
.. _dbapi-exceptions: .. _dbapi-exceptions:
@ -122,12 +122,12 @@ Exceptions
In compliance with the |DBAPI|_, the module makes informations about errors In compliance with the |DBAPI|_, the module makes informations about errors
available through the following exceptions: available through the following exceptions:
.. exception:: Warning .. exception:: Warning
Exception raised for important warnings like data truncations while Exception raised for important warnings like data truncations while
inserting, etc. It is a subclass of the Python `~exceptions.StandardError`. inserting, etc. It is a subclass of the Python `~exceptions.StandardError`.
.. exception:: Error .. exception:: Error
Exception that is the base class of all other error exceptions. You can 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 use this to catch all errors with one single `!except` statement. Warnings
@ -150,7 +150,7 @@ available through the following exceptions:
>>> try: >>> try:
... cur.execute("SELECT * FROM barf") ... cur.execute("SELECT * FROM barf")
... except Exception, e: ... except psycopg2.Error as e:
... pass ... pass
>>> e.pgcode >>> e.pgcode
@ -159,6 +159,7 @@ available through the following exceptions:
ERROR: relation "barf" does not exist ERROR: relation "barf" does not exist
LINE 1: SELECT * FROM barf LINE 1: SELECT * FROM barf
^ ^
.. attribute:: cursor .. attribute:: cursor
The cursor the exception was raised from; `None` if not applicable. The cursor the exception was raised from; `None` if not applicable.
@ -170,7 +171,7 @@ available through the following exceptions:
>>> try: >>> try:
... cur.execute("SELECT * FROM barf") ... cur.execute("SELECT * FROM barf")
... except Exception, e: ... except psycopg2.Error, e:
... pass ... pass
>>> e.diag.severity >>> e.diag.severity
@ -195,41 +196,41 @@ available through the following exceptions:
Exception raised for errors that are related to the database. It is a Exception raised for errors that are related to the database. It is a
subclass of `Error`. subclass of `Error`.
.. exception:: DataError .. exception:: DataError
Exception raised for errors that are due to problems with the processed Exception raised for errors that are due to problems with the processed
data like division by zero, numeric value out of range, etc. It is a data like division by zero, numeric value out of range, etc. It is a
subclass of `DatabaseError`. subclass of `DatabaseError`.
.. exception:: OperationalError .. exception:: OperationalError
Exception raised for errors that are related to the database's operation Exception raised for errors that are related to the database's operation
and not necessarily under the control of the programmer, e.g. an and not necessarily under the control of the programmer, e.g. an
unexpected disconnect occurs, the data source name is not found, a unexpected disconnect occurs, the data source name is not found, a
transaction could not be processed, a memory allocation error occurred transaction could not be processed, a memory allocation error occurred
during processing, etc. It is a subclass of `DatabaseError`. during processing, etc. It is a subclass of `DatabaseError`.
.. exception:: IntegrityError .. exception:: IntegrityError
Exception raised when the relational integrity of the database is Exception raised when the relational integrity of the database is
affected, e.g. a foreign key check fails. It is a subclass of affected, e.g. a foreign key check fails. It is a subclass of
`DatabaseError`. `DatabaseError`.
.. exception:: InternalError .. exception:: InternalError
Exception raised when the database encounters an internal error, e.g. the Exception raised when the database encounters an internal error, e.g. the
cursor is not valid anymore, the transaction is out of sync, etc. It is a cursor is not valid anymore, the transaction is out of sync, etc. It is a
subclass of `DatabaseError`. subclass of `DatabaseError`.
.. exception:: ProgrammingError .. exception:: ProgrammingError
Exception raised for programming errors, e.g. table not found or already Exception raised for programming errors, e.g. table not found or already
exists, syntax error in the SQL statement, wrong number of parameters exists, syntax error in the SQL statement, wrong number of parameters
specified, etc. It is a subclass of `DatabaseError`. specified, etc. It is a subclass of `DatabaseError`.
.. exception:: NotSupportedError .. exception:: NotSupportedError
Exception raised in case a method or database API was used which is not 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 supported by the database, e.g. requesting a `!rollback()` on a
connection that does not support transaction or has transactions turned connection that does not support transaction or has transactions turned