Skip to main content
Donate to the Python Software Foundation or Purchase a PyCharm License to Benefit the PSF! Donate Now

Integrates dogpile.cache for Pyramid

Project description


Small dogpile.cache configuration and access package. It is inspired by pyramid_dogpile_cache, which we found unusable since it insists on configuring the cache regions in its get_region() API – but if you want to use the @cache_on_arguments decorator, that is at import time, where no configuration exists yet. Our package wants to perform the configuration during the WSGI application setup instead.

This package is compatible with Python version 2.7 and 3 (>=3.4).


The package offers only one API function; it returns a dogpile.cache CacheRegion:

from pyramid_dogpile_cache import get_region
region = get_region('foo')

As said above, this is safe to call at import time, so you can go on like this:

def expensive_function(one, two, three):
    # compute stuff

Setup / Pyramid

Include the package, either in code:

config = Configurator(...)

or in the ini file:

pyramid.includes = pyramid_dogpile_cache2

Setup / Paste

For non-Pyramid WSGI applications that use a paste.ini file, you need to call:

def my_paste_app_factory(global_conf, **local_conf):
    return my_wsgi_callable


The settings support of pyramid_dogpile_cache unfortunately is quite incomplete (e.g. it does not even convert expiration_time to int). The support of this packages is a little better, but still very much incomplete: we support the in-memory and memcached backends (pylibmc to be precise), and only the same backend and configuration for all cache regions.

The following settings are supported:


A list of region names that should be configured (separated by either spaces or commas).


The default backend for cache regions (e.g. 'dogpile.cache.memory', dogpile.cache.pylibmc, etc.).


Backend for the given region.


The default expiration time. Can be overridden for individual regions (in seconds).


The expiration time for the given cache region (in seconds).


Defaults for backend arguments. Can be overridden for individual regions.


Backend arguments for the given cache region.

Backend arguments work only for strings, thus we support some custom treatment:


A list of memcached servers, separated by ;.


Set pylibmc behaviours, see coerce_memached_behaviors for which subkeys are supported.

Note: As opposed to pyramid_dogpile_cache we don’t support overriding the key_generator or key_mangler functions yet; we preconfigure them with enhanced versions of dogpile.cache that support non-ascii function arguments and generating cache keys for methods that include the class name.

Change log for pyramid_dogpile_cache2

1.0.5 (2018-12-14)

  • Clarify Python-3 compatiblity (it’s >=3.4, not _just_ 3.4)

1.0.4 (2018-11-21)

  • Support caching functions with type annotations on Python 3 (see PR #5).

1.0.3 (2017-02-14)

  • Fix packaging issue (see PR #2).

1.0.2 (2016-08-01)

  • Update API compatibility to dogpile.cache-0.6.0.

1.0.1 (2016-01-20)

  • Actually include the class name in the cache key for methods.

1.0.0 (2016-01-19)

  • Initial release.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
pyramid_dogpile_cache2-1.0.5.tar.gz (9.4 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page