2015-04-17 15:05:18 -03:00
|
|
|
/*[clinic input]
|
|
|
|
preserve
|
|
|
|
[clinic start generated code]*/
|
|
|
|
|
|
|
|
PyDoc_STRVAR(_gdbm_gdbm_get__doc__,
|
|
|
|
"get($self, key, default=None, /)\n"
|
|
|
|
"--\n"
|
|
|
|
"\n"
|
|
|
|
"Get the value for key, or default if not present.");
|
|
|
|
|
|
|
|
#define _GDBM_GDBM_GET_METHODDEF \
|
2022-05-03 15:25:41 -03:00
|
|
|
{"get", _PyCFunction_CAST(_gdbm_gdbm_get), METH_FASTCALL, _gdbm_gdbm_get__doc__},
|
2015-04-17 15:05:18 -03:00
|
|
|
|
|
|
|
static PyObject *
|
2020-06-16 13:41:23 -03:00
|
|
|
_gdbm_gdbm_get_impl(gdbmobject *self, PyObject *key, PyObject *default_value);
|
2015-04-17 15:05:18 -03:00
|
|
|
|
|
|
|
static PyObject *
|
2020-06-16 13:41:23 -03:00
|
|
|
_gdbm_gdbm_get(gdbmobject *self, PyObject *const *args, Py_ssize_t nargs)
|
2015-04-17 15:05:18 -03:00
|
|
|
{
|
|
|
|
PyObject *return_value = NULL;
|
|
|
|
PyObject *key;
|
|
|
|
PyObject *default_value = Py_None;
|
|
|
|
|
2019-01-11 12:01:42 -04:00
|
|
|
if (!_PyArg_CheckPositional("get", nargs, 1, 2)) {
|
2017-01-16 21:21:47 -04:00
|
|
|
goto exit;
|
|
|
|
}
|
2019-01-11 12:01:42 -04:00
|
|
|
key = args[0];
|
|
|
|
if (nargs < 2) {
|
|
|
|
goto skip_optional;
|
|
|
|
}
|
|
|
|
default_value = args[1];
|
|
|
|
skip_optional:
|
2015-04-17 15:05:18 -03:00
|
|
|
return_value = _gdbm_gdbm_get_impl(self, key, default_value);
|
|
|
|
|
|
|
|
exit:
|
|
|
|
return return_value;
|
|
|
|
}
|
|
|
|
|
|
|
|
PyDoc_STRVAR(_gdbm_gdbm_setdefault__doc__,
|
|
|
|
"setdefault($self, key, default=None, /)\n"
|
|
|
|
"--\n"
|
|
|
|
"\n"
|
|
|
|
"Get value for key, or set it to default and return default if not present.");
|
|
|
|
|
|
|
|
#define _GDBM_GDBM_SETDEFAULT_METHODDEF \
|
2022-05-03 15:25:41 -03:00
|
|
|
{"setdefault", _PyCFunction_CAST(_gdbm_gdbm_setdefault), METH_FASTCALL, _gdbm_gdbm_setdefault__doc__},
|
2015-04-17 15:05:18 -03:00
|
|
|
|
|
|
|
static PyObject *
|
2020-06-16 13:41:23 -03:00
|
|
|
_gdbm_gdbm_setdefault_impl(gdbmobject *self, PyObject *key,
|
2015-04-17 15:05:18 -03:00
|
|
|
PyObject *default_value);
|
|
|
|
|
|
|
|
static PyObject *
|
2020-06-16 13:41:23 -03:00
|
|
|
_gdbm_gdbm_setdefault(gdbmobject *self, PyObject *const *args, Py_ssize_t nargs)
|
2015-04-17 15:05:18 -03:00
|
|
|
{
|
|
|
|
PyObject *return_value = NULL;
|
|
|
|
PyObject *key;
|
|
|
|
PyObject *default_value = Py_None;
|
|
|
|
|
2019-01-11 12:01:42 -04:00
|
|
|
if (!_PyArg_CheckPositional("setdefault", nargs, 1, 2)) {
|
2017-01-16 21:21:47 -04:00
|
|
|
goto exit;
|
|
|
|
}
|
2019-01-11 12:01:42 -04:00
|
|
|
key = args[0];
|
|
|
|
if (nargs < 2) {
|
|
|
|
goto skip_optional;
|
|
|
|
}
|
|
|
|
default_value = args[1];
|
|
|
|
skip_optional:
|
2015-04-17 15:05:18 -03:00
|
|
|
return_value = _gdbm_gdbm_setdefault_impl(self, key, default_value);
|
|
|
|
|
|
|
|
exit:
|
|
|
|
return return_value;
|
|
|
|
}
|
|
|
|
|
|
|
|
PyDoc_STRVAR(_gdbm_gdbm_close__doc__,
|
|
|
|
"close($self, /)\n"
|
|
|
|
"--\n"
|
|
|
|
"\n"
|
|
|
|
"Close the database.");
|
|
|
|
|
|
|
|
#define _GDBM_GDBM_CLOSE_METHODDEF \
|
|
|
|
{"close", (PyCFunction)_gdbm_gdbm_close, METH_NOARGS, _gdbm_gdbm_close__doc__},
|
|
|
|
|
|
|
|
static PyObject *
|
2020-06-16 13:41:23 -03:00
|
|
|
_gdbm_gdbm_close_impl(gdbmobject *self);
|
2015-04-17 15:05:18 -03:00
|
|
|
|
|
|
|
static PyObject *
|
2020-06-16 13:41:23 -03:00
|
|
|
_gdbm_gdbm_close(gdbmobject *self, PyObject *Py_UNUSED(ignored))
|
2015-04-17 15:05:18 -03:00
|
|
|
{
|
|
|
|
return _gdbm_gdbm_close_impl(self);
|
|
|
|
}
|
|
|
|
|
|
|
|
PyDoc_STRVAR(_gdbm_gdbm_keys__doc__,
|
|
|
|
"keys($self, /)\n"
|
|
|
|
"--\n"
|
|
|
|
"\n"
|
|
|
|
"Get a list of all keys in the database.");
|
|
|
|
|
|
|
|
#define _GDBM_GDBM_KEYS_METHODDEF \
|
2022-05-03 15:25:41 -03:00
|
|
|
{"keys", _PyCFunction_CAST(_gdbm_gdbm_keys), METH_METHOD|METH_FASTCALL|METH_KEYWORDS, _gdbm_gdbm_keys__doc__},
|
2015-04-17 15:05:18 -03:00
|
|
|
|
|
|
|
static PyObject *
|
2020-06-16 13:41:23 -03:00
|
|
|
_gdbm_gdbm_keys_impl(gdbmobject *self, PyTypeObject *cls);
|
2015-04-17 15:05:18 -03:00
|
|
|
|
|
|
|
static PyObject *
|
2020-06-16 13:41:23 -03:00
|
|
|
_gdbm_gdbm_keys(gdbmobject *self, PyTypeObject *cls, PyObject *const *args, Py_ssize_t nargs, PyObject *kwnames)
|
2015-04-17 15:05:18 -03:00
|
|
|
{
|
2022-04-30 07:15:02 -03:00
|
|
|
if (nargs) {
|
|
|
|
PyErr_SetString(PyExc_TypeError, "keys() takes no arguments");
|
|
|
|
return NULL;
|
2020-06-16 13:41:23 -03:00
|
|
|
}
|
2022-04-30 07:15:02 -03:00
|
|
|
return _gdbm_gdbm_keys_impl(self, cls);
|
2015-04-17 15:05:18 -03:00
|
|
|
}
|
|
|
|
|
|
|
|
PyDoc_STRVAR(_gdbm_gdbm_firstkey__doc__,
|
|
|
|
"firstkey($self, /)\n"
|
|
|
|
"--\n"
|
|
|
|
"\n"
|
|
|
|
"Return the starting key for the traversal.\n"
|
|
|
|
"\n"
|
|
|
|
"It\'s possible to loop over every key in the database using this method\n"
|
|
|
|
"and the nextkey() method. The traversal is ordered by GDBM\'s internal\n"
|
|
|
|
"hash values, and won\'t be sorted by the key values.");
|
|
|
|
|
|
|
|
#define _GDBM_GDBM_FIRSTKEY_METHODDEF \
|
2022-05-03 15:25:41 -03:00
|
|
|
{"firstkey", _PyCFunction_CAST(_gdbm_gdbm_firstkey), METH_METHOD|METH_FASTCALL|METH_KEYWORDS, _gdbm_gdbm_firstkey__doc__},
|
2015-04-17 15:05:18 -03:00
|
|
|
|
|
|
|
static PyObject *
|
2020-06-16 13:41:23 -03:00
|
|
|
_gdbm_gdbm_firstkey_impl(gdbmobject *self, PyTypeObject *cls);
|
2015-04-17 15:05:18 -03:00
|
|
|
|
|
|
|
static PyObject *
|
2020-06-16 13:41:23 -03:00
|
|
|
_gdbm_gdbm_firstkey(gdbmobject *self, PyTypeObject *cls, PyObject *const *args, Py_ssize_t nargs, PyObject *kwnames)
|
2015-04-17 15:05:18 -03:00
|
|
|
{
|
2022-04-30 07:15:02 -03:00
|
|
|
if (nargs) {
|
|
|
|
PyErr_SetString(PyExc_TypeError, "firstkey() takes no arguments");
|
|
|
|
return NULL;
|
2020-06-16 13:41:23 -03:00
|
|
|
}
|
2022-04-30 07:15:02 -03:00
|
|
|
return _gdbm_gdbm_firstkey_impl(self, cls);
|
2015-04-17 15:05:18 -03:00
|
|
|
}
|
|
|
|
|
|
|
|
PyDoc_STRVAR(_gdbm_gdbm_nextkey__doc__,
|
|
|
|
"nextkey($self, key, /)\n"
|
|
|
|
"--\n"
|
|
|
|
"\n"
|
|
|
|
"Returns the key that follows key in the traversal.\n"
|
|
|
|
"\n"
|
|
|
|
"The following code prints every key in the database db, without having\n"
|
|
|
|
"to create a list in memory that contains them all:\n"
|
|
|
|
"\n"
|
|
|
|
" k = db.firstkey()\n"
|
2021-08-31 10:59:52 -03:00
|
|
|
" while k is not None:\n"
|
2015-04-17 15:05:18 -03:00
|
|
|
" print(k)\n"
|
|
|
|
" k = db.nextkey(k)");
|
|
|
|
|
|
|
|
#define _GDBM_GDBM_NEXTKEY_METHODDEF \
|
2022-05-03 15:25:41 -03:00
|
|
|
{"nextkey", _PyCFunction_CAST(_gdbm_gdbm_nextkey), METH_METHOD|METH_FASTCALL|METH_KEYWORDS, _gdbm_gdbm_nextkey__doc__},
|
2015-04-17 15:05:18 -03:00
|
|
|
|
|
|
|
static PyObject *
|
2020-06-16 13:41:23 -03:00
|
|
|
_gdbm_gdbm_nextkey_impl(gdbmobject *self, PyTypeObject *cls, const char *key,
|
2021-05-07 22:17:37 -03:00
|
|
|
Py_ssize_t key_length);
|
2015-04-17 15:05:18 -03:00
|
|
|
|
|
|
|
static PyObject *
|
2020-06-16 13:41:23 -03:00
|
|
|
_gdbm_gdbm_nextkey(gdbmobject *self, PyTypeObject *cls, PyObject *const *args, Py_ssize_t nargs, PyObject *kwnames)
|
2015-04-17 15:05:18 -03:00
|
|
|
{
|
|
|
|
PyObject *return_value = NULL;
|
2020-06-16 13:41:23 -03:00
|
|
|
static const char * const _keywords[] = {"", NULL};
|
|
|
|
static _PyArg_Parser _parser = {"s#:nextkey", _keywords, 0};
|
2015-04-17 15:05:18 -03:00
|
|
|
const char *key;
|
2021-05-07 22:17:37 -03:00
|
|
|
Py_ssize_t key_length;
|
2015-04-17 15:05:18 -03:00
|
|
|
|
2020-06-16 13:41:23 -03:00
|
|
|
if (!_PyArg_ParseStackAndKeywords(args, nargs, kwnames, &_parser,
|
|
|
|
&key, &key_length)) {
|
2015-04-17 15:05:18 -03:00
|
|
|
goto exit;
|
2016-06-09 10:16:06 -03:00
|
|
|
}
|
2020-06-16 13:41:23 -03:00
|
|
|
return_value = _gdbm_gdbm_nextkey_impl(self, cls, key, key_length);
|
2015-04-17 15:05:18 -03:00
|
|
|
|
|
|
|
exit:
|
|
|
|
return return_value;
|
|
|
|
}
|
|
|
|
|
|
|
|
PyDoc_STRVAR(_gdbm_gdbm_reorganize__doc__,
|
|
|
|
"reorganize($self, /)\n"
|
|
|
|
"--\n"
|
|
|
|
"\n"
|
|
|
|
"Reorganize the database.\n"
|
|
|
|
"\n"
|
|
|
|
"If you have carried out a lot of deletions and would like to shrink\n"
|
|
|
|
"the space used by the GDBM file, this routine will reorganize the\n"
|
|
|
|
"database. GDBM will not shorten the length of a database file except\n"
|
|
|
|
"by using this reorganization; otherwise, deleted file space will be\n"
|
|
|
|
"kept and reused as new (key,value) pairs are added.");
|
|
|
|
|
|
|
|
#define _GDBM_GDBM_REORGANIZE_METHODDEF \
|
2022-05-03 15:25:41 -03:00
|
|
|
{"reorganize", _PyCFunction_CAST(_gdbm_gdbm_reorganize), METH_METHOD|METH_FASTCALL|METH_KEYWORDS, _gdbm_gdbm_reorganize__doc__},
|
2015-04-17 15:05:18 -03:00
|
|
|
|
|
|
|
static PyObject *
|
2020-06-16 13:41:23 -03:00
|
|
|
_gdbm_gdbm_reorganize_impl(gdbmobject *self, PyTypeObject *cls);
|
2015-04-17 15:05:18 -03:00
|
|
|
|
|
|
|
static PyObject *
|
2020-06-16 13:41:23 -03:00
|
|
|
_gdbm_gdbm_reorganize(gdbmobject *self, PyTypeObject *cls, PyObject *const *args, Py_ssize_t nargs, PyObject *kwnames)
|
2015-04-17 15:05:18 -03:00
|
|
|
{
|
2022-04-30 07:15:02 -03:00
|
|
|
if (nargs) {
|
|
|
|
PyErr_SetString(PyExc_TypeError, "reorganize() takes no arguments");
|
|
|
|
return NULL;
|
2020-06-16 13:41:23 -03:00
|
|
|
}
|
2022-04-30 07:15:02 -03:00
|
|
|
return _gdbm_gdbm_reorganize_impl(self, cls);
|
2015-04-17 15:05:18 -03:00
|
|
|
}
|
|
|
|
|
|
|
|
PyDoc_STRVAR(_gdbm_gdbm_sync__doc__,
|
|
|
|
"sync($self, /)\n"
|
|
|
|
"--\n"
|
|
|
|
"\n"
|
|
|
|
"Flush the database to the disk file.\n"
|
|
|
|
"\n"
|
|
|
|
"When the database has been opened in fast mode, this method forces\n"
|
|
|
|
"any unwritten data to be written to the disk.");
|
|
|
|
|
|
|
|
#define _GDBM_GDBM_SYNC_METHODDEF \
|
2022-05-03 15:25:41 -03:00
|
|
|
{"sync", _PyCFunction_CAST(_gdbm_gdbm_sync), METH_METHOD|METH_FASTCALL|METH_KEYWORDS, _gdbm_gdbm_sync__doc__},
|
2015-04-17 15:05:18 -03:00
|
|
|
|
|
|
|
static PyObject *
|
2020-06-16 13:41:23 -03:00
|
|
|
_gdbm_gdbm_sync_impl(gdbmobject *self, PyTypeObject *cls);
|
2015-04-17 15:05:18 -03:00
|
|
|
|
|
|
|
static PyObject *
|
2020-06-16 13:41:23 -03:00
|
|
|
_gdbm_gdbm_sync(gdbmobject *self, PyTypeObject *cls, PyObject *const *args, Py_ssize_t nargs, PyObject *kwnames)
|
2015-04-17 15:05:18 -03:00
|
|
|
{
|
2022-04-30 07:15:02 -03:00
|
|
|
if (nargs) {
|
|
|
|
PyErr_SetString(PyExc_TypeError, "sync() takes no arguments");
|
|
|
|
return NULL;
|
2020-06-16 13:41:23 -03:00
|
|
|
}
|
2022-04-30 07:15:02 -03:00
|
|
|
return _gdbm_gdbm_sync_impl(self, cls);
|
2015-04-17 15:05:18 -03:00
|
|
|
}
|
|
|
|
|
|
|
|
PyDoc_STRVAR(dbmopen__doc__,
|
|
|
|
"open($module, filename, flags=\'r\', mode=0o666, /)\n"
|
|
|
|
"--\n"
|
|
|
|
"\n"
|
|
|
|
"Open a dbm database and return a dbm object.\n"
|
|
|
|
"\n"
|
|
|
|
"The filename argument is the name of the database file.\n"
|
|
|
|
"\n"
|
|
|
|
"The optional flags argument can be \'r\' (to open an existing database\n"
|
|
|
|
"for reading only -- default), \'w\' (to open an existing database for\n"
|
|
|
|
"reading and writing), \'c\' (which creates the database if it doesn\'t\n"
|
|
|
|
"exist), or \'n\' (which always creates a new empty database).\n"
|
|
|
|
"\n"
|
|
|
|
"Some versions of gdbm support additional flags which must be\n"
|
|
|
|
"appended to one of the flags described above. The module constant\n"
|
|
|
|
"\'open_flags\' is a string of valid additional flags. The \'f\' flag\n"
|
|
|
|
"opens the database in fast mode; altered data will not automatically\n"
|
|
|
|
"be written to the disk after every change. This results in faster\n"
|
|
|
|
"writes to the database, but may result in an inconsistent database\n"
|
|
|
|
"if the program crashes while the database is still open. Use the\n"
|
|
|
|
"sync() method to force any unwritten data to be written to the disk.\n"
|
|
|
|
"The \'s\' flag causes all database operations to be synchronized to\n"
|
|
|
|
"disk. The \'u\' flag disables locking of the database file.\n"
|
|
|
|
"\n"
|
|
|
|
"The optional mode argument is the Unix mode of the file, used only\n"
|
|
|
|
"when the database has to be created. It defaults to octal 0o666.");
|
|
|
|
|
|
|
|
#define DBMOPEN_METHODDEF \
|
2022-05-03 15:25:41 -03:00
|
|
|
{"open", _PyCFunction_CAST(dbmopen), METH_FASTCALL, dbmopen__doc__},
|
2015-04-17 15:05:18 -03:00
|
|
|
|
|
|
|
static PyObject *
|
2018-02-26 10:02:22 -04:00
|
|
|
dbmopen_impl(PyObject *module, PyObject *filename, const char *flags,
|
|
|
|
int mode);
|
2015-04-17 15:05:18 -03:00
|
|
|
|
|
|
|
static PyObject *
|
2017-12-15 07:11:11 -04:00
|
|
|
dbmopen(PyObject *module, PyObject *const *args, Py_ssize_t nargs)
|
2015-04-17 15:05:18 -03:00
|
|
|
{
|
|
|
|
PyObject *return_value = NULL;
|
2018-02-26 10:02:22 -04:00
|
|
|
PyObject *filename;
|
2015-04-17 15:05:18 -03:00
|
|
|
const char *flags = "r";
|
|
|
|
int mode = 438;
|
|
|
|
|
2019-01-11 10:01:14 -04:00
|
|
|
if (!_PyArg_CheckPositional("open", nargs, 1, 3)) {
|
2017-01-16 20:35:17 -04:00
|
|
|
goto exit;
|
|
|
|
}
|
2019-01-11 10:01:14 -04:00
|
|
|
filename = args[0];
|
|
|
|
if (nargs < 2) {
|
|
|
|
goto skip_optional;
|
|
|
|
}
|
|
|
|
if (!PyUnicode_Check(args[1])) {
|
2019-08-29 11:49:08 -03:00
|
|
|
_PyArg_BadArgument("open", "argument 2", "str", args[1]);
|
2019-01-11 10:01:14 -04:00
|
|
|
goto exit;
|
|
|
|
}
|
|
|
|
Py_ssize_t flags_length;
|
|
|
|
flags = PyUnicode_AsUTF8AndSize(args[1], &flags_length);
|
|
|
|
if (flags == NULL) {
|
|
|
|
goto exit;
|
|
|
|
}
|
|
|
|
if (strlen(flags) != (size_t)flags_length) {
|
|
|
|
PyErr_SetString(PyExc_ValueError, "embedded null character");
|
|
|
|
goto exit;
|
|
|
|
}
|
|
|
|
if (nargs < 3) {
|
|
|
|
goto skip_optional;
|
|
|
|
}
|
|
|
|
mode = _PyLong_AsInt(args[2]);
|
|
|
|
if (mode == -1 && PyErr_Occurred()) {
|
|
|
|
goto exit;
|
|
|
|
}
|
|
|
|
skip_optional:
|
2018-02-26 10:02:22 -04:00
|
|
|
return_value = dbmopen_impl(module, filename, flags, mode);
|
2015-04-17 15:05:18 -03:00
|
|
|
|
|
|
|
exit:
|
|
|
|
return return_value;
|
|
|
|
}
|
2022-05-03 15:25:41 -03:00
|
|
|
/*[clinic end generated code: output=617117d16956ac4d input=a9049054013a1b77]*/
|