Printen is a simple, flexible module for integrating Elasticsearch into Python projects - especially projects utilizing Peewee or Django models.

Printen's code is currently in active development and should be considered alpha - breaking changes should be expected.

There is no shortage of fine search libraries for Python. The common tool used is Haystack, though this is oriented specifically towards Django, but supports a multitude of search backends. This is a great choice if you need flexibility in your search backends, but one can begin to feel constrained as the interface to the search backend is necessarily generic, so as to support all search backends similarly.

Other options include great django-simple-elasticsearch, which has the advantage of specifically focusing on Elasticsearch, but is limited to Django.

A final option is to use the excellent official Python Elasticsearch Client, which is not super hard, but does require a decent amount of work to map it to the concepts of your ORM.

Printen seeks to do this work for you, without being overly choosy about what Python framework you use it with (essentially the opposite of Haystack - choosy about the search engine, not choosy about the Python framework).

Printen is expected to be compatible with Elasticsearch 2.0 and above.

To see the complete documentation, visit Printen's documentation on Read the Docs.

Printen works with Python 2.7 or 3.6 and requires a version of Elasticsearch DSL between 2 and 3, as per the requirements.txt.

Printen can still be intalled via pip:

$ pip install printen

or if you have the source locally:

$ python setup.py install

Printen is licensed under the BSD License.

This was inspired by James Addison's django-simple-elasticsearch.