File: //usr/lib/python3/dist-packages/sphinx/domains/__pycache__/citation.cpython-310.pyc
o
�$�a� � @ s d Z ddlmZmZmZmZmZmZmZm Z ddl
m Z ddl m
Z
ddlmZ ddlmZ ddlmZ ddlmZ dd lmZ dd
lmZmZ er\dd lm Z dd l m Z dd
l m Z e�!e"�Z#G dd� de�Z$G dd� de�Z%G dd� de�Z&dddee'ef fdd�Z(dS )z�
sphinx.domains.citation
~~~~~~~~~~~~~~~~~~~~~~~
The citation domain.
:copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS.
:license: BSD, see LICENSE for details.
� )�
TYPE_CHECKING�Any�Dict�List�Optional�Set�Tuple�cast)�nodes)�Element)� pending_xref)�Domain)�__)�SphinxTransform)�logging)�copy_source_info� make_refnode)�Sphinx)�Builder)�BuildEnvironmentc @ s e Zd ZdZdZdZddiZedee e
e e e f f fdd��Z edee e
e f fdd ��Zd
e dd fd d
�Zdee dedd fdd�Zdejdd fdd�Zdedd fdd�Zd%dd�Zddde d d d e d e ded edee fd!d"�Zddde d d d e ded edee
e ef fd#d$�Zd S )&�CitationDomainzDomain for citations.�citation�refz citation not found: %(target)s�returnc C � | j �di �S )N� citations��data�
setdefault��self� r! �9/usr/lib/python3/dist-packages/sphinx/domains/citation.pyr * � zCitationDomain.citationsc C r )N�
citation_refsr r r! r! r" r$ . r# z CitationDomain.citation_refs�docnameNc C sp t | j�� �D ]\}\}}}||kr| j|= qt | j�� �D ]\}}||hkr,| j|= q ||v r5|�|� q d S )N)�listr �itemsr$ �remove)r r% �key�fn�_l�lineno�docnamesr! r! r" � clear_doc2 s �
��zCitationDomain.clear_docr- � otherdatac C sr |d � � D ]\}}|d |v r|| j|< q|d � � D ]\}}| j�|t� �}|D ] }||v r5|�|� q*q d S )Nr r r$ )r' r r$ r �set�add)r r- r/ r) r r$ r% r! r! r" �merge_domaindata< s
�
���z CitationDomain.merge_domaindata�nodec C sh |d � � }|| jv r#| j�| j| d �}tjtd�|||ddd� |d |d d |jf| j|< d S )Nr z+duplicate citation %s, other instance in %sr r )�location�type�subtyper% �ids)�astextr �env�doc2path�logger�warningr �line)r r3 �label�pathr! r! r" �
note_citationG s
�"z CitationDomain.note_citationc C s& | j �|d t� �}|�| jj� d S )N� reftarget)r$ r r0 r1 r9 r% )r r3 r- r! r! r" �note_citation_referenceO s z&CitationDomain.note_citation_referencec C sD | j �� D ]\}\}}}|| jvr tjtd�|dd||fd� qd S )Nz Citation [%s] is not referenced.r r )r5 r6 r4 )r r' r$ r; r< r )r �namer% �labelidr, r! r! r" �check_consistencyS s
���z CitationDomain.check_consistencyr9 r � fromdocname�builderr �typ�target�contnodec C s, | j �|d�\}} }
|sd S t|||| |�S )N)� rK r )r �getr ) r r9 rF rG rH rI r3 rJ r% rD r, r! r! r" � resolve_xrefY s �zCitationDomain.resolve_xrefc C s, | � |||d|||�}|d u rg S d|fgS )Nr )rM )r r9 rF rG rI r3 rJ �refnoder! r! r" �resolve_any_xrefc s
z CitationDomain.resolve_any_xref)r N) �__name__�
__module__� __qualname__�__doc__rC r> �dangling_warnings�propertyr �strr �intr r r$ r. r r2 r
r r@ r rB rE r r rM rO r! r! r! r" r sF �"
����
�
����r c @ �& e Zd ZdZdZdeddfdd�ZdS )�CitationDefinitionTransformz3Mark citation definition labels as not smartquoted.�k �kwargsr Nc K sX t t| j�d��}| j�tj�D ]}| jj|d< |� |� t tj
|d �}d|d< qd S )Nr r% r F�support_smartquotes) r r r9 �
get_domain�document�traverser
r r% r@ r> )r r[ �domainr3 r> r! r! r" �applyq s
�z!CitationDefinitionTransform.apply�rP rQ rR rS �default_priorityr ra r! r! r! r" rY m s rY c @ rX )�CitationReferenceTransformz|
Replace citation references by pending_xref nodes before the default
docutils transform tries to resolve them.
rZ r[ r Nc
K s� t t| j�d��}| j�tj�D ]1}|�� }t |dd|dd|d |�
dg �d�}|t� |d| �7 }t ||� |�
|� |�|� qd S ) Nr r TFr7 �classes)� refdomain�reftyperA �refwarnr\ r7 re z[%s])r r r9 r] r^ r_ r
�citation_referencer8 r rL �inliner � replace_selfrB )r r[ r` r3 rI r r! r! r" ra � s
�
�z CitationReferenceTransform.applyrb r! r! r! r" rd } s rd �appr r c C s, | � t� | �t� | �t� ddddd�S )N�builtin� T)�version� env_version�parallel_read_safe�parallel_write_safe)�
add_domainr �
add_transformrY rd )rl r! r! r" �setup� s
�ru N))rS �typingr r r r r r r r �docutilsr
�docutils.nodesr �sphinx.addnodesr �sphinx.domainsr
�
sphinx.localer �sphinx.transformsr � sphinx.utilr �sphinx.util.nodesr r �sphinx.applicationr �sphinx.buildersr �sphinx.environmentr � getLoggerrP r; r rY rd rV ru r! r! r! r" �<module> s& (
M