Skip to main content

Django-filter is a reusable Django application for allowing users to filter querysets dynamically.

Project description

Django-filter is a reusable Django application for allowing users to filter querysets dynamically.

Full documentation on read the docs.

https://travis-ci.org/carltongibson/django-filter.svg?branch=master

Requirements

  • Python: 2.7, 3.3, 3.4, 3.5

  • Django: 1.8, 1.9, 1.10

  • DRF: 3.4, 3.5

Installation

Install using pip:

pip install django-filter

Or clone the repo and add to your PYTHONPATH:

git clone git@github.com:carltongibson/django-filter.git

Usage

Django-filter can be used for generating interfaces similar to the Django admin’s list_filter interface. It has an API very similar to Django’s ModelForms. For example, if you had a Product model you could have a filterset for it with the code:

import django_filters

class ProductFilter(django_filters.FilterSet):
    class Meta:
        model = Product
        fields = ['name', 'price', 'manufacturer']

And then in your view you could do:

def product_list(request):
    filter = ProductFilter(request.GET, queryset=Product.objects.all())
    return render(request, 'my_app/template.html', {'filter': filter})

Django-filters additionally supports specifying FilterSet fields using a dictionary to specify filters with lookup types:

import django_filters

class ProductFilter(django_filters.FilterSet):
    class Meta:
        model = Product
        fields = {'name': ['exact', 'icontains'],
                  'price': ['exact', 'gte', 'lte'],
                 }

The filters will be available as 'name', 'name__icontains', 'price', 'price__gte', and 'price__lte' in the above example.

Support

If you have questions about usage or development you can join the mailing list.

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-filter-1.0.1.tar.gz (218.1 kB view hashes)

Uploaded Source

Built Distribution

django_filter-1.0.1-py2.py3-none-any.whl (54.2 kB view hashes)

Uploaded Python 2 Python 3

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