͆h/SrSSKJr SSKrSSKrSSKrSSKrSSKrSSKrSSK r SSK r SSK J r SSK J r Jr SSKJr SSKJrJrJrJrJr SSKJr \ R2S :a SS KJrJr OSS KJrJr SS KJr SS K J!r!J"r" \(aSS K#J$r$ \"S5r%\RL"\'5r(Sr)SS.S6Sjjr*S7Sjr+S8Sjr,\ R2S:a \-R\r/OS9Sjr/S:Sjr0\ R2S :aSSK1J2r2 O SS.S;Sjjr2SSjr5S?Sjr6\Rn"S5r8S?S jr9\Rt"SS!9S@S"j5r;SAS#jrSBSES&jjr?S'r@SFS(jrA\Rt"SS!9SGS)j5rBSHS*jrCSIS+jrDSJS,jrES-rFS.rG"S/S05rH"S1S2\R5rJ"S3S45rKSKS5jrLg)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)pagescU(aD[SU55n[R"U5R[R S9nO [ 5n[UR55$)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. c38# UHoRv M g7fN) update_date).0ps M/opt/services/DDDS/venv/lib/python3.13/site-packages/mkdocs/utils/__init__.py &get_build_timestamp..7s7A--s)tzinfo) maxr fromisoformatreplacerutcget_build_datetimeint timestamp)r date_stringdts rget_build_timestampr+/sR  777  # #K 0 8 8 8 M  ! r||~ c[RRS5nUc$[R"[ R 5$[R"[U5[ R 5$)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,c4[5RS5$)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_dater8Ls   ( ( 44r,)r c^U(a%URU5(aUS[U5*$U$r)endswithlen)ssuffixs r _removesuffixr?Zs+ ajj((^F |$ $r,c>[[RU55$)z4Reduce duplicate items in a list and preserve order.)listdictfromkeys)data_sets r reduce_listrE`s  h' ((r,)insortcU$rr7)vs rrIisQr,)keycU"U5n[U5nUS:a-X2"XS- 5:aUS-nUS:aX2"XS- 5:aMURXA5 g)Nr)r<insert)axrJkxis rrFrFisZ V F!eSq5]* FA!eSq5]* r,cZ[RRU5n[R"USS9 [RR U5(a=[RR U[RR U55n[R"X5 g)zq 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`qsf -JKK T* ww}}[!!ggll;0@0@0MN  OOK-r,c[RRU5n[R"USS9 [ US5nUR U5 SSS5 g!,(df  g=f)zGWrite content to output_path, making sure any parent directories exist.TrSwbN)r/rUrVrWopenwrite)contentr^r_fs r write_filerg~sF-JKK T* k4 A  ! s A A*c[RRU5(dg[R"U5HnUR S5(aMR X5n[RR U5(a[R"US5 Mw[R"U5 M g)zKRemove the content of a directory recursively but not the directory itself.N.T) r/rUexistslistdir startswithrYrXr[rmtreeunlink) directoryentryrUs rclean_directoryrqs 77>>) $ $I&   C ww||I- 77==   MM$ % IIdO'r,c,UR[5$)z Return True if the given file path is a Markdown file. https://superuser.com/questions/249436/file-extension-for-markdown-files )r;markdown_extensionsrUs ris_markdown_filerus ==, --r,z^\d{3}\.html?$c>[[RU55$)z=Return True if the given file path is an HTTP error template.)bool_ERROR_TEMPLATE_REmatchrts ris_error_templaterzs "((. //r,)maxsizecURS5(dSU-n[R"U5SSnU(aURS5$/$)N/rL)rl posixpathnormpathsplitrts r _norm_partsrsF ??3  Tz   d #AB 'D"4::c?**r,cFURS5up#nSU;aUn[U5n[U5nSn[XV5HupX:wa O US- nM S/[U5U- -XgS-n SR U 5=(d Sn UR S5(aU S-$U $)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}rirrLz..N) rpartitionrzipr<rYr;) urlotherrV_rZ other_parts dest_partscommonrNb rel_partsrelurls rget_relative_urlrs!++C0G he$KS!J FK, 6 ! - #k*V34z'7JJI XXi 'CF<<,,6C<8&8r,c[U5upUS:XaU$Ub%[XR5nUS:aSU-U-nU$[R"X 5$)z:Return a URL relative to the given page or using the base.r../) _get_norm_urlrrr~rY)rUpagebaserelative_levelresults r normalize_urlrs[(.D  !$1 A ^+f4F >>$ %%r,cU(dSnO1SU;a+[RSUS35 URSS5n[U5nUR(d'UR (dUR S5(aUS4$[R"U5S-nSnUR S US -5(a!US - nUR S US -5(aM!X4$) Nri\zPath 'zh' uses OS-specific separator '\'. That will be unsupported in a future release. Please change it to '/'.r})r}#rrrrrL) logwarningr$r schemenetlocrlr~r)rUparsednormrs rrrs   TFU V ||D#& d^F }} )D)DRx   d #c )DN //%!!3 4 4! //%!!3 4 4  r,cFUVs/sHn[X1U5PM sn$s snf)Soft-deprecated, do not use.)r) path_listrrrUs rcreate_media_urlsrs$9B B M$d + BB Bsc\[R"S[5 URSS5$)Nz=path_to_url is never used in MkDocs and will be removed soon.rr})warningswarnDeprecationWarningr$rts r path_to_urlrs' MMGI[ <<c ""r,c[5Un[RR[RR UR 5R 55$)z3Return the directory of an installed theme by name.) get_themesr/rUrVabspathload__file__)namethemes r get_theme_dirrs: L E 77??277??5::<+@+@A BBr,c 0n[R[SS95nUVs1sH9o"RcMURRS:XdM-URiM; nnUGHnURceURU;aUURRS:wa;[ R "SURSURRS35eURU;a{XRRnUce[RSURSURRS URS URRS 3 5 X@UR'GM U$s snf) z= level.c N>[[5Ul[TU]"S0UD6 g)Nr7)rr'countssuperr)rkwargs __class__s rrCountHandler.__init__us&1#&6  "6"r,cxURU5nU(a!URUR==S- ss'U$)NrL)filterrlevelnors rhandleCountHandler.handleys0 [[  KK '1 , ' r,c[URR5SS9VVs/sHup[R"U5U4PM snn$s snnf)NT)reverse)sortedritemslogging getLevelName)rkrHs r get_countsCountHandler.get_countssC9? @Q@Q@S]a9bc9b%%a(!,9bcccs$A)rr)rzlist[tuple[str, int]]) rrrrrrrr r __classcell__)rs@rrrrs.#ddr,rc(\rSrSrSrSrSSjrSrg) weak_propertyizHSame as a read-only property, but allows overwriting the field for good.c2XlURUlgr)funcr)rrs rrweak_property.__init__s || r,Nc.UcU$URU5$r)r)rinstanceowners r__get__weak_property.__get__s  Kyy""r,)rrr)rrrrrrrrr7r,rrrsR$#r,rcUS:Xa0[R"S[5 [R"5$[ S[ <SU<35e)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)rDz Iterable[T]rzlist[T])rNzMutableSequence[T]rOrrr)r]rr^rrr)rebytesr^rrr)rorrr)rUrrrw)rUrr list[str])rrrrrr)N)rUrr Page | Nonerrrr)rUrrztuple[str, int])rz Iterable[str]rr!rrrr)rrrr)rzdict[str, EntryPoint])rzCollection[str])rVrrr)rrrz str | None)rr)Mr __future__r functoolsrr/r~rer[sysr collectionsrrrpathlibrtypingrr r r r urllib.parser version_infoimportlib.metadatarrimportlib_metadatarrmkdocs.utils.yamlrrmkdocs.structure.pagesrr getLoggerrrrsr+r&r8r removesuffixr?rEbisectrFr`rgrqrucompilerxrz lru_cacherrrrrrrrrrrrrr NullHandlerrrrr7r,rr5s #  #'PP!w;;;8+ CL !=A  H5v$$M ) w4? .$.ZZ 120  T"+#+98 & T" # .EGCC$/C>ACC#C  T"#6  &(  d7&&d$ # # Kr,