{"id":8122,"date":"2021-02-09T10:03:42","date_gmt":"2021-02-09T04:33:42","guid":{"rendered":"http:\/\/www.pythonpool.com\/?p=8122"},"modified":"2026-07-13T12:31:36","modified_gmt":"2026-07-13T07:01:36","slug":"python-shelve","status":"publish","type":"post","link":"https:\/\/www.pythonpool.com\/python-shelve\/","title":{"rendered":"Python shelve: Persistent Dictionary Storage and Safety"},"content":{"rendered":"

Quick answer:<\/strong> shelve provides a persistent dictionary-like interface with string keys and pickle-serialized values. It is convenient for small local, single-user data, but dbm backend differences, concurrent writes, portability, and pickle trust limits make a real database the better choice for shared or transactional systems.<\/p>\n

\"Python
shelve behaves like a persistent dictionary, but its dbm backend and pickle values make concurrency, portability, and trust boundaries important.<\/figcaption><\/figure>\n

Python shelve<\/code> gives you a persistent dictionary for small local programs. It stores string keys and Python objects on disk, so a later run can open the same shelf and read the saved values back.<\/p>\n

The module is useful when plain text is too awkward and a full database would be extra work. A command-line tool, local cache, learning project, or one-user desktop script can often use a shelf for settings, counters, lightweight records, or computed results.<\/p>\n

A shelf is not a server database. It is backed by dbm<\/code> and serializes values with pickle<\/code>. That means it is simple and convenient, but it also inherits backend limits, platform differences, and the usual warning about loading pickled data only from trusted sources.<\/p>\n

The official Python documentation covers the shelve module<\/a>, the underlying dbm interfaces<\/a>, and the pickle module<\/a>.<\/p>\n

Use shelve<\/code> when the data naturally behaves like a mapping. Each key must be a string. Each value must be pickleable. If you need SQL queries, concurrent writers, transactions, remote access, or transparent data sharing across languages, choose SQLite, PostgreSQL, Redis, or another storage system instead.<\/p>\n

\n
\n

Contents<\/p>\nToggle<\/span><\/path><\/svg><\/svg><\/span><\/span><\/span><\/a><\/span><\/div>\n