LCOV - code coverage report
Current view: top level - Modules/_sqlite - cursor.c (source / functions) Hit Total Coverage
Test: CPython 3.12 LCOV report [commit 5e6661bce9] Lines: 6 634 0.9 %
Date: 2023-03-20 08:15:36 Functions: 1 30 3.3 %
Branches: 1 458 0.2 %

           Branch data     Line data    Source code
       1                 :            : /* cursor.c - the cursor type
       2                 :            :  *
       3                 :            :  * Copyright (C) 2004-2010 Gerhard Häring <gh@ghaering.de>
       4                 :            :  *
       5                 :            :  * This file is part of pysqlite.
       6                 :            :  *
       7                 :            :  * This software is provided 'as-is', without any express or implied
       8                 :            :  * warranty.  In no event will the authors be held liable for any damages
       9                 :            :  * arising from the use of this software.
      10                 :            :  *
      11                 :            :  * Permission is granted to anyone to use this software for any purpose,
      12                 :            :  * including commercial applications, and to alter it and redistribute it
      13                 :            :  * freely, subject to the following restrictions:
      14                 :            :  *
      15                 :            :  * 1. The origin of this software must not be misrepresented; you must not
      16                 :            :  *    claim that you wrote the original software. If you use this software
      17                 :            :  *    in a product, an acknowledgment in the product documentation would be
      18                 :            :  *    appreciated but is not required.
      19                 :            :  * 2. Altered source versions must be plainly marked as such, and must not be
      20                 :            :  *    misrepresented as being the original software.
      21                 :            :  * 3. This notice may not be removed or altered from any source distribution.
      22                 :            :  */
      23                 :            : 
      24                 :            : #include "cursor.h"
      25                 :            : #include "microprotocols.h"
      26                 :            : #include "module.h"
      27                 :            : #include "util.h"
      28                 :            : 
      29                 :            : typedef enum {
      30                 :            :     TYPE_LONG,
      31                 :            :     TYPE_FLOAT,
      32                 :            :     TYPE_UNICODE,
      33                 :            :     TYPE_BUFFER,
      34                 :            :     TYPE_UNKNOWN
      35                 :            : } parameter_type;
      36                 :            : 
      37                 :            : #define clinic_state() (pysqlite_get_state_by_type(Py_TYPE(self)))
      38                 :            : #include "clinic/cursor.c.h"
      39                 :            : #undef clinic_state
      40                 :            : 
      41                 :            : static inline int
      42                 :          0 : check_cursor_locked(pysqlite_Cursor *cur)
      43                 :            : {
      44         [ #  # ]:          0 :     if (cur->locked) {
      45                 :          0 :         PyErr_SetString(cur->connection->ProgrammingError,
      46                 :            :                         "Recursive use of cursors not allowed.");
      47                 :          0 :         return 0;
      48                 :            :     }
      49                 :          0 :     return 1;
      50                 :            : }
      51                 :            : 
      52                 :            : /*[clinic input]
      53                 :            : module _sqlite3
      54                 :            : class _sqlite3.Cursor "pysqlite_Cursor *" "clinic_state()->CursorType"
      55                 :            : [clinic start generated code]*/
      56                 :            : /*[clinic end generated code: output=da39a3ee5e6b4b0d input=3c5b8115c5cf30f1]*/
      57                 :            : 
      58                 :            : /*
      59                 :            :  * Registers a cursor with the connection.
      60                 :            :  *
      61                 :            :  * 0 => error; 1 => ok
      62                 :            :  */
      63                 :            : static int
      64                 :          0 : register_cursor(pysqlite_Connection *connection, PyObject *cursor)
      65                 :            : {
      66                 :          0 :     PyObject *weakref = PyWeakref_NewRef((PyObject *)cursor, NULL);
      67         [ #  # ]:          0 :     if (weakref == NULL) {
      68                 :          0 :         return 0;
      69                 :            :     }
      70                 :            : 
      71         [ #  # ]:          0 :     if (PyList_Append(connection->cursors, weakref) < 0) {
      72         [ #  # ]:          0 :         Py_CLEAR(weakref);
      73                 :          0 :         return 0;
      74                 :            :     }
      75                 :            : 
      76                 :          0 :     Py_DECREF(weakref);
      77                 :          0 :     return 1;
      78                 :            : }
      79                 :            : 
      80                 :            : /*[clinic input]
      81                 :            : _sqlite3.Cursor.__init__ as pysqlite_cursor_init
      82                 :            : 
      83                 :            :     connection: object(type='pysqlite_Connection *', subclass_of='clinic_state()->ConnectionType')
      84                 :            :     /
      85                 :            : 
      86                 :            : [clinic start generated code]*/
      87                 :            : 
      88                 :            : static int
      89                 :          0 : pysqlite_cursor_init_impl(pysqlite_Cursor *self,
      90                 :            :                           pysqlite_Connection *connection)
      91                 :            : /*[clinic end generated code: output=ac59dce49a809ca8 input=23d4265b534989fb]*/
      92                 :            : {
      93         [ #  # ]:          0 :     if (!check_cursor_locked(self)) {
      94                 :          0 :         return -1;
      95                 :            :     }
      96                 :            : 
      97                 :          0 :     Py_INCREF(connection);
      98                 :          0 :     Py_XSETREF(self->connection, connection);
      99         [ #  # ]:          0 :     Py_CLEAR(self->statement);
     100         [ #  # ]:          0 :     Py_CLEAR(self->row_cast_map);
     101                 :            : 
     102                 :          0 :     Py_INCREF(Py_None);
     103                 :          0 :     Py_XSETREF(self->description, Py_None);
     104                 :            : 
     105                 :          0 :     Py_INCREF(Py_None);
     106                 :          0 :     Py_XSETREF(self->lastrowid, Py_None);
     107                 :            : 
     108                 :          0 :     self->arraysize = 1;
     109                 :          0 :     self->closed = 0;
     110                 :          0 :     self->rowcount = -1L;
     111                 :            : 
     112                 :          0 :     Py_INCREF(Py_None);
     113                 :          0 :     Py_XSETREF(self->row_factory, Py_None);
     114                 :            : 
     115         [ #  # ]:          0 :     if (!pysqlite_check_thread(self->connection)) {
     116                 :          0 :         return -1;
     117                 :            :     }
     118                 :            : 
     119         [ #  # ]:          0 :     if (!register_cursor(connection, (PyObject *)self)) {
     120                 :          0 :         return -1;
     121                 :            :     }
     122                 :            : 
     123                 :          0 :     self->initialized = 1;
     124                 :            : 
     125                 :          0 :     return 0;
     126                 :            : }
     127                 :            : 
     128                 :            : static inline int
     129                 :          0 : stmt_reset(pysqlite_Statement *self)
     130                 :            : {
     131                 :          0 :     int rc = SQLITE_OK;
     132                 :            : 
     133         [ #  # ]:          0 :     if (self->st != NULL) {
     134                 :          0 :         Py_BEGIN_ALLOW_THREADS
     135                 :          0 :         rc = sqlite3_reset(self->st);
     136                 :          0 :         Py_END_ALLOW_THREADS
     137                 :            :     }
     138                 :            : 
     139                 :          0 :     return rc;
     140                 :            : }
     141                 :            : 
     142                 :            : static int
     143                 :          0 : cursor_traverse(pysqlite_Cursor *self, visitproc visit, void *arg)
     144                 :            : {
     145   [ #  #  #  # ]:          0 :     Py_VISIT(Py_TYPE(self));
     146   [ #  #  #  # ]:          0 :     Py_VISIT(self->connection);
     147   [ #  #  #  # ]:          0 :     Py_VISIT(self->description);
     148   [ #  #  #  # ]:          0 :     Py_VISIT(self->row_cast_map);
     149   [ #  #  #  # ]:          0 :     Py_VISIT(self->lastrowid);
     150   [ #  #  #  # ]:          0 :     Py_VISIT(self->row_factory);
     151   [ #  #  #  # ]:          0 :     Py_VISIT(self->statement);
     152                 :          0 :     return 0;
     153                 :            : }
     154                 :            : 
     155                 :            : static int
     156                 :          0 : cursor_clear(pysqlite_Cursor *self)
     157                 :            : {
     158         [ #  # ]:          0 :     Py_CLEAR(self->connection);
     159         [ #  # ]:          0 :     Py_CLEAR(self->description);
     160         [ #  # ]:          0 :     Py_CLEAR(self->row_cast_map);
     161         [ #  # ]:          0 :     Py_CLEAR(self->lastrowid);
     162         [ #  # ]:          0 :     Py_CLEAR(self->row_factory);
     163         [ #  # ]:          0 :     if (self->statement) {
     164                 :            :         /* Reset the statement if the user has not closed the cursor */
     165                 :          0 :         stmt_reset(self->statement);
     166         [ #  # ]:          0 :         Py_CLEAR(self->statement);
     167                 :            :     }
     168                 :            : 
     169                 :          0 :     return 0;
     170                 :            : }
     171                 :            : 
     172                 :            : static void
     173                 :          0 : cursor_dealloc(pysqlite_Cursor *self)
     174                 :            : {
     175                 :          0 :     PyTypeObject *tp = Py_TYPE(self);
     176                 :          0 :     PyObject_GC_UnTrack(self);
     177         [ #  # ]:          0 :     if (self->in_weakreflist != NULL) {
     178                 :          0 :         PyObject_ClearWeakRefs((PyObject*)self);
     179                 :            :     }
     180                 :          0 :     tp->tp_clear((PyObject *)self);
     181                 :          0 :     tp->tp_free(self);
     182                 :          0 :     Py_DECREF(tp);
     183                 :          0 : }
     184                 :            : 
     185                 :            : static PyObject *
     186                 :          0 : _pysqlite_get_converter(pysqlite_state *state, const char *keystr,
     187                 :            :                         Py_ssize_t keylen)
     188                 :            : {
     189                 :            :     PyObject *key;
     190                 :            :     PyObject *upcase_key;
     191                 :            :     PyObject *retval;
     192                 :            : 
     193                 :          0 :     key = PyUnicode_FromStringAndSize(keystr, keylen);
     194         [ #  # ]:          0 :     if (!key) {
     195                 :          0 :         return NULL;
     196                 :            :     }
     197                 :          0 :     upcase_key = PyObject_CallMethodNoArgs(key, state->str_upper);
     198                 :          0 :     Py_DECREF(key);
     199         [ #  # ]:          0 :     if (!upcase_key) {
     200                 :          0 :         return NULL;
     201                 :            :     }
     202                 :            : 
     203                 :          0 :     retval = PyDict_GetItemWithError(state->converters, upcase_key);
     204                 :          0 :     Py_DECREF(upcase_key);
     205                 :            : 
     206                 :          0 :     return retval;
     207                 :            : }
     208                 :            : 
     209                 :            : static int
     210                 :          0 : pysqlite_build_row_cast_map(pysqlite_Cursor* self)
     211                 :            : {
     212                 :            :     int i;
     213                 :            :     const char* pos;
     214                 :            :     const char* decltype;
     215                 :            :     PyObject* converter;
     216                 :            : 
     217         [ #  # ]:          0 :     if (!self->connection->detect_types) {
     218                 :          0 :         return 0;
     219                 :            :     }
     220                 :            : 
     221                 :          0 :     Py_XSETREF(self->row_cast_map, PyList_New(0));
     222         [ #  # ]:          0 :     if (!self->row_cast_map) {
     223                 :          0 :         return -1;
     224                 :            :     }
     225                 :            : 
     226         [ #  # ]:          0 :     for (i = 0; i < sqlite3_column_count(self->statement->st); i++) {
     227                 :          0 :         converter = NULL;
     228                 :            : 
     229         [ #  # ]:          0 :         if (self->connection->detect_types & PARSE_COLNAMES) {
     230                 :          0 :             const char *colname = sqlite3_column_name(self->statement->st, i);
     231         [ #  # ]:          0 :             if (colname == NULL) {
     232                 :          0 :                 PyErr_NoMemory();
     233         [ #  # ]:          0 :                 Py_CLEAR(self->row_cast_map);
     234                 :          0 :                 return -1;
     235                 :            :             }
     236                 :          0 :             const char *type_start = NULL;
     237         [ #  # ]:          0 :             for (pos = colname; *pos != 0; pos++) {
     238         [ #  # ]:          0 :                 if (*pos == '[') {
     239                 :          0 :                     type_start = pos + 1;
     240                 :            :                 }
     241   [ #  #  #  # ]:          0 :                 else if (*pos == ']' && type_start != NULL) {
     242                 :          0 :                     pysqlite_state *state = self->connection->state;
     243                 :          0 :                     converter = _pysqlite_get_converter(state, type_start,
     244                 :            :                                                         pos - type_start);
     245   [ #  #  #  # ]:          0 :                     if (!converter && PyErr_Occurred()) {
     246         [ #  # ]:          0 :                         Py_CLEAR(self->row_cast_map);
     247                 :          0 :                         return -1;
     248                 :            :                     }
     249                 :          0 :                     break;
     250                 :            :                 }
     251                 :            :             }
     252                 :            :         }
     253                 :            : 
     254   [ #  #  #  # ]:          0 :         if (!converter && self->connection->detect_types & PARSE_DECLTYPES) {
     255                 :          0 :             decltype = sqlite3_column_decltype(self->statement->st, i);
     256         [ #  # ]:          0 :             if (decltype) {
     257                 :          0 :                 for (pos = decltype;;pos++) {
     258                 :            :                     /* Converter names are split at '(' and blanks.
     259                 :            :                      * This allows 'INTEGER NOT NULL' to be treated as 'INTEGER' and
     260                 :            :                      * 'NUMBER(10)' to be treated as 'NUMBER', for example.
     261                 :            :                      * In other words, it will work as people expect it to work.*/
     262   [ #  #  #  #  :          0 :                     if (*pos == ' ' || *pos == '(' || *pos == 0) {
                   #  # ]
     263                 :          0 :                         pysqlite_state *state = self->connection->state;
     264                 :          0 :                         converter = _pysqlite_get_converter(state, decltype,
     265                 :            :                                                             pos - decltype);
     266   [ #  #  #  # ]:          0 :                         if (!converter && PyErr_Occurred()) {
     267         [ #  # ]:          0 :                             Py_CLEAR(self->row_cast_map);
     268                 :          0 :                             return -1;
     269                 :            :                         }
     270                 :          0 :                         break;
     271                 :            :                     }
     272                 :            :                 }
     273                 :            :             }
     274                 :            :         }
     275                 :            : 
     276         [ #  # ]:          0 :         if (!converter) {
     277                 :          0 :             converter = Py_None;
     278                 :            :         }
     279                 :            : 
     280         [ #  # ]:          0 :         if (PyList_Append(self->row_cast_map, converter) != 0) {
     281         [ #  # ]:          0 :             Py_CLEAR(self->row_cast_map);
     282                 :          0 :             return -1;
     283                 :            :         }
     284                 :            :     }
     285                 :            : 
     286                 :          0 :     return 0;
     287                 :            : }
     288                 :            : 
     289                 :            : static PyObject *
     290                 :          0 : _pysqlite_build_column_name(pysqlite_Cursor *self, const char *colname)
     291                 :            : {
     292                 :            :     const char* pos;
     293                 :            :     Py_ssize_t len;
     294                 :            : 
     295         [ #  # ]:          0 :     if (self->connection->detect_types & PARSE_COLNAMES) {
     296         [ #  # ]:          0 :         for (pos = colname; *pos; pos++) {
     297         [ #  # ]:          0 :             if (*pos == '[') {
     298   [ #  #  #  # ]:          0 :                 if ((pos != colname) && (*(pos-1) == ' ')) {
     299                 :          0 :                     pos--;
     300                 :            :                 }
     301                 :          0 :                 break;
     302                 :            :             }
     303                 :            :         }
     304                 :          0 :         len = pos - colname;
     305                 :            :     }
     306                 :            :     else {
     307                 :          0 :         len = strlen(colname);
     308                 :            :     }
     309                 :          0 :     return PyUnicode_FromStringAndSize(colname, len);
     310                 :            : }
     311                 :            : 
     312                 :            : /*
     313                 :            :  * Returns a row from the currently active SQLite statement
     314                 :            :  *
     315                 :            :  * Precondidition:
     316                 :            :  * - sqlite3_step() has been called before and it returned SQLITE_ROW.
     317                 :            :  */
     318                 :            : static PyObject *
     319                 :          0 : _pysqlite_fetch_one_row(pysqlite_Cursor* self)
     320                 :            : {
     321                 :            :     int i, numcols;
     322                 :            :     PyObject* row;
     323                 :            :     int coltype;
     324                 :            :     PyObject* converter;
     325                 :            :     PyObject* converted;
     326                 :            :     Py_ssize_t nbytes;
     327                 :            :     char buf[200];
     328                 :            :     const char* colname;
     329                 :            :     PyObject* error_msg;
     330                 :            : 
     331                 :          0 :     Py_BEGIN_ALLOW_THREADS
     332                 :          0 :     numcols = sqlite3_data_count(self->statement->st);
     333                 :          0 :     Py_END_ALLOW_THREADS
     334                 :            : 
     335                 :          0 :     row = PyTuple_New(numcols);
     336         [ #  # ]:          0 :     if (!row)
     337                 :          0 :         return NULL;
     338                 :            : 
     339                 :          0 :     sqlite3 *db = self->connection->db;
     340         [ #  # ]:          0 :     for (i = 0; i < numcols; i++) {
     341         [ #  # ]:          0 :         if (self->connection->detect_types
     342         [ #  # ]:          0 :                 && self->row_cast_map != NULL
     343         [ #  # ]:          0 :                 && i < PyList_GET_SIZE(self->row_cast_map))
     344                 :            :         {
     345                 :          0 :             converter = PyList_GET_ITEM(self->row_cast_map, i);
     346                 :            :         }
     347                 :            :         else {
     348                 :          0 :             converter = Py_None;
     349                 :            :         }
     350                 :            : 
     351                 :            :         /*
     352                 :            :          * Note, sqlite3_column_bytes() must come after sqlite3_column_blob()
     353                 :            :          * or sqlite3_column_text().
     354                 :            :          *
     355                 :            :          * See https://sqlite.org/c3ref/column_blob.html for details.
     356                 :            :          */
     357         [ #  # ]:          0 :         if (converter != Py_None) {
     358                 :          0 :             const void *blob = sqlite3_column_blob(self->statement->st, i);
     359         [ #  # ]:          0 :             if (blob == NULL) {
     360         [ #  # ]:          0 :                 if (sqlite3_errcode(db) == SQLITE_NOMEM) {
     361                 :          0 :                     PyErr_NoMemory();
     362                 :          0 :                     goto error;
     363                 :            :                 }
     364                 :          0 :                 converted = Py_NewRef(Py_None);
     365                 :            :             }
     366                 :            :             else {
     367                 :          0 :                 nbytes = sqlite3_column_bytes(self->statement->st, i);
     368                 :          0 :                 PyObject *item = PyBytes_FromStringAndSize(blob, nbytes);
     369         [ #  # ]:          0 :                 if (item == NULL) {
     370                 :          0 :                     goto error;
     371                 :            :                 }
     372                 :          0 :                 converted = PyObject_CallOneArg(converter, item);
     373                 :          0 :                 Py_DECREF(item);
     374                 :            :             }
     375                 :            :         } else {
     376                 :          0 :             Py_BEGIN_ALLOW_THREADS
     377                 :          0 :             coltype = sqlite3_column_type(self->statement->st, i);
     378                 :          0 :             Py_END_ALLOW_THREADS
     379         [ #  # ]:          0 :             if (coltype == SQLITE_NULL) {
     380                 :          0 :                 converted = Py_NewRef(Py_None);
     381         [ #  # ]:          0 :             } else if (coltype == SQLITE_INTEGER) {
     382                 :          0 :                 converted = PyLong_FromLongLong(sqlite3_column_int64(self->statement->st, i));
     383         [ #  # ]:          0 :             } else if (coltype == SQLITE_FLOAT) {
     384                 :          0 :                 converted = PyFloat_FromDouble(sqlite3_column_double(self->statement->st, i));
     385         [ #  # ]:          0 :             } else if (coltype == SQLITE_TEXT) {
     386                 :          0 :                 const char *text = (const char*)sqlite3_column_text(self->statement->st, i);
     387   [ #  #  #  # ]:          0 :                 if (text == NULL && sqlite3_errcode(db) == SQLITE_NOMEM) {
     388                 :          0 :                     PyErr_NoMemory();
     389                 :          0 :                     goto error;
     390                 :            :                 }
     391                 :            : 
     392                 :          0 :                 nbytes = sqlite3_column_bytes(self->statement->st, i);
     393         [ #  # ]:          0 :                 if (self->connection->text_factory == (PyObject*)&PyUnicode_Type) {
     394                 :          0 :                     converted = PyUnicode_FromStringAndSize(text, nbytes);
     395   [ #  #  #  # ]:          0 :                     if (!converted && PyErr_ExceptionMatches(PyExc_UnicodeDecodeError)) {
     396                 :          0 :                         PyErr_Clear();
     397                 :          0 :                         colname = sqlite3_column_name(self->statement->st, i);
     398         [ #  # ]:          0 :                         if (colname == NULL) {
     399                 :          0 :                             PyErr_NoMemory();
     400                 :          0 :                             goto error;
     401                 :            :                         }
     402                 :          0 :                         PyOS_snprintf(buf, sizeof(buf) - 1, "Could not decode to UTF-8 column '%s' with text '%s'",
     403                 :            :                                      colname , text);
     404                 :          0 :                         error_msg = PyUnicode_Decode(buf, strlen(buf), "ascii", "replace");
     405                 :            : 
     406                 :          0 :                         PyObject *exc = self->connection->OperationalError;
     407         [ #  # ]:          0 :                         if (!error_msg) {
     408                 :          0 :                             PyErr_SetString(exc, "Could not decode to UTF-8");
     409                 :            :                         } else {
     410                 :          0 :                             PyErr_SetObject(exc, error_msg);
     411                 :          0 :                             Py_DECREF(error_msg);
     412                 :            :                         }
     413                 :            :                     }
     414         [ #  # ]:          0 :                 } else if (self->connection->text_factory == (PyObject*)&PyBytes_Type) {
     415                 :          0 :                     converted = PyBytes_FromStringAndSize(text, nbytes);
     416         [ #  # ]:          0 :                 } else if (self->connection->text_factory == (PyObject*)&PyByteArray_Type) {
     417                 :          0 :                     converted = PyByteArray_FromStringAndSize(text, nbytes);
     418                 :            :                 } else {
     419                 :          0 :                     converted = PyObject_CallFunction(self->connection->text_factory, "y#", text, nbytes);
     420                 :            :                 }
     421                 :            :             } else {
     422                 :            :                 /* coltype == SQLITE_BLOB */
     423                 :          0 :                 const void *blob = sqlite3_column_blob(self->statement->st, i);
     424   [ #  #  #  # ]:          0 :                 if (blob == NULL && sqlite3_errcode(db) == SQLITE_NOMEM) {
     425                 :          0 :                     PyErr_NoMemory();
     426                 :          0 :                     goto error;
     427                 :            :                 }
     428                 :            : 
     429                 :          0 :                 nbytes = sqlite3_column_bytes(self->statement->st, i);
     430                 :          0 :                 converted = PyBytes_FromStringAndSize(blob, nbytes);
     431                 :            :             }
     432                 :            :         }
     433                 :            : 
     434         [ #  # ]:          0 :         if (!converted) {
     435                 :          0 :             goto error;
     436                 :            :         }
     437                 :          0 :         PyTuple_SET_ITEM(row, i, converted);
     438                 :            :     }
     439                 :            : 
     440         [ #  # ]:          0 :     if (PyErr_Occurred())
     441                 :          0 :         goto error;
     442                 :            : 
     443                 :          0 :     return row;
     444                 :            : 
     445                 :          0 : error:
     446                 :          0 :     Py_DECREF(row);
     447                 :          0 :     return NULL;
     448                 :            : }
     449                 :            : 
     450                 :            : /*
     451                 :            :  * Checks if a cursor object is usable.
     452                 :            :  *
     453                 :            :  * 0 => error; 1 => ok
     454                 :            :  */
     455                 :          0 : static int check_cursor(pysqlite_Cursor* cur)
     456                 :            : {
     457         [ #  # ]:          0 :     if (!cur->initialized) {
     458                 :          0 :         pysqlite_state *state = pysqlite_get_state_by_type(Py_TYPE(cur));
     459                 :          0 :         PyErr_SetString(state->ProgrammingError,
     460                 :            :                         "Base Cursor.__init__ not called.");
     461                 :          0 :         return 0;
     462                 :            :     }
     463                 :            : 
     464         [ #  # ]:          0 :     if (cur->closed) {
     465                 :          0 :         PyErr_SetString(cur->connection->state->ProgrammingError,
     466                 :            :                         "Cannot operate on a closed cursor.");
     467                 :          0 :         return 0;
     468                 :            :     }
     469                 :            : 
     470                 :          0 :     return (pysqlite_check_thread(cur->connection)
     471         [ #  # ]:          0 :             && pysqlite_check_connection(cur->connection)
     472   [ #  #  #  # ]:          0 :             && check_cursor_locked(cur));
     473                 :            : }
     474                 :            : 
     475                 :            : static int
     476                 :          0 : begin_transaction(pysqlite_Connection *self)
     477                 :            : {
     478                 :            :     assert(self->isolation_level != NULL);
     479                 :            :     int rc;
     480                 :            : 
     481                 :          0 :     Py_BEGIN_ALLOW_THREADS
     482                 :            :     sqlite3_stmt *statement;
     483                 :          0 :     char begin_stmt[16] = "BEGIN ";
     484                 :            : #ifdef Py_DEBUG
     485                 :            :     size_t len = strlen(self->isolation_level);
     486                 :            :     assert(len <= 9);
     487                 :            : #endif
     488                 :          0 :     (void)strcat(begin_stmt, self->isolation_level);
     489                 :          0 :     rc = sqlite3_prepare_v2(self->db, begin_stmt, -1, &statement, NULL);
     490         [ #  # ]:          0 :     if (rc == SQLITE_OK) {
     491                 :          0 :         (void)sqlite3_step(statement);
     492                 :          0 :         rc = sqlite3_finalize(statement);
     493                 :            :     }
     494                 :          0 :     Py_END_ALLOW_THREADS
     495                 :            : 
     496         [ #  # ]:          0 :     if (rc != SQLITE_OK) {
     497                 :          0 :         (void)_pysqlite_seterror(self->state, self->db);
     498                 :          0 :         return -1;
     499                 :            :     }
     500                 :            : 
     501                 :          0 :     return 0;
     502                 :            : }
     503                 :            : 
     504                 :            : static PyObject *
     505                 :          0 : get_statement_from_cache(pysqlite_Cursor *self, PyObject *operation)
     506                 :            : {
     507                 :          0 :     PyObject *args[] = { NULL, operation, };  // Borrowed ref.
     508                 :          0 :     PyObject *cache = self->connection->statement_cache;
     509                 :          0 :     size_t nargsf = 1 | PY_VECTORCALL_ARGUMENTS_OFFSET;
     510                 :          0 :     return PyObject_Vectorcall(cache, args + 1, nargsf, NULL);
     511                 :            : }
     512                 :            : 
     513                 :            : static inline int
     514                 :          0 : stmt_step(sqlite3_stmt *statement)
     515                 :            : {
     516                 :            :     int rc;
     517                 :            : 
     518                 :          0 :     Py_BEGIN_ALLOW_THREADS
     519                 :          0 :     rc = sqlite3_step(statement);
     520                 :          0 :     Py_END_ALLOW_THREADS
     521                 :            : 
     522                 :          0 :     return rc;
     523                 :            : }
     524                 :            : 
     525                 :            : static int
     526                 :          0 : bind_param(pysqlite_state *state, pysqlite_Statement *self, int pos,
     527                 :            :            PyObject *parameter)
     528                 :            : {
     529                 :          0 :     int rc = SQLITE_OK;
     530                 :            :     const char *string;
     531                 :            :     Py_ssize_t buflen;
     532                 :            :     parameter_type paramtype;
     533                 :            : 
     534         [ #  # ]:          0 :     if (parameter == Py_None) {
     535                 :          0 :         rc = sqlite3_bind_null(self->st, pos);
     536                 :          0 :         goto final;
     537                 :            :     }
     538                 :            : 
     539         [ #  # ]:          0 :     if (PyLong_CheckExact(parameter)) {
     540                 :          0 :         paramtype = TYPE_LONG;
     541         [ #  # ]:          0 :     } else if (PyFloat_CheckExact(parameter)) {
     542                 :          0 :         paramtype = TYPE_FLOAT;
     543         [ #  # ]:          0 :     } else if (PyUnicode_CheckExact(parameter)) {
     544                 :          0 :         paramtype = TYPE_UNICODE;
     545         [ #  # ]:          0 :     } else if (PyLong_Check(parameter)) {
     546                 :          0 :         paramtype = TYPE_LONG;
     547         [ #  # ]:          0 :     } else if (PyFloat_Check(parameter)) {
     548                 :          0 :         paramtype = TYPE_FLOAT;
     549         [ #  # ]:          0 :     } else if (PyUnicode_Check(parameter)) {
     550                 :          0 :         paramtype = TYPE_UNICODE;
     551         [ #  # ]:          0 :     } else if (PyObject_CheckBuffer(parameter)) {
     552                 :          0 :         paramtype = TYPE_BUFFER;
     553                 :            :     } else {
     554                 :          0 :         paramtype = TYPE_UNKNOWN;
     555                 :            :     }
     556                 :            : 
     557   [ #  #  #  #  :          0 :     switch (paramtype) {
                   #  # ]
     558                 :          0 :         case TYPE_LONG: {
     559                 :          0 :             sqlite_int64 value = _pysqlite_long_as_int64(parameter);
     560   [ #  #  #  # ]:          0 :             if (value == -1 && PyErr_Occurred())
     561                 :          0 :                 rc = -1;
     562                 :            :             else
     563                 :          0 :                 rc = sqlite3_bind_int64(self->st, pos, value);
     564                 :          0 :             break;
     565                 :            :         }
     566                 :          0 :         case TYPE_FLOAT: {
     567                 :          0 :             double value = PyFloat_AsDouble(parameter);
     568   [ #  #  #  # ]:          0 :             if (value == -1 && PyErr_Occurred()) {
     569                 :          0 :                 rc = -1;
     570                 :            :             }
     571                 :            :             else {
     572                 :          0 :                 rc = sqlite3_bind_double(self->st, pos, value);
     573                 :            :             }
     574                 :          0 :             break;
     575                 :            :         }
     576                 :          0 :         case TYPE_UNICODE:
     577                 :          0 :             string = PyUnicode_AsUTF8AndSize(parameter, &buflen);
     578         [ #  # ]:          0 :             if (string == NULL)
     579                 :          0 :                 return -1;
     580         [ #  # ]:          0 :             if (buflen > INT_MAX) {
     581                 :          0 :                 PyErr_SetString(PyExc_OverflowError,
     582                 :            :                                 "string longer than INT_MAX bytes");
     583                 :          0 :                 return -1;
     584                 :            :             }
     585                 :          0 :             rc = sqlite3_bind_text(self->st, pos, string, (int)buflen, SQLITE_TRANSIENT);
     586                 :          0 :             break;
     587                 :          0 :         case TYPE_BUFFER: {
     588                 :            :             Py_buffer view;
     589         [ #  # ]:          0 :             if (PyObject_GetBuffer(parameter, &view, PyBUF_SIMPLE) != 0) {
     590                 :          0 :                 return -1;
     591                 :            :             }
     592         [ #  # ]:          0 :             if (view.len > INT_MAX) {
     593                 :          0 :                 PyErr_SetString(PyExc_OverflowError,
     594                 :            :                                 "BLOB longer than INT_MAX bytes");
     595                 :          0 :                 PyBuffer_Release(&view);
     596                 :          0 :                 return -1;
     597                 :            :             }
     598                 :          0 :             rc = sqlite3_bind_blob(self->st, pos, view.buf, (int)view.len, SQLITE_TRANSIENT);
     599                 :          0 :             PyBuffer_Release(&view);
     600                 :          0 :             break;
     601                 :            :         }
     602                 :          0 :         case TYPE_UNKNOWN:
     603                 :          0 :             PyErr_Format(state->ProgrammingError,
     604                 :            :                     "Error binding parameter %d: type '%s' is not supported",
     605                 :          0 :                     pos, Py_TYPE(parameter)->tp_name);
     606                 :          0 :             rc = -1;
     607                 :            :     }
     608                 :            : 
     609                 :          0 : final:
     610                 :          0 :     return rc;
     611                 :            : }
     612                 :            : 
     613                 :            : /* returns 0 if the object is one of Python's internal ones that don't need to be adapted */
     614                 :            : static inline int
     615                 :          0 : need_adapt(pysqlite_state *state, PyObject *obj)
     616                 :            : {
     617         [ #  # ]:          0 :     if (state->BaseTypeAdapted) {
     618                 :          0 :         return 1;
     619                 :            :     }
     620                 :            : 
     621   [ #  #  #  # ]:          0 :     if (PyLong_CheckExact(obj) || PyFloat_CheckExact(obj)
     622   [ #  #  #  # ]:          0 :           || PyUnicode_CheckExact(obj) || PyByteArray_CheckExact(obj)) {
     623                 :          0 :         return 0;
     624                 :            :     } else {
     625                 :          0 :         return 1;
     626                 :            :     }
     627                 :            : }
     628                 :            : 
     629                 :            : static void
     630                 :          0 : bind_parameters(pysqlite_state *state, pysqlite_Statement *self,
     631                 :            :                 PyObject *parameters)
     632                 :            : {
     633                 :            :     PyObject* current_param;
     634                 :            :     PyObject* adapted;
     635                 :            :     const char* binding_name;
     636                 :            :     int i;
     637                 :            :     int rc;
     638                 :            :     int num_params_needed;
     639                 :            :     Py_ssize_t num_params;
     640                 :            : 
     641                 :          0 :     Py_BEGIN_ALLOW_THREADS
     642                 :          0 :     num_params_needed = sqlite3_bind_parameter_count(self->st);
     643                 :          0 :     Py_END_ALLOW_THREADS
     644                 :            : 
     645   [ #  #  #  #  :          0 :     if (PyTuple_CheckExact(parameters) || PyList_CheckExact(parameters) || (!PyDict_Check(parameters) && PySequence_Check(parameters))) {
             #  #  #  # ]
     646                 :            :         /* parameters passed as sequence */
     647         [ #  # ]:          0 :         if (PyTuple_CheckExact(parameters)) {
     648                 :          0 :             num_params = PyTuple_GET_SIZE(parameters);
     649         [ #  # ]:          0 :         } else if (PyList_CheckExact(parameters)) {
     650                 :          0 :             num_params = PyList_GET_SIZE(parameters);
     651                 :            :         } else {
     652                 :          0 :             num_params = PySequence_Size(parameters);
     653         [ #  # ]:          0 :             if (num_params == -1) {
     654                 :          0 :                 return;
     655                 :            :             }
     656                 :            :         }
     657         [ #  # ]:          0 :         if (num_params != num_params_needed) {
     658                 :          0 :             PyErr_Format(state->ProgrammingError,
     659                 :            :                          "Incorrect number of bindings supplied. The current "
     660                 :            :                          "statement uses %d, and there are %zd supplied.",
     661                 :            :                          num_params_needed, num_params);
     662                 :          0 :             return;
     663                 :            :         }
     664         [ #  # ]:          0 :         for (i = 0; i < num_params; i++) {
     665                 :          0 :             const char *name = sqlite3_bind_parameter_name(self->st, i+1);
     666         [ #  # ]:          0 :             if (name != NULL) {
     667                 :          0 :                 int ret = PyErr_WarnFormat(PyExc_DeprecationWarning, 1,
     668                 :            :                         "Binding %d ('%s') is a named parameter, but you "
     669                 :            :                         "supplied a sequence which requires nameless (qmark) "
     670                 :            :                         "placeholders. Starting with Python 3.14 an "
     671                 :            :                         "sqlite3.ProgrammingError will be raised.",
     672                 :            :                         i+1, name);
     673         [ #  # ]:          0 :                 if (ret < 0) {
     674                 :          0 :                     return;
     675                 :            :                 }
     676                 :            :             }
     677                 :            : 
     678         [ #  # ]:          0 :             if (PyTuple_CheckExact(parameters)) {
     679                 :          0 :                 PyObject *item = PyTuple_GET_ITEM(parameters, i);
     680                 :          0 :                 current_param = Py_NewRef(item);
     681         [ #  # ]:          0 :             } else if (PyList_CheckExact(parameters)) {
     682                 :          0 :                 PyObject *item = PyList_GetItem(parameters, i);
     683                 :          0 :                 current_param = Py_XNewRef(item);
     684                 :            :             } else {
     685                 :          0 :                 current_param = PySequence_GetItem(parameters, i);
     686                 :            :             }
     687         [ #  # ]:          0 :             if (!current_param) {
     688                 :          0 :                 return;
     689                 :            :             }
     690                 :            : 
     691         [ #  # ]:          0 :             if (!need_adapt(state, current_param)) {
     692                 :          0 :                 adapted = current_param;
     693                 :            :             } else {
     694                 :          0 :                 PyObject *protocol = (PyObject *)state->PrepareProtocolType;
     695                 :          0 :                 adapted = pysqlite_microprotocols_adapt(state, current_param,
     696                 :            :                                                         protocol,
     697                 :            :                                                         current_param);
     698                 :          0 :                 Py_DECREF(current_param);
     699         [ #  # ]:          0 :                 if (!adapted) {
     700                 :          0 :                     return;
     701                 :            :                 }
     702                 :            :             }
     703                 :            : 
     704                 :          0 :             rc = bind_param(state, self, i + 1, adapted);
     705                 :          0 :             Py_DECREF(adapted);
     706                 :            : 
     707         [ #  # ]:          0 :             if (rc != SQLITE_OK) {
     708                 :          0 :                 PyObject *exc = PyErr_GetRaisedException();
     709                 :          0 :                 sqlite3 *db = sqlite3_db_handle(self->st);
     710                 :          0 :                 _pysqlite_seterror(state, db);
     711                 :          0 :                 _PyErr_ChainExceptions1(exc);
     712                 :          0 :                 return;
     713                 :            :             }
     714                 :            :         }
     715         [ #  # ]:          0 :     } else if (PyDict_Check(parameters)) {
     716                 :            :         /* parameters passed as dictionary */
     717         [ #  # ]:          0 :         for (i = 1; i <= num_params_needed; i++) {
     718                 :            :             PyObject *binding_name_obj;
     719                 :          0 :             Py_BEGIN_ALLOW_THREADS
     720                 :          0 :             binding_name = sqlite3_bind_parameter_name(self->st, i);
     721                 :          0 :             Py_END_ALLOW_THREADS
     722         [ #  # ]:          0 :             if (!binding_name) {
     723                 :          0 :                 PyErr_Format(state->ProgrammingError,
     724                 :            :                              "Binding %d has no name, but you supplied a "
     725                 :            :                              "dictionary (which has only names).", i);
     726                 :          0 :                 return;
     727                 :            :             }
     728                 :            : 
     729                 :          0 :             binding_name++; /* skip first char (the colon) */
     730                 :          0 :             binding_name_obj = PyUnicode_FromString(binding_name);
     731         [ #  # ]:          0 :             if (!binding_name_obj) {
     732                 :          0 :                 return;
     733                 :            :             }
     734         [ #  # ]:          0 :             if (PyDict_CheckExact(parameters)) {
     735                 :          0 :                 PyObject *item = PyDict_GetItemWithError(parameters, binding_name_obj);
     736                 :          0 :                 current_param = Py_XNewRef(item);
     737                 :            :             } else {
     738                 :          0 :                 current_param = PyObject_GetItem(parameters, binding_name_obj);
     739                 :            :             }
     740                 :          0 :             Py_DECREF(binding_name_obj);
     741         [ #  # ]:          0 :             if (!current_param) {
     742   [ #  #  #  # ]:          0 :                 if (!PyErr_Occurred() || PyErr_ExceptionMatches(PyExc_LookupError)) {
     743                 :          0 :                     PyErr_Format(state->ProgrammingError,
     744                 :            :                                  "You did not supply a value for binding "
     745                 :            :                                  "parameter :%s.", binding_name);
     746                 :            :                 }
     747                 :          0 :                 return;
     748                 :            :             }
     749                 :            : 
     750         [ #  # ]:          0 :             if (!need_adapt(state, current_param)) {
     751                 :          0 :                 adapted = current_param;
     752                 :            :             } else {
     753                 :          0 :                 PyObject *protocol = (PyObject *)state->PrepareProtocolType;
     754                 :          0 :                 adapted = pysqlite_microprotocols_adapt(state, current_param,
     755                 :            :                                                         protocol,
     756                 :            :                                                         current_param);
     757                 :          0 :                 Py_DECREF(current_param);
     758         [ #  # ]:          0 :                 if (!adapted) {
     759                 :          0 :                     return;
     760                 :            :                 }
     761                 :            :             }
     762                 :            : 
     763                 :          0 :             rc = bind_param(state, self, i, adapted);
     764                 :          0 :             Py_DECREF(adapted);
     765                 :            : 
     766         [ #  # ]:          0 :             if (rc != SQLITE_OK) {
     767                 :          0 :                 PyObject *exc = PyErr_GetRaisedException();
     768                 :          0 :                 sqlite3 *db = sqlite3_db_handle(self->st);
     769                 :          0 :                 _pysqlite_seterror(state, db);
     770                 :          0 :                 _PyErr_ChainExceptions1(exc);
     771                 :          0 :                 return;
     772                 :            :            }
     773                 :            :         }
     774                 :            :     } else {
     775                 :          0 :         PyErr_SetString(state->ProgrammingError,
     776                 :            :                         "parameters are of unsupported type");
     777                 :            :     }
     778                 :            : }
     779                 :            : 
     780                 :            : PyObject *
     781                 :          0 : _pysqlite_query_execute(pysqlite_Cursor* self, int multiple, PyObject* operation, PyObject* second_argument)
     782                 :            : {
     783                 :          0 :     PyObject* parameters_list = NULL;
     784                 :          0 :     PyObject* parameters_iter = NULL;
     785                 :          0 :     PyObject* parameters = NULL;
     786                 :            :     int i;
     787                 :            :     int rc;
     788                 :            :     int numcols;
     789                 :            :     PyObject* column_name;
     790                 :            : 
     791         [ #  # ]:          0 :     if (!check_cursor(self)) {
     792                 :          0 :         goto error;
     793                 :            :     }
     794                 :            : 
     795                 :          0 :     self->locked = 1;
     796                 :            : 
     797         [ #  # ]:          0 :     if (multiple) {
     798         [ #  # ]:          0 :         if (PyIter_Check(second_argument)) {
     799                 :            :             /* iterator */
     800                 :          0 :             parameters_iter = Py_NewRef(second_argument);
     801                 :            :         } else {
     802                 :            :             /* sequence */
     803                 :          0 :             parameters_iter = PyObject_GetIter(second_argument);
     804         [ #  # ]:          0 :             if (!parameters_iter) {
     805                 :          0 :                 goto error;
     806                 :            :             }
     807                 :            :         }
     808                 :            :     } else {
     809                 :          0 :         parameters_list = PyList_New(0);
     810         [ #  # ]:          0 :         if (!parameters_list) {
     811                 :          0 :             goto error;
     812                 :            :         }
     813                 :            : 
     814         [ #  # ]:          0 :         if (second_argument == NULL) {
     815                 :          0 :             second_argument = PyTuple_New(0);
     816         [ #  # ]:          0 :             if (!second_argument) {
     817                 :          0 :                 goto error;
     818                 :            :             }
     819                 :            :         } else {
     820                 :          0 :             Py_INCREF(second_argument);
     821                 :            :         }
     822         [ #  # ]:          0 :         if (PyList_Append(parameters_list, second_argument) != 0) {
     823                 :          0 :             Py_DECREF(second_argument);
     824                 :          0 :             goto error;
     825                 :            :         }
     826                 :          0 :         Py_DECREF(second_argument);
     827                 :            : 
     828                 :          0 :         parameters_iter = PyObject_GetIter(parameters_list);
     829         [ #  # ]:          0 :         if (!parameters_iter) {
     830                 :          0 :             goto error;
     831                 :            :         }
     832                 :            :     }
     833                 :            : 
     834                 :            :     /* reset description */
     835                 :          0 :     Py_INCREF(Py_None);
     836                 :          0 :     Py_SETREF(self->description, Py_None);
     837                 :            : 
     838         [ #  # ]:          0 :     if (self->statement) {
     839                 :            :         // Reset pending statements on this cursor.
     840                 :          0 :         (void)stmt_reset(self->statement);
     841                 :            :     }
     842                 :            : 
     843                 :          0 :     PyObject *stmt = get_statement_from_cache(self, operation);
     844                 :          0 :     Py_XSETREF(self->statement, (pysqlite_Statement *)stmt);
     845         [ #  # ]:          0 :     if (!self->statement) {
     846                 :          0 :         goto error;
     847                 :            :     }
     848                 :            : 
     849                 :          0 :     pysqlite_state *state = self->connection->state;
     850   [ #  #  #  # ]:          0 :     if (multiple && sqlite3_stmt_readonly(self->statement->st)) {
     851                 :          0 :         PyErr_SetString(state->ProgrammingError,
     852                 :            :                         "executemany() can only execute DML statements.");
     853                 :          0 :         goto error;
     854                 :            :     }
     855                 :            : 
     856         [ #  # ]:          0 :     if (sqlite3_stmt_busy(self->statement->st)) {
     857                 :          0 :         Py_SETREF(self->statement,
     858                 :            :                   pysqlite_statement_create(self->connection, operation));
     859         [ #  # ]:          0 :         if (self->statement == NULL) {
     860                 :          0 :             goto error;
     861                 :            :         }
     862                 :            :     }
     863                 :            : 
     864                 :          0 :     (void)stmt_reset(self->statement);
     865         [ #  # ]:          0 :     self->rowcount = self->statement->is_dml ? 0L : -1L;
     866                 :            : 
     867                 :            :     /* We start a transaction implicitly before a DML statement.
     868                 :            :        SELECT is the only exception. See #9924. */
     869         [ #  # ]:          0 :     if (self->connection->autocommit == AUTOCOMMIT_LEGACY
     870         [ #  # ]:          0 :         && self->connection->isolation_level
     871         [ #  # ]:          0 :         && self->statement->is_dml
     872         [ #  # ]:          0 :         && sqlite3_get_autocommit(self->connection->db))
     873                 :            :     {
     874         [ #  # ]:          0 :         if (begin_transaction(self->connection) < 0) {
     875                 :          0 :             goto error;
     876                 :            :         }
     877                 :            :     }
     878                 :            : 
     879                 :            :     assert(!sqlite3_stmt_busy(self->statement->st));
     880                 :            :     while (1) {
     881                 :          0 :         parameters = PyIter_Next(parameters_iter);
     882         [ #  # ]:          0 :         if (!parameters) {
     883                 :          0 :             break;
     884                 :            :         }
     885                 :            : 
     886                 :          0 :         bind_parameters(state, self->statement, parameters);
     887         [ #  # ]:          0 :         if (PyErr_Occurred()) {
     888                 :          0 :             goto error;
     889                 :            :         }
     890                 :            : 
     891                 :          0 :         rc = stmt_step(self->statement->st);
     892   [ #  #  #  # ]:          0 :         if (rc != SQLITE_DONE && rc != SQLITE_ROW) {
     893         [ #  # ]:          0 :             if (PyErr_Occurred()) {
     894                 :            :                 /* there was an error that occurred in a user-defined callback */
     895         [ #  # ]:          0 :                 if (state->enable_callback_tracebacks) {
     896                 :          0 :                     PyErr_Print();
     897                 :            :                 } else {
     898                 :          0 :                     PyErr_Clear();
     899                 :            :                 }
     900                 :            :             }
     901                 :          0 :             _pysqlite_seterror(state, self->connection->db);
     902                 :          0 :             goto error;
     903                 :            :         }
     904                 :            : 
     905         [ #  # ]:          0 :         if (pysqlite_build_row_cast_map(self) != 0) {
     906                 :          0 :             _PyErr_FormatFromCause(state->OperationalError,
     907                 :            :                                    "Error while building row_cast_map");
     908                 :          0 :             goto error;
     909                 :            :         }
     910                 :            : 
     911                 :            :         assert(rc == SQLITE_ROW || rc == SQLITE_DONE);
     912                 :          0 :         Py_BEGIN_ALLOW_THREADS
     913                 :          0 :         numcols = sqlite3_column_count(self->statement->st);
     914                 :          0 :         Py_END_ALLOW_THREADS
     915   [ #  #  #  # ]:          0 :         if (self->description == Py_None && numcols > 0) {
     916                 :          0 :             Py_SETREF(self->description, PyTuple_New(numcols));
     917         [ #  # ]:          0 :             if (!self->description) {
     918                 :          0 :                 goto error;
     919                 :            :             }
     920         [ #  # ]:          0 :             for (i = 0; i < numcols; i++) {
     921                 :            :                 const char *colname;
     922                 :          0 :                 colname = sqlite3_column_name(self->statement->st, i);
     923         [ #  # ]:          0 :                 if (colname == NULL) {
     924                 :          0 :                     PyErr_NoMemory();
     925                 :          0 :                     goto error;
     926                 :            :                 }
     927                 :          0 :                 column_name = _pysqlite_build_column_name(self, colname);
     928         [ #  # ]:          0 :                 if (column_name == NULL) {
     929                 :          0 :                     goto error;
     930                 :            :                 }
     931                 :          0 :                 PyObject *descriptor = PyTuple_Pack(7, column_name,
     932                 :            :                                                     Py_None, Py_None, Py_None,
     933                 :            :                                                     Py_None, Py_None, Py_None);
     934                 :          0 :                 Py_DECREF(column_name);
     935         [ #  # ]:          0 :                 if (descriptor == NULL) {
     936                 :          0 :                     goto error;
     937                 :            :                 }
     938                 :          0 :                 PyTuple_SET_ITEM(self->description, i, descriptor);
     939                 :            :             }
     940                 :            :         }
     941                 :            : 
     942         [ #  # ]:          0 :         if (rc == SQLITE_DONE) {
     943         [ #  # ]:          0 :             if (self->statement->is_dml) {
     944                 :          0 :                 self->rowcount += (long)sqlite3_changes(self->connection->db);
     945                 :            :             }
     946                 :          0 :             stmt_reset(self->statement);
     947                 :            :         }
     948                 :          0 :         Py_XDECREF(parameters);
     949                 :            :     }
     950                 :            : 
     951         [ #  # ]:          0 :     if (!multiple) {
     952                 :            :         sqlite_int64 lastrowid;
     953                 :            : 
     954                 :          0 :         Py_BEGIN_ALLOW_THREADS
     955                 :          0 :         lastrowid = sqlite3_last_insert_rowid(self->connection->db);
     956                 :          0 :         Py_END_ALLOW_THREADS
     957                 :            : 
     958                 :          0 :         Py_SETREF(self->lastrowid, PyLong_FromLongLong(lastrowid));
     959                 :            :         // Fall through on error.
     960                 :            :     }
     961                 :            : 
     962                 :          0 : error:
     963                 :          0 :     Py_XDECREF(parameters);
     964                 :          0 :     Py_XDECREF(parameters_iter);
     965                 :          0 :     Py_XDECREF(parameters_list);
     966                 :            : 
     967                 :          0 :     self->locked = 0;
     968                 :            : 
     969         [ #  # ]:          0 :     if (PyErr_Occurred()) {
     970         [ #  # ]:          0 :         if (self->statement) {
     971                 :          0 :             (void)stmt_reset(self->statement);
     972         [ #  # ]:          0 :             Py_CLEAR(self->statement);
     973                 :            :         }
     974                 :          0 :         self->rowcount = -1L;
     975                 :          0 :         return NULL;
     976                 :            :     }
     977   [ #  #  #  # ]:          0 :     if (self->statement && !sqlite3_stmt_busy(self->statement->st)) {
     978         [ #  # ]:          0 :         Py_CLEAR(self->statement);
     979                 :            :     }
     980                 :          0 :     return Py_NewRef((PyObject *)self);
     981                 :            : }
     982                 :            : 
     983                 :            : /*[clinic input]
     984                 :            : _sqlite3.Cursor.execute as pysqlite_cursor_execute
     985                 :            : 
     986                 :            :     sql: unicode
     987                 :            :     parameters: object(c_default = 'NULL') = ()
     988                 :            :     /
     989                 :            : 
     990                 :            : Executes an SQL statement.
     991                 :            : [clinic start generated code]*/
     992                 :            : 
     993                 :            : static PyObject *
     994                 :          0 : pysqlite_cursor_execute_impl(pysqlite_Cursor *self, PyObject *sql,
     995                 :            :                              PyObject *parameters)
     996                 :            : /*[clinic end generated code: output=d81b4655c7c0bbad input=a8e0200a11627f94]*/
     997                 :            : {
     998                 :          0 :     return _pysqlite_query_execute(self, 0, sql, parameters);
     999                 :            : }
    1000                 :            : 
    1001                 :            : /*[clinic input]
    1002                 :            : _sqlite3.Cursor.executemany as pysqlite_cursor_executemany
    1003                 :            : 
    1004                 :            :     sql: unicode
    1005                 :            :     seq_of_parameters: object
    1006                 :            :     /
    1007                 :            : 
    1008                 :            : Repeatedly executes an SQL statement.
    1009                 :            : [clinic start generated code]*/
    1010                 :            : 
    1011                 :            : static PyObject *
    1012                 :          0 : pysqlite_cursor_executemany_impl(pysqlite_Cursor *self, PyObject *sql,
    1013                 :            :                                  PyObject *seq_of_parameters)
    1014                 :            : /*[clinic end generated code: output=2c65a3c4733fb5d8 input=0d0a52e5eb7ccd35]*/
    1015                 :            : {
    1016                 :          0 :     return _pysqlite_query_execute(self, 1, sql, seq_of_parameters);
    1017                 :            : }
    1018                 :            : 
    1019                 :            : /*[clinic input]
    1020                 :            : _sqlite3.Cursor.executescript as pysqlite_cursor_executescript
    1021                 :            : 
    1022                 :            :     sql_script: str
    1023                 :            :     /
    1024                 :            : 
    1025                 :            : Executes multiple SQL statements at once.
    1026                 :            : [clinic start generated code]*/
    1027                 :            : 
    1028                 :            : static PyObject *
    1029                 :          0 : pysqlite_cursor_executescript_impl(pysqlite_Cursor *self,
    1030                 :            :                                    const char *sql_script)
    1031                 :            : /*[clinic end generated code: output=8fd726dde1c65164 input=78f093be415a8a2c]*/
    1032                 :            : {
    1033         [ #  # ]:          0 :     if (!check_cursor(self)) {
    1034                 :          0 :         return NULL;
    1035                 :            :     }
    1036                 :            : 
    1037                 :          0 :     size_t sql_len = strlen(sql_script);
    1038                 :          0 :     int max_length = sqlite3_limit(self->connection->db,
    1039                 :            :                                    SQLITE_LIMIT_SQL_LENGTH, -1);
    1040         [ #  # ]:          0 :     if (sql_len > (unsigned)max_length) {
    1041                 :          0 :         PyErr_SetString(self->connection->DataError,
    1042                 :            :                         "query string is too large");
    1043                 :          0 :         return NULL;
    1044                 :            :     }
    1045                 :            : 
    1046                 :            :     // Commit if needed
    1047                 :          0 :     sqlite3 *db = self->connection->db;
    1048         [ #  # ]:          0 :     if (self->connection->autocommit == AUTOCOMMIT_LEGACY
    1049         [ #  # ]:          0 :         && !sqlite3_get_autocommit(db))
    1050                 :            :     {
    1051                 :          0 :         int rc = SQLITE_OK;
    1052                 :            : 
    1053                 :          0 :         Py_BEGIN_ALLOW_THREADS
    1054                 :          0 :         rc = sqlite3_exec(db, "COMMIT", NULL, NULL, NULL);
    1055                 :          0 :         Py_END_ALLOW_THREADS
    1056                 :            : 
    1057         [ #  # ]:          0 :         if (rc != SQLITE_OK) {
    1058                 :          0 :             goto error;
    1059                 :            :         }
    1060                 :            :     }
    1061                 :            : 
    1062                 :          0 :     while (1) {
    1063                 :            :         int rc;
    1064                 :            :         const char *tail;
    1065                 :            : 
    1066                 :          0 :         Py_BEGIN_ALLOW_THREADS
    1067                 :            :         sqlite3_stmt *stmt;
    1068                 :          0 :         rc = sqlite3_prepare_v2(db, sql_script, (int)sql_len + 1, &stmt,
    1069                 :            :                                 &tail);
    1070         [ #  # ]:          0 :         if (rc == SQLITE_OK) {
    1071                 :            :             do {
    1072                 :          0 :                 rc = sqlite3_step(stmt);
    1073         [ #  # ]:          0 :             } while (rc == SQLITE_ROW);
    1074                 :          0 :             rc = sqlite3_finalize(stmt);
    1075                 :            :         }
    1076                 :          0 :         Py_END_ALLOW_THREADS
    1077                 :            : 
    1078         [ #  # ]:          0 :         if (rc != SQLITE_OK) {
    1079                 :          0 :             goto error;
    1080                 :            :         }
    1081                 :            : 
    1082         [ #  # ]:          0 :         if (*tail == (char)0) {
    1083                 :          0 :             break;
    1084                 :            :         }
    1085                 :          0 :         sql_len -= (tail - sql_script);
    1086                 :          0 :         sql_script = tail;
    1087                 :            :     }
    1088                 :            : 
    1089                 :          0 :     return Py_NewRef((PyObject *)self);
    1090                 :            : 
    1091                 :          0 : error:
    1092                 :          0 :     _pysqlite_seterror(self->connection->state, db);
    1093                 :          0 :     return NULL;
    1094                 :            : }
    1095                 :            : 
    1096                 :            : static PyObject *
    1097                 :          0 : pysqlite_cursor_iternext(pysqlite_Cursor *self)
    1098                 :            : {
    1099         [ #  # ]:          0 :     if (!check_cursor(self)) {
    1100                 :          0 :         return NULL;
    1101                 :            :     }
    1102                 :            : 
    1103         [ #  # ]:          0 :     if (self->statement == NULL) {
    1104                 :          0 :         return NULL;
    1105                 :            :     }
    1106                 :            : 
    1107                 :          0 :     sqlite3_stmt *stmt = self->statement->st;
    1108                 :            :     assert(stmt != NULL);
    1109                 :            :     assert(sqlite3_data_count(stmt) != 0);
    1110                 :            : 
    1111                 :          0 :     self->locked = 1;  // GH-80254: Prevent recursive use of cursors.
    1112                 :          0 :     PyObject *row = _pysqlite_fetch_one_row(self);
    1113                 :          0 :     self->locked = 0;
    1114         [ #  # ]:          0 :     if (row == NULL) {
    1115                 :          0 :         return NULL;
    1116                 :            :     }
    1117                 :          0 :     int rc = stmt_step(stmt);
    1118         [ #  # ]:          0 :     if (rc == SQLITE_DONE) {
    1119         [ #  # ]:          0 :         if (self->statement->is_dml) {
    1120                 :          0 :             self->rowcount = (long)sqlite3_changes(self->connection->db);
    1121                 :            :         }
    1122                 :          0 :         (void)stmt_reset(self->statement);
    1123         [ #  # ]:          0 :         Py_CLEAR(self->statement);
    1124                 :            :     }
    1125         [ #  # ]:          0 :     else if (rc != SQLITE_ROW) {
    1126                 :          0 :         (void)_pysqlite_seterror(self->connection->state,
    1127                 :          0 :                                  self->connection->db);
    1128                 :          0 :         (void)stmt_reset(self->statement);
    1129         [ #  # ]:          0 :         Py_CLEAR(self->statement);
    1130                 :          0 :         Py_DECREF(row);
    1131                 :          0 :         return NULL;
    1132                 :            :     }
    1133         [ #  # ]:          0 :     if (!Py_IsNone(self->row_factory)) {
    1134                 :          0 :         PyObject *factory = self->row_factory;
    1135                 :          0 :         PyObject *args[] = { (PyObject *)self, row, };
    1136                 :          0 :         PyObject *new_row = PyObject_Vectorcall(factory, args, 2, NULL);
    1137                 :          0 :         Py_SETREF(row, new_row);
    1138                 :            :     }
    1139                 :          0 :     return row;
    1140                 :            : }
    1141                 :            : 
    1142                 :            : /*[clinic input]
    1143                 :            : _sqlite3.Cursor.fetchone as pysqlite_cursor_fetchone
    1144                 :            : 
    1145                 :            : Fetches one row from the resultset.
    1146                 :            : [clinic start generated code]*/
    1147                 :            : 
    1148                 :            : static PyObject *
    1149                 :          0 : pysqlite_cursor_fetchone_impl(pysqlite_Cursor *self)
    1150                 :            : /*[clinic end generated code: output=4bd2eabf5baaddb0 input=e78294ec5980fdba]*/
    1151                 :            : {
    1152                 :            :     PyObject* row;
    1153                 :            : 
    1154                 :          0 :     row = pysqlite_cursor_iternext(self);
    1155   [ #  #  #  # ]:          0 :     if (!row && !PyErr_Occurred()) {
    1156                 :          0 :         Py_RETURN_NONE;
    1157                 :            :     }
    1158                 :            : 
    1159                 :          0 :     return row;
    1160                 :            : }
    1161                 :            : 
    1162                 :            : /*[clinic input]
    1163                 :            : _sqlite3.Cursor.fetchmany as pysqlite_cursor_fetchmany
    1164                 :            : 
    1165                 :            :     size as maxrows: int(c_default='self->arraysize') = 1
    1166                 :            :         The default value is set by the Cursor.arraysize attribute.
    1167                 :            : 
    1168                 :            : Fetches several rows from the resultset.
    1169                 :            : [clinic start generated code]*/
    1170                 :            : 
    1171                 :            : static PyObject *
    1172                 :          0 : pysqlite_cursor_fetchmany_impl(pysqlite_Cursor *self, int maxrows)
    1173                 :            : /*[clinic end generated code: output=a8ef31fea64d0906 input=c26e6ca3f34debd0]*/
    1174                 :            : {
    1175                 :            :     PyObject* row;
    1176                 :            :     PyObject* list;
    1177                 :          0 :     int counter = 0;
    1178                 :            : 
    1179                 :          0 :     list = PyList_New(0);
    1180         [ #  # ]:          0 :     if (!list) {
    1181                 :          0 :         return NULL;
    1182                 :            :     }
    1183                 :            : 
    1184         [ #  # ]:          0 :     while ((row = pysqlite_cursor_iternext(self))) {
    1185         [ #  # ]:          0 :         if (PyList_Append(list, row) < 0) {
    1186                 :          0 :             Py_DECREF(row);
    1187                 :          0 :             break;
    1188                 :            :         }
    1189                 :          0 :         Py_DECREF(row);
    1190                 :            : 
    1191         [ #  # ]:          0 :         if (++counter == maxrows) {
    1192                 :          0 :             break;
    1193                 :            :         }
    1194                 :            :     }
    1195                 :            : 
    1196         [ #  # ]:          0 :     if (PyErr_Occurred()) {
    1197                 :          0 :         Py_DECREF(list);
    1198                 :          0 :         return NULL;
    1199                 :            :     } else {
    1200                 :          0 :         return list;
    1201                 :            :     }
    1202                 :            : }
    1203                 :            : 
    1204                 :            : /*[clinic input]
    1205                 :            : _sqlite3.Cursor.fetchall as pysqlite_cursor_fetchall
    1206                 :            : 
    1207                 :            : Fetches all rows from the resultset.
    1208                 :            : [clinic start generated code]*/
    1209                 :            : 
    1210                 :            : static PyObject *
    1211                 :          0 : pysqlite_cursor_fetchall_impl(pysqlite_Cursor *self)
    1212                 :            : /*[clinic end generated code: output=d5da12aca2da4b27 input=f5d401086a8df25a]*/
    1213                 :            : {
    1214                 :            :     PyObject* row;
    1215                 :            :     PyObject* list;
    1216                 :            : 
    1217                 :          0 :     list = PyList_New(0);
    1218         [ #  # ]:          0 :     if (!list) {
    1219                 :          0 :         return NULL;
    1220                 :            :     }
    1221                 :            : 
    1222         [ #  # ]:          0 :     while ((row = pysqlite_cursor_iternext(self))) {
    1223         [ #  # ]:          0 :         if (PyList_Append(list, row) < 0) {
    1224                 :          0 :             Py_DECREF(row);
    1225                 :          0 :             break;
    1226                 :            :         }
    1227                 :          0 :         Py_DECREF(row);
    1228                 :            :     }
    1229                 :            : 
    1230         [ #  # ]:          0 :     if (PyErr_Occurred()) {
    1231                 :          0 :         Py_DECREF(list);
    1232                 :          0 :         return NULL;
    1233                 :            :     } else {
    1234                 :          0 :         return list;
    1235                 :            :     }
    1236                 :            : }
    1237                 :            : 
    1238                 :            : /*[clinic input]
    1239                 :            : _sqlite3.Cursor.setinputsizes as pysqlite_cursor_setinputsizes
    1240                 :            : 
    1241                 :            :     sizes: object
    1242                 :            :     /
    1243                 :            : 
    1244                 :            : Required by DB-API. Does nothing in sqlite3.
    1245                 :            : [clinic start generated code]*/
    1246                 :            : 
    1247                 :            : static PyObject *
    1248                 :          0 : pysqlite_cursor_setinputsizes(pysqlite_Cursor *self, PyObject *sizes)
    1249                 :            : /*[clinic end generated code: output=893c817afe9d08ad input=de7950a3aec79bdf]*/
    1250                 :            : {
    1251                 :          0 :     Py_RETURN_NONE;
    1252                 :            : }
    1253                 :            : 
    1254                 :            : /*[clinic input]
    1255                 :            : _sqlite3.Cursor.setoutputsize as pysqlite_cursor_setoutputsize
    1256                 :            : 
    1257                 :            :     size: object
    1258                 :            :     column: object = None
    1259                 :            :     /
    1260                 :            : 
    1261                 :            : Required by DB-API. Does nothing in sqlite3.
    1262                 :            : [clinic start generated code]*/
    1263                 :            : 
    1264                 :            : static PyObject *
    1265                 :          0 : pysqlite_cursor_setoutputsize_impl(pysqlite_Cursor *self, PyObject *size,
    1266                 :            :                                    PyObject *column)
    1267                 :            : /*[clinic end generated code: output=018d7e9129d45efe input=607a6bece8bbb273]*/
    1268                 :            : {
    1269                 :          0 :     Py_RETURN_NONE;
    1270                 :            : }
    1271                 :            : 
    1272                 :            : /*[clinic input]
    1273                 :            : _sqlite3.Cursor.close as pysqlite_cursor_close
    1274                 :            : 
    1275                 :            : Closes the cursor.
    1276                 :            : [clinic start generated code]*/
    1277                 :            : 
    1278                 :            : static PyObject *
    1279                 :          0 : pysqlite_cursor_close_impl(pysqlite_Cursor *self)
    1280                 :            : /*[clinic end generated code: output=b6055e4ec6fe63b6 input=08b36552dbb9a986]*/
    1281                 :            : {
    1282         [ #  # ]:          0 :     if (!check_cursor_locked(self)) {
    1283                 :          0 :         return NULL;
    1284                 :            :     }
    1285                 :            : 
    1286         [ #  # ]:          0 :     if (!self->connection) {
    1287                 :          0 :         PyTypeObject *tp = Py_TYPE(self);
    1288                 :          0 :         pysqlite_state *state = pysqlite_get_state_by_type(tp);
    1289                 :          0 :         PyErr_SetString(state->ProgrammingError,
    1290                 :            :                         "Base Cursor.__init__ not called.");
    1291                 :          0 :         return NULL;
    1292                 :            :     }
    1293   [ #  #  #  # ]:          0 :     if (!pysqlite_check_thread(self->connection) || !pysqlite_check_connection(self->connection)) {
    1294                 :          0 :         return NULL;
    1295                 :            :     }
    1296                 :            : 
    1297         [ #  # ]:          0 :     if (self->statement) {
    1298                 :          0 :         (void)stmt_reset(self->statement);
    1299         [ #  # ]:          0 :         Py_CLEAR(self->statement);
    1300                 :            :     }
    1301                 :            : 
    1302                 :          0 :     self->closed = 1;
    1303                 :            : 
    1304                 :          0 :     Py_RETURN_NONE;
    1305                 :            : }
    1306                 :            : 
    1307                 :            : static PyMethodDef cursor_methods[] = {
    1308                 :            :     PYSQLITE_CURSOR_CLOSE_METHODDEF
    1309                 :            :     PYSQLITE_CURSOR_EXECUTEMANY_METHODDEF
    1310                 :            :     PYSQLITE_CURSOR_EXECUTESCRIPT_METHODDEF
    1311                 :            :     PYSQLITE_CURSOR_EXECUTE_METHODDEF
    1312                 :            :     PYSQLITE_CURSOR_FETCHALL_METHODDEF
    1313                 :            :     PYSQLITE_CURSOR_FETCHMANY_METHODDEF
    1314                 :            :     PYSQLITE_CURSOR_FETCHONE_METHODDEF
    1315                 :            :     PYSQLITE_CURSOR_SETINPUTSIZES_METHODDEF
    1316                 :            :     PYSQLITE_CURSOR_SETOUTPUTSIZE_METHODDEF
    1317                 :            :     {NULL, NULL}
    1318                 :            : };
    1319                 :            : 
    1320                 :            : static struct PyMemberDef cursor_members[] =
    1321                 :            : {
    1322                 :            :     {"connection", T_OBJECT, offsetof(pysqlite_Cursor, connection), READONLY},
    1323                 :            :     {"description", T_OBJECT, offsetof(pysqlite_Cursor, description), READONLY},
    1324                 :            :     {"arraysize", T_INT, offsetof(pysqlite_Cursor, arraysize), 0},
    1325                 :            :     {"lastrowid", T_OBJECT, offsetof(pysqlite_Cursor, lastrowid), READONLY},
    1326                 :            :     {"rowcount", T_LONG, offsetof(pysqlite_Cursor, rowcount), READONLY},
    1327                 :            :     {"row_factory", T_OBJECT, offsetof(pysqlite_Cursor, row_factory), 0},
    1328                 :            :     {"__weaklistoffset__", T_PYSSIZET, offsetof(pysqlite_Cursor, in_weakreflist), READONLY},
    1329                 :            :     {NULL}
    1330                 :            : };
    1331                 :            : 
    1332                 :            : static const char cursor_doc[] =
    1333                 :            : PyDoc_STR("SQLite database cursor class.");
    1334                 :            : 
    1335                 :            : static PyType_Slot cursor_slots[] = {
    1336                 :            :     {Py_tp_dealloc, cursor_dealloc},
    1337                 :            :     {Py_tp_doc, (void *)cursor_doc},
    1338                 :            :     {Py_tp_iter, PyObject_SelfIter},
    1339                 :            :     {Py_tp_iternext, pysqlite_cursor_iternext},
    1340                 :            :     {Py_tp_methods, cursor_methods},
    1341                 :            :     {Py_tp_members, cursor_members},
    1342                 :            :     {Py_tp_init, pysqlite_cursor_init},
    1343                 :            :     {Py_tp_traverse, cursor_traverse},
    1344                 :            :     {Py_tp_clear, cursor_clear},
    1345                 :            :     {0, NULL},
    1346                 :            : };
    1347                 :            : 
    1348                 :            : static PyType_Spec cursor_spec = {
    1349                 :            :     .name = MODULE_NAME ".Cursor",
    1350                 :            :     .basicsize = sizeof(pysqlite_Cursor),
    1351                 :            :     .flags = (Py_TPFLAGS_DEFAULT | Py_TPFLAGS_BASETYPE |
    1352                 :            :               Py_TPFLAGS_HAVE_GC | Py_TPFLAGS_IMMUTABLETYPE),
    1353                 :            :     .slots = cursor_slots,
    1354                 :            : };
    1355                 :            : 
    1356                 :            : int
    1357                 :          1 : pysqlite_cursor_setup_types(PyObject *module)
    1358                 :            : {
    1359                 :          1 :     PyObject *type = PyType_FromModuleAndSpec(module, &cursor_spec, NULL);
    1360         [ -  + ]:          1 :     if (type == NULL) {
    1361                 :          0 :         return -1;
    1362                 :            :     }
    1363                 :          1 :     pysqlite_state *state = pysqlite_get_state(module);
    1364                 :          1 :     state->CursorType = (PyTypeObject *)type;
    1365                 :          1 :     return 0;
    1366                 :            : }

Generated by: LCOV version 1.14