U P’“e’#ã@sVdZddlmZddlmZddlmZdZGdd„deƒZ dekrRe  e j d ¡d S) a´ Cache manager ============= The cache manager can be used to store python objects attached to a unique key. The cache can be controlled in two ways: with a object limit or a timeout. For example, we can create a new cache with a limit of 10 objects and a timeout of 5 seconds:: # register a new Cache Cache.register('mycache', limit=10, timeout=5) # create an object + id key = 'objectid' instance = Label(text=text) Cache.append('mycache', key, instance) # retrieve the cached object instance = Cache.get('mycache', key) If the instance is NULL, the cache may have trashed it because you've not used the label for 5 seconds and you've reach the limit. é)Úenviron)ÚLogger)ÚClock)ÚCachec@s’eZdZdZiZiZeddd„ƒZeddd„ƒZeddd„ƒZ edd d „ƒZ edd d „ƒZ edd d„ƒZ eddd„ƒZ edd„ƒZedd„ƒZdS)rz3See module documentation for more information. NcCs:||dœtj|<itj|<t d|t|ƒt|ƒf¡dS)aßRegister a new category in the cache with the specified limit. :Parameters: `category`: str Identifier of the category. `limit`: int (optional) Maximum number of objects allowed in the cache. If None, no limit is applied. `timeout`: double (optional) Time after which to delete the object if it has not been used. If None, no timeout is applied. )ÚlimitÚtimeoutz.Cache: register <%s> with limit=%s, timeout=%sN)rÚ _categoriesÚ_objectsrÚdebugÚstr)Úcategoryrr©r ú./tmp/pip-unpacked-wheel-xzebddm3/kivy/cache.pyÚregister)sþ  ÿÿzCache.registercCs°t|ddƒrdS|dkr tdƒ‚ztj|}Wn$tk rRt d|¡YdSX|p^|d}|d}|dk rŒttj|ƒ|krŒt  |¡||t   ¡t   ¡dœtj||<dS) ajAdd a new object to the cache. :Parameters: `category`: str Identifier of the category. `key`: str Unique identifier of the object to store. `obj`: object Object to store in cache. `timeout`: double (optional) Time after which to delete the object if it has not been used. If None, no timeout is applied. :raises: `ValueError`: If `None` is used as `key`. .. versionchanged:: 2.0.0 Raises `ValueError` if `None` is used as `key`. Z_nocacheFNz%"None" cannot be used as key in Cachez#Cache: category <%s> does not existrr)ÚobjectrÚ lastaccessÚ timestamp) ÚgetattrÚ ValueErrorrrÚKeyErrorrÚwarningÚlenr Ú _purge_oldestrÚget_time)r ÚkeyÚobjrÚcatrr r rÚappend?s$   üz Cache.appendcCsHz*t ¡tj||d<tj||dWStk rB|YSXdS)aPGet a object from the cache. :Parameters: `category`: str Identifier of the category. `key`: str Unique identifier of the object in the store. `default`: anything, defaults to None Default value to be returned if the key is not found. rrN)rrrr Ú Exception©r rÚdefaultr r rÚgetss z Cache.getcCs2ztj||dWStk r,|YSXdS)aZGet the object timestamp in the cache. :Parameters: `category`: str Identifier of the category. `key`: str Unique identifier of the object in the store. `default`: anything, defaults to None Default value to be returned if the key is not found. rN©rr rrr r rÚ get_timestamp…s zCache.get_timestampcCs2ztj||dWStk r,|YSXdS)abGet the objects last access time in the cache. :Parameters: `category`: str Identifier of the category. `key`: str Unique identifier of the object in the store. `default`: anything, defaults to None Default value to be returned if the key is not found. rNr"rr r rÚget_lastaccess–s zCache.get_lastaccesscCs^zD|dk r*tj||=t d||f¡nitj|<t d|¡Wntk rXYnXdS)a-Purge the cache. :Parameters: `category`: str Identifier of the category. `key`: str (optional) Unique identifier of the object in the store. If this argument is not supplied, the entire category will be purged. NzCache: Removed %s:%s from cachez%Cache: Flushed category %s from cache)rr rÚtracer)r rr r rÚremove§s  ÿ ÿ z Cache.removeéc Csòt d|¡ddl}t ¡}g}tj|D]Z}tj||}|d|dkrZ|kr`q,nq,| ||d|f¡t d|d¡q,d}||krîz4|d7}| |¡\}}t d|||t ¡f¡Wnt k rÞYdSXt  ||¡qŒdS)NzCache: Remove oldest in %srrrz Cache: <<< %fr'zCache: %d => %s %f %f) rr%Úheapqrrrr ÚheappushÚheappoprr&) r Zmaxpurger(ÚtimeZ heap_listrrÚnrr r rr¾s* ÿ zCache._purge_oldestcCsÖt ¡}tjD]Â}|tjkrqtj|d}|dk rT||krT|d9}|tj|d<qttj| ¡ƒD]h}tj||d}tj||d}|dk rš|}|dkr¤qf|||krft d||f¡t  ||¡qfqdS)Nrérz.Cache: Removed %s:%s from cache due to timeout) rrrr rÚlistÚkeysrr%r&)ÚdtZcurtimer rrrZ objtimeoutr r rÚ_purge_by_timeoutÕs*   ÿzCache._purge_by_timeoutc CsVtdƒtjD]B}td| ¡ttj|ƒttj|dƒttj|dƒfƒqdS)z%Print the cache usage to the console.z Cache usage :z * %s : %d / %s, timeout=%srrN)ÚprintrrÚ capitalizerr r )r r r rÚ print_usageøs  üzCache.print_usage)NN)N)N)N)N)N)r')Ú__name__Ú __module__Ú __qualname__Ú__doc__rr Ú staticmethodrrr!r#r$r&rr1r4r r r rr"s*  3      "rZKIVY_DOC_INCLUDEr'N) r8ÚosrZ kivy.loggerrZ kivy.clockrÚ__all__rrZschedule_intervalr1r r r rÚs   c