MimicDB¶
The Python implementation of MimicDB works with the Boto library and several different backends including Redis.
Installation¶
By default, MimicDB requires Redis (although other backends can be used instead).
$ pip install boto
$ pip install redis
$ pip install mimicdb
Quickstart¶
If you’re using Boto already, replace boto imports with mimicdb imports.
Change:
from boto.s3.connection import S3Connection
from boto.s3.key import Key
To:
from mimicdb.s3.connection import S3Connection
from mimicdb.s3.key import Key
Additionally, import the MimicDB object itself, and initiate the backend:
from mimicdb import MimicDB
MimicDB()
After establishing a connection for the first time, sync the connection to save the metadata locally:
conn = S3Connection(KEY, SECRET)
conn.sync()
Or sync only a couple buckets from the connection:
conn.sync('bucket1', 'bucket2')
After that, upload, download and list as you usually would. API calls that can be responded to locally will return instantly without hitting S3 servers. API calls that are made to S3 using MimicDB will be mimicked locally to ensure consistency with the remote servers.
Pass force=True to most functions to force a call to the S3 API. This also updates the local database.