-PhaJ8dZddlZddlZddlZddlZddlZddlZddlmZ ddl m Z ddl mZddlmZddlmZmZddlZddlmZddlmZdd lmZmZmZejj d Z!d Z"d Z#d Z$GddZ%ddZ&dZ'dZ(dZ)dZ*dS)zLink resolver objects.N)BytesIO)Path) HTTPErrorURLError)ExtensionError)js_index)_W_KW _read_jsonstatus_iteratorzsphinx-gallerycHtj|jdvrd}d|i}tj|d|}tj|}|jdd}|}|dkr5tj t|}n|dkrtd || d }n>t|d d 5}|}dddn #1swxYwY|S) z+Get data over http(s) or from a local file.)httphttpszhMozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.11 (KHTML, like Gecko) Chrome/23.0.1271.64 Safari/537.11z User-AgentNzcontent-encodingplaingzip)fileobjzunknown encoding utf-8r)modeencoding) urllib_parseurlparseschemeurllib_requestRequesturlopenheadersgetreadrGzipFilerrdecodeopen)url user_agentrreqresprdatafids Z/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/sphinx_gallery/docs_resolv.py _get_datar*sUS!!(,=== ,$S$88%c**<##$6@@yy{{ v  =777<<>>DD   !AX!A!ABB B{{7## #C' 2 2 2 c88::D                Ks6DDDctj|d}tj|}||vr ||}nt |}|||<||S)z;Persistent dictionary usage to retrieve the search indexes. searchindex)ospathjoinshelver"r*close)r# gallery_dir cached_file search_indexr's r)get_datar5/si',,{M::K;{++L lC ~~ S Kc>|d}|dkr|d}|dkrtd|d|}|dkrtd|d|}|dkrtd||dz|}i}|D]}|dd\}}|d }|}|d d kr|d d }|dd vr |dd }n3|dkrd}n*|dkrd}n! t |}n#t$rYwxYw|||<|S)zParse the Sphinx index for documentation options. Parameters ---------- index : str The Sphinx index page Returns ------- docopts : dict The documentation options from the page. var DOCUMENTATION_OPTIONSrzconst DOCUMENTATION_OPTIONSz2Documentation options could not be found in index.{z};r :",Nz"'falseFtrueT)findrstrip splitlinessplitrstripint ValueError)indexposendposblockdocoptslinekeyvalues r)parse_sphinx_docoptsrO=s **0 1 1C Qwwjj677 QwwQRRR **S#  C QwwQRRR ZZc " "F zzQRRR #'F" # ) ) + +EG  ""ZZQ'' Uiikk$$  9  #2#J%%''E 8u  !B$KEE g  EE f__EE E        Ns7F FFc0eZdZdZddZdZddZddZdS) SphinxDocLinkResolveraResolve documentation links using searchindex.js generated by Sphinx. Parameters ---------- doc_url : str The base URL of the project website. relative : bool Return relative links (only useful for links to documentation of this package). Fc||_||_||_||_i|_t |t rbtj |d}tj |d}tj |dd}n |rtd|dz}|dz}|dz}tj d kr.t |t r|std d |_ nd |_ t||}d |vrt||_n$t||} t| |_t||} t#j| |_dS)Nz index.htmlzsearchindex.js_staticzdocumentation_options.jszMRelative links are only supported for local URLs (doc_url cannot be absolute)/z/searchindex.jsz!/_static/documentation_options.jsntzHYou have to use relative=True for the local package on a Windows system.TFr8)configdoc_urlr2relative _link_cache isinstancerr-r.r/rnamelower _is_windowsr5rO_docoptsrloads _searchindex) selfrVrWr2rX index_urlsearchindex_url docopts_urlrGrKsindexs r)__init__zSphinxDocLinkResolver.__init__s  &   gt $ $ H Wl;;I gll74DEEO',,w ;UVVKK $8 # I%(99O!$GGK 7==??d " "z'4'@'@ " $4 $D  $D K00 &% / /077DMM{K88G099DM/;77$N622r6cN |jd|}t|tr ||}nq#t$rYdSwxYwt|tt fr2 |D]}|d|kr |dd}ndSn##t $rYdSwxYwn#t$rYdSwxYw|S)Nobjects)r`rZdictKeyErrorlisttuple Exception)rafirstsecondmatchitems r)_get_index_matchz&SphinxDocLinkResolver._get_index_matchs %i07E%&&  !&MEE   44 ED%=11  %$$7f,,$(!HE!E- $t"!   44     44 $ s2B4 AA"B BB B"!B"c|rdnd}|||d}}|||}|Pd|vrL|dd\}}d|||g}|||}|dx}}n8|d} t|d} |d} |jd | }|jd | } |jd d } tj | d| z} |j r<| d d} tj|j | }ntj|j | }d||g}| dkr|} n%| dkr|jd| ddz|z} |dz| z}||fS)z/Get a valid link and type_, False if not found.module module_shortr[N.r robjtypes filenames FILE_SUFFIXz .rst.htmlrT\-objnames#)rsrCr/strr`r^rr-r.splitextr]replacerW posixpath)racobjuse_full_module module_typerorprqlinktype_ fname_idx objname_idxanchorfnameextfullnames r)_get_link_typez$SphinxDocLinkResolver._get_link_types"1Ehh~ [)4E%k29=E-##M;??CG$$U++A.4E ; c400w||DL%88 ~dlE::xx00H||!3*:6{CAFLxW#:&DU{r6c|ddz|dz}||jvr[d}|jdD]-}tj||ddz|dzrd}n.||||j|<|j|\}}|jrJ|Ht j|| }|j r| d d }|d d}|r||fn|S) aResolve the link to the documentation, returns None if not found. Parameters ---------- cobj : Dict[str, Any] Dict with information about the "code object" for which we are resolving a link. - cobj['name'] : function or class name (str) - cobj['module'] : module name (str) - cobj['module_short'] : shortened module name (str) - cobj['is_class'] : whether object is class (bool) - cobj['is_explicit'] : whether object is an explicit backreference (referred to by sphinx markup) (bool) this_url: str URL of the current page. Needed to construct relative URLs (only used if relative=True in constructor). return_type : bool If True, return the type as well. Returns ------- link : str or None The link (URL) to the documentation. type_ : str The type. Only returned if return_type is True. rvrwr[Fprefer_full_moduleruTN)startr|rTrx) rYrVresearchrrXr-r.relpathr]r) rarthis_url return_type full_namerpatternrrs r)resolvezSphinxDocLinkResolver.resolves8(3.f= D, , ,#O;';<  9Wd8ns&:T&\&IJJ&*OE+/*=*=dO*T*TD Y '&y1 e = T-7??4x?88D /||D#..8D +5e}}5r6N)F)__name__ __module__ __qualname____doc__rfrsrrr6r)rQrQssk  03030303d.$$$$L060606060606r6rQfetchingc.t|tr|d|jd|jd|jd}n!t|t r |d|j}td t|j |dS)N z: z ()z The following {} has occurred {}) rZrr#codemsgrreasonloggerwarningformattyper)er error_msgs r)_handle_http_url_errorr!s!Y)88QU88af88888 Ax )((ah((  NN*11$q''2BINNr6c<dD]}||d}|S)Nz~!@$%^&*()+=,./';:"?><[]\{}|`#r~)r)sxs r)_sanitize_css_classr+s+ / IIa   Hr6cft|jddx}r|St|jdt}|}|D]?\}}d|dtD}||hz D]}|||<@||j_|S)a Get the mapping between module names and intersphinx inventories. In some cases, intersphinx inventories may provide documentation for modules _other_ than the one given by the intersphinx_mapping key (e.g., the Python inventory contains documentation for all standard library modules, or Matplotlib contains several `mpl_toolkits`` modules), so this checks py:module for all inventories and adds that additional module mapping. sg_intersphinx_inventoryNintersphinx_named_inventorycDh|]}|ddS)rwr)rC).0qualnames r) z-_get_intersphinx_inventory..Cs6   '/HNN3   "   r6z py:module)getattrenvrjcopyitemsrr)app inventoryintersphinx_inv_origintersphinx_inv module_namedocumented_modulesother_module_names r)_get_intersphinx_inventoryr1sCG%?FFFy#37,I466RR*//11O"6"<"<">">;; Y  3<==dff3U3U   "4{m!C ; ; 1:O- . . ;(7CG$ r6c  +,i}tj|jj|}|dD]\}} |8t |jjt|jj |d||<nt |jj||||<_#ttf$r}t|Yd}~d}~wwxYwtjtj|jj |}d} d+d} dtj|D} t!| d |d d t#| d } t%|} | D]j\}}tj|||}|t#|dzd}tj|||dddz}tj|st)|}i,t+|D]}||}dx}}|D]}|d|dfD]}|dd}|d}||vrX ||||d\}}n5#ttf$r!}t|d|d|Yd}~nd}~wwxYw||cxkrdkrnnd}|a|| vr]| |}|dkr|}n|d|}|D]0\}}|dr||vr||d}|}n1|duo d|vo|d }|| +fd|dD} |d|}!d t3|z}"||"d!t3|zz }"|r|"d"z }"| ||!|"| #,| <n|nt+,t"d$}#d%d&|#D}$t7j|$}%,fd'}&t#,dkrt;|d(d)*5}'|'}(dddn #1swxYwYt;|d+fit>5}'|(D]-})|% |&|)}*|'!|*. dddn #1swxYwYldS),z?Add resolvers for the packages for which we want to show links. reference_urlNT)rXz?{text}z%sz.cRg|]$\}}}|D]}|d||g%S)z.html)endswith)rdirpath_rzfilenames r) z%_embed_code_links..ks^    !GQ !      W % %   (    r6z'embedding documentation hyperlinks for z... fuchsiacLtj|dS)Nr )r-r.basename)rs r)z#_embed_code_links..vs!1!1!A$!7!7r6)colorlengthstringify_funcr z .codeobj.jsonrvrurwrr[)rz resolving )rbuiltinspythonpyzpy:classis_classc3"K|] }|zV dSNr)rpart orig_patterns r) z$_embed_code_links..s90048L4/000000r6zsphx-glr-backref-module-z sphx-glr-backref-type-z sphx-glr-backref-instance)rtitle css_classtext)rMreverse|c3>K|]}tj|VdSr)rescape)rr[s r)rz$_embed_code_links..s*??RYt__??????r6c8|Sr)group)rqstr_repls r)substitute_linkz*_embed_code_links..substitute_linksEKKMM* *r6rr)rw)"r-r.r/buildersrcdirrrQrVsphinx_gallery_confroutdirrrrabspathwalkr lenrexistsr sortedrCr startswithrrrcompiler" readlinesr subwrite)-r gallery_confr2 doc_resolverssrc_gallery_dir this_moduler#rhtml_gallery_dir link_patternperiodflatiteratorrrr full_fnamesubpath json_fnameexample_code_objr[cobjsrrrmodnamecnameinvwantrMrN is_instance name_htmlfull_function_namernames regex_strregexrr(lines_inrLline_outrrs- @@r)_embed_code_linksrMsMgll3;#5{CCO(9??AA&& S &{-BJ2+,,#! ... k**.CJ2C.. k*)$ & & & "1 % % % % % % % % &wrw||CK4F 'T'TUUUL.L 'F  %'W-=%>%>   D  C+CCC4yy77 H155O"d(d(W\\"2GUCC #.//!3556W\\ WeCRCj?&B  w~~j))  &j11+,,D D D$T*E D5? ?  $^ 4d8nE;;G")--"4"4Q"7K LE#m33*7 *D*L*L $jd+M++KD%%!*842 !'EG'E'Ee'E'E #g;;;;;;;;;&. | (F(F-k:"j00#(DD&-#7#7#7#7D*-))++&&JC"~~d33& ',T{1~(+ %T)1&%/1 $Z 00 '$*KK0000<@JJsOO000%% 18-A-A%-A-A*$>AT#BB% !,% 9 Q> 1SS S c|dS|jj}|jjdvrdStdd|d}t |ts|g}|D]}t|||dS)z4Embed hyperlinks to documentation into example code.N)html readthedocsz%embedding documentation hyperlinks...white)r gallery_dirs) rVrrr[rinforZrlr)r exceptionrrr2s r)embed_code_linksrs:1L {666 KK7wKGGG/L lD ) )&$~ #:: #|[9999::r6)r)+rrjsonr-rrr0 urllib.parseparserurllib.requestrequestriorpathlibr urllib.errorrr sphinx.utilsphinx sphinx.errorsr sphinx.searchrutilsr r r utillogging getLoggerrr*r5rOrQrrrrrrr6r)r-s  ######'''''',,,,,,,,((((((""""""5555555555   & &'7 8 8*   333lk6k6k6k6k6k6k6k6\   8P(P(P(f:::::r6