Commit 5c90d085 authored by Berker Peksag's avatar Berker Peksag

Issue #6057: Document exceptions in sqlite3 module

Patch by Jaysinh Shukla and Stéphane Wirtel.
parent 08024465
...@@ -542,7 +542,7 @@ Cursor Objects ...@@ -542,7 +542,7 @@ Cursor Objects
.. literalinclude:: ../includes/sqlite3/execute_1.py .. literalinclude:: ../includes/sqlite3/execute_1.py
:meth:`execute` will only execute a single SQL statement. If you try to execute :meth:`execute` will only execute a single SQL statement. If you try to execute
more than one statement with it, it will raise an ``sqlite3.Warning``. Use more than one statement with it, it will raise an :exc:`.Warning`. Use
:meth:`executescript` if you want to execute multiple SQL statements with one :meth:`executescript` if you want to execute multiple SQL statements with one
call. call.
...@@ -605,7 +605,7 @@ Cursor Objects ...@@ -605,7 +605,7 @@ Cursor Objects
Close the cursor now (rather than whenever ``__del__`` is called). Close the cursor now (rather than whenever ``__del__`` is called).
The cursor will be unusable from this point forward; a ``ProgrammingError`` The cursor will be unusable from this point forward; a :exc:`ProgrammingError`
exception will be raised if any operation is attempted with the cursor. exception will be raised if any operation is attempted with the cursor.
.. attribute:: rowcount .. attribute:: rowcount
...@@ -719,6 +719,36 @@ Now we plug :class:`Row` in:: ...@@ -719,6 +719,36 @@ Now we plug :class:`Row` in::
35.14 35.14
.. _sqlite3-exceptions:
Exceptions
----------
.. exception:: Warning
A subclass of :exc:`Exception`.
.. exception:: Error
The base class of the other exceptions in this module. It is a subclass
of :exc:`Exception`.
.. exception:: DatabaseError
Exception raised for errors that are related to the database.
.. exception:: IntegrityError
Exception raised when the relational integrity of the database is affected,
e.g. a foreign key check fails. It is a subclass of :exc:`DatabaseError`.
.. exception:: ProgrammingError
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. It is a subclass of :exc:`DatabaseError`.
.. _sqlite3-types: .. _sqlite3-types:
SQLite and Python types SQLite and Python types
......
...@@ -1360,6 +1360,7 @@ Shiyao Ma ...@@ -1360,6 +1360,7 @@ Shiyao Ma
Alex Shkop Alex Shkop
Joel Shprentz Joel Shprentz
Yue Shuaijie Yue Shuaijie
Jaysinh Shukla
Terrel Shumway Terrel Shumway
Eric Siegerman Eric Siegerman
Paul Sijben Paul Sijben
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment