Skip to content

Commit

Permalink
gh-94630: Update sqlite3 docs with positional-only and keyword-only s…
Browse files Browse the repository at this point in the history
…ymbols (GH-94631)

(cherry picked from commit 9498860)

Co-authored-by: Erlend Egeberg Aasland <[email protected]>
  • Loading branch information
miss-islington and erlend-aasland authored Jul 6, 2022
1 parent 7e3b6af commit 7f45ae8
Showing 1 changed file with 11 additions and 11 deletions.
22 changes: 11 additions & 11 deletions Doc/library/sqlite3.rst
Original file line number Diff line number Diff line change
Expand Up @@ -304,7 +304,7 @@ Module functions and constants
Added the ``sqlite3.connect/handle`` auditing event.


.. function:: register_converter(typename, converter)
.. function:: register_converter(typename, converter, /)

Register the *converter* callable to convert SQLite objects of type
*typename* into a Python object of a specific type.
Expand All @@ -318,7 +318,7 @@ Module functions and constants
case-insensitively.


.. function:: register_adapter(type, adapter)
.. function:: register_adapter(type, adapter, /)

Register an *adapter* callable to adapt the Python type *type* into an
SQLite type.
Expand All @@ -340,7 +340,7 @@ Module functions and constants
.. literalinclude:: ../includes/sqlite3/complete_statement.py


.. function:: enable_callback_tracebacks(flag)
.. function:: enable_callback_tracebacks(flag, /)

By default you will not get any tracebacks in user-defined functions,
aggregates, converters, authorizer callbacks etc. If you want to debug them,
Expand Down Expand Up @@ -445,7 +445,7 @@ Connection Objects
.. literalinclude:: ../includes/sqlite3/md5func.py


.. method:: create_aggregate(name, n_arg, aggregate_class)
.. method:: create_aggregate(name, /, n_arg, aggregate_class)

Creates a user-defined aggregate function.

Expand Down Expand Up @@ -546,7 +546,7 @@ Connection Objects
.. versionadded:: 3.3


.. method:: enable_load_extension(enabled)
.. method:: enable_load_extension(enabled, /)

This routine allows/disallows the SQLite engine to load SQLite extensions
from shared libraries. SQLite extensions can define new functions,
Expand All @@ -564,7 +564,7 @@ Connection Objects

.. literalinclude:: ../includes/sqlite3/load_extension.py

.. method:: load_extension(path)
.. method:: load_extension(path, /)

This routine loads an SQLite extension from a shared library. You have to
enable extension loading with :meth:`enable_load_extension` before you can
Expand Down Expand Up @@ -703,7 +703,7 @@ Cursor Objects
.. index:: single: ? (question mark); in SQL statements
.. index:: single: : (colon); in SQL statements

.. method:: execute(sql[, parameters])
.. method:: execute(sql, parameters=(), /)

Execute an SQL statement. Values may be bound to the statement using
:ref:`placeholders <sqlite3-placeholders>`.
Expand All @@ -719,7 +719,7 @@ Cursor Objects
a transaction is implicitly opened before executing *sql*.


.. method:: executemany(sql, seq_of_parameters)
.. method:: executemany(sql, seq_of_parameters, /)

Execute a :ref:`parameterized <sqlite3-placeholders>` SQL command
against all parameter sequences or mappings found in the sequence
Expand All @@ -734,7 +734,7 @@ Cursor Objects
.. literalinclude:: ../includes/sqlite3/executemany_2.py


.. method:: executescript(sql_script)
.. method:: executescript(sql_script, /)

Execute multiple SQL statements at once.
If there is a pending transaciton,
Expand Down Expand Up @@ -784,11 +784,11 @@ Cursor Objects
The cursor will be unusable from this point forward; a :exc:`ProgrammingError`
exception will be raised if any operation is attempted with the cursor.

.. method:: setinputsizes(sizes)
.. method:: setinputsizes(sizes, /)

Required by the DB-API. Does nothing in :mod:`sqlite3`.

.. method:: setoutputsize(size [, column])
.. method:: setoutputsize(size, column=None, /)

Required by the DB-API. Does nothing in :mod:`sqlite3`.

Expand Down

0 comments on commit 7f45ae8

Please sign in to comment.