ó
ëEYc@skdd
lZddl
mZ
def
d„ƒYZeƒZdef
d„ƒYZdef
d	„ƒYZd
S(
iÿÿÿÿNi(
tpy3ktNoValuecBs8eZ
dZed
„ƒ
Zer-d„Zn	d„ZRS(sbDescribe a missing cache value.

    The :attr:`.NO_VALUE` module global
    should be used.

    c


Cs|S(
N((
tself((sF/home/tvault/.virtenv/lib/python2.7/site-packages/dogpile/cache/api.pytpayloadsc


CstS(
N(
tFalse(
R((sF/home/tvault/.virtenv/lib/python2.7/site-packages/dogpile/cache/api.pyt__bool__s
c


CstS(
N(
R(
R((sF/home/tvault/.virtenv/lib/python2.7/site-packages/dogpile/cache/api.pyt__nonzero__s
(t__name__t
__module__t__doc__tpropertyRRRR(((sF/home/tvault/.virtenv/lib/python2.7/site-packages/dogpile/cache/api.pyR
s


tCachedValuecBsJeZ
dZeejd
ƒ
ƒ
Zeejdƒ
ƒ
Zd„Zd„Z	RS(s9
Represent a value stored in the cache.

    :class:`.CachedValue` is a two-tuple of
    ``(payload, metadata)``, where ``metadata``
    is dogpile.cache's tracking information (
    currently the creation time).  The metadata
    and tuple structure is pickleable, if
    the backend requires serialization.

    ii
cCstj
||
|fƒS(
N(ttuplet__new__(tclsRtmetadata((sF/home/tvault/.virtenv/lib/python2.7/site-packages/dogpile/cache/api.pyR
-s
c

Cst|j
|jffS(
N(RRR(
R((sF/home/tvault/.virtenv/lib/python2.7/site-packages/dogpile/cache/api.pyt
__reduce__0s
(
RRR	R
toperatort
itemgetterRRR
R(((sF/home/tvault/.virtenv/lib/python2.7/site-packages/dogpile/cache/api.pyRs


	tCacheBackendcBsteZ
dZdZd
„Zed„ƒ
Zd„Zd„Z	d„Z
d„Zd„Zd„Z
d	„Zd
„ZRS(s'Base class for backend implementations.c
Cs
tƒ‚
d
S(sãConstruct a new :class:`.CacheBackend`.

        Subclasses should override this to
        handle the given arguments.

        :param arguments: The ``arguments`` parameter
         passed to :func:`.make_registry`.

        N(
tNotImplementedError(Rt	arguments((sF/home/tvault/.virtenv/lib/python2.7/site-packages/dogpile/cache/api.pyt__init__?s
cs2tˆ
ƒ
‰|t
‡‡
‡fd
†ˆDƒ
ƒ
ƒ
S(Nc
3s2|](}
|
jˆ
ƒ
r|
ˆˆ|
fV
qdS(
N(
t
startswith(t.0tkey(tconfig_dicttprefixt
prefix_len(sF/home/tvault/.virtenv/lib/python2.7/site-packages/dogpile/cache/api.pys	<genexpr>Ps

(tlentdict(RRR((RRRsF/home/tvault/.virtenv/lib/python2.7/site-packages/dogpile/cache/api.pytfrom_config_dictKs




c


CstS(
N(
R(
R((sF/home/tvault/.virtenv/lib/python2.7/site-packages/dogpile/cache/api.pythas_lock_timeoutVs
c
Csd
S(s»Return an optional mutexing object for the given key.

        This object need only provide an ``acquire()``
        and ``release()`` method.

        May return ``None``, in which case the dogpile
        lock will use a regular ``threading.Lock``
        object to mutex concurrent threads for
        value creation.   The default implementation
        returns ``None``.

        Different backends may want to provide various
        kinds of "mutex" objects, such as those which
        link to lock files, distributed mutexes,
        memcached semaphores, etc.  Whatever
        kind of system is best suited for the scope
        and behavior of the caching backend.

        A mutex that takes the key into account will
        allow multiple regenerate operations across
        keys to proceed simultaneously, while a mutex
        that does not will serialize regenerate operations
        to just one at a time across all keys in the region.
        The latter approach, or a variant that involves
        a modulus of the given key's hash value,
        can be used as a means of throttling the total
        number of value recreation operations that may
        proceed at one time.

        N(
tNone(RR((sF/home/tvault/.virtenv/lib/python2.7/site-packages/dogpile/cache/api.pyt	get_mutexYsc
Cs
tƒ‚
d
S(s¦Retrieve a value from the cache.

        The returned value should be an instance of
        :class:`.CachedValue`, or ``NO_VALUE`` if
        not present.

        N(
R(RR((sF/home/tvault/.virtenv/lib/python2.7/site-packages/dogpile/cache/api.pytgetzsc
Cs
tƒ‚
d
S(s²Retrieve multiple values from the cache.

        The returned value should be a list, corresponding
        to the list of keys given.

        .. versionadded:: 0.5.0

        N(
R(Rtkeys((sF/home/tvault/.virtenv/lib/python2.7/site-packages/dogpile/cache/api.pyt	get_multi„s	c
Cs
tƒ‚
d
S(sòSet a value in the cache.

        The key will be whatever was passed
        to the registry, processed by the
        "key mangling" function, if any.
        The value will always be an instance
        of :class:`.CachedValue`.

        N(
R(RRtvalue((sF/home/tvault/.virtenv/lib/python2.7/site-packages/dogpile/cache/api.pytsets
c
Cs
tƒ‚
d
S(s&Set multiple values in the cache.

        ``mapping`` is a dict in which
        the key will be whatever was passed
        to the registry, processed by the
        "key mangling" function, if any.
        The value will always be an instance
        of :class:`.CachedValue`.

        When implementing a new :class:`.CacheBackend` or cutomizing via
        :class:`.ProxyBackend`, be aware that when this method is invoked by
        :meth:`.Region.get_or_create_multi`, the ``mapping`` values are the
        same ones returned to the upstream caller. If the subclass alters the
        values in any way, it must not do so 'in-place' on the ``mapping`` dict
        -- that will have the undesirable effect of modifying the returned
        values as well.

        .. versionadded:: 0.5.0

        N(
R(Rtmapping((sF/home/tvault/.virtenv/lib/python2.7/site-packages/dogpile/cache/api.pyt	set_multi›sc
Cs
tƒ‚
d
S(sH
Delete a value from the cache.

        The key will be whatever was passed
        to the registry, processed by the
        "key mangling" function, if any.

        The behavior here should be idempotent,
        that is, can be called any number of times
        regardless of whether or not the
        key exists.
        N(
R(RR((sF/home/tvault/.virtenv/lib/python2.7/site-packages/dogpile/cache/api.pytdelete²sc
Cs
tƒ‚
d
S(sr
Delete multiple values from the cache.

        The key will be whatever was passed
        to the registry, processed by the
        "key mangling" function, if any.

        The behavior here should be idempotent,
        that is, can be called any number of times
        regardless of whether or not the
        key exists.

        .. versionadded:: 0.5.0

        N(
R(RR$((sF/home/tvault/.virtenv/lib/python2.7/site-packages/dogpile/cache/api.pytdelete_multiÀsN(RRR	R!tkey_manglerRtclassmethodRR R"R#R%R'R)R*R+(((sF/home/tvault/.virtenv/lib/python2.7/site-packages/dogpile/cache/api.pyR4s
			!	
				(	Rtutil.compatRtobjectR
tNO_VALUERRR(((sF/home/tvault/.virtenv/lib/python2.7/site-packages/dogpile/cache/api.pyt<module>
s