Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[3.10] gh-94630: Update sqlite3 docs with positional-only and keyword-only symbols (GH-94631) #94634

Merged
merged 1 commit into from
Jul 6, 2022
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
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