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

Elasticsearch data layer for eve rest framework

Project Description

Eve-Elastic is elasticsearch data layer for eve REST framework.

Features

  • fulltext search
  • filtering via elasticsearch filter dsl
  • facets support
  • aggregations support
  • elasticsearch mapping generator for schema

License

Eve-Elastic is GPLv3 licensed.

Supported elastic versions

It supports 1.7 and 2.x versions. If you limit your queries to those which work with both you can have single codebase for both.

Install

$ pip install Eve-Elastic

Usage

Set elastic as your eve data layer.

import eve
from eve_elastic import Elastic

app = eve.Eve(data=Elastic)
app.run()

Config

There are 2 options for Eve-Elastic taken from app.config:

  • ELASTICSEARCH_URL (default: 'http://localhost:9200/') - this can be either single url or list of urls
  • ELASTICSEARCH_INDEX - (default: 'eve')
  • ELASTICSEARCH_INDEXES - (default: {}) - resource to index mapping
  • ELASTICSEARCH_FORCE_REFRESH - (default: True) - force index refresh after every modification
  • ELASTICSEARCH_AUTO_AGGREGATIONS - (default: True) - return aggregates on every search if configured for resource

Query params

Eve-Elastic supports eve like queries via where param which work as term filter.

On top of this, there is a predefined query_string query which does fulltext search.

$ curl http://localhost:5000/items?q=foo&df=name
  • q - query (default: *)
  • df - default field (default: _all)

Filtering

For more sophisticated filtering, you can use filter query param which will be used as filter for the query, using elastic filter dsl.

Facets

To add a facets support for specific resource, add facets into its datasource:

DOMAIN = {
    'contacts': {
        'datasource':
            'facets': {
                'urgency': {'terms': {'field': 'urgency'}},
                'versioncreated': {'date_histogram': {'field': 'versioncreated', 'interval': 'hour'}}
            }
        }
    }

You will find more info about facets in elasticsearch docs.

Changelog

2.4 (2017-08-02)

  • add support for kwargs to remove (by Luis Fernando Gomes)

2.3 (2017-07-27)

  • add support for parent-child relations.

2.2 (2017-07-21)

  • add ELASTICSEARCH_RETRY_ON_CONFLICT setting

2.1 (2017-03-27)

  • support es_highlight to be a callback.

2.0 (2017-02-03)

  • add support for elastic 2

0.6 (2016-11-16)

  • handle projections
  • parse dates using ciso8601

0.5.2 (2016-11-15)

  • make serializer configurable again

0.5 (2016-11-14)

  • allow list of urls to be set in ELASTICSEARCH_URL
  • add support for where param
  • handle bson.ObjectId serialization

0.4.1 (2016-11-08)

  • fix init_index on versions endpoints

0.4 (2016-11-03)

  • implement elastic_prefix resource config similar to mongo_prefix in eve
  • change init_app behaviour - it won’t call init_index anymore, it must be called explicitly

0.3.8 (2016-08-05)

  • add search highlights config
  • fix aggregations request trigger parsing

0.3.7 (2016-04-13)

  • fix search when there is no request.args

0.3.6 (2016-03-21)

  • fix find_one with multi term lookup

0.3.5 (2016-03-17)

  • add skip_index_init param to Elastic

0.3.4 (2016-03-17)

  • make init_index put mapping always, no matter if index is there already

0.3.3 (2016-03-15)

  • introduce init_index method to create index and put mapping

0.3.2 (2016-02-11)

  • introduce ELASTICSEARCH_AUTO_AGGREGATIONS config option

0.3.1 (2016-02-11)

  • introduce ELASTICSEARCH_FORCE_REFRESH settings that is True by default
  • fix for ELASTICSEARCH_INDEXES when using datasource.source config

0.3.0 (2016-02-08)

  • introduce ELASTICSEARCH_INDEXES settings for setting different index per resource

0.2.21 (2015-11-20)

  • try to put settings in case put mapping is failing

0.2.20 (2015-11-16)

  • make it possible to specify index settings (by Mayur Dhamanwala)

0.2.19 (2015-09-29)

  • use ELASTICSEARCH_URL value as is so that it works with auth and https

0.2.18 (2015-08-12)

  • throw InvalidSearchString exception in case elastic returns SearchParseException (by Mugur Rus)

0.2.17 (2015-08-11)

  • add support for phase search via q param (by Mugur Rus)

0.2.16 (2015-08-04)

  • fix pip install

0.2.15 (2015-08-04)

  • parse mapping for fields type dict
  • avoid hidden dependencies - put it in requirements file (by Dinu Ghermany)

0.2.14 (2015-07-31)

  • avoid pymongo dependency

0.2.13 (2015-07-22)

  • add default_operator param to _build_query_string (by Mugur Rus)

0.2.12 (2015-07-07)

  • use both resource and datasource schema to convert datetime values (by Anca Farcas)

0.2.11 (2015-06-22)

  • return no hits when trying to find one resource and there is no mapping

0.2.10 (2015-06-12)

  • fix: make it eve 0.6 compatible

0.2.9 (2015-05-11)

  • fix: stop converting null values to datetime

0.2.7 (2015-04-16)

  • feat: allow delete by query

0.2.6 (2015-02-10)

  • fix a bug when getting cursor count

0.2.5 (2015-02-09)

  • add index param to put_mapping method

0.2.4 (2014-12-26)

  • add build_query_string method

0.2.3 (2014-12-08)

  • fix serializer on python 2.7 (by Jonathan Dray)

0.2.2 (2014-12-02)

  • make use of score sort if there is a query defined

0.2.1 (2014-11-27)

  • allow resource filters being callbacks for request specific filtering

0.2.0 (2014-11-24)

  • fix q param search for using eve <= 0.4
  • fix filters request args filtering
  • let user set mapping in schema
  • support aggregations

0.1.17 (2014-11-12)

  • switch to elasticsearch lib
  • add factory for es and indices

0.1.13 (2014-07-21)

  • fix count to allow extra params

0.1.12 (2014-07-08)

  • fix for superdesk search_backend setting

0.1.11 (2014-06-27)

  • add custom json serializer to work with bson.ObjectId

0.1.10 (2014-06-11)

  • fix is_empty

0.1.9 (2014-05-29)

  • fix is_empty call
  • implement find_one_raw

0.1.8 (2014-05-29)

  • fix remove by lookup

0.1.7 (2014-05-28)

  • preserve mapping after deleting all documents for given type

0.1.6 (2014-05-09)

  • support source param on find

0.1.5 (2014-05-05)

  • fix for elastic 1.0+ fields handling

0.1.4 (2014-05-02)

  • make it work with elastic 1.0+

0.1.3 (2014-01-31)

  • allow filtering via elasticsearch filter dsl

0.1.2 (2014-01-30)

  • fix pip install (add missing MANIFEST file)

0.1.1 (2014-01-30)

  • add changelog ;)
  • migrate readme to rst and use it for long_description

0.1.0 (2014-01-28)

  • initial release
Release History

Release History

This version
History Node

2.4

History Node

2.3

History Node

2.2

History Node

2.1

History Node

2.0

History Node

2.0rc3

History Node

2.0rc2

History Node

2.0rc1

History Node

0.6

History Node

0.5.2

History Node

0.5.1

History Node

0.5

History Node

0.4.1

History Node

0.4

History Node

0.3.8

History Node

0.3.7

History Node

0.3.6

History Node

0.3.5

History Node

0.3.4

History Node

0.3.3

History Node

0.3.2

History Node

0.3.1

History Node

0.3.0

History Node

0.2.21

History Node

0.2.20

History Node

0.2.19

History Node

0.2.18

History Node

0.2.17

History Node

0.2.16

History Node

0.2.15

History Node

0.2.14

History Node

0.2.13

History Node

0.2.12

History Node

0.2.11

History Node

0.2.10

History Node

0.2.9

History Node

0.2.8

History Node

0.2.7

History Node

0.2.6

History Node

0.2.5

History Node

0.2.4

History Node

0.2.3

History Node

0.2.2

History Node

0.2.1

History Node

0.2.0

History Node

0.1.23

History Node

0.1.22

History Node

0.1.21

History Node

0.1.20

History Node

0.1.19

History Node

0.1.18

History Node

0.1.17

History Node

0.1.16

History Node

0.1.15

History Node

0.1.13

History Node

0.1.12

History Node

0.1.11

History Node

0.1.10

History Node

0.1.9

History Node

0.1.8

History Node

0.1.7

History Node

0.1.6

History Node

0.1.5

History Node

0.1.4

History Node

0.1.3

History Node

0.1.3b4

History Node

0.1.3b3

History Node

0.1.3b2

History Node

0.1.3b1

History Node

0.1.3b

History Node

0.1.3a

History Node

0.1.2

History Node

0.1.2a

History Node

0.1.1

History Node

0.1.1a

History Node

0.1.0

History Node

0.1b

Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
Eve_Elastic-2.4-py2.py3-none-any.whl (44.9 kB) Copy SHA256 Checksum SHA256 3.5 Wheel Aug 2, 2017
Eve-Elastic-2.4.tar.gz (62.7 kB) Copy SHA256 Checksum SHA256 Source Aug 2, 2017

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting