dumbdbm — Портативная реализация DBM

Примечание

Модуль dumbdbm был переименован в dbm.dumb в Python 3. Инструмент 2to3 автоматически адаптирует импорты при преобразовании ваших исходников в Python 3.

Примечание

Модуль dumbdbm предназначен в качестве последнего варианта падения для модуля anydbm, когда нет более надёжного модуля. Модуль dumbdbm не написан для скорости и используется не так часто, как другие модули баз данных.

Модуль dumbdbm предоставляет интерфейс, похожий на словарь, сохраняемый исключительно в Python. В отличие от других модулей, таких как gdbm и bsddb, для его работы не требуется внешняя библиотека. Как и в других сохраняемых отображениях, ключи и значения должны всегда быть строками.

Модуль определяет следующее:

exception dumbdbm.error: Вызывается при ошибках, специфичных для dumbdbm, таких как ошибки ввода-вывода. KeyError вызывается при общих ошибках отображения, таких как указание некорректного ключа.

dumbdbm.open(filename[, flag[, mode]])

Открывает базу данных dumbdbm и возвращает объект dumbdbm. Аргумент filename — это имя файла базы данных (без расширений). При создании базы данных dumbdbm создаются файлы с расширениями .dat и .dir.

Опциональный аргумент flag в настоящее время игнорируется; база данных всегда открывается для обновления и создаётся, если она не существует.

Опциональный аргумент mode — это режим файла в Unix, используемый только при создании базы данных. По умолчанию он равен восьмеричному 0666 (и будет изменён текущим значением umask).

Изменено в версии 2.2: Аргумент mode игнорировался в предыдущих версиях.

В дополнение к методам, похожим на методы словаря, объекты dumbdm предоставляют следующий метод:

dumbdbm.close(): Закрывает базу данных dumbdm.

См. также

Module anydbm: Общий интерфейс к базам данных типа dbm.
Module dbm: Аналогичный интерфейс к библиотеке DBM/NDBM.
Module gdbm: Аналогичный интерфейс к библиотеке GNU GDBM.
Module shelve: Модуль сохранения объектов Python, хранящий данные, отличные от строк.
Module whichdb: Модуль-утилита, используемый для определения типа существующей базы данных.

1. Объекты Dumbdbm

В дополнение к методам, предоставляемым классом UserDict.DictMixin, объекты dumbdbm предоставляют следующие методы.

dumbdbm.sync(): Синхронизирует файлы каталога и данных на диске. Этот метод вызывается методом sync() объектов Shelve.