diff --git a/README.md b/README.md index 92eeab70..408f65f0 100644 --- a/README.md +++ b/README.md @@ -484,11 +484,15 @@ _In-process databases usable directly from Python._ _Libraries for caching data._ -- [cachetools](https://github.com/tkem/cachetools) - Extensible memoizing collections and decorators. -- [diskcache](https://github.com/grantjenks/python-diskcache) - SQLite and file backed cache backend, compatible with Django. -- [django-redis](https://github.com/jazzband/django-redis) - Full-featured Redis cache backend for Django. -- [hishel](https://github.com/karpetrosyan/hishel) - RFC 9111 compliant HTTP caching for clients like httpx and requests and servers like FastAPI, with sync and async support. -- [django-cacheops](https://github.com/Suor/django-cacheops) - A slick ORM cache with automatic granular event-driven invalidation. +- General + - [cachetools](https://github.com/tkem/cachetools) - Extensible memoizing collections and decorators. + - [diskcache](https://github.com/grantjenks/python-diskcache) - SQLite and file backed cache backend, compatible with Django. + - [dogpile.cache](https://github.com/sqlalchemy/dogpile.cache) - A caching API for Redis, Memcached, and other backends, with coordinated value regeneration. +- HTTP Responses + - [hishel](https://github.com/karpetrosyan/hishel) - RFC 9111 compliant HTTP caching for clients like httpx and requests and servers like FastAPI, with sync and async support. +- Django + - [django-redis](https://github.com/jazzband/django-redis) - Full-featured Redis cache backend for Django. + - [django-cacheops](https://github.com/Suor/django-cacheops) - A slick ORM cache with automatic granular event-driven invalidation. ### Search diff --git a/website/data/category_intros/caching.md b/website/data/category_intros/caching.md index c613b472..cca8b803 100644 --- a/website/data/category_intros/caching.md +++ b/website/data/category_intros/caching.md @@ -5,6 +5,7 @@ How to choose: - Memoizing a function in one process, with a size limit or an expiry time: cachetools - A persistent cache on local disk that several processes share: DiskCache - A Django cache backend on local disk: DiskCache +- A shared Redis or Memcached cache outside Django, with coordinated value regeneration: dogpile.cache - A Django cache and session store on Redis: django-redis - Caching HTTP responses in HTTPX or Requests, or setting cache headers in FastAPI: Hishel - Django ORM queries cached in Redis and invalidated when the data changes: Cacheops @@ -13,6 +14,8 @@ cachetools offers [variants of the standard library's `@lru_cache` decorator](ht DiskCache keeps keys and values in [a SQLite database and a directory of files](https://grantjenks.com/docs/diskcache/), with no server process to run. Point a `Cache` at a directory, and [other threads and processes that open the same directory](https://grantjenks.com/docs/diskcache/tutorial.html#tutorial-cache) share its entries. Its `memoize()` decorator takes [arguments like `lru_cache`'s](https://grantjenks.com/docs/diskcache/tutorial.html#tutorial-fanoutcache), plus an expiry time. In Django, [set `diskcache.DjangoCache` as the `BACKEND`](https://grantjenks.com/docs/diskcache/tutorial.html#tutorial-djangocache) and a directory as the `LOCATION`. +dogpile.cache gives you [one caching API over Redis, Memcached, and other backends](https://dogpilecache.sqlalchemy.org/en/latest/usage.html), without depending on a web framework. Create a region with `make_region()`, configure its backend, and call `get_or_create()` with a key and a function that computes the value. For shared Redis or Memcached caches, enable [`distributed_lock`](https://dogpilecache.sqlalchemy.org/en/latest/api.html) so one worker regenerates an expired value while others use the previous one. + django-redis is a [full-featured Redis cache and session backend](https://github.com/jazzband/django-redis#introduction) for Django. [Set `django_redis.cache.RedisCache` as the `BACKEND`](https://github.com/jazzband/django-redis#configure-as-cache-backend) and a redis-py URL like `redis://127.0.0.1:6379/1` as the `LOCATION`. Sessions then need no extra backend: [point `SESSION_ENGINE` at Django's cache sessions](https://github.com/jazzband/django-redis#configure-as-session-backend), and they live in Redis too. Its clients, parsers, and serializers [are pluggable](https://github.com/jazzband/django-redis#why-use-django-redis). Hishel caches HTTP responses [by RFC 9111](https://hishel.com/overview.html), the rules browsers follow. It works in sync and async code, and comes with a backend that stores responses in SQLite. In HTTPX, [use `SyncCacheClient` or `AsyncCacheClient`](https://hishel.com/httpx.html#cache-clients), drop-in replacements for `Client` and `AsyncClient`. In Requests, [mount its `CacheAdapter`](https://hishel.com/requests.html#quick-start) on a `Session`. In FastAPI, [the `cache()` dependency](https://hishel.com/fastapi.html) sends Cache-Control headers to browsers and CDNs, and Hishel's ASGI middleware adds a cache on your server.