G@d6dZddlZddlZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl m Z m Z ddlmZmZddlmZddlmZmZmZmZmZmZmZmZmZmZmZmZm Z m!Z!m"Z"m#Z#GddeZ$d d Z%d Z&dS) z PyDoc patchN)_DEV)is_dark_interfaceget_font)to_text_string) classnameclassify_class_attrsdescribeDocformat_exception_onlyHelperHTMLRepr_is_bound_method ModuleScannerlocatereplace visiblenameisdatagetdocdeque _split_listceZdZdZeZejZejZdZddZ ddZ d Z d Z d d Z d ZdZdZdZdZdZdiiifdZd!dZd"dZddiifdZdZddiiidfdZdZd#dZd"dZd#dZd!dZdS)$ CustomHTMLDocz Formatter class for HTML documentation. See: https://github.com/aroberge/mod_pydoc/blob/master/mod_pydoc/pydoc.py cd|d|dS)Format an HTML page.z+ Python: z. z )selftitlecontentss Elib/python3.11/site-packages/spyder/plugins/onlinehelp/pydoc_patch.pypagezCustomHTMLDoc.page.sUUHHH & &c2d||pdS)zFormat a page heading.z`
{}{}
 format)rrextrass r headingzCustomHTMLDoc.heading8s" uf()) *r"Nr%cd||}|r|d|||z}n|r|d||z}d|}|dz|zS)z Format a section with a heading.z; zI z z{}
{}
{} {}
{}
{}{}

z r&) rrrwidthprelude marginaliagap css_classresults r html_sectionzCustomHTMLDoc.html_section?s  y%    66*gs334FF 6$fZ556F.44X>>44x??r"cNd|}|j|g|Ri|S)z$Format a section with a big heading.z%{})r'r2)rrargskwargss r bigsectionzCustomHTMLDoc.bigsectionVs87>>uEE t 8888888r"c ~||}t|dddddddd S)z!Format literal preformatted text.z z  r% 
)escape expandtabsrrtexts r preformatzCustomHTMLDoc.preformat[sB{{4??,,--tVWfg (D(<< dr:zz.%s
)lenrange)rlistr'colsr1rowscolis r multicolumnzCustomHTMLDoc.multicolumnasD $q 4';; & &CJ9 48T#Xd]33 A As4yy==#ffT!Woo5@Fg%FF?&HHr"c d|zS)z Grey span.z%srr=s r greyzCustomHTMLDoc.greyos -44r"c:|D]}||vrd||d|dcS|S)z:Make a link for an identifier, given name-to-URL mappings. r)rnamedictsdicts r namelinkzCustomHTMLDoc.namelinkssE B BDt|||04T DDDAAAA r"c |jtj|j}}t ||r1t |||urd|jd|dt||dSt||S)zMake a link for a class.rO.html#rPrQ)__name__sysmodulesget __module__hasattrgetattrr)robjectmodnamerRmodules r classlinkzCustomHTMLDoc.classlinkzs 8I(J(Jf 64  CWVT%:%:f%D%D%Dy'A'A'A'AC C)))r"c(d|jd|jdS)zMake a link for a module.rO.html">rQ)rXrr_s r modulelinkzCustomHTMLDoc.modulelinks! OOOV___. .r"c|\}}}}|r||S|r |d|d}nd|z}|rd|z}n|}d|d|dS)z;Make a link for a module or package to display in an index...htmlz%s.htmlz%s (package)rOrPrQ)rM)r modpkginforRpath ispackageshadowedurlr>s r modpkglinkzCustomHTMLDoc.modpkglinks{*4'dIx  #99T?? "  #"&$$-CCd"C  &-DDD(+TTT22r"cd|d|dS)zMake a link to source file.zr;funcsclassesmethodsresultsherepatternmatchstartendallschemerfcpepselfdotrRrns r markupzCustomHTMLDoc.markupsC &4;*011 NN4..E JE3 NN66$tEz"233 4 4 438<<>> 0Cc7D =fSkk))#x88SSSABBBB =?#c((JVVC[[[[IJJJJ =@3s88KVVC[[[[IJJJJc#a%iC''MM$@@BBBB =y4/0000t}}T7;;<<<D1 2 vvd455k**+++wwwr"cd}|D]}t|tdur|\}}|dz}||||z}|rU||fkrNg}|D]+} ||| |,|dzd|zdz}|dz}t|tgur|d||||zz}d |zS) zS Produce HTML for a class tree as given by inspect.getclasstree(). r#rz
ru, )z
z
%s
z
%s
)typerbrzr} formattree) rtreer`parentr1entrycbasesparentsbases r rzCustomHTMLDoc.formattrees ' 'EE{{d2hh&& 5&$..G"<"<<EUvi// G %FFt~~dG'D'DEEEE#c\DIIg,>,>>DF)+eR(("3doo7A7'7'#''2V;;r"c 0|j} |j}n#t$rd}YnwxYw|d}g}t t |dz D]O}|dd|d|dz||Pd||ddz} tj |} | } tj dkrddl } | | } | | } n#t $rd} YnwxYwg}t#|d rwt%|j}|dd d kr*|ddd kr|d d}|d |zt#|dr:|t%|j|r| dd|zz} |}|dt1z}nd}d| z|z}| |}tj|tj}gi}}tj|tjD]T\}}|tj|p||ur5t=|||r$|||fd|zx||<||<U|D]z\}}|jD]m}|j|j }}tj!"|}||kr8|r6t#||r&tG|||ur||vr|dz|zx||<||<n{gi}}tj|tj$D]\}}|*tj%|stj||urOt=|||r>|||fd|z||<tj&|r ||||<g}tj|tND]-\}}t=|||r|||f.(tS|j*||}|od|}|d|zz}t#|drg}tWj,|j-D]\} }}!||||!df |./|j0}"|1d|"dz}n6|r4/|fd}"|1d|"dz}|rd |D}#2tj3|#d|g}"|D]1\}}|"4|||||2|1d!d"|"d#z}|rdg}"|D]1\}}|"4|||||2|1d$d"|"d%z}|rag}"|D].\}}|"4||/|1d&d'|"d(z}t#|d)rH(t%|j5j*}"|1d*|"d+z}t#|d,rH(t%|j6j*}"|1d-|"d.z}|S)/z/Produce HTML documentation for a module object.NrhrBz/{}win32rz (built-in) __version__ z $Revision: $z version %s__date__z (%s)rz-
Module Referencer#zindex
#rWz#-z{}z

%s

__path__zPackage Contentspackager0c:|dSNrB)rf)trs r z)CustomHTMLDoc.docmodule..6s4??1Q4#8#8r"Modulesracg|]\}}|Srr).0keyvalues r z+CustomHTMLDoc.docmodule..;s;;;>R!,VW_EE : :JC&u--7FBBsC00:NNC<00003c 9E#Ju! : :JC : :#}doW11d??v?'F2F?vs++t33e++ '( 2S 8:E#Jt  :2u!,VW5FGG 2 2JC%e,, %e,,66sC002LL#u...!%E#J)%002',Sze !,VV<< * *JC3V,, * S%L)))kk&..$.%GG3'..s33-#-- 6: & & 9G,3,@O-%-% : :('5ua89999 LLNNN''AAHdoo"H .CCCFF  9''8888::Hdoo8x.999F  D;;7;;;I 4Y B BDIIKH% C C UMM%dE5AACCCCdoo388H--.DDDF  HH# C C UMM%dE5AACCCCdooSXXh//;.HHHF  CH" ; ; U eS 9 9::::doo h//6.CCCF 6< ( ( 8{{3v'8#9#94>JJHdoo(h.888F 6= ) ) :{{3v'9#:#:DNKKHdoo8y.:::F s !! AD!! D0/D0c*j}|p|}j}g} | jGfdd} | tt j} t | dkrVd| D])} d| j z*dfd} fd}fd }fd tD}i|D]O\}}}}d |zd z|zx|<} t|}n#t$rYnwxYw ||<@#t$rYLwxYw|r| r| n|d dt|fd\}}t jur|}Nurd}ndj z}|dz }|d| d|z|d}| d|z|d}| d|z|d}|d|z|d}|d|z|d}|gksJ|}|d| } ||kr d|d |d!}n |d"|d#|d!}|rPg}|D]0} || j 1|d$d%|zz}t+j}|od&|z}|| d'|d()S)*z.Produce HTML documentation for a class object.c eZdZdZfdZdS).CustomHTMLDoc.docclass..HorizontalRulecd|_dSNrneedoners r __init__z7CustomHTMLDoc.docclass..HorizontalRule.__init__gs   r"c:|jr dd|_dS)Nz
rBr)rpushs r maybez4CustomHTMLDoc.docclass..HorizontalRule.maybejs%<#DNNN  r"N)rXr\ __qualname__rr)rsr HorizontalRulerfs= ! ! ! ! ! ! ! ! ! !r"rz&
Method resolution order:
z
%s

c ft||\}}|r ||D]x\}}}} t |}||  n0#t$r#|| YnwxYwdy|S)Nr9)rrr^r Exception_docdescriptor)msgattrs predicateokrRkindhomeclsrrr~hrmdictrr_rrs r spillz%CustomHTMLDoc.docclass..spillzs#E955IB  S 24  .D$ % ' 5 5T]]!4eWe"$$%%%% %DDDT00ucBBCCCCC DDJJJJLsA55*B"!B"ct||\}}|rI ||D]'\}}}} || (|SN)rrr) rrrrrRrrrrrrrs r spilldescriptorsz0CustomHTMLDoc.docclass..spilldescriptorss}#E955IB @ S 24@@.D$D,,T5#>>????Lr"ct||\}}|r ||D]\}}}}t||}t |st j|rt|dd} nd} | d|znAt|j } d| z} d|| dd|S)N__doc__
%s

%s

z
r9) rrdocotherr^callablerisdatadescriptorrrr?)rrrrrRrrrrrrr~rrrr_rrs r spilldataz)CustomHTMLDoc.docclass..spilldatas(#E955IB  S 24  .D$==)>)>cJJD#'*B5*I*I#%eY=="{>EFFFF"kk&--*/%AA83>44EFFFDJJJJLr"cHg|]\}}}}t|||||fS))obj)r)rrRrclsrr_s r rz*CustomHTMLDoc.docclass..sL333+T4e&1113$c5)333r"r-rc|duS)Nrr)r thisclasss r rz(CustomHTMLDoc.docclass..s1!2r"z defined herezinherited from %sz:
c|dSrrrs r rz(CustomHTMLDoc.docclass..s QqTr")rz Methods %sc|ddkS)NrBmethodrrs r rz(CustomHTMLDoc.docclass..sAaDH$4r"zClass methods %sc|ddkS)NrBz class methodrrs r rz(CustomHTMLDoc.docclass..sAaDN$:r"zStatic methods %sc|ddkS)NrBz static methodrrs r rz(CustomHTMLDoc.docclass..sAaDO$;r"zData descriptors %sc|ddkS)NrBzdata descriptorrrs r rz(CustomHTMLDoc.docclass..sqt7H/Hr"zData and other attributes %sc|ddkS)NrBrrrs r rz(CustomHTMLDoc.docclass..s!r"r# class z = class z(%s)rz%s
 docclassr)rXrrzrrgetmrorDrrbr\r r^rrpopleftrbuiltinsr_rr}rrr?r2)rr_rRrr~rrrealnamerrrmrorrrr rrrrranchor inheritedtagrrrrrrrs`` ``` @@@@r rzCustomHTMLDoc.docclass[s'?x  ! ! ! ! ! ! ! ! ! !^  GN6**++ s88a<< HHJJJ D: ; ; ; J J_t~~d6<6G(I(IIJJJJ DOOO            (                    *3333/CF/K/K333).   %Cw"%*s"2S"8 8E#J --      &e     !  (KKMM !!HQK *2222 4 4 E9HO++!f$$$)DNNv0-2-22 9 C JJ>>J * * *E,,e4466EE,s2E::<|r/||jvr&|j||urd |jdz|zd |d }d} n|}d| d |d|} d}t j|rU t j|}n#ttf$rd}YnwxYw|r$t|}|dkrd|z} |dd}|sd}| |z| o| | z}| rd|zS| t||j|||}|od|z}d|d|dS)z;Produce HTML documentation for a function or method object.r#rrz from Nz method of %s instancez unbound %s methodrz" class="signature">rz $$D DsDD0/D0cg}|j}|r|d|z|j6|t||j}|d|z|dd|S)Nz
%s
z
%s
z
r#)rzrrrr?r})rrRrrrrrs r rzCustomHTMLDoc._docdescriptor:s~  - D$t+ , , , = $++fUmmT^<z&CustomHTMLDoc.index..ZsD@@RFc"gg////////@@@@@@r"r#rBindexr) rranyrzrrDrKror6)rdirrmrrrRrrs r rFzCustomHTMLDoc.indexTs  H%,%93%%@%@   !HdE@@4@@@@@  NND"eTX-=> ? ? ?HTNN  w<< ''AAH??3G?DD D2r")r#)r*r#Nr%r#)r@r)NN)NNN)rXr\rrr_repr_instancer'r;r!r)r2r6r?rKrMrUrbrfrorrrrrrr(r6rr;rr@rFrr"r rr sXZZN  D  "F&&&*****+-5@@@@.999 <<< I I I I555***... 3 3 3888#'b"b' ' ' ' V<<<<*B%)d"b[;[;[;[;z222'+R<E<E<E<E|    6666'''' 6666r"r text/htmlc  G fddt}|fd fd fdfd fdfd fd fd  fd  f d }|d r |dd}|dkrtjtjt }tj||}t|5}d| cdddS#1swxYwYn|dkr ||Sttd||fz)aBPydoc url handler for use with the pydoc server. If the content_type is 'text/css', the _pydoc.css style sheet is read and returned if it exits. If the content_type is 'text/html', then the result of get_html_page(url) is returned. See https://github.com/python/cpython/blob/master/Lib/pydoc.py c eZdZfdZdZdS)_url_handler.._HTMLDocc td}td}trd}nd}d|z}d|z}d|d ||d |d  d |d }|S)r rich_font)optionfontzstatic/css/dark_pydoc.csszstatic/css/light_pydoc.cssz2z'zY Pydoc: zM z, z*
z
)rfamilyr) rrrrich_text_fontplain_text_fontcss_pathcss_link code_style html_page html_navbars r r!z#_url_handler.._HTMLDoc.pagevs%[999@@BBN&f555<<>>O "" 867E  :OK JUUHHjjj... []]]]HHH.I r"cd|d|dS)Nz Python 
T)tersea )r;rpython_version python_buildpython_compiler)rhtmls r rYz!_url_handler..html_navbars++x/F/H/H/H/H/7/D/F/Fq/I/I/I/7/G/I/I/I/IKLL(77DKK(9(E(E(EFFFF#H Hr"cd}d}dtjD}||}|dd|dzg}i}tjD]+}|||,|dd d |fS) z Index page.cd|d|dSNrOrdrQrrRs r bltinlinkz3_url_handler..html_index..bltinlink15ttt< Index of Modulescg|] }|dk| S)__main__r)rrRs r rz4_url_handler..html_index..s,((($J&&&&&r"z

zBuilt-in Modulesbuiltin_modulesrzT

pydoc by Ka-Ping Yee<ping@lfw.org>

zIndex of Modulesr#) r)rYbuiltin_module_namesrKr6rkrzrFr})rhr)namesrseenrHrcs r html_indexz _url_handler..html_indexs = = =,,>??((#":(((##E955UT__ 4E&5&G&GGH8 3 3C OODJJsD11 2 2 2 2 ' ( ( ("2778#4#444r"cgfd}tj5tjdt||dddn #1swxYwYd}g} d}D]&\}}||||z'| d|d |d z}d|fS) zSearch results page.cv|dddkr |dddz}||od|zfdS)Niz .__init__z (package)z- )rz)rkr`desc search_results r callbackz3_url_handler..html_search..callbacksPrss|{**!#2#,5  '4+?D4K!@ A A A A Ar"ignoreNcd|d|dSrfrrgs r rhz4_url_handler..html_search..bltinlinkrir"zSearch Resultszkey = {}r^rxr) warningscatch_warningsfilterwarningsrrunr)rzr6r'r}) rrurhrr)rRrsrrtrcs @r html_searchz!_url_handler..html_searchse  B B B B B  $ & & / /  #H - - - OO  # . . . / / / / / / / / / / / / / / /  = = =,,/00' 3 3JD$ NN99T??T1 2 2 2 2T__   c " "FKK$8$8H-NNN))s7A  A$'A$ct|dd}tj|5}|}dddn #1swxYwYd|z}d}|d||dz}d |z|fS) z-Get and display a source file listing safely.z%20r8N 
%s
z File ListingzFile: {}getfilerz getfile %s)rtokenizeopenr;readr)r6r')rkfplinesbodyr)rrcs r html_getfilez"_url_handler..html_getfiles||E3'' ]4  +BKK **E + + + + + + + + + + + + + + +&,,~..T__Z->->t-D-Dd7@-BBBd"H,,s(A  A$'A$cd}ddz}ttj}||}|d|dz}d|fS)zIndex of topic texts available.cd|d|dSNz.html_topicss B B B,,011F:v}))++,,##E955T__ h(-444!!r"cd}ttj}d}||}|dzd|dz}d|fS)zIndex of keywords.zIndex of Keywordscd|d|dSrrrgs r rhz6_url_handler..html_keywords..bltinlinkrr"r^Keywordskeywordsr)r)rr rrrKr6)r)rnrhrrcs r html_keywordsz#_url_handler..html_keywordss,,233v++--.. B B B##E955V#doo J'6'8'888##r"ctj}t||}||\}}||jvrd}nd}|}d|z}||d}|rRt| }d} ||} d|d}|d|d |||ffS) zTopic or keyword help page.KeywordTopicr~rrcd|d|dSrrrgs r rhz7_url_handler..html_topicpage..bltinlinks:>$$EEr"zRelated help topics: r8r#) ioStringIOr _gettopicrr)rr6rrrKr2r}) topicbufhtmlhelprxrefsrr)rhrcs r html_topicpagez$_url_handler..html_topicpages"kmm#s##",,U33% H% % %EEE,,u%%"T[[%:%::??5(h?GG  :5;;==))E F F F$$UI66E%%&=u08&::E 55%%((E2335 5r"ct|d}|"|dkrttdt|}||}||fS)NrB) forceloadNoneziThere was an error while retrieving documentation for the object you requested: Object could not be found)rr.rr r)rnr rcontentrcs r html_getobjz!_url_handler..html_getobjsvSA&&& ;3&==LMMNN N --S))g~r"cd}tr=dfdtt ||D}ndt |z}|||dz}d|z|fS)NErrorr^c3BK|]}|VdSr)r;)rlinercs r rEz3_url_handler..html_error..*sG#J#J4;;t#4#4#J#J#J#J#J#Jr"z%serrorrz Error - %s)r)rr}r rrr6)rnexcr)rrcs r html_errorz _url_handler..html_error's,,w''  2{{#J#J#J#J#8cC#H#H#J#J#JJJHHnS111HT__S(g_NNNc!8++r"c  |}|dr |dd} |dvr \}}n|dkr\}}n|dkr \}}nd|vr|d\}}}|dkr |\}}n|d kr |\}}n|d kr. |\}}n#t$r |\}}YnswxYw|d kr@|dvr \}}nW  |\}}nG#t$r|\}}Yn-wxYwt|d |z |\}}n&#t$r}||\}}Yd}~nd}~wwxYw||S) zGenerate an HTML page for url.riN)r#rFrrr&z search?keyz getfile?keyz topic?keyzget?keyzZThere was an error while retrieving documentation for the object you requested: Bad URL %s)endswith partitionr.rr!)rn complete_urlrroprrrcrrrrprr|rrs r get_html_pagez#_url_handler..get_html_page1sN <<  crc(C$ ;m##!+ww!,ww ""!.ww ]]3// As%%%0[%5%5NE77=((%1\#%6%6NE77;&&:)7)<)<ww%:::)4S)9)9www:9__m++)3wwA-8[-=-=NE77)AAA-;^C-@-@NE777A%EFFHKLMMM"-S!1!1w ; ; ;'Z c::NE777777 ;yy(((s`BE -B<;E <CE CE 3DE DE D,E E-E((E-/rBNtext/cssr#rJzrThere was an error while retrieving documentation for the object you requested: unknown content type %r for url %s) r startswithosrkdirnamerealpath__file__r}r readlinesrr)rn content_typer[r path_hererUrrcrrrrprrYr|rrs @@@@@@@@@@r _url_handlerrisCCCCCCC=CCCB 8::DHHHHH.55555,*****6 - - - - - " " " " " $ $ $ $ $555550,,,,,*)*)*)*)*)*)*)*)*)*)*)*)*)X ~~c!""gz!!GOOBG$4$4X$>$>?? 7<< 3// (^^ +r772<<>>** + + + + + + + + + + + + + + + + +  $ $}S!!!   M N N 3   ! !!s9'D--D14D1c ddl ddlddl ddl ddl}Gdd jjG fdd jjG fdd j}||||}d |_ | |j s*|j s#| d |j s|j #|S) z Start an HTTP server thread on a specific port. This is a reimplementation of `pydoc._start_server` to handle connection errors for 'do_GET'. Taken from PyDoc: https://github.com/python/cpython/blob/3.7/Lib/pydoc.py rNceZdZdZdZdS)!_start_server..DocHandlerc|jdrd}nd}|d|dd|z| |j||j|ddS#t$rYdSt$rYdSwxYw) zProcess a request from an HTML browser. The URL received is in self.path. Get an HTML page from self.urlhandler and send it. z.cssrrJz Content-Typez%s; charset=UTF-8zutf-8N) rkr send_response send_header end_headerswfilewrite urlhandlerencodeConnectionAbortedErrorBrokenPipeError)rrs r do_GETz(_start_server..DocHandler.do_GET~s y!!&)) +) *   s # # #    3l B D D D          I|"-"--3VG__>>>>>)   "     s#AB++ C8 CCcdSrr)rr4s r log_messagez-_start_server..DocHandler.log_messages Dr"N)rXr\rrrrr"r DocHandlerr|s2   8     r"rc&eZdZdZfdZdZdS) _start_server..DocServerc||_|j|f|_||_|j||j|jd|_dSNF)hostaddressrurrhandlerquit)rrportrus r rz)_start_server..DocServer.__init__sGDI It,DL$DM I  tT\4< @ @ @DIIIr"c|jsQ|jgggd\}}}|r||jQ|dSr)rselectsocketfilenohandle_request server_close)rrdwrexrs r serve_until_quitz1_start_server..DocServer.serve_until_quits{i *#]]DK,>,>,@,@+A2r1MM B*'')))i *        r"cv|j||jr||dSdSr)rserver_activaterurs r rz0_start_server..DocServer.server_activatesD I % %d + + +} $ d##### $ $r"N)rXr\rrrr)rsr DocServerrsL         $ $ $ $ $r"rc6eZdZfdZfdZdZdZdS)#_start_server..ServerThreadc||_||_t||_j|d|_d|_dSr)rrr|rThreadrservingr)rrrr threadings r rz,_start_server..ServerThread.__init__sG(DODID DI   % %d + + + DLDJJJr"c: jj__jj_t|j_|j |j |j }||_ | dS#t$r}||_Yd}~dSd}~wwxYw)zStart the server.N)server HTTPServerrrmessageMessage MessageClass staticmethodrrrready docserverrrr)rdocsvrerremailhttps r r{z'_start_server..ServerThread.runs !%!7 $. !*/-*? '(4T_(E(E %"49diDD!''')))))     sA9A>> BBBcpd|_|j|_|j|_d|j|jfz|_dS)NTz http://%s:%d/)rr server_portrrn)rrs r rz)_start_server..ServerThread.readys5DL DI*DI&$)TY)??DHHHr"cpd|j_|d|_d|_d|_dS)z'Stop the server and this thread nicely.TNF)rrr}rrnrs r stopz(_start_server..ServerThread.stops4"&DN  IIKKK"DN DLDHHHr"N)rXr\rrr{rr)rrrrrsr ServerThreadrsw              @ @ @      r"rTg{Gz?) http.server email.messagerrtimerBaseHTTPRequestHandlerrrdaemonrrrsleep) rhostnamerrrthreadrrrrrrs @@@@@@r _start_serverrms\MMMKKK     T[7   D$$$$$$$DK*$$$*%%%%%%%%%%%y'%%%N\*h 5 5FFM LLNNNl6> 3l6> Mr")rJ)'rrrrrrrrvrYrrxspyder.config.baserrspyder.config.guirrspyder.py3compatrpydocrr r r r r rrrrrrrrrrrrrrr"r r s   &%%%%%%%99999999++++++555555555555555555555555555555555555 F F F F F CF F F RA!A!A!A!Htttttr"