API docs for “spamfighter.core.storage.dbm.DBMStorage”

Надежное хранилище ключей. Элементы хранилища хранятся в BDB (anydbm) базе данных на локальном диске. Поддерживается интерфейс expire-ключей (удаляемых по истечение некоторого времени).

Instance Variables db ссылка на базу данных anydbm

Method	__init__	Конструктор.
Method	set	Записать (перезаписать) значение ключа.
Method	get	Получить значения ключа.
Method	add	Добавить ключ в хранилище.
Method	append	Дописать в конец значения ключа еще один элемент.
Method	incr	Увеличить значение ключа на единицу (тип значения - целое число).
Method	delete	Удалить ключ из хранилища.
Method	_fetch	Получить значение ключа.

def __init__(self, dir, name): (source)

Конструктор.

Parameters	dir	подкаталог, в котором должны храниться файлы БД (type: `str` )
	name	имя БД (type: `str` )

def _fetch(self, key): (source)

Получить значение ключа.

Parameters	key	ключ (type: `str` )
Returns	пара (срок_годности, значение), если ключ есть в БД или (None, None), если он отсутствует

def set(self, key, value, expire): (source)

Записать (перезаписать) значение ключа.

Parameters	key	ключ (type: `str` )
	value	значение (type: `str` или `int` )
	expire	время жизни ключа в секундах, 0 - хранить "вечно" (type: `int` )
Returns	Deferred о завершении операции (type: `twisted.internet.Deferred` )

def get(self, key): (source)

Получить значения ключа.

Если ключ не найден (не существует, потерян, истекло время жизни), возвращается исключение KeyError.

Parameters	key	ключ (type: `str` )
Returns	Deferred значение ключа, `str` или `int` (type: `twisted.internet.Deferred` )

def add(self, key, value, expire): (source)

Добавить ключ в хранилище.

Операция аналогична set, но если ключ уже существует, будет возвращена ошибка KeyError.

Parameters	key	ключ (type: `str` )
	value	значение
	expire	время жизни ключа в секундах, 0 - хранить "вечно" (type: `int` )
Returns	Deferred о завершении операции (type: `twisted.internet.Deferred` )

def append(self, key, value): (source)

Дописать в конец значения ключа еще один элемент. Работает только над существующими ключами, если ключ не существует, будет возвращена ошибка KeyError.

Parameters	key	ключ (type: `str` )
	value	дописываемое значение
Returns	Deferred о завершении операции (type: `twisted.internet.Deferred` )

def incr(self, key, value=1): (source)

Увеличить значение ключа на единицу (тип значения - целое число). Работает только над существующими ключами, если ключ не существует, будет возвращена ошибка KeyError.

Parameters	key	ключ (type: `str` )
	value	величина инкремента (type: `int` )
Returns	Deferred с новым значением ключа, `int` (type: `twisted.internet.Deferred` )

def delete(self, key): (source)

Удалить ключ из хранилища.

Если ключ не найден, возвращается исключение KeyError.

Parameters	key	ключ (type: `str` )
Returns	Deferred о завершении операции (type: `twisted.internet.Deferred` )

Class s.c.s.d.DBMStorage(object):