Jump to >

This documentation covers the in-development release of Djblets. You can see the latest stable docs or all previous versions.


Compatibility functions for older Django cache backend configuration.

These functions are used to maintain compatibility or transition settings from older versions of Django.

normalize_cache_backend(cache_backend, cache_name='default')[source]

Return a new-style CACHES dictionary from any given cache_backend.

Over time, Django has had support for two formats for a cache backend. The old-style CACHE_BACKEND string, and the new-style CACHES dictionary.

This function will accept either as input and return a dictionary containing a single normalized entry for the given cache backend. This can be merged into the existing CACHES setting.

If a CACHES dictionary is passed, the “default” cache will be the result.

  • cache_backend (dict or str) – The new-style or old-style cache backend dictionary or str to normalize.

  • cache_name (str) – The name of the cache backend to look up in cache_backend, if a new-style dictionary is provided.


A new-style cache backend dictionary containing the single cache backend referenced. If there were any parsing issues, an empty dictionary will be returned.