'
s, ( ( ($J&& &&&r zzBuilt-in Modulesr zf
pydoc by Ka-Ping Yee<ping@lfw.org>
zIndex of ModulesrK ) rn r r r rx r
r r rX )r rn namesri r3 r r! s r
html_indexz _url_handler..html_index
s = = = ,, =
( (#": ( ( (##E955UT__ &3 &3 3 4 8 3 3C OODJJsD 1 1 2 2 2 2
' ( ( ( "2778#4#444r c g fd}t j 5 t j d d }t || | ddd n # 1 swxY w Y d }g }
d } D ]&\ }}| || |z '|
d| z d d
| z }d |fS ) zSearch results page.c v |dd dk r
|d d dz } ||od|z f d S r7 r )r
r] r
search_results r r! z3_url_handler..html_search..callback;
sP rss|{**!#2#, 5 '4+?D4K!@ A A A A Ar r: c d S r r r9 s r r# z2_url_handler..html_search..onerrorB
s r r$ Nc d| d| dS r r r s r r z4_url_handler..html_search..bltinlinkG
r r z-Search Resultszkey = %sr r zSearch Results) r; r< r= r& r' rn r rx rX ) r r! r# r r rn r# r ri r r! s @r html_searchz!_url_handler..html_search6
s
B B B B B
$
&
& @ @ #H - - -
OO #w ? ? ? @ @ @ @ @ @ @ @ @ @ @ @ @ @ @ = = = ,, ;
( 3 3JD$ NN99T??T1 2 2 2 2T__ gv{{7';'; = = = ))s INDEXTopicsr )rn r r) r r r rx )r rn r ri r! s r html_topicsz!_url_handler..html_topicsT
s B B B ,, 2
v}))++,,##E955T__ gx ) ) )!!r c d } t t j }d } || }| dd| z }d|fS )zIndex of keywords.r c d| d| dS r r r s r r z6_url_handler..html_keywords..bltinlinkk
r r Keywordsr )rn r r) r r r rx )rn r r ri r! s r
html_keywordsz#_url_handler..html_keywordsd
s ,, 2
v++--.. B B B ##E955T__ + + +8##r c t j }t || }| | \ }}| |j v rd}nd} d|z }d | z } | d| }|rQt | }d }
|| } dd| }|d| d |||f fS )
zTopic or keyword help page.KEYWORDTOPICr z
%s
r c d| d| dS r r r s r r z7_url_handler..html_topicpage..bltinlink
s :>$$EEr r
r rK )
r r1 r) r r rn r rx r r r rv rX ) r bufhtmlhelpri r rh rn r r! s r html_topicpagez$_url_handler..html_topicpages
s! kmm#s##",,U33% H% % % EEE,, /% 7
#T[[%:%::??57H== J5;;==))E
F
F
F $$UI66ELL!8'5IIE 55%%((E2335 5r c t | d }|| dk rt d t | } || }||fS )NrT )r r+ zcould not find object)r r/ r r )r r9 rh contentr! s r html_getobjz!_url_handler..html_getobj
sY SA&&& ;3&== 455 5
--S))g~ r c d }d fdt t | | D }| | d| z }d| z |fS )Nz$Errorr c 3 B K | ]} | V d S r )rM )r r r! s r r[ z3_url_handler..html_error..
sG F FTt{{4 0 0 F F F F F Fr rh z
Error - %s)rn rX r rC rx )r r rn ri r! s r
html_errorz _url_handler..html_error
s ,, 2
;; F F F F 4T#YY D D F F F F FT__S'8 D DDc!8++r c | }| d r
| dd } | dv r
\ }}n| dk r \ }}n| dk r \ }}nd| v r| d \ }}} |dk r | \ }}n|d k r.
| \ }}n# t $ r | \ }}Y ngw xY w|d
k r@| dv r
\ }}nK | \ }}n;# t $ r
| \ }}Y n!w xY wt d | \ }}n&# t $ r} || \ }}Y d}~nd}~ww xY w || S ) z Generate an HTML page for url.r- N)rK r r r r9 z
search?keyz topic?keyzget?keyz
bad pydoc url)r r r/ r rj )r complete_urlrh r opr r r! r r r r r r r s r
get_html_pagez#_url_handler..get_html_page
s << crc(C ;m##!+ ww !, ww
""!. ww ]]3 / /
As %%%0[%5%5NE77;&&:)7 )<)<ww% : : :)4S)9)9www:9__m++)3 wwA-8[-=-=NE77 ) A A A-;^C-@-@NE777A %_555!,S!1!1w ; ; ; 'Z c : :NE777777 ; yy(((s` A2D( B& %D( &C>D( CD( C, +D( ,DD( D D( (
E 2EE r, rT NrB rK rC zunknown content type z for url ) re r r r
dirnamerealpathr rX r readlinesrG )r rJ r r path_herer fpr! r r r r r r r r s @@@@@@@@@r _url_handlerr sq ? ? ? ? ? ? ?7 ? ? ?$ 8::DH H H H H65 5 5 5 50 * * * * *<" " " " "
$
$
$
$
$ 5 5 5 5 52 , , , , ,&) &) &) &) &) &) &) &) &) &) &) &)P ~~c !""gz!!GOOBG$4$4X$>$>?? 7<< 3//
(^^ +r772<<>>** + + + + + + + + + + + + + + + + + $ $ }S!!!
)LLL##N
O
OOs 2'D&&D*-D*T localhost) open_browserr c ddl }t t || }|j rt |j dS |j r/d}|r| |j t d|j t | |j rat d }| }|dk rn7|dk r| |j nt | |j an%# t t f$ r t Y nw xY w|j r%| t d dS dS # |j r$| t d w w xY wdS ) 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.
r Nz"Server commands: [b]rowser, [q]uitzServer ready atzserver> r r zServer stopped)
webbrowserr r rh r rg r r r r1 r r rx )rV r r r serverthreadserver_help_msgr s r browser
s x>>L
l !!! (> . OOL , - - - ( #\%5 6 6 6 / " " " &
+J''iikk#::CZZ OOL$45555/*** &
+ "8, GGGGG #
( !!###&'''''
(
(|#
( !!###&''''
('( (s+ B C, +D? , D D?
DD? ?-E,c r t | t o"| t j dk S r )r. rD r r sep)r s r ispathr
s( a 5!&&..A"55r c d| v s#t j | v st j | v rdS t j t
}t j | }| }|| v r5t j || s| | | dt j |S )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.
rK Nr )
r curdirgetcwdr
r r copysamefileremoveinsert)
given_pathargv0
stdlib_dir
script_dir revised_paths r _get_revised_pathr
s
Z29
22bikkZ6O6Ot **J ''J ??$$LZ (8(8Z(P(P J'''29;;''' r c t t j t j d } | | t j dd< dS dS )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.
r N)r r r
argv)r s r _adjust_cli_sys_pathr s<
%SXsx{;;L " r c 0 ddl } G d dt }t | t j dd d \ }}d}d}d}d}d}|D ]C\ } }
| d k rd
}d
}| d k rt |
dS | d k rd
}|
}| d
k rd
}| dk rd
}|
}D|rt
||| dS |s||D ]C} t | rEt j
| s&t d| z t j d t | r.t j
| rt | } |rNt | r/t j | rt! | n,t# | n t$ | d
# t& t( f$ r.} t | t j d Y d} ~ =d} ~ ww xY wdS # | j |f$ r t j t j t j d d }
t d |
t j Y dS w xY w)z@Command-line interface (looks at sys.argv to decide what to do).r Nc e Zd ZdS )cli..BadUsageN)r) r r r r r BadUsager # s r r rT zbk:n:p:wFr z-bTz-kz-pz-wz-n)r r zfile %r does not existr a pydoc - 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 )getoptr r r r r% r r r r
existsr exitr r r r' r" r r
r rh r r r0 r )r r optsr writing start_serverr rV r optvalargr r s r clir s MMM#####9###M!]]38ABB<<<
d HCd{{ # # d{{ d{{ # d{{ d{{ # 4( F F F F F#8^ Cc{{
27>>##6#6
.4555
#;; *27>>##6#6 *$S//C 0 c{{ &rw}}S'9'9 &!#
IIc$I/// !23
e
$
L( # ! ! !g rw / / < <==a@
: FsF ; ! ! ! ! ! ! !sK A H 1H 8A H B)G?H H #G;5H ;H H B JJr- r )r )r r N)r r NF)rK N)rC )cr@ r r r r r r- importlib._bootstrapr importlib._bootstrap_externalimportlib.machineryimportlib.utilr r r r r rM r r7 r} r urllib.parser r; collectionsr reprlibr tracebackr r r$ r> r7 rI rQ rZ r^ ra rh rl rt r
IGNORECASErv rx r{ r r r all_feature_namesr r r r r r r r r r r r r: re ra rg r r r r r r r r r r r rj r r! r r r= r" r' r) r r& r% r r r r r r r r) r r r r s % %L (
)
$ $ $ $
+ + + + + +
1 1 1f
! ! ! A A A
% % %G G G bj5r}EE ( ( (
" J 899 ( ( ( (0
" % % % %NK K K K K K K K6 6 6$ ! , , , ,`6 6 6 6 6 6 6 6t( ( ( ( ( t ( ( ( TY 7 Y 7 Y 7 Y 7 Y 7c Y 7 Y 7 Y 7z : : : : :t : : :@Y Y Y Y Yc Y Y Yv G " " " H# # # 0
/
/
/F F F
*2 *2 *2X2 2 2 6 * wyy MOO wyy > > > > KLC C C C6 DE ! "# # # # W W W W W W W Wr vxx; ; ; ; ; ; ; ;z
<
<
< V V VriP iP iP iPX (4+ ( ( ( ( (J6 6 6 8# # #T! T! T!l zCEEEEE r