Current File : //usr/lib/python2.7/site-packages/salt/cache/__init__.pyo
�
���^c @@ s� d Z d d l m Z m Z m Z d d l Z d d l Z d d l Z d d l m
Z
d d l m Z d d l
m Z d d l Z d d l Z e j e � Z d � Z d e f d � � YZ d
e f d � � YZ d S( u\
Loader mechanism for caching data, with data expiration, etc.
.. versionadded:: 2016.11.0
i ( t absolute_importt print_functiont unicode_literalsN( t six( t Serial( t OrderedDictc K@ s. | j d d � r t } n t } | | | � S( u�
Creates and returns the cache class.
If memory caching is enabled by opts MemCache class will be instantiated.
If not Cache class will be returned.
u memcache_expire_secondsi ( t gett MemCachet Cache( t optst kwargst cls( ( s7 /usr/lib/python2.7/site-packages/salt/cache/__init__.pyt factory s R c B@ sz e Z d Z d d � Z d � Z e d � � Z d d � Z d � Z d � Z
d � Z d d � Z d � Z
d d
� Z RS( u�
Base caching object providing access to the modular cache subsystem.
Related configuration options:
:param cache:
The name of the cache driver to use. This is the name of the python
module of the `salt.cache` package. Default is `localfs`.
:param serial:
The module of `salt.serializers` package that should be used by the cache
driver to store data.
If a driver can't use a specific module or uses specific objects storage
it can ignore this parameter.
Terminology.
Salt cache subsystem is organized as a tree with nodes and leafs like a
filesystem. Cache consists of banks. Each bank can contain a number of
keys. Each key can contain a dict or any other object serializable with
`salt.payload.Serial`. I.e. any data object in the cache can be
addressed by the path to the bank and the key name:
bank: 'minions/alpha'
key: 'data'
Bank names should be formatted in a way that can be used as a
directory structure. If slashes are included in the name, then they
refer to a nested structure.
Key name is a string identifier of a data container (like a file inside a
directory) which will hold the data.
c K@ s� | | _ | d k r3 | j d t j j � | _ n | | _ | j d t j j d � | _ t
| � | _ d | _ | | _
| j | j
d <d S( Nu cachediru cache( R t NoneR t saltt syspathst CACHE_DIRt cachedirt configt DEFAULT_MASTER_OPTSt driverR t serialt _modulest _kwargs( t selfR R R
( ( s7 /usr/lib/python2.7/site-packages/salt/cache/__init__.pyt __init__F s c C@ sh t j j | j | j � | _ d j | j � } | | j k r[ | j | | j � | _ n i | _ d S( Nu {0}.init_kwargs(
R t loadert cacheR R R t formatR t modulesR ( R t fun( ( s7 /usr/lib/python2.7/site-packages/salt/cache/__init__.pyt __lazy_initR s
c C@ s# | j d k r | j � n | j S( N( R R
t _Cache__lazy_init( R ( ( s7 /usr/lib/python2.7/site-packages/salt/cache/__init__.pyR Z s
c K@ s� | j d d � } | j | | � } t } | d k r? t } n% t t j � � | | k rd t } n | j | | � } | s� | t k r� | d k r� g } | | � }
x0 |
D] } | j | | � � q� Wn | | � } | j | | | � n | S( uI
Check cache for the data. If it is there, check to see if it needs to
be refreshed.
If the data is not there, or it needs to be refreshed, then call the
callback function (``fun``) with any given ``**kwargs``.
In some cases, the callback function returns a list of objects which
need to be processed by a second function. If that is the case, then
the second function is passed in as ``loop_fun``. Each item in the
return list from the first function will be the only argument for the
second function.
u expirei�Q N(
R t updatedt FalseR
t Truet intt timet fetcht appendt store( R t bankt keyR t loop_funR
t expire_secondsR! t update_cachet datat itemst item( ( s7 /usr/lib/python2.7/site-packages/salt/cache/__init__.pyR ` s"
c C@ s/ d j | j � } | j | | | | | j � S( u�
Store data using the specified module
:param bank:
The name of the location inside the cache which will hold the key
and its associated data.
:param key:
The name of the key (or file inside a directory) which will hold
the data. File extensions should not be provided, as they will be
added by the driver itself.
:param data:
The data which will be stored in the cache. This data should be
in a format which can be serialized by msgpack/json/yaml/etc.
:raises SaltCacheError:
Raises an exception if cache driver detected an error accessing data
in the cache backend (auth, permissions, etc).
u {0}.store( R R R R ( R R) R* R. R ( ( s7 /usr/lib/python2.7/site-packages/salt/cache/__init__.pyR( � s c C@ s, d j | j � } | j | | | | j � S( u�
Fetch data using the specified module
:param bank:
The name of the location inside the cache which will hold the key
and its associated data.
:param key:
The name of the key (or file inside a directory) which will hold
the data. File extensions should not be provided, as they will be
added by the driver itself.
:return:
Return a python object fetched from the cache or an empty dict if
the given path or key not found.
:raises SaltCacheError:
Raises an exception if cache driver detected an error accessing data
in the cache backend (auth, permissions, etc).
u {0}.fetch( R R R R ( R R) R* R ( ( s7 /usr/lib/python2.7/site-packages/salt/cache/__init__.pyR& � s c C@ s, d j | j � } | j | | | | j � S( u�
Get the last updated epoch for the specified key
:param bank:
The name of the location inside the cache which will hold the key
and its associated data.
:param key:
The name of the key (or file inside a directory) which will hold
the data. File extensions should not be provided, as they will be
added by the driver itself.
:return:
Return an int epoch time in seconds or None if the object wasn't
found in cache.
:raises SaltCacheError:
Raises an exception if cache driver detected an error accessing data
in the cache backend (auth, permissions, etc).
u {0}.updated( R R R R ( R R) R* R ( ( s7 /usr/lib/python2.7/site-packages/salt/cache/__init__.pyR! � s c C@ s/ d j | j � } | j | | d | | j �S( u�
Remove the key from the cache bank with all the key content. If no key is specified remove
the entire bank with all keys and sub-banks inside.
:param bank:
The name of the location inside the cache which will hold the key
and its associated data.
:param key:
The name of the key (or file inside a directory) which will hold
the data. File extensions should not be provided, as they will be
added by the driver itself.
:raises SaltCacheError:
Raises an exception if cache driver detected an error accessing data
in the cache backend (auth, permissions, etc).
u {0}.flushR* ( R R R R ( R R) R* R ( ( s7 /usr/lib/python2.7/site-packages/salt/cache/__init__.pyt flush� s c C@ s) d j | j � } | j | | | j � S( u
Lists entries stored in the specified bank.
:param bank:
The name of the location inside the cache which will hold the key
and its associated data.
:return:
An iterable object containing all bank entries. Returns an empty
iterator if the bank doesn't exists.
:raises SaltCacheError:
Raises an exception if cache driver detected an error accessing data
in the cache backend (auth, permissions, etc).
u {0}.list( R R R R ( R R) R ( ( s7 /usr/lib/python2.7/site-packages/salt/cache/__init__.pyt list� s c C@ s, d j | j � } | j | | | | j � S( u
Checks if the specified bank contains the specified key.
:param bank:
The name of the location inside the cache which will hold the key
and its associated data.
:param key:
The name of the key (or file inside a directory) which will hold
the data. File extensions should not be provided, as they will be
added by the driver itself.
:return:
Returns True if the specified key exists in the given bank and False
if not.
If key is None checks for the bank existense.
:raises SaltCacheError:
Raises an exception if cache driver detected an error accessing data
in the cache backend (auth, permissions, etc).
u {0}.contains( R R R R ( R R) R* R ( ( s7 /usr/lib/python2.7/site-packages/salt/cache/__init__.pyt contains� s N( t __name__t
__module__t __doc__R
R R t propertyR R R( R& R! R1 R2 R3 ( ( ( s7 /usr/lib/python2.7/site-packages/salt/cache/__init__.pyR % s & R c B@ sb e Z d Z i Z d � Z e d � � Z d � Z e d � � Z d � Z
d � Z d d � Z
RS( ua
Short-lived in-memory cache store keeping values on time and/or size (count)
basis.
c K@ s� t t | � j | | � | j d d � | _ | j d d � | _ | j d t � | _ | j d t � | _ | j r� d | _ d | _
n d | _ d S( Nu memcache_expire_secondsi
u memcache_max_itemsi u memcache_full_cleanupu memcache_debugi (
t superR R R t expiret maxR" t cleanupt debugt callt hitR
t _storage( R R R
( ( s7 /usr/lib/python2.7/site-packages/salt/cache/__init__.pyR s c C@ so t j � } x\ t j | j � D]H } x? t | j � � D]+ \ } } | d | | k rb | | =q8 Pq8 Wq Wd S( Ni ( R% R t
itervaluesR. R2 R/ ( R R9 t nowt storageR* R. ( ( s7 /usr/lib/python2.7/site-packages/salt/cache/__init__.pyt __cleanup# s
c C@ s@ d j | j � } | | j k r5 | j | | j � S| j Sd S( Nu {0}.storage_id( R R R R
( R R ( ( s7 /usr/lib/python2.7/site-packages/salt/cache/__init__.pyt _get_storage_id- s c C@ sW | j d k rP | j � } | t j k r= t � t j | <n t j | | _ n | j S( N( R? R
RD R R. R ( R t
storage_id( ( s7 /usr/lib/python2.7/site-packages/salt/cache/__init__.pyRB 4 s c C@ sn | j r | j d 7_ n t j � } | j j | | f d � } | d k r� | d | j | k r� | j r� | j d 7_ t j d | j | j t | j � | j � n | | d <| | j | | f <| d St
t | � j | | � } t
| j � | j k rQ| j r t j | j � n t
| j � | j k rQ| j j d t � qQn | | g | j | | f <| S( Ni i u( MemCache stats (call/hit/rate): %s/%s/%st last( R< R= R% RB t popR
R9 R> t logt floatR8 R R& t lenR: R; t _MemCache__cleanupt popitemR" ( R R) R* RA t recordR. ( ( s7 /usr/lib/python2.7/site-packages/salt/cache/__init__.pyR& = s* # &
c C@ s� | j j | | f d � t t | � j | | | � t | j � | j k r� | j ri t j | j
� n t | j � | j k r� | j j d t � q� n t
j
� | g | j | | f <d S( NRF ( RB RG R
R8 R R( RJ R: R; RK R9 RL R" R% ( R R) R* R. ( ( s7 /usr/lib/python2.7/site-packages/salt/cache/__init__.pyR( Y s c C@ s6 | j j | | f d � t t | � j | | � d S( N( RB RG R
R8 R R1 ( R R) R* ( ( s7 /usr/lib/python2.7/site-packages/salt/cache/__init__.pyR1 c s N( R4 R5 R6 R. R t classmethodRK RD R7 RB R& R( R
R1 ( ( ( s7 /usr/lib/python2.7/site-packages/salt/cache/__init__.pyR s
( R6 t
__future__R R R t loggingR% t salt.configR t salt.extR t salt.payloadR t salt.utils.odictR t salt.loadert
salt.syspathst getLoggerR4 RH R t objectR R ( ( ( s7 /usr/lib/python2.7/site-packages/salt/cache/__init__.pyt <module> s
�
Mini Shell