mirror of
https://github.com/python/cpython.git
synced 2025-11-02 03:01:58 +00:00
bpo-40956: Convert _sqlite3.Cursor to Argument Clinic (GH-24007)
This commit is contained in:
Erlend Egeberg Aasland
GitHub
parent
dd74c01d3b
commit
c7f8d3caf0
3 changed files with 401 additions and 73 deletions
259
Modules/_sqlite/clinic/cursor.c.h
Normal file
259
Modules/_sqlite/clinic/cursor.c.h
Normal file
|
|
@ -0,0 +1,259 @@
|
|||
/*[clinic input]
|
||||
preserve
|
||||
[clinic start generated code]*/
|
||||
|
||||
static int
|
||||
pysqlite_cursor_init_impl(pysqlite_Cursor *self,
|
||||
pysqlite_Connection *connection);
|
||||
|
||||
static int
|
||||
pysqlite_cursor_init(PyObject *self, PyObject *args, PyObject *kwargs)
|
||||
{
|
||||
int return_value = -1;
|
||||
pysqlite_Connection *connection;
|
||||
|
||||
if (Py_IS_TYPE(self, pysqlite_CursorType) &&
|
||||
!_PyArg_NoKeywords("Cursor", kwargs)) {
|
||||
goto exit;
|
||||
}
|
||||
if (!_PyArg_CheckPositional("Cursor", PyTuple_GET_SIZE(args), 1, 1)) {
|
||||
goto exit;
|
||||
}
|
||||
if (!PyObject_TypeCheck(PyTuple_GET_ITEM(args, 0), pysqlite_ConnectionType)) {
|
||||
_PyArg_BadArgument("Cursor", "argument 1", (pysqlite_ConnectionType)->tp_name, PyTuple_GET_ITEM(args, 0));
|
||||
goto exit;
|
||||
}
|
||||
connection = (pysqlite_Connection *)PyTuple_GET_ITEM(args, 0);
|
||||
return_value = pysqlite_cursor_init_impl((pysqlite_Cursor *)self, connection);
|
||||
|
||||
exit:
|
||||
return return_value;
|
||||
}
|
||||
|
||||
PyDoc_STRVAR(pysqlite_cursor_execute__doc__,
|
||||
"execute($self, sql, parameters=(), /)\n"
|
||||
"--\n"
|
||||
"\n"
|
||||
"Executes a SQL statement.");
|
||||
|
||||
#define PYSQLITE_CURSOR_EXECUTE_METHODDEF \
|
||||
{"execute", (PyCFunction)(void(*)(void))pysqlite_cursor_execute, METH_FASTCALL, pysqlite_cursor_execute__doc__},
|
||||
|
||||
static PyObject *
|
||||
pysqlite_cursor_execute_impl(pysqlite_Cursor *self, PyObject *sql,
|
||||
PyObject *parameters);
|
||||
|
||||
static PyObject *
|
||||
pysqlite_cursor_execute(pysqlite_Cursor *self, PyObject *const *args, Py_ssize_t nargs)
|
||||
{
|
||||
PyObject *return_value = NULL;
|
||||
PyObject *sql;
|
||||
PyObject *parameters = NULL;
|
||||
|
||||
if (!_PyArg_CheckPositional("execute", nargs, 1, 2)) {
|
||||
goto exit;
|
||||
}
|
||||
if (!PyUnicode_Check(args[0])) {
|
||||
_PyArg_BadArgument("execute", "argument 1", "str", args[0]);
|
||||
goto exit;
|
||||
}
|
||||
if (PyUnicode_READY(args[0]) == -1) {
|
||||
goto exit;
|
||||
}
|
||||
sql = args[0];
|
||||
if (nargs < 2) {
|
||||
goto skip_optional;
|
||||
}
|
||||
parameters = args[1];
|
||||
skip_optional:
|
||||
return_value = pysqlite_cursor_execute_impl(self, sql, parameters);
|
||||
|
||||
exit:
|
||||
return return_value;
|
||||
}
|
||||
|
||||
PyDoc_STRVAR(pysqlite_cursor_executemany__doc__,
|
||||
"executemany($self, sql, seq_of_parameters, /)\n"
|
||||
"--\n"
|
||||
"\n"
|
||||
"Repeatedly executes a SQL statement.");
|
||||
|
||||
#define PYSQLITE_CURSOR_EXECUTEMANY_METHODDEF \
|
||||
{"executemany", (PyCFunction)(void(*)(void))pysqlite_cursor_executemany, METH_FASTCALL, pysqlite_cursor_executemany__doc__},
|
||||
|
||||
static PyObject *
|
||||
pysqlite_cursor_executemany_impl(pysqlite_Cursor *self, PyObject *sql,
|
||||
PyObject *seq_of_parameters);
|
||||
|
||||
static PyObject *
|
||||
pysqlite_cursor_executemany(pysqlite_Cursor *self, PyObject *const *args, Py_ssize_t nargs)
|
||||
{
|
||||
PyObject *return_value = NULL;
|
||||
PyObject *sql;
|
||||
PyObject *seq_of_parameters;
|
||||
|
||||
if (!_PyArg_CheckPositional("executemany", nargs, 2, 2)) {
|
||||
goto exit;
|
||||
}
|
||||
if (!PyUnicode_Check(args[0])) {
|
||||
_PyArg_BadArgument("executemany", "argument 1", "str", args[0]);
|
||||
goto exit;
|
||||
}
|
||||
if (PyUnicode_READY(args[0]) == -1) {
|
||||
goto exit;
|
||||
}
|
||||
sql = args[0];
|
||||
seq_of_parameters = args[1];
|
||||
return_value = pysqlite_cursor_executemany_impl(self, sql, seq_of_parameters);
|
||||
|
||||
exit:
|
||||
return return_value;
|
||||
}
|
||||
|
||||
PyDoc_STRVAR(pysqlite_cursor_executescript__doc__,
|
||||
"executescript($self, sql_script, /)\n"
|
||||
"--\n"
|
||||
"\n"
|
||||
"Executes a multiple SQL statements at once. Non-standard.");
|
||||
|
||||
#define PYSQLITE_CURSOR_EXECUTESCRIPT_METHODDEF \
|
||||
{"executescript", (PyCFunction)pysqlite_cursor_executescript, METH_O, pysqlite_cursor_executescript__doc__},
|
||||
|
||||
PyDoc_STRVAR(pysqlite_cursor_fetchone__doc__,
|
||||
"fetchone($self, /)\n"
|
||||
"--\n"
|
||||
"\n"
|
||||
"Fetches one row from the resultset.");
|
||||
|
||||
#define PYSQLITE_CURSOR_FETCHONE_METHODDEF \
|
||||
{"fetchone", (PyCFunction)pysqlite_cursor_fetchone, METH_NOARGS, pysqlite_cursor_fetchone__doc__},
|
||||
|
||||
static PyObject *
|
||||
pysqlite_cursor_fetchone_impl(pysqlite_Cursor *self);
|
||||
|
||||
static PyObject *
|
||||
pysqlite_cursor_fetchone(pysqlite_Cursor *self, PyObject *Py_UNUSED(ignored))
|
||||
{
|
||||
return pysqlite_cursor_fetchone_impl(self);
|
||||
}
|
||||
|
||||
PyDoc_STRVAR(pysqlite_cursor_fetchmany__doc__,
|
||||
"fetchmany($self, /, size=cursor.arraysize)\n"
|
||||
"--\n"
|
||||
"\n"
|
||||
"Fetches several rows from the resultset.");
|
||||
|
||||
#define PYSQLITE_CURSOR_FETCHMANY_METHODDEF \
|
||||
{"fetchmany", (PyCFunction)(void(*)(void))pysqlite_cursor_fetchmany, METH_FASTCALL|METH_KEYWORDS, pysqlite_cursor_fetchmany__doc__},
|
||||
|
||||
static PyObject *
|
||||
pysqlite_cursor_fetchmany_impl(pysqlite_Cursor *self, int maxrows);
|
||||
|
||||
static PyObject *
|
||||
pysqlite_cursor_fetchmany(pysqlite_Cursor *self, PyObject *const *args, Py_ssize_t nargs, PyObject *kwnames)
|
||||
{
|
||||
PyObject *return_value = NULL;
|
||||
static const char * const _keywords[] = {"size", NULL};
|
||||
static _PyArg_Parser _parser = {NULL, _keywords, "fetchmany", 0};
|
||||
PyObject *argsbuf[1];
|
||||
Py_ssize_t noptargs = nargs + (kwnames ? PyTuple_GET_SIZE(kwnames) : 0) - 0;
|
||||
int maxrows = self->arraysize;
|
||||
|
||||
args = _PyArg_UnpackKeywords(args, nargs, NULL, kwnames, &_parser, 0, 1, 0, argsbuf);
|
||||
if (!args) {
|
||||
goto exit;
|
||||
}
|
||||
if (!noptargs) {
|
||||
goto skip_optional_pos;
|
||||
}
|
||||
maxrows = _PyLong_AsInt(args[0]);
|
||||
if (maxrows == -1 && PyErr_Occurred()) {
|
||||
goto exit;
|
||||
}
|
||||
skip_optional_pos:
|
||||
return_value = pysqlite_cursor_fetchmany_impl(self, maxrows);
|
||||
|
||||
exit:
|
||||
return return_value;
|
||||
}
|
||||
|
||||
PyDoc_STRVAR(pysqlite_cursor_fetchall__doc__,
|
||||
"fetchall($self, /)\n"
|
||||
"--\n"
|
||||
"\n"
|
||||
"Fetches all rows from the resultset.");
|
||||
|
||||
#define PYSQLITE_CURSOR_FETCHALL_METHODDEF \
|
||||
{"fetchall", (PyCFunction)pysqlite_cursor_fetchall, METH_NOARGS, pysqlite_cursor_fetchall__doc__},
|
||||
|
||||
static PyObject *
|
||||
pysqlite_cursor_fetchall_impl(pysqlite_Cursor *self);
|
||||
|
||||
static PyObject *
|
||||
pysqlite_cursor_fetchall(pysqlite_Cursor *self, PyObject *Py_UNUSED(ignored))
|
||||
{
|
||||
return pysqlite_cursor_fetchall_impl(self);
|
||||
}
|
||||
|
||||
PyDoc_STRVAR(pysqlite_cursor_setinputsizes__doc__,
|
||||
"setinputsizes($self, sizes, /)\n"
|
||||
"--\n"
|
||||
"\n"
|
||||
"Required by DB-API. Does nothing in pysqlite.");
|
||||
|
||||
#define PYSQLITE_CURSOR_SETINPUTSIZES_METHODDEF \
|
||||
{"setinputsizes", (PyCFunction)pysqlite_cursor_setinputsizes, METH_O, pysqlite_cursor_setinputsizes__doc__},
|
||||
|
||||
PyDoc_STRVAR(pysqlite_cursor_setoutputsize__doc__,
|
||||
"setoutputsize($self, size, column=None, /)\n"
|
||||
"--\n"
|
||||
"\n"
|
||||
"Required by DB-API. Does nothing in pysqlite.");
|
||||
|
||||
#define PYSQLITE_CURSOR_SETOUTPUTSIZE_METHODDEF \
|
||||
{"setoutputsize", (PyCFunction)(void(*)(void))pysqlite_cursor_setoutputsize, METH_FASTCALL, pysqlite_cursor_setoutputsize__doc__},
|
||||
|
||||
static PyObject *
|
||||
pysqlite_cursor_setoutputsize_impl(pysqlite_Cursor *self, PyObject *size,
|
||||
PyObject *column);
|
||||
|
||||
static PyObject *
|
||||
pysqlite_cursor_setoutputsize(pysqlite_Cursor *self, PyObject *const *args, Py_ssize_t nargs)
|
||||
{
|
||||
PyObject *return_value = NULL;
|
||||
PyObject *size;
|
||||
PyObject *column = Py_None;
|
||||
|
||||
if (!_PyArg_CheckPositional("setoutputsize", nargs, 1, 2)) {
|
||||
goto exit;
|
||||
}
|
||||
size = args[0];
|
||||
if (nargs < 2) {
|
||||
goto skip_optional;
|
||||
}
|
||||
column = args[1];
|
||||
skip_optional:
|
||||
return_value = pysqlite_cursor_setoutputsize_impl(self, size, column);
|
||||
|
||||
exit:
|
||||
return return_value;
|
||||
}
|
||||
|
||||
PyDoc_STRVAR(pysqlite_cursor_close__doc__,
|
||||
"close($self, /)\n"
|
||||
"--\n"
|
||||
"\n"
|
||||
"Closes the cursor.");
|
||||
|
||||
#define PYSQLITE_CURSOR_CLOSE_METHODDEF \
|
||||
{"close", (PyCFunction)pysqlite_cursor_close, METH_NOARGS, pysqlite_cursor_close__doc__},
|
||||
|
||||
static PyObject *
|
||||
pysqlite_cursor_close_impl(pysqlite_Cursor *self);
|
||||
|
||||
static PyObject *
|
||||
pysqlite_cursor_close(pysqlite_Cursor *self, PyObject *Py_UNUSED(ignored))
|
||||
{
|
||||
return pysqlite_cursor_close_impl(self);
|
||||
}
|
||||
/*[clinic end generated code: output=11db0de4fb1951a9 input=a9049054013a1b77]*/
|
||||
Loading…
Add table
Add a link
Reference in a new issue