A persistent, full-text searchable key-value store. Powered by Flask, ElasticSearch, S3, and good intentions.
Python
Latest commit ae575ab Jan 23, 2017 @kennethreitz committed on GitHub Merge pull request #19 from drewrey/remove_paywall
Remove reference to paywall in delete_record
Permalink
Failed to load latest commit information.
.gitignore always ignore t.py Mar 31, 2013
Procfile working Jan 15, 2017
README.rst update readme Jan 15, 2017
elephant.py Remove reference to paywall in delete_record Jan 24, 2017
requirements.txt gunicorn Jan 15, 2017

README.rst

Elephant

Elephant is an S3-backed key-value store with querying powered by Elastic Search. Your data is persisted on S3 as simple JSON documents, but you can instantly query it over HTTP.

Suddenly, your data becomes as durable as S3, as portable as JSON, and as queryable as HTTP. Enjoy!

Usage

>>> requests.post('http://elephant-server/', data={'title': 'Test Page', 'draft': True})
<Response [200]>

>>> requests.get('http://elephant-server/', params={'q': 'draft:True'}).json()
{u'records': [{u'epoch': 1364286524987, u'title': u'Test Page', u'uuid': u'ce251e8a-ab6b-4f7e-bdc4-eecf0e71ac16'}}

Configuration

Elephant expects the following environment variables to be set:

# AWS Credentials
BYODEMO_BUCKET_NAME = xxxxxx
BYODEMO_AWS_ACCESS_KEY_ID = xxxxxx
BYODEMO_AWS_SECRET_ACCESS_KEY = xxxxxx

# Elastic Search Server
FOUNDELASTICSEARCH_URL = xxxxxx
ES_PASSWORD = xxxxxx

If you need a production Elastic Search instance, checkout searchly and heroku-elasticsearch.

Management

Reseeding ElasticSearch is super simple:

$ python elephant.py seed
Creating Index...
Indexing...
[####                            ] 29/378

Inspiration

Extracted out of the in-progress blackbox project.