django-easyfilters

================== django-easyfilters

Overview

This library provides filters similar in some ways to list_filter and date_hierarchy in Django's admin, but for use outside the admin. Importantly, it also includes result counts for the choices. It is designed to be very easy to get started with.

Download/install

Just install as a Python library.

PyPI page: http://pypi.python.org/pypi/django-easyfilters

Docs

See the docs/ directory, especially docs/overview.rst

Also hosted here: http://packages.python.org/django-easyfilters And here: https://django-easyfilters.readthedocs.org/en/latest/

Demo

A small demo app is included, see the instructions in docs/develop.rst

A (currently) live example can be seen at:

http://www.christchurchbradford.org.uk/sermons/

Status

The library is in a useful state and is used in production. Test coverage is extensive. Feedback regarding API or features is very welcome!

Support

File bugs/feature request in the 'issues' in BitBucket:

https://bitbucket.org/spookylukey/django-easyfilters/issues?status=new&status=open

Or drop me <http://lukeplant.me.uk/>_ an email, I always like to hear when people are using my stuff.

TODO

• Possible: ability to specify 'defaults' attribute for FilterSet
• Allow the automatic 'page' resetting to be customized

Version 0.5

• Python 3.3 compatibility :-) Tests are run against Python 2.6, 2.7 and 3.3, and Django 1.3 to 1.5

Version 0.4

• Cleaned up internal Filter implementation/API

• Added and documented Filter.render_choice_object which can be overridden for easy customization of filters.

• Fixed various bugs with DateTimeFilter. Thanks to psyton for a bug fix.

Version 0.3.2

• Correction to new FilterSet.title attribute.

Version 0.3.1

• Fixed crasher in 0.3

Version 0.3

• Added the FilterSet.title attribute, and the title_fields attribute that can be used to control it.

Version 0.2

• Added NumericRangeFilter

• More docs, and API firmed up.

• Fixed bug with test_settings.py which caused static media not to be served with most recent Django.

Version 0.1.1

Cleaned up the release tarball to remove old files.

Version 0.1

Initial release