Metadata-Version: 1.0
Name: Products.StandardCacheManagers
Version: 2.13.0
Summary: Cache managers for Zope 2.
Home-page: http://pypi.python.org/pypi/Products.StandardCacheManagers
Author: Zope Foundation and Contributors
Author-email: zope-dev@zope.org
License: ZPL 2.1
Description: Overview
        ========
        
        This package provides two cache managers for Zope 2. A RAMCacheManager and an
        Accelerated HTTP cache manager, which adds HTTP cache headers to responses.
        
        The following is intended for people interested in the internals of
        RAMCacheManager, such as maintainers.
        
        Introduction
        ============
        
        The caching framework does not interpret the data in any way, it acts
        just as a general storage for data passed to it.  It tries to check if
        the data is pickleable though.  IOW, only pickleable data is
        cacheable. 
        
        The idea behind the RAMCacheManager is that it should be shared between
        threads, so that the same objects are not cached in each thread.  This
        is achieved by storing the cache data structure itself as a module
        level variable (RAMCacheManager.caches).  This, of course, requires
        locking on modifications of that data structure.
        
        Each RAMCacheManager instance has one cache in RAMCacheManager.caches
        dictionary.   A unique __cacheid is generated when creating a cache
        manager and it's used as a key for caches.
        
        Object Hierarchy
        ================
        
        RAMCacheManager
          RAMCache
            ObjectCacheEntries
              CacheEntry
        
        RAMCacheManager is a persistent placeful object.  It is assigned a
        unique __cacheid on its creation.  It is then used as a key to look up
        the corresponding RAMCache object in the global caches dictionary.
        So, each RAMCacheManager has a single RAMCache related to it.
        
        RAMCache is a volatile cache, unique for each RAMCacheManager.  It is
        shared among threads and does all the locking.  It has a writelock.
        No locking is done on reading though.  RAMCache keeps a dictionary of
        ObjectCacheEntries indexed by the physical path of a cached object.
        
        ObjectCacheEntries is a container for cached values for a single object.  
        The values in it are indexed by a tuple of a view_name, interesting 
        request variables, and extra keywords passed to Cache.ZCache_set(). 
        
        CacheEntry is a wrapper around a single cached value.  It stores the
        data itself, creation time, view_name and keeps the access count.
        
        Changelog
        =========
        
        2.13.0 (2010-07-11)
        -------------------
        
        - Released as separate package.
        
Platform: UNKNOWN
