3
T'íc:5 ã @ s$ d Z ddlZddlZddlZddlmZ ddlmZmZm Z m
Z
m Z m Z m
Z
mZ ddlmZ ddlmZmZ ddlZddlmZ ddlmZ dd lmZ dd
lmZ dd l m Z dd l m Z dd
l m!Z!m"Z" ddl#m$Z$ ddl%m&Z& ddl'm(Z(m)Z)m*Z* ddl+m,Z, e)j-e.Z/dZ0G dd deZ1ee2e2e e2 dddZ3ee4dddZ5eeddd d Z6ee e
e2 e dd d d Z7ee e2dd!d"d#Z8G d$d% d%e&Z9ee eee e d&d'd(Z:ee2e e2 d)d*d+Z;ee2e4d)d,d-Z<ee e
e2ee2ef e2f ddf d.d/d0Z=eee2ef d.d1d2Z>dS )3z7Add links to module code in Python object descriptions.é N)Úpath)ÚAnyÚDictÚ GeneratorÚIterableÚOptionalÚSetÚTupleÚcast)Únodes)ÚElementÚNode)Úaddnodes)ÚSphinx)ÚBuilder)ÚStandaloneHTMLBuilder)ÚRemovedInSphinx50Warning)ÚBuildEnvironment)Ú_Ú__)ÚModuleAnalyzer)ÚSphinxPostTransform)Úget_full_modnameÚloggingÚstatus_iterator)Ú make_refnodeZ_modulesc @ s e Zd ZdZdS )Úviewcode_anchorzÞNode for viewcode anchors.
This node will be processed in the resolving phase.
For viewcode supported builders, they will be all converted to the anchors.
For not supported builders, they will be removed.
N)Ú__name__Ú
__module__Ú __qualname__Ú__doc__© r! r! ú5/tmp/pip-build-gk9425m9/sphinx/sphinx/ext/viewcode.pyr s r )ÚappÚmodnameÚ attributeÚreturnc C sp y
t ||S tk
r, tjd|| d S tk
rj } z$tjtj j tjd|| d S d }~X nX d S )NzDidn't find %s in %sz0viewcode can't import %s, failed with error "%s")r ÚAttributeErrorÚloggerÚverboseÚ ExceptionÚ tracebackÚ
format_excÚrstrip)r# r$ r% Úer! r! r" Ú_get_full_modname( s
r/ )Úbuilderr& c C s> | j dkrdS | jdkr dS | jjdr6| jj r6dS dS d S )NÚhtmlFZ
singlehtmlZepubT)ÚformatÚnameÚ
startswithÚconfigÚviewcode_enable_epub)r0 r! r! r" Úis_supported_builder: s
r7 )r# Údoctreer& c s$ j jtdsi _tttttd fdd }xêt|jtj D ]Ö}|j
ddkrZqFt }xº|D ]²}t |tj
sxqf|j
d}|j
d}|}jjrº jd ||} | s¶t ||} | }|sÀqf|j
d}|||j|sÜqf||kræqf|j| tjt|jd
d }
|t|
|jd 7 }qfW qFW d S )
NÚ_viewcode_modules)r$ ÚfullnameÚdocnameÚrefnamer& c sÈ j j| d }|dkrdS jd| }|d krrytj| }|j W n tk
rb dj | < dS X |j}|j}n|\}}|d ks|d |kr¤||i |f}|j | < |\} }}
} ||krÄ||
|< dS dS )NFzviewcode-find-sourcer T) r9 ÚgetÚemit_firstresultr Z
for_moduleZ find_tagsr* ÚcodeÚtags) r$ r: r; r< ÚentryZ code_tagsZanalyzerr? r@ r Úused)r# Úenvr! r" Úhas_tagJ s,
z doctree_read.<locals>.has_tagÚdomainÚpyÚmoduler: zviewcode-follow-importedÚ.ú/)Ú reftargetÚrefidÚrefdoc)r0 rC Úhasattrr9 ÚstrÚboolÚlistÚfindallr Údescr= ÚsetÚ
isinstanceZdesc_signaturer5 Ú viewcode_follow_imported_membersr> r/ r; ÚaddÚ posixpathÚjoinÚOUTPUT_DIRNAMEÚreplacer ) r# r8 rD ZobjnodeÚnamesZsignoder$ r: r< Z new_modnameÚpagenamer! )r# rC r" Ú doctree_readE s<
r] )r# rC ÚdocnamesÚotherr& c C s t |dsd S t |ds i |_xn|jj D ]`\}}||jkrH||j|< q*|j| r*|j| d }x(|d j D ]\}}||krn|||< qnW q*W d S )Nr9 é )rM r9 Úitems) r# rC r^ r_ r$ rA rB r: r; r! r! r" Úenv_merge_info
s
rb )r# rC r; r& c C s~ t |di }xlt|j D ]\\}}|dkr,q|\}}}} x&t|D ]}
||
|krB|j|
qBW t|dkr|j| qW d S )Nr9 Fr )ÚgetattrrP ra ÚpopÚlen) r# rC r; Úmodulesr$ rA r? r@ rB r< r: r! r! r" Ú
env_purge_doc s rg c @ s@ e Zd ZdZdZeddddZdddd Zddd
d ZdS ) ÚViewcodeAnchorTransformz;Convert or remove viewcode_anchor nodes depends on builder.éd N)Úkwargsr& c K s" t | jjr| j n| j d S )N)r7 r# r0 Úconvert_viewcode_anchorsÚremove_viewcode_anchors)Úselfrj r! r! r" Úrun¬ s
zViewcodeAnchorTransform.run)r& c C sZ xT| j jtD ]D}tjdtddgd}t| jj|d |d |d |}|j | qW d S )NÚ z[source]z
viewcode-link)ÚclassesrL rJ rK )
ÚdocumentrQ r r Úinliner r r# r0 Z replace_self)rm ÚnodeÚanchorZrefnoder! r! r" rk ² s
z0ViewcodeAnchorTransform.convert_viewcode_anchorsc C s* x$t | jjtD ]}|jj| qW d S )N)rP rq rQ r ÚparentÚremove)rm rs r! r! r" rl ¹ s z/ViewcodeAnchorTransform.remove_viewcode_anchors) r r r r Zdefault_priorityr rn rk rl r! r! r! r" rh ¨ s
rh )r# rC rs Úcontnoder& c C s: |d dkr6t jdt t| j|d |d |d |S d S )NZreftypeZviewcodezTviewcode extension is no longer use pending_xref node. Please update your extension.rL rJ rK )ÚwarningsÚwarnr r r0 )r# rC rs rw r! r! r" Úmissing_reference¾ s rz )r# r$ r& c C s@ | j d|}|rdS ytj|\}}|S tk
r: dS X dS )z"Get module filename for *modname*.zviewcode-find-sourceN)r> r Zget_module_sourcer* )r# r$ Z source_infoÚfilenameÚsourcer! r! r" Úget_module_filenameÊ s r} c C sz t | |}|dkrdS tt| j}|jdd|j }tj| jd|}y tj |tj |kr^dS W n t
k
rt Y nX dS )z*Check generation of module page is needed.NTrH rI z _modules/F) r} r
r r0 rZ Z
out_suffixr rX ZoutdirÚgetmtimeÚIOError)r# r$ Zmodule_filenamer0 ÚbasenameZ
page_filenamer! r! r" Úshould_generate_module_page× s
r )r# r& c
c sB | j j}t|dsd S t| j s$d S | j j}| j j}t|j}xòtt |jj
t ddt |j| j
dd D ]À\}}|s~qnt| |sqn|\}}} }
tjt|jdd} |jjd#krÀ|jj} nd } |j|| d d
}
|
j }|d jd\}}|d |g|dd
< t |d }xr| j
D ]f\}}|| \}}}|| |d |
d | }d||tdf || ||< |t|| d7 < qW g }|}xPd|krÚ|jddd }||kr|j|| tjt|jdd|d qW |j|| tjtdtdd |j ||td| dj| d}| |dfV qnW |s>d S dg}d g} x¬t |D ] }|j | d$ r| j|d |jd n@| j x(|j | d% s²| j |jd qW | j|d |jd |tjtdtjt|jdd|f qTW |jd t | d td td!d j| d"}tjtd|dfV d S )&Nr9 z highlighting module code... Zbluec S s | d S )Nr r! )Úxr! r! r" Ú<lambda>û s z collect_pages.<locals>.<lambda>rH rI Úpython3ÚdefaultÚnoneÚpythonF)Zlinenosr z<pre>é ú#zM<div class="viewcode-block" id="%s"><a class="viewcode-back" href="%s">%s</a>z[docs]z</div>)ÚlinkÚtitleÚindexz Module codez<h1>Source code for %s</h1>Ú
)Úparentsr Úbodyz page.htmlro z<ul>z</ul>z <li><a href="%s">%s</a></li>
zOverview: module codez0<h1>All modules for which code is available</h1>)r r )r r
r éÿÿÿÿr ) r0 rC rM r7 Ú highlighterZget_relative_urirS r9 r Úsortedra r re Ú verbosityr rW rX rY rZ r5 Zhighlight_languageZhighlight_blockÚ
splitlinesÚsplitr ÚminÚrsplitÚappendÚreverser4 rd ) r# rC r ZuritoÚmodnamesr$ rA r? r@ rB r< r\ ÚlexerZ highlightedÚlinesZbeforeÚafterZmaxindexr3 r; ÚtypeÚstartÚendZbacklinkr ru Úcontextr1 Ústackr! r! r" Ú
collect_pagesì s
r£ c C s | j dd d | j ddd | j ddd | jdt | jdt | jdt | jd t | jd
t | jd | jd | jt t
j d
ddS )NZviewcode_importFr6 rU Tz doctree-readzenv-merge-infoz
env-purge-doczhtml-collect-pageszmissing-referencezviewcode-find-sourcezviewcode-follow-importedr )ÚversionZ env_versionZparallel_read_safe) Zadd_config_valueÚconnectr] rb rg r£ rz Z add_eventZadd_post_transformrh ÚsphinxZ__display_version__)r# r! r! r" ÚsetupP s
r§ )?r rW r+ rx Úosr Útypingr r r r r r r r
Zdocutilsr Zdocutils.nodesr r
r¦ r Zsphinx.applicationr Zsphinx.buildersr Zsphinx.builders.htmlr Zsphinx.deprecationr Zsphinx.environmentr Z
sphinx.localer r Z
sphinx.pycoder Z!sphinx.transforms.post_transformsr Z sphinx.utilr r r Zsphinx.util.nodesr Ú getLoggerr r( rY r rN r/ rO r7 r] rb rg rh rz r} r r£ r§ r! r! r! r" Ú<module> sF (
@
,d