F\hSrS/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)Ra^Generate 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 /usr/share/doc/pythonX.Y/html/library if the pythonX.Y-doc package is installed or 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 /usr/lib/python3.13/pydoc.pypathdirsrcs{ DHxxggoocjS)''""3'  "rww}}S'9'9 KK  OOG $  Kc[RRUR5nUcgURR S5SSHn[ X5nM [R"U5(dgU$)Nr) rmodulesget __module__ __qualname__splitgetattrinspectisclass)funcclsnames r _findclassr*osc ++//$// *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_finddocrDys||$$|| 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 rcramrs` 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_listr3s@ 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 visiblenamerFs <<  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..usKOODGQ7aArrN)r$ enumerater]rMsort)attrsrGfieldsir)keyfuncrs @rsort_attributesrlspVY +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 ispackagerzsb 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|'<'<>  rstdlibc[R"U5n[RR SUR 5n[RRU5n[U[[55(Ga-URS;dURU5(GaUR[RRUS55(dUR[RRUS55(dURS;aURS5(a;SRURS 5URR!55nU$[RRXARR!5S -5nU$S nU$![a SnGNf=f) z*Return the location of module docs or None (built-in)r7) errno exceptionsgcmarshalposixsignalr_thread zipimportz dist-packagesz site-packages)z xml.etreeztest.test_pydoc.pydoc_mod)zhttp://zhttps://z {}/{}.html/.htmlN)r% getabsfilerMrenvironr r7rrr4rIr/rr^rhrUlower)r@rGbasedirrdoclocs r getdocloc Doc.getdocloc3sQ %%f-D doo>''""7+ vtBx ( ( __!99oog&&//"'',,w"HII//"'',,w"HII OO#M M  !899%,,V]]3-?AVAVAXY  foo.C.C.E.OP F ) D sF11 GGr!N)r/r!r"rrrUr r version_infor7r?rEr9r:r;r= docpropertyr< sysconfigget_pathrYrr!rrr6r6sm G"%"2"22A"6!78J$ ! LPOIOO:OO;(1(:(:8(Drr6cD\rSrSrSrSrSrSrSrSr \ r Sr \ r S r g ) HTMLRepriPzBClass for safely making an HTML representation of a Python object.cv[R"U5 S=UlUlSUlS=UlUlgN drrmaxlistmaxtuplemaxdict maxstringmaxotherr@s rrHTMLRepr.__init__R1 d')) t} ),,rc $[USSSSSS5$)N&z&z>)rr@r~s rescapeHTMLRepr.escapeXstS'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$rurrrCrlr@rlevel methodnames rrepr1HTMLRepr.repr1^sw 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)rrkrCrrurSrTr@rr~testtestreprs r repr_stringHTMLRepr.repr_stringes{A~~&: 4)rurrrCrkr1r/r@rr~s r repr_instanceHTMLRepr.repr_instancersQ G;;tGDG$4dnnEF F G;;1E1EEF Fs 69*A%rjrhrlrkriN)r/r!r"rrFrrurCrrrepr_strr repr_unicoderr!rrraraPs4L- E'B -HG Lrrac(\rSrSrSr\"5r\Rr\RrSr SSjr SSjr Sr Sr S rS rS rS rS rSrSrSrS0004SjrSSjrSSjrSS004SjrSrSS000SS4SjrSSjr\rSSjrSSjrSr g) HTMLDocizz'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
)ru expandtabsrrts 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!rts 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/rxs 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.rrSrz"%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) rurScompilesearchspanrgroupsrintrr^)r@r~rufuncsclassesrrherepatternrjstartrkrschemerfcpepselfdotr)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$[R6"U5=(d UULdM-[9UXQ5(dM@UR UU45 SU-UU'[RH"U5(dMxUUUU'M /n[R0"U[J5H,unn[9UXQ5(dMUR UU45 M. TRM[OU5TRPUU5nU=(a SU-nUSU--n[US5(a/n[RRT"URV5Hunnn UR UUU S45 M URY5 TR[UTR\5n!UTR_SSU!5-nO3U(a,TR[UU4Sj5n!UTR_SSU!5-nU(aUVVs/sHunnUPM n"nnTRa[Rb"U"S5U5/n!UH*unnU!R TReUUUUU55 M, UTR_S S!S"RU!55-nU(aW/n!UH*unnU!R TReUUUUU55 M, UTR_S#S$S"RU!55-nU(aT/n!UH'unnU!R TReUU55 M) UTR_S%S&S'RU!55-n[US(5(aETRM[!URf5TRP5n!UTR_S)S*U!5-n[US+5(aETRM[!URh5TRP5n!UTR_S,S-U!5-nU$![a SnGN8f=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)5r/__all__r>r#rr]rr^r%rTurllibparsequoterrMrrJrr\rurrYlocalsrrrwr& getmodulerrr!rrr r$rxr2r|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%%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 $L\rSrSrSrU4SjrSrg)(HTMLDoc.docclass..HorizontalRuleicSUlgrneedonerms 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# ! ! !rr1r[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< r7rrr8r)rr9rr: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
r3rY)rr,r=r$rWrr)r7rrr8r)rr9rrBrCrrr: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 rrrN$ AaDH$4rzClass methods %scUSS:H$NrZz class methodr!rTs rrrN& AaDN$:rzStatic methods %scUSS:H$NrZrr!rTs rrrN( AaDO$;rzReadonly properties %scUSS:H$NrZrr!rTs rrrN*qt7J/JrzData descriptors %scUSS:H$NrZrr!rTs rrrN,qt7H/HrzData and other attributes %scUSS:H$NrZrr!rTs rrrN. !rrQ class zz = class r(%s)r()rz&%s
 rr)r/rrrr%getmror]r,rr!rrr$r6rMpopleftrbuiltinsrGrr^rnrurWrrr)"r@rGr)rrrrrealnamerrr1mrorBr<rArFrr(rrrr9anchor inheritedtagrrdeclrlrCr:r;r+rMs"`` ``` @@@@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.=)rrCrxs r formatvalueHTMLDoc.formatvalueMsyytyy0011rc 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.NrQrIFr, class method of %s method of %s instance unbound %s method from r from %sasync rez ">rfz %sz
%s
z%
%s
rEzr3)r/rr0r$r%r&rr1r7ismethodwrapperr9r>r2r!r"riscoroutinefunctionisasyncgenfunctiongetattr_staticrrxrn__annotations__rurrrWr)r@rGr)rrrrrr9rlrnnoteskipdocsimfuncimselfobjclasspnameasyncqualifierrreallinkrlrqrCs rr;HTMLDoc.docroutineQs ??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
r3rQ)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)rrs rr HTMLDoc.indexs  X%,%9%93%%@ !HE@4@@@ NND"eX-=> ?HN &A  ##G__=sGX66rr!rQ)rQNrr[rNNN)!r/r!r"rrFra_repr_instancerCrurrrrrrrrrrrrrrrr9r:rvr;r<r]r=rrr!rrrrzs1ZN   D  " "F &&3419U** < 5G*/&O 38#'b"b% R*&sj%)d"b[>z2'+RdR.s5"Dy2~s)r^rts 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.. sDeyG44esrgrrY )r4rrrr^rr) r@rrqrrrVrrrrs ` rrTextDoc.formattreesE%'' 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[ R5HQupUc$[ R"U 5=(d UULdM,[XU5(dM?U RX45 MS /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 RR/US -5(dM*U U;dM2URU 5 ME U(a3UR)5 XpRS S R+U55-nU (aU V V s/sHupU PM nn n UR1[ R2"US5U5/nU H&upURUR5XU55 M( XpRSS R+U55-nU (aQ/nU H&upURUR5XU55 M( XpRSS R+U55-nU(aP/nUH%upURUR7XUSS95 M' XpRSS R+U55-n[US5(aN[9UR:5nUSSS:XaUSSS:XaUSSR=5nXpRSU5-n[US5(a'XpRSR>55-n[US5(a'XpRS[9UR@55-n[US5(a'XpRS[9URB55-n[ RD"U5nXpRS!U5-nU$s sn n f![Fa 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$rYr%rr&rrrrxr|setrrrraddrr^rwrrrr?r=rJrr\rrrrTrM)r@rGr)rrsynopdescrVrrXrrrrrr modpkgs_namesrrqr submodulesrrrrs rr9TextDoc.docmodulesvf~. fd.E &FGfi.'  ll+=vI@F ll=$??F!,,VW__EJC%%e,66As00NNC<0 F !,,VW5F5FGJC%%e,66As00LL#. H !,,VV>F 6: & &ll63v3GHHF 6< ( (ll8S9J9J5KLLF 6= ) )ll9c&:L:L6MNNF %%f-D,,vt44 G:@ D sV2V88 WWc ^^^^^^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 rgrrhrYr[zMethod resolution order:rrQc3# UHNnURRS5(aM%URS:XdM7[UR5v MP g7f)rrkN)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%rms rr1TextDoc.docclass..HorizontalRule.__init__r(rcF>UR(aT"S5 SUlg)NzF----------------------------------------------------------------------rZr%r*s rr,.TextDoc.docclass..HorizontalRule.mayber.rr%Nr/r0srr1rr2rr1c >[X5up1U(aLTR5 T "U5 UH.upEpg[T U5nT "T RUUT T U55 M0 U$![a T "T R XtT 55 MYf=fr[r5) r7rrr8r)rr9rr: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[r?r@s rrA*TextDoc.docclass..spilldescriptorsrCrc >[X5up1U(aWT R5 T "U5 UH9upEpg[U5n[T U5n T "TR XT SUS9S-5 M; U$![a UR Un N__dict__r=)r7rrr8r)rr9rrCr?r:rrGr+r@s rrF#TextDoc.docclass..spilldatas#E5IB S 24.D -C5%fd3s#bcJ 35L *5%..t45s A//B  B rHrc>USTL$rKr!rLs rr"TextDoc.docclass..rOrrPrQz Methods %s: cUSS:H$rSr!rTs rrrrUrzClass methods %s: cUSS:H$rWr!rTs rrrrXrzStatic methods %s: cUSS:H$rZr!rTs rrrr[rzReadonly properties %s: cUSS:H$r]r!rTs rrrr^rzData descriptors %s: cUSS:H$r`r!rTs rrrrarzData and other attributes %s: cUSS:H$rcr!rTs rrrrdrz | )r/rr!rmapr^rrnrWrr%rir]sortedrI__subclasses__rJrVrrrjrrkrGrrrrrU) r@rGr)rrrlrrrrrrlrCrmrB subclassesno_of_subclassesMAX_SUBCLASSES_TO_DISPLAY subclassnamer1r<rArFrr(rrrorpr:r+rMs `` ` @@@rr:TextDoc.docclassys??x   ++ #  tyy22EIIdOk1Hr2r!r"rurrrrrrxrnrrWrrU)r@rGr)rrr9rlrrrrrrrrrlrqrCs 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.docdata\sb~~  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.docotherlsyy  )TE\/R47DCI%DaxUd e 304506B$>.C  D4;;s3x0047 7D rr!)r)NrQr)NNNNr)r/r!r"rrFrrrCrrrrr9r:rvr;r<r]r=rr!rrrrsj1ZN   D6 A cJSLj'HLT  K $  rrc\rSrSrSrSrSrg) _PlainTextDoci{z2Subclass of TextDoc which overrides string stylingcU$r[r!rts rr_PlainTextDoc.bold}s rr!N)r/r!r"rrFrrr!rrrr{s <rrc.[5q[X5 g)zCThe first time this is called, determine what kind of pager to use.N)rpager)r~rs rr r s 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^rkr$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_docrs 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/r rr1print 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,)rpkgpathdonerrqrs r writedocsr1s5 |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&_SS'_S$S(_S)S*_S+S,_S-S._S/S0_S1S_S2S_S3S4_S5S6_S7S8_SS9_S:S;_S S<_ES=S>0ErS?VVVs/sHnS@Ho!U-PM M snnnrSASBSCSD/\Q7SESFSGSHSISJSK.r0SLSM_SNSO_SPSQ_SRSS_STSU_SVSW_SXSY_SZS[_S\S]_S^S__S`Sa_SbSc_SdSe_SfSe_SgSh_SiSh_r\R5H4ur r \ H(r \R\ \ 5r \ \ ;a\ Sj-\ -r \ \\ 'M* M6 C C C C 0SkSl_S[Sm_SnSo_SpSq_SrSs_StSu_SvSw_SxSy_SzS{_S|S}_S~S_SS_SS_SS_SS_SSk_SSk_0SS_SUS_SS_SS_SS_SS$_SS_SS_SS_SS_SS_SS_SS_SS_SS_SS_SS_E0SS_SS_SS_SS_SS_SS_SS_SS_SS_S_S_SS_SS|_SS_SS_SS_SS_SS_E0SS_SS_SS_SS_SOS_SS_SS_SS_SS_S,S_SS_SS _SS_SS_S]S_SS_SS7_ES$SSSSSS.Er SSjr\S5r\S5rSr\"5r\4SjrSrSrSSjrSrSSjrSrSrSrSSjrSSjrSr SSjr!Sr"gs snnnf)Helperi FalserQNoneTrueandBOOLEANaswithassert)r;rQasync)r<rQawait)r=rQbreak)r> while forclass)r@zCLASSES SPECIALMETHODScontinue)rAr?def)functionrQdel)rD BASICMETHODSelififelse)rHr?excepttryfinallyfor)rLzbreak continue whilefromimportglobal)rOznonlocal NAMESPACES)rG TRUTHVALUE)rNMODULESin)rRSEQUENCEMETHODSis COMPARISONlambda)rVrnonlocal)rWzglobal NAMESPACESnotorpass)rZrQraise)r[ EXCEPTIONSreturn)r]r)rJr\while)r^zbreak continue if TRUTHVALUE)r:z CONTEXTMANAGERS EXCEPTIONS yieldyield)r_rQ)bfru'rrdz'''rz""")+rI***rRz//%<<>>rq|^~rrrs<=>===!=<>)rrrsrnrorprqrr)rIrm) z+=z-=z*=z/=z%=z&=z|=z^=z<<=z>>=z**=z//=)rirjrqrkrlrm)jJ)STRINGS OPERATORSrUUNARYAUGMENTEDASSIGNMENTBITWISECOMPLEXrhzOPERATORS FORMATTINGrgPOWER,zTUPLES LISTS FUNCTIONSrz ATTRIBUTES FLOAT MODULES OBJECTSrELLIPSIS:zSLICINGS DICTIONARYLITERALS@z def classrruz:=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) formatstringsrvUNICODE)rz:encodings unicode SEQUENCES STRINGMETHODS FORMATTING TYPESNUMBERS)numberszINTEGER FLOAT COMPLEX TYPESINTEGER)integersz int rangeFLOAT)floatingz float mathrz) 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 PRIVATENAMESrQ) typesmodulesrNPACKAGES EXPRESSIONS)zoperator-summaryzlambda or and not in is BOOLEAN COMPARISON BITWISE SHIFTING BINARY FORMATTING POWER UNARY ATTRIBUTES SUBSCRIPTS SLICINGS CALLS TUPLES LISTS DICTIONARIESrv PRECEDENCEOBJECTS)objectsrSPECIALMETHODS) specialnameszbBASICMETHODS ATTRIBUTEMETHODS CALLABLEMETHODS SEQUENCEMETHODS MAPPINGMETHODS NUMBERMETHODS CLASSESrE) customizationzhash repr str SPECIALMETHODSATTRIBUTEMETHODS)zattribute-accesszATTRIBUTES SPECIALMETHODSCALLABLEMETHODS)zcallable-typeszCALLS SPECIALMETHODSrS)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) subscriptionsrSr)slicingsrSCALLS)callsr)powerrrw)unaryrBINARY)binaryrSHIFTING)shiftingrry)bitwiser) comparisonszEXPRESSIONS BASICMETHODS)booleanszEXPRESSIONS TRUTHVALUE ASSERTION ASSIGNMENT) assignmentrxrx) augassignr)zassignment-expressionsrQDELETION RETURNING)compoundzfor while break continue)truthz if while and or not BASICMETHODS)debuggerpdb)zcontext-managersr:) IMPORTING CONDITIONALLOOPINGrP DEBUGGINGCONTEXTMANAGERSNcXlX lgr[_input_output)r@inputr#s rrHelper.__init__s   rcHUR=(d [R$r[)rrstdinrms rr Helper.inputs{{'cii'rcHUR=(d [R$r[)rrstdoutrms rr# Helper.outputs||)szz)rc[R"5SSS:XaU"5 gSURR<SURR<S3$)NrZr?rQrrrz instance>)r%stackr1r!r"rms 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 URS5nU(dgUR 5n[ U5S:a'USUSs=:XaS;aO OUSUSS;aUSSnUR5S;agUS :XaUR5 OURU5 M![[4a gf=f) NrYzhelp> r[rrrcrZ)qquitexitr) r#r"getlineKeyboardInterruptEOFErrorr\r]rVrr)r@rs rrHelper.interacts $ ,,x0wmmoGG 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)r6r4r5z Help on %s:)r#r$rY)r4rJr\ listkeywords listsymbols listtopics listmodulesr#r  showsymbolrCevalrr  showtopicr r3r#r")r@rr$s rr Helper.helpsE 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\rms rr Helper.intros7   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.list)su 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 rrms rr Helper.listkeywords6s4   $--$$&'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"rr rrms rrHelper.listsymbols=s4   $,,##%&rcURRS5 URURR 5SS9 g)NzN Here is a list of available topics. Enter any topic name to get more help. r)r)r#r"rr rrms rrHelper.listtopicsEs8   $++""$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"r r r rCr4rJrKeyErrorr\textwrapr^r#wraprr ) r@topic more_xrefs pydoc_datatargetlabelxrefsrCr)r~ wrapped_texts rrHelper.showtopicLs  $ (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'r1r r r rir4rJ _gettopic)r@r+r,r-r.r/r0rCs rr4Helper._gettopicps $  (9(9%(@A34 4 fc " ">>&5 5 &&u- [bC'*4Ez   sB** B76B7clURUnURS5up4nURX55 g)NrB)r  partitionr)r@symbolr.r+rr0s 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!)rqr?s ronerror#Helper.listmodules..onerrorsw-rrBz 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@rrrBr?s @rrHelper.listmoduless  KK   F3K   CL KK   G6= )  . O  '  : IIglln % KK   rrr)F)rrcr)#r/r!r"rr  _strprefixes_symbols_inverser rr+symbols_r8r r rr5rr#rrGrrrrrrrr rrrr4rrr)rprs000rr3r3 s$$$ $ y $ f $ . $ $ $ '$ 4$ -$ $ &$ $ %$ %!$" 5#$$ .%$& '$( 3)$* "+$, '-$. '/$0 l1$2 )3$4 55$6 y7$8 i9$:  ;$< (=$> )?$@ $A$B :C$D !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% _ Ms;Ir3c"\rSrSrSrSSjrSrg)rFiz7An 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__rZrQrYrrrD get_source get_filenamer)rVrrr/ __import__rFr#r>rr. find_specrrrrPr6rioStringIOrQrr r r1r r$)r@r?r completerrBseenrqr)rrrrrsourcerrs rrGModuleScanner.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"rrFrGrr!rrrFrFs A8rrFcSnSn[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 rr?apropos..callbacks1 23<; &crl\1G g+t ,rcgr[r!rqs rrBapropos..onerrors rrrDN)rrfilterwarningsrFrG)rr?rBs rrErEsG-  ")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..DocHandleri6 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_GET8 s yy!!&))) *   s #   ^-@<-O P     JJ  T__ <))/ :rcgr[r!)r@r>s r log_message-_start_server..DocHandler.log_messageH s rr!N)r/r!r"rrprsrr!rr DocHandlerrd6 s  :  rruc.>\rSrSrSrU4SjrSrSrg) _start_server..DocServeriL cXlURU4UlX0lURR XRUR 5 SUlgNF)hostaddressr?rBrhandlerr)r@rzportr?s rr)_start_server..DocServer.__init__N 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_quitU sZii#]]DKK,>,>,@+A2r1M '')iii    rcURRU5 UR(aURU5 ggr[)rBserver_activater?rms rr0_start_server..DocServer.server_activate\ s, II % %d +}} d#r)r{r?rzrN)r/r!r"rrrrr)rsr DocServerrwL s   $rrc@>\rSrSrU4SjrUUUU4SjrSrSrSrg)#_start_server..ServerThreadia c>XlX l[U5UlTRR U5 SUlSUlSUlgry) rmrzrr}Threadrservingerror docserver)r@rmrzr} threadings rr,_start_server..ServerThread.__init__c sA(OID DI    % %d + DLDJ!DNrcl>TRRTlTTlTRR Tl[UR5TlT"URURUR5nXl UR5 g![anX lSnAgSnAff=f)zStart the server.N)server HTTPServerrBr|rDMessage MessageClass staticmethodrmrzr}readyrrr6r)r@docsvrr,ruremailhttps rrG'_start_server..ServerThread.runl s !!%!7!7 $. !*/--*?*? '(4T__(E %"499diiD!''') !  !sBB B3#B..B3cSUlURUlURUlSURUR4-Ulg)NTz http://%s:%d/)rrz server_portr}r)r@rs rr)_start_server..ServerThread.readyy s:DL DI**DI&$))TYY)??DHrcpSURlUR5 SUlSUlSUlg)z&Stop the server and this thread nicelyTNF)rrr^rrrms rstop(_start_server..ServerThread.stop s."&DNN  IIK"DN DLDHr)rrrzr}rrrmN) r/r!r"rrrGrrr)rurrrrsr ServerThreadra s " ! ! @  rrg{Gz?) http.server email.messagerrrBaseHTTPRequestHandlerrrrrrrtimesleep) rmhostnamer}rthreadrurrrrrs @@@@@@r _start_serverrspT[[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
)ruplatformpython_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 ModulesrOz

zBuilt-in Modulesrzf

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

zIndex of ModulesrQ) rrr/rrrrrr^)rrr)namesrrWrr+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 rr?3_url_handler..html_search..callback s;rs|{*!#2,5  '+?D4K!@ Arrcgr[r!r_s rrB2_url_handler..html_search..onerror srrDNcSU<SU<S3$rr!rs rr4_url_handler..html_search..bltinlink rrz-Search Resultszkey = %srrzSearch Results) rrrarFrGrrrr^) rr?rBrrrr)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)rrr3r rrr)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)rrr3r 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..bltinlink0 s :>EErr%rBrQ) rTrUr3r4r rrrrr#rrr^) r+bufhtmlhelprr0rrrr+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)r2r5zcould not find object)rrirr?)rr?rcontentr+s r html_getobj!_url_handler..html_getobj8 sESA& ;3&=45 5 --)~rc>TRS5nSRU4Sj[[U5U555nUTR USU5-nSU-U4$)Nz$Errorrc3F># UHnTRU5v M g7fr[)ru)rrr+s rr3_url_handler..html_error..D s%FD6:t{{400Ds!rz Error - %s)rr^rrIr)rrrrr+s r html_error _url_handler..html_error@ 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.rSN)rQrr r ruz search?keyz topic?keyzget?keyz bad pydoc url)rr7rir6r)r complete_urlrroprrr+rrrrrrrs r get_html_page#_url_handler..get_html_pageI 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(rRrZNrfrQrgzunknown content type z for url ) rrrrdirnamerealpathrr^r readlinesrM)rrorr 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> rr`zServer stopped) webbrowserrrrr rrrrrVrrr)r}rrr 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)r4rJr>rsep)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 )getoptr6rrrrEr r rrexistsr rrr-rr1r,rr1rrr'r&rhr )r"r!optsr>writing start_serverrr}roptvalargrr 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<sg)T ( )   $   +CC      0d ! A  * %G jj5r}}E ( "J889(2  2 %NK K&+$ !(X77v(t(TM 7cM 7b:t:@NcN` G  6*y O y >KLC6DE!2# ]]~ x;;z <VriPX (4+ (J68#T!l zEr