From f5a784729cb7a75630f569ec522e3b9435718a76 Mon Sep 17 00:00:00 2001
From: "Miss Islington (bot)"
<31488909+miss-islington@users.noreply.github.com>
Date: Sun, 4 Sep 2022 14:41:13 -0700
Subject: [PATCH] Docs: alphabetically order sqlite3.Cursor attrs (GH-96565)
(cherry picked from commit 9e5568578234f0ecd003247c8a2deaeb69976b4b)
Co-authored-by: Erlend E. Aasland <erlend.aasland@protonmail.com>
---
Doc/library/sqlite3.rst | 61 +++++++++++++++++++++--------------------
1 file changed, 31 insertions(+), 30 deletions(-)
diff --git a/Doc/library/sqlite3.rst b/Doc/library/sqlite3.rst
index 5a467d340da..cf78bd25b7a 100644
--- a/Doc/library/sqlite3.rst
+++ b/Doc/library/sqlite3.rst
@@ -1165,13 +1165,32 @@ Cursor objects
Required by the DB-API. Does nothing in :mod:`!sqlite3`.
- .. attribute:: rowcount
+ .. attribute:: arraysize
- Read-only attribute that provides the number of modified rows for
- ``INSERT``, ``UPDATE``, ``DELETE``, and ``REPLACE`` statements;
- is ``-1`` for other statements,
- including :abbr:`CTE (Common Table Expression)` queries.
- It is only updated by the :meth:`execute` and :meth:`executemany` methods.
+ Read/write attribute that controls the number of rows returned by :meth:`fetchmany`.
+ The default value is 1 which means a single row would be fetched per call.
+
+ .. attribute:: connection
+
+ Read-only attribute that provides the SQLite database :class:`Connection`
+ belonging to the cursor. A :class:`Cursor` object created by
+ calling :meth:`con.cursor() <Connection.cursor>` will have a
+ :attr:`connection` attribute that refers to *con*:
+
+ .. doctest::
+
+ >>> con = sqlite3.connect(":memory:")
+ >>> cur = con.cursor()
+ >>> cur.connection == con
+ True
+
+ .. attribute:: description
+
+ Read-only attribute that provides the column names of the last query. To
+ remain compatible with the Python DB API, it returns a 7-tuple for each
+ column where the last six items of each tuple are ``None``.
+
+ It is set for ``SELECT`` statements without any matching rows as well.
.. attribute:: lastrowid
@@ -1188,32 +1207,14 @@ Cursor objects
.. versionchanged:: 3.6
Added support for the ``REPLACE`` statement.
- .. attribute:: arraysize
-
- Read/write attribute that controls the number of rows returned by :meth:`fetchmany`.
- The default value is 1 which means a single row would be fetched per call.
-
- .. attribute:: description
-
- Read-only attribute that provides the column names of the last query. To
- remain compatible with the Python DB API, it returns a 7-tuple for each
- column where the last six items of each tuple are ``None``.
-
- It is set for ``SELECT`` statements without any matching rows as well.
-
- .. attribute:: connection
-
- Read-only attribute that provides the SQLite database :class:`Connection`
- belonging to the cursor. A :class:`Cursor` object created by
- calling :meth:`con.cursor() <Connection.cursor>` will have a
- :attr:`connection` attribute that refers to *con*:
+ .. attribute:: rowcount
- .. doctest::
+ Read-only attribute that provides the number of modified rows for
+ ``INSERT``, ``UPDATE``, ``DELETE``, and ``REPLACE`` statements;
+ is ``-1`` for other statements,
+ including :abbr:`CTE (Common Table Expression)` queries.
+ It is only updated by the :meth:`execute` and :meth:`executemany` methods.
- >>> con = sqlite3.connect(":memory:")
- >>> cur = con.cursor()
- >>> cur.connection == con
- True
.. The sqlite3.Row example used to be a how-to. It has now been incorporated
into the Row reference. We keep the anchor here in order not to break
--
GitLab