Easy Django integration with Elasticsearch through ZomboDB Postgres Extension
Project description
Easy Django integration with Elasticsearch through ZomboDB Postgres Extension. Thanks to ZomboDB, your Django models are synced with Elasticsearch after every transaction! Searching is also very simple: you can make Elasticsearch queries by just calling one of the search methods on your querysets. Couldn’t be easier!
Documentation
The full documentation is at https://django-zombodb.readthedocs.io.
Requirements
Python: 3.5, 3.6, 3.7
Django: 2.0, 2.1, 2.2
Postgres and Elasticsearch: same as ZomboDB current requirements
Quickstart
Install ZomboDB (instructions here)
Install django-zombodb:
pip install django-zombodb
Add the SearchQuerySet and the ZomboDBIndex to your model:
from django_zombodb.indexes import ZomboDBIndex
from django_zombodb.querysets import SearchQuerySet
class Restaurant(models.Model):
name = models.TextField()
objects = models.Manager.from_queryset(SearchQuerySet)()
class Meta:
indexes = [
ZomboDBIndex(fields=[
'name',
]),
]
Make the migrations:
python manage.py makemigrations
Add django_zombodb.operations.ZomboDBExtension() as the first operation of the migration you’ve just created:
import django_zombodb.operations
class Migration(migrations.Migration):
dependencies = [
('restaurants', '0001_initial'),
]
operations = [
django_zombodb.operations.ZomboDBExtension(), # <<< here
]
Run the migrations (Postgres user must be SUPERUSER to create the ZomboDB extension):
python manage.py migrate
Done! Now you can make Elasticsearch queries directly from your model:
Restaurant.objects.filter(is_open=True).query_string_search("brazil* AND coffee~")
Full Example
Check https://github.com/vintasoftware/django-zombodb/tree/master/example
Running Tests
You need to have Elasticsearch and Postgres instances running on default ports. Also, you need ZomboDB installed. Then just do:
python runtests.py
Security
Please check SECURITY.rst. If you found or if you think you found a vulnerability please get in touch via admin AT vinta.com.br
Please avoid disclosing any security issue on GitHub or any other public website. We’ll work to swiftly address any possible vulnerability and give credit to reporters (if wanted).
Commercial Support
This project is maintained by Vinta Software and other contributors. We are always looking for exciting work, so if you need any commercial support, feel free to get in touch: contact@vinta.com.br
Change Log
0.3.0 (2019-07-18)
Support for custom Elasticsearch mappings through field_mapping parameter on ZomboDBIndex.
Support to limit parameter on search methods.
0.2.1 (2019-06-13)
Dropped support for Python 3.4.
Added missing imports to docs.
0.2.0 (2019-03-01)
Removed parameter url from ZomboDBIndex. This simplifies the support of multiple deployment environments (local, staging, production), because the ElasticSearch URL isn’t copied to inside migrations code (see Issue #17).
0.1.0 (2019-02-01)
First release on PyPI.
Project details
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_zombodb-0.3.0-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 13170fb63897e93141d71217f21263dec896c3aecb3ae2f0ed06a7e6a53058ed |
|
MD5 | 778bec5e8a14bde599f5fd6430e90079 |
|
BLAKE2b-256 | 75540f561c00c5a1fe5fefe856b241fd1f62151283530fce3b25d8faac800cb0 |