| 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
�abUj �
@ s� d dl Zd dlZd dlZd dlZd dlZd dlZd dlmZ d dl m
Z
d dl m Z m
Z
mZmZmZmZmZ d dlmZmZ d dlmZ d dlmZmZmZm Z d dl m Z m Z d dl Z d d l!m"Z" d d
l#m$Z$ d d l%m&Z& d d l'm(Z( d d
l)m*Z* d dl+m,Z, d dl-m.Z. d dl/m0Z0m1Z1 d dl2m3Z3 d dl4m5Z5m6Z6 d dl7m8Z8m9Z9 d dl:m;Z; d dl<m=Z=m>Z>m?Z? e5�@eA�ZBG dd� d�ZCeDeDd�dd�ZEdXeDe(e d�d d �ZFeDeDd�d d �ZGe$eDe
e
d �d!d"�ZHeDeDe
e
e
eIeJd#�d$d%�ZKe$dd&�d'd(�ZLe*eeD e>e"eed)�d*d+�ZMeeD e=e*eeD eDe"eee d,�d-d.�ZNe,eeD e=eJe*eeD e"eee d/� d0d1�ZOe,eeD e=eJe"eee d2�d3d4�ZPe,eDeJd5�d6d7�ZQe,eDe"eee d8�d9d:�ZRe,eJe"eee d;�d<d=�ZSe,e"eee d>�d?d@�ZTe$e,e"eee dA�dBdC�ZUG dDdE� dEe8�ZVG dFdG� dGe9�ZWG dHdI� dIe3�ZXe$eDeeD ddJ�dKdL�ZYe$e(ddM�dNdO�ZZe$eeDe
f d&�dPdQ�Z[eeD ddR�dSdT�Z\eAdUk�r�d dl5Z]e]�^� e\ej_dVd� dW� dS )Y� N)�path)�
ModuleType)�IO�Any�Dict�List�Optional�Tuple�cast)�urlsplit�
urlunsplit)�nodes)�Element�Node� TextElement�system_message)�Reporter�
relative_path)� pending_xref)�Sphinx)�INVENTORY_FILENAME)�Config)�Domain)�BuildEnvironment)�ExtensionError)�_�__)�ReferencesResolver)�logging�requests)�CustomReSTDispatcher�
SphinxRole)�
InventoryFile)� Inventory�
InventoryItem� RoleFunctionc @ sz e Zd Zedd�dd�Zeeeeee e
f f d�dd��Z ee
d�dd ��Z eeee
f d�d
d ��Z
dd�d d
�ZdS )�InventoryAdapterN)�env�returnc C s, || _ t|d�s(i | j _i | j _i | j _d S )N�intersphinx_cache)r' �hasattrr) �intersphinx_inventory�intersphinx_named_inventory)�selfr' � r. �:/usr/lib/python3.9/site-packages/sphinx/ext/intersphinx.py�__init__> s
zInventoryAdapter.__init__�r( c C s | j jS �N)r' r) �r- r. r. r/ �cacheF s zInventoryAdapter.cachec C s | j jS r2 )r' r+ r3 r. r. r/ �main_inventoryJ s z InventoryAdapter.main_inventoryc C s | j jS r2 )r' r, r3 r. r. r/ �named_inventoryN s z InventoryAdapter.named_inventoryc C s | j j�� | j j�� d S r2 )r' r+ �clearr, r3 r. r. r/ r7 R s zInventoryAdapter.clear)�__name__�
__module__� __qualname__r r0 �propertyr �strr �intr# r4 r5 r6 r7 r. r. r. r/ r& ; s "r& )�urlr( c C s6 t t| ��}d|d v r.|d �d�d |d< t|�S )N�@� )�listr �splitr )r> �fragsr. r. r/ �_strip_basic_authW s rD )r> �configr( c C sB t j| d||jd�}|�� |j|j_tj|jjdd�|j_|jS )NT)�streamrE �timeout)Zdecode_content) r �get�intersphinx_timeoutZraise_for_statusr> �raw� functools�partial�read)r> rE �rr. r. r/ �_read_from_urll s
rO c C s^ t | �}|jd u r| S t|�}|jr>d�|j|j|j�|d< nd�|j|j�|d< t|�S d S )Nz{}@{}:{}r@ z{}@{})r �usernamerA �port�format�hostnamer )r> �partsrC r. r. r/ �
_get_safe_url� s
rU )�app�uri�invr( c
C s� d|v}|st |�}z0d|v r.t|| jd�}ntt�| j|�d�}W n: ty~ } z"d||jt |�f|_
� W Y d }~n
d }~0 0 z�t |d�r�|j }||kr�t
�td�||� ||t�|�t�|�d fv r�t�|�}|�h z"|r�tjntj}t�|||�}W n4 t�y0 } ztd| �| �W Y d } ~ n
d } ~ 0 0 W d � n1 �sH0 Y W n> t�y� } z$d ||jjt |�f|_
� W Y d }~nd }~0 0 |S d S )
N�://)rE �rbz4intersphinx inventory %r not fetchable due to %s: %sr> z)intersphinx inventory has moved: %s -> %s�/z,unknown or unsupported inventory version: %rz3intersphinx inventory %r not readable due to %s: %s)rD rO rE �openr �join�srcdir� Exception� __class__r< �argsr* r> �logger�infor �dirname� posixpathr" �load�
ValueErrorr8 )
rV rW rX Zlocaluri�f�errZnewinvr] �invdata�excr. r. r/ �fetch_inventory� s> �
H�rl )�namerW �invsr4 rV �nowr( c C s� ||j jd }g }�z |D �] }|s2t�|t�}d|vsR||vsR|| d |k r t|�} t�td�| � zt |||�}
W n< t
y� } z$|� | j � W Y d } ~ q W Y d } ~ n
d } ~ 0 0 |
r | ||
f||< W |g kr�nbt
|�t
|�k �rt�td�� |D ]} tj| � � q�n*d�dd� |D ��}
t�td �d |
� d
S q W |g k�rNnbt
|�t
|�k �r�t�td�� |D ]} tj| � �qrn*d�dd� |D ��}
t�td �d |
� d S t
|�t
|�k �r�t�td�� |D ]} tj| � �q�n*d�dd� |D ��}
t�td �d |
� np|g k�r$nbt
|�t
|�k �r\t�td�� |D ]} tj| � �qHn*d�dd� |D ��}
t�td �d |
� 0 d S ) Ni�Q rY r@ z(loading intersphinx inventory from %s...zXencountered some issues with some of the inventories, but they had working alternatives:�
c S s g | ]}|d |dd� �qS )r r@ Nr. ��.0rh r. r. r/ �
<listcomp>� � z)fetch_inventory_group.<locals>.<listcomp>zAfailed to reach any of the inventories with the following issues:TF)rE �intersphinx_cache_limitre r] r rU rb rc r rl r_ �appendra �len�warning)rm rW rn r4 rV ro Z
cache_timeZfailuresrX Z safe_inv_urlrj ri ZfailZissuesr. r. r/ �fetch_inventory_group� s�
"
���
���
���
��ry )rV r( c
C s t t�� �}t| jj�}tj�� �b}g }| jj �
� D ]*\}\}}|� |� t
||||j| |�� q4dd� tj�|�D �}W d � n1 s�0 Y t|��r |�� t|j�
� �} tdd� | D ��}
dd� | D �} |
| D ]>\}} }
|r�|
|j|< |
�� D ] \}}|j�|i ��|� q�q�d S )Nc S s g | ] }|� � �qS r. )�resultrq r. r. r/ rs � rt z!load_mappings.<locals>.<listcomp>c s s | ]}|d r|V qdS )r Nr. �rr �vr. r. r/ � <genexpr> rt z load_mappings.<locals>.<genexpr>c S s g | ]}|d s|�qS )r r. r{ r. r. r/ rs rt )r= �timer& Zbuilderr' �
concurrent�futuresZThreadPoolExecutorrE �intersphinx_mapping�valuesrv Zsubmitry r4 Z as_completed�anyr7 rA �sortedr6 �itemsr5 �
setdefault�update)rV ro Z inventoriesZpoolr� rm rW rn �updatedZ cached_valsZ
named_valsZ unnamed_valsZ_xrj �typeZobjectsr. r. r/ �
load_mappings� s& �4
r� )�domain�inv_name�data�node�contnoder( c C s |\}}}}d|vr4|� d�r4t�t|d d�|�}|rJtd�||f } ntd�|f } tjddd|| d�}
|� d �r�|
�|� n�|d
ks�| jd kr�|d d
kr�|� � } |d ur�| �
|d �r�|
�|� | t |�d d � | t |�d d � �� n
|
�|� n|
�|� ||�� |
S )NrY Zrefdoc�.z (in %s v%s)z(in %s)� F)ZinternalZrefuri�reftitleZ refexplicit�-�std�reftype�keyword�:r@ )
rH r r] r r r
Z referencerv rm Zastext�
startswithr` rw ) r� r� r� r� r� Zproj�versionrW Zdispnamer� �newnode�titler. r. r/ �_create_element_from_result s,
�
�� r� )r� � inventoryr� �objtypes�targetr� r� r( c
s� |D ]�}||vrq||| v r,|| | }nJ|dkr|� � � tt� fdd�|| �� ��} | r|| | d }qvqnqt|| |||� S d S )Nzstd:termc s | � � � kS r2 )�lower)�k�Z target_lowerr. r/ �<lambda>9 rt z8_resolve_reference_in_domain_by_target.<locals>.<lambda>r )r� rA �filter�keysr� )
r� r� r� r� r� r� r� Zobjtyper� Zinsensitive_matchesr. r� r/ �&_resolve_reference_in_domain_by_target) s
�r� ) r' r� r� �honor_disabled_refsr� r� r� r� r( c
s� �j dkr d|v r |�d� �j dkr8d|v r8|�d� �fdd�|D �}|rh| jj� � fd d�|D �}t||�||d
||�}|d ur�|S ��|�} | d u r�d S t||�|| ||�S ) Nr� Z cmdoption�option�pyZ attribute�methodc s g | ]}d � � j|��qS )z{}:{})rR rm )rr �t)r� r. r/ rs X rt z0_resolve_reference_in_domain.<locals>.<listcomp>c s g | ]}|� vr|�qS r. r. )rr �o)�disabledr. r/ rs ] rt � reftarget)rm rv rE � intersphinx_disabled_reftypesr� Zget_full_qualified_name)
r' r� r� r� r� r� r� r� �resZfull_qualified_namer. )r� r� r/ � _resolve_reference_in_domainI s&
�
�r� )r' r� r� r� r� r� r( c
C s� |o
|d u }|r d| j jv r d S |d }|dkr�| j�� D ]N\}}|rX|d | j jv rXq:t|j�} t| ||||| ||�}
|
d ur:|
S q:d S |�d�}|s�d S |r�|d | j jv r�d S | �|�}|� |�} | s�d S t| ||||| ||�S d S )N�*r� r� z:*� refdomain)
rE r� Zdomainsr� rA Z object_typesr� rH �
get_domainZobjtypes_for_role) r' r� r� r� r� r� �typ� domain_namer� r� r� r. r. r/ �_resolve_referencem sF �
�
�
�r� )r' r� r( c C s |t | �jv S r2 )r& r6 )r' r� r. r. r/ �inventory_exists� s r� )r' r� r� r� r( c C s t | |t| �j| d||�S )NF)r� r& r6 )r' r� r� r� r. r. r/ � resolve_reference_in_inventory� s �r� )r' r� r� r� r( c C s t | d t| �j|||�S r2 )r� r& r5 )r' r� r� r� r. r. r/ � resolve_reference_any_inventory� s �r� )r' r� r� r( c C sn t | d||�}|d ur|S |d }d|vr.d S |�dd�\}}t| |�sLd S ||d< t| |||�}||d< |S )NTr� r� r@ )r� rB r� r� )r' r� r� r� r� r� Z newtargetZres_invr. r. r/ �"resolve_reference_detect_inventory� s
r� )rV r' r� r� r( c C s t |||�S r2 )r� )rV r' r� r� r. r. r/ �missing_reference� s r� c s6 e Zd Zeeeeeee e
f d�� fdd� Z � Z S )�IntersphinxDispatcher)� role_name�language_module�lineno�reporterr( c s8 t |�dkr"|�d�r"t|�g fS t� �||||�S d S )N� )z external:z external+)rw r� �IntersphinxRole�super�role)r- r� r� r� r� �r` r. r/ r� � s zIntersphinxDispatcher.role)
r8 r9 r: r< r r= r r r% r r r� �
__classcell__r. r. r� r/ r� � s �r� c @ s� e Zd Ze�d�Zedd�dd�Zee e
e e f d�dd�Z eee
e ef d �d
d �Zee
eeef d �d d
�Zeeed�dd�Zeeef ee e
e e f d�dd�ZdS )r� z(\+([^:]+))?:(.*)N)� orig_namer( c C s
|| _ d S r2 )r� )r- r� r. r. r/ r0 � s zIntersphinxRole.__init__r1 c C s� | � | j�\}}|rFt| j|�sFtjtd�|| jj| jfd� g g fS | � |�}|d u r~tjtd�|| jj| jfd� g g fS | �
|�\}}|D ] }t |t �r�d|d< ||d< q�||fS )Nz4inventory for external cross-reference not found: %s)�locationz/role for external cross-reference not found: %sT� intersphinxr� )
� get_inventory_and_name_suffixr� r� r' rb rx r �docnamer� �
get_role_name� invoke_role�
isinstancer )r- r� Z name_suffixr� rz �messagesr� r. r. r/ �run� s$
�
�
zIntersphinxRole.run)rm r( c C s" t j�|d��dd�\}}||fS )N� � � )r� � _re_inv_ref� fullmatch�group)r- rm rX �suffixr. r. r/ r� s z-IntersphinxRole.get_inventory_and_name_suffixc C s� |� d�}t|�dkr<| jj�d�}|r.|jnd }|d }n"t|�dkrZ|d }|d }nd S |rv| �||�rv||fS | �d|�r�d|fS d S d S )Nr� r@ �default_domainr r� r� )rB rw r' Z temp_datarH rm �is_existent_role)r- rm �namesr� r� r� r. r. r/ r� s
z IntersphinxRole.get_role_name)r� r� r( c C s@ z&| j �|�}||jv r W dS W dS W n ty: Y dS 0 d S )NTF)r' r� Zrolesr )r- r� r� r� r. r. r/ r� ( s
z IntersphinxRole.is_existent_role)r� r( c C sT | j �|d �}|rH|�|d �}|d�|�| j| j| j| j| j| j �S g g fS d S )Nr r@ r� )
r' r� r� r] Zrawtext�textr� Zinliner�optionsZcontent)r- r� r� Z role_funcr. r. r/ r� 2 s �zIntersphinxRole.invoke_role)r8 r9 r: �re�compiler� r< r0 r r r r r� r r� r� �boolr� r� r. r. r. r/ r� � s
r� c @ s& e Zd Zejd Zedd�dd�ZdS )�IntersphinxRoleResolverr@ N)�kwargsr( c K s� | j �t�D ]�}d|vrq ttj|d �� �}|d }|d urPt| j|||�}nt | jd||�}|d u r�|d }t
d�|d ||d f }t j ||d |d
� |�
|� q |�
|� q d S ) Nr� r r� Fr� z-external %s:%s reference target not found: %sr� r� �ref)r� r� Zsubtype)ZdocumentZtraverser r
r
r Zdeepcopyr� r' r� r rb rx Z replace_self)r- r� r� r� r� r� r� �msgr. r. r/ r� E s � zIntersphinxRoleResolver.run)r8 r9 r: r Zdefault_priorityr r� r. r. r. r/ r� = s
r� )rV r� �sourcer( c C s t � }|�� d S r2 )r� Zenable)rV r� r� �
dispatcherr. r. r/ �install_dispatcherZ s r� )rV rE r( c C s� |j �� �� D ]�\}}z�t|ttf�r`|| }\}}t|t�spt�t d�|� |j �
|� W qnd || }}}t|t�s�|||fff|j |< n|||ff|j |< W q t y� } z*t�t d�||� |j �
|� W Y d }~qd }~0 0 qd S )Nz0intersphinx identifier %r is not string. Ignoredz3Failed to read intersphinx_mapping[%s], ignored: %r) r� �copyr� r� rA �tupler< rb rx r �popr_ )rV rE �key�valuerm rW rX rk r. r. r/ � normalize_intersphinx_mappingd s"
�
r� c C s� | � di d� | � ddd� | � dd d� | � dg d� | jdtd d
� | �d t� | �d t� | �d
t� | �t� tj ddd�S )Nr� Tru � FrI r� z
config-initedi )�priorityzbuilder-initedz source-readzmissing-referencer@ )r� Z env_versionZparallel_read_safe)
Zadd_config_valueZconnectr� r� r� r� Zadd_post_transformr� �sphinxZ__display_version__)rV r. r. r/ �setup| s
�r� )�argvr( c
s8 t | �dk r$tdtjd� t�d� G dd� d�� G � fdd�d�}z|| d }t|� d |�}t|pdi �D ]T}t|� t|| �� �D ]6\}}td
||d d kr�d
|d nd |d f � q�qhW nr t�y } z(t|j d |j dd � � W Y d }~n:d }~0 t
�y2 } ztd| � W Y d }~n
d }~0 0 d S )Nr@ zXPrint out an inventory file.
Error: must specify local path or URL to an inventory file.��filec @ s" e Zd ZU dZeed< dZdZdS )z inspect_main.<locals>.MockConfigNrI F)r8 r9 r: rI r= �__annotations__Z
tls_verifyZ
user_agentr. r. r. r/ �
MockConfig� s
r� c s& e Zd ZdZ� � Zedd�dd�ZdS )z inspect_main.<locals>.MockAppr� N)r� r( c S s t |tjd� d S )Nr� )�print�sys�stderr)r- r� r. r. r/ �warn� s z"inspect_main.<locals>.MockApp.warn)r8 r9 r: r^ rE r< r� r. �r� r. r/ �MockApp� s r� r r� z %-40s %s%sr� r� z%-40s: r� zUnknown error: %r) rw r� r� r� �exitrl r� r� rg ra r_ )r� r� �filenamerj r� �entryZeinfork r. r� r/ � inspect_main� s* �
�0r �__main__r@ )r� )N)`�concurrent.futuresr rK re r� r� r~ �osr �typesr �typingr r r r r r r
� urllib.parser r Zdocutilsr
Zdocutils.nodesr r r r Zdocutils.utilsr r r� Zsphinx.addnodesr Zsphinx.applicationr Zsphinx.builders.htmlr Z
sphinx.configr Zsphinx.domainsr Zsphinx.environmentr Z
sphinx.errorsr Z
sphinx.localer r Z!sphinx.transforms.post_transformsr Z sphinx.utilr r Zsphinx.util.docutilsr r! Zsphinx.util.inventoryr" Zsphinx.util.typingr# r$ r% Z getLoggerr8 rb r& r< rD rO rU rl �floatr� ry r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r Z_loggingZ basicConfigr� r. r. r. r/ �<module> s� $
( � %!�
� � $
� )� �
� � U
#