3j%SSKJr SSKrSSKrSSKJr SSKJr SSKr \(a"SSK J r SSKJ r JrJr SSKJr \\\ 4rS \S '"S S 5rg!\ a \(dSSK r NGf=f) ) annotationsN) TYPE_CHECKING) atomic_write)Iterator)AnyLiteral TypeAlias)CachingFileSystemr Detailc\rSrSrSrSSjrSSjrSSjrSSSjjrSSjr SSjr SS jr SS jr SS jr SS jrSS jrSrg) CacheMetadataaCache metadata. All reading and writing of cache metadata is performed by this class, accessing the cached files and blocks is not. Metadata is stored in a single file per storage directory in JSON format. For backward compatibility. No longer supports pickle. cDU(d [S5eXl0/Ulg)z Parameters ---------- storage: list[str] Directories containing cached files, must be at least one. Metadata is stored in the last of these directories by convention. z3CacheMetadata expects at least one storage locationN) ValueError_storage cached_files)selfstorages _/home/wildlama/miniconda3/lib/python3.13/site-packages/fsspec/implementations/cache_metadata.py__init__CacheMetadata.__init__"s"RS S +-$c[US5n[R"U5nSSS5 WR5H:n[ UR S5[ 5(dM)[US5US'M< U$!,(df  N^=f)z6Low-level function to load metadata from specific filerNblocks)openjsonloadvalues isinstancegetlistset)rfnfloadedcs r_loadCacheMetadata._load1se "c]aYYq\FA!%%/400!!H+.( ! ]s A<< B cx[USS9n[R"X5 SSS5 g!,(df  g=f)z4Low-level function to save metadata to specific filew)modeN)rrdump)rmetadata_to_saver%r&s r_saveCacheMetadata._save:s' "3 '1 II& *( ' 's+ 9c## [UR5n[UR5H@up4X2S- :HnU(a U(dM[RR US5XE4v MB g7f)zYield locations (filenames) where metadata is stored, and whether writable or not. Parameters ---------- writable: bool Set to True to only yield writable locations. Returns ------- Yields (str, str, bool) r cacheN)lenr enumerateospathjoin)r writable_onlynirwritables r_scan_locationsCacheMetadata._scan_locations?sW  #DMM2JAEzHX'',,w0'C C 3sA0A2c[UR5UR5Huup4pVX;aMXaR5nUbqUR(a$USUR R U5:waMYUR(a+[R"5US- UR:aM[RRXGS5n[RRU5(dMXs4s $ g)zIf path is in cache return its details, otherwise return ``False``. If the optional CachingFileSystem is specified then it is used to perform extra checks to reject possible matches, such as if they are too old. uidtimer%F) zipr=rcopy check_filesfsukeyexpiryrAr6r7r8exists)rr7cfsr%base_r3details r check_fileCacheMetadata.check_fileUs%((<(<(>@Q@Q$R MRq [%%'F??ve} D8I'I::$))+v">"Kd4L1Bww~~b!!z!%S rc/nURSR5R5Hup4[R"5US- U:dM&UR SS5nU(d[ SU35e[ RRURSU5nURU5 URSRU5 M URS(aL[ RRURSS5nURURSU5 URS(+nX'4$)zRemove expired metadata from the cache. Returns names of files corresponding to expired metadata and a boolean flag indicating whether the writable cache is empty. Caller is responsible for deleting the expired files. rAr%z)Cache metadata does not contain 'fn' for r3) rrCitemsrAr" RuntimeErrorr6r7r8rappendpopr0)r expiry_time expired_filesr7rLr% cache_pathwritable_cache_emptys r clear_expiredCacheMetadata.clear_expiredps  --b1668>>@LDyy{VF^+k9ZZb)&CD6JWW\\$--"3R8$$R(!!"%))$/A   R dmmB&7AJ JJt((,j 9#'#4#4R#8822rc/nUR5H^un n[RRU5(a"UR UR U55 MMUR 05 M` U=(d 0/Ulg)z>Load all metadata from disk and store in ``self.cached_files``N)r=r6r7rHrTr)r)rrr%rKs rrCacheMetadata.loadsh ,,.HB1ww~~b!!##DJJrN3##B' / )0RDrcURSUnUSSLa0[US5UR-UR:aSUS'ggg)z{Perform side-effect actions on closing a cached file. The actual closing of the file is the responsibility of the caller. rPrTN)rr4 blocksizesize)rr&r7r(s ron_close_cached_file"CacheMetadata.on_close_cached_filesT   b !$ ' X;d "s1X;'7!++'E'OAhK(P "rcURUS5nU(dgUup4URURS5(a0URSR U5 UR 5 U$[ S5e)zRemove metadata of cached file. If path is in the cache, return the filename of the cached file, otherwise return ``None``. Caller is responsible for deleting the cached file. NrPzrsc" % (..)S#XFI&A-A- sAA)(A)