| /* cache .c - a LRU cache | 
 |  * | 
 |  * Copyright (C) 2004-2010 Gerhard Häring <gh@ghaering.de> | 
 |  * | 
 |  * This file is part of pysqlite. | 
 |  * | 
 |  * This software is provided 'as-is', without any express or implied | 
 |  * warranty.  In no event will the authors be held liable for any damages | 
 |  * arising from the use of this software. | 
 |  * | 
 |  * Permission is granted to anyone to use this software for any purpose, | 
 |  * including commercial applications, and to alter it and redistribute it | 
 |  * freely, subject to the following restrictions: | 
 |  * | 
 |  * 1. The origin of this software must not be misrepresented; you must not | 
 |  *    claim that you wrote the original software. If you use this software | 
 |  *    in a product, an acknowledgment in the product documentation would be | 
 |  *    appreciated but is not required. | 
 |  * 2. Altered source versions must be plainly marked as such, and must not be | 
 |  *    misrepresented as being the original software. | 
 |  * 3. This notice may not be removed or altered from any source distribution. | 
 |  */ | 
 |  | 
 | #include "cache.h" | 
 | #include <limits.h> | 
 |  | 
 | /* only used internally */ | 
 | pysqlite_Node* pysqlite_new_node(PyObject* key, PyObject* data) | 
 | { | 
 |     pysqlite_Node* node; | 
 |  | 
 |     node = (pysqlite_Node*) (pysqlite_NodeType.tp_alloc(&pysqlite_NodeType, 0)); | 
 |     if (!node) { | 
 |         return NULL; | 
 |     } | 
 |  | 
 |     Py_INCREF(key); | 
 |     node->key = key; | 
 |  | 
 |     Py_INCREF(data); | 
 |     node->data = data; | 
 |  | 
 |     node->prev = NULL; | 
 |     node->next = NULL; | 
 |  | 
 |     return node; | 
 | } | 
 |  | 
 | void pysqlite_node_dealloc(pysqlite_Node* self) | 
 | { | 
 |     Py_DECREF(self->key); | 
 |     Py_DECREF(self->data); | 
 |  | 
 |     Py_TYPE(self)->tp_free((PyObject*)self); | 
 | } | 
 |  | 
 | int pysqlite_cache_init(pysqlite_Cache* self, PyObject* args, PyObject* kwargs) | 
 | { | 
 |     PyObject* factory; | 
 |     int size = 10; | 
 |  | 
 |     self->factory = NULL; | 
 |  | 
 |     if (!PyArg_ParseTuple(args, "O|i", &factory, &size)) { | 
 |         return -1; | 
 |     } | 
 |  | 
 |     /* minimum cache size is 5 entries */ | 
 |     if (size < 5) { | 
 |         size = 5; | 
 |     } | 
 |     self->size = size; | 
 |     self->first = NULL; | 
 |     self->last = NULL; | 
 |  | 
 |     self->mapping = PyDict_New(); | 
 |     if (!self->mapping) { | 
 |         return -1; | 
 |     } | 
 |  | 
 |     Py_INCREF(factory); | 
 |     self->factory = factory; | 
 |  | 
 |     self->decref_factory = 1; | 
 |  | 
 |     return 0; | 
 | } | 
 |  | 
 | void pysqlite_cache_dealloc(pysqlite_Cache* self) | 
 | { | 
 |     pysqlite_Node* node; | 
 |     pysqlite_Node* delete_node; | 
 |  | 
 |     if (!self->factory) { | 
 |         /* constructor failed, just get out of here */ | 
 |         return; | 
 |     } | 
 |  | 
 |     /* iterate over all nodes and deallocate them */ | 
 |     node = self->first; | 
 |     while (node) { | 
 |         delete_node = node; | 
 |         node = node->next; | 
 |         Py_DECREF(delete_node); | 
 |     } | 
 |  | 
 |     if (self->decref_factory) { | 
 |         Py_DECREF(self->factory); | 
 |     } | 
 |     Py_DECREF(self->mapping); | 
 |  | 
 |     Py_TYPE(self)->tp_free((PyObject*)self); | 
 | } | 
 |  | 
 | PyObject* pysqlite_cache_get(pysqlite_Cache* self, PyObject* args) | 
 | { | 
 |     PyObject* key = args; | 
 |     pysqlite_Node* node; | 
 |     pysqlite_Node* ptr; | 
 |     PyObject* data; | 
 |  | 
 |     node = (pysqlite_Node*)PyDict_GetItem(self->mapping, key); | 
 |     if (node) { | 
 |         /* an entry for this key already exists in the cache */ | 
 |  | 
 |         /* increase usage counter of the node found */ | 
 |         if (node->count < LONG_MAX) { | 
 |             node->count++; | 
 |         } | 
 |  | 
 |         /* if necessary, reorder entries in the cache by swapping positions */ | 
 |         if (node->prev && node->count > node->prev->count) { | 
 |             ptr = node->prev; | 
 |  | 
 |             while (ptr->prev && node->count > ptr->prev->count) { | 
 |                 ptr = ptr->prev; | 
 |             } | 
 |  | 
 |             if (node->next) { | 
 |                 node->next->prev = node->prev; | 
 |             } else { | 
 |                 self->last = node->prev; | 
 |             } | 
 |             if (node->prev) { | 
 |                 node->prev->next = node->next; | 
 |             } | 
 |             if (ptr->prev) { | 
 |                 ptr->prev->next = node; | 
 |             } else { | 
 |                 self->first = node; | 
 |             } | 
 |  | 
 |             node->next = ptr; | 
 |             node->prev = ptr->prev; | 
 |             if (!node->prev) { | 
 |                 self->first = node; | 
 |             } | 
 |             ptr->prev = node; | 
 |         } | 
 |     } else { | 
 |         /* There is no entry for this key in the cache, yet. We'll insert a new | 
 |          * entry in the cache, and make space if necessary by throwing the | 
 |          * least used item out of the cache. */ | 
 |  | 
 |         if (PyDict_Size(self->mapping) == self->size) { | 
 |             if (self->last) { | 
 |                 node = self->last; | 
 |  | 
 |                 if (PyDict_DelItem(self->mapping, self->last->key) != 0) { | 
 |                     return NULL; | 
 |                 } | 
 |  | 
 |                 if (node->prev) { | 
 |                     node->prev->next = NULL; | 
 |                 } | 
 |                 self->last = node->prev; | 
 |                 node->prev = NULL; | 
 |  | 
 |                 Py_DECREF(node); | 
 |             } | 
 |         } | 
 |  | 
 |         data = PyObject_CallFunction(self->factory, "O", key); | 
 |  | 
 |         if (!data) { | 
 |             return NULL; | 
 |         } | 
 |  | 
 |         node = pysqlite_new_node(key, data); | 
 |         if (!node) { | 
 |             return NULL; | 
 |         } | 
 |         node->prev = self->last; | 
 |  | 
 |         Py_DECREF(data); | 
 |  | 
 |         if (PyDict_SetItem(self->mapping, key, (PyObject*)node) != 0) { | 
 |             Py_DECREF(node); | 
 |             return NULL; | 
 |         } | 
 |  | 
 |         if (self->last) { | 
 |             self->last->next = node; | 
 |         } else { | 
 |             self->first = node; | 
 |         } | 
 |         self->last = node; | 
 |     } | 
 |  | 
 |     Py_INCREF(node->data); | 
 |     return node->data; | 
 | } | 
 |  | 
 | PyObject* pysqlite_cache_display(pysqlite_Cache* self, PyObject* args) | 
 | { | 
 |     pysqlite_Node* ptr; | 
 |     PyObject* prevkey; | 
 |     PyObject* nextkey; | 
 |     PyObject* display_str; | 
 |  | 
 |     ptr = self->first; | 
 |  | 
 |     while (ptr) { | 
 |         if (ptr->prev) { | 
 |             prevkey = ptr->prev->key; | 
 |         } else { | 
 |             prevkey = Py_None; | 
 |         } | 
 |  | 
 |         if (ptr->next) { | 
 |             nextkey = ptr->next->key; | 
 |         } else { | 
 |             nextkey = Py_None; | 
 |         } | 
 |  | 
 |         display_str = PyUnicode_FromFormat("%S <- %S -> %S\n", | 
 |                                            prevkey, ptr->key, nextkey); | 
 |         if (!display_str) { | 
 |             return NULL; | 
 |         } | 
 |         PyObject_Print(display_str, stdout, Py_PRINT_RAW); | 
 |         Py_DECREF(display_str); | 
 |  | 
 |         ptr = ptr->next; | 
 |     } | 
 |  | 
 |     Py_INCREF(Py_None); | 
 |     return Py_None; | 
 | } | 
 |  | 
 | static PyMethodDef cache_methods[] = { | 
 |     {"get", (PyCFunction)pysqlite_cache_get, METH_O, | 
 |         PyDoc_STR("Gets an entry from the cache or calls the factory function to produce one.")}, | 
 |     {"display", (PyCFunction)pysqlite_cache_display, METH_NOARGS, | 
 |         PyDoc_STR("For debugging only.")}, | 
 |     {NULL, NULL} | 
 | }; | 
 |  | 
 | PyTypeObject pysqlite_NodeType = { | 
 |         PyVarObject_HEAD_INIT(NULL, 0) | 
 |         MODULE_NAME "Node",                             /* tp_name */ | 
 |         sizeof(pysqlite_Node),                          /* tp_basicsize */ | 
 |         0,                                              /* tp_itemsize */ | 
 |         (destructor)pysqlite_node_dealloc,              /* tp_dealloc */ | 
 |         0,                                              /* tp_print */ | 
 |         0,                                              /* tp_getattr */ | 
 |         0,                                              /* tp_setattr */ | 
 |         0,                                              /* tp_reserved */ | 
 |         0,                                              /* tp_repr */ | 
 |         0,                                              /* tp_as_number */ | 
 |         0,                                              /* tp_as_sequence */ | 
 |         0,                                              /* tp_as_mapping */ | 
 |         0,                                              /* tp_hash */ | 
 |         0,                                              /* tp_call */ | 
 |         0,                                              /* tp_str */ | 
 |         0,                                              /* tp_getattro */ | 
 |         0,                                              /* tp_setattro */ | 
 |         0,                                              /* tp_as_buffer */ | 
 |         Py_TPFLAGS_DEFAULT|Py_TPFLAGS_BASETYPE,         /* tp_flags */ | 
 |         0,                                              /* tp_doc */ | 
 |         0,                                              /* tp_traverse */ | 
 |         0,                                              /* tp_clear */ | 
 |         0,                                              /* tp_richcompare */ | 
 |         0,                                              /* tp_weaklistoffset */ | 
 |         0,                                              /* tp_iter */ | 
 |         0,                                              /* tp_iternext */ | 
 |         0,                                              /* tp_methods */ | 
 |         0,                                              /* tp_members */ | 
 |         0,                                              /* tp_getset */ | 
 |         0,                                              /* tp_base */ | 
 |         0,                                              /* tp_dict */ | 
 |         0,                                              /* tp_descr_get */ | 
 |         0,                                              /* tp_descr_set */ | 
 |         0,                                              /* tp_dictoffset */ | 
 |         (initproc)0,                                    /* tp_init */ | 
 |         0,                                              /* tp_alloc */ | 
 |         0,                                              /* tp_new */ | 
 |         0                                               /* tp_free */ | 
 | }; | 
 |  | 
 | PyTypeObject pysqlite_CacheType = { | 
 |         PyVarObject_HEAD_INIT(NULL, 0) | 
 |         MODULE_NAME ".Cache",                           /* tp_name */ | 
 |         sizeof(pysqlite_Cache),                         /* tp_basicsize */ | 
 |         0,                                              /* tp_itemsize */ | 
 |         (destructor)pysqlite_cache_dealloc,             /* tp_dealloc */ | 
 |         0,                                              /* tp_print */ | 
 |         0,                                              /* tp_getattr */ | 
 |         0,                                              /* tp_setattr */ | 
 |         0,                                              /* tp_reserved */ | 
 |         0,                                              /* tp_repr */ | 
 |         0,                                              /* tp_as_number */ | 
 |         0,                                              /* tp_as_sequence */ | 
 |         0,                                              /* tp_as_mapping */ | 
 |         0,                                              /* tp_hash */ | 
 |         0,                                              /* tp_call */ | 
 |         0,                                              /* tp_str */ | 
 |         0,                                              /* tp_getattro */ | 
 |         0,                                              /* tp_setattro */ | 
 |         0,                                              /* tp_as_buffer */ | 
 |         Py_TPFLAGS_DEFAULT|Py_TPFLAGS_BASETYPE,         /* tp_flags */ | 
 |         0,                                              /* tp_doc */ | 
 |         0,                                              /* tp_traverse */ | 
 |         0,                                              /* tp_clear */ | 
 |         0,                                              /* tp_richcompare */ | 
 |         0,                                              /* tp_weaklistoffset */ | 
 |         0,                                              /* tp_iter */ | 
 |         0,                                              /* tp_iternext */ | 
 |         cache_methods,                                  /* tp_methods */ | 
 |         0,                                              /* tp_members */ | 
 |         0,                                              /* tp_getset */ | 
 |         0,                                              /* tp_base */ | 
 |         0,                                              /* tp_dict */ | 
 |         0,                                              /* tp_descr_get */ | 
 |         0,                                              /* tp_descr_set */ | 
 |         0,                                              /* tp_dictoffset */ | 
 |         (initproc)pysqlite_cache_init,                  /* tp_init */ | 
 |         0,                                              /* tp_alloc */ | 
 |         0,                                              /* tp_new */ | 
 |         0                                               /* tp_free */ | 
 | }; | 
 |  | 
 | extern int pysqlite_cache_setup_types(void) | 
 | { | 
 |     int rc; | 
 |  | 
 |     pysqlite_NodeType.tp_new = PyType_GenericNew; | 
 |     pysqlite_CacheType.tp_new = PyType_GenericNew; | 
 |  | 
 |     rc = PyType_Ready(&pysqlite_NodeType); | 
 |     if (rc < 0) { | 
 |         return rc; | 
 |     } | 
 |  | 
 |     rc = PyType_Ready(&pysqlite_CacheType); | 
 |     return rc; | 
 | } |