Easy creation of link-based filtering for a list of Django model objects.
Project description
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.
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:
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 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
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
