Current File : //proc/227033/root/opt/alt/python27/lib/python2.7/site-packages/beaker/cache.pyo
�
���Kc @ sX d Z d d l Z d d l j Z d d l j Z d d l m Z m Z d d l j
j Z d d l j
j
Z
d d l j
j Z d d l j
j Z i e j d 6e j d 6e j d 6e j d 6e
j d 6e j d 6e j d
6Z i Z i Z y d d l Z x e j d � D]� Z yB e j � Z e j! Z! e! e k rBe d e! � � n e e e! <Wqe e" f k
rfqd d l# Z# d d
l m$ Z$ e% e# j& � d e$ � s�d d l' Z' d d l( m( Z( e( � Z) e' j* d e) � e j+ d e e) j, � f e- d � q�qXqWWn e. k
rn Xd � Z/ d � Z0 d e1 f d � � YZ2 d e1 f d � � YZ3 d S( s� Cache object
The Cache object is used to manage a set of cache files and their
associated backend. The backends can be rotated on the fly by
specifying an alternate type when used.
Advanced users can add new backends in beaker.backends
i����N( t BeakerExceptiont InvalidCacheBackendErrort memoryt dbmt files
ext:memcacheds ext:databases ext:sqlas
ext:googles beaker.backendss2 NamespaceManager name conflict,'%s' already loaded( t DistributionNotFoundi ( t StringIOs5 Unable to load NamespaceManager entry point: '%s': %si c s" d g � � � � f d � } | S( s# Decorate a function to cache itself using a cache region
The region decorator requires arguments if there are more than
2 of the same named function, in the same module. This is
because the namespace used for the functions cache is based on
the functions name and the module.
Example::
# Add cache region settings to beaker:
beaker.cache.cache_regions.update(dict_of_config_region_options))
@cache_region('short_term', 'some_data')
def populate_things(search_term, limit, offset):
return load_the_data(search_term, limit, offset)
return load('rabbits', 20, 0)
.. note::
The function being decorated must only be called with
positional arguments.
c s@ t j � � � � � � � � f d � } � | _ � | _ | S( Nc s� t � } | j d t � s& � � � S� d sh � t k rO t d � � � n t j � | � � d <n d j t t � � � � } � � f d � } � d j | d | �S( Nt enabledi s Cache region not configured: %st c s
� � � S( N( ( ( t argst func( s= /opt/alt/python27/lib/python2.7/site-packages/beaker/cache.pyt goo s t
createfunc(
t
cache_regionst gett TrueR t Cachet
_get_cachet joint mapt strt get_value( R t regt cache_keyR ( t cachet deco_argsR
t namespacet region( R s= /opt/alt/python27/lib/python2.7/site-packages/beaker/cache.pyt cachedd s
( t utilt func_namespacet _arg_namespacet _arg_region( R
R ( R R R ( R
R s= /opt/alt/python27/lib/python2.7/site-packages/beaker/cache.pyt decorateb s
N( t None( R R R! ( ( R R R s= /opt/alt/python27/lib/python2.7/site-packages/beaker/cache.pyt cache_regionF s c G s� t | � r* | s | j } n | j } n | s? t d � � n
t | } t j | | � } d j d � | D� � } | j | � d S( s� Invalidate a cache region namespace or decorated function
This function only invalidates cache spaces created with the
cache_region decorator.
:param namespace: Either the namespace of the result to invalidate, or the
cached function reference
:param region: The region the function was cached to. If the function was
cached to a single region then this argument can be None
:param args: Arguments that were used to differentiate the cached
function as well as the arguments passed to the decorated
function
Example::
# Add cache region settings to beaker:
beaker.cache.cache_regions.update(dict_of_config_region_options))
def populate_things(invalidate=False):
@cache_region('short_term', 'some_data')
def load(search_term, limit, offset):
return load_the_data(search_term, limit, offset)
# If the results should be invalidated first
if invalidate:
region_invalidate(load, None, 'some_data',
'rabbits', 20, 0)
return load('rabbits', 20, 0)
s1 Region or callable function namespace is requiredR c s s | ] } t | � Vq d S( N( R ( t .0t x( ( s= /opt/alt/python27/lib/python2.7/site-packages/beaker/cache.pys <genexpr>� s N( t callableR R R R
R R R t remove_value( R R R R R ( ( s= /opt/alt/python27/lib/python2.7/site-packages/beaker/cache.pyt region_invalidatey s "
R c B s� e Z d Z d d d d d � Z e d � � Z d � Z e Z d � Z e Z
d � Z e Z d � Z
e j d � d � � Z d
� Z d � Z d � Z d
� Z d � Z d � Z RS( sI Front-end to the containment API implementing a data cache.
:param namespace: the namespace of this Cache
:param type: type of cache to use
:param expire: seconds to keep cached data
:param expiretime: seconds to keep cached data (legacy support)
:param starttime: time when cache was cache was
R c K s� y& t | } t | t � r% | � n Wn! t k
rI t d | � � n X| | | � | _ | pe | | _ | | _ | | _ d S( Ns Unknown cache implementation %r( t clsmapt
isinstanceR t KeyErrort TypeErrorR t
expiretimet starttimet nsargs( t selfR t typeR- R. t expireR/ t cls( ( s= /opt/alt/python27/lib/python2.7/site-packages/beaker/cache.pyt __init__� s
c C sL | t | � } y t | SWn) t k
rG | | | � t | <} | SXd S( N( R t cache_managersR+ ( R3 R t kwt keyR ( ( s= /opt/alt/python27/lib/python2.7/site-packages/beaker/cache.pyR � s
c K s | j | | � j | � d S( N( t
_get_valuet set_value( R0 R7 t valueR6 ( ( s= /opt/alt/python27/lib/python2.7/site-packages/beaker/cache.pyt put� s c K s | j | | � j � S( s* Retrieve a cached value from the container( R8 R ( R0 R7 R6 ( ( s= /opt/alt/python27/lib/python2.7/site-packages/beaker/cache.pyR � s c K s/ | j | | � } | j � r+ | j � n d S( N( R8 t has_current_valuet clear_value( R0 R7 R6 t mycontainer( ( s= /opt/alt/python27/lib/python2.7/site-packages/beaker/cache.pyR' � s c K s| t | t � r$ | j d d � } n d | k r@ | j | | � S| j d | j � | j d | j � t j | | j | � S( Nt asciit backslashreplaceR1 R- R. (
R* t unicodet encodet _legacy_get_valuet
setdefaultR- R. t containert ValueR ( R0 R7 R6 ( ( s= /opt/alt/python27/lib/python2.7/site-packages/beaker/cache.pyR8 � s s� Specifying a 'type' and other namespace configuration with cache.get()/put()/etc. is deprecated. Specify 'type' and other namespace configuration to cache_manager.get_cache() and/or the Cache constructor instead.c K s� | j d | j � } | j d d � } | j d d � } | j j � } | j | � t | j j d | | �} | j | d | d | d | �S( NR- R. R R1 ( t popR- R" R/ t copyt updateR R R8 ( R0 R7 R1 R6 R- R. R t kwargst c( ( s= /opt/alt/python27/lib/python2.7/site-packages/beaker/cache.pyRC � s
c C s | j j � d S( s' Clear all the values from the namespaceN( R t remove( R0 ( ( s= /opt/alt/python27/lib/python2.7/site-packages/beaker/cache.pyt clear� s c C s
| j | � S( N( R ( R0 R7 ( ( s= /opt/alt/python27/lib/python2.7/site-packages/beaker/cache.pyt __getitem__� s c C s | j | � j � S( N( R8 R< ( R0 R7 ( ( s= /opt/alt/python27/lib/python2.7/site-packages/beaker/cache.pyt __contains__ s c C s
| | k S( N( ( R0 R7 ( ( s= /opt/alt/python27/lib/python2.7/site-packages/beaker/cache.pyt has_key s c C s | j | � d S( N( R' ( R0 R7 ( ( s= /opt/alt/python27/lib/python2.7/site-packages/beaker/cache.pyt __delitem__ s c C s | j | | � d S( N( R; ( R0 R7 R: ( ( s= /opt/alt/python27/lib/python2.7/site-packages/beaker/cache.pyt __setitem__
s N( t __name__t
__module__t __doc__R" R4 t classmethodR R; R9 R R R' RL R8 R t
deprecatedRC RM RN RO RP RQ RR ( ( ( s= /opt/alt/python27/lib/python2.7/site-packages/beaker/cache.pyR � s$
t CacheManagerc B sG e Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z RS( c K s2 | | _ | j d i � | _ t j | j � d S( s� Initialize a CacheManager object with a set of options
Options should be parsed with the
:func:`~beaker.util.parse_cache_config_options` function to
ensure only valid options are used.
R
N( RJ RG t regionsR
RI ( R0 RJ ( ( s= /opt/alt/python27/lib/python2.7/site-packages/beaker/cache.pyR4 s c K s, | j j � } | j | � t j | | � S( N( RJ RH RI R R ( R0 t nameRJ R6 ( ( s= /opt/alt/python27/lib/python2.7/site-packages/beaker/cache.pyt get_cache s
c C s? | | j k r" t d | � � n | j | } t j | | � S( Ns Cache region not configured: %s( RY R R R ( R0 RZ R R6 ( ( s= /opt/alt/python27/lib/python2.7/site-packages/beaker/cache.pyt get_cache_region" s
c G s
t | | � S( s� Decorate a function to cache itself using a cache region
The region decorator requires arguments if there are more than
2 of the same named function, in the same module. This is
because the namespace used for the functions cache is based on
the functions name and the module.
Example::
# Assuming a cache object is available like:
cache = CacheManager(dict_of_config_options)
def populate_things():
@cache.region('short_term', 'some_data')
def load(search_term, limit, offset):
return load_the_data(search_term, limit, offset)
return load('rabbits', 20, 0)
.. note::
The function being decorated must only be called with
positional arguments.
( R# ( R0 R R ( ( s= /opt/alt/python27/lib/python2.7/site-packages/beaker/cache.pyR ( s c G s� t | | | � St | � r: | s. | j } n | j } n | sO t d � � n
| j | } | j | | � } d j d � | D� � } | j | � d S( sL Invalidate a cache region namespace or decorated function
This function only invalidates cache spaces created with the
cache_region decorator.
:param namespace: Either the namespace of the result to invalidate, or the
name of the cached function
:param region: The region the function was cached to. If the function was
cached to a single region then this argument can be None
:param args: Arguments that were used to differentiate the cached
function as well as the arguments passed to the decorated
function
Example::
# Assuming a cache object is available like:
cache = CacheManager(dict_of_config_options)
def populate_things(invalidate=False):
@cache.region('short_term', 'some_data')
def load(search_term, limit, offset):
return load_the_data(search_term, limit, offset)
# If the results should be invalidated first
if invalidate:
cache.region_invalidate(load, None, 'some_data',
'rabbits', 20, 0)
return load('rabbits', 20, 0)
s1 Region or callable function namespace is requiredR c s s | ] } t | � Vq d S( N( R ( R$ R% ( ( s= /opt/alt/python27/lib/python2.7/site-packages/beaker/cache.pys <genexpr>w s N( R( R& R R R RY R[ R R' ( R0 R R R R R ( ( s= /opt/alt/python27/lib/python2.7/site-packages/beaker/cache.pyR( G s #
c s> d g � d j d � | D� � � � � � � f d � } | S( sR Decorate a function to cache itself with supplied parameters
:param args: Used to make the key unique for this function, as in region()
above.
:param kwargs: Parameters to be passed to get_cache(), will override defaults
Example::
# Assuming a cache object is available like:
cache = CacheManager(dict_of_config_options)
def populate_things():
@cache.cache('mycache', expire=15)
def load(search_term, limit, offset):
return load_the_data(search_term, limit, offset)
return load('rabbits', 20, 0)
.. note::
The function being decorated must only be called with
positional arguments.
R c s s | ] } t | � Vq d S( N( R ( R$ R% ( ( s= /opt/alt/python27/lib/python2.7/site-packages/beaker/cache.pys <genexpr>� s c s: t j � � � � � � � � � f d � } � | _ | S( Nc sm � d s# � j � � � � d <n � d d j d � � D� � } � � f d � } � d j | d | �S( Ni R c s s | ] } t | � Vq d S( N( R ( R$ R% ( ( s= /opt/alt/python27/lib/python2.7/site-packages/beaker/cache.pys <genexpr>� s c s
� � � S( N( ( ( R R
( s= /opt/alt/python27/lib/python2.7/site-packages/beaker/cache.pyR � s R ( R[ R R ( R R R ( R R
R7 RJ R R0 ( R s= /opt/alt/python27/lib/python2.7/site-packages/beaker/cache.pyR � s
!( R R R ( R
R ( R R7 RJ R0 ( R
R s= /opt/alt/python27/lib/python2.7/site-packages/beaker/cache.pyR! � s N( R" R ( R0 R RJ R! ( ( R R7 RJ R0 s= /opt/alt/python27/lib/python2.7/site-packages/beaker/cache.pyR z s c O sE | j } | j | | � } d j d � | D� � } | j | � d S( s� Invalidate a cache decorated function
This function only invalidates cache spaces created with the
cache decorator.
:param func: Decorated function to invalidate
:param args: Used to make the key unique for this function, as in region()
above.
:param kwargs: Parameters that were passed for use by get_cache(), note that
this is only required if a ``type`` was specified for the
function
Example::
# Assuming a cache object is available like:
cache = CacheManager(dict_of_config_options)
def populate_things(invalidate=False):
@cache.cache('mycache', type="file", expire=15)
def load(search_term, limit, offset):
return load_the_data(search_term, limit, offset)
# If the results should be invalidated first
if invalidate:
cache.invalidate(load, 'mycache', 'rabbits', 20, 0, type="file")
return load('rabbits', 20, 0)
R c s s | ] } t | � Vq d S( N( R ( R$ R% ( ( s= /opt/alt/python27/lib/python2.7/site-packages/beaker/cache.pys <genexpr>� s N( R R[ R R' ( R0 R
R RJ R R R ( ( s= /opt/alt/python27/lib/python2.7/site-packages/beaker/cache.pyt
invalidate� s ! ( RS RT R4 R[ R\ R R( R R] ( ( ( s= /opt/alt/python27/lib/python2.7/site-packages/beaker/cache.pyRX s 3 ,(4 RU t warningst beaker.containerRE t beaker.utilR t beaker.exceptionsR R t beaker.ext.memcachedt extt memcachedt beaker.ext.databaset databaset beaker.ext.sqlat sqlat beaker.ext.googlet googlet MemoryNamespaceManagert DBMNamespaceManagert FileNamespaceManagert MemcachedNamespaceManagert DatabaseNamespaceManagert SqlaNamespaceManagert GoogleNamespaceManagerR) R
R5 t
pkg_resourcest iter_entry_pointst entry_pointt loadt NamespaceManagerRZ t SyntaxErrort sysR R* t exc_infot tracebackR t tbt print_exct warnt getvaluet RuntimeWarningt ImportErrorR# R( t objectR RX ( ( ( s= /opt/alt/python27/lib/python2.7/site-packages/beaker/cache.pyt <module> s^
3 2c
Mini Shell