[Python-checkins] [3.11] Docs: add links to 'callable' term in sqlite3 docs (GH-106072) (#106074)
erlend-aasland
webhook-mailer at python.org
Sun Jun 25 04:16:34 EDT 2023
https://github.com/python/cpython/commit/1bbf60dc311443dfc7cd3c587745db0768bfe5dc
commit: 1bbf60dc311443dfc7cd3c587745db0768bfe5dc
branch: 3.11
author: Miss Islington (bot) <31488909+miss-islington at users.noreply.github.com>
committer: erlend-aasland <erlend.aasland at protonmail.com>
date: 2023-06-25T10:16:30+02:00
summary:
[3.11] Docs: add links to 'callable' term in sqlite3 docs (GH-106072) (#106074)
(cherry picked from commit bef1c8761e3b0dfc5708747bb646ad8b669cbd67)
Co-authored-by: Erlend E. Aasland <erlend at python.org>
files:
M Doc/library/sqlite3.rst
diff --git a/Doc/library/sqlite3.rst b/Doc/library/sqlite3.rst
index 249d29ce8993..c99c01b0e5c7 100644
--- a/Doc/library/sqlite3.rst
+++ b/Doc/library/sqlite3.rst
@@ -394,15 +394,15 @@ Module functions
.. function:: register_adapter(type, adapter, /)
- Register an *adapter* callable to adapt the Python type *type* into an
- SQLite type.
+ Register an *adapter* :term:`callable` to adapt the Python type *type*
+ into an SQLite type.
The adapter is called with a Python object of type *type* as its sole
argument, and must return a value of a
:ref:`type that SQLite natively understands <sqlite3-types>`.
.. function:: register_converter(typename, converter, /)
- Register the *converter* callable to convert SQLite objects of type
+ Register the *converter* :term:`callable` to convert SQLite objects of type
*typename* into a Python object of a specific type.
The converter is invoked for all SQLite values of type *typename*;
it is passed a :class:`bytes` object and should return an object of the
@@ -459,7 +459,7 @@ Module constants
SQLITE_DENY
SQLITE_IGNORE
- Flags that should be returned by the *authorizer_callback* callable
+ Flags that should be returned by the *authorizer_callback* :term:`callable`
passed to :meth:`Connection.set_authorizer`, to indicate whether:
* Access is allowed (:const:`!SQLITE_OK`),
@@ -562,8 +562,8 @@ Connection objects
Create and return a :class:`Cursor` object.
The cursor method accepts a single optional parameter *factory*. If
- supplied, this must be a callable returning an instance of :class:`Cursor`
- or its subclasses.
+ supplied, this must be a :term:`callable` returning
+ an instance of :class:`Cursor` or its subclasses.
.. method:: blobopen(table, column, row, /, *, readonly=False, name="main")
@@ -647,7 +647,7 @@ Connection objects
If ``-1``, it may take any number of arguments.
:param func:
- A callable that is called when the SQL function is invoked.
+ A :term:`callable` that is called when the SQL function is invoked.
The callable must return :ref:`a type natively supported by SQLite
<sqlite3-types>`.
Set to ``None`` to remove an existing SQL function.
@@ -872,9 +872,10 @@ Connection objects
.. method:: set_authorizer(authorizer_callback)
- Register callable *authorizer_callback* to be invoked for each attempt to
- access a column of a table in the database. The callback should return
- one of :const:`SQLITE_OK`, :const:`SQLITE_DENY`, or :const:`SQLITE_IGNORE`
+ Register :term:`callable` *authorizer_callback* to be invoked
+ for each attempt to access a column of a table in the database.
+ The callback should return one of :const:`SQLITE_OK`,
+ :const:`SQLITE_DENY`, or :const:`SQLITE_IGNORE`
to signal how access to the column should be handled
by the underlying SQLite library.
@@ -897,7 +898,7 @@ Connection objects
.. method:: set_progress_handler(progress_handler, n)
- Register callable *progress_handler* to be invoked for every *n*
+ Register :term:`callable` *progress_handler* to be invoked for every *n*
instructions of the SQLite virtual machine. This is useful if you want to
get called from SQLite during long-running operations, for example to update
a GUI.
@@ -912,8 +913,8 @@ Connection objects
.. method:: set_trace_callback(trace_callback)
- Register callable *trace_callback* to be invoked for each SQL statement
- that is actually executed by the SQLite backend.
+ Register :term:`callable` *trace_callback* to be invoked
+ for each SQL statement that is actually executed by the SQLite backend.
The only argument passed to the callback is the statement (as
:class:`str`) that is being executed. The return value of the callback is
@@ -1045,8 +1046,8 @@ Connection objects
Defaults to ``-1``.
:param progress:
- If set to a callable, it is invoked with three integer arguments for
- every backup iteration:
+ If set to a :term:`callable`,
+ it is invoked with three integer arguments for every backup iteration:
the *status* of the last iteration,
the *remaining* number of pages still to be copied,
and the *total* number of pages.
@@ -1247,8 +1248,8 @@ Connection objects
.. attribute:: text_factory
- A callable that accepts a :class:`bytes` parameter and returns a text
- representation of it.
+ A :term:`callable` that accepts a :class:`bytes` parameter
+ and returns a text representation of it.
The callable is invoked for SQLite values with the ``TEXT`` data type.
By default, this attribute is set to :class:`str`.
If you want to return ``bytes`` instead, set *text_factory* to ``bytes``.
More information about the Python-checkins
mailing list