| Server IP : 127.0.0.1 / Your IP : 216.73.216.109 Web Server : Apache/2.4.54 (Win64) OpenSSL/1.1.1q PHP/8.1.10 System : Windows NT DESKTOP-E5T4RUN 10.0 build 19045 (Windows 10) AMD64 User : SERVERWEB ( 0) PHP Version : 8.1.10 Disable Function : NONE MySQL : OFF | cURL : ON | WGET : OFF | Perl : OFF | Python : OFF | Sudo : OFF | Pkexec : OFF Directory : C:/cygwin64/lib/python3.9/site-packages/sphinx/ext/__pycache__/ |
Upload File : |
a
�ab�5 � @ s$ 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�Z1ee2e2e e2 d�dd�Z3ee4d�dd�Z5eedd�d d �Z6ee e
e2 e dd �d d �Z7ee e2dd!�d"d#�Z8G d$d%� d%e&�Z9ee eee e d&�d'd(�Z:ee2e e2 d)�d*d+�Z;ee2e4d)�d,d-�Z<ee e
e2ee2ef e2f ddf d.�d/d0�Z=eee2ef d.�d1d2�Z>dS )3z�
sphinx.ext.viewcode
~~~~~~~~~~~~~~~~~~~
Add links to module code in Python object descriptions.
:copyright: Copyright 2007-2022 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_refnodeZ_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! �7/usr/lib/python3.9/site-packages/sphinx/ext/viewcode.pyr ' s r )�app�modname� attribute�returnc
C sx z t ||�W S ty. t�d||� Y d S tyr } z.t�t�� �� � t�d||� W Y d }~d S d }~0 0 d S )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 r/ )�builderr& c C s< | j dkrdS | jdkr dS | j�d�r4| jjs4dS dS d S )N�htmlFZ
singlehtmlZepubT)�format�name�
startswith�config�viewcode_enable_epub)r0 r! r! r" �is_supported_builderB s
r7 )r# �doctreer& c s � j j�t�d�si �_tttttd�� �fdd� }t|�tj ��D ]�}|�
d�dkrXqDt � }|D ]�}t |tj
�stqb|�
d�}|�
d�}|}�jjr�� �d ||�} | s�t� ||�} | }|s�qb|�
d�}|||�j|�s�qb||v r�qb|�|� t�t|�d
d ��}
|t|
|�jd �7 }qbqDd S )
N�_viewcode_modules)r$ �fullname�docname�refnamer& c s� �j �| d �}|du rdS � �d| �}|d u rrzt�| �}|�� W n tyb d�j | < Y dS 0 |j}|j}n|\}}|d u s�|d |kr�||i |f}|�j | < |\} }}
} ||v r�||
|< dS dS )NF�viewcode-find-sourcer T) r9 �get�emit_firstresultr Z
for_moduleZ find_tagsr* �code�tags) r$ r: r; r< �entryZ code_tagsZanalyzerr@ rA r �used�r# �envr! r" �has_tagR s,
z doctree_read.<locals>.has_tag�domain�py�moduler: �viewcode-follow-imported�.�/)� reftarget�refid�refdoc)r0 rE �hasattrr9 �str�bool�list�findallr Zdescr> �set�
isinstanceZdesc_signaturer5 � viewcode_follow_imported_membersr? r/ r; �add� posixpath�join�OUTPUT_DIRNAME�replacer ) r# r8 rF Zobjnode�namesZsignoder$ r: r< Z new_modname�pagenamer! rD r" � doctree_readM s>
�
r_ )r# rE �docnames�otherr& c C s� t |d�sd S t |d�s i |_|j�� D ]\\}}||jvrF||j|< q(|j| r(|j| d }|d �� D ]\}}||vrj|||< qjq(d S )Nr9 � )rP r9 �items) r# rE r` ra r$ rB rC r: r; r! r! r" �env_merge_info� s
rd )r# rE r; r& c C sv t |di �}t|�� �D ]X\}}|du r*q|\}}}} t|�D ]}
||
|kr>|�|
� q>t|�dkr|�|� qd S )Nr9 Fr )�getattrrS rc �pop�len) r# rE r; �modulesr$ rB r@ rA rC r< r: r! r! r" �
env_purge_doc� s ri c @ s@ e Zd ZdZdZedd�dd�Zdd�dd �Zdd�d
d �ZdS ) �ViewcodeAnchorTransformz;Convert or remove viewcode_anchor nodes depends on builder.�d N)�kwargsr& c K s" t | jj�r| �� n| �� d S �N)r7 r# r0 �convert_viewcode_anchors�remove_viewcode_anchors)�selfrl r! r! r" �run� s
zViewcodeAnchorTransform.run)r& c C sV | j �t�D ]D}tjdtd�dgd�}t| jj|d |d |d |�}|� |� q d S )N� z[source]z
viewcode-link)�classesrO rM rN )
�documentrT r r Zinliner r r# r0 Z replace_self)rp �node�anchorZrefnoder! r! r" rn � s �z0ViewcodeAnchorTransform.convert_viewcode_anchorsc C s& t | j�t��D ]}|j�|� qd S rm )rS rt rT r �parent�remove)rp ru r! r! r" ro � s z/ViewcodeAnchorTransform.remove_viewcode_anchors) r r r r Zdefault_priorityr rq rn ro r! r! r! r" rj � s
rj )r# rE ru �contnoder& c C s: |d dkr6t �dt� t| j|d |d |d |�S d S )NZreftypeZviewcodezTviewcode extension is no longer use pending_xref node. Please update your extension.rO rM rN )�warnings�warnr r r0 )r# rE ru ry r! r! r" �missing_reference� s ��r| )r# r$ r& c C sB | � d|�}|rdS zt�|�\}}|W S ty< Y dS 0 dS )z"Get module filename for *modname*.r= N)r? r Zget_module_sourcer* )r# r$ Z source_info�filename�sourcer! r! r" �get_module_filename� s r c C sz t | |�}|du rdS tt| j�}|�dd�|j }t�| jd|�}z t� |�t� |�kr`W dS W n t
yt Y n0 dS )z*Check generation of module page is needed.NTrK rL z _modules/F) r r
r r0 r\ Z
out_suffixr rZ Zoutdir�getmtime�IOError)r# r$ Zmodule_filenamer0 �basenameZ
page_filenamer! r! r" �should_generate_module_page� s
r� )r# r& c
c s, | j j}t|d�sd S t| j �s$d S | j j}| j j}t|j�}tt |j�
� �t d�dt |j�| j
dd� �D �]�\}}|szqjt| |�s�qj|\}}} }
t�t|�dd��} |jjdv r�|jj} nd } |j|| d
d �}
|
�� }|d �d
�\}}|d
|g|d d�< t |�d }| �
� D ]f\}}|| \}}}|| |�d |
d | }d||td�f || ||< |t||� d7 < �qg }|}d|v �r�|�dd�d }||v �r�|�|| t�t|�dd���|d�� �q�|�|| t�td��td�d�� |� � ||td�| d�|� d�}| |dfV qj|�s0d S dg}dg} t |�D ]�}|� | d ��rr| �|d � |�d � n<| � � |� | d ��s�| � � |�d � �qz| �|d � |�d |t�td�t�t|�dd���|f � �qD|�d t | �d � td �td �d�|� d!�}t�td�|dfV d S )"Nr9 z highlighting module code... Zbluec S s | d S )Nr r! )�xr! r! r" �<lambda> � z collect_pages.<locals>.<lambda>rK rL )Zpython3�defaultZnoneZpythonF)Zlinenosr 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.htmlrr ���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� ) r0 rE rP r7 � highlighterZget_relative_urirU r9 r �sortedrc r rg � verbosityr� rY rZ r[ r\ r5 Zhighlight_languageZhighlight_block�
splitlines�splitr �min�rsplit�append�reverser4 rf ) r# rE r� Zurito�modnamesr$ rB r@ rA rC r< r^ ZlexerZ highlighted�lines�beforeZafterZmaxindexr3 r; �type�start�endZbacklinkr� rw �contextr1 �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 )NZviewcode_importFr6 rW Tz doctree-readzenv-merge-infoz
env-purge-doczhtml-collect-pageszmissing-referencer= rJ r� )�versionZ env_versionZparallel_read_safe) Zadd_config_valueZconnectr_ rd ri r� r| Z add_eventZadd_post_transformrj �sphinxZ__display_version__)r# r! r! r" �setupX s
�r� )?r rY r+ rz �osr �typingr r r r r r r r
Zdocutilsr Zdocutils.nodesr r
r� r Zsphinx.applicationr Zsphinx.buildersr Zsphinx.builders.htmlr Zsphinx.deprecationr Zsphinx.environmentr Z
sphinx.localer r Z
sphinx.pycoder Z!sphinx.transforms.post_transformsr Z sphinx.utilr r r Zsphinx.util.nodesr Z getLoggerr r( r[ r rQ r/ rR r7 r_ rd ri rj r| r r� r� r� r! r! r! r" �<module> sJ
(
@
� �
,d