U çZßfã@s2dZddlZddlZddlZgZGdd„dƒZdS)z, ftp_stat_cache.py - cache for (l)stat data éNc@steZdZdZdZdd„Zdd„Zdd„Zd d „Zd d „Z d d„Z dd„Z dd„Z dd„Z dd„Zdd„Zdd„ZdS)Ú StatCacheaZ Implement an LRU (least-recently-used) cache. `StatCache` objects have an attribute `max_age`. After this duration after _setting_ it a cache entry will expire. For example, if you code my_cache = StatCache() my_cache.max_age = 10 my_cache["/home"] = ... the value my_cache["/home"] can be retrieved for 10 seconds. After that, the entry will be treated as if it had never been in the cache and should be fetched again from the remote host. Note that the `__len__` method does no age tests and thus may include some or many already expired entries. iˆcCs"tj |j¡|_d|_| ¡dS)N)ÚftputilÚlrucacheZLRUCacheÚ_DEFAULT_CACHE_SIZEÚ_cacheÚmax_ageÚenable©Úself©r ú6/tmp/pip-unpacked-wheel-g7w5sq0v/ftputil/stat_cache.pyÚ__init__)szStatCache.__init__cCs d|_dS)z1 Enable storage of stat results. TN©Ú_enabledr r r r r0szStatCache.enablecCs d|_dS)aH Disable the cache. Further storage attempts with `__setitem__` won't have any visible effect. Disabling the cache only effects new storage attempts. Values stored before calling `disable` can still be retrieved unless disturbed by a `resize` command or normal cache expiration. FNrr r r r Údisable6s zStatCache.disablecCs ||j_dS)zÁ Set number of cache entries to the integer `new_size`. If the new size is smaller than the current cache size, relatively long-unused elements will be removed. N)rÚsize)r Znew_sizer r r ÚresizeCszStatCache.resizecCsFzt ¡|j |¡WStjjk r@tj d |¡¡‚YnXdS)zŠ Return the age of a cache entry for `path` in seconds. If the path isn't in the cache, raise a `CacheMissError`. zno entry for path {} in cacheN) ÚtimerÚmtimerrÚ CacheKeyErrorÚerrorÚCacheMissErrorÚformat©r Úpathr r r Ú_ageKs ÿzStatCache._agecCs|j ¡dS)z7 Clear (invalidate) all cache entries. N)rÚclearr r r r rWszStatCache.clearcCsB| d¡std |¡ƒ‚z |j|=Wntjjk r<YnXdS)a$ Invalidate the cache entry for the absolute `path` if present. After that, the stat result data for `path` can no longer be retrieved, as if it had never been stored. If no stat result for `path` is in the cache, do _not_ raise an exception. ú/z{} must be an absolute pathN)Ú startswithÚAssertionErrorrrrrrrr r r Ú invalidate]s  zStatCache.invalidatecCs†|jstj d¡‚|jdk rJ| |¡|jkrJ| |¡tj d |¡¡‚n8z |j|WStj j k r€tj d |¡¡‚YnXdS)z‘ Return the stat entry for the `path`. If there's no stored stat entry or the cache is disabled, raise `CacheMissError`. zcache is disabledNzentry for path {} has expiredzentry for path {} not found) rrrrrrr rrrrrr r r Ú __getitem__os  ÿ ÿzStatCache.__getitem__cCs&| d¡st‚|jsdS||j|<dS)zi Put the stat data for the absolute `path` into the cache, unless it's disabled. rN)rrrr)r rÚ stat_resultr r r Ú __setitem__†szStatCache.__setitem__cCs0z ||Wntjjk r&YdSXdSdS)zŒ Support for the `in` operator. Return a true value, if data for `path` is in the cache, else return a false value. FTN)rrrrr r r Ú __contains__s  zStatCache.__contains__cCs t|jƒS)z Return the number of entries in the cache. Note that this may include some (or many) expired entries. )Úlenrr r r r Ú__len__ szStatCache.__len__cCs4g}t|jƒD]}| d |||¡¡qd |¡S)zG Return a string representation of the cache contents. z{}: {}Ú )ÚsortedrÚappendrÚjoin)r ÚlinesÚkeyr r r Ú__str__§szStatCache.__str__N)Ú__name__Ú __module__Ú __qualname__Ú__doc__rr rrrrrr r!r#r$r&r-r r r r rs   r)r1rZ ftputil.errorrZftputil.lrucacheÚ__all__rr r r r Ús