Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/jonaprieto/flask-ponywhoosh

A Flask full-text search engine
https://github.com/jonaprieto/flask-ponywhoosh

flask full-text-search ponyorm python search-engine whoosh

Last synced: 3 months ago
JSON representation

A Flask full-text search engine

Awesome Lists containing this project

README

        

|PonyWhoosh|

flask-ponywhoosh
================

|PyPI Package latest release| |Test|

We are looking for enthusiatic and skilled mantainers for Flask-PonyWhoosh. If you are interested just send an email to `[email protected]`
===========================================================================

This package provides the easiest way to add a search engine in your flask application on
the shoulders of Pony ORM and Whoosh, two amazing pieces of software.
We've included some templates to render the search engine and we hope you hack it.
Just see the example below.

- Documentation: https://jonaprieto.github.io/flask-ponywhoosh/

Install
-------

- The natural way:

.. code:: bash

$ pip install flask-ponywhoosh

- Using the source:

.. code:: bash

$ git clone https://github.com/jonaprieto/flask-ponywhoosh.git
$ cd flask-ponywhoosh

If you are using python 2:

.. code:: bash

$ make install-py2

If you are using python 3:

.. code:: bash

$ make install-py3

A small example
---------------

Download the source of this package:

.. code:: bash

$ git clone https://github.com/jonaprieto/flask-ponywhoosh.git
$ cd flask-ponywhoosh

Then, you can run the example running these commands:

.. code:: bash

$ pip install -r requirements.txt
$ python example.py runserver

You will see in the shell some outputs showing settings of
flask-ponywhoosh (debug mode is on by default). We provide two urls by
default:

- / : the form of the search engine
- /database : raw content of the test database

is often http://127.0.0.1:5000.

Hacking
-------

Customize the templates, URL routes and other stuffs, please checkout
the documentation on:

- http://pythonhosted.org/flask-ponywhoosh/
- https://pypi.python.org/pypi/flask-ponywhoosh

Screenshots
-----------

Adding what fields of your models in your database you want to search.

|PonyWhoosh1|

|PonyWhoosh2|

.. |PonyWhoosh| image:: https://github.com/jonaprieto/flask-ponywhoosh/blob/master/docs/_static/logo.png?raw=true
:class: align-center
:target: https://pypi.python.org/pypi/flask-ponywhoosh
.. |PyPI Package latest release| image:: http://img.shields.io/pypi/v/flask-ponywhoosh.png?style=flat
.. |Test| image:: https://travis-ci.org/jonaprieto/flask-ponywhoosh.svg?branch=master
:target: https://travis-ci.org/jonaprieto/flask-ponywhoosh
.. |PonyWhoosh1| image:: https://github.com/jonaprieto/flask-ponywhoosh/blob/master/images/databaseconfig.gif?raw=true
:class: align-center
:target: https://pypi.python.org/pypi/flask-ponywhoosh
.. |PonyWhoosh2| image:: http://g.recordit.co/6MnvKNod6y.gif
:class: align-center
:target: https://pypi.python.org/pypi/flask-ponywhoosh