+ :1jlRt^RIHt^RIt^RIt^RIHtHt^RIHt^RI H t ^RI H t ^RI Ht^RIHtHtHtHt^R IHt^R IHt^R IHt] 'd^R IHt^R IHt^RIHt]P>!] 4t!Rt"RRlt#RRlt$RRlt%RRlt&RRlt'RRlt(RRlt)RRlt*R R!lt+R#)"z Handles all caching logic including: - Retrieving from cache - Saving to cache - Determining whether not certain items have expired and need to be refreshed ) annotationsN)datetimetimezonewraps)Path) TYPE_CHECKING)user_cache_dir)APP_NAMENOTICES_CACHE_FNNOTICES_CACHE_SUBDIR%NOTICES_DECORATOR_DISPLAY_INTERVAL_NS)json) CondaError)ChannelNoticeResponse)Sequence)PathType) ChannelNoticec6a\S4RV3Rll4pV#)c V^8dQhRRRR/#)urlstrname)formats"3lib/python3.14/site-packages/conda/notices/cache.py __annotate__%cached_response..__annotate__*s  S  cv<\4p\WV4pV'dV#S!W4pVe \WB4V#N)get_notices_cache_dirget_notice_response_from_cachewrite_notice_response_to_cache)rr cache_dir cache_val return_valuefuncs&& rwrapper cached_response..wrapper)s=)+ 23iH  C  # *< Crr)r(r)sf rcached_responser+(s  4[   Nrc V^8dQhRRRR/#)rchannel_notice_responserreturnboolr)rs"rrr:s2 rcaa\P!\P4oRV3Rllo\;QJd)V3RlVP 4F 'gK R# R#!V3RlVP 44#)z This checks the contents of the cache response to see if it is expired. If for whatever reason we encounter an exception while parsing the individual messages, we assume an invalid cache and return true. c V^8dQhRRRR/#)r expired_atzdatetime | Noner.r/r)rs"rr6is_notice_response_cache_expired..__annotate__Es  o $ rc<VfR#VS8#)z?If there is no "expired_at" field present assume it is expired.Tr)r2nows&ris_channel_notice_expiredCis_notice_response_cache_expired..is_channel_notice_expiredEs  Crc3H<"TFpS!VP4xK R#5ir!)r2).0chnr6s& r 3is_notice_response_cache_expired..Ks$2C "#..112s"TF)rr5rutcanynotices)r-r6r5s&@@r is_notice_response_cache_expiredr@:sj ,,x|| $C  3*223333*22 rcV^8dQhRR/#rr.rr)rs"rrrQs  t rc\\\\R74pV\, pVP RRR7V# \ dp\ RT RT 24hRp?ii;i)zDReturns the location of the notices cache directory as a Path object) appauthorT)parentsexist_okzKError encountered while attempting to create cache directory. Directory: z Exception: N)rr r r mkdirOSErrorr)r% cache_subdirexcs rr"r"Qsv^HABI33L 4$7    (>*5 "   sA A# AA#cV^8dQhRR/#rBr)rs"rrr`srcv\4pV\, pVP4'g \V4V#)a Return path of notices cache If the file does not exist, we create it with natural filesystem timestamps, then set only the modification time to be in the past. This ensures notices are checked and displayed immediately rather than waiting for the full display interval. )r"r is_file_clear_cache_file)r% notices_caches rget_notices_cache_filerP`s4&'I 00M  " "-( rc(V^8dQhRRRRRRRR/#)rrrrr%rr.zChannelNoticeResponse | Noner)rs"rrrrs,       $(  !  rcH\P!W4p\PP V4'dT\ V4;_uu_4p\ P!V4pRRR4\WX4p\V4'gV#R#R# +'giL3;i)z;Retrieves a notice response object from cache if it exists.N) r get_cache_keyospathisfileopenrloadr@)rrr% cache_keyfpdata chn_ntc_resps&&& rr#r#rsq&33CCI ww~~i  )__99R=D,S= / == > ! _s B B! c$V^8dQhRRRRRR/#)rr-rr%rr.Noner)rs"rrrs$ 9 92 9?C 9  9rc\P!VPV4p\VR4;_uu_4p\P !VP V4RRR4R# +'giR#;i)z3Writes our notice data to our local cache location.wN)rrSrrWrdump json_data)r-r%rYrZs&& rr$r$sT&33##YI i   )33R8    s "A"" A3 c$V^8dQhRRRRRR/#)r cache_filerchannel_noticesSequence[ChannelNotice]r.r^r)rs"rrrs$***'>* *rc VUu0uFq"PkK pp\V4;_uu_4pVP4pRRR4\\ R\XP 4444pVP V4p\VR4;_uu_4pVPRPV44RRR4R#uupi +'giL;i +'giR#;i)z;Insert channel notice into our database marking it as read.Nr` ) idrWreadsetfilter splitlinesunionwritejoin)rdrer: notice_idsrZcontentscontents_unique contents_news&& rmark_channel_notices_as_viewedrus%44OS&&OJ4 j  R  &s8+>+>+@'ABCO"((4L j#  " <()  5     sCC!C C  C, c$V^8dQhRRRRRR/#)rrdrrerfr.zset[str]r)rs"rrrs$ 4 4 4'> 4  4rc 8VUu0uFq"PkK pp\V4;_uu_4pVP4pRRR4\\ R\XP 4444pVP V4#uupi +'giLR;i)zCReturn the ids of the channel notices which have already been seen.N)rirWrjrkrlrm intersection)rdrer:rqrZrrrss&& rget_viewed_channel_notice_idsrysu%44OS&&OJ4 j  R  &s8+>+>+@'ABCO  " "? 335  sBB  B cV^8dQhRR/#)rr.r^r)rs"rrrsTrc$\4pV\, pVP4F@pVP4'gKW!8Xd\ V4K/VP 4KB R# \ dKTi;i \ dKfi;i)a[ Invalidate the notices cache so notices will be retrieved and displayed on the next command invocation. For the ``notices.cache`` file we rewind its mtime into the past instead of removing it. On Windows the file can be transiently locked (e.g. by antivirus or lingering file handles), in which case ``unlink()`` raises ``PermissionError`` and the cache would otherwise remain with a recent ``touch()``-ed mtime, suppressing notices on subsequent runs. Per-channel cached response files are still removed when possible, but any ``OSError`` raised while unlinking them is ignored for the same reason. N)r"r iterdirrMrNrHunlink)r%rOrds r clear_cacher~s&'I 00M'') !!##   & !*- !!#*      s$ A.B. A=<A= BBc V^8dQhRRRR/#)rrdrr.r^r)rs"rrrs??(?t?rc2\V4p\VR4;_uu_4pVPR4RRR4VP4pVP\ , p\ P!WPV3R7R# +'giL\;i)r`N)ns) rrWrostat st_mtime_nsr rTutime st_atime_ns)rdrZr past_mtime_nss& rrNrNshj!J j#  "    ?? D$$'LLMHHZ--}=>  s B B ),__doc__ __future__rloggingrTrr functoolsrpathlibrtypingr platformdirsr base.constantsr r r r common.serializer exceptionsrtypesrcollections.abcr common.pathrr getLogger__name__loggerr+r@r"rPr#r$ruryr~rNrrrrs# ' ' $#((&$   8 $$. $   9*" 4B?r