File manager - Edit - /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyo
Back
� �ْSc @ s[ d Z d d l Z d d l Z d d l Z d d l m Z d d l m Z y d d l Z Wn e k ry d d l Z n Xd d l m Z m Z m Z m Z m Z d d l m Z d � Z d e f d � � YZ d e f d � � YZ d e f d � � YZ e j d � j Z d e f d � � YZ e Z d e f d � � YZ d e f d � � YZ d S( s| werkzeug.contrib.cache ~~~~~~~~~~~~~~~~~~~~~~ The main problem with dynamic Web sites is, well, they're dynamic. Each time a user requests a page, the webserver executes a lot of code, queries the database, renders templates until the visitor gets the page he sees. This is a lot more expensive than just loading a file from the file system and sending it to the visitor. For most Web applications, this overhead isn't a big deal but once it becomes, you will be glad to have a cache system in place. How Caching Works ================= Caching is pretty simple. Basically you have a cache object lurking around somewhere that is connected to a remote cache or the file system or something else. When the request comes in you check if the current page is already in the cache and if so, you're returning it from the cache. Otherwise you generate the page and put it into the cache. (Or a fragment of the page, you don't have to cache the full thing) Here is a simple example of how to cache a sidebar for a template:: def get_sidebar(user): identifier = 'sidebar_for/user%d' % user.id value = cache.get(identifier) if value is not None: return value value = generate_sidebar_for(user=user) cache.set(identifier, value, timeout=60 * 5) return value Creating a Cache Object ======================= To create a cache object you just import the cache system of your choice from the cache module and instantiate it. Then you can start working with that object: >>> from werkzeug.contrib.cache import SimpleCache >>> c = SimpleCache() >>> c.set("foo", "value") >>> c.get("foo") 'value' >>> c.get("missing") is None True Please keep in mind that you have to create the cache and put it somewhere you have access to it (either as a module global you can import or you just put it into your WSGI application). :copyright: (c) 2014 by the Werkzeug Team, see AUTHORS for more details. :license: BSD, see LICENSE for more details. i����N( t md5( t time( t iteritemst string_typest text_typet integer_typest to_bytes( t renamec C s6 t | d � r | j � St | d � r2 | j � S| S( s Wrapper for efficient iteration over mappings represented by dicts or sequences:: >>> for k, v in _items((i, i*i) for i in xrange(5)): ... assert k*k == v >>> for k, v in _items(dict((i, i*i) for i in xrange(5))): ... assert k*k == v R t items( t hasattrR R ( t mappingorseq( ( sE /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyt _itemsJ s t BaseCachec B s� e Z d Z d d � Z d � Z d � Z d � Z d � Z d d � Z d d � Z d d � Z d � Z d � Z d d � Z d d � Z RS( s� Baseclass for the cache systems. All the cache systems implement this API or a superset of it. :param default_timeout: the default timeout that is used if no timeout is specified on :meth:`set`. i, c C s | | _ d S( N( t default_timeout( t selfR ( ( sE /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyt __init__d s c C s d S( s� Looks up key in the cache and returns the value for it. If the key does not exist `None` is returned instead. :param key: the key to be looked up. N( t None( R t key( ( sE /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyt getg s c C s d S( s� Deletes `key` from the cache. If it does not exist in the cache nothing happens. :param key: the key to delete. N( ( R R ( ( sE /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyt deleteo s c G s t | j | � S( sf Returns a list of values for the given keys. For each key a item in the list is created. Example:: foo, bar = cache.get_many("foo", "bar") If a key can't be looked up `None` is returned for that key instead. :param keys: The function accepts multiple keys as positional arguments. ( t mapR ( R t keys( ( sE /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyt get_manyw s c G s t t | | j | � � � S( s Works like :meth:`get_many` but returns a dict:: d = cache.get_dict("foo", "bar") foo = d["foo"] bar = d["bar"] :param keys: The function accepts multiple keys as positional arguments. ( t dictt zipR ( R R ( ( sE /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyt get_dict� s c C s d S( s9 Adds a new key/value to the cache (overwrites value, if key already exists in the cache). :param key: the key to set :param value: the value for the key :param timeout: the cache timeout for the key (if not specified, it uses the default timeout). N( ( R R t valuet timeout( ( sE /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyt set� s c C s d S( s* Works like :meth:`set` but does not overwrite the values of already existing keys. :param key: the key to set :param value: the value for the key :param timeout: the cache timeout for the key or the default timeout if not specified. N( ( R R R R ( ( sE /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyt add� s c C s4 x- t | � D] \ } } | j | | | � q Wd S( s� Sets multiple keys and values from a mapping. :param mapping: a mapping with the keys/values to set. :param timeout: the cache timeout for the key (if not specified, it uses the default timeout). N( R R ( R t mappingR R R ( ( sE /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyt set_many� s c G s" x | D] } | j | � q Wd S( s� Deletes multiple keys at once. :param keys: The function accepts multiple keys as positional arguments. N( R ( R R R ( ( sE /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyt delete_many� s c C s d S( sk Clears the cache. Keep in mind that not all caches support completely clearing the cache. N( ( R ( ( sE /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyt clear� s i c C s' | j | | j | � p d | � d S( s Increments the value of a key by `delta`. If the key does not yet exist it is initialized with `delta`. For supporting caches this is an atomic operation. :param key: the key to increment. :param delta: the delta to add. i N( R R ( R R t delta( ( sE /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyt inc� s c C s' | j | | j | � p d | � d S( s Decrements the value of a key by `delta`. If the key does not yet exist it is initialized with `-delta`. For supporting caches this is an atomic operation. :param key: the key to increment. :param delta: the delta to subtract. i N( R R ( R R R" ( ( sE /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyt dec� s N( t __name__t __module__t __doc__R R R R R R R R R R R! R# R$ ( ( ( sE /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyR \ s t NullCachec B s e Z d Z RS( s� A cache that doesn't cache. This can be useful for unit testing. :param default_timeout: a dummy parameter that is ignored but exists for API compatibility with other caches. ( R% R& R' ( ( ( sE /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyR( � s t SimpleCachec B sP e Z d Z d d d � Z d � Z d � Z d d � Z d d � Z d � Z RS( s< Simple memory cache for single process environments. This class exists mainly for the development server and is not 100% thread safe. It tries to use as many atomic operations as possible and no locks for simplicity but it could happen under heavy load that keys are added multiple times. :param threshold: the maximum number of items the cache stores before it starts deleting some. :param default_timeout: the default timeout that is used if no timeout is specified on :meth:`~BaseCache.set`. i� i, c C s5 t j | | � i | _ | j j | _ | | _ d S( N( R R t _cacheR! t _threshold( R t thresholdR ( ( sE /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyR � s c C s� t | j � | j k r� t � } xd t | j j � � D]J \ } \ } \ } } | | k sk | d d k r7 | j j | d � q7 q7 Wn d S( Ni i ( t lenR* R+ R t enumerateR t popR ( R t nowt idxR t expirest _( ( sE /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyt _prune� s . c C s; | j j | d � \ } } | t � k r7 t j | � Sd S( Ni ( i N( R* R R R t picklet loads( R R R2 R ( ( sE /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyR � s c C sO | d k r | j } n | j � t � | t j | t j � f | j | <d S( N( R R R4 R R5 t dumpst HIGHEST_PROTOCOLR* ( R R R R ( ( sE /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyR � s c C sv | d k r | j } n t | j � | j k r= | j � n t � | t j | t j � f } | j j | | � d S( N( R R R- R* R+ R4 R R5 R7 R8 t setdefault( R R R R t item( ( sE /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyR s c C s | j j | d � d S( N( R* R/ R ( R R ( ( sE /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyR s N( R% R& R' R R4 R R R R R ( ( ( sE /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyR) � s s [^\x00-\x21\xff]{1,250}$t MemcachedCachec B s� e Z d Z d d d d � Z d � Z d � Z d d � Z d d � Z d � Z d d � Z d � Z d � Z d � Z d d � Z d d � Z d � Z RS( sd A cache that uses memcached as backend. The first argument can either be an object that resembles the API of a :class:`memcache.Client` or a tuple/list of server addresses. In the event that a tuple/list is passed, Werkzeug tries to import the best available memcache library. Implementation notes: This cache backend works around some limitations in memcached to simplify the interface. For example unicode keys are encoded to utf-8 on the fly. Methods such as :meth:`~BaseCache.get_dict` return the keys in the same format as passed. Furthermore all get methods silently ignore key errors to not cause problems when untrusted user data is passed to the get methods which is often the case in web applications. :param servers: a list or tuple of server addresses or alternatively a :class:`memcache.Client` or a compatible client. :param default_timeout: the default timeout that is used if no timeout is specified on :meth:`~BaseCache.set`. :param key_prefix: a prefix that is added before all keys. This makes it possible to use the same memcached server for different applications. Keep in mind that :meth:`~BaseCache.clear` will also clear keys with a different prefix. i, c C s� t j | | � | d k s1 t | t t f � r| | d k rI d g } n | j | � | _ | j d k r� t d � � q� n | | _ t | � | _ d S( Ns 127.0.0.1:11211s no memcache module found( R R R t isinstancet listt tuplet import_preferred_memcache_libt _clientt RuntimeErrorR t key_prefix( R t serversR RB ( ( sE /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyR - s ! c C sZ t | t � r! | j d � } n | j r: | j | } n t | � rV | j j | � Sd S( Ns utf-8( R< R t encodeRB t _test_memcached_keyR@ R ( R R ( ( sE /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyR < s c G s$ i } t } xm | D]e } t | t � r@ | j d � } t } n | } | j r_ | j | } n t | � r | | | <q q W| j j | j � � } } | s� | j r� i } x+ t | � D] \ } } | | | | <q� Wn t | � t | � k r x* | D] } | | k r� d | | <q� q� Wn | S( Ns utf-8( t FalseR< t unicodeRD t TrueRB RE R@ t get_multiR R R- R ( R R t key_mappingt have_encoded_keysR t encoded_keyt dt rvR ( ( sE /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyR G s* c C sl | d k r | j } n t | t � r9 | j d � } n | j rR | j | } n | j j | | | � d S( Ns utf-8( R R R< R RD RB R@ R ( R R R R ( ( sE /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyR _ s c C sl | d k r | j } n t | t � r9 | j d � } n | j rR | j | } n | j j | | | � d S( Ns utf-8( R R R< R RD RB R@ R ( R R R R ( ( sE /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyR h s c G s* | j | � } g | D] } | | ^ q S( N( R ( R R RM R ( ( sE /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyR q s c C s� | d k r | j } n i } x^ t | � D]P \ } } t | t � rX | j d � } n | j rq | j | } n | | | <q+ W| j j | | � d S( Ns utf-8( R R R R< R RD RB R@ t set_multi( R R R t new_mappingR R ( ( sE /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyR u s c C s] t | t � r! | j d � } n | j r: | j | } n t | � rY | j j | � n d S( Ns utf-8( R< RG RD RB RE R@ R ( R R ( ( sE /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyR � s c G s� g } xd | D]\ } t | t � r4 | j d � } n | j rM | j | } n t | � r | j | � q q W| j j | � d S( Ns utf-8( R< RG RD RB RE t appendR@ t delete_multi( R R t new_keysR ( ( sE /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyR � s c C s | j j � d S( N( R@ t flush_all( R ( ( sE /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyR! � s i c C sQ t | t � r! | j d � } n | j r: | j | } n | j j | | � d S( Ns utf-8( R< RG RD RB R@ t incr( R R R" ( ( sE /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyR# � s c C sQ t | t � r! | j d � } n | j r: | j | } n | j j | | � d S( Ns utf-8( R< RG RD RB R@ t decr( R R R" ( ( sE /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyR$ � s c C s� y d d l } Wn t k r# n X| j | � Sy d d l m } Wn t k rX n X| j � Sy d d l } Wn t k r� n X| j | � Sd S( sA Returns an initialized memcache client. Used by the constructor.i����N( t memcache( t pylibmct ImportErrort Clientt google.appengine.apiRW ( R RC RX RW ( ( sE /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyR? � s N( R% R& R' R R R R R R R R R R R! R# R$ R? ( ( ( sE /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyR; s t RedisCachec B s� e Z d Z d d d d d d d � Z d � Z d � Z d � Z d � Z d d � Z d d � Z d d � Z d � Z d � Z d � Z d d � Z d d � Z RS( sq Uses the Redis key-value store as a cache backend. The first argument can be either a string denoting address of the Redis server or an object resembling an instance of a redis.Redis class. Note: Python Redis API already takes care of encoding unicode strings on the fly. .. versionadded:: 0.7 .. versionadded:: 0.8 `key_prefix` was added. .. versionchanged:: 0.8 This cache backend now properly serializes objects. .. versionchanged:: 0.8.3 This cache backend now supports password authentication. :param host: address of the Redis server or an object which API is compatible with the official Python Redis client (redis-py). :param port: port number on which Redis server listens for connections. :param password: password authentication for the Redis server. :param db: db (zero-based numeric index) on Redis Server to connect. :param default_timeout: the default timeout that is used if no timeout is specified on :meth:`~BaseCache.set`. :param key_prefix: A prefix that should be added to all keys. t localhosti� i i, c C s� t j | | � t | t � ry y d d l } Wn t k rN t d � � n X| j d | d | d | d | � | _ n | | _ | p� d | _ d S( Ni����s no redis module foundt hostt portt passwordt dbt ( R R R< R t redisRY RA t RedisR@ RB ( R R^ R_ R` Ra R RB Rc ( ( sE /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyR � s * c C s< t | � } | t k r+ t | � j d � Sd t j | � S( s� Dumps an object into a string for redis. By default it serializes integers as regular string and pickle dumps everything else. t asciit !( t typeR t strRD R5 R7 ( R R t t( ( sE /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyt dump_object� s c C sW | d k r d S| j d � r0 t j | d � Sy t | � SWn t k rR | SXd S( sV The reversal of :meth:`dump_object`. This might be callde with None. Rf i N( R t startswithR5 R6 t intt ValueError( R R ( ( sE /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyt load_object� s c C s | j | j j | j | � � S( N( Rn R@ R RB ( R R ( ( sE /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyR s c G sX | j r, g | D] } | j | ^ q } n g | j j | � D] } | j | � ^ q? S( N( RB R@ t mgetRn ( R R R t x( ( sE /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyR s #c C sH | d k r | j } n | j | � } | j j | j | | | � d S( N( R R Rj R@ t setexRB ( R R R R t dump( ( sE /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyR s c C sj | d k r | j } n | j | � } | j j | j | | � } | rf | j j | j | | � n d S( N( R R Rj R@ t setnxRB t expire( R R R R Rr t added( ( sE /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyR s c C s{ | d k r | j } n | j j � } xC t | � D]5 \ } } | j | � } | j | j | | | � q4 W| j � d S( N( R R R@ t pipelineR Rj Rq RB t execute( R R R t pipeR R Rr ( ( sE /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyR s c C s | j j | j | � d S( N( R@ R RB ( R R ( ( sE /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyR " s c G sJ | s d S| j r6 g | D] } | j | ^ q } n | j j | � d S( N( RB R@ R ( R R R ( ( sE /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyR % s #c C sO | j r> | j j | j d � } | rK | j j | � qK n | j j � d S( Nt *( RB R@ R R t flushdb( R R ( ( sE /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyR! , s i c C s | j j | j | | � S( N( R@ RU RB ( R R R" ( ( sE /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyR# 4 s c C s | j j | j | | � S( N( R@ RV RB ( R R R" ( ( sE /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyR$ 7 s N( R% R& R' R R Rj Rn R R R R R R R R! R# R$ ( ( ( sE /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyR\ � s t FileSystemCachec B st e Z d Z d Z d d d d � Z d � Z d � Z d � Z d � Z d � Z d d � Z d d � Z d � Z RS( s� A cache that stores the items on the file system. This cache depends on being the only user of the `cache_dir`. Make absolutely sure that nobody but this cache stores files there or otherwise the cache will randomly delete files therein. :param cache_dir: the directory where cache files are stored. :param threshold: the maximum number of items the cache stores before it starts deleting some. :param default_timeout: the default timeout that is used if no timeout is specified on :meth:`~BaseCache.set`. :param mode: the file mode wanted for the cache files, default 0600 s .__wz_cachei� i, i� c C sW t j | | � | | _ | | _ | | _ t j j | j � sS t j | j � n d S( N( R R t _pathR+ t _modet ost patht existst makedirs( R t cache_dirR, R t mode( ( sE /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyR L s c C sG g t j | j � D]0 } | j | j � s t j j | j | � ^ q S( s; return a list of (fully qualified) cache filenames ( R~ t listdirR| t endswitht _fs_transaction_suffixR t join( R t fn( ( sE /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyt _list_dirT s c C s | j � } t | � | j k r� t � } x� t | � D]� \ } } t } d } y_ z> t | d � } t j | � } | | k p� | d d k } Wd | d k r� | j � n XWn t k r� n X| r7 y t j | � Wq� t t f k r� q� Xq7 q7 Wn d S( Nt rbi i ( R� R- R+ R R. RF R t openR5 t loadt closet ExceptionR~ t removet IOErrort OSError( R t entriesR0 R1 t fnameR� t fR2 ( ( sE /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyR4 Z s( c C sF x? | j � D]1 } y t j | � Wq t t f k r= q Xq Wd S( N( R� R~ R� R� R� ( R R� ( ( sE /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyR! q s c C sI t | t � r! | j d � } n t | � j � } t j j | j | � S( Ns utf-8( R< R RD R t hexdigestR~ R R� R| ( R R t hash( ( sE /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyt _get_filenamex s c C s | j | � } yW t | d � } z) t j | � t � k rI t j | � SWd | j � Xt j | � Wn t k rz d SXd S( NR� ( R� R� R5 R� R R� R~ R� R� R ( R R t filenameR� ( ( sE /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyR ~ s c C s; | j | � } t j j | � s7 | j | | | � n d S( N( R� R~ R R� R ( R R R R R� ( ( sE /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyR � s c C s� | d k r | j } n | j | � } | j � y� t j d | j d | j � \ } } t j | d � } z: t j t t � | � | d � t j | | t j � Wd | j � Xt | | � t j | | j � Wn t t f k r� n Xd S( Nt suffixt dirt wbi ( R R R� R4 t tempfilet mkstempR� R| R~ t fdopenR5 Rr Rl R R8 R� R t chmodR} R� R� ( R R R R R� t fdt tmpR� ( ( sE /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyR � s c C s8 y t j | j | � � Wn t t f k r3 n Xd S( N( R~ R� R� R� R� ( R R ( ( sE /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyR � s N( R% R& R' R� R R� R4 R! R� R R R R R ( ( ( sE /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyR{ ; s ( R' R~ t reR� t hashlibR R t cPickleR5 RY t werkzeug._compatR R R R R t werkzeug.posixemulationR R t objectR R( R) t compilet matchRE R; t GAEMemcachedCacheR\ R{ ( ( ( sE /opt/imh-python/lib/python2.7/site-packages/werkzeug/contrib/cache.pyt <module>: s( ( {2�z
| ver. 1.4 |
Github
|
.
| PHP 8.3.31 | Generation time: 0 |
proxy
|
phpinfo
|
Settings