Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

An extensible key-value store backend for Django applications.

Project Description

An extensible key-value store backend for Django applications.

This module provides an abstraction layer for accessing a key-value storage.

Configuring your key-value store is a matter of adding a statement in this form to your Django settings module:

KEY_VALUE_STORE_BACKEND = 'scheme://store?parameters'

Where scheme is one of the following, persistent stores:

  • db (local table accessed through Django’s database connection)
  • googleappengine (Google AppEngine data store)
  • sdb (Amazon SimpleDB)
  • tokyotyrant (Tokyo Tyrant)

And some non-persistent stores, provided mainly for testing purposes:

  • locmem
  • memcached

store and parameters varies from one backend to another. Refer to the documentation included in each backend implementation for further details.

You can define a django_kvstore-backed custom model, in a fashion similar to Django models (although it does not support querying, except by primary key lookup).

Here’s an example of a custom model class using django_kvstore:

from django_kvstore import models

class MyData(models.Model):
    my_key = models.Field(pk=True)
    foo = models.Field()
    bar = models.Field()

Typical usage for such a model:

key = "something_unique"
data = MyData.get(key)
if data is None:
    data = MyData(my_key=key) = "foo" = "bar"

and deletion:

key = "something_unique"
data = MyData.get(key)
if data is not None:

Release History

This version
History Node


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
(7.1 kB) Copy SHA256 Hash SHA256
Source None Jan 26, 2010

Supported By

Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Kabu Creative Kabu Creative UX & Design Google Google Cloud Servers Fastly Fastly CDN StatusPage StatusPage Statuspage DigiCert DigiCert EV Certificate