+ &j6!a0t$^RIHt^RIt^RIt^RIt^RIHt^RIH t ^RI t ]'d'^RI Ht^RIHtHtHt^RIHt]]]3,tR]R &!R R 4tR# ] d]'g^RI t LOi;i) ) annotationsN) TYPE_CHECKING) atomic_write)Iterator)AnyLiteral TypeAlias)CachingFileSystemr Detailc]tRt^tRtRRltRRltRRltRRR lltR R lt R R lt RRlt RRlt RRlt RRltRRltRtR#) CacheMetadataaDCache 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, also reads metadata stored in pickle format which is converted to JSON when next saved. cV^8dQhRR/#)storagez list[str])formats"}/Users/jameslopez/projects/CWCArchive/cwc-podcast/.venv/lib/python3.14/site-packages/fsspec/implementations/cache_metadata.py __annotate__CacheMetadata.__annotate__$s(( (c VV'g \R4hWn/.VnRVnR#)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 locationFN) ValueError_storage cached_files_force_save_pickle)selfrs&&r__init__CacheMetadata.__init__$s,RS S +-$#(rc V^8dQhRRRR/#)rfnstrreturnr r)rs"rrr7s    rc \VR4;_uu_4p\P!V4pRRR4XP 4F?p\ TPR4\4'gK*\TR,4TR&KA T# +'giLe;i \dL\TR4;_uu_4p\P!T4pRRR4K +'giL;ii;i)z6Low-level function to load metadata from specific filerNrbblocks) openjsonloadrpicklevalues isinstancegetlistset)rr floadedcs&& r_loadCacheMetadata._load7s (b#!1 A!%%/400!!H+.( !  (b$1Q  (sEBB B B BBC3<CC3 C/ )C3/C3c$V^8dQhRRRRRR/#)rmetadata_to_saver r r!r"Noner)rs"rrrDs!//f/#/$/rc JVP'd5\V4;_uu_4p\P!W4RRR4R#\VRR7;_uu_4p\P!W4RRR4R# +'giR#;i +'giR#;i)z4Low-level function to save metadata to specific fileNw)mode)rrr*dumpr()rr6r r0s&&& r_saveCacheMetadata._saveDsn  " " "b!!Q ,0"!bs++q *.,+"!!,++sA=B= B  B" c V^8dQhRRRR/#)r writable_onlyboolr"zIterator[tuple[str, str, bool]]r)rs"rrrMs DD!D (Drc# "\VP4p\VP4FFwr4W2^, 8HpV'd V'gK"\PP VR4WE3xKH R#5i)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) cacheN)lenr enumerateospathjoin)rr?nirwritables&& r_scan_locationsCacheMetadata._scan_locationsMsW  #DMM2JAEzHX'',,w0'C C 3s A A9 ,A9c$V^8dQhRRRRRR/#)rrFr!cfszCachingFileSystem | Noner"z#Literal[False] | tuple[Detail, str]r)rs"rrrcs$6 ,rc L\VP4VP4Fwwr4rVW9dKWa,P4pVeVP'd*VR,VP P V48wdKeVP'd5\P!4VR,, VP8dK\PPWGR,4p\PPV4'gKWs3u# R#)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) ziprKrcopy check_filesfsukeyexpiryrQrErFrGexists)rrFrNr base_rBdetails&&& r check_fileCacheMetadata.check_filecs%((<(<(>@Q@Q$R MRq [%%'F???ve} D8I'I:::$))+v">"Kd4L1Bww~~b!!z!%S rc V^8dQhRRRR/#)r expiry_timeintr"ztuple[list[str], bool]r)rs"rrr~s3331G3rc .pVPR,P4P4Fwr4\P!4VR,, V8gK/VP RR4pV'g\ RV 24h\ PPVPR,V4pVPV4VPR,PV4K VPR,'dU\ PPVPR,R4pVPVPR,V4VPR,'*pW'3#)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. rQr z)Cache metadata does not contain 'fn' for rB) rrSitemsrQr- RuntimeErrorrErFrGrappendpopr<)rr_ expired_filesrFr[r cache_pathwritable_cache_emptys&& r clear_expiredCacheMetadata.clear_expired~s   --b1668>>@LDyy{VF^+k9ZZb)&CD6JWW\\$--"3R8$$R(!!"%))$/A   R dmmB&7AJ JJt((,j 9#'#4#4R#8822rcV^8dQhRR/#rr"r7r)rs"rrrs 1 1d 1rc .pVP4F_wpp\PPV4'd#VP VP V44KNVP /4Ka T;'g/.VnR#)z>Load all metadata from disk and store in ``self.cached_files``N)rKrErFrXrfr3r)rrr rZs& rr)CacheMetadata.loadsk ,,.HB1ww~~b!!##DJJrN3##B' / )00RDrc$V^8dQhRRRRRR/#)rr0rrFr!r"r7r)rs"rrrs!crc VPR,V,pVR,RJd<\VR,4VP,VP8dRVR&R#R#R#)z{Perform side-effect actions on closing a cached file. The actual closing of the file is the responsibility of the caller. r&TNrc)rrC blocksizesize)rr0rFr2s&&& ron_close_cached_file"CacheMetadata.on_close_cached_filesT   b !$ ' X;d "s1X;'7!++'E'OAhK(P "rc V^8dQhRRRR/#)rrFr!r"z str | Noner)rs"rrrsSZrc VPVR4pV'gR#Vwr4VPVPR,4'd5VPR,P V4VP 4V#\ R4h)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. Nzrsj"" % (..)S#XFI&N-N- sA""A81A87A8