1berry/cpython
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

gh-118928: Amend sqlite3 execute*() deprecation notes (#135163)

Browse Source
This commit is contained in:
Erlend E. Aasland 2025-06-10 13:24:33 +02:00 committed by GitHub
parent c23eec2960
commit ee7345d507
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 11 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
Doc/library/sqlite3.rst
View File

@ -1482,7 +1482,9 @@ Cursor objects
:type parameters: :class:`dict` | :term:`sequence`
:raises ProgrammingError:
If *sql* contains more than one SQL statement.
When *sql* contains more than one SQL statement.
When :ref:`named placeholders <sqlite3-placeholders>` are used
and *parameters* is a sequence instead of a :class:`dict`.
If :attr:`~Connection.autocommit` is
:data:`LEGACY_TRANSACTION_CONTROL`,
@ -1491,13 +1493,11 @@ Cursor objects
and there is no open transaction,
a transaction is implicitly opened before executing *sql*.
.. deprecated-removed:: 3.12 3.14
.. versionchanged:: 3.14
:exc:`DeprecationWarning` is emitted if
:exc:`ProgrammingError` is emitted if
:ref:`named placeholders <sqlite3-placeholders>` are used
and *parameters* is a sequence instead of a :class:`dict`.
Starting with Python 3.14, :exc:`ProgrammingError` will
be raised instead.
Use :meth:`executescript` to execute multiple SQL statements.
@ -1519,8 +1519,10 @@ Cursor objects
:type parameters: :term:`iterable`
:raises ProgrammingError:
If *sql* contains more than one SQL statement,
or is not a DML statement.
When *sql* contains more than one SQL statement
or is not a DML statement,
When :ref:`named placeholders <sqlite3-placeholders>` are used
and the items in *parameters* are sequences instead of :class:`dict`\s.
Example:
@ -1544,14 +1546,12 @@ Cursor objects
.. _RETURNING clauses: https://www.sqlite.org/lang_returning.html
.. deprecated-removed:: 3.12 3.14
.. versionchanged:: 3.14
:exc:`DeprecationWarning` is emitted if
:exc:`ProgrammingError` is emitted if
:ref:`named placeholders <sqlite3-placeholders>` are used
and the items in *parameters* are sequences
instead of :class:`dict`\s.
Starting with Python 3.14, :exc:`ProgrammingError` will
be raised instead.
.. method:: executescript(sql_script, /)