grthtrhthjhtyjytjytkergtrhtrjytjerhrfh4:24 29/09/2026 eG*SrS/rSrSrSrSSKrSSKrSSKrSSKr SSK r SSK r SSK r SSK r SSKrSSKrSSKrSSKrSSKrSSKrSSKrSSKrSSKrSSKrSSKrSSKJr SSKJr SS KJr SS K J!r!J"r"J#r#J$r$J%r%J&r& \!r'\#r(\$r)\%r*\&r+S r,S r-S r.Sr/Sr0Sr1Sr2Sr3Sr4Sr5Sr6Sr7Sr8\Rr"S\Rt5r;SrSr?\@"\R5rBSKSjrCSrDSrES rFS!rG04S"jrH"S#S$\I5rJS%rKS04S&jrL"S'S(5rM"S)S*\5rN"S+S,\M5rO"S-S.\5rP"S/S0\M5rQ"S1S2\Q5rRSLS3jqSS4rTSMS5jrU\Q"5rV\R"5rW\O"5rXSMS6jrYSNS7jrZSOS8jr[SMS9jr\SPS:jr]"S;S<5r^\^"5r_"S=S>5r`S?raS@rbSQSAjrcSMSBSCSD.SEjjrdSFreSGrfSHrgSIrh\iSJ:Xa\h"5 gg)RaGenerate Python documentation in HTML or text for interactive use. At the Python interactive prompt, calling help(thing) on a Python object documents the object, and calling help() starts up an interactive help session. Or, at the shell command line outside of Python: Run "pydoc " to show documentation on something. may be the name of a function, module, package, or a dotted reference to a class or function within a module or module in a package. If the argument contains a path segment delimiter (e.g. slash on Unix, backslash on Windows) it is treated as the path to a Python source file. Run "pydoc -k " to search for a keyword in the synopsis lines of all available modules. Run "pydoc -n " to start an HTTP server with the given hostname (default: localhost) on the local machine. Run "pydoc -p " to start an HTTP server on the given port on the local machine. Port number 0 can be used to get an arbitrary unused port. Run "pydoc -b" to start an HTTP server on an arbitrary unused port and open a web browser to interactively browse documentation. Combine with the -n and -p options to control the hostname and port used. Run "pydoc -w " to write out the HTML documentation for a module to a file named ".html". Module docs for core modules are assumed to be in https://docs.python.org/X.Y/library/ This can be overridden by setting the PYTHONDOCS environment variable to a different URL or to a local directory containing the Library Reference Manual pages. 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_only) get_pagerplain pipe_pager plain_pagertempfile_pager tty_pagerch/n/n[RHn[RRU=(d S5n[RR U5nX1;dMQ[RR U5(dMwUR U5 UR U5 M U$)zAConvert sys.path into a list of absolute, existing, unique paths..)syspathosabspathnormcaseisdirappend)dirsnormdirsdirnormdirs ,/opt/alt/python313/lib64/python3.13/pydoc.pypathdirsr_s{ DHxxggoocjS)''""3'  "rww}}S'9'9 KK  OOG $  Kc[RRUR5nUcgURR S5SSHn[ X5nM [R"U5(dgU$)Nr) rmodulesget __module__ __qualname__splitgetattrinspectisclass)funcclsnames r _findclassr*ksc ++//$// *C {!!'',Sb1c 2 ??3   Jrc[R"U5(arURRnURn[R "U5(a'[ [ X!S5S5URLaUnGOURnGO[R"U5(a+URn[U5nUb[ X15ULagGOl[R"U5(acURnURn[R "U5(a#URS-U-UR:XaUnOURnO[U[5(a4URn[UR5nUb[ X15ULagO[R"U5(d "U5(anURnUR"n[ X15ULag[R$"U5(a+[ USS5n[U[&5(a X;aXA$OgUR(Hn[+[ XQ55nUcMUs $ g![,a M1f=f)N__func__r __slots__)r%ismethodr,__name____self__r&r$ __class__ isfunctionr* isbuiltinr" isinstancepropertyfgetismethoddescriptorisdatadescriptor __objclass__ismemberdescriptordict__mro__ _getowndocAttributeError)objr)selfr(slotsbasedocs r_finddocrDus||$$|| OOD ! ! GD-z :cll JC..C   C ||o ;'#,C78   3  |||| OOD ! !    #d *c.>.> >C..C C " "||" ;'#,C78  # #C ( (G,D,DS,I,I|| 3 S (  % %c * *Cd3E%&&4={"  WT01C ?J      sI00 I>=I>c[RUS5nUcgU[La0[U5Rn[ U[ 5(aX!:XagU$![ a gf=f)zQGet the documentation string for an object if it is not inherited from its class.__doc__N)object__getattribute__typerFr4strr>)r?rCtypedocs rr=r=sb %%c95 ; d?3i''G'3''GN sA8AA A$#A$c[U5nUc [U5n[ U[ 5(dg[ R"U5$![[4a gf=f)zGet the documentation string for an object. All tabs are expanded to spaces. To clean up docstrings that are indented to line up with blocks of code, any whitespace than can be uniformly removed from the second line onwards is removed.N)r=rDr> TypeErrorr4rJr%cleandoc)rGrCs r_getdocrOs^ V C { 6"C c3     C   *  s AAAc[U5=(d [R"U5nU=(a& [R"SSUR 55=(d S$)z-Get the doc string or comments for an object.z^ * )rOr% getcommentsresubrstrip)rGresults rgetdocrWs> V_ ; 3 3F ;F  :bffWb&--/: @b@rcUR5RS5n[U5S:XaUSS4$[U5S:a1USR5(dUSSR USS54$SSR U54$)z>Split a doc string into a synopsis line (if any) and the rest. rrQN)stripr#lenrUjoin)rCliness rsplitdocr`s~ IIK  d #E 5zQQx| Uqq!2!2Qx59--- tyy rc[R"U5nU(a2[USS5nUS:waS[U5- OSnUR US9$g![ [ 4ak [USS5nU(aRUSSS:XaS USS-n[US S5b3[R"S U5nU(aS XER5S-nUs$f=f) Nr/rQP) max_width__text_signature__r[z($(r0z)\(\w+(?:(?=\))|,\s*(?:/(?:(?=\))|,\s*))?)) r% signaturer$r]format ValueErrorrMrSmatchend)rGrgr)rdargspecms r _getargspecrns%%f- 6:r2D,0J,>c$iDI##i#8 8    " &"6= r{d" +vz40<HHI7S!GEEGH$55G sAAA8C CcbURnURU:waURS-U-nU$)z@Get a class name and qualify it with a module name if necessary.r)r/r!rGmodnamer)s r classnamerrs3 ??D G#  3&- KrcSUR;aOURRS5SnURU:waURbURS-U-$U$URU:wa UR$g)z[Get a name of the enclosing class (qualified it with a module name if necessary) or module.rrN)r" rpartitionr!rps r parentnamerus f!!!""--c215    'F,=,=,I$$s*T1 1K    '$$ $ (rcZ[R"U5=(d [R"U5=(dm [R"U5=(dP [R"U5=(d3 [R "U5=(d [R "U5(+$)z>Check if an object is of a type that probably means it's data.)r%ismoduler& isroutineisframe istracebackiscode)rGs risdatar|sy  (FGOOF,CF!!&)F-4__V-DF##F+F/6~~f/E GGrc|U(a4USRURUS55nUSSnU(aM4U$)z/Do a series of global replacements on a string.rZrr[N)r^r#)textpairss rreplacers= Qx}}TZZa12ab  % Krc[U5U:a>[SUS- S-5n[SUS- U- 5nUSUS-U[U5U- S-$U$)zCOmit part of a string if needed to make it fit in a maximum length.rr[N...)r]max)r~maxlenpreposts rcramr s` 4y6!fQh]#1fQhsl#DSzE!DT4$999 Krz at 0x[0-9a-f]{6,16}(>+)$c.[RSU5$)z>Remove the hexadecimal id from a Python object representation.z\1) _re_stripidrT)r~s rstripidrs ??5$ ''rc[R"U5(ag[R"U5(a3[USS5n[R"U5=(d USL(+$g)zc Returns True if fn is a bound method, regardless of whether fn was implemented in Python or in C. Tr0NF)r%r.r3r$rw)fnr@s r_is_bound_methodrsW r:t,$$T*->?  @ z$'(||~r'  Nrc/n/nUH4nU"U5(aURU5 M#URU5 M6 X#4$)zSplit sequence s via predicate, and return pair ([true], [false]). The return value is a 2-tuple of lists, ([x for x in s if predicate(x)], [x for x in s if not predicate(x)]) r)s predicateyesnoxs r _split_listr/s@ C B  Q<< JJqM IIaL  7NrcnUS;agURS5(aURS5(agURS5(a[US5(agU[La4U[;a*[ [ X S5[R5(ag UbX;$URS5(+$) z3Decide whether to show documentation on a variable.>rF__date____file__r/__path____spec__r- __author__ __cached__ __loader__r! __credits__ __package__ __version__ __builtins__r"__firstlineno____static_attributes__r__rZ__fieldsTNF) startswithendswithhasattr __future___future_feature_namesr4r$_Feature)r)allr?s r visiblenamerBs <<  tt!4!4Q sY 7 7 *)>!> gc. 0C0C D D {??3'''rc$/n[R"U5Hsup#pE[R"U5(a'Sn[U[5(aUR cSnOUS:Xa[ U5(aSnURX#XE45 Mu U$)zUWrap inspect.classify_class_attrs, with fixup for data descriptors and bound methods.data descriptorreadonly propertymethod static method)r%classify_class_attrsr8r4r5fsetrr)rGresultsr)kindr(rs rrr[sG$+$@$@$H S  # #E * *$D%**uzz/A* X "25"9"9"DC/0%I Nrc ^[US/5n[U5VVs0sHup4XC[U5- _M snnmU4SjnUR US9 gs snnf![a 0mN*f=f)zGSort the attrs list in-place by _fields and then alphabetically by namerc8>TRUSS5US4$Nr)r )attr field_orders r!sort_attributes..qsKOODGQ7aArrN)r$ enumerater]rMsort)attrsrGfieldsir)keyfuncrs @rsort_attributesrhspVY +F=Fv=NO=N tF m+=NO BG JJ7J P  s!AAAA A'&A'c [R"S[SS9 [RR U5(aPSHJn[RR [RRUSU-55(dMJ g g)z3Guess whether a path refers to a package directory.z,The pydoc.ispackage() function is deprecatedr[) stacklevel)z.pyz.pyc__init__TF)warningswarnDeprecationWarningrrrisfiler^)rexts r ispackagervsb MM@$4 ww}}T"Cww~~bggll4c1ABCC# rc Sn[R"UR5nUGH$up4 nU[R:XaX- nM#U[R:Xa[ R "5 [ R"S[5 [R"U5nSSS5 [W[5(d gUR5RS5SR5s $U[R:Xa US;aX- nMU[R [R"[R$4;dGM% g g!,(df  N=f![R&[([*4a gf=f)z8Return the one-line summary of a file object, if presentrQignoreNrYr)rf))tokenizegenerate_tokensreadlineSTRINGNEWLINErcatch_warnings simplefilter SyntaxWarningast literal_evalr4rJr\r#OPCOMMENTNLENCODING TokenErrorUnicodeDecodeError SyntaxError)filestringtokenstok_type tok_stringr docstrings rsource_synopsisrs,F))$--8-3 )H!Q8??*$X---,,.))(MB # 0 0 8I/")S11 (..t4Q7==??X[[(Z:-E$("2"2HKKARAR!SS.4" /.   !3[ AsCA.E!22E$E!1E!5AE! E! E! E E!!FFc[R"U5RnURUS5up4UbX2:GaeUR [ [ RR55(a[ RRnOTUR [ [ RR55(a[ RRnOSnUc.[R"U5nU [U5nSSS5 OU"SU5n[ R R#SUUS9n[ R$R'U5n [(R*S U R,(aU R,R/5SOSnX$4X'U$![a gf=f!,(df  N%=f! g=f)z.Get the one-line summary out of a module file.NNN__temp__loaderr)rstatst_mtimer rtuple importlib machineryBYTECODE_SUFFIXESSourcelessFileLoaderEXTENSION_SUFFIXESExtensionFileLoaderropenOSErrorrutilspec_from_file_location _bootstrap_loadrrrF splitlines) filenamecachemtime lastupdaterV loader_clsrrspecmodules rsynopsisrsx GGH  & &E8\:JZ/   U9#6#6#H#HI J J",,AAJ   uY%8%8%K%KL M M",,@@JJ   }}X. (. H5F>>99*hAG:ID "--33D9 J'7=~~V^^..034F / M)   s*(F% F5>G% F21F25 GG c$\rSrSrSrSrSrSrg)ErrorDuringImportizEErrors that occurred while trying to import something to document it.c[U[5(d?[U[5(de[U5UlX lUR UlO0[R"S[5 UuUlUlUlXl g)NzCA tuple value for exc_info is deprecated, use an exception instance) r4r BaseExceptionrIexcr __traceback__tbrrrr )r@r exc_infos rrErrorDuringImport.__init__sj(E**h 66 66H~DH!J,,DG MM_, .-5 )DHdj$' rcrURRnSUR<SU<SUR<3$)Nz problem in  - z: )rr/r r)r@rs r__str__ErrorDuringImport.__str__s&hh+/==#tzzJJr)rr rrN)r/r!r"rrFrrrrrrrsO !Krrc|[RRn[US5nXR [ U55:HnSSS5 [ RRU5n[ RRU5upVW(a [RRXP5nO[RRXP5n[RRXPUS9n[RRU5$!,(df  N=f![ an [#X 5eSn A ff=f)z> 1 1$V 1 LD+##))$//   +**+s#D1D! D! D;+ D66D;cU(aU[R;aU[R;am[RVs/sHo3RUS-5(dMUPM! nnU/U-H)n[RUX%'[RU M+ [R "U5nU$s snf![ anU[R;a'[[RURU5e[U5[La[URU5e[U[5(aURU:XaSnAg[X5eSnAff=f)aImport a module; handle errors; return None if the module isn't found. If the module *is* found but an exception occurs, it's wrapped in an ErrorDuringImport exception and reraised. Unlike __import__, if a package path is specified, the module at the end of the path is returned, not the package at the beginning. If the optional 'forceload' argument is 1, we reload the module from disk (unless it's a dynamic extension).rN)rrbuiltin_module_namesrr import_modulerrrrIrr r4 ImportErrorr))r forceloadr rmsubsrrr,s r safeimportr4s/ ,3333 $';;K;a,,tcz2J;K 6D=C!$S!1EJ C()((. M)L  / 3;; #CKK$5$>$>D D #Y+ %#CLL#6 6 [ ) )chh$.>$D. . /s8AB;B6#B6)A B;6B;; E"BE EE"c\rSrSr\R R SS\RSS-5r S Sjr S Sjr \ =r =r =r=r=rr\R&"S54S jrS rg) Doci PYTHONDOCSz%https://docs.python.org/%d.%d/libraryNr[cX4U-n[R"U5(aUR"U6$[R"U5(aUR"U6$[R "U5(aUR "U6$[R"U5(aUR"U6$UR"U6$![a NEf=f)z%Generate documentation for an object.) r%rw docmoduler&docclassrx docroutiner>r8docdatadocother)r@rGr)argss rdocument Doc.documents~$  ''0E)Ev&&t}}d/C(C  (($1G*G(  # #F + +DLL$4G-G}}d##   s)C)C)C C  C c|SU=(a S[U5-<S[U5R<3n[U5e)z+Raise an exception for unimplemented types.z!don't know how to document object z of type )reprrIr/rM)r@rGr)r>messages rfailDoc.fail's6  %S4:% %tF|'<'<>  rstdlibch[R"U5n[RR SUR 5n[RRU5n[U[[55(Ga URS;dJURU5(aUR[RRUS55(dURS;aSSKJn U(aURUR;atURURnURS 5(a#S R#UR%S 5U5nU$[RRXF5nU$SnU$SnU$![a SnGNf=f![ a SnNf=f) z*Return the location of module docs or None (built-in)r7) errno exceptionsgcmarshalposixsignalr_thread zipimportz site-packages)z xml.etreeztest.test_pydoc.pydoc_modr) module_docsN)zhttp://zhttps://z{}/{}/)r% getabsfilerMrenvironr r7rrr4rIr/rr^ pydoc_datarRr1rhrU)r@rGbasedirrdoclocrRdoc_names r getdocloc Doc.getdocloc/sg %%f-D doo>''""7+ vtBx ( ( __!99oog&&//"'',,w"HII OO#M M #2v+2I2II&226??C$$%<==$^^FMM#,>IF  WW\\&;F   F ; D  #"  #s#F+F" FF" F10F1r!N)r/r!r"rrrUr r version_infor7r?rEr9r:r;r= docpropertyr< sysconfigget_pathrZrr!rrr6r6sm G"%"2"22A"6!78J$ ! LPOIOO:OO;(1(:(:8(D"rr6cD\rSrSrSrSrSrSrSrSr \ r Sr \ r S r g ) HTMLRepriUzBClass for safely making an HTML representation of a Python object.cv[R"U5 S=UlUlSUlS=UlUlgN drrmaxlistmaxtuplemaxdict maxstringmaxotherr@s rrHTMLRepr.__init__W1 d')) t} ),,rc $[USSSSSS5$)N&z&z>)rr@r~s rescapeHTMLRepr.escape]stS'3VDDrc.[R"X5$r\)rrCr@rGs rrC HTMLRepr.repr`syy&&rc P[[U5S5(aVSSR[U5RR 55-n[X5(a[ X5"X5$UR [[[U55UR55$Nr/repr_r) rrIr^r/r#r$rvrrrCrmr@rlevel methodnames rrepr1HTMLRepr.repr1csw 47J ' ' 388DG,<,<,B,B,D#EEJt((t0::{{4Q 0$--@AArc[XR5n[U5nSU;a1S[USS5;a SUS-UR U5-US-$[ R "SSUR U55$)N\\\rQrrz-((\\[\\abfnrtv\'"]|\\[0-9]..|\\x..|\\u....)+)z\1)rrlrCrrvrSrTr@rrtesttestreprs r repr_stringHTMLRepr.repr_stringjs{A~~&: 4)rvrrrCrlr1r/r@rrs r repr_instanceHTMLRepr.repr_instancewsQ G;;tGDG$4dnnEF F G;;1E1EEF Fs 69*A%rkrirmrlrjN)r/r!r"rrFrrvrCrrrepr_strr repr_unicoderr!rrrbrbUs4L- E'B -HG Lrrbc(\rSrSrSr\"5r\Rr\RrSr SSjr SSjr Sr Sr S rS rS rS rS rSrSrSrS0004SjrSSjrSSjrSS004SjrSrSS000SS4SjrSSjr\rSSjrSSjrSr g) HTMLDociz'Formatter class for HTML documentation.cSU<SU<S3$)Format an HTML page.zN Python: z z r!)r@titlecontentss rpage HTMLDoc.pagesH& &rc*SU<SU=(d S<S3$)zFormat a page heading.zU
 
z		  z
r!)r@rextrass rheadingHTMLDoc.headings &$H$ & &rNc Uc SSU--S-nSU<SU<S3nU(aUSU<SU<S U<S U<S U<S 3 -nOUSU<S U<SU<S 3-nUSU--$)z Format a section with a heading.zrzz-

z z-decor">z
 
z
z z
z. %s
r!) r@rr(rwidthprelude marginaliagaprVs rsectionHTMLDoc.sections{  .E1AAIMJ   :sGS::F 8;ZNNFIHTTTrc2SU-nUR"U/UQ76$)z$Format a section with a big heading.z&%s)r)r@rr>s r bigsectionHTMLDoc.bigsections 85@||E)D))rc fURUR55n[USSSSSSSS5 $)z!Format literal preformatted text. z rBrrY
)rv expandtabsrrus r preformatHTMLDoc.preformats7{{4??,-tVWfg (D(< rrz%s
)r]range)r@listrhrVrowscolrs r multicolumnHTMLDoc.multicolumnsD A !#8C88F48TXd]3s4y=#fTWo5@F4g%F  ,f44rc SU-$)Nz%sr!rus rgrey HTMLDoc.greys !?$!FFrc@UHnX;dM SX1<SU<S3s $ U$)z:Make a link for an identifier, given name-to-URL mappings. r!)r@r)dictsr;s rnamelinkHTMLDoc.namelinks%D|04 DAA rc UR[RRUR5pC[ XC5(a0[ XC5ULa"SUR<SU<S[X5<S3$[X5$)zMake a link for a class.r.html#rr)r/rrr r!rr$rr)r@rGrqr)rs r classlinkHTMLDoc.classlinks^ 8I8I(Jf 6 WV%:f%Dy'AC C))rcSnUR[RRUR5pT[ XT5(a[ XT5ULawSUR;aHURRS5SnURU:waUR<SU<3nO%SU-nOURU:waSUR-nU(aSU<S[X5<S 3$[X5$) z.Make a link for the enclosing class or module.Nrrrz#%s%s.htmlrrr) r/rrr r!rr$r"rtru)r@rGrqlinkr)rs r parentlinkHTMLDoc.parentlinks 8I8I(Jf 6 WV%:f%Df)))**55c:1=$$/+1??DAD 4r)r/rys r modulelinkHTMLDoc.modulelinks-3__fooNNrcUup#pEU(aURU5$U(a U<SU<S3nOSU-nU(aSU-nOUnSU<SU<S3$)z;Make a link for a module or package to display in an index.r.htmlrz"%s (package)rrr)r)r@ modpkginfor)rrshadowedurlr~s r modpkglinkHTMLDoc.modpkglinksR*4'I 99T? " "&-Cd"C 7$>DD(+T22rcSU<SU<S3$)zMake a link to source file.z%sNrQ) rvrScompilesearchspanrgroupsrintrr^)r@r~rvfuncsclassesrrherepatternrjstartrkrschemerfcpepselfdotr)rs rmarkupHTMLDoc.markups&4;;**34~~d11e1JE NN6$E"23 438<<> 0C7DSk))#x8SAB@3s8KVC[IJ9CHDVC[IJCE?c)NN7T]]4-I#IJNN#=#DE#a%C't}}T77KLt}}T7;<D3~~d11e114 vd5k*+wwwrcSnUHn[U[5(auUupgUS-nX@RXb5-nU(aKXs4:waE/nUH#n URURX55 M% US-SR U5-S-nUS-nM[U[ 5(dMUSUR XRW5--nM SU-$) zAProduce HTML for a class tree as given by inspect.getclasstree().rQz

rf, rz
z
%s
z
%s
)r4rrrr^r formattree) r@treerqparentrVentrycbasesparentsrBs rrHTMLDoc.formattree-sE%'' "==.."<<Ui/ G %t~~d'DE!&#c\DIIg,>>DF)+E4(("3dooA7'#''!6))rc ^URnURnURS5n/n[ [ U5S- 5H4nUR SSRUSUS-5<SXh<S35 M6 SRXvSS-5n SU -n [R"U5n [RRU 5n TRX5n /n[US 5(a][!UR"5nUSS S :XaUSSS :XaUS SR%5nUR STR'U5-5 [US5(a3UR TR'[!UR(555 U(aU SSRU5--n TR+U5nUbS[-5-nOSnTR/U SU -U-5n[R0"U[R25n/0nn[R0"U[R45H`unnUc$[R6"U5=(d UULdM-[9UXQ5(dM@UR UU45 SU-=UU'UU'Mb UHunnUR:HnURUR<nn[>R@RCU5nUU:wdMBU(dMK[UU5(dM^[EUU5ULdMoUU;dMwUS-U-=UU'UU'M M /0nn[R0"U[RF5HunnUc?[RH"U5(d$[R6"U5=(d UULdMH[9UXQ5(dM[UR UU45 SU-UU'[RJ"U5(dMUUUU'M /n[R0"U[L5H,unn[9UXQ5(dMUR UU45 M. TRO[QU5TRRUU5nU=(a SU-nUSU--n[US5(a/n[TRV"URX5Hunnn UR UUU S45 M UR[5 TR]UTR^5n!UTRaSSU!5-nO3U(a,TR]UU4Sj5n!UTRaSSU!5-nU(aUVVs/sHunnUPM n"nnTRc[Rd"U"S5U5/n!UH*unnU!R TRgUUUUU55 M, UTRaS S!S"RU!55-nU(aW/n!UH*unnU!R TRgUUUUU55 M, UTRaS#S$S"RU!55-nU(aT/n!UH'unnU!R TRgUU55 M) UTRaS%S&S'RU!55-n[US(5(aETRO[!URh5TRR5n!UTRaS)S*U!5-n[US+5(aETRO[!URj5TRR5n!UTRaS,S-U!5-nU$![a SnGNSf=f![a S n GNf=fs snnf).z/Produce HTML documentation for a module object.NrrZrz.html" class="white">rr!%srIr $Revision: $z version %srz (%s)rz-
Module ReferencerQzindex
#rz#-z%sz

%s

rrzPackage Contentsz pkg-contentc,>TRUS5$r)r)tr@s rr#HTMLDoc.docmodule..s4??1Q4#8rModulesClassesindexrB Functions functionsDatadatarrAuthorauthorrCreditscredits)6r/__all__r>r#rr]rr^r%rTurllibparsequoterrMrrJrr\rvrrZlocalsrrrwr& getmodulerrr!rrr r$rxr3r2r|rrWrpkgutil iter_modulesrrrrrr getclasstreer?rr)#r@rGr)modignoredrpartslinksr linkednameheadrrrinfoversionrXrVrrcdictrrrBrqrrfdictrrCmodpkgsimporterispkgr classlists#` rr9HTMLDoc.docmodule@s ..C 3s5z!|$A LL%1+&2 3%XXeBCj01 2Z? $%%f-D,,$$T*C}}S/H 6= ) )&,,-Gs|11gbclc6I!"R...0 KK t{{7';; < 6: & & KK C$89 : 'DIIdO33D'  DvxOFFd$?($JV$ST$$VW-=-=>R!,,VW__EJC""5)3V>sC00NNC<003c 9E#Ju F"JC#}}dooW1d?vv'F2Fvs+t3"e|7>7IC7OOE#Jt ("2u!,,VW5F5FGJC$$U++%%e,66AsC00LL#u.!%E#J))%00s%,H!,,VV>F H" U eS 9:#doo h 799F 6< ( ({{3v'8'8#94>>JHdooh(KKF 6= ) ){{3v'9'9#:DNNKHdooiHMMF _ C  $#H $N\rSrSrSrU4SjrSrg)(HTMLDoc.docclass..HorizontalRuleicSUlgrneedonerns rr1HTMLDoc.docclass..HorizontalRule.__init__   rcF>UR(aT"S5 SUlg)Nz
rZr'r@pushs rmaybe.HTMLDoc.docclass..HorizontalRule.maybe<<N  rr'Nr/r!r"rrr.rr-srHorizontalRuler% ! ! !rr3r[z&
Method resolution order:
z
%s

c ,>[X5up1U(aVT R5 T"U5 UH8upEpg[T U5nT"TRXtT T TT T U55 T"S5 M: U$![a T"TR XtT 55 N2f=f)NrYrr.r$r? Exceptionr<)msgrrokr)rhomeclsrrrhrmdictrrGr-r@s rspillHTMLDoc.docclass..spills#E5IB S 24.DQ ' 5 T]]5(-wvwPQJ35L%=T\\%s;<=s A.."BBc>[X5up1U(a<TR5 T "U5 UHupEpgT "T RXtT 55 M U$r\rr.r< r9rrr:r)rr;rr<rr-r@s rspilldescriptors*HTMLDoc.docclass..spilldescriptorsI#E5IB S 24.De37835Lrcx>[X5up1U(aT R5 T"U5 UHupEpgTR[TU5UT5n[ U5n U (d T"SU-5 O=TR [ U5TR T T T 5n SU -n T"SU<U <S35 T"S5 M U$)Nz
%s
z
%s
r5rY)rr.r=r$rWrr)r9rrr:r)rr;rrBrCrrr<r=rrGr-r@s r spilldata#HTMLDoc.docclass..spilldatas#E5IB S 24.D==)>cJD -C0478"kk&-*/%A@3FdC@AJ35Lrr?r-rc>USTL$Nr[r!r thisclasss rr"HTMLDoc.docclass..AaDI z Methods %scUSS:H$NrZrr!rs rrrP* AaDH$4rzClass methods %scUSS:H$NrZz class methodr!rVs rrrP, AaDN$:rzStatic methods %scUSS:H$NrZrr!rVs rrrP. AaDO$;rzReadonly properties %scUSS:H$NrZrr!rVs rrrP0qt7J/JrzData descriptors %scUSS:H$NrZrr!rVs rrrP2qt7H/HrzData and other attributes %scUSS:H$NrZrr!rVs rrrP4 !rrQ class zz = class r(%s)r()rz&%s
 rr)r/rrrr%getmror]r.rr!rrr$r8rMpopleftrbuiltinsrGrr^rnrvrWrrr)"r@rGr)rrrrrealnamerrr3mrorBr>rCrHrr(rrrr;anchor inheritedtagrrdeclrlrCr<r=r-rOs"`` ``` @@@@rr:HTMLDoc.docclasss??x   ! ! GNN6*+ s8a< HHJ : ;_t~~d6<6G6G(IIJ O  $    &0DF/K3/K+T4e&1*$c5)/K 3). %Cw"%*s"2S"8 8E#J -   &e */KKM !!HQK *52MN E9X__,hoo1M!f$$)DNN9;A;L;L-NN 9 C E6 *,,e46E,s2E:D||E7Ha==a3    s0>M8  M8  NN N N N N cHURSURU5-5$z)Format an argument default value as text.=)rrCrys r formatvalueHTMLDoc.formatvalueSsyytyy0011rc zURn U=(d U nUcUnUcSO URS-U-n Sn Sn Sn [U5(anURnXLa[USS5n O[R "U5(aSUR X5-n OSUR URU5-n Ov[R"U5(d[R"U5(a>URnUcSUR X5-n OXLaS UR X5-n OUn [R"U 5(aZUbWU RUR:wd U RURS -U -:waURX5nU(aS U-n [R "U5(d[R""U5(aS nOSnX):Xa S U <SU <S3nOcUbP[R$"Xy/5ULa6SURS-U -<SU <S3nSn U R'S 5(aSn OU nS U <SU<SU<3nSn[R("U5(a3[+U5nU(a!U S:XaSU-nUR,(dUSSnU(dSnUU-UR/U5-U =(a UR1SU -5-nU (aSU-$UR3[5U5UR6XEU5nU=(a SU-nSU<SU<S3$![a GN f=f) z;Produce HTML documentation for a function or method object.NrQrKFr, class method of %s method of %s instance unbound %s method from r from %sasync rgz ">rhz %sz
%s
z%
%s
rGzr5)r/rr0r$r%r&rr1r7ismethodwrapperr9r>r2r!r"riscoroutinefunctionisasyncgenfunctiongetattr_staticrrxrn__annotations__rvrrrWr)r@rGr)rrrrrr;rnrpnoteskipdocsimfuncimselfobjclasspnameasyncqualifierrreallinkrlrsrCs rr;HTMLDoc.docroutineWs ??x ?G " s:TA F # #__F| T:((,t~~f/JJ/$..$$c3++((00%%f-- D!..:/$..2OOD,#dnnX&CCDF   f % %'*=   !3!3 3   7#7#7##=#H HOOF0E!E)  ' ' / /**622%NN  >DhOE&&rR8FBKK#%0(<??8,,D#h(E   V $ $!&)G8z1>E--%amGG% G(<<AHyy?$FGI +d2 2++vICGACGC15s; ;u"  s/ L,, L:9L:c/nURnU(a U"SU-5 UR[U5UR5nU(a U"SU-5 U"S5 SR U5$)z1Produce html documentation for a data descriptor.z!
%s
z&
%s
r5rQ)rrrWrr^ r@rGr)rrrrr-rCs rr<HTMLDoc.docdatas`~~  5< =kk&.$..9  :S@ A YwwwrcVU=(a SU-=(d SnXPRU5-$)z-Produce HTML documentation for a data object.z%s = rQrC)r@rGr)rrlhss rr=HTMLDoc.docothers)6/$6<"YYv&&&rc6/nUc0n[R"U/5H:upEn[SU55(aMURUSXeU;45 SX%'M< UR 5 UR X0R 5nURUSU5$)z2Generate an HTML index for a directory of modules.c3^# UH#nS[U5s=:*=(a S:*Os v M% g7f)iiN)ord.0chs r HTMLDoc.index..s$@4RFc"g////4s+-rQrZr)rranyrrrrr)r@rrrrr)r rs rr HTMLDoc.indexs  X%,%9%93%%@ !HE@4@@@ NND"eX-=> ?HN &A  ##G__=sGX66rr!rQ)rQNrr\rNNN)!r/r!r"rrFrb_repr_instancerCrvrrrrrrrrrrrrrrrr9r:rxr;r<r^r=rrr!rrrrs1ZN   D  " "F &&3419U** < 5G*/&O 38#'b"b% R*&tl%)d"b[>z2'+RdR.s5"Dy2~s)r^rus rbold TextDoc.boldsww5555rcU(dgURS5Vs/sHo2U-R5PM nnSRU5$s snf)z6Indent text by prepending a given prefix to each line.rQrY)r#rUr^)r@r~prefixliner_s rindentTextDoc.indentsFB6:jj6FG6Fd4-'')6FGyyHsA ctURU5R5nURU5S-U-S-$)z&Format a section with a given heading.rYr)rrUr)r@rrclean_contentss rrTextDoc.sections7X.557yy$&7&@@rNc @^SnUHn[U[5(aLUupxXT-[UT5-nU(a)X4:wa#U4SjU5n USSRU 5--nUS-nMd[U[5(dM{XPR UTWUS-5-nM U$)zBRender in text a class tree as returned by inspect.getclasstree().rQc3<># UHn[UT5v M g7fr\rr)rrrqs rr%TextDoc.formattree..sDeyG44esrirrY )r4rrrr^rr) r@rrqrrrVrrrrs ` rrTextDoc.formattree sE%'' 9Q+@@Ui/DeDG#ftyy/A&AAF$E4((//7Av#88 rc  URn[[U55upVURSX%=(a SU--5n[ USS5nUR U5n U bXpRSU S-5-nU(aXpRSU5-n/n [ R"U[ R5HQupUc$[ R"U 5=(d UULdM,[XU5(dM?U RX45 MS /n [ R"U[ R5HlupUc?[ R"U 5(d$[ R"U 5=(d UULdMG[XU5(dMZU RX45 Mn /n[ R"U[5H*up[XU5(dMURX45 M, /n[5n[!US5(a["R$"UR&5HFunnnUR)U5 U(aURUS -5 M5URU5 MH UR+5 XpRS S R-U55-n/n[ R"U[ R.5HCupU RR1US -5(dM*U U;dM2URU 5 ME U(a3UR+5 XpRS S R-U55-nU (aU V V s/sHupU PM nn n UR3[ R4"US5U5/nU H&upURUR7XU55 M( XpRSS R-U55-nU (aQ/nU H&upURUR7XU55 M( XpRSS R-U55-nU(aP/nUH%upURUR9XUSS95 M' XpRSS R-U55-n[!US5(aN[;UR<5nUSSS:XaUSSS:XaUSSR?5nXpRSU5-n[!US5(a'XpRSR@55-n[!US5(a'XpRS[;URB55-n[!US5(a'XpRS[;URD55-n[ RF"U5nXpRS!U5-nU$s sn n f![Ha S nN*f=f)"z5Produce text documentation for a given module object.NAMErr NzMODULE 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. DESCRIPTIONr (package)zPACKAGE CONTENTSrYr SUBMODULESrZCLASSES FUNCTIONSF)rDATArrrrrVERSIONrDATErAUTHORrCREDITSrIFILE)%r/r`rWrr$rZr%rr&rrrrxr3r|setrrrraddrr^rwrrrr?r=rJrr\rrrrTrM)r@rGr)rrsynopdescrVrrXrrrrrr modpkgs_namesrrqr  submodulesr!rrrs rr9TextDoc.docmodulesvf~. fd.E &FGfi.'  ll+=vI@F ll=$??F!,,VW__EJC%%e,66As00NNC<0 F !,,VW5F5FGJC$$U++%%e,66As00LL#. H!,,VV>F 6: & &ll63v3GHHF 6< ( (ll8S9J9J5KLLF 6= ) )ll9c&:L:L6MNNF %%f-D,,vt44 G:@ D s"W !W W"!W"c ^^^^^^TRnU=(d UnTRnTR4SjnX%:XaSTRU5-nOTRU5S-U-nU(a"[ Xv5n USSR U 5--n/n U R m[T5n U (aU S:wa T"X+-S-5 [T5n U (a T"U S-5 [[R"T55n [U 5S:a*T"S 5 U HnT"S U"U5-5 M T"S 5 [S [RT55[ R"S 9n[U5nSnU(aGT"S5 USUHnT"S U-5 M UU:aT"S[!UU- 5-S-5 T"S 5 "U4SjS5nU"5mUUUUU4SjnUUUU4SjnUUUUU4Sjn[%T5VVVVs/sHunnnn['UTS9(dMUUUU4PM! nnnnnU(aU (aU R)5mOUSSm[+UU4Sj5unnT[,R.LaT[,R.LaUnMdTTLaSnOS[1TTR5-n[3UT5 U"SU-US5nU"SU-US 5nU"S!U-US"5nU"S#U-US$5nU"S%U-US&5nU"S'U-US(5nU/:XdeUnU(aMSR U 5n U (dUS-$US-TR5U R75S)5-S-$s snnnnf)*z4Produce text documentation for a given class object.c[X5$r\r)rrms rmakename"TextDoc.docclass..makenames Q? "rclass z = class rirrjrYr[zMethod resolution order:rrQc3# UHNnURRS5(aM%URS:XdM7[UR5v MP g7f)rrmN)r/rr!rJ)rr(s rr#TextDoc.docclass..sI S*E3LL++C058^^z5QS  *Es$AAArrzBuilt-in subclasses:Nz ... and z other subclassesc(>\rSrSrSrU4SjrSrg)(TextDoc.docclass..HorizontalRuleicSUlgrr'rns rr1TextDoc.docclass..HorizontalRule.__init__r*rcF>UR(aT"S5 SUlg)NzF----------------------------------------------------------------------rZr'r,s rr..TextDoc.docclass..HorizontalRule.mayber0rr'Nr1r2srr3rr4rr3c >[X5up1U(aLTR5 T "U5 UH.upEpg[T U5nT "T RUUT T U55 M0 U$![a T "T R XtT 55 MYf=fr\r7) r9rrr:r)rr;rr<rrGr-r@s rr>TextDoc.docclass..spills#E5IB S 24.DE ' 5 T]]5(,c67DE35L%=T\\%s;<=s A$$"B  B c>[X5up1U(a<TR5 T "U5 UHupEpgT "T RXtT 55 M U$r\rArBs rrC*TextDoc.docclass..spilldescriptorsrErc >[X5up1U(aWT R5 T "U5 UH9upEpg[U5n[T U5n T "TR XT SUS9S-5 M; U$![a UR Un N__dict__r=)r9rrr:r)rr;rrCr?r<rrGr-r@s rrH#TextDoc.docclass..spilldatas#E5IB S 24.D -C5%fd3s#bcJ 35L *5%..t45s A//B  B rJrc>USTL$rMr!rNs rr"TextDoc.docclass..rQrrRrSz Methods %s: cUSS:H$rUr!rVs rrrrWrzClass methods %s: cUSS:H$rYr!rVs rrrrZrzStatic methods %s: cUSS:H$r\r!rVs rrrr]rzReadonly properties %s: cUSS:H$r_r!rVs rrrr`rzData descriptors %s: cUSS:H$rbr!rVs rrr rcrzData and other attributes %s: cUSS:H$rer!rVs rrr rfrz | )r/rr!rmapr^rrnrWrr%rkr]sortedrI__subclasses__rJlowerrrrlrrmrGrrrrrU) r@rGr)rrrnrrrrrrlrCrorB subclassesno_of_subclassesMAX_SUBCLASSES_TO_DISPLAY subclassnamer3r>rCrHrr(rrrqrrr<r-rOs `` ` @@@rr:TextDoc.docclasss??x   ++ #  tyy22EIIdOk1Hr2r!r"rurrrrrrxrnrrWrrU)r@rGr)rrr;rnrrrrrrrrrlrsrCs rr;TextDoc.docroutines??x ?G F # #__F| T:((,y/EE/)$$c3++((00%%f-- ?!..:/)H2JJD,#i&>>DF   f % %'*=   !3!3 3   7#7#7##=#H Hv+E!E)  ' ' / /**622%NN  IIh'E&&rR8FB??8,,DIIdOe+h6E   V $ $!&)G8z1 $*4--%amGG%/$6 $; .&BC$;#"J$++c*:*A*A*Cd*JK Ke"  s K KKc/nURnU(aU"URU55 U"S5 [U5=(d SnU(aU"URU55 U"S5 SR U5$)z1Produce text documentation for a data descriptor.rYrQ)rrrWrr^rs rr<TextDoc.docdatacsb~~  4 ! JVn"  S! " JwwwrrclURU5nU(a6U=(a US-=(d SU-n U[U 5- n U S:aUSU S-nU=(a URU5S-=(d SU-n U(d [U5nU(a#U SUR [ U55-S-- n U $)z-Produce text documentation for a data object.rrQrNrrY)rCr]rrWrrJ) r@rGr)rrrrCrrCrchops rr=TextDoc.docotherssyy  )TE\/R47DCI%DaxUd e 304506B$>.C  D4;;s3x0047 7D rr!)r)NrQr)NNNNr)r/r!r"rrFrrrCrrrrr9r:rxr;r<r^r=rr!rrrrsj1ZN   D6 A dLSLj'HLT  K $  rrc\rSrSrSrSrSrg) _PlainTextDociz2Subclass of TextDoc which overrides string stylingcU$r\r!rus rr_PlainTextDoc.bolds rr!N)r/r!r"rrFrrr!rrr r s <rr c.[5q[X5 g)zCThe first time this is called, determine what kind of pager to use.N)rpager)r~rs rrrs KE $rc[R"U5(a\UR[R;aSUR-$[ US5(aSUR-$SUR-$[R "U5(aSUR-$[R"U5(a@SURR<SURR<SUR<3$[R"U5(a@SURR<SURR<SUR<3$[R"U5(aS UR-$[R"U5(aS UR-$[R"U5(aS UR-$[U5R$) z/Produce a short description of the given thing.zbuilt-in module rzpackage zmodule zbuilt-in function zgetset descriptor rzmember descriptor rz function zmethod )r%rwr/rr/rr3isgetsetdescriptorr9r!r:r&r2r.rI)things rdescriberso >>S55 5%6 6 5* % %. .u~~- -#enn44!!%((    ) )5+=+=+F+F NN !!%((    ) )5+=+=+F+F NN u%..((%  U^^++5>>)) ;  rcxURS5Vs/sH o"(dM UPM nnSupEU[U5:a@[SRUSUS-5U5nU(aXeS-pTOOU[U5:aM@U(aUnO[nX5SHn[ Xr5nM U$s snf![ a  gf=f)z@Locate an object by name or dotted path, importing as necessary.rrNrZ)r#r]r4r^rmr$r>)rr2partrrn nextmodulerGs rlocaters"jjo 6odToE 6IF c%j.t! 5yA :1uq c%j.b  V*F M 7  s B&B& B++ B98B9c[U[5(a[X5nUc[SU-5eX 4$[ USS5nU[U[5(aU4$S4$)zDGiven an object or a path to an object, get the object and its name.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/)r4rJrr1r$)rr2rGr)s rresolversq%) >,/445 5}uj$/js33d====rcUc[n[X5upE[U5n[R"U5nU(a!SU;aUSUSUR S5-- nOU(aXtLaUSUR -- n[R"U5(d[R"U5(dt[R"U5(dY[R"U5(d>[U5(d.[US5(a URnO[U5nUS- nX-S-URXE5-$)zBRender text documentation, given an object or a path to an object.Nrz in z in module __origin__ objectr)r~rrr%rrfindr/rwr&rxr8rOrrrIr?)rrr2rendererrGr)rrs r render_docr s 5,LF F D   v &F t  .tzz#/// F( //   V $ $oof%%''&&v..foo 6< ( (&&F&\F I D <& 8#4#4V#B BBrcUc[U[5(aUnO\[USS5n[U[5(d:[USS5n[U[5(d[U5RS-n[ [ XU5SU<35 g[ XU[5nURU5 g![anU(ae[U5 SnAgSnAff=f![an[U5nSnANVSnAff=f)zCDisplay text documentation, given an object or a path to an object.Nr"r/rHelp on ) r4rJr$rIr/rr r1print plaintextwrite)rrr2outputis_cliwhatrrs rrCrCs~ %%%und;!$,,"5*d;D%dC00#E{33i? *U95$7J K  5I>A  Q  #JJ  CA s0BB8C"8 CCC" D, C<<Dc[X5up#[R[U5[R X#55n[ US-SSS9nUR U5 SSS5 [SUS-5 g!,(df  N=f)z" 5 4s A88 BchUc0n[R"U/U5Hup4n[U5 M g)zAWrite out HTML documentation for all modules in a directory tree.N)r walk_packagesr/)rpkgpathdonerrqr s r writedocsr4 s5 |BT$+$9$93%$I 5%J rc\rSrSr0SS_SS_SS_SS_SS _S S _S S _SS_SS_SS_SS_SS_SS_SS_SS_SS_S S!_0S"S!_S#S$_S%S&_S'S(_SS)_S&S*_S+S,_S-S._S/S0_SS1_S2S3_S4S_S5S_S6S7_S8S9_S:S;_S!S<_ES=S>S?S@.ErSAVVVs/sHnSBHo!U-PM M snnnrSCSDSESF/\Q7SGSHSISJSKSLSM.r0SNSO_SPSQ_SRSS_STSU_SVSW_SXSY_SZS[_S\S]_S^S__S`Sa_SbSc_SdSe_SfSg_ShSg_SiSj_SkSj_r\R5H4ur r \ H(r \R\ \ 5r \ \ ;a\ Sl-\ -r \ \\ 'M* M6 C C C C 0SmSn_S]So_SpSq_SrSs_StSu_SvSw_SxSy_SzS{_S|S}_S~S_SS_SS_SS_SS_SS_SSm_SSm_0SS_SWS_SS_SS_SS_SS&_SS_SS_SS_SS_SS_SS_SS_SS_SS_SS_SS_E0SS_SS_SS_SS_SS_SS_SS_SS_SS_SaS_SS_SS~_SS_SS_SS_SS_SS_E0SS_SS_SS_SS_SQS_SS_SS_SS_SS_S.S_SS_SS _SS_SS_S_S_SS_SS:_ES&SSSSSS.Er SSjr\S5r\S5rSr\"5r\4SjrSrSrSSjrSrSSjrSrSrSrSSjrSSjrSr SSjr!Sr"gs snnnf)HelperiFalserQNoneTrueandBOOLEANaswithassert)r>rQasync)r?rQawait)r@rQbreak)rA while forcaserjclass)rDzCLASSES SPECIALMETHODScontinue)rErBdef)functionrQdel)rH BASICMETHODSelififelse)rLrBexcepttryfinallyfor)rPzbreak continue whilefromimportglobal)rSznonlocal NAMESPACES)rKzTRUTHVALUE match)rRMODULESin)rUSEQUENCEMETHODSis COMPARISONlambda)rYr)rjrKnonlocal)rZzglobal NAMESPACESnotorpass)r]rQraise)r^ EXCEPTIONSreturn)r`r)rNr_)whilezbreak continue if TRUTHVALUE)r=z CONTEXTMANAGERS EXCEPTIONS yield)yieldrQ)rar=rb)bfru'rrgz'''rz""")+rK***rSz//%<<>>rr|^~rsrt<=>===!=<>)rsrtrqrrrsrtru)rKrp) z+=z-=z*=z/=z%=z&=z|=z^=z<<=z>>=z**=z//=)rlrmrrrnrorp)jJ)STRINGS OPERATORSrXUNARYAUGMENTEDASSIGNMENTBITWISECOMPLEXrkzOPERATORS FORMATTINGrjPOWER,zTUPLES LISTS FUNCTIONSrz ATTRIBUTES FLOAT MODULES OBJECTSrELLIPSIS:zSLICINGS DICTIONARYLITERALS@z def classrrxz:=ASSIGNMENTEXPRESSIONSr PRIVATENAMESrzPRIVATENAMES SPECIALMETHODS` BACKQUOTESrfzTUPLES FUNCTIONS CALLSr[zLISTS SUBSCRIPTS SLICINGS]rBTYPES)typeszRSTRINGS UNICODE NUMBERS SEQUENCES MAPPINGS FUNCTIONS CLASSES MODULES FILES inspect)stringsz4str UNICODE SEQUENCES STRINGMETHODS FORMATTING TYPES STRINGMETHODS)zstring-methodszSTRINGS FORMATTING FORMATTING) formatstringsryUNICODE)rz:encodings unicode SEQUENCES STRINGMETHODS FORMATTING TYPESNUMBERS)numberszINTEGER FLOAT COMPLEX TYPESINTEGER)integersz int rangeFLOAT)floatingz float mathr}) imaginaryz complex cmath SEQUENCES)typesseqz$STRINGMETHODS FORMATTING range LISTSMAPPINGS DICTIONARIESr)typesfunctionsz def TYPESMETHODS) typesmethodszclass def CLASSES TYPES CODEOBJECTS)zbltin-code-objectszcompile FUNCTIONS TYPES TYPEOBJECTS)zbltin-type-objectsz types TYPES FRAMEOBJECTS TRACEBACKSNONE)zbltin-null-objectrQ)zbltin-ellipsis-objectSLICINGSSPECIALATTRIBUTES) specialattrsrQr)rz!class SPECIALMETHODS PRIVATENAMESrT) typesmodulesrRPACKAGES EXPRESSIONS)zoperator-summaryzlambda or and not in is BOOLEAN COMPARISON BITWISE SHIFTING BINARY FORMATTING POWER UNARY ATTRIBUTES SUBSCRIPTS SLICINGS CALLS TUPLES LISTS DICTIONARIESry PRECEDENCEOBJECTS)objectsrSPECIALMETHODS) specialnameszbBASICMETHODS ATTRIBUTEMETHODS CALLABLEMETHODS SEQUENCEMETHODS MAPPINGMETHODS NUMBERMETHODS CLASSESrI) customizationzhash repr str SPECIALMETHODSATTRIBUTEMETHODS)zattribute-accesszATTRIBUTES SPECIALMETHODSCALLABLEMETHODS)zcallable-typeszCALLS SPECIALMETHODSrV)sequence-typesz(SEQUENCES SEQUENCEMETHODS SPECIALMETHODSMAPPINGMETHODS)rzMAPPINGS SPECIALMETHODS NUMBERMETHODS)z numeric-typesz*NUMBERS AUGMENTEDASSIGNMENT SPECIALMETHODS EXECUTION) execmodelz%NAMESPACES DYNAMICFEATURES EXCEPTIONS NAMESPACES)namingz3global nonlocal ASSIGNMENT DELETION DYNAMICFEATURESDYNAMICFEATURES)zdynamic-featuresrQSCOPINGFRAMESr_)rKztry except finally raise CONVERSIONS) conversionsrQ IDENTIFIERS) identifierszkeywords SPECIALIDENTIFIERSSPECIALIDENTIFIERS)z id-classesrQ)zatom-identifiersrQLITERALS)z atom-literalsz=STRINGS NUMBERS TUPLELITERALS LISTLITERALS DICTIONARYLITERALSTUPLES TUPLELITERALS) exprlistszTUPLES LITERALSLISTS)ztypesseq-mutable LISTLITERALSr)listszLISTS LITERALS) typesmappingDICTIONARYLITERALSr)r;zDICTIONARIES LITERALS ATTRIBUTES)zattribute-referencesz(getattr hasattr setattr ATTRIBUTEMETHODS SUBSCRIPTS) subscriptionsrVr)slicingsrVCALLS)callsr)powerrrz)unaryrBINARY)binaryrSHIFTING)shiftingrr|)bitwiser) comparisonszEXPRESSIONS BASICMETHODS)booleanszEXPRESSIONS TRUTHVALUE ASSERTION ASSIGNMENT) assignmentr{r{) augassignr)zassignment-expressionsrQDELETION RETURNING)compoundzfor while break continue)truthz if while and or not BASICMETHODS)debuggerpdb)zcontext-managersr=) IMPORTING CONDITIONALLOOPING TRUTHVALUE DEBUGGINGCONTEXTMANAGERSNcXlX lgr\_input_output)r@inputr&s rrHelper.__init__s   rcHUR=(d [R$r\)rrstdinrns rr Helper.inputs{{'cii'rcHUR=(d [R$r\)rrstdoutrns rr& Helper.outputs||)szz)rc[R"5SSS:XaU"5 gSURR<SURR<S3$)NrZr?rQrsrz instance>)r%stackr1r!r"rns r__repr__Helper.__repr__sO ==?1 a C ' F (&*^^%>%>%)^^%@%@B Brc&XRLaURU5 gUR 5 UR 5 URR S5 g![a(nURR US35 SnAgSnAff=f)NrYa 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. )_GoInteractiverr1r&r%introinteract)r@requestr,s r__call__Helper.__call__sw -- - . '" JJL MMO KK     . !!SE*-- .sA B(B  BcURRS5 URS5nUR 5nU(dM,[ U5S:a'USUSs=:XaS;aO OUSUSS;aUSSnUR5S;agUS :XaUR5 OURU5 M![[4a gf=f) NrYzhelp> r[rrrfrZ)qquitexitr) r&r%getlineKeyboardInterruptEOFErrorr\r]rrr)r@rs rrHelper.interacts $ ,,x0mmoGG q WQZ72;%L*%L '!B-7!!B-}}"77&   '"%&x0  sB==CCcUR[RLa [U5$URR U5 URR 5 URR 5$)z.Read one line, using input() when appropriate.)rrrr&r%flushr)r@prompts rrHelper.getlinesQ :: "= KK  f % KK   ::&&( (rc[U[5(Ga^UR5nUS:XaUR5 GOiUS:XaUR 5 GOQUS:XaUR 5 GO9US:XaUR 5 GO!USSS:Xa#UR UR5S5 OXR;aURU5 OUS;a [[U5S URUS 9 OXR;aURU5 OXR;aURU5 OlU(a[US URUS 9 ON[[S URUS 9 O3[U[ 5(aU"5 O[US URUS 9 UR"R%S 5 g) Nkeywordssymbolstopicsrzmodules rZ)r9r7r8z Help on %s:)r&r'rY)r4rJr\ listkeywords listsymbols listtopics listmodulesr#r showsymbolrCevalrr  showtopicrr6r&r%)r@rr's rr Helper.help sE gs # #mmoG*$d&7&7&9I%t'7'7'9H$doo&7I%t'7'7'9! *  !34LL($//'*B55DM=fUMM)4>>'+BKK')@#g}T\\RXYc=fM  ( ($&'=fM $rcURRSRS[RSS-55 g)NaWelcome to Python {0}'s help utility! If this is your first time using Python, you should definitely check out the tutorial 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 get a list of available modules, keywords, symbols, or topics, enter "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", enter "modules spam". To quit this help utility and return to the interpreter, enter "q", "quit" or "exit". z%d.%dr[)r&r%rhrr]rns rr Helper.intro s7   F7S%%bq) )*! ,rc [U5nX2-n[U5U-S- U-n[U5Hn[U5HtnXu-U-nU[U5:dMURR X5 XrS- :dMBURR SSUS- [X5- --5 Mv URR S5 M g)NrZrBrY)rr]rr&r%) r@itemscolumnsrcolwrrowrrs rr Helper.list3su E W$q(W4;CW~J$s5z>KK%%eh/q[( ))#tax#eh-7O0P*PQ & KK  d #rcURRS5 URURR 55 g)NzN Here is a list of the Python keywords. Enter any keyword to get more help. )r&r%rr rrns rrHelper.listkeywords@s4   $--$$&'rcURRS5 URURR 55 g)Nzx Here is a list of the punctuation symbols which Python assigns special meaning to. Enter any symbol to get more help. )r&r%rrrrns rrHelper.listsymbolsGs4   $,,##%&rcURRS5 URURR 5SS9 g)NzN Here is a list of available topics. Enter any topic name to get more help. r)r)r&r%rrrrns rrHelper.listtopicsOs8   $++""$a 0rcSSKnURR XR R U55nU(d(URRS[U5-5 g[U[5(aURXB5$UupVURRUnUR5S-nU(aU=(d SS-U-nU(aRSSK nSSRUR55-S-n UR!U S 5n US SRU 5-- nUR"c[%US U<35 gURRU5 g![a URRS5 gf=f![a* URRS[U5-5 gf=f) Nrt Sorry, topic and keyword documentation is not available because the module "pydoc_data.topics" could not be found. zno documentation found for %s rYrQrBRelated help topics: rHz %s r")pydoc_data.topicsr1r&r%rr r rCr4rJrKeyErrorr\textwrapr^r#wraprr) r@topic more_xrefsrVtargetlabelxrefsrCr-r~ wrapped_texts rrHelper.showtopicVs  $ (9(9%(@A KK  ?$u+M N  fc " ">>&5 5  ##**51CiikD  [bC'*4E  *TYYu{{}-EELD#==r2L 8dii 55 5C <<  #%+ , KK  c "?  KK         KK  ?$u+M N  s#E+F+%FF1G  G ctSSKnURRXRRU55nU(d [ S5e[ U[5(aURXB5$UupVURRUnU(aU=(d SS-U-nXv4$![a gf=f)aReturn unbuffered tuple of (topic, xrefs). If an error occurs here, the exception is caught and displayed by the url handler. This function duplicates the showtopic method but returns its result directly so it can be formatted for display in an html page. rN)r(rQzcould not find topicrQrB) r+r1rr r rir4rJ _gettopic)r@r/r0rVr1r2r3rCs rr7Helper._gettopiczs $  (9(9%(@A34 4 fc " ">>&5 5 &&u- [bC'*4Ez   sB** B76B7clURUnURS5up4nURX55 g)NrB)r partitionr)r@symbolr1r/rr3s rrHelper.showsymbols0f% **3/% u$rcv^U(a6URRSRU55 [U5 gURRS5 0nU4SjmU4Sjn[ 5R TUS9 UR UR55 URRS5 g)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... chU(aUSSS:XaUSSS-nURS5S:aSX1'gg)N .__init__rrrrZ)find)rrqrrs rcallback$Helper.listmodules..callbacks@wrs|{:%crl\9G<<$q('(G$)rc>T"SUS5 gr\r!)rqrBs ronerror#Helper.listmodules..onerrorsw-rrEz 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&r%rhapropos ModuleScannerrunrr)r@rrrErBs @rrHelper.listmoduless  KK   F3K   CL KK   G6= )  . O  '  : IIglln % KK   rrr)F)rrcr)#r/r!r"rr  _strprefixes_symbols_inverserrr/symbols_r;r rrr5rr&rrGrrrrrrrrrrrr7rrr)rprs000rr6r6s&&& & y & f & . & & & '& & 4& -& & && & %!&" %#&$ 5%&& .'&( )&* 3+&, (-&. '/&0 '1&2 l3&4 )5&6 7&8 59&: y;&< i=&>  ?&@ (A&B )C&D $E&F;<K&HR$8L#7aAEE#7LL%e;l;N?!B4  # g % /  z  *  [ i % ^ + \ % % ( (!G$,113xF[[/FF"#-$GFO 4 xV=V (V A V 4 V (V =V ,V +V 1V IV NV 4V >!V" H#V$ <%V& 'V( g)V* )+V, 9-V. 1/V0 A1V2 -3V4 H5V6 .7V> ]?V@ mAVB 'CVD 4EVJ IKVL MMVN EOVP /QVT GUVV ,WVZ K[V\ W]V^ 3_V` {V| ?}V~ ZV@ :AVB 3CVD )EVF )GVH )IVJ +KVL /MVN -OVP AQVR 9SVT XUVV ;WVX =YVZ !?[V\ E]V^ X_V`;C(7kVFp((**BXN- #,) *,& $('1"#H6% a Ms=Ir6c"\rSrSrSrSSjrSrg)rIiz7An interruptible scanner that searches module synopses.Nc U(aUR5nSUl0n[RHnUS:wdM SXV'Uc U"SUS5 M[ U5R =(d SnUR S5SnUS-U-nUR5RU5S:dM}U"SXh5 M [R"US9GHMupn UR(a GO7Uc U"SUS5 M*U RU5n U Rn [U S 5(a`U RU5n [!["R$"U 55=(d Sn[U S 5(aU R'U5nO`SnO][(R*R-U 5nUR (aUR R15SOSn[3US S5nUS-U-nUR5RU5S:dGMDU"XU5 GMP U(aU"5 gg![a GMpf=f![a U(aU"U5 GMf=f![.a U(aU"U5 GMf=f) NF__main__rZrQrYrrrG get_source get_filenamer)rrrr/ __import__rFr#rArr1 find_specrrrrSr8rioStringIOrTrr r r1r r$)r@rBr completerrEseenrqr)rrr rrsourcerrs rrJModuleScanner.runs8 ciik //G*$ ! ;T7B/%g.66<"D::d+A.D"U?T1Dzz|((-2 w50)0(=(=g(N $Huyy{w+#--g6D6<00!!'!2!27!; +2;;v+>?E2Dv~66%227;#!!*!5!5!;!;D!A >D^^6>>446q9QSD"6*T:D-::<$$S)Q.TD1I)OL  K ;#%!"#G, !'!"#G, !s6:H1)I I$1 I?II! I!$JJ)rr)r/r!r"rrFrJrr!rrrIrIs A8rrIcSnSn[R"5 [R"S5 [5R XUS9 SSS5 g!,(df  g=f)zAPrint all the one-line module summaries that contain a substring.cTUSSS:XaUSSS-n[X=(a SU-5 gNr?r@rz- )r#)rrqrs rrBapropos..callbacks1 23<; &crl\1G g+t ,rcgr\r!rqs rrEapropos..onerrors rrrGN)rrfilterwarningsrIrJ)rrBrEs rrHrHsG-  ")H7; # " "s /A A"c^^^^^ ^ SSKmSSKmSSKm SSKm "SSTRR 5m"U 4SjSTRR 5m"UUUUU 4SjST R5nU"XU5nUR5 UR(doUR(aUR(dM[R"S 5 UR(d&UR(dM:UR(dMMU$) aStart an HTTP server thread on a specific port. Start an HTML/text server thread, so HTML or text documents can be browsed dynamically and interactively with a web browser. Example use: >>> import time >>> import pydoc Define a URL handler. To determine what the client is asking for, check the URL and content_type. Then get or generate some text or HTML code and return it. >>> def my_url_handler(url, content_type): ... text = 'the URL sent was: (%s, %s)' % (url, content_type) ... return text Start server thread on port 0. If you use port 0, the server will pick a random port number. You can then use serverthread.port to get the port number. >>> port = 0 >>> serverthread = pydoc._start_server(my_url_handler, port) Check that the server is really started. If it is, open browser and get first page. Use serverthread.url as the starting page. >>> if serverthread.serving: ... import webbrowser The next two lines are commented out so a browser doesn't open if doctest is run on this module. #... webbrowser.open(serverthread.url) #True Let the server do its thing. We just need to monitor its status. Use time.sleep so the loop doesn't hog the CPU. >>> starttime = time.monotonic() >>> timeout = 1 #seconds This is a short timeout for testing purposes. >>> while serverthread.serving: ... time.sleep(.01) ... if serverthread.serving and time.monotonic() - starttime > timeout: ... serverthread.stop() ... break Print any errors that may have occurred. >>> print(serverthread.error) None rNc \rSrSrSrSrSrg)!_start_server..DocHandleri@ cBURRS5(aSnOSnURS5 URSSU-5 UR 5 UR R URURU5RS55 g) z~Process a request from an HTML browser. The URL received is in self.path. Get an HTML page from self.urlhandler and send it. z.csstext/css text/htmlz Content-Typez%s; charset=UTF-8r+N) rr send_response send_header end_headerswfiler% urlhandlerencode)r@ content_types rdo_GET(_start_server..DocHandler.do_GETB s yy!!&))) *   s #   ^-@<-O P     JJ  T__ <))/ :rcgr\r!)r@r>s r log_message-_start_server..DocHandler.log_messageR s rr!N)r/r!r"rrsrvrr!rr DocHandlerrg@ s  :  rrxc.>\rSrSrSrU4SjrSrSrg) _start_server..DocServeriV cXlURU4UlX0lURR XRUR 5 SUlgNF)hostaddressrBrBrhandlerr)r@r}portrBs rr)_start_server..DocServer.__init__X s?I IIt,DL$M II  t\\4<< @DIrc>UR(dZTRURR5///S5upnU(aUR 5 UR(dMZUR 5 gr)rselectsocketfilenohandle_request server_close)r@rdwrexrs rserve_until_quit1_start_server..DocServer.serve_until_quit_ sZii#]]DKK,>,>,@+A2r1M '')iii    rcURRU5 UR(aURU5 ggr\)rBserver_activaterBrns rr0_start_server..DocServer.server_activatef s, II % %d +}} d#r)r~rBr}rN)r/r!r"rrrrr)rsr DocServerrzV s   $rrc@>\rSrSrU4SjrUUUU4SjrSrSrSrg)#_start_server..ServerThreadik c>XlX l[U5UlTRR U5 SUlSUlSUlgr|) rpr}rrThreadrservingerror docserver)r@rpr}r threadings rr,_start_server..ServerThread.__init__m sA(OID DI    % %d + DLDJ!DNrcl>TRRTlTTlTRR Tl[UR5TlT"URURUR5nXl UR5 g![anX lSnAgSnAff=f)zStart the server.N)server HTTPServerrBrrDMessage MessageClass staticmethodrpr}rreadyrrr8r)r@docsvrr,rxremailhttps rrJ'_start_server..ServerThread.runv s !!%!7!7 $. !*/--*?*? '(4T__(E %"499diiD!''') !  !sBB B3#B..B3cSUlURUlURUlSURUR4-Ulg)NTz http://%s:%d/)rr} server_portrr)r@rs rr)_start_server..ServerThread.ready s:DL DI**DI&$))TYY)??DHrcpSURlUR5 SUlSUlSUlg)z&Stop the server and this thread nicelyTNF)rrr^rrrns rstop(_start_server..ServerThread.stop s."&DNN  IIK"DN DLDHr)rrr}rrrrpN) r/r!r"rrrJrrr)rxrrrrsr ServerThreadrk s " ! ! @  rrg{Gz?) http.server email.messagerrrBaseHTTPRequestHandlerrrrrrrtimesleep) rphostnamerrthreadrxrrrrrs @@@@@@r _start_serverr spT[[77,$DKK**$*&&y''&P* 5F LLNllFNNv7G7G 3llFNNNv7G7G7G Mrc^^^ ^ ^ ^ ^ ^^"U 4SjS[5nU"5mU4Sjm U4Sjm U4Sjm U4SjmU4Sjm U4SjmU4S jm U4S jmUUU U U U UU4S jnURS 5(aUS SnUS:Xa[RR [RR [ 55n[RRX@5n[U5nSRUR55sSSS5 $US:XaU"U5$[SU<SU<35e!,(df  N!=f)zThe pydoc 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. c">\rSrSrU4SjrSrg)_url_handler.._HTMLDoci c B>SnSU-nSU<SU<ST"5<SU<S3 $)rzpydoc_data/_pydoc.cssz1zH Pydoc: z z z*
z
r!)r@rrcss_pathcss_link html_navbars rr#_url_handler.._HTMLDoc.page s/.HC HkmX? ?rr!N)r/r!r"rrr)rsr_HTMLDocr s  ? ?rrc >TR[R"5<S[R"5S<S[R"5<S35nSU<STR[R"SS95<S 3$) Nz [rrrz=
Python 
T)tersea
)rvplatformpython_version python_buildpython_compiler)rr.s rr!_url_handler..html_navbar sg++x/F/F/H/7/D/D/Fq/I/7/G/G/IKL0DKK(9(9(EF+H Hrc>SnTRS5n[RVs/sH nUS:wdM UPM nnTRX05nUSTR SSU5-/n0n[R H#nUR TRXe55 M% UR S5 SS RU54$s snf) zModule Index page.cSU<SU<S3$Nrrrr!r)s r bltinlink3_url_handler..html_index..bltinlink 15t< Index of ModulesrRz

zBuilt-in Modulesrzf

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

zIndex of ModulesrQ) rrr/rrrrrr^)rrr)namesrrZrr.s r html_index _url_handler..html_index s =,, = #&":":(":$J&":(##E5UT__ &33488C OODJJs1 2  ' ("2778#444(s CCc>^ /m U 4Sjn[R"5 [R"S5 Sn[5R XUS9 SSS5 Sn/nT R S5nT HupgUR U"U5U-5 M! UT RSU-S S RU55-nS U4$!,(df  Nu=f) zSearch results page.cd>USSS:XaUSSS-nTRX=(a SU-45 gr_r)rrqr search_results rrB3_url_handler..html_search..callback s;rs|{*!#2,5  '+?D4K!@ Arrcgr\r!rbs rrE2_url_handler..html_search..onerror srrGNcSU<SU<S3$rr!rs rr4_url_handler..html_search..bltinlink rrz-Search Resultszkey = %srrzSearch Results) rrrdrIrJrrrr^) rrBrErrrr)rrrr.s @r html_search!_url_handler..html_search s  B  $ $ &  # #H -  O  w  ? ' =,, ; (JD NN9T?T1 2(T__  gv{{7';==))%' &s 2C Cc>SnTRS5n[[RR 55nTR X 5nUTR SSU5-nSU4$)zIndex of topic texts available.cSU<SU<S3$NzINDEXTopicsr)rrr6rrrr)rrrrr.s r html_topics!_url_handler..html_topics sl B,, 2 v}}))+,##E5T__ gx))!!rc>TRS5n[[RR 55nSnTR X5nUTR SSU5-nSU4$)zIndex of keywords.rcSU<SU<S3$rr!rs rr6_url_handler..html_keywords..bltinlink! rrKeywordsr)rrr6r rrr)rrrrr.s r html_keywords#_url_handler..html_keywords sl,, 2 v++-. B##E5T__ ++8##rc>[R"5n[X5nURU5up4XR;aSnOSnTR SU-5nSTR U5-nTRUSU5nU(a@[UR55nSnTRXG5nTRSSU5nU<SU<3S RXcU454$) zTopic or keyword help page.KEYWORDTOPICrz 
%s
rcSU<SU<S3$rr!rs rr7_url_handler..html_topicpage..bltinlink: s :>EErr)rBrQ) rWrXr6r7r rrrrr#rrr^) r/bufhtmlhelprr3rrrr.s rhtml_topicpage$_url_handler..html_topicpage) skkm##",,U3 %% %EE,, /% 7 #T[[%::??57H= 5;;=)E F$$U6ELL!8'5IE %(E235 5rc~>[USS9nUcUS:wa [S5e[U5nTRX5nX#4$)NrZ)r2r8zcould not find object)rrirr?)rr?rcontentr.s r html_getobj!_url_handler..html_getobjB sESA& ;3&=45 5 --)~rc>TRS5nSRU4Sj[[U5U555nUTR USU5-nSU-U4$)Nz$Errorrc3F># UHnTRU5v M g7fr\)rv)rrr.s rr3_url_handler..html_error..N s%FD6:t{{400Ds!rz Error - %s)rr^rrIr)rrrrr.s r html_error _url_handler..html_errorJ sf,, 2 ;;F4T#YDFFT__S'8DDc!8++rcV>UnURS5(aUSSnUS;a T "5up#OUS:Xa T"5up#OUS:Xa T "5up#OuSU;adURS5upEnUS:Xa T "U5up#OJUS :Xa T "U5up#O8US :XaUS;a T "5up#O"T "U5up#O[S 5eT "U5up#TR X#5$![a T "U5up#N'f=f![a T "U5up#NAf=f![anT"X5up#SnAN^SnAff=f) zGenerate an HTML page for url.rN)rQrrr rwz search?keyz topic?keyzget?keyz bad pydoc url)rr:rir8r)r complete_urlrroprrr.rrrrrrrs r get_html_page#_url_handler..get_html_pageS sc << cr(C ;m#!+w!,w "!.w ]]3/ s%%0%5NE7;&:)7)<w9_m+)3wA-8-=NE7%_55!,S!1wyy((%&:)4S)9w: *A-;C-@NE7A  ;' :NE7 ;svD D D *D ;D  C D $ C0/D C-*D ,C--D 0DD DD D( D##D(rSrZNrirQrjzunknown content type z for url ) rrrrdirnamerealpathrr^r readlinesrM)rrrrr path_hererfpr.rrrrrrrrs @@@@@@@@@r _url_handlerr s?7?$ :DH650*<" $52,&)&)P ~~c!"gz!GGOOBGG$4$4X$>? 77<< / (^r772<<>*^  $S!! L#N OO ^s +D55 ET localhost) open_browserrcSSKn[[X 5nUR(a[ UR5 gUR (aSnU(aUR UR5 [ SUR5 [ U5 UR (ab[S5nUR5nUS:XaO@US:XaUR UR5 O [ U5 UR (aMbUR (aUR5 [ S5 ggg![[4a [ 5 NKf=f!UR (aUR5 [ S5 ff=f) zStart the enhanced pydoc web server and open a web browser. Use port '0' to start the server on an arbitrary port. Set open_browser to False to suppress opening a browser. rNz"Server commands: [b]rowser, [q]uitzServer ready atzserver> rrczServer stopped) webbrowserrrrr#rrrrrrrr)rrrr  serverthreadserver_help_msgcmds rbrowser  s0  x>L l  !>  OOL,, - ( #\%5%5 6 / "&&J'iik#:CZOOL$4$45/*&&&##!!#&'$' "8,  G ##!!#&'$s12AD5E>D55EEEE/Fct[U[5=(a" UR[R5S:$r)r4rJrArsep)rs rispathr s% a  5!&&.A"55rcSU;d-[RU;d[R"5U;ag[RR [ 5n[RR U5nUR 5nX0;a5[RRX25(dURU5 URS[R"55 U$)zEnsures current directory is on returned path, and argv0 directory is not Exception: argv0 dir is left alone if it's also pydoc's directory. Returns a new path entry list, or None if no adjustment is needed. rQNr) rcurdirgetcwdrrrcopysamefileremoveinsert) given_pathargv0 stdlib_dir script_dir revised_paths r_get_revised_pathr s Z299 2biikZ6O*J'J??$L(8(8(P(PJ'299;' rc[[R[RS5nUbU[RSS&gg)zEnsures current directory is on sys.path, and __main__ directory is not. Exception: __main__ dir is left alone if it's also pydoc's directory. rN)rrrargv)rs r_adjust_cli_sys_pathr  s4 %SXXsxx{;L"  rcSSKn"SS[5n[5 UR[RSSS5up#SnSnSnSnSnUH@upU S :XaS nS nU S :Xa [ U 5 gU S :XaS nU nU S :XaS nU S:XdM<S nU nMB U(a [ XxUS9 gU(dUeUGHn [U 5(aH[RRU 5(d$[SU -5 [R"S5 [U 5(a/[RRU 5(a [U 5n U(aN[U 5(a1[RRU 5(a [!U 5 M[#U 5 M[$R%U S S9 GM g![&[(4a-n [U 5 [R"S5 Sn A GMCSn A ff=f!UR*U4az [RR-[RR/[RS55Sn [SR1U [R2S95 gf=f)z@Command-line interface (looks at sys.argv to decide what to do).rNc\rSrSrSrg)cli..BadUsagei r!N)r/r!r"rrr!rrBadUsager# strr$rZzbk:n:p:wFrz-bTz-kz-pz-wz-n)rrzfile %r does not exist)r'apydoc - 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. )r r)getoptr8r rrrHr rrrexistsr#rrr-rr4r/rr1rrr'r&rhr)r%r$optsr>writing start_serverrrroptvalargrr s rclir- s#9#M!]]388AB<<   HCd{# # d{ d{# d{d{#   4 F 8^Cc{{277>>##6#6.45  #;;277>>##6#6$S/Cc{{rww}}S'9'9!#  IIc$I/ !23 e    LL( #!ggrww// <=a@ : FsF; !!siAG<2G< G<&A'G<BF<G< F< G<"F<6G<<G9 !G4-G<4G99G<r?si%L ( )   $   +CC      0d ! A  * %G jj5r}}E ( "J889(2  2 %NK K&+$ !(X@@H(t(TN 7cN 7d:t:@OcOb G  6*y O y >KLC6DE!2# ``D x;;z <VriPX (4+ (J68#T!l zEr