Skip to main content

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.

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django-easyfilters-0.6.tar.gz (40.4 kB view hashes)

Uploaded source

Built Distribution

django_easyfilters-0.6-py2-none-any.whl (34.3 kB view hashes)

Uploaded 2 7

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page