Metadata-Version: 2.1
Name: shove
Version: 0.6.6
Summary: Generic dictionaryish object storage frontend
Home-page: https://bitbucket.org/lcrees/shove/
Author: L. C. Rees
Author-email: lcrees@gmail.com
License: BSD
Keywords: object storage persistence database dictionary
Classifier: Development Status :: 4 - Beta
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Topic :: Database :: Front-Ends
Classifier: Topic :: Software Development :: Libraries
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Framework :: Setuptools Plugin
License-File: LICENSE

Common object storage frontend that supports
dictionary-style access, object serialization
and compression, and multiple storage and caching
backends.

Supported storage backends out of the box are:

- DBM
- Filesystem
- Memory
- sqlite (disk or memory)

Current supported caching backends are:

- Filesystem
- Memory
- sqlite (disk or memory)

The simplest *shove* use case...

>>> from shove import Shove
>>> store = Shove()

...which creates an in-memory store and cache.

Use of other backends for storage and caching involves
passing an module URI or existing store or cache instance
to *shove* following the form:

>>> from shove import Shove
>>> <storename> = Shove(<store_uri>, <cache_uri>)

Each module-specific URI form is documented in its module. The
URI form follows the URI form used by SQLAlchemy:

    http://www.sqlalchemy.org/docs/core/engines.html

*shove* implements the Python dictionary/mapping API:

    http://docs.python.org/lib/typesmapping.html
