Skip to content

jonaprieto/flask-ponywhoosh

Repository files navigation

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 prieto.jona@gmail.com

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.

Install

  • The natural way:
$ pip install flask-ponywhoosh
  • Using the source:
$ git clone https://github.com/jonaprieto/flask-ponywhoosh.git
$ cd flask-ponywhoosh

If you are using python 2:

$ make install-py2

If you are using python 3:

$ make install-py3

A small example

Download the source of this package:

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

Then, you can run the example running these commands:

$ 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:

  • <localhost>/ : the form of the search engine
  • <localhost>/database : raw content of the test database

<localhost> is often http://127.0.0.1:5000.

Hacking

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

Screenshots

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

PonyWhoosh1

PonyWhoosh2