Metadata-Version: 2.0
Name: shove-sqlalchemy
Version: 0.1.0
Summary: Common object storage frontend using SQLAlchemy
Home-page: https://bitbucket.org/lcrees/shove-sqlalchemy
Author: L. C. Rees
Author-email: lcrees@gmail.com
License: BSD
Keywords: object storage persistence database sqlalchemy rdms
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Topic :: Database :: Front-Ends
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Requires-Dist: shove (>=0.6.4)
Requires-Dist: sqlalchemy (>=0.4)

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

Currently supported storage backends are:

- Amazon S3 Web Service
- Apache Cassandra
- Berkeley Source Database
- DBM
- Durus
- FTP
- Filesystem
- Firebird
- git
- HDF5
- LevelDB
- Memory
- Mercurial
- Microsoft SQL Server
- MongoDB
- MySQL
- Oracle
- PostgreSQL
- Redis
- SQLite
- Subversion
- Zope Object Database (ZODB)

Currently supported caching backends are:

- Filesystem
- Firebird
- Memory
- Microsoft SQL Server
- MySQL
- Oracle
- PostgreSQL
- Redis
- SQLite
- memcache

The simplest *shove* use case is:

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

which creates an in-memory store and cache.

The 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* fully implements the Python dictionary/mapping API:

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

