gh-94630: Update sqlite3 docs with positional-only and keyword-only symbols (GH-94631)

(cherry picked from commit 94988603f3)

Co-authored-by: Erlend Egeberg Aasland <erlend.aasland@protonmail.com>
This commit is contained in:
Miss Islington (bot) 2022-07-06 16:21:05 -07:00 committed by GitHub
parent 7e3b6affa0
commit 7f45ae859a
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 11 additions and 11 deletions

View File

@ -304,7 +304,7 @@ Module functions and constants
Added the ``sqlite3.connect/handle`` auditing event. 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 Register the *converter* callable to convert SQLite objects of type
*typename* into a Python object of a specific type. *typename* into a Python object of a specific type.
@ -318,7 +318,7 @@ Module functions and constants
case-insensitively. case-insensitively.
.. function:: register_adapter(type, adapter) .. function:: register_adapter(type, adapter, /)
Register an *adapter* callable to adapt the Python type *type* into an Register an *adapter* callable to adapt the Python type *type* into an
SQLite type. SQLite type.
@ -340,7 +340,7 @@ Module functions and constants
.. literalinclude:: ../includes/sqlite3/complete_statement.py .. 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, By default you will not get any tracebacks in user-defined functions,
aggregates, converters, authorizer callbacks etc. If you want to debug them, aggregates, converters, authorizer callbacks etc. If you want to debug them,
@ -445,7 +445,7 @@ Connection Objects
.. literalinclude:: ../includes/sqlite3/md5func.py .. 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. Creates a user-defined aggregate function.
@ -546,7 +546,7 @@ Connection Objects
.. versionadded:: 3.3 .. versionadded:: 3.3
.. method:: enable_load_extension(enabled) .. method:: enable_load_extension(enabled, /)
This routine allows/disallows the SQLite engine to load SQLite extensions This routine allows/disallows the SQLite engine to load SQLite extensions
from shared libraries. SQLite extensions can define new functions, from shared libraries. SQLite extensions can define new functions,
@ -564,7 +564,7 @@ Connection Objects
.. literalinclude:: ../includes/sqlite3/load_extension.py .. 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 This routine loads an SQLite extension from a shared library. You have to
enable extension loading with :meth:`enable_load_extension` before you can enable extension loading with :meth:`enable_load_extension` before you can
@ -703,7 +703,7 @@ Cursor Objects
.. index:: single: ? (question mark); in SQL statements .. index:: single: ? (question mark); in SQL statements
.. index:: single: : (colon); 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 Execute an SQL statement. Values may be bound to the statement using
:ref:`placeholders <sqlite3-placeholders>`. :ref:`placeholders <sqlite3-placeholders>`.
@ -719,7 +719,7 @@ Cursor Objects
a transaction is implicitly opened before executing *sql*. 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 Execute a :ref:`parameterized <sqlite3-placeholders>` SQL command
against all parameter sequences or mappings found in the sequence against all parameter sequences or mappings found in the sequence
@ -734,7 +734,7 @@ Cursor Objects
.. literalinclude:: ../includes/sqlite3/executemany_2.py .. literalinclude:: ../includes/sqlite3/executemany_2.py
.. method:: executescript(sql_script) .. method:: executescript(sql_script, /)
Execute multiple SQL statements at once. Execute multiple SQL statements at once.
If there is a pending transaciton, If there is a pending transaciton,
@ -784,11 +784,11 @@ Cursor Objects
The cursor will be unusable from this point forward; a :exc:`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.
.. method:: setinputsizes(sizes) .. method:: setinputsizes(sizes, /)
Required by the DB-API. Does nothing in :mod:`sqlite3`. 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`. Required by the DB-API. Does nothing in :mod:`sqlite3`.