[3.13] gh-138736: Fix sqlite3.Connection.blobopen 'row' parameter type and naming (#138738) (#139063)

The 'row' parameter represents a ROWID. Clarify this in docs and docstrings.

(cherry picked from commit 8eb106240f)

Co-authored-by: chiri <chirizxc@proton.me>
This commit is contained in:
Erlend E. Aasland 2025-09-17 17:26:10 +01:00 committed by GitHub
parent 3db6d82a4d
commit 5f84c1d192
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
3 changed files with 10 additions and 10 deletions

View file

@ -632,7 +632,7 @@ Connection objects
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")
.. method:: blobopen(table, column, rowid, /, *, readonly=False, name="main")
Open a :class:`Blob` handle to an existing
:abbr:`BLOB (Binary Large OBject)`.
@ -643,8 +643,8 @@ Connection objects
:param str column:
The name of the column where the blob is located.
:param str row:
The name of the row where the blob is located.
:param int rowid:
The row id where the blob is located.
:param bool readonly:
Set to ``True`` if the blob should be opened without write

View file

@ -229,7 +229,7 @@ exit:
}
PyDoc_STRVAR(blobopen__doc__,
"blobopen($self, table, column, row, /, *, readonly=False, name=\'main\')\n"
"blobopen($self, table, column, rowid, /, *, readonly=False, name=\'main\')\n"
"--\n"
"\n"
"Open and return a BLOB object.\n"
@ -238,8 +238,8 @@ PyDoc_STRVAR(blobopen__doc__,
" Table name.\n"
" column\n"
" Column name.\n"
" row\n"
" Row index.\n"
" rowid\n"
" Row id.\n"
" readonly\n"
" Open the BLOB without write permissions.\n"
" name\n"
@ -1866,4 +1866,4 @@ exit:
#ifndef DESERIALIZE_METHODDEF
#define DESERIALIZE_METHODDEF
#endif /* !defined(DESERIALIZE_METHODDEF) */
/*[clinic end generated code: output=5d4d7e4abe17b164 input=a9049054013a1b77]*/
/*[clinic end generated code: output=fa34f4c5f8837a7c input=a9049054013a1b77]*/

View file

@ -573,8 +573,8 @@ _sqlite3.Connection.blobopen as blobopen
Table name.
column as col: str
Column name.
row: sqlite3_int64
Row index.
rowid as row: sqlite3_int64
Row id.
/
*
readonly: bool = False
@ -588,7 +588,7 @@ Open and return a BLOB object.
static PyObject *
blobopen_impl(pysqlite_Connection *self, const char *table, const char *col,
sqlite3_int64 row, int readonly, const char *name)
/*[clinic end generated code: output=6a02d43efb885d1c input=23576bd1108d8774]*/
/*[clinic end generated code: output=6a02d43efb885d1c input=cc3d4b47dac08401]*/
{
if (!pysqlite_check_thread(self) || !pysqlite_check_connection(self)) {
return NULL;