Integrate Elasticsearch DSL with Django REST framework.
Project description
Integrate Elasticsearch DSL with Django REST framework in the shortest way possible, with least efforts possible.
Package provides views, serializers, filter backends, pagination and other handy add-ons.
You are expected to use django-elasticsearch-dsl for defining your Elasticsearch documents.
Prerequisites
Django 1.8, 1.9, 1.10, 1.11 and 2.0.
Python 2.7, 3.4, 3.5, 3.6
Elasticsearch 2.x, 5.x, 6.x
Dependencies
Documentation
Documentation is available on Read the Docs.
Main features and highlights
Filtering filter backend (big variety of native- and functional- query lookups, such as gt, gte, lt, lte, endswith, contains, wildcard, exists, exclude, isnull, range, in, prefix (same as startswith), term and terms is implemented.
Geo-spatial filtering filter backend (the following filters implemented: geo_distance, geo_polygon and geo_bounding_box).
Geo-spatial ordering filter backend (the following filters implemented: geo_distance).
Installation
Install latest stable version from PyPI:
pip install django-elasticsearch-dsl-drfor latest stable version from GitHub:
pip install https://github.com/barseghyanartur/django-elasticsearch-dsl-drf/archive/stable.tar.gzor latest stable version from BitBucket:
pip install https://bitbucket.org/barseghyanartur/django-elasticsearch-dsl-drf/get/stable.tar.gzAdd rest_framework, django_elasticsearch_dsl and django_elasticsearch_dsl_drf to INSTALLED_APPS:
INSTALLED_APPS = ( # ... # REST framework 'rest_framework', # Django Elasticsearch integration 'django_elasticsearch_dsl', # Django REST framework Elasticsearch integration (this package) 'django_elasticsearch_dsl_drf', # ... )
Quick start
Perhaps the easiest way to get acquainted with django-elasticsearch-dsl-drf is to read the quick start tutorial.
See it as a guide of diving into integration of Elasticsearch with Django with very low knowledge entry level.
Testing
Project is covered with tests.
To test with all supported Python/Django versions type:
toxTo test against specific environment, type:
tox -e py36-django110To test just your working environment type:
./runtests.pyTo run a single test in your working environment type:
./runtests.py src/django_elasticsearch_dsl_drf/tests/test_filtering.pyOr:
./manage.py test django_elasticsearch_dsl_drf.tests.test_orderingIt’s assumed that you have all the requirements installed. If not, first install the test requirements:
pip install -r examples/requirements/test.txtWriting documentation
Keep the following hierarchy.
=====
title
=====
header
======
sub-header
----------
sub-sub-header
~~~~~~~~~~~~~~
sub-sub-sub-header
^^^^^^^^^^^^^^^^^^
sub-sub-sub-sub-header
++++++++++++++++++++++
sub-sub-sub-sub-sub-header
**************************License
GPL 2.0/LGPL 2.1
Support
For any issues contact me at the e-mail given in the Author section.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for django-elasticsearch-dsl-drf-0.13.tar.gz
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 3f821f64cb62e26e8a5da88c2db91be274a07f72202c68c07c30118015eed43e |
|
| MD5 | 956290c92bf17b88486a8e0d573e8dc3 |
|
| BLAKE2b-256 | 27b3a52c512adc880de9c946ff85a32970c7e226a0c99544babfd9e3d76270dc |
Hashes for django_elasticsearch_dsl_drf-0.13-py2.py3-none-any.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | b02f5f270e75c3eeda650c201d24007b06ee83a3f6b44e521eaee36ca448cc65 |
|
| MD5 | b4df93f98f624952f1dbd84822db5c6b |
|
| BLAKE2b-256 | a6cafeb7d130a66c9708a0370e55f0167c91f52f00bdaf1a8f3946a9ce114be5 |
