==================
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
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