Skip to content
CAI
Software that uses CAICheck a score

sdm-restorating/django-cacheops

60.7

Adequate · 22 September 2026

3.4k

lines of production code

Python

with Lua

6

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

This system is a Django caching library that manages data caching and invalidation via Redis. It provides core caching, locking, and transaction support, along with template tags for fragment caching. The library includes management commands for cache cleanup and invalidation, supported by a comprehensive test suite and benchmarking infrastructure.

Features

Introduce CacheopsLibrary and invalidate\_fragment template tag

The cacheops template tags are now implemented via a new CacheopsLibrary class, which provides a decorator\_tag method to register template tags. This change introduces the invalidate\_fragment function, allowing users to invalidate specific cache fragments by name. The implementation uses Python's inspect.getfullargspec for argument parsing and leverages Django's template parsing utilities to handle template content and arguments.

cacheops/templatetags · high confidence

Architecture

Refactored cacheops internals to use Django AppConfig and modularize Redis operations

The cacheops package was restructured to use a Django AppConfig (apps.py) for initialization, replacing previous monkey-patching of Django's app registry. The codebase was split into distinct modules: getset.py handles core caching and locking logic, redis.py manages the Redis client and Lua scripts, transaction.py manages transaction states, and invalidation.py handles cache invalidation. This refactoring improves thread safety, separates concerns, and modernizes the integration with Django's application lifecycle.

cacheops · high confidence

Behavioural changes

Release django-cacheops 7.0.1

This release fixes compatibility with Redis 6.x and older, improves handling of abstract models, and includes documentation updates. The package is now version 7.0.1, with setup.py and CHANGELOG updated to reflect this version.

(repo-wide) · high confidence

Rewrote cache invalidation and storage logic in Lua

The cacheops library replaced its previous caching and invalidation scripts with new Lua implementations (cache\_thing, cache\_thing\_insideout, invalidate, and invalidate\_insideout). These changes introduce an 'insideout' caching mode that uses stamp-based invalidation to detect stale data, support cache key prefixes, and handle Redis versions 4.0 and above (including Redis 6.x and 7.x) with optimized deletion using 'unlink' and chunked operations for large invalidation sets.

cacheops/lua · medium confidence

Updated cache invalidation and cleanup management commands

The \invalidate\ management command now supports invalidating auto-created models and uses Django's modern \apps\ registry instead of deprecated APIs, while the \cleanfilecache\ and \reapconjs\ commands have been added to clean stale file cache and expired conjunction keys respectively.

cacheops/management · medium confidence

Test coverage

Added comprehensive test suite and benchmarking infrastructure

The project now includes a full test suite and benchmarking framework to validate caching, invalidation, and transaction support. This includes model definitions and fixtures for testing, a benchmarking script (bench.py) for performance measurement, and specific test files (tests.py, test\_extras.py, tests\_sharding.py, tests\_transactions.py) that cover features like cache signals, locking, no-invalidation contexts, database sharding prefixes, and atomic transaction handling.

tests · high confidence

Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

How this codebase got here

This is the PUBLIC form of this artifact. Findings are listed in full, but the details of SECURITY findings — which rule fired, in which file, on which line, and how to fix it — are deliberately withheld, and any secret-scanner results are excluded entirely. Where detail is absent here it was REMOVED FOR PUBLICATION; it is not missing from the analysis. The complete artifact is available from the repository owner.

Score

  • CAI 59 → 61 (+1.4)
  • Rubric changed (rubric-2026.08.19 → rubric-2026.09.15) — scores are not directly comparable.

Lenses

  • Code Health 99 → 96 (-3.0)
  • Architecture 94 → 96 (+2.8)
  • Maturity 43 → 43 (+0.0)
  • Readiness 58 → 62 (+4.4)
  • Security 79 → 87 (+7.8)

Resolved (9)

  • Coverage not included — suite not readable by the collector
  • Dependency hygiene not measured — no supported dependency manifest was read
  • High: security finding (details withheld)
  • High: security finding (details withheld)
  • High: security finding (details withheld)
  • High: security finding (details withheld)
  • No exposed public API
  • Test reliability not included
  • dormant codebase — no living knowledge left to concentrate

New (23)

  • Documentation: no architecture or design documentation (README.rst)
  • HackComment (cacheops/query.py)
  • High: security finding (details withheld)
  • High: security finding (details withheld)
  • High: security finding (details withheld)
  • High: security finding (details withheld)
  • High: security finding (details withheld)
  • High: security finding (details withheld)
  • Medium: security finding (details withheld)
  • Medium: security finding (details withheld)
  • No ADRs found
  • No dependency advisory monitoring
  • TodoComment (cacheops/jinja2.py)
  • TodoComment (cacheops/query.py)
  • TodoComment (cacheops/query.py)
  • TodoComment (cacheops/query.py)
  • TodoComment (cacheops/query.py)
  • TodoComment (cacheops/query.py)
  • TodoComment (cacheops/query.py)
  • TodoComment (cacheops/sharding.py)
  • …and 3 more

Written by watchdog.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

Survey your own repository

sdm-restorating/django-cacheops was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.

About this page

  • The score is its most recent published measurement, taken on 22 September 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
  • Measured at commit ff7e86c168a62def7f95be8199c4a43281a6cf32 — the exact code this score is about.
  • Scored under rubric-2026.09.15 — the same rubric and the same method as every other entry in this index.
  • Measured by watchdog.canine.dev using codehealth-analyzer preprod-821afab8930d.