Django Custom Manager with Method Chaining and Lazy Evaluation

Snippet

Django Custom Manager with Method Chaining and Lazy Evaluation

Custom Django managers enable reusable querysets with method chaining. By inheriting from models.Manager and chaining .filter() calls, you create lazy querysets that only execute against the database when iterated. The published manager is composed into Article, allowing both Article.objects and Article.published access patterns while maintaining DRY principles through inheritance.

snippet.py

python

from django.db import models
 
class PublishedManager(models.Manager):
    def for_user(self, user):
        return self.filter(author=user)
 
    def published(self):
        return self.filter(status='published')
 
class ArticleManager(PublishedManager):
    def with_related(self):
        return self.select_related('author', 'category').prefetch_related('tags')
 
    def in_category(self, category):
        return self.filter(category__slug=category)
 
 
class Article(models.Model):
    title = models.CharField(max_length=200)
    author = models.ForeignKey('auth.User', on_delete=models.CASCADE)
    category = models.ForeignKey('Category', on_delete=models.SET_NULL, null=True)
    tags = models.ManyToManyField('Tag')
    status = models.CharField(max_length=20, default='draft')
    created_at = models.DateTimeField(auto_now_add=True)
 
    objects = ArticleManager()
    published = PublishedManager()
 
    class Meta:
        ordering = ['-created_at']
 
 
# Usage with method chaining
articles = Article.objects.for_user(request.user).published().with_related()

django

Breakdown

class PublishedManager(models.Manager):

Base manager providing core queryset filtering methods

def for_user(self, user): return self.filter(author=user)

Returns queryset filtered by author, lazy evaluation starts here

class ArticleManager(PublishedManager):

Extends base manager inheriting for_user and published methods

def with_related(self): return self.select_related('author', 'category')...

Optimizes query with JOINs and prefetches to prevent N+1 problem

objects = ArticleManager()

Default manager chain for Article.objects

published = PublishedManager()

Composed manager exposing only published filtering

Previous snippet Next snippet

More Expert Python exercises →

From your library

Django Custom Manager with Method Chaining and Lazy Evaluation

Related