Skip to main content
Join the official Python Developers Survey 2018 and win valuable prizes: Start the survey!

A trivial, persistent, dictionary-like object, backed by SQLite.

Project description

Build Status

A trivial, persistent, dictionary-like object, backed by SQLite.

Installation

$ python setup.py install

Or just drop the permadict.py file into your package.

Usage

Basic usage:

>>> from permadict import Permadict
>>> d = Permadict("db.sqlite")
>>> d["key"] = "value"
>>> print(d["key"])
value

As a context manager:

>>> with Permadict("db.sqlite") as d:
...     d["something"] = 1.2345
...
>>> with Permadict("db.sqlite") as d:
...     print(d["something"])
...
1.2345

Iterating:

>>> d = Permadict("db.sqlite")
>>> for k, v in d.items():
...     print(k, v)
...
something 1.2345
>>> for key in d.keys():
...     print(key)
...
something

Deleting an item:

>>> del d["something"]

Clearing all items:

>>> d.clear()

Limitations

Keys must be strings. Values are stored as BLOB type after being pickled, so your Python objects must be picklable.

Permadict doesn’t act entirely like a dict: some methods are missing, whether that be on purpose (as with dict.copy) or simply due to negligence.

Motivation

I needed a way to share small amounts of data between processes. SQLite provides a safe way to do so. Also, why not?

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
permadict-1.0.1-py2.py3-none-any.whl (4.7 kB) Copy SHA256 hash SHA256 Wheel py2.py3 Mar 19, 2017

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page