File: //usr/lib/python3/dist-packages/sphinx/ext/__pycache__/viewcode.cpython-310.pyc
o
�$�a�5 � @ sR 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)�-e.�Z/dZ0G dd� de�Z1dede2de2de e2 fdd�Z3dede4fd d �Z5ded eddfd d �Z6ded!e d"e
e2 d#e ddf
d$d%�Z7ded!e d&e2ddfd'd(�Z8G d)d*� d*e&�Z9ded!e d+ed,ede e f
d-d.�Z:dede2de e2 fd/d0�Z;dede2de4fd1d2�Z<dede e
e2ee2ef e2f ddf fd3d4�Z=dedee2ef fd5d6�Z>dS )7z�
sphinx.ext.viewcode
~~~~~~~~~~~~~~~~~~~
Add links to module code in Python object descriptions.
:copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS.
:license: BSD, see LICENSE for details.
� 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_refnode�_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/usr/lib/python3/dist-packages/sphinx/ext/viewcode.pyr ' s r �app�modname� attribute�returnc
C st zt ||�W S ty t�d||� Y d S ty9 } zt�t�� �� � t�d||� W Y d }~d S d }~ww )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_modname0 s ��r0 �builderc C s8 | j dkrdS | jdkrdS | j�d�r| jjsdS dS )N�htmlF�
singlehtml�epubT)�format�name�
startswith�config�viewcode_enable_epub)r1 r" r" r# �is_supported_builderB s
r: �doctreec
s$ � j j�t�d�s i �_dtdtdtdtdtf
� �fdd� }t|�tj ��D ]i}|�
d �d
kr0q&t � }|D ]Y}t |tj
�s>q5|�
d �}|�
d�}|}�jjr_� �d ||�} | s]t� ||�} | }|sbq5|�
d�}|||�j|�spq5||v ruq5|�|� t�t|�d
d��}
|t|
|�jd�7 }q5q&d S )N�_viewcode_modulesr% �fullname�docname�refnamer' c s� �j �| d �}|du r
dS � �d| �}|d u r9z t�| �}|�� W n ty1 d�j | < Y dS w |j}|j}n|\}}|d u sG|d |krR||i |f}|�j | < |\} }}
} ||v rb||
|< dS dS )NF�viewcode-find-sourcer T) r< �get�emit_firstresultr �
for_module� find_tagsr+ �code�tags) r% r= r> r? �entry� code_tags�analyzerrE rF r �used�r$ �envr" r# �has_tagR s.
�
z doctree_read.<locals>.has_tag�domain�py�module�viewcode-follow-imported�.�/)� reftarget�refid�refdoc)r1 rL �hasattrr< �str�bool�list�traverser �descrA �set�
isinstance�desc_signaturer8 � viewcode_follow_imported_membersrB r0 r> �add� posixpath�join�OUTPUT_DIRNAME�replacer ) r$ r; rM �objnode�names�signoder% r= r? � new_modname�pagenamer" rK r# � doctree_readM sB
$
�
��rk rL �docnames�otherc C s� t |d�sd S t |d�si |_|j�� D ].\}}||jvr#||j|< q|j| rB|j| d }|d �� D ] \}}||vrA|||< q5qd S )Nr< � )rW r< �items) r$ rL rl rm r% rG rJ r= r> r" r" r# �env_merge_info� s
��rp r> c C sv t |di �}t|�� �D ],\}}|du rq |\}}}} t|�D ]
}
||
|kr,|�|
� q t|�dkr8|�|� q d S )Nr< Fr )�getattrrZ ro �pop�len) r$ rL r> �modulesr% rG rE rF rJ r? r= r" r" r# �
env_purge_doc� s
�
��ru c @ s: e Zd ZdZdZdeddfdd�Zd dd �Zd d
d �ZdS )
�ViewcodeAnchorTransformz;Convert or remove viewcode_anchor nodes depends on builder.�d �kwargsr' Nc K s$ t | jj�r | �� d S | �� d S �N)r: r$ r1 �convert_viewcode_anchors�remove_viewcode_anchors)�selfrx r" r" r# �run� s zViewcodeAnchorTransform.runc C sV | j �t�D ]"}tjdtd�dgd�}t| jj|d |d |d |�}|� |� qd S )N� z[source]z
viewcode-link)�classesrV rT rU )
�documentr[ r r �inliner r r$ r1 � replace_self)r| �node�anchor�refnoder" r" r# rz � s � �z0ViewcodeAnchorTransform.convert_viewcode_anchorsc C s& t | j�t��D ]}|j�|� qd S ry )rZ r� r[ r �parent�remove)r| r� r" r" r# r{ � s �z/ViewcodeAnchorTransform.remove_viewcode_anchors)r' N) r r r r! �default_priorityr r} rz r{ r" r" r" r# rv � s
rv r� �contnodec C s: |d dkrt �dt� t| j|d |d |d |�S d S )N�reftype�viewcodezTviewcode extension is no longer use pending_xref node. Please update your extension.rV rT rU )�warnings�warnr r r1 )r$ rL r� r� r" r" r# �missing_reference� s ��r� c C s> | � d|�}|r
dS z
t�|�\}}|W S ty Y dS w )z"Get module filename for *modname*.r@ N)rB r �get_module_sourcer+ )r$ r% � source_info�filename�sourcer" r" r# �get_module_filename� s �r� c C sz t | |�}|du r dS tt| j�}|�dd�|j }t�| jd|�}zt� |�t� |�kr0W dS W dS t
y< Y dS w )z*Check generation of module page is needed.NTrR rS z _modules/F) r� r
r r1 re �
out_suffixr rc �outdir�getmtime�IOError)r$ r% �module_filenamer1 �basename�
page_filenamer" r" r# �should_generate_module_page� s
� ��r� c
c s6 � | j j}t|d�s d S t| j �sd S | j j}| j j}t|j�}tt |j�
� �t d�dt |j�| j
dd� �D ]�\}}|s=q6t| |�sCq6|\}}} }
t�t|�dd��} |jjdv r^|jj} nd } |j|| d
d �}
|
�� }|d �d
�\}}|d
|g|d d�< t |�d }| �
� D ]2\}}|| \}}}|| |�d |
d | }d||td�f || ||< |t||� d7 < q�g }|}d|v r�|�dd�d }||v r�|�|| t�t|�dd���|d�� d|v s�|�|| t�td��td�d�� |� � ||td�| d�|� d�}| |dfV q6|�sd S dg}dg} t |�D ]T}|� | d ��r8| �|d � |�d � n$| � � |� | d ��sU| � � |�d � |� | d ��rD| �|d � |�d |t�td�t�t|�dd���|f � �q!|�d t | �d � td �td �d�|� d!�}t�td�|dfV d S )"Nr< z highlighting module code... �bluec S s | d S )Nr r" )�xr" r" r# �<lambda> s z collect_pages.<locals>.<lambda>rR rS )�python3�default�none�pythonF)�linenosr 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.htmlr~ ���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� ) r1 rL rW r: � highlighter�get_relative_urir] r< r �sortedro r rs � verbosityr� rb rc rd re r8 �highlight_language�highlight_block�
splitlines�splitr �min�rsplit�append�reverser7 rr ) r$ rL r� �urito�modnamesr% rG rE rF rJ r? rj �lexer� highlighted�lines�before�after�maxindexr6 r> �type�start�end�backlinkr� r� �contextr2 �stackr" r" r# �
collect_pages� s� �
�
�������
��
� � ���r� c C s� | � dd d� | � ddd� | � ddd� | �dt� | �dt� | �dt� | �d t� | �d
t� | �d � | �d � | �t � t
j d
dd�S )N�viewcode_importFr9 r` Tz doctree-readzenv-merge-infoz
env-purge-doczhtml-collect-pageszmissing-referencer@ rQ r� )�version� env_version�parallel_read_safe) �add_config_value�connectrk rp ru r� r� � add_event�add_post_transformrv �sphinx�__display_version__)r$ r" r" r# �setupX s
�r� )?r! rb r, r� �osr �typingr r r r r r r r
�docutilsr �docutils.nodesr r
r� r �sphinx.applicationr �sphinx.buildersr �sphinx.builders.htmlr �sphinx.deprecationr �sphinx.environmentr �
sphinx.localer r �
sphinx.pycoder �!sphinx.transforms.post_transformsr � sphinx.utilr r r �sphinx.util.nodesr � getLoggerr r) rd r rX r0 rY r: rk rp ru rv r� r� r� r� r� r" r" r" r# �<module> sP
(
@�
�
�
. d