From 42534a94981bfdbd0d87c00917eb8b0a40aa0f8a Mon Sep 17 00:00:00 2001 From: Erlend Egeberg Aasland Date: Thu, 7 Jul 2022 01:13:30 +0200 Subject: [PATCH] gh-94630: Update sqlite3 docs with positional-only and keyword-only symbols (GH-94631) (cherry picked from commit 94988603f3c934f95220f09aefffd50c0a5d3367) Co-authored-by: Erlend Egeberg Aasland --- Doc/library/sqlite3.rst | 22 +++++++++++----------- 1 file changed, 11 insertions(+), 11 deletions(-) diff --git a/Doc/library/sqlite3.rst b/Doc/library/sqlite3.rst index 9ebd42b7925bae..49f3536e6c3163 100644 --- a/Doc/library/sqlite3.rst +++ b/Doc/library/sqlite3.rst @@ -322,7 +322,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. @@ -336,7 +336,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. @@ -358,7 +358,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, @@ -498,7 +498,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. @@ -637,7 +637,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, @@ -655,7 +655,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 @@ -866,7 +866,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 `. @@ -882,7 +882,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 ` SQL command against all parameter sequences or mappings found in the sequence @@ -897,7 +897,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, @@ -947,11 +947,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`.