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

miss-islington webhook-mailer at python.org
Wed Jul 6 19:22:15 EDT 2022


https://github.com/python/cpython/commit/fa44a760d583ad2d8e049aca1626c35ef5a8149e
commit: fa44a760d583ad2d8e049aca1626c35ef5a8149e
branch: 3.11
author: Miss Islington (bot) <31488909+miss-islington at users.noreply.github.com>
committer: miss-islington <31488909+miss-islington at users.noreply.github.com>
date: 2022-07-06T16:22:10-07:00
summary:

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 <erlend.aasland at protonmail.com>

files:
M Doc/library/sqlite3.rst

diff --git a/Doc/library/sqlite3.rst b/Doc/library/sqlite3.rst
index 9ebd42b7925ba..49f3536e6c316 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 <sqlite3-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 <sqlite3-placeholders>` 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`.
 



More information about the Python-checkins mailing list