Skip to main content

Filter user-data based on multiple criteria.

Project description

For a lot of web applications - Blogs come to mind as a canonical example, the queryset needs to be filtered in the views based upon some business rules. For instance, in a Blog, a “Dashboard” view - allowing editing of posts, should only ever have posts written by the user who is currently logged-in.

In general, there is a need to filter data based on some business logic - universally! i.e. across each and every view. The ugly way of doing this would be to write queries substantiating the business logic in every single view. Sieve does the same job beautifully, minimally and correctly.


We are at the cheeseshop:

pip install django_sieve


To use django_sieve in a project:

  1. Include it in INSTALLED_APPS in your settings file.

  2. Define a sieve model. A sieve model is the control for defining the filtering criteria of user data. For instance, in our example, we have a bookstore in which a user can subscribe to all the books from a particular author or all the books from a few publishers. In this case, his book list need to only contain books from the author and publishers that he has chosen. In order to do this, we define a sieve model like so:

    class Sieve(models.Model):
            group = models.ForeignKey('auth.Group')
            publisher = models.ManyToManyField(Publisher)
            author = models.ForeignKey(Author)
  3. Declare your project-wide sieve model in For instance, if the sieve model is called Sieve and resides in the bookstore app:

    SIEVE_MODEL = 'bookstore.Sieve'
  4. Use SieveManager as the ModelManager for all the models in your project that you want to filter based on the criteria defined in the sieve model:

    class Author(models.Model):
            first_name = models.CharField(max_length=30)
            last_name = models.CharField(max_length=40)
            email = models.EmailField()
            objects = SieveManager()
  5. Use the sieve method to define your queryset in your views like so:

    class BookView(ListView):
            queryset = Book.objects.sieve(user=request.user)

That is all. Site-wide filtering of user data based on predefined criteria without having to write queries for all the views.

Please be wary of performance issues though - in our experience, django-sieve works for 90% cases especially when you need to bring everything up for a quick demo. However, as your site matures and the number of users increase, you may want to invest in profiling your views and hand-crafting these queries when and where required.


i.0.0 (2014)

  • Got to 93% test coverage.

0.3.0 (2014)

  • Changed the mapping from User to Group, dealt with self-referencing models etc.

0.2.0 (2014)

  • Added support for ManyToMany fields in SIEVE_MODEL

0.1.0 (2014)

  • First release on PyPI.

Project details

Download files

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

Files for django_sieve, version 1.0.0
Filename, size File type Python version Upload date Hashes
Filename, size django_sieve-1.0.0.tar.gz (13.1 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page