django-cacheops

What it is and what it does

django-cacheops is a Django caching layer that sits between your ORM and Redis to automatically cache querysets and invalidate them when underlying data changes. It supports both automatic caching (configured per-model) and manual caching via `.cache()` method calls, plus decorators for caching function results. The package uses Redis as its primary backend and can fall back to filesystem-based time-invalidated caching for simpler use cases.

The core value is granular, event-driven invalidation: when you save, delete, or update a model instance, cacheops automatically invalidates only the relevant cached queries rather than flushing everything. It also provides decorators to cache any user function or view, template extensions for Django and Jinja2, transparent transaction support, and a dog-pile prevention mechanism to avoid thundering-herd problems when cache entries expire.

Use it for

• Cache frequently accessed User.objects.get() calls across a Django app to reduce database load on auth queries.
• Automatically invalidate cached article listings when posts are published, updated, or deleted without manual cache management.
• Decorate expensive reporting functions with @cached_as(Model) to cache results and invalidate them on model changes.
• Use .nocache() to disable automatic caching on specific querysets when you need fresh data in particular code paths.
• Cache count and aggregate operations on large tables separately from fetch operations to optimize pagination.
• Configure per-model cache timeouts and operations (get, fetch, count, aggregate, exists) to fine-tune what gets cached.

Worth the install?

AI-flagged interpretation of the facts on this page. Verify before relying on it.

Install

django-cacheops on PyPI

Before you install

Low install friction; wheel distribution available. Actively maintained with recent commits and stable production status. Requires Redis 4.0+ as a runtime dependency alongside Django 3.2+ and Python 3.8+.

Redis 4.0+ server must be running and accessible; Django 3.2+ and Python 3.8+ required.

License in practice

BSD permissive license allows commercial and private use with minimal restrictions; suitable for most projects.

Quickstart

pip install django-cacheops

# In Django settings.py:
INSTALLED_APPS = ['cacheops', ...]
CACHEOPS_REDIS = 'redis://localhost:6379/1'
CACHEOPS = {'auth.user': {'ops': 'get', 'timeout': 60*15}}

# In code:
from cacheops import cached_as
user = User.objects.get(id=1)  # cached automatically
result = Article.objects.filter(tag=2).cache()

Package facts

Evidence: django_cacheops-7.2-py2.py3-none-any.whl

Tags

More Python Modules packages

See also django-cachalot · django-redis · django-sql-utils · django-cache-memoize · django-mock-queries · python-redis-cache · django-cache-url · django-redis-sessions · Collectfast · django-perf-rec