From 617a14826b909db534baa412ac4a2da3ac49b8f4 Mon Sep 17 00:00:00 2001 From: Quaylyn Rimer Date: Thu, 17 Jul 2025 01:14:16 -0600 Subject: [PATCH 1/3] gh-118469: Document sqlite3.Binary in module constants - Remove redundant second paragraph about DB-API 2.0 specification - Change 'bytes objects' to 'bytes-like objects' for accuracy - Add 'This is the current behavior' to clarify implementation status --- Doc/library/sqlite3.rst | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/Doc/library/sqlite3.rst b/Doc/library/sqlite3.rst index a14af6d3d88df2..3617bd0aca9804 100644 --- a/Doc/library/sqlite3.rst +++ b/Doc/library/sqlite3.rst @@ -498,6 +498,16 @@ Module constants The ``named`` DB-API parameter style is also supported. +.. data:: Binary + + A type object used to describe columns containing :abbr:`BLOB (Binary Large OBject)` data. + Implemented as an alias for :class:`memoryview`. + + .. note:: + + Binary data can also be stored and retrieved using bytes-like objects + directly without using :data:`!Binary`. This is the current behavior. + .. data:: sqlite_version Version number of the runtime SQLite library as a :class:`string `. From 1ab40bb7cafb912ae6cae3864a0da91e9b44f29b Mon Sep 17 00:00:00 2001 From: Quaylyn Rimer <31830590+killerdevildog@users.noreply.github.com> Date: Thu, 17 Jul 2025 11:39:01 -0600 Subject: [PATCH 2/3] Update Doc/library/sqlite3.rst Typo Fix Co-authored-by: Peter Bierma --- Doc/library/sqlite3.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Doc/library/sqlite3.rst b/Doc/library/sqlite3.rst index 3617bd0aca9804..ad32fdbdb10072 100644 --- a/Doc/library/sqlite3.rst +++ b/Doc/library/sqlite3.rst @@ -500,7 +500,7 @@ Module constants .. data:: Binary - A type object used to describe columns containing :abbr:`BLOB (Binary Large OBject)` data. + A type object used to describe columns containing :abbr:`BLOB (Binary Large Object)` data. Implemented as an alias for :class:`memoryview`. .. note:: From a9b10b035708e72ad38164a7b4f7a64341f21f3a Mon Sep 17 00:00:00 2001 From: Quaylyn Rimer <31830590+killerdevildog@users.noreply.github.com> Date: Thu, 17 Jul 2025 12:21:38 -0600 Subject: [PATCH 3/3] Update Doc/library/sqlite3.rst Updated "This is " to make a complete sentence. Co-authored-by: Peter Bierma --- Doc/library/sqlite3.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Doc/library/sqlite3.rst b/Doc/library/sqlite3.rst index ad32fdbdb10072..e7609b56d6bf2b 100644 --- a/Doc/library/sqlite3.rst +++ b/Doc/library/sqlite3.rst @@ -501,7 +501,7 @@ Module constants .. data:: Binary A type object used to describe columns containing :abbr:`BLOB (Binary Large Object)` data. - Implemented as an alias for :class:`memoryview`. + This is currently implemented as an alias for :class:`memoryview`. .. note::