3
T'ícó ã @ sØ d Z ddlmZ ddlmZ ddlmZmZmZm Z m
Z
m Z m Z m
Z
ddlmZmZ ddlmZ ddlmZ ddlmZ erdd lmZ ejeZG d
d d e Z d d
ddddddddddddddZ G dd dZ d S ) zLSphinx core events.
Gracefully adapted from the TextPress system by Armin.
é )Ú defaultdict)Ú
attrgetter)Ú
TYPE_CHECKINGÚAnyÚCallableÚDictÚListÚ
NamedTupleÚTupleÚType)ÚExtensionErrorÚ SphinxError)Ú__)Úlogging)Ú safe_getattr)ÚSphinxc @ s e Zd ZU eeedS )Ú
EventListenerN)Ú__name__Ú
__module__Ú __qualname__ÚintÚidr ÚhandlerÚpriority© r r ú//tmp/pip-build-gk9425m9/sphinx/sphinx/events.pyr s
r Ú Úconfigz env, added, changed, removedÚenvz env, docnamez
env, docnameszdocname, source textz the doctree before being pickledz&env, read docnames, other env instancezenv, node, contnodez domain, nodezdoctree, docnameÚ exception)zbuilder-initedz
config-initedzenv-get-outdatedzenv-get-updatedz
env-purge-doczenv-before-read-docszenv-check-consistencyz source-readz doctree-readzenv-merge-infozmissing-referencezwarn-missing-referencezdoctree-resolvedz env-updatedzbuild-finishedc @ s e Zd ZdZdddddZedddd Zeeeed
d d Z edd
ddZ
f dee e e
e df edddZf dee e e
e df e dddZdS )Ú EventManagerzEvent manager for Sphinx.r N)ÚappÚreturnc C s$ || _ tj | _tt| _d| _d S )Nr )r! Ú core_eventsÚcopyÚeventsr ÚlistÚ listenersÚnext_listener_id)Úselfr! r r r Ú__init__3 s
zEventManager.__init__)Únamer" c C s( || j krttd| d| j |< dS )z Register a custom Sphinx event.zEvent %r already presentr N)r% r r )r) r+ r r r Úadd9 s
zEventManager.add)r+ Úcallbackr r" c C sJ || j krttd| | j}| jd7 _| j| jt||| |S )z$Connect a handler to specific event.zUnknown event name: %sé )r% r r r( r' Úappendr )r) r+ r- r Ú listener_idr r r Úconnect? s
zEventManager.connect)r0 r" c C sB x<| j j D ].}x(|dd
D ]}|j|kr |j| q W q W dS )zDisconnect a handler.N)r' Úvaluesr Úremove)r) r0 r' Úlistenerr r r Ú
disconnectI s
zEventManager.disconnect)Úallowed_exceptions.)r+ Úargsr6 r" c G sô y t jd|t|dd
W n tk
r2 Y nX g }t| j| tdd}x |D ]}y |j|j| j f| W qT |k
r Y qT t
k
r Y qT tk
rê } z2t |jdd}t t
d|j|f ||d|W Y dd}~X qTX qTW |S ) zEmit a Sphinx event.z[app] emitting event: %r%sNéd r )Úkeyr z*Handler %r for event %r threw an exception)Úmodname)ÚloggerÚdebugÚreprÚ ExceptionÚsortedr' r r/ r r! r
r r r ) r) r+ r6 r7 Úresultsr' r4 Úexcr: r r r ÚemitP s$
,zEventManager.emitc G s0 x*| j |f|d|iD ]}|dk r|S qW dS )zEmit a Sphinx event and returns first result.
This returns the result of the first handler that doesn't return ``None``.
r6 N)rB )r) r+ r6 r7 Úresultr r r Úemit_firstresultj s z EventManager.emit_firstresult)r r r Ú__doc__r* Ústrr, r r r1 r5 r r
r r> r rB rD r r r r r 0 s
&r N) rE Ú collectionsr Úoperatorr Útypingr r r r r r r
r Z
sphinx.errorsr r
Z
sphinx.localer Z sphinx.utilr Zsphinx.util.inspectr Zsphinx.applicationr Ú getLoggerr r; r r# r r r r r Ú<module> s6 (