| 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 Z ddlZddlZddlZddlZddlZddlZddlm Z ddl
m Z ddl m
Z
mZmZmZmZmZmZ ddlmZmZ ddlmZ ddlmZmZm Z m Z dd l m Z m Z ddl!Z!dd
l"m#Z# dd l$m%Z% dd l&m'Z' dd
l(m)Z) ddl*m+Z+ ddl,m-Z- ddl.m/Z/ ddl0m1Z1m2Z2 ddl3m4Z4 ddl5m6Z6m7Z7 ddl8m9Z9m:Z: ddl;m<Z< ddl=m>Z>m?Z?m@Z@ e6�AeB�ZCG dd� d�ZDeEeEd�dd�ZFdYeEe)e
d �d d �ZGeEeEd�d d �ZHe%eEeed!�d"d#�ZIeEeEeeeeJeKd$�d%d&�ZLe%dd'�d(d)�ZMe+eeE e?e#e ed*�d+d,�ZNeeE e>e+eeE eEe#e ee d-�d.d/�ZOe-eeE e>eKe+eeE e#e ee d0� d1d2�ZPe-eeE e>eKe#e ee d3�d4d5�ZQe-eEeKd6�d7d8�ZRe-eEe#e ee d9�d:d;�ZSe-eKe#e ee d<�d=d>�ZTe-e#e ee d?�d@dA�ZUe%e-e#e ee dB�dCdD�ZVG dEdF� dFe9�ZWG dGdH� dHe:�ZXG dIdJ� dJe4�ZYe%eEeeE ddK�dLdM�ZZe%e)ddN�dOdP�Z[e%eeEef d'�dQdR�Z\eeE ddS�dTdU�Z]eBdVk�r�ddl6Z^e^�_� e]ej`dWd� dX� dS )Za�
sphinx.ext.intersphinx
~~~~~~~~~~~~~~~~~~~~~~
Insert links to objects documented in remote Sphinx documentation.
This works as follows:
* Each Sphinx HTML build creates a file named "objects.inv" that contains a
mapping from object names to URIs relative to the HTML set's root.
* Projects using the Intersphinx extension can specify links to such mapping
files in the `intersphinx_mapping` config value. The mapping will then be
used to resolve otherwise missing references to objects into links to the
other documentation.
* By default, the mapping file is assumed to be at the same location as the
rest of the documentation; however, the location of the mapping file can
also be specified individually, e.g. if the docs should be buildable
without Internet access.
:copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
:license: BSD, see LICENSE for details.
� 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 @ s~ e Zd ZdZedd�dd�Zeeee ee
e f f d�dd��Z ee d�d d
��Z
eeee f d�d d ��Zdd�d
d�ZdS )�InventoryAdapterz!Inventory adapter for environmentN)�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__�__doc__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 )a� Returns *url* with basic auth credentials removed. Also returns the
basic auth username and password if they're present in *url*.
E.g.: https://user:pass@example.com => https://example.com
*url* need not include basic auth credentials.
:param url: url which may or may not contain basic auth credentials
:type url: ``str``
:return: *url* with any basic auth creds removed
:rtype: ``str``
�@� )�listr �splitr )r? �fragsr. r. r/ �_strip_basic_authW s rE )r? �configr( c C sB t j| d||jd�}|�� |j|j_tj|jjdd�|j_|jS )u� Reads data from *url* with an HTTP *GET*.
This function supports fetching from resources which use basic HTTP auth as
laid out by RFC1738 § 3.1. See § 5 for grammar definitions for URLs.
.. seealso:
https://www.ietf.org/rfc/rfc1738.txt
:param url: URL of an HTTP resource
:type url: ``str``
:return: data read from resource described by *url*
:rtype: ``file``-like object
T)�streamrF �timeout)Zdecode_content) r �get�intersphinx_timeoutZraise_for_statusr? �raw� functools�partial�read)r? rF �rr. r. r/ �_read_from_urll s
rP c C s^ t | �}|jdu r| S t|�}|jr>d�|j|j|j�|d< nd�|j|j�|d< t|�S dS )a5 Gets version of *url* with basic auth passwords obscured. This function
returns results suitable for printing and logging.
E.g.: https://user:12345@example.com => https://user@example.com
:param url: a url
:type url: ``str``
:return: *url* with password removed
:rtype: ``str``
Nz{}@{}:{}rA z{}@{})r �usernamerB �port�format�hostnamer )r? �partsrD r. r. r/ �
_get_safe_url� s
rV )�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 dS ) z6Fetch, parse and return an intersphinx inventory file.�://)rF �rbz4intersphinx inventory %r not fetchable due to %s: %sNr? z)intersphinx inventory has moved: %s -> %s�/z,unknown or unsupported inventory version: %rz3intersphinx inventory %r not readable due to %s: %s)rE rP rF �openr �join�srcdir� Exception� __class__r= �argsr* r? �logger�infor �dirname� posixpathr" �load�
ValueErrorr8 )
rW rX rY Zlocaluri�f�errZnewinvr^ �invdata�excr. r. r/ �fetch_inventory� s> �
H�rm )�namerX �invsr4 rW �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 rZ rA 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 rA Nr. ��.0ri r. r. r/ �
<listcomp>� � z)fetch_inventory_group.<locals>.<listcomp>zAfailed to reach any of the inventories with the following issues:TF)rF �intersphinx_cache_limitrf r^ r rV rc rd r rm r` �appendrb �len�warning)rn rX ro r4 rW rp Z
cache_timeZfailuresrY Z safe_inv_urlrk rj ZfailZissuesr. r. r/ �fetch_inventory_group� s�
"
���
���
���
��rz )rW 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�dS )z3Load all intersphinx mappings into the environment.c S s g | ] }|� � �qS r. )�resultrr r. r. r/ rt � ru z!load_mappings.<locals>.<listcomp>Nc s s | ]}|d r|V qdS )r Nr. �rs �vr. r. r/ � <genexpr> ru z load_mappings.<locals>.<genexpr>c S s g | ]}|d s|�qS )r r. r| r. r. r/ rt ru )r> �timer& Zbuilderr' �
concurrent�futuresZThreadPoolExecutorrF �intersphinx_mapping�valuesrw Zsubmitrz r4 Z as_completed�anyr7 rB �sortedr6 �itemsr5 �
setdefault�update)rW rp Z inventoriesZpoolr� rn rX ro �updatedZ cached_valsZ
named_valsZ unnamed_valsZ_xrk �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 )NrZ Zrefdoc�.z (in %s v%s)z(in %s)� F)ZinternalZrefuri�reftitleZ refexplicit�-�std�reftype�keyword�:rA )
rI r r^ r r r
Z referencerw rn Zastext�
startswithra rx ) r� r� r� r� r� Zproj�versionrX 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 ru z8_resolve_reference_in_domain_by_target.<locals>.<lambda>r )r� rB �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{}:{})rS rn )rs �t)r� r. r/ rt X ru z0_resolve_reference_in_domain.<locals>.<listcomp>c s g | ]}|� vr|�qS r. r. )rs �o)�disabledr. r/ rt ] ru � reftarget)rn rw rF � 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)
rF r� Zdomainsr� rB Z object_typesr� rI �
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 )z�Attempt to resolve a missing reference via intersphinx references.
Resolution is tried in the given inventory with the target as is.
Requires ``inventory_exists(env, inv_name)``.
F)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 | dt| �j|||�S )z�Attempt to resolve a missing reference via intersphinx references.
Resolution is tried with the target as is in any inventory.
N)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||�}|dur|S |d }d|vr.dS |�dd�\}}t| |�sLdS ||d< t| |||�}||d< |S )ag Attempt to resolve a missing reference via intersphinx references.
Resolution is tried first with the target as is in any inventory.
If this does not succeed, then the target is split by the first ``:``,
to form ``inv_name:newtarget``. If ``inv_name`` is a named inventory, then resolution
is tried in that inventory with the new target.
TNr� r� rA )r� rC r� r� )r' r� r� r� r� r� Z newtargetZres_invr. r. r/ �"resolve_reference_detect_inventory� s
r� )rW r' r� r� r( c C s t |||�S )zBAttempt to resolve a missing reference via intersphinx references.)r� )rW r' r� r� r. r. r/ �missing_reference� s r� c s: e Zd ZdZeeeeee e
e f d�� fdd� Z � Z
S )�IntersphinxDispatcherzyCustom dispatcher for external role.
This enables :external:***:/:external+***: roles on parsing reST document.
)� role_name�language_module�lineno�reporterr( c s8 t |�dkr"|�d�r"t|�g fS t� �||||�S d S )N� )z external:z external+)rx r� �IntersphinxRole�super�role)r- r� r� r� r� �ra r. r/ r� � s zIntersphinxDispatcher.role)r8 r9 r: 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' rc ry r �docnamer� �
get_role_name� invoke_role�
isinstancer )r- r� Z name_suffixr� r{ �messagesr� r. r. r/ �run� s$
�
�
zIntersphinxRole.run)rn r( c C s" t j�|d��dd�\}}||fS )N� � � )r� � _re_inv_ref� fullmatch�group)r- rn rY �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� rA �default_domainr r� r� )rC rx r' Z temp_datarI rn �is_existent_role)r- rn �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 rA 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 ZdZejd Zedd�dd�ZdS )�IntersphinxRoleResolverz�pending_xref node resolver for intersphinx role.
This resolves pending_xref nodes generated by :intersphinx:***: role.
rA 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 rc ry Z replace_self)r- r� r� r� r� r� r� �msgr. r. r/ r� E s � zIntersphinxRoleResolver.run)r8 r9 r: r; r Zdefault_priorityr r� r. r. r. r/ r� = s
r� )rW r� �sourcer( c C s t � }|�� dS )z�Enable IntersphinxDispatcher.
.. note:: The installed dispatcher will uninstalled on disabling sphinx_domain
automatically.
N)r� Zenable)rW r� r� �
dispatcherr. r. r/ �install_dispatcherZ s r� )rW rF 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� rB �tupler= rc ry r �popr` )rW rF �key�valuern rX rY rl 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� Trv � FrJ r� z
config-initedi )�priorityzbuilder-initedz source-readzmissing-referencerA )r� Z env_versionZparallel_read_safe)
Zadd_config_valueZconnectr� r� r� r� Zadd_post_transformr� �sphinxZ__display_version__)rW 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 dS )z-Debug functionality to print out an inventoryrA 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>.MockConfigNrJ F)r8 r9 r: rJ 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_ rF r= r� r. �r� r. r/ �MockApp� s r� r r� z %-40s %s%sr� r� z%-40s: r� NzUnknown error: %r) rx r� r� r� �exitrm r� r� rh rb r` )r� r� �filenamerk r� �entryZeinforl r. r� r/ � inspect_main� s* �
�0r �__main__rA )r� )N)ar; �concurrent.futuresr� rL rf 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 rc r& r= rE rP rV rm �floatr� rz 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
#