zzBuilt-in Modulesz#ee77aaz|
pydoc by Ka-Ping Yee<ping@lfw.org>zIndex of Modulesr ) r r r r r r r
rh r! )r r namesr r r )r r r
html_index s z _url_handler..html_indexc s g f d d } t j 7 t j d d d } t j | | d | Wd QRXd d } g } j d
d d } x+ D]# \ } } | j | | | q W| j d
| d d d j | } d | f S)zSearch results page.c sK | d d d k r* | d d d } j | | o@ d | f d S)Nr z .__init__z
(package)z- ii)r
)r r' rw )
search_resultr r r 9 s z3_url_handler..html_search..callbackr c S s d S)Nr )r' r r r r @ s z2_url_handler..html_search..onerrorr Nc S s d | | f S)Nz%sr )r( r r r r E s z4_url_handler..html_search..bltinlinkz5Search Resultsz#ffffffz#7799eezkey = %sz#ee77aaz
zSearch Results) r r r r r r r
r r! ) rG r r r rh r r( rw r )r )r r html_search4 s
z!_url_handler..html_searchc
s t j j | } t j | } j | j } Wd QRXd | } j d d d } | j d | d d | } d | | f S) z-Get and display a source file listing safely.Nz
%s
z3File Listingz#ffffffz#7799eezFile: %sz#ee77aaz
getfile %s) r+ r, Zunquoter r r r r r )r fpr# Zbodyr r )r r r html_getfileR s
z"_url_handler..html_getfilec sn d d } j d d d } t t j j } j | | } | j d d d | } d | f S)z Index of topic texts available.c S s d | | f S)Nz %sr )r( r r r r b s z4_url_handler..html_topics..bltinlinkz,INDEXz#ffffffz#7799eeZTopicsz#ee77aa)r r r r rD r r )r r r r )r r r html_topics_ s z!_url_handler..html_topicsc sn j d d d } t t j j } d d } j | | } | j d d d | } d | f S)zIndex of keywords.z,INDEXz#ffffffz#7799eec S s d | | f S)Nz %sr )r( r r r r v s z6_url_handler..html_keywords..bltinlinkZKeywordsz#ee77aa)r r r r rD r r )r r r r )r r r
html_keywordso s z#_url_handler..html_keywordsc s t j } t | | } | j | \ } } | | j k rH d } n d } j d | d d } d j | } j | d d | } | r t | j } d d } j
| | } j d
d d | } d | | f d j | | | f f S)
zTopic or keyword help page.ZKEYWORDZTOPICz)%sz#ffffffz#7799eez
%s
z#ee77aac S s d | | f S)Nz %sr )r( r r r r s z7_url_handler..html_topicpage..bltinlinkzRelated help topics: z%s %sr )
r r r r r r r r r r r r r! )r ZbufZhtmlhelpr r r r r )r r r html_topicpage~ s&
z$_url_handler..html_topicpagec s^ t | d d } | d k r6 | d k r6 t d t | } j | | } | | f S)Nr r r zcould not find object)r r^ r r )r
r9 r content)r r r html_getobj s z!_url_handler..html_getobjc sp j d d d } d j f d d t t | | D } | j | d d | } d | | f S) Nz,Errorz#ffffffz#7799eez
c 3 s | ] } j | Vq d S)N)r )r rw )r r r rf s z3_url_handler..html_error..z#bb0000z
Error - %s)r r! r r r )r
r r r )r r r
html_error s
z _url_handler..html_errorc s
| } | j d r% | d d } y| d k rF \ } } ny| d k rd \ } } n[| d k r \ } } n=d | k r| j d \ } } } | d k r | \ } } q| d
k r | \ } } q| d k r4y | \ } } Wqt k
r0 | \ } } YqXq| d k r| d k r^ \ } } qy | \ } } Wqt k
r | \ } } YqXqt d
n | \ } } Wn: t k
r} z | | \ } } WYd d } ~ Xn X j | | S)z Generate an HTML page for url.z.htmlN r rh r r rZ z
search?keyz getfile?keyz topic?keyzget?keyz
bad pydoc url)r rh )r rh )rb r r^ rB r )r
Z complete_urlr r opr_ r ) r r r r r r r r r r r
get_html_page sB
(z#_url_handler..get_html_pager r Nztext/cssr z text/htmlz"unknown content type %r for url %s) r ra r r dirnamerealpathrV r! r readlinesr )r
r r r Z path_herer r r )
r r r r r r r r r r r _url_handler s,
**
r open_browserTc C s$ d d l } t t | } | j r5 t | j d S| j r d } | rZ | j | j z y t d | j t | x^ | j r t d } | j } | d k r Pq} | d k r | j | j q} t | q} WWn t
t f k
r t Yn XWd | j r | j t d Xd S) 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 r r r r r
r r r r r )r r r Z serverthreadZserver_help_msgr r r r browse s2
r c C s% t | t o$ | j t j d k S)Nr )r r- r r sep)rN r r r ispath
s r c C s d d l } Gd d d t } d t j k r| t j j t j d } | t j k ri t j j | t j j d d y| j t j d d d \ } } d } d } d } d } xp | D]h \ } }
| d
k r d } d } | d k rt |
d S| d
k rd } |
} | d k r d } q W| r[| d k rGd } t
| d | d S| sg| x | D] } t | rt j j | rt
d | Pyy t | rt j j | rt | } | r
t | r t j j | r t | qt | n
t j | Wqnt k
rL} z t
| WYd d } ~ XqnXqnWWnc | j | f k
rt j j t j j t j d d }
t
d j d |
d t j Yn Xd S)z@Command-line interface (looks at sys.argv to decide what to do).r Nc @ s e Z d Z d S)zcli..BadUsageN)r% r& r[ r r r r BadUsage
s r r r r zbk:p:wFz-bTz-kz-pz-wr zfile %r does not exista 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} -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. The -p option can be used with
the -b option to explicitly specify the server port.
{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 )getoptrB r r r r argvremoveinsertr r r existsr rn r r r r r r r r r r r )r r Z scriptdirZoptsr ZwritingZ start_serverr r ZoptvalargrH r r r r cli
sd %
%)r r )WrU r* rP rT rS rS Zimportlib._bootstrapr~ Z importlib._bootstrap_externalimportlib.machineryimportlib.utilr r r r0 r r r r r Z urllib.parser+ r collectionsr reprlibr tracebackr r r r$ r) r- r/ r3 r
IGNORECASEr4 r5 r: r? rC rO re rf rp rx r rB r r r r r r rj rk rz r| r{ r r r r r r r r r. r r r r r" r r r r r r r r r r r r% r r r r $ s
'
0>* - d ! ,
= % V