a ze @s&dgZdZdZdZddlZddlZddlZddlZddl Zddl Z ddl Z ddl Z ddl Z ddlZddlZddlZddlZddlZddlZddlZddlZddlZddlmZddlmZddlmZd d Zd d Zd dZ ddZ!ddZ"ddZ#ddZ$ddZ%ddZ&ddZ'ddZ(dd Z)e*d!ej+Z,d"d#Z-d$d%Z.d&d'Z/d(d)Z0dd*d+Z1d,d-Z2d.d/Z3d0d1Z4d2d3Z5ifd4d5Z6Gd6d7d7e7Z8d8d9Z9difd:d;Z:Gdd?d?eZGdDdEdEe;Z?GdFdGdGe?Z@dHdIaAdJdKZBdLdMZCdNdOZDdPdQZEdRdSZFdTdUZGdVdWZHdXdYZIddZd[ZJe?ZKe@ZLe=ZMdd\d]ZNdd_d`ZOddadbZPddcddZQddfdgZRGdhdidiZSeSZTGdjdkdkZUdldmZVdndoZWddqdrZXddsdtdudvdwZYdxdyZZdzd{Z[d|d}Z\d~dZ]e^dkr"e]dS)helpzKa-Ping Yee z26 February 2001zGuido van Rossum, for an excellent programming language. Tommy Burnette, the original creator of manpy. Paul Prescod, for all his work on onlinehelp. Richard Chamberlain, for the first implementation of textdoc. N)deque)Repr)format_exception_onlycCs\g}g}tjD]H}tj|pd}tj|}||vrtj|r||||q|SN.)syspathosabspathnormcaseisdirappend)dirsZnormdirsdirnormdirr/usr/lib/python3.9/pydoc.pypathdirsRs    rcCst|ot|tj SN)inspectZisclass isinstancetypes GenericAliasobjectrrr_isclass^srcCsNtj|j}|durdS|jdddD]}t||}q.t|sJdS|S)Nr)rmodulesget __module__ __qualname__splitgetattrr)funcclsnamerrr _findclassas r'c Cst|rH|jj}|j}t|r>tt||dd|jur>|}n|j}n"t|r||j}t |}|dusvt|||urzdSnt |r|j}|j}t|r|j d||j kr|}n|j}nt |t r|j}|j}t |}|dust|||urdSntt|st|rf|j}|j}t|||ur.dSt|rjt|dd}t |trj||vrj||SndS|jD]F}ztt||}WntyYqpYn0|durp|SqpdS)N__func__r __slots__)rismethodr(__name____self__rr# __class__ isfunctionr' isbuiltinr!rpropertyfgetZismethoddescriptorisdatadescriptor __objclass__ismemberdescriptordict__mro__ _getowndocAttributeError)objr&selfr%r$slotsbasedocrrr_finddocksZ            r>cCsdzJt|d}|durWdS|turFt|j}t|trF||krFWdS|WSty^YdS0dS)N__doc__)r__getattribute__typer?rstrr8)r9r=Ztypedocrrrr7s   r7c CsNt|}|dur6z t|}Wnttfy4YdS0t|tsDdSt|Sr)r7r>r8 TypeErrorrrBrZcleandoc)rr=rrr_getdocs  rDcCs,t|pt|}|r(tdd|p*dS)Nz^ * )rDrZ getcommentsresubrstrip)rresultrrrgetdocsrJcCsf|d}t|dkr&|ddfSt|dkrX|dsX|dd|ddfSdd|fS)N rrE)stripr"lenrHjoin)r=linesrrrsplitdocs   rRcCs"|j}|j|kr|jd|}|Sr)r+r )rmodnamer&rrr classnames rTcCs<t|p8t|p8t|p8t|p8t|p8t| Sr)rismoduler isroutineZisframeZ istracebackZiscoderrrrisdatasrWcGs.|r*|d||d}|dd}q|S)NrLrrM)rPr")textpairsrrrreplacesrZcCsXt||krTtd|dd}td|d|}|d|d|t||dS|S)NrrM...)rOmax)rXmaxlenpreZpostrrrcrams  $r`z at 0x[0-9a-f]{6,16}(>+)$cCs td|S)Nz\1) _re_stripidrGrXrrrstripidsrccCs<t|rdSt|r8t|dd}t|p4|du SdS)NTr,F)rr*r/r#rU)fnr:rrr_is_bound_methods    recCs^i}t|tjD]\}}d||<q|jD]}|t|q*|D]}t||||<qF|SNrL)r getmembersrV __bases__update allmethodskeysr#)clmethodskeyvaluer<rrrrjs   rjcCs8g}g}|D]"}||r$||q ||q ||fSrr)s predicateZyesnoxrrr _split_lists  rucCs\|dvr dS|dr$|dr$dS|drr+ __credits__r!__file____path____spec__ __package__ __cached__ __version__ __author__ __loader____date__r) __builtins__r r?r__rL__fieldsT) startswithendswithhasattr)r&allr9rrr visiblenamesrcCsXg}t|D]D\}}}}t|r@d}t|tr@|jdur@d}|||||fq|S)Ndata descriptorreadonly property)rclassify_class_attrsr2rr0fsetr)rresultsr&kindr%rorrrr)s rcsZt|dgzfddtDWnty<iYn0fdd}|j|ddS)Nrcsi|]\}}||tqSr)rO).0ir&)fieldsrr :z#sort_attributes..cs|dd|dfSNr)r)attr) field_orderrr=rz!sort_attributes..rn)r# enumeraterCsort)attrsrZkeyfuncr)rrrsort_attributes4s    rcCs:tj|r6dD]$}tjtj|d|rdSqdS)N)z.pyz.pyc__init__TF)r r r isfilerP)r extrrr ispackageBs  rcCs|}|dddks |s0|}|sq0q|}|dddkrT|dd}|dddkr|dd}|dddkr|dd}|s|}|sqq|dd }nd}|S) NrL#zr"""r["""r\r)readlinerNr")filelinerIrrrsource_synopsisJs rc Cs2t|j}||d\}}|dus.||kr.|ttjjrJtjj }n |ttjj rftjj }nd}|durzt |}WntyYdS0|t|}Wdn1s0Yn^|d|}tjjd||d}ztj|} WnYdS0tjd=| jr| jdnd}||f||<|S)N)NNZ__temp__loaderr)r statst_mtimerrtuple importlib machineryBYTECODE_SUFFIXESSourcelessFileLoaderEXTENSION_SUFFIXESExtensionFileLoadertokenizeopenOSErrorrutilspec_from_file_location _bootstrap_loadrrr? splitlines) filenamecachemtimeZ lastupdaterIZ loader_clsrrspecmodulerrrsynopsis[s6    (   rc@seZdZddZddZdS)ErrorDuringImportcCs||_|\|_|_|_dSr)rexcrotb)r:rexc_inforrrrszErrorDuringImport.__init__cCs|jj}d|j||jfS)Nzproblem in %s - %s: %s)rr+rro)r:rrrr__str__szErrorDuringImport.__str__N)r+r r!rrrrrrrsrc Cstjj}t|d"}||t|k}Wdn1s:0Ytj|}tj |\}}|rttj ||}ntj ||}tjj |||d}ztj|WSt|tYn0dS)Nrbr)rr MAGIC_NUMBERrreadrOr r basenamesplitext_bootstrap_externalrSourceFileLoaderrrrrrr) r magicrZ is_bytecoderr&rrrrrr importfiles 0 rc sz^|rTtjvrTtjvrTfddtjD}g|D]}tj|||<tj|=q8t}Wnzt\}}}} tjvrttjj| n>|turt|j| n(t |t r|j krYdSttYn0 dddD],} zt || }WqtyYdS0q|S)Ncsg|]}|dr|qS)r)r)rmr rr rzsafeimport..rrL)rrbuiltin_module_names __import__rrrw SyntaxErrorr issubclass ImportErrorr&r"r#r8) r forceloadrZsubsrnrrrorinfopartrrr safeimports*    rc@sfeZdZejddejddZd ddZ d ddZ e Z Z Z ZZZed fd d ZdS)Doc PYTHONDOCSz%https://docs.python.org/%d.%d/libraryNrMcGs||f|}zDt|r$|j|WSt|r8|j|WSt|rN|j|WSWntybYn0t|rx|j |S|j |Sr) rrU docmodulerdocclassrV docroutiner8r2docdatadocother)r:rr&argsrrrdocuments  z Doc.documentcGs*d|odt|t|jf}t|dS)Nz.don't know how to document object%s of type %s )reprrAr+rC)r:rr&rmessagerrrfailszDoc.failZstdlibcCszt|}Wnty$d}Yn0tjd|j}tj|}t |t tr|j dvsx| |r| tj |ds|j dvr| drd|d|j f}qtj ||j d }nd}|S) N (built-in)r) errno exceptionsgcZimpmarshalposixsignalr_threadZ zipimportz site-packages)z xml.etreeztest.pydoc_mod)zhttp://zhttps://z%s/%s/.html)r getabsfilerCr environrrr r rrAr+rrPrHlower)r:rZbasedirrdoclocrrr getdoclocs(    z Doc.getdocloc)N)N)r+r r!r rrr version_inforrrrrrr docpropertyr sysconfigZget_pathrrrrrrs   rc@sDeZdZddZddZddZddZd d ZeZd d Z eZ d S)HTMLReprcCs,t|d|_|_d|_d|_|_dSN drrmaxlistmaxtuplemaxdict maxstringmaxotherr:rrrr s  zHTMLRepr.__init__cCst|ddddddS)N&z&z>)rZr:rXrrrescapeszHTMLRepr.escapecCs t||Sr)rrr:rrrrrsz HTMLRepr.reprcCsZtt|dr@ddt|j}t||r@t||||S|ttt ||j SNr+repr_r) rrArPr+r"r#r r`rcrrr:rtlevelZ methodnamerrrrepr1s  zHTMLRepr.repr1cCs^t||j}t|}d|vrJdt|ddvrJd|d|||dStdd||S)Nr\\rErrz-((\\[\\abfnrtv\'"]|\\[0-9]..|\\x..|\\u....)+)z\1)r`rrrZr rFrGr:rtrtestZtestreprrrr repr_strings zHTMLRepr.repr_stringcCs@z|ttt||jWS|d|jjYS0dSNz <%s instance>)r r`rcrrr-r+r:rtrrrr repr_instance*szHTMLRepr.repr_instanceN) r+r r!rr rrrrepr_strrZ repr_unicoderrrrrs rc@seZdZeZejZejZddZd0ddZd1d d Z d d Z d dZ d2ddZ ddZ ddZddZddZddZddZdiiifddZd3d d!Zd4d"d#Zddiifd$d%Zd&d'Zddiiidfd(d)Zd5d*d+ZeZd6d,d-Zd7d.d/ZdS)8HTMLDoccCs d||fS)Nz Python: %s %s r)r:titlecontentsrrrpage;sz HTMLDoc.pagerEcCsd|||||pdfS)Na'
 
 
%s		%s
 r)r:rfgcolbgcolextrasrrrheadingEszHTMLDoc.headingNrc Cs^|durdd|d}d|||f} |r@| d||||f} n| d|||f} | d|S)Nzrzz

zR z( z'
 
%s
%s %s
%s
%s%s%s
r) r:rr r!rwidthZpreludeZ marginaliaZgaprIrrrsectionPs zHTMLDoc.sectioncGsd|}|j|g|RS)Nz%s)r&)r:rrrrr bigsectionfszHTMLDoc.bigsectionc Cs&||}t|dddddddd S)N z rrrK
)r  expandtabsrZr rrr preformatks zHTMLDoc.preformatrcCsd}t||d|}t|D]X}|dd|}t|||||D]$}|t|krJ||||d}qJ|d}q d|S)NrErLzrr)zz7%s
)rOrange)r:listformatZcolsrIrowscolrrrr multicolumnqs   zHTMLDoc.multicolumncCsd|S)Nz%srr rrrgrey}rz HTMLDoc.greycGs*|D] }||vrd|||fSq|S)N%sr)r:r&Zdictsr5rrrnamelinkszHTMLDoc.namelinkcCsN|jtj|j}}t||rDt|||urDd|j|t||fSt||S)Nz%s)r+rrrr rr#rT)r:rrSr&rrrr classlinks zHTMLDoc.classlinkcCsd|j|jfSNz%s)r+r rrr modulelinkszHTMLDoc.modulelinkcCsR|\}}}}|r||S|r,d||f}nd|}|rBd|}n|}d||fS)Nz %s.%s.htmlz%s.htmlz"%s (package)r3)r2)r:Z modpkginfor&r rshadowedurlrXrrr modpkglinks   zHTMLDoc.modpkglinkcCs d||fS)Nz%sr)r:r9r rrrfilelinkszHTMLDoc.filelinkcCs|p|j}g}d}td}|||} | s0qh| \} } ||||| | \} } }}}}| r|| dd}|d||fn|rdt|}|d||| fn|rdt|}|d||| fn|r"|| | dd kr|d | ||n|d |n@|| | dd krP|| ||||n|| ||| }q||||dd |S) NrzJ\b((http|https|ftp)://\S+[\w/]|RFC[- ]?(\d+)|PEP[- ]?(\d+)|(self\.)?(\w+))"z"r3z'http://www.rfc-editor.org/rfc/rfc%d.txtz)https://www.python.org/dev/peps/pep-%04d/rL(zself.zself.%srE) r rFcompilesearchspanrgroupsrZintr4rP)r:rXr funcsclassesrmrherepatternmatchstartendrschemeZrfcZpepZselfdotr&r9rrrmarkups8      zHTMLDoc.markupc Csd}|D]}t|tdur|\}}|d}||||}|r||fkrg}|D]} ||| |qR|dd|d}|d}qt|tgur|d||||}qd |S) NrErz"

r=, )z
z
%s
z
%s
)rAr5rrP formattree) r:treerSparentrIentrycbasesparentsr<rrrrNs"  zHTMLDoc.formattreec# s|j}z |j}Wnty&d}Yn0|d}g}tt|dD],}|dd|d|d||fqFd||dd} d| } z&t |} t j | } | | } Wntyd} Yn0g}t|dr2t|j}|ddd kr|ddd kr|dd}|d |t|d rT|t|j|rl| d d|} |}|durdt}nd}| ddd| |}t|tj}gi}}t|tD]Z\}}|dust|p||urt|||r|||fd|||<||<q|D]\}}|jD]n}|j|j}}tj !|}||kr:|r:t||r:t"|||ur:||vr:|d|||<||<q:q,gi}}t|tj#D]p\}}|dust$|st||urt|||r|||fd|||<t%|r||||<qg}t|t&D]&\}}t|||rH|||fqH't(|j)||}|od|}|d|}t|drg}t*+|j,D]\}}} |||| dfq|-.|j/}!|0ddd|!}n.|r6.|fdd}!|0ddd|!}|rd d!|D}"1t2|"d|g}!|D]"\}}|!3|||||qd|0d"dd#d$|!}|rg}!|D]"\}}|!3|||||q|0d%dd&d$|!}|r4g}!|D]\}}|!3||q|0d'dd(d)|!}t|d*rh't|j4j)}!|0d+dd|!}t|d,r't|j5j)}!|0d-dd|!}|S).NrrLz5%sr)%srr| $Revision: $z version %srz (%s)rLz-
Module ReferencerE#ffffff#7799eezindex
rz.html#z#-z %sz

%s

rxrzPackage Contentsz#aa55cccs|dSrf)r7trrrr9rz#HTMLDoc.docmodule..ZModulescSsg|] \}}|qSrrrrnrorrrr>rz%HTMLDoc.docmodule..ZClasses#ee77aarZ Functionsz#eeaa77ZDataz#55aa55r)r}ZAuthorrvZCredits)6r+__all__r8r"r,rOrrPrrurllibparsequoter;rCrrBr|rNr rrlocalsr#rgrUr getmodulerrhr rrrr#rVr/r.rWrKrJr+pkgutil iter_modulesrxrr1r:r'rN getclasstreerr}rv)#r:rr&modignoredrpartsZlinksrZ linkednameheadr r9r;rversionrrIrrDZcdictrnror<rSrrCZfdictdatar=modpkgsimporterispkgr classlistrrrrs          $                        zHTMLDoc.docmodulec sj}|p |}j}g} | jGfddd} | tt} t| dkrd| D]} d| j qddfdd} fd d }fd d }fd dt D}i|D]j\}}}}d|d||<}zt |}Wnt y2Yn0z ||<Wqt yTYq0q|rf| rn| n |ddt|fdd\}}tjurtjur|}qXn"urd}ndj }|d7}t|| d||dd}| d||dd}| d||dd}|d||dd}|d||d d}|d!||d"d}|}qXd#| } ||krd$||f}nd%|||f}|rg}|D]} || j q|d&d'|}d#}zt}Wntt fyd}Yn0|r2t|}|r2|d(kr2||d)}t}|rN||pJd#}|j}|ond*|}|d+d,| d-|S).Ncs eZdZddZfddZdS)z(HTMLDoc.docclass..HorizontalRulecSs d|_dSrZneedonerrrrrhsz1HTMLDoc.docclass..HorizontalRule.__init__cs|jrdd|_dS)Nz
rLrrrpushrrmaybejsz.HTMLDoc.docclass..HorizontalRule.maybeNr+r r!rrurrsrrHorizontalRulegsrwrMz&
Method resolution order:
z
%s

c st||\}}|r||D]b\}}}}zt|}Wn$tyd||Yn0||dq&|S)NrKrurur# Exceptionrrmsgrrrokr&rhomeclsrorDrChrmdictrhrrtr:rrspillzs   zHTMLDoc.docclass..spillcsJt||\}}|rF||D]\}}}}||q&|Srrururr{rrhrtr:rrspilldescriptorssz*HTMLDoc.docclass..spilldescriptorsc st||\}}|r||D]r\}}}}t||}t|} | s`d|n0t|j} d| } d|| fdq&|S)Nz
%s
z
%sz
%s%s
rK)rururr#rJrKr+) r|rrrr}r&rr~ror<r=rrr spilldatas  z#HTMLDoc.docclass..spilldatacs,g|]$\}}}}t|dr||||fqS)r9rrr&rr%rorrrrs  z$HTMLDoc.docclass..r-rcs |duSNrMrr[ thisclassrrrrz"HTMLDoc.docclass.. defined hereinherited from %sz:
z Methods %scSs |ddkSNrLmethodrr[rrrrrzClass methods %scSs |ddkSNrLz class methodrr[rrrrrzStatic methods %scSs |ddkSNrLz static methodrr[rrrrrzReadonly properties %scSs |ddkSNrLrrr[rrrrrzData descriptors %scSs |ddkSNrLrrr[rrrrrzData and other attributes %scSs |ddkSNrLrmrr[rrrrrrEz*class %sz/%s = class %s(%s)rL()r(z%s
 z#000000z#ffc8d8r[)r+rhrrrgetmrorOrur5r rr#rzrCpopleftrubuiltinsrrrP signature ValueErrorrBr rJrKr+r&)r:rr&rhrCrDrirealnamerSrrwmror<rrrrrnrr~roanchor inheritedtagrrTdeclrargspecr=r) rDrCrrrhrrtr:rrr\s                   zHTMLDoc.docclasscCs|d||SN=)r2rr rrr formatvalueszHTMLDoc.formatvaluec Cs|j}|p |}|r|jpdd|} d} d} t|r|jj} |rZ| |urd|| |} n0|jdurzd||jj|} nd|| |} t|st|rd} nd} ||krd| |f}nD|rt||g|urd |jd||f}d } n|}d | ||f}d}t |rjzt |}Wnt t fy<d}Yn0|rjt |}|d krjd |}|d d}|std}| |||| o|d| }| rd|S|t||j|||}|od|}d||fSdS)NrErr from  method of %s instance unbound %s methodasync z$%sz%srLz)%s = %sz$%s lambda r(...)z'%sz
%s
z
%s
z
%s
%s
)r+rer,r-r5riscoroutinefunctionisasyncgenfunctiongetattr_staticrVrrrCrBr r2rKrJr+)r:rr&rhrCrDrmrlrrnoteskipdocsimclassasyncqualifierrZreallinkrrrr=rrrrsl       zHTMLDoc.docroutinecCsNg}|j}|r|d||t||j}|r<|d||dd|S)Nz!
%s
z
%s
rxrE)rrKrJr+rPr:rr&rhrlrrtr=rrrrCs  zHTMLDoc.docdatacGs|r d|pd}|||S)Nz%s = rEr)r:rr&rhriZlhsrrrrSszHTMLDoc.docothercCsg}|duri}t|gD]<\}}}tdd|Dr:q||d|||vfd||<q||||j}||dd|S)Ncss*|]"}dt|kodknVqdS)iiN)ordrZchrrr ]rz HTMLDoc.index..rErLrYr^)rerfanyrrr1r:r')r:rr8rnror&rprrrrindexXs  z HTMLDoc.index)rE)r$rENr)r)N)NN)NNN)NN)N)r+r r!r_repr_instancerr rr#r&r'r+r1r2r4r5r7r:r;rKrNrrrrrrrrrrrrr2s<   +  y# A  rc@s0eZdZddZddZddZeZddZd S) TextReprcCs,t|d|_|_d|_d|_|_dSrrrrrrrks  zTextRepr.__init__cCsTtt|dr@ddt|j}t||r@t||||Sttt||j Sr ) rrArPr+r"r#r`rcrrrrrrrqs  zTextRepr.repr1cCsHt||j}t|}d|vrDdt|ddvrDd|d||dS|S)NrrrErr)r`rrrZrrrrrxs  zTextRepr.repr_stringcCs4zttt||jWSd|jjYS0dSr)r`rcrrr-r+rrrrrszTextRepr.repr_instanceN)r+r r!rrrrrrrrrris  rc@szeZdZeZejZddZdddZddZdd d Z dd d Z dddZ ddZ dddZ dddZeZdddZdS)TextDoccCsddd|DS)NrEcss|]}|d|VqdS)NrrrrrrrzTextDoc.bold..)rPr rrrboldsz TextDoc.bold cs>|sdSfdd|dD}|r4|d|d<d|S)NrEcsg|] }|qSrrrrprefixrrrrz"TextDoc.indent..rKr)r"rHrP)r:rXrrQrrrindentszTextDoc.indentcCs$||}||d|dS)NrKr()rrHr)r:rrZclean_contentsrrrr&szTextDoc.sectionNrEc sd}|D]}t|tdurr|\}}||t|}|rh||fkrhfdd|D} |dd| }|d}qt|tgur|||||d}q|S) NrErc3s|]}t|VqdSrrT)rrRrSrrrrz%TextDoc.formattree..rrLrKr)rArTrPrN) r:rOrSrPrrIrQrRrSrTrrrrNs  zTextDoc.formattreec Cs|j}tt|\}}|d||o(d|}t|dd}||}|dur`||d|d}|rt||d|}g} t|tD]<\} } |dust | p||urt | ||r| | | fqg} t|tj D]B\} } |dust | st | |urt | ||r| | | fqg} t|tD]&\} } t | ||r(| | | fq(g}t}t|drt|jD]6\}}}|||r| |dn | |qr|||d d |}g}t|tjD]0\} } | j|d r| |vr| | q|r0|||d d |}| rd d| D}|t|d|g}| D]\} } | || | |q^||dd |}| rg}| D]\} } | || | |q||dd |}| r g}| D]"\} } | |j| | |ddq||dd |}t|drzt|j}|dddkrj|dddkrj|dd}||d|}t|dr||dt|j }t|dr||dt|j!}t|dr||d t|j"}zt#|}Wnt$yd!}Yn0||d"|}|S)#NNAME - r_zMODULE REFERENCEa. The following documentation is automatically generated from the Python source files. It may be incomplete, incorrect or include features that are considered implementation detail and may vary between Python implementations. When in doubt, consult the module reference at the location listed above. Z DESCRIPTIONrx (package)zPACKAGE CONTENTSrKrZ SUBMODULEScSsg|] \}}|qSrrr]rrrrrz%TextDoc.docmodule..rLCLASSES FUNCTIONSF)r^ZDATAr|rVrWrrXVERSIONrZDATEr}ZAUTHORrvZCREDITSrFILE)%r+rRrJr&r#rrrgrrdrrrVr/rWsetrrerfrxaddrrPrUrrNrgrrrBr|rNrr}rvrrC)r:rr&rhZsynopdescrIrrrDrnrorCrmrnZ modpkgs_namesrorSrpZ submodulesrqrrlrrrrrs                $    zTextDoc.docmodulec sJj}|p |}j}jfdd}||kr:d|}n|d|}|rlt||} |dd| }g} | jzt} Wnt t fyd} Yn0| rt | } | r| dkrȈ|| dt } | r| dt t}t|d kr(d |D]}d ||qd td dtDt jd}t|}d}|rd|d|D]}d |ql||krdt ||dd Gfddd}|fdd}fdd}fdd}fddtD}|r|r(|n |dd t|fdd \}}tjurltjurl|}qn ur|d!}nd"tj}t||d#||d$d }|d%||d&d }|d'||d(d }|d)||d*d }|d+||d,d }|d-||d.d }|}qd| } | s.|dS|d| d/dS)0NcSs t||Srr)rRrrrrmakenamesz"TextDoc.docclass..makenameclass z = class rrLrrKrMzMethod resolution order:rrEcss.|]&}|jds|jdkrt|jVqdS)rrN)r+rr rB)rr%rrrrCsz#TextDoc.docclass..rrzBuilt-in subclasses:z ... and z other subclassescs eZdZddZfddZdS)z(TextDoc.docclass..HorizontalRulecSs d|_dSrrrrrrrrUsz1TextDoc.docclass..HorizontalRule.__init__cs|jrdd|_dS)NzF----------------------------------------------------------------------rLrrrrsrrruWsz.TextDoc.docclass..HorizontalRule.maybeNrvrrsrrrwTsrwc st||\}}|r|||D]T\}}}}zt|}Wn$tyd||Yq&0||q&|Srryr{rrhrrtr:rrr]s zTextDoc.docclass..spillcsJt||\}}|rF||D]\}}}}||q&|Srrr{rrrrnsz*TextDoc.docclass..spilldescriptorsc st||\}}|r||D]\\}}}}t|}zt|} Wntyd|j|} Yn0j| |d|ddq&|S)Nr)r^r=rK)rururJr#r8__dict__r) r|rrrr}r&rr~ror=r9rrrrws z#TextDoc.docclass..spilldatacs,g|]$\}}}}t|dr||||fqSrrrrrrrs  z$TextDoc.docclass..rcs |duSrrr[rrrrrz"TextDoc.docclass..rrz Methods %s: cSs |ddkSrrr[rrrrrzClass methods %s: cSs |ddkSrrr[rrrrrzStatic methods %s: cSs |ddkSrrr[rrrrrzReadonly properties %s: cSs |ddkSrrr[rrrrrzData descriptors %s: cSs |ddkSrrr[rrrrrzData and other attributes %s: cSs |ddkSrrr[rrrrrz | )r+rhr rmaprPrrrrrCrBrJrrrOsortedrA__subclasses__rrrrurrrTrrrH)r:rr&rhrirrSrrrTrrrr=rr<Z subclassesZno_of_subclassesZMAX_SUBCLASSES_TO_DISPLAYZ subclassnamerwrrrrrrr)rrhrrtr:rrrs                   zTextDoc.docclasscCsd||Srrr rrrrszTextDoc.formatvaluec Cs|j}|p |}d}d}t|rn|jj}|rB||urndt||}n,|jdur`dt|jj|}ndt||}t|st|rd} nd} ||kr||} n,|rt ||g|urd}||d|} d} t |r:zt |} Wnt t fyd} Yn0| r:t| } |d kr:||d } | dd } | sDd } | | | |} |rb| d St|pnd}| d |o||d SdS)NrErrrrrrL = rz lambda rrrK)r+rer,r-rTrrrrrrVrrrCrBrJrrH)r:rr&rhrlrrrrrrrrrr=rrrrsT       zTextDoc.docroutinecCsTg}|j}|r$||||dt|p.d}|rJ||||dd|S)NrKrE)rrrJrrPrrrrrs zTextDoc.docdatac Cs||}|rF|r|dpd|}|t|} | dkrF|d| d}|rX||dpZd|}|slt|}|r|d|t|d7}|S)NrrErr\rK)rrOrrJrrB) r:rr&rhrPr^r=rrZchoprrrrs  zTextDoc.docother)r)NrE)NN)NN)NNN)NNN)NNNNN)r+r r!rrrrrr&rNrrrrrrrrrrrrs   e  7 rc@seZdZddZdS) _PlainTextDoccCs|Srrr rrrr sz_PlainTextDoc.boldN)r+r r!rrrrrr srcCstat|dSr)getpagerpagerrbrrrrsrc sZttjdstSttjds tStjr4tjs8tStjdpNtjdrtj dkrjfddStjddvrfd dSfd dStjddvrtStj dkrd dSttd rt d dkrddSddl }| \}}t |zRttd r,t d|dkr,ddWt|StWt|SWt|n t|0dS)NisattyZMANPAGERZPAGERwin32cstt|Sr tempfilepagerplainrbZ use_pagerrrr#rzgetpager..ZTERM)ZdumbZemacscstt|Sr) pipepagerrrbrrrr%rcs t|Srrrbrrrr'rcSstt|dS)Nzmore /dev/nullrcSs t|dS)NZlessrrbrrrr-rz more "%s"cSs t|dS)NZmorerrbrrrr4r)rrstdin plainpagerstdoutrr rrplatformrtempfilemkstempcloseunlinkttypager)rfdrrrrrs>            rcCstdd|S)Nz.rE)rFrGrbrrrr:src Csddl}|j|d|jd}zVtj|jdd2}z||WntyNYn0Wdn1sd0YWntyYn0z| WqWqtyYq0qdS)NrT)shellrbackslashreplace)errors) subprocessPopenPIPEio TextIOWrapperrwriteKeyboardInterruptrwait)rXcmdrprocpiperrrr>s (  rc Csddl}|}tj|d}t|ddtjdkr.cSstjddddS)NrrL)rrrrrrrrqrLINESrLz -- more --)qQz ) rK)bB)rrr"ttyrrfilenoZ tcgetattrZ setcbreakrr8rUnsupportedOperationrBr rrrrrrPflushZ tcsetattrZ TCSAFLUSH) rXrQrroldZgetcharhrZincrRrrrrfsN              & rcCstjtt|dSr)rrrrrrbrrrrsrcCst|r>|jtjvr d|jSt|dr4d|jSd|jSt|rRd|jSt|rtd|jj |jj|jfSt |rd|jj |jj|jfSt |rd|jSt |rd |jSt |rd |jSt|jS) Nzbuilt-in module rxzpackage zmodule zbuilt-in function zgetset descriptor %s.%s.%szmember descriptor %s.%s.%srz function zmethod )rrUr+rrrr/Zisgetsetdescriptorr3r r4rr.r*rA)thingrrrdescribes2                 rc Csdd|dD}d\}}|t|kr\td|d|d|}|r\||d}}qq\q|rf|}nt}||dD]*}zt||}WqvtyYdS0qv|S)NcSsg|] }|r|qSrr)rrrrrrrzlocate..rrrL)r"rOrrPrr#r8)r rrjrnZ nextmodulerrrrrlocates   rcCsVt|tr0t||}|dur(td|||fSt|dd}|t|trL|ndfSdS)Nz~No Python documentation found for %r. Use help() to get the interactive help utility. Use help(str) for help on the str class.r+)rrBrrr#)rrrr&rrrresolves   r Python Library Documentation: %scCs|dur t}t||\}}t|}t|}|rTd|vrT|d|d|d7}n|rn||urn|d|j7}t|st|st |st |st |st |dr|j }nt|}|d7}||d|||S)Nrz in z in module __origin__z objectr()rXrrrrdrfindr+rUrrVr2rDrrrAr)rrrZrendererrr&rrrrr render_docs.     rc Cshz2|durtt|||n|t|||tWn0ttfyb}zt|WYd}~n d}~00dSr)rrr plaintextrrprint)rrroutputrorrrr=s r=c Csztt||\}}tt|t||}t|dddd}||Wdn1sZ0Ytd|dWn0tt fy}zt|WYd}~n d}~00dS)Nrrr)rZwrote) rhtmlrrrrrr rr)rrrr&rrrorrrwritedocs(r#rEcCs2|dur i}t|g|D]\}}}t|qdSr)re walk_packagesr#)rpkgpathdonerorSrprrr writedocs s  r'cJ@s.eZdZdddddddddddd d d d d ddddddddddddddddddddd$Zd d!d"DZd#d$d%d&geRd'd(d)d*d+d,d-Zd.d/d0d1d2d3d4d5d6d7d8d9d9d:d:d;ZeD]:\ZZ e D],Z e e eZ ee vre d<eZ e ee <qqd=d>d?d@dAdBdCdDdEdFdGdHdIdJdKdLdLdMdNdOdPdQddRdSdSdTdUdVdWdXdYdZd[d\d]d^d_d_d`dadbdcdddedfdgdhdidjdkdldmdndodpdqdrdsdtdudvdwdxdydzd{dd d|d}d~ddIZ dddZ eddZeddZddZeZefddZddZddZddZddZdddZddZddZddZdddZdddZddZdddZ dS)HelperrEBOOLEANwith)assertrE)asyncrE)awaitrE)break while for)classzCLASSES SPECIALMETHODS)continuer/)functionrE)del BASICMETHODSif)elser/try)forzbreak continue whileimport)globalznonlocal NAMESPACES)r5 TRUTHVALUE)r9MODULES)inSEQUENCEMETHODS COMPARISON)lambdar)nonlocalzglobal NAMESPACES)passrE)raise EXCEPTIONS)returnr)r7rD)whilezbreak continue if TRUTHVALUE)r*z CONTEXTMANAGERS EXCEPTIONS yield)yieldrE)$FalseNoneTrue__peg_parser__andasr+r,r-r.r0r1defr3elifr6exceptfinallyr8fromr:r5r9r=isr@rAnotorrBrCrEr7rFr*rGcCsg|]}dD] }||q qS)'r<r)rpr rrrrErzHelper.)r frurWz'''r<r)+r***rz//%<<>>r|^~rr <=>===!=<>)rr rdrerfrgrh)rrc) z+=z-=z*=z/=z%=z&=z|=z^=z<<=z>>=z**=z//=)r_r`rrarbrc)jJ)STRINGS OPERATORSr?UNARYAUGMENTEDASSIGNMENTBITWISECOMPLEXzOPERATORS FORMATTINGPOWERzTUPLES LISTS FUNCTIONSz ATTRIBUTES FLOAT MODULES OBJECTSELLIPSISzSLICINGS DICTIONARYLITERALSz def classrk PRIVATENAMESzPRIVATENAMES SPECIALMETHODSZ BACKQUOTESzTUPLES FUNCTIONS CALLSzLISTS SUBSCRIPTS SLICINGS)r^r],rr\:@rrr`r=rM[]r)rzRSTRINGS UNICODE NUMBERS SEQUENCES MAPPINGS FUNCTIONS CLASSES MODULES FILES inspect)stringsz4str UNICODE SEQUENCES STRINGMETHODS FORMATTING TYPES)zstring-methodszSTRINGS FORMATTING)Z formatstringsrl)rzz:encodings unicode SEQUENCES STRINGMETHODS FORMATTING TYPES)ZnumberszINTEGER FLOAT COMPLEX TYPES)Zintegersz int range)Zfloatingz float math)Z imaginaryz complex cmath)Ztypesseqz$STRINGMETHODS FORMATTING range LISTS DICTIONARIES)Ztypesfunctionsz def TYPES)Z typesmethodszclass def CLASSES TYPES)zbltin-code-objectszcompile FUNCTIONS TYPES)zbltin-type-objectsz types TYPESTYPES)zbltin-null-objectrE)zbltin-ellipsis-objectSLICINGS)Z specialattrsrE)rz!class SPECIALMETHODS PRIVATENAMES)Z typesmodulesr9)zoperator-summaryzlambda or and not in is BOOLEAN COMPARISON BITWISE SHIFTING BINARY FORMATTING POWER UNARY ATTRIBUTES SUBSCRIPTS SLICINGS CALLS TUPLES LISTS DICTIONARIES EXPRESSIONS)Zobjectsr|)Z specialnameszbBASICMETHODS ATTRIBUTEMETHODS CALLABLEMETHODS SEQUENCEMETHODS MAPPINGMETHODS NUMBERMETHODS CLASSES)Z customizationzhash repr str SPECIALMETHODS)zattribute-accesszATTRIBUTES SPECIALMETHODS)zcallable-typeszCALLS SPECIALMETHODS)sequence-typesz(SEQUENCES SEQUENCEMETHODS SPECIALMETHODS)rzMAPPINGS SPECIALMETHODS)z numeric-typesz*NUMBERS AUGMENTEDASSIGNMENT SPECIALMETHODS)Z execmodelz%NAMESPACES DYNAMICFEATURES EXCEPTIONS)Znamingz3global nonlocal ASSIGNMENT DELETION DYNAMICFEATURES)zdynamic-featuresrE NAMESPACES)rztry except finally raise)Z conversionsrE)Z identifierszkeywords SPECIALIDENTIFIERS)z id-classesrE)zatom-identifiersrE)z atom-literalsz=STRINGS NUMBERS TUPLELITERALS LISTLITERALS DICTIONARYLITERALS SEQUENCES)Z exprlistszTUPLES LITERALS)ztypesseq-mutable LISTLITERALS)ZlistszLISTS LITERALS)Z typesmappingDICTIONARYLITERALS)r5zDICTIONARIES LITERALS)zattribute-referencesz(getattr hasattr setattr ATTRIBUTEMETHODS)Z subscriptionsr>)Zslicingsr>)Zcallsr~)Zpowerr~)Zunaryr~)binaryr~)Zshiftingr~)Zbitwiser~)Z comparisonszEXPRESSIONS BASICMETHODS)ZbooleanszEXPRESSIONS TRUTHVALUEr+)Z assignmentrn)Z augassign NUMBERMETHODSr3rE)Zcompoundzfor while break continue)truthz if while and or not BASICMETHODS)ZdebuggerZpdb)zcontext-managersr*)Ir|rkZ STRINGMETHODSZ FORMATTINGUNICODEZNUMBERSZINTEGERFLOATrprZMAPPINGSrZMETHODSZ CODEOBJECTSZ TYPEOBJECTSZ FRAMEOBJECTSZ TRACEBACKSNONErrZSPECIALATTRIBUTESrr<ZPACKAGESr~rlZ PRECEDENCEZOBJECTSZSPECIALMETHODSr4ZATTRIBUTEMETHODSZCALLABLEMETHODSr>ZMAPPINGMETHODSrZ EXECUTIONrZDYNAMICFEATURESZSCOPINGZFRAMESrDZ CONVERSIONSZ IDENTIFIERSZSPECIALIDENTIFIERSrsZLITERALSZTUPLESZ TUPLELITERALSZLISTSrr{rZ ATTRIBUTESZ SUBSCRIPTSr}ZCALLSrqrmZBINARYZSHIFTINGror?r)Z ASSERTIONZ ASSIGNMENTrnZDELETIONZ RETURNINGZ IMPORTINGZ CONDITIONALZLOOPINGr;Z DEBUGGINGZCONTEXTMANAGERSNcCs||_||_dSr)_input_output)r:inputr!rrrrszHelper.__init__cCs |jp tjSr)rrrrrrrrsz Helper.inputcCs |jp tjSr)rrrrrrrr!sz Helper.outputcCs2tdddkr|dSd|jj|jjfS)NrLr[?rEz<%s.%s instance>)rstackr-r r!rrrr__repr__s zHelper.__repr__cCs6||jur||n|||jddS)Na You are now leaving help and returning to the Python interpreter. If you want to ask for help on a particular object directly from the interpreter, you can type "help(object)". Executing "help('string')" has the same effect as typing a particular string at the help> prompt. )_GoInteractiverintrointeractr!rr:Zrequestrrr__call__s   zHelper.__call__c Cs|jdz|d}|s WqWnttfy<YqYn0|}t|dkr|d|dkrndvrnn |d|ddvr|dd}|dvrq|d kr|q | |q dS) NrKzhelp> rMrrrVrL)r quitr) r!rgetlinerEOFErrorrNrOrrrrrrrrs    ,  zHelper.interactcCs8|jtjurt|S|j||j|jSdSr)rrrr!rrr)r:promptrrrrs    zHelper.getlinecCs<t|tdur|}|dkr,|n|dkr>|n|dkrP|n|dkrb|n|dddkr||dn||jvr||nj|d vrt t |d nR||j vr| |n<||j vr| |n&|rt |d |jd nt td |jd n$t|tr|nt |d |jd |jd dS) NrEkeywordssymbolstopicsrzmodules rL)rJrHrIz Help on %s:)r!rK)rArN listkeywords listsymbols listtopics listmodulesr"r showsymbolr=evalr showtopicrrrBrr(r!rrrrrrs$z Helper.helpcCs$|jddtjdddS)Na Welcome to Python {0}'s help utility! If this is your first time using Python, you should definitely check out the tutorial on the Internet at https://docs.python.org/{0}/tutorial/. Enter the name of any module, keyword, or topic to get help on writing Python programs and using Python modules. To quit this help utility and return to the interpreter, just type "quit". To get a list of available modules, keywords, symbols, or topics, type "modules", "keywords", "symbols", or "topics". Each module also comes with a one-line summary of what it does; to list the modules whose name or summary contain a given string such as "spam", type "modules spam". z%d.%drM)r!rr.rrrrrrrs z Helper.introrPc Cstt|}||}t||d|}t|D]v}t|D]\}|||}|t|kr<|j||||dkr<|jdd|dt||q<|jdq0dS)NrLrrK)r-rrOr,r!r) r:itemscolumnsr%Zcolwr/rowr0rrrrr-%s      &z Helper.listcCs |jd||jdS)NzN Here is a list of the Python keywords. Enter any keyword to get more help. )r!rr-rrkrrrrr2s zHelper.listkeywordscCs |jd||jdS)Nzx Here is a list of the punctuation symbols which Python assigns special meaning to. Enter any symbol to get more help. )r!rr-rrkrrrrr9s zHelper.listsymbolscCs |jd||jdS)NzN Here is a list of available topics. Enter any topic name to get more help. )r!rr-rrkrrrrrAs zHelper.listtopicsc Cs,z ddl}Wn ty,|jdYdS0|j||j|}|s`|jdt|dSt|tdur|| ||S|\}}z|jj|}Wn(t y|jdt|YdS0| d}|r|pdd|}|r ddl }dd |d} || d } |d d | 7}t|dS) Nrt Sorry, topic and keyword documentation is not available because the module "pydoc_data.topics" could not be found. zno documentation found for %s rErKrRelated help topics: rLHz %s )pydoc_data.topicsrr!rrrrrrArKeyErrorrNtextwraprPr"wrapr) r:topic more_xrefs pydoc_datatargetlabelxrefsr=rrXZ wrapped_textrrrrHs4       zHelper.showtopiccCsz ddl}Wnty YdS0|j||j|}|sDtdt|trZ|||S|\}}|jj|}|r|pxdd|}||fS)Nr)rrEzcould not find topicrEr) rrrrrrrrB _gettopic)r:rrrrrrr=rrrrhs      zHelper._gettopiccCs*|j|}|d\}}}|||dS)Nr)r partitionr)r:symbolrrrrrrrrs zHelper.showsymbolcsv|r |jd|t|nR|jdi}|fddfdd}tj|d|||jddS) Nzy Here is a list of modules whose name or summary contains '{}'. If there are any, enter a module name to get more help. zI Please wait a moment while I gather a list of all available modules... cSs>|r$|dddkr$|ddd}|ddkr:d||<dS)N .__init__rrrrL)find)r rSrrrrrcallbacksz$Helper.listmodules..callbackcsd|ddSrrrrrronerrorsz#Helper.listmodules..onerrorrz Enter any module name to get more help. Or, type "modules spam" to search for modules whose name or summary contain the string "spam". )r!rr.apropos ModuleScannerrunr-rk)r:rnrrrrrrs     zHelper.listmodules)NN)rr)rE)rE)rE)!r+r r!rZ _strprefixesZ_symbols_inverserrrZsymbols_rrrrr0rr!rrrrrrrrr-rrrrrrrrrrrr(sD(    W       r(c@seZdZdddZdS)rNc Cs|r |}d|_i}tjD]p}|dkrd||<|durF|d|dqt|jpRd}|dd}|d|}||dkr|d||qtj |dD]V\} }} |jrq|dur|d|dqzt | |} Wnt yYqYn0| j } t | d rjz| |} Wn&ty6|r.||YqYn0tt| pJd}t | d rd| |}nd}n^ztj| }Wn&ty|r||YqYn0|jr|jdnd}t|d d}|d|}||dkr||||q|r|dS) NF__main__rLrErKrrr get_source get_filenamerw)rrrrrr?r"rrer$ _get_specrrrrrzrrStringIOrrrrrrr#)r:rrnZ completerrseenrSr&rrorprrsourcer rrrrrs^            zModuleScanner.run)NNN)r+r r!rrrrrrsrcCsXdd}dd}t,tdtj|||dWdn1sJ0YdS)NcSs6|dddkr |ddd}t||o.d|dSNrrrz- )r r rSrrrrrszapropos..callbackcSsdSrrrrrrrszapropos..onerrorignorer)warningscatch_warningsfilterwarningsrr)rnrrrrrrs   rcsddlddlddlddlGdddjjGfdddjjGfdddj}||||}||j s|j st dq~|S) Nrc@seZdZddZddZdS)z!_start_server..DocHandlercSsX|jdrd}nd}|d|dd|||j||j|ddS)Nz.csstext/css text/htmlz Content-Typez%s; charset=UTF-8r) r rZ send_responseZ send_headerZ end_headersZwfiler urlhandlerr)r: content_typerrrdo_GET0 s   z(_start_server..DocHandler.do_GETcWsdSrr)r:rrrr log_message@ sz-_start_server..DocHandler.log_messageN)r+r r!rrrrrr DocHandler. srcs(eZdZddZfddZddZdS)z _start_server..DocServercSs6||_|j|f|_||_|j||j|jd|_dSNF)hostaddressrr<rhandlerr)r:rportrrrrrF s  z)_start_server..DocServer.__init__cs>|js2|jgggd\}}}|r|q|dSrf)rselectsocketrZhandle_requestZ server_close)r:Zrdwrexrrrserve_until_quitM s  z1_start_server..DocServer.serve_until_quitcSs |j||jr||dSr)r<server_activaterrrrrrT s z0_start_server..DocServer.server_activateN)r+r r!rrrrrrr DocServerD s rcs:eZdZfddZfddZddZddZd S) z#_start_server..ServerThreadcs2||_||_t||_j|d|_d|_dSr)rrrBrThreadrservingerror)r:rrr) threadingrrr[ s   z,_start_server..ServerThread.__init__c szzJjj__jj_t|j_|j |j |j }||_ | Wn*tyt}z||_WYd}~n d}~00dSr)server HTTPServerr<rrZMessageZ MessageClass staticmethodrrrready docserverrrzr)r:Zdocsvre)rremailhttprrrc s    z'_start_server..ServerThread.runcSs,d|_|j|_|j|_d|j|jf|_dS)NTz http://%s:%d/)rrZ server_portrr9)r:rrrrrp sz)_start_server..ServerThread.readycSs&d|j_|d|_d|_d|_dS)NTF)rrrPrr9rrrrstopv s z(_start_server..ServerThread.stopN)r+r r!rrrrr)rrrrrrr ServerThreadY s  rg{Gz?) Z http.serverZ email.messagerrrZBaseHTTPRequestHandlerrrrHrrtimesleep)rhostnamerrthreadr)rrrrrrr _start_servers8'   rrcs6Gfdddt}|fddfddfddfd d fd d fd dfddfddfdd}|dr|dd}|dkrtjtjt}tj||}t|}d| WdS1s0Yn|dkr"||St d||fdS)NcseZdZfddZdS)z_url_handler.._HTMLDoccsd}d|}d|||fS)Nzpydoc_data/_pydoc.cssz1a  Pydoc: %s %s%s
%s
r)r:rrcss_pathZcss_link html_navbarrrr s z#_url_handler.._HTMLDoc.pageN)r+r r!rrrrr_HTMLDoc srcs>dttdtf}d|tjddfS)Nz %s [%s, %s]raZ
Python %s
%s
T)Zterse)r rZpython_versionZ python_buildZpython_compiler)rlr"rrr s  z!_url_handler..html_navbarcsdd}ddd}ddtjD}||}|dd dd |g}i}tjD]}|||qT|d d d |fS)NcSs d||fSr6rr&rrr bltinlink sz3_url_handler..html_index..bltinlinkz7Index of ModulesrYrZcSsg|]}|dkr|qS)rr)rr&rrrr sz4_url_handler..html_index..z

zBuilt-in Modulesr^z|

pydoc by Ka-Ping Yee<ping@lfw.org>zIndex of ModulesrE) r#rrr1r'r rrrP)rr#namesrrrrrr html_index s"  z _url_handler..html_indexc sgfdd}t4tddd}tj|||dWdn1sR0Ydd}g}d d d }D]\}}||||qz|d |d d d|}d|fS)Ncs:|dddkr |ddd}||o0d|fdSrrprZ search_resultrrr sz3_url_handler..html_search..callbackrcSsdSrrrrrrr sz2_url_handler..html_search..onerrorrcSs d||fSr6rrrrrr sz4_url_handler..html_search..bltinlinkz5Search ResultsrYrZzkey = %sr^
zSearch Results) rrrrrr#rr'rP) rnrrrrr#r&rrrrr html_search s$   0 z!_url_handler..html_searchcsLdd}ddd}ttj}||}|ddd|}d|fS)NcSs d||fSNz%srrrrrr sz4_url_handler..html_topics..bltinlink,INDEXrYrZZTopicsr^)r#rr(rrkr1r')rr#rrrrr html_topics s z!_url_handler..html_topicscsLddd}ttj}dd}||}|ddd|}d|fS)NrrYrZcSs d||fSrrrrrrr sz6_url_handler..html_keywords..bltinlinkZKeywordsr^)r#rr(rrkr1r')r#rrrrrr html_keywords s z#_url_handler..html_keywordscst}t||}||\}}||jvr0d}nd}d|dd}d|}|dd|}|rt| }dd } ||} d dd|}d ||fd |||ffS) NZKEYWORDZTOPICrUrYrZz 

%s
r^cSs d||fSrrrrrrr& sz7_url_handler..html_topicpage..bltinlinkrz%s %srE) rrr(rrr#rKr'rr"r1r&rP)rbufZhtmlhelprrrr#rrrrhtml_topicpage s,     z$_url_handler..html_topicpagecs@t|dd}|dur$|dkr$tdt|}||}||fS)NrL)rrIzcould not find object)rrrr)r9r9rcontentrrr html_getobj/ s   z!_url_handler..html_getobjcsPddd}dfddtt||D}||dd|}d||fS) Nz,ErrorrYrZrc3s|]}|VqdSr)r rrrrr; rz3_url_handler..html_error..z#bb0000z Error - %s)r#rPrrAr')r9rr#rrrr html_error7 s  z _url_handler..html_errorc sp|}|dr|dd}z|dvr2\}}n|dkrF\}}n|dkrZ\}}nd|vr |d\}}}|dkr|\}}n|dkrz|\}}Wnty|\}}Yn0nZ|d kr|dvr\}}n2z|\}}Wn ty|\}}Yn0ntd n |\}}Wn4tyb}z||\}}WYd}~n d}~00||S) Nr)rErrrrz search?keyz topic?keyzget?keyz bad pydoc url)rrrrzr)r9Z complete_urlrr oprr)r"r r rrrrrrr get_html_pageA s>          $z#_url_handler..get_html_pagerrLrrErz"unknown content type %r for url %s) rrr r dirnamerealpathrwrPr readlinesrC)r9rrrZ path_hererfpr) r"r r rrrrrrr _url_handler s*         (    0 rT localhost) open_browserrc Csddl}tt||}|jr(t|jdS|jrd}|rB||jzzZtd|jt||jrtd}| }|dkr|qqZ|dkr||jqZt|qZWnt t fytYn0W|jr| tdn|jr| td0dS)Nrz"Server commands: [b]rowser, [q]uitzServer ready atzserver> r r zServer stopped) webbrowserrrrr rrr9rrrrr)rrrrZ serverthreadZserver_help_msgrrrrbrowsev s8     rcCst|to|tjdkSr)rrBrr sep)rtrrrispath srcCsvd|vstj|vst|vr"dStjt}tj|}|}||vrbtj||sb||| dt|S)NrEr) r curdirgetcwdr rrwcopysamefileremoveinsert)Z given_pathZargv0Z stdlib_dirZ script_dir revised_pathrrr_get_revised_path s    r!cCs,ttjtjd}|dur(|tjdd<dSr)r!rr argv)r rrr_adjust_cli_sys_path sr#c Csddl}Gdddt}tzx|tjddd\}}d}d}d}d}d}|D]\\} } | dkrld }d }| d krt| WdS| d krd }| }| d krd }| d krTd }| }qT|rt|||dWdS|s||D]} t| rtj | st d| qz`t| r&tj | r&t | } |rXt| rNtj | rNt| nt| n t| Wqty} zt | WYd} ~ qd} ~ 00qWnL|j|fytj tj tjdd} t dj| tjdYn0dS)Nrc@s eZdZdS)zcli..BadUsageN)r+r r!rrrrBadUsage rr$rLzbk:n:p:wFrz-bTz-kz-pz-wz-n)rrzfile %r does not existapydoc - the Python documentation tool {cmd} ... Show text documentation on something. may be the name of a Python keyword, topic, function, module, or package, or a dotted reference to a class or function within a module or module in a package. If contains a '{sep}', it is used as the path to a Python source file to document. If name is 'keywords', 'topics', or 'modules', a listing of these things is displayed. {cmd} -k Search for a keyword in the synopsis lines of all available modules. {cmd} -n Start an HTTP server with the given hostname (default: localhost). {cmd} -p Start an HTTP server on the given port on the local machine. Port number 0 can be used to get an arbitrary unused port. {cmd} -b Start an HTTP server on an arbitrary unused port and open a Web browser to interactively browse documentation. This option can be used in combination with -n and/or -p. {cmd} -w ... Write out the HTML documentation for a module to a file in the current directory. If contains a '{sep}', it is treated as a filename; if it names a directory, documentation is written for all the contents. )rr)getoptrzr#rr"rrrr r existsr rrr r'r#rrrrrr.r)r%r$ZoptsrwritingZ start_serverrrroptvalargrorrrrcli s`    $r+r)NN)r)r)rrN)rrN)r)rEN)r)r)_r_r}rrvrZimportlib._bootstraprZimportlib._bootstrap_externalZimportlib.machineryimportlib.utilrrr rerrFrrrrr urllib.parser`r collectionsrreprlibr tracebackrrrr'r>r7rDrJrRrTrWrZr`r> IGNORECASErarcrerjrurrrrrrrzrrrrrrrrrrrrrrrrrrrrXrr"rrr=r#r'r(rrrrrrrr!r#r+r+rrrr(s      3      ' 0:*; " ,    = n% U