$g/hdZddlmZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl m Z ddl m Z mZddlmZddlmZmZmZmZmZddlmZe jd kr dd lmZmZndd lmZmZdd lmZdd l m!Z!m"Z"erdd l#m$Z$edZ%ej&e'Z(dZ)ddd\dZ*d]dZ+d^dZ,e jdkre-j.Z/nd_dZ/d`d!Z0e jd krdd"l1m2Z2nd#d$dad)Z2dbd,Z3dcd/Z4ddd1Z5ded4Z6ej7d5Z8ded6Z9ej:d7dfd9Z;dgd<Z dhdkdFZ?dGZ@dldIZAej:d7dmdKZBdndMZCdodOZDdpdRZEdSZFdTZGGdUdVZHGdWdXejIZJGdYdZZKdqd[ZLdS)rz 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)pagesrCollection[Page] | Nonereturnintc|rLtd|D}tj|tj}nt }t|S)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. c3$K|] }|jV dSN) update_date).0ps U/var/www/html/netbox-4.1.3/venv/lib/python3.11/site-packages/mkdocs/utils/__init__.py z&get_build_timestamp..7s$77A!-777777)tzinfo) maxr fromisoformatreplacerutcget_build_datetimer timestamp)r date_stringdts r!get_build_timestampr-/sn  "7777777  #K 0 0 8 8 8 M M  ! ! r||~~  r#rctjd}|tjt jStjt|t jS)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 r!r)r)>sO ':;; |HL)))  !#&7"8"8(, G GGr#strcDtdS)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#r!get_build_dater:Ls    ( ( 4 44r#)r ssuffixcd|r-||r|dt| S|Sr)endswithlen)r<r=s r! _removesuffixrAZs9  %ajj(( %^F |^$ $r#data_set Iterable[T]list[T]cPtt|S)z4Reduce duplicate items in a list and preserve order.)listdictfromkeys)rBs r! reduce_listrI`s  h'' ( ((r#)insortc|Srr9)vs r!rMisQr#)keyaMutableSequence[T]xNonec||}t|}|dkr;||||dz kr#|dz}|dkr||||dz k#|||dS)Nr)r@insert)rOrQrNkxis r!rJrJis SVV FF!eeSS1q5]]** FA!eeSS1q5]]** Ar# source_path output_pathcRtj|}tj|dtj|r=tj|tj|}tj||dS)z} Copy source_path to output_path, making sure any parent directories exist. The output_path may be a directory. Texist_okN) r0pathdirnamemakedirsisdirjoinbasenameshutilcopyfile)rXrY output_dirs r! copy_filerfqs --JK T**** w}}[!!Ogll;0@0@0M0MNN  OK-----r#contentbytesctj|}tj|dt |d5}||ddddS#1swxYwYdS)zGWrite content to output_path, making sure any parent directories exist.Tr[wbN)r0r]r^r_openwrite)rgrYrefs r! write_filern~s--JK T**** k4 A sA))A-0A- directorycttj|sdStj|D]}|drtj||}tj|rtj|dmtj |dS)zKRemove the content of a directory recursively but not the directory itself.N.T) r0r]existslistdir startswithrar`rcrmtreeunlink)roentryr]s r!clean_directoryrxs 7>>) $ $I&&     C   w||Iu-- 7==    M$ % % % % IdOOOO  r#r]boolc6|tS)z Return True if the given file path is a Markdown file. https://superuser.com/questions/249436/file-extension-for-markdown-files )r?markdown_extensionsr]s r!is_markdown_filer}s ==, - --r#z^\d{3}\.html?$cPtt|S)z=Return True if the given file path is an HTTP error template.)ry_ERROR_TEMPLATE_REmatchr|s r!is_error_templaters "((.. / //r#)maxsize list[str]c|dsd|z}tj|dd}|r|dngS)N/rT)rt posixpathnormpathsplitr|s r! _norm_partsrsQ ??3  Tz  d # #ABB 'D" *4::c???*r#urlothercn|d\}}}d|vr|}t|}t|}d}t||D]\}} || krn|dz }dgt||z z||dz} d| pd} |dr| dzn| 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'). rrqrrTz..N) rpartitionrzipr@rar?) rrr^_rb other_parts dest_partscommonrOb rel_partsrelurls r!get_relative_urlrs!++C00GQ he$$KS!!J FK,,1 66 E! #k**V34z&''7JJI XXi 'CF<<,, 86C<<&8r#page Page | Nonebasect|\}}|dkr|S|%t||j}|dkrd|z|z}|Stj||S)z:Return a URL relative to the given page or using the base.Nr../) _get_norm_urlrrrra)r]rrrelative_levelresults r! normalize_urlrsl(..D.  !$11 A  ^+f4F >$ % %%r#tuple[str, int]c|sd}n8d|vr4td|d|dd}t|}|js|js|dr|dfStj|dz}d}|d |d zr|d z }|d |d z||fS) Nrq\zPath 'zh' uses OS-specific separator '\'. That will be unsupported in a future release. Please change it to '/'.r)r#rrrrrT) logwarningr'r schemenetlocrtrr)r]parsednormrs r!rrs '   VT V V V   ||D#&& d^^F } )D)DRx  d # #c )DN //%!!3 4 4! //%!!3 4 4  r# path_list Iterable[str]c$fd|DS)Soft-deprecated, do not use.c2g|]}t|Sr9)r)rr]rrs r! z%create_media_urls..s% B B BM$d + + B B Br#r9)rrrs ``r!create_media_urlsrs$ C B B B B B B BBr#cbtjdt|ddS)Nz=path_to_url is never used in MkDocs and will be removed soon.rr)warningswarnDeprecationWarningr'r|s r! path_to_urlrs2 MGI[ <<c " ""r#namect|}tjtj|jS)z3Return the directory of an installed theme by name.) get_themesr0r]r^abspathload__file__)rthemes r! get_theme_dirrs= LL E 7??27??5::<<+@AA B BBr#dict[str, EntryPoint]c i}ttd}d|D}|D]}|jJ|j|vr:|jjdkr*t jd|jd|jjd|j|vr[||jj}|Jtd |jd |jjd |jd |jjd |||j<|S)zzget_themes.. s0ZZZB)<QYAYAYAYAYAYr#Nrz The theme 'z&' is a builtin theme but the package 'z1' attempts to provide a theme with the same name.zA theme named 'z&' is provided by the Python packages 'z' and 'z'. The one in 'z' will be used.) rGrHrrrrConfigurationErrorrr)themesepsbuiltinsr other_dists r!rrsa%'F"&-- ?0S0S0S"T"TCZZ#ZZZH##z%%% : ! !ejo&A&A/BejBBPUPZP_BBB Z6 ! ! +0J))) KKY%*YYTYT^TcYY"YY8= YYY    #uz Mr#Collection[str]cBtS)z.Return a list of all installed themes by name.)rkeysr9r#r!get_theme_namesr"s <<    r#r^c|}|dddd}||kr|}|S)z2Return a page tile obtained from a directory name.- r)r'lower capitalize)r^titles r!dirname_to_titler'sS E MM#s # # + +C 5 5E {{}}  "" Lr# markdown_src str | NonecT|ddddd}|rh|d}|s>|dsdS|dSdS)rz   rz# N)r'rpopstriprtlstrip)rlineslines r!get_markdown_titler2s   . . 6 6tT B B H H N NE !yy||!!##zz||  t$$ 4{{4   4r#c|D]&}t|ts||vr ||cS'g}||i}|||S)z Given a list, look for dictionary with a key matching key and return it's value. If it doesn't exist, create it with the value of an empty list and return that. ) isinstancerGappend)branchrNnode new_branchs r!find_or_create_noder?so $%%   $;;9    J  D MM$ r#cg}|D]V}t|jj}|}|D]!}t|}t ||}"||W|S)zk Given a list of paths, convert them into a nested structure that will match the pages config. )rparentpartsrrr)pathsnestedr]rrparts r! nest_pathsrRsu F%+ 7 7D#D))D(66FF d Mr#c"eZdZdZd dZd dZd S) DuplicateFilterz!Avoid logging duplicate messages.rrRc,t|_dSr)setmsgsselfs r!__init__zDuplicateFilter.__init__is!ee r#recordlogging.LogRecordryc`|j|jv}|j|j|Sr)msgraddrrrvs r!__call__zDuplicateFilter.__call__ls+ Zty ( fj!!! r#NrrR)rrrry)__name__ __module__ __qualname____doc__rrr9r#r!rrfsB++$$$$r#rc2eZdZdZdfd ZdZd dZxZS) CountHandlerz$Counts all logged messages >= level.rrRc ltt|_tjdi|dS)Nr9)rrcountssuperr)rkwargs __class__s r!rzCountHandler.__init__us5&1#&6&6 ""6"""""r#ch||}|r|j|jxxdz cc<|S)NrT)filterr levelnors r!handlezCountHandler.handleys@ [[   - K ' ' '1 , ' ' ' r#list[tuple[str, int]]cfdt|jdDS)Nc@g|]\}}tj||fSr9)logging getLevelName)rkrLs r!rz+CountHandler.get_counts..s,cccA%a((!,cccr#T)reverse)sortedr itemsrs r! get_countszCountHandler.get_countss2cc @Q@Q@S@S]a9b9b9bccccr#r)rr)rrrrrrr __classcell__)r s@r!rrrsn..######ddddddddr#rc eZdZdZdZddZdS) weak_propertyzHSame as a read-only property, but allows overwriting the field for good.c,||_|j|_dSr)funcr)rrs r!rzweak_property.__init__s | r#Nc4||S||Sr)r)rinstanceowners r!__get__zweak_property.__get__s  Kyy"""r#r)rrrrrr#r9r#r!rrs=RR$$$######r#rc|dkr-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__r(sZ   M    ~ I8IIII J JJr#)rrrr)rr)rr6)r<r6r=r6rr6)rBrCrrD)rOrPrQrrrR)rXr6rYr6rrR)rgrhrYr6rrR)ror6rrR)r]r6rry)r]r6rr)rr6rr6rr6)Nr)r]r6rrrr6rr6)r]r6rr)rrrrrr6rr)rr6rr6)rr)rr)r^r6rr6)rr6rr)rr6)Mr __future__r functoolsrr0rrercsysr collectionsrrrpathlibrtypingrr r r r urllib.parser version_infoimportlib.metadatarrimportlib_metadatarrmkdocs.utils.yamlrrmkdocs.structure.pagesrr getLoggerrrr{r-r)r:r6 removesuffixrArIbisectrJrfrnrxr}compilerr lru_cacherrrrrrrrrrrrrr NullHandlerrrr(r9r#r!r<s #"""""  ######''''''''PPPPPPPPPPPPPP!!!!!!w;;;;;;;;;;;;;;;;;88888888,++++++ GCLLg!!=A       H H H H5555v$MM )))) w4?; . . . .$.... RZ 1220000 T"""+++#"+99998 & & & & &T"""   #" .EGCCCCC###CCCC T"""#"6     &(        ddddd7&ddd$ # # # # # # # # K K K K K Kr#