2yi/dZddlmZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl m Z ddl m Z mZddlmZddlmZmZmZmZmZddlmZe j2d k\r dd lmZmZndd lmZmZdd lmZdd l m!Z!m"Z"erdd l#m$Z$edZ%ejLe'Z(dZ)ddd6dZ*d7dZ+d8dZ,e j2dk\r e-j\Z/nd9dZ/d:dZ0e j2d k\rddl1m2Z2nddd;dZ2ddZ5d?dZ6ejndZ8d?d Z9ejtd!d@d"Z;dAd#Z dB dEd&Z?d'Z@dFd(ZAejtd!dGd)ZBdHd*ZCdId+ZDdJd,ZEd-ZFd.ZGGd/d0ZHGd1d2ejZJGd3d4ZKdKd5ZLy)Lz Standalone file utils. Nothing in this module should have an knowledge of config or the layout and structure of the site and pages in the site. ) annotationsN) defaultdict)datetimetimezone)PurePath) TYPE_CHECKING CollectionIterableMutableSequenceTypeVar)urlsplit) ) EntryPoint entry_points) exceptions)get_yaml_loader yaml_load)PageT)z .markdownz.mdownz.mkdnz.mkdz.md)pagesc|rFtd|D}tj|jtj }n t }t|jS)z Returns the number of seconds since the epoch for the latest updated page. In reality this is just today's date because that's how pages' update time is populated. c34K|]}|jywN) update_date).0ps W/var/www/html/content_weaver/venv/lib/python3.12/site-packages/mkdocs/utils/__init__.py z&get_build_timestamp..7s7A!--7s)tzinfo) maxr fromisoformatreplacerutcget_build_datetimeint timestamp)r date_stringdts rget_build_timestampr*/sR  777  # #K 0 8 8 8 M  ! r||~ ctjjd}|#tjt j Stjt|t j S)z Returns an aware datetime object. Support SOURCE_DATE_EPOCH environment variable for reproducible builds. See https://reproducible-builds.org/specs/source-date-epoch/ SOURCE_DATE_EPOCH) osenvirongetrnowrr$ fromtimestampr&)source_date_epochs rr%r%>sN ':; ||HLL))  ! !#&7"8(,, GGr+c4tjdS)z Returns the displayable date string. Support SOURCE_DATE_EPOCH environment variable for reproducible builds. See https://reproducible-builds.org/specs/source-date-epoch/ z%Y-%m-%d)r%strftimer+rget_build_dater7Ls   ( ( 44r+)r cJ|r |j|r|dt| S|Sr)endswithlen)ssuffixs r _removesuffixr>Zs( ajj(^F |$ $r+c>ttj|S)z4Reduce duplicate items in a list and preserve order.)listdictfromkeys)data_sets r reduce_listrD`s  h' ((r+)insortc|Srr6)vs rrHisQr+)keyc||}t|}|dkDr-||||dz kr|dz}|dkDr||||dz kr|j||y)Nr)r;insert)axrIkxis rrErEis` V F!eS1q5]* FA!eS1q5]* Ar+cTtjj|}tj|dtjj |r=tjj |tjj |}tj||y)z} Copy source_path to output_path, making sure any parent directories exist. The output_path may be a directory. Texist_okN) r.pathdirnamemakedirsisdirjoinbasenameshutilcopyfile) source_path output_path output_dirs r copy_filer_qse -JKK T* ww}}[!ggll;0@0@0MN  OOK-r+ctjj|}tj|dt |d5}|j |dddy#1swYyxYw)zGWrite content to output_path, making sure any parent directories exist.TrRwbN)r.rTrUrVopenwrite)contentr]r^fs r write_filerf~sO-JKK T* k4 A s AA'crtjj|sytj|D]}|j drtjj ||}tjj |rtj|dktj|y)zKRemove the content of a directory recursively but not the directory itself.N.T) r.rTexistslistdir startswithrXrWrZrmtreeunlink) directoryentryrTs rclean_directoryrps} 77>>) $I&    C ww||Iu- 77==  MM$ % IIdO r+c,|jtS)z Return True if the given file path is a Markdown file. https://superuser.com/questions/249436/file-extension-for-markdown-files )r:markdown_extensionsrTs ris_markdown_filerts ==, --r+z^\d{3}\.html?$c>ttj|S)z=Return True if the given file path is an HTTP error template.)bool_ERROR_TEMPLATE_REmatchrss ris_error_templaterys "((. //r+)maxsizec|jdsd|z}tj|dd}|r|jdSgS)N/rK)rk posixpathnormpathsplitrss r _norm_partsrsC ??3 Tz   d #AB 'D"4::c?**r+c2|jd\}}}d|vr|}t|}t|}d}t||D]\}} || k7rn|dz }dgt||z z||dz} dj | xsd} |j dr| dzS| S)a Return given url relative to other. Both are operated as slash-separated paths, similarly to the 'path' part of a URL. The last component of `other` is skipped if it contains a dot (considered a file). Actual URLs (with schemas etc.) aren't supported. The leading slash is ignored. Paths are normalized ('..' works as parent directory), but going higher than the root has no effect ('foo/../../bar' ends up just as 'bar'). r|rhrrKz..N) rpartitionrzipr;rXr:) urlotherrU_rY other_parts dest_partscommonrMb rel_partsrelurls rget_relative_urlrs!++C0GQ he$KS!J FK,1 6 !  #k*V34z&'7JJI XXi 'CF<<,6C<8&8r+ct|\}}|dk(r|S|%t||j}|dkDrd|z|z}|Stj||S)z:Return a URL relative to the given page or using the base.r../) _get_norm_urlrrr}rX)rTpagebaserelative_levelresults r normalize_urlrsa(.D.  !$1 A ^+f4F >>$ %%r+cv|sd}n/d|vr+tjd|d|jdd}t|}|js|j s|j dr|dfStj|dz}d}|j d |d zr|d z }|j d |d zr||fS) Nrh\zPath 'zh' uses OS-specific separator '\'. That will be unsupported in a future release. Please change it to '/'.r|)r|#rrrrrK) logwarningr#r schemenetlocrkr}r~)rTparsednormrs rrrs   TFU V ||D#& d^F }} )DRx   d #c )DN //%!!3 4! //%!!3 4  r+cB|Dcgc]}t|||c}Scc}w)Soft-deprecated, do not use.)r) path_listrrrTs rcreate_media_urlsrs"9B BM$d + BB BscZtjdt|jddS)Nz=path_to_url is never used in MkDocs and will be removed soon.rr|)warningswarnDeprecationWarningr#rss r path_to_urlrs' MMGI[ <<c ""r+ct|}tjjtjj |j j S)z3Return the directory of an installed theme by name.) get_themesr.rTrUabspathload__file__)namethemes r get_theme_dirrs: L E 77??277??5::<+@+@A BBr+c i}tjtd}|Dchc]5}|j|jjdk(s*|j7}}|D] }|jJ|j|vrS|jjdk7r:t j d|jd|jjd|j|vr{||jj}|Jtjd|jd|jjd |jd |jjd |||j< |Scc}w) z= level.c Ltt|_t|di|y)Nr6)rr&countssuperr)rkwargs __class__s rrzCountHandler.__init__us&1#&6  "6"r+cn|j|}|r!|j|jxxdz cc<|S)NrK)filterrlevelnors rhandlezCountHandler.handleys0 [[  KK '1 , ' r+ct|jjdDcgc]\}}tj||fc}}Scc}}w)NT)reverse)sortedritemslogging getLevelName)rkrGs r get_countszCountHandler.get_countss?9? @Q@Q@S]a9bcA%%a(!,cccs!Ar)rzlist[tuple[str, int]])rrrrrrr __classcell__)rs@rrrrs.#dr+rceZdZdZdZddZy) weak_propertyzHSame as a read-only property, but allows overwriting the field for good.c4||_|j|_yr)funcr)rr s rrzweak_property.__init__s || r+Nc,||S|j|Sr)r )rinstanceowners r__get__zweak_property.__get__s  Kyy""r+r)rrrrrr r6r+rrrsR$#r+rc|dk(r.tjdttjSt dt d|)Nwarning_filterzwarning_filter doesn't do anything since MkDocs 1.2 and will be removed soon. All messages on the `mkdocs` logger get counted automatically.zmodule z has no attribute )rrrrFilterAttributeErrorr)rs r __getattr__rsH   M  ~~ 78,.@I JJr+)rzCollection[Page] | Nonerr&)rr)rstr)r<rr=rrr)rCz Iterable[T]rzlist[T])rMzMutableSequence[T]rNrrr)r\rr]rrr)rdbytesr]rrr)rnrrr)rTrrrv)rTrr list[str])rrrrrr)N)rTrr Page | Nonerrrr)rTrrztuple[str, int])rz Iterable[str]rrrrrr)rrrr)rzdict[str, EntryPoint])rzCollection[str])rUrrr)rrrz str | None)rr)Mr __future__r functoolsrr.r}rerZsysr collectionsrrrpathlibrtypingrr r r r urllib.parser version_infoimportlib.metadatarrimportlib_metadatarrmkdocs.utils.yamlrrmkdocs.structure.pagesrr getLoggerrrrrr*r%r7r removesuffixr>rDbisectrEr_rfrprtcompilerwry lru_cacherrrrrrrrrrrrrr NullHandlerrrrr6r+rr+s #  #'PP!w;;;8+ CLg!=A  H5v$$M ) w4? .$. RZZ 120 T"+#+98 &T" # .EGCC$/C>ACC#C T"#6  &(  d7&&d$ # # Kr+