mirror of
https://github.com/python/cpython.git
synced 2025-09-25 17:59:57 +00:00
Issue #6057: Document exceptions in sqlite3 module
Patch by Jaysinh Shukla and Stéphane Wirtel.
This commit is contained in:
parent
48de28290c
commit
ed789f9cf9
2 changed files with 33 additions and 2 deletions
|
@ -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
|
||||||
|
|
||||||
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::
|
||||||
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
|
||||||
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
|
||||||
|
|
Loading…
Add table
Add a link
Reference in a new issue