File: //usr/lib/python3/dist-packages/sphinx/__pycache__/events.cpython-310.pyc
o
�$�a� � @ s� d Z ddlmZ ddlmZ ddlmZmZmZm Z m
Z
m Z m Z m
Z
ddlmZmZ ddlmZ ddlmZ ddlmZ erDdd lmZ e�e�ZG d
d � d e �Z d d
dddddddddddddd�Z G dd� d�Z d S ) z�
sphinx.events
~~~~~~~~~~~~~
Sphinx core events.
Gracefully adapted from the TextPress system by Armin.
:copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS.
:license: BSD, see LICENSE for details.
� )� defaultdict)�
attrgetter)�
TYPE_CHECKING�Any�Callable�Dict�List�
NamedTuple�Tuple�Type)�ExtensionError� SphinxError)�__)�logging)� safe_getattr)�Sphinxc @ s& e Zd ZU eed< eed< eed< dS )�
EventListener�id�handler�priorityN)�__name__�
__module__� __qualname__�int�__annotations__r � r r �//usr/lib/python3/dist-packages/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 ZdZddd�Zdeddfd d
�Zded ed edefd
d�Z deddfdd�Z
dd�dede de e
e df defdd�Zdd�dede de e
e df de fdd�ZdS ) � EventManagerzEvent manager for Sphinx.�appr �returnNc C s$ || _ t�� | _tt�| _d| _d S )Nr )r" � core_events�copy�eventsr �list� listeners�next_listener_id)�selfr" r r r �__init__: s
zEventManager.__init__�namec C s( || j v r
ttd�| ��d| j |< dS )z Register a custom Sphinx event.zEvent %r already presentr N)r& r r )r* r, r r r �add@ s
zEventManager.add�callbackr c C sJ || j vr
ttd�| ��| j}| jd7 _| j| �t|||�� |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 �connectF s
zEventManager.connectr1 c C s: | j �� D ]}|dd� D ] }|j|kr|�|� q
qdS )zDisconnect a handler.N)r( �valuesr �remove)r* r1 r( �listenerr r r �
disconnectP s
���zEventManager.disconnectr )�allowed_exceptions�argsr7 .c G s� zt �d|t|�dd� � W n ty Y nw g }t| j| td�d�}|D ]A}z|�|j| j g|�R � � W q( |yA � t
yH � tyi } zt |jdd�}t t
d�|j|f ||d�|�d}~ww |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 r0 r r" r
r r r ) r* r, r7 r8 �resultsr( r5 �excr; r r r �emitW s4 � �����zEventManager.emitc G s2 | j |g|�R d|i�D ]
}|dur| S q dS )z�Emit a Sphinx event and returns first result.
This returns the result of the first handler that doesn't return ``None``.
r7 N)rC )r* r, r7 r8 �resultr r r �emit_firstresultq s
�z EventManager.emit_firstresult)r" r r# N)r r r �__doc__r+ �strr- r r r2 r6 r r
r r? r rC rE r r r r r! 7 s$
��
����r! N) rF � collectionsr �operatorr �typingr r r r r r r
r �
sphinx.errorsr r
�
sphinx.localer � sphinx.utilr �sphinx.util.inspectr �sphinx.applicationr � getLoggerr r< r r$ r! r r r r �<module> s: (
�