3
T'ícFV ã @ s
d Z ddlZddlZddlmZ ddlmZ ddlmZm Z m
Z
m Z m Z m
Z
mZmZmZmZ ddlmZ ddlmZ ddlmZmZmZ dd lmZ dd
l m Z dd l m Z ydd l m!Z! W n e"k
rÜ dd l#m!Z! Y nX dd
l$m%Z% ddl&m'Z' ddl(m)Z) ddl*m+Z+m,Z,m-Z- ddl.m/Z/m0Z0 ddl1m2Z2 ddl3m4Z4m5Z5m6Z6 ddl7m8Z8 ddl9m:Z: dd l;mZ< ddl=m>Z> ddl?m@Z@ ddlAmBZB ddlCmDZDmEZE er¼ddlFmGZG ddlHmIZI e@jJeKZLd d iZMG d d d ZNd e'dd!d"d#ZOd e ePe f d$d%d&ZQdS )'zSphinx component registry.é N)Ú
import_module)Ú
MethodType)
Ú
TYPE_CHECKINGÚAnyÚCallableÚDictÚIteratorÚListÚOptionalÚTupleÚTypeÚUnion)Únodes)ÚInput)ÚElementÚNodeÚ TextElement)ÚParser)Ú Directive)Ú Transform)Ú entry_points)ÚBuilder)ÚConfig)ÚRemovedInSphinx60Warning)ÚDomainÚIndexÚObjType)Ú
GenericObjectÚTarget)ÚBuildEnvironment)ÚExtensionErrorÚ SphinxErrorÚVersionRequirementError)Ú Extension)Ú__)ÚXRefRole)Úlogging)Úprefixed_warnings)Ú RoleFunctionÚ TitleGetter)ÚSphinx)Ú
Documenterzsphinxjp.themecorez1.2c @ sr e Zd ZddddZdnee eddddZd edd
d d Z d eed
d
dZ
doee eddddZ eedddZ
eee dddZdpeeee eddddZdqeeeeef eddd d Zdreee edd d d Zd!ddd!g dfeeeeee eeedd" d#d$Z dseeeee eedd%d&d'Z dteeedd(d)d*Z duee edd+d,d-Z eee d.d/d0Z!e"eee f dd1d2Z#d ee d3d4d5Z$ee%ee& d.d6d7Z'dveee(j) edd8d9d:Z*ee+ e,eef dd;d<d=Z-eee(j) d>d?d@Z.ee/e(j)dAdBdCZ0ee1 ddDdEdFZ2eee1 ddGdHZ3ee1 ddDdIdJZ4eee1 ddKdLZ5eedM ddNdOdPZ6eee/ee/ge/f ddQdRdSZ7ee/ddTdUdVZ8ee/ddTdWdXZ9eedYdZd[Z:dweeedd\d]d^Z;dxee< ee=edd_d`daZ>ee,eef e,eef ddbdcddZ?eeddedfdgZ@d eddhdidjZAd e"eef dkdldmZBdS )yÚSphinxComponentRegistryN)Úreturnc C s i | _ i | _i | _g | _i | _i | _i | _i | _i | _i | _ i | _
i | _ d| _ i | _
g | _g | _g | _g | _i | _i | _i | _i | _i | _g | _d S )NZper_page)Úautodoc_attrgettrsÚbuildersÚ documentersÚ css_filesÚdomainsÚdomain_directivesÚdomain_indicesÚdomain_object_typesÚ domain_rolesÚenumerable_nodesÚhtml_inline_math_renderersÚhtml_block_math_renderersZhtml_assets_policyÚ html_themesÚjs_filesÚlatex_packagesÚ latex_packages_after_hyperrefÚpost_transformsÚsource_parsersÚ
source_inputsÚ
source_suffixÚ translatorsÚtranslation_handlersÚ
transforms)Úself© rF ú1/tmp/pip-build-gk9425m9/sphinx/sphinx/registry.pyÚ__init__3 s0 z SphinxComponentRegistry.__init__F)ÚbuilderÚoverrider- c C sh t jd| t|ds&ttd| |j| jkrX| rXttd|j| j|j jf || j|j< d S )Nz[app] adding builder: %rÚnamez(Builder class %s has no "name" attributez(Builder %r already exists (in module %s))ÚloggerÚdebugÚhasattrr r$ rK r/ Ú
__module__)rE rI rJ rF rF rG Ú add_builder s
z#SphinxComponentRegistry.add_builderr* )ÚapprK r- c C st |d kr d S || j krptdd}y || }W n4 tk
r` } zttd| |W Y d d }~X nX | j||j d S )Nzsphinx.builders)Úgroupz?Builder name %s not registered or available through entry point)r/ r ÚKeyErrorr! r$ Úload_extensionÚmodule)rE rQ rK Zbuilder_entry_pointsZ entry_pointÚexcrF rF rG Úpreload_builder s
z'SphinxComponentRegistry.preload_builderc C s( || j krttd| | j | |S )Nz Builder name %s not registered)r/ r! r$ )rE rQ rK rF rF rG Úcreate_builder s
z&SphinxComponentRegistry.create_builder)ÚdomainrJ r- c C s@ t jd| |j| jkr0| r0ttd|j || j|j< d S )Nz[app] adding domain: %rz domain %s already registered)rL rM rK r2 r r$ )rE rY rJ rF rF rG Ú
add_domain s z"SphinxComponentRegistry.add_domain)rY r- c C s
|| j kS )N)r2 )rE rY rF rF rG Ú
has_domain£ s z"SphinxComponentRegistry.has_domain)Úenvr- c c s x| j j D ]}||}|jj| jj|ji |jj| jj|ji |j j
| j j|jg x,| j j|ji j
D ]\}}|j|| qvW |V q W d S )N)r2 ÚvaluesÚ
directivesÚupdater3 ÚgetrK Úrolesr6 ÚindicesÚextendr4 r5 ÚitemsÚadd_object_type)rE r\ Z DomainClassrY rK ÚobjtyperF rF rG Úcreate_domains¦ s z&SphinxComponentRegistry.create_domains)rY rK ÚclsrJ r- c C sh t jd|||f || jkr,ttd| | jj|i }||kr\| r\ttd||f |||< d S )Nz$[app] adding directive to domain: %rz domain %s not yet registeredz3The %r directive is already registered to domain %s)rL rM r2 r r$ r3 Ú
setdefault)rE rY rK rh rJ r^ rF rF rG Úadd_directive_to_domain³ s
z/SphinxComponentRegistry.add_directive_to_domain)rY rK ÚrolerJ r- c C sh t jd|||f || jkr,ttd| | jj|i }||kr\| r\ttd||f |||< d S )Nz [app] adding role to domain: %rz domain %s not yet registeredz.The %r role is already registered to domain %s)rL rM r2 r r$ r6 ri )rE rY rK rk rJ ra rF rF rG Úadd_role_to_domain¿ s
z*SphinxComponentRegistry.add_role_to_domain)rY ÚindexrJ r- c C sj t jd||f || jkr*ttd| | jj|g }||kr\| r\ttd|j|f |j| d S )Nz [app] adding index to domain: %rz domain %s not yet registeredz/The %r index is already registered to domain %s) rL rM r2 r r$ r4 ri rK Úappend)rE rY rm rJ rb rF rF rG Úadd_index_to_domainË s
z+SphinxComponentRegistry.add_index_to_domainÚ ) Ú
directivenameÚrolenameÚ
indextemplateÚ
parse_nodeÚ
ref_nodeclassÚobjnameÚdoc_field_typesrJ r- c C s t jd|||||||f t|ttf|t||d} | jd|| | jd|t|d | j j
di }
||
kr| rt t d| t
|p|||
|< d S )Nz [app] adding object type: %r)rs rt rw Ústd)Úinnernodeclassz(The %r object_type is already registered)rL rM Útyper ÚobjectÚ staticmethodrj rl r% r5 ri r r$ r ) rE rq rr rs rt ru rv rw rJ Ú directiveÚ object_typesrF rF rG re Ö s
z'SphinxComponentRegistry.add_object_type)rq rr rs ru rv rJ r- c C s t jd|||||f t|ttfd|i}| jd|| | jd|t|d | jj di }||krx| rxt
t d| t |p||||< d S )Nz [app] adding crossref type: %rrs rx )ry z*The %r crossref_type is already registered)
rL rM rz r r{ rj rl r% r5 ri r r$ r ) rE rq rr rs ru rv rJ r} r~ rF rF rG Úadd_crossref_typeî s
z)SphinxComponentRegistry.add_crossref_type)ÚsuffixÚfiletyperJ r- c C s> t jd|| || jkr0| r0ttd| n
|| j|< d S )Nz"[app] adding source_suffix: %r, %rz&source_suffix %r is already registered)rL rM rA r r$ )rE r r rJ rF rF rG Úadd_source_suffix s z)SphinxComponentRegistry.add_source_suffix)ÚparserrJ r- c C sL t jd| x:|jD ]0}|| jkr:| r:ttd| q|| j|< qW d S )Nz%[app] adding search source_parser: %rz*source_parser for %r is already registered)rL rM Ú supportedr? r r$ )rE r rJ r rF rF rG Úadd_source_parser s
z)SphinxComponentRegistry.add_source_parser)r r- c C sD y
| j | S tk
r> } zttd| |W Y d d }~X nX d S )Nz#Source parser for %s not registered)r? rS r! r$ )rE r rV rF rF rG Úget_source_parser s
z)SphinxComponentRegistry.get_source_parserc C s | j S )N)r? )rE rF rF rG Úget_source_parsers s z*SphinxComponentRegistry.get_source_parsers)rQ Úfilenamer- c C s( | j |}| }t|tr$|j| |S )N)r Ú
isinstanceÚ SphinxParserZset_application)rE rQ r Ú parser_classr rF rF rG Úcreate_source_parser s
z,SphinxComponentRegistry.create_source_parserc C sP t jdt y
| j| S tk
rJ y
| jd S tk
rD d S X Y nX d S )Nz9SphinxComponentRegistry.get_source_input() is deprecated.Ú*)ÚwarningsÚwarnr r@ rS )rE r rF rF rG Úget_source_input$ s
z(SphinxComponentRegistry.get_source_input)rK Ú
translatorrJ r- c C s: t jd| || jkr,| r,ttd| || j|< d S )Nz.[app] Change of translator for the %s builder.z Translator for %r already exists)rL rM rB r r$ )rE rK r rJ rF rF rG Úadd_translator1 s z&SphinxComponentRegistry.add_translator)ÚnodeÚkwargsr- c K s t jd|| xv|j D ]j\}}| jj|i }y|\}}||f||j< W q tk
r } z ttd||f |W Y d d }~X qX qW d S )Nz)[app] adding translation_handlers: %r, %rzEkwargs for add_node() must be a (visit, depart) function tuple: %r=%r) rL rM rd rC ri Ú__name__Ú
ValueErrorr r$ ) rE r r Z builder_nameÚhandlersrC ÚvisitÚdepartrV rF rF rG Úadd_translation_handlers8 s
z0SphinxComponentRegistry.add_translation_handlers)rI r- c C s | j j|j|jS )N)rB r` rK Zdefault_translator_class)rE rI rF rF rG Úget_translator_classF s
z,SphinxComponentRegistry.get_translator_class)rI Úargsr- c G s | j |}|s td|j || }| jj|jd }|d krL| jj|ji }xH|j D ]<\}\}}t|d| t|| |rVt|d| t|| qVW |S )Nztranslator not found for %sÚvisit_Zdepart_) r ÚAssertionErrorrK rC r` Úformatrd Úsetattrr ) rE rI r Ztranslator_classr r rK r r rF rF rG Úcreate_translatorJ s
z)SphinxComponentRegistry.create_translator)Ú transformr- c C s t jd| | jj| d S )Nz[app] adding transform: %r)rL rM rD rn )rE r¢ rF rF rG Ú
add_transform\ s z%SphinxComponentRegistry.add_transformc C s | j S )N)rD )rE rF rF rG Úget_transforms` s z&SphinxComponentRegistry.get_transformsc C s t jd| | jj| d S )Nz [app] adding post transform: %r)rL rM r> rn )rE r¢ rF rF rG Úadd_post_transformc s z*SphinxComponentRegistry.add_post_transformc C s | j S )N)r> )rE rF rF rG Úget_post_transformsg s z+SphinxComponentRegistry.get_post_transformsr+ )rf Ú
documenterr- c C s || j |< d S )N)r0 )rE rf r§ rF rF rG Úadd_documenterj s z&SphinxComponentRegistry.add_documenter)ÚtypÚ
attrgetterr- c C s || j |< d S )N)r. )rE r© rª rF rF rG Úadd_autodoc_attrgetterm s z.SphinxComponentRegistry.add_autodoc_attrgetter)r Ú
attributesr- c K s | j j||f d S )N)r1 rn )rE r r¬ rF rF rG Ú
add_css_filesq s z%SphinxComponentRegistry.add_css_filesc K s" t jd|| | jj||f d S )Nz [app] adding js_file: %r, %r)rL rM r; rn )rE r r¬ rF rF rG Ú add_js_filet s z#SphinxComponentRegistry.add_js_file)rK r- c s" | j | j }t fdd|D S )Nc s g | ]}|d kr|qS )r rF )Ú.0Úx)rK rF rG ú
<listcomp>z s z=SphinxComponentRegistry.has_latex_package.<locals>.<listcomp>)r< r= Úbool)rE rK ÚpackagesrF )rK rG Úhas_latex_packagex s z)SphinxComponentRegistry.has_latex_package)rK ÚoptionsÚafter_hyperrefr- c C sN | j |rtjd| tjd| |r:| jj||f n| jj||f d S )Nz#latex package '%s' already includedz [app] adding latex package: %r)r´ rL r rM r= rn r< )rE rK rµ r¶ rF rF rG Úadd_latex_package| s
z)SphinxComponentRegistry.add_latex_package)r ÚfigtypeÚ title_getterrJ r- c C sB t jd||| || jkr0| r0ttd| ||f| j|< d S )Nz*[app] adding enumerable node: (%r, %r, %r)z%enumerable_node %r already registered)rL rM r7 r r$ )rE r r¸ r¹ rJ rF rF rG Úadd_enumerable_node s z+SphinxComponentRegistry.add_enumerable_node)rK Úinline_renderersÚblock_renderersr- c C sB t jd||| || jkr*ttd| || j|< || j|< d S )Nz+[app] adding html_math_renderer: %s, %r, %rz&math renderer %s is already registered)rL rM r8 r r$ r9 )rE rK r» r¼ rF rF rG Úadd_html_math_renderer s
z.SphinxComponentRegistry.add_html_math_renderer)rK Ú
theme_pathr- c C s || j |< d S )N)r: )rE rK r¾ rF rF rG Úadd_html_theme s z&SphinxComponentRegistry.add_html_theme)rQ Úextnamer- c & C sf ||j krdS |tkr0tjtd|t| dS td| }t| y t|}W nL tk
r } z0tjtdt j
t td| ||W Y dd}~X nX t |dd}|dkrÌtjtd| i }nHy ||}W n: t
k
r } z t
td||f |W Y dd}~X nX |dkr$i }n t|tsDtjtd | i }t||f||j |< W dQ R X dS )
zLoad a Sphinx extension.Nz\the extension %r was already merged with Sphinx since version %s; this extension is ignored.z while setting up extension %s:zOriginal exception:
z Could not import extension %sÚsetupzMextension %r has no setup() function; is it really a Sphinx extension module?zpThe %s extension used by this project needs at least Sphinx v%s; it therefore cannot be built with this version.zuextension %r returned an unsupported object from its setup() function; it should return None or a metadata dictionary)Ú
extensionsÚEXTENSION_BLACKLISTrL Úwarningr$ r' r Ú ImportErrorÚverboseÚ tracebackÚ
format_excr Úgetattrr" r Údictr# )rE rQ rÀ ÚprefixÚmodÚerrrÁ ÚmetadatarF rF rG rT sB
z&SphinxComponentRegistry.load_extension)rQ r- c C s, ddl m} dd |jj D }||d< |S )Nr )Ú ENV_VERSIONc S s& i | ] }|j jd r|j d |jqS )Z env_version)rÎ r` rK )r¯ ÚextrF rF rG ú
<dictcomp>Ë s z:SphinxComponentRegistry.get_envversion.<locals>.<dictcomp>Zsphinx)Úsphinx.environmentrÏ r r] )rE rQ rÏ Z
envversionrF rF rG Úget_envversionÉ s z&SphinxComponentRegistry.get_envversion)F)F)F)F)F)rp Nrp F)F)F)F)F)NF)Cr rO Ú __qualname__rH r r r² rP ÚstrrW rX r rZ r[ r r rg r rj r
r( r% rl r ro r r r re r r r r
r r r r r
r r r Ú NodeVisitorr r r r r r r¡ r r£ r¤ r¥ r¦ r¨ r« r r® r´ r· r r) rº r½ r¿ rT rÓ rF rF rF rG r, 2 s^ M
.r, r* )rQ Úconfigr- c C s` xN| j jj D ]>\}}|| jjkr0|| jj|< q| jj| dkr|| jj|< qW | jj| j _dS )zDMerge any user-specified source_suffix with any added by extensions.N)ÚregistryrA rd r× )rQ r× r r rF rF rG Úmerge_source_suffixÑ s rÙ )rQ r- c C s | j dtdd ddddS )Nz
config-initedi )ÚpriorityÚbuiltinT)ÚversionZparallel_read_safeZparallel_write_safe)ÚconnectrÙ )rQ rF rF rG rÁ ß s rÁ )RÚ__doc__rÇ r Ú importlibr Útypesr Útypingr r r r r r r
r r r
Zdocutilsr Z docutils.ior Zdocutils.nodesr r r Zdocutils.parsersr Zdocutils.parsers.rstr Zdocutils.transformsr Zimportlib_metadatar rÅ Zimportlib.metadataZsphinx.buildersr Z
sphinx.configr Zsphinx.deprecationr Zsphinx.domainsr r r Zsphinx.domains.stdr r rÒ r Z
sphinx.errorsr r! r" Zsphinx.extensionr# Z
sphinx.localer$ Zsphinx.parsersr Z sphinx.rolesr% Z sphinx.utilr& Zsphinx.util.loggingr' Zsphinx.util.typingr( r) Zsphinx.applicationr* Zsphinx.ext.autodocr+ Ú getLoggerr rL rà r, rÙ rÕ rÁ rF rF rF rG Ú<module> sP 0
"