| 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/util/__pycache__/ |
Upload File : |
a
�abXT � @ sd d Z ddlZddlZddlmZ ddlmZ ddlmZmZm Z m
Z
m Z m Z m
Z
mZmZmZ ddlmZ ddlmZ ddlmZmZ ejd kr�dd
lmZ ndd lmZ G d d
� d
�ZzddlmZ W n e y� dZY n0 edediZ eej ej f Z e!d�Z"ee#ge$f Z%ee#e#e#e&ee e#ef e e# ge
e ej' e ej( f f Z)e e#ee#gef f Z*eej'ge#f Z+e
e#e#e#e#f Z,e e#e e#e,f f Z-d(ee e e e#ef d�dd�Z.ee$d�dd�Z/d)e e e#e#d�dd�Z0d*e e e#e#d�dd �Z1d+e e e#e#d�d d �Z2d,ee#e#d �d d!�Z3d-ee#e#d �d"d#�Z4d.ee#e#d �d$d%�Z5ed&d'ee#gef ie� dS )/z�
sphinx.util.typing
~~~~~~~~~~~~~~~~~~
The composite types for Sphinx.
:copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
:license: BSD, see LICENSE for details.
� N)�Struct)�
TracebackType)
�Any�Callable�Dict� Generator�List�Optional�Tuple�Type�TypeVar�Union)�nodes)�Inliner)�RemovedInSphinx60Warning�deprecated_alias�� � )�
ForwardRef)� _ForwardRefc @ s6 e Zd ZdZd
eedd�dd�Zeeed�dd �ZdS ) r z#A pseudo ForwardRef class for py36.TN)�arg� is_argument�returnc C s
|| _ d S �N)r )�selfr r � r �6/usr/lib/python3.9/site-packages/sphinx/util/typing.py�__init__ s zForwardRef.__init__)�globalns�localnsr c C s t | j�}|�||�S r )r r �
_eval_type)r r r �refr r r � _evaluate s
zForwardRef._evaluate)T) �__name__�
__module__� __qualname__�__doc__r �boolr r r# r r r r r s r )� UnionTypez
struct.Structztypes.TracebackType)�objr r r c C s� ddl m} zt�| ||�W S ty: || di � Y S tyV || di � Y S tyr || di � Y S ty� i Y S 0 dS )z�Return a dictionary containing type hints for a function, method, module or class object.
This is a simple wrapper of `typing.get_type_hints()` that does not raise an error on
runtime.
r )� safe_getattr�__annotations__N)Zsphinx.util.inspectr+ �typing�get_type_hints� NameError�AttributeError� TypeError�KeyError)r* r r r+ r r r r. M s r. )�typr c C s t | dd�}|dko t| t�S )z&Check *typ* is system defined TypeVar.r% � r- )�getattr�
isinstancer )r3 �modnamer r r �is_system_TypeVarf s r8 � fully-qualified-except-typing)�cls�moder c s� ddl m} � dkrd}nd}�zh| du s2| tu r8W dS | tu rFW dS t| t�rV| W S | tv rpd |t| f W S |�| �r�tj d
kr�d || j
| j f W S d | j W S n�t �rt| t ��rt
| j�d
k� r�d| jv � r�d�� fdd�| jD ��}d| W S d�� fdd�| jD ��W S np| j
dv �rbt| d��rTd| j d�� fdd�| jD ��f W S d | j W S n$tj dk�rzt| � �W S t| � �W S W n" ttf�y� |�| � Y S 0 dS )aw Convert python class to a reST reference.
:param mode: Specify a method how annotations will be stringified.
'fully-qualified-except-typing'
Show the module name and qualified name of the annotation except
the "typing" module.
'smart'
Show the name of the annotation.
r ��inspect�smart�~r4 Nz:py:obj:`None`�...�:py:class:`%s%s`�r �
�:py:class:`%s%s.%s`�:py:class:`%s`� � | c 3 s | ]}|rt |� �V qd S r ��restify��.0�a�r; r r � <genexpr>� � zrestify.<locals>.<genexpr>z Optional[%s]c 3 s | ]}t |� �V qd S r rH rJ rM r r rN � rO )Z __builtin__�builtins�__args__z:py:class:`%s`\ [%s]�, c 3 s | ]}t |� �V qd S r rH �rK r rM r r rN � rO r )� sphinx.utilr= �NoneType�Ellipsisr6 �str�INVALID_BUILTIN_CLASSES� isNewType�sys� version_infor% r$ r) �lenrQ �join�hasattr�
_restify_py37�
_restify_py36r0 r1 Zobject_description)r: r; r= � modprefix�argsr rM r rI l sD
� rI c s� ddl m} � dkrd}nd}|�| �r�| jdkr�| jtu r�t| j�dkr�| jd tu r�t| j�d kr�d
� � fd d �| jd
d� D ��}d| S dt
| jd � � S n"d
� � fdd �| jD ��}d| S �n|�| ��r6t | jt j
�r�t
| j� �}nLt| dd
��r4| jdk�r d| j| jf }nd|| j| jf }n t
| j� �}t| dd
�}t| d��sZn�tdd � | jD ���rrn�| jdk�r�| jdk�r�d
� � fdd �| jd
d� D ��}|d|t
| jd � �f 7 }nh| jdk�rt|dd
�dk�r|d d
� d d � | jD �� 7 }n*| j�r2|d d
� � fd d �| jD �� 7 }|S t | t j
��rTd | j| jf S t| d ��r�| jdk�r|d| j| jf S d|| j| jf S nDt | t��r�d!| j S | jdk�r�d | j| jf S d"|| j| jf S d
S )#z)Convert python class to a reST reference.r r< r> r? r4 r- rF ���� rR c 3 s | ]}t |� �V qd S r rH rJ rM r r rN � rO z _restify_py37.<locals>.<genexpr>Nz8:py:obj:`~typing.Optional`\ [:obj:`~typing.Union`\ [%s]]� :py:obj:`~typing.Optional`\ [%s]c 3 s | ]}t |� �V qd S r rH rJ rM r r rN � rO � :py:obj:`~typing.Union`\ [%s]�_name�:py:class:`~%s.%s`rD �
__origin__rQ c s s | ]}t |�V qd S r �r8 rJ r r r rN � rO r c 3 s | ]}t |� �V qd S r rH rJ rM r r rN � rO � \ [[%s], %s]�Literal�\ [%s]c s s | ]}t |�V qd S r ��reprrJ r r r rN � rO c 3 s | ]}t |� �V qd S r rH rJ rM r r rN � rO �:py:obj:`~%s.%s`r& rE �:py:obj:`%s%s.%s`)rT r= Zisgenericaliasr% ri r
r\ rQ rU r] rI r6 r- � _SpecialFormr5 rg r^ �allr& r �__forward_arg__r$ )r: r; r= ra rb �text�originr rM r r_ � s`
�� " " "
r_ c
s� � dkrd}nd}t | dd �}|dkr�t | dd �r:| j}q�t | dd �rN| j}q�t | dd �rb| j}q�t | d d �rzt| j�}q�t| ��d
d�}n$t| d�r�d ||| jf }nt| �}t | t
j ��r t| d ��s |dkr�d
| }n d||f }| j }|�rd�
� fdd�|D ��}|d| S |S �npt | t
j��r�|dk�rBd
| }n d||f }| j d u �sjt| j �dk�rr| j }nV| jtk�r�| j }nBd�
� fdd�| j d d� D ��}t| j d � �} |d|| f S |�r�d�
� fdd�|D ��}|d| S |S �n�t| d ��r�| jt
ju �r�| j }|d u�r�t|�dk�r�|d tu �r�t|�dk�rvd�
� fdd�|d d� D ��}d| S dt|d � � S n d�
� fd d�|D ��}d | S nd S n�t| d��r�| jdk�r�d | j| jf S d!|| j| jf S n�t| d��r*| jdk�rd"| j| jf S d#|| j| jf S nft| d$��rf| jdk�rRd"| j| jf S d#|| j| jf S n*| jdk�r�d"| j|f S d#|| j|f S d S )%Nr> r? r4 r% r- rg r& rt ri �typing.z%s%s.%s�__tuple_params__z:py:class:`~typing.%s`rA rR c 3 s | ]}t |� �V qd S r rH �rK �prM r r rN rO z _restify_py36.<locals>.<genexpr>rm rd c 3 s | ]}t |� �V qd S r rH rS rM r r rN rO rc rk c 3 s | ]}t |� �V qd S r rH ry rM r r rN rO rF c 3 s | ]}t |� �V qd S r rH ry rM r r rN " rO z;:py:obj:`~typing.Optional`\ [:py:obj:`~typing.Union`\ [%s]]re r c 3 s | ]}t |� �V qd S r rH ry rM r r rN ( rO rf z:py:obj:`Union`rh rD rp rq r$ )r5 rg r& rt � stringifyri ro �replacer^ r6 r- � TupleMetarQ r] � GenericMetar\ r rI r
rU r% r$ )
r: r; ra �module�qualnameZreftext�params� param_strrb �resultr rM r r` � s�
�
"
�
�
r` )�
annotationr; r c C sd ddl m} |dkrd}nd}t| t�rN| �d�rH| �d�rH| dd� S | S n�t| t�r�| jd krp|d
v rp| jS |d � | j| jg� S n�|�
| �r�t j d kr�|d
| j| jf S | jS n�| s�t
| �S | tu r�dS | tv r�|t| S t| ��d�� r�nJt| dd�dk�r2t| dd��r2t| d��r*t
| �S | jS n| tu �r@dS t j dk�rVt| |�S t| |�S dS )a� Stringify type annotation object.
:param mode: Specify a method how annotations will be stringified.
'fully-qualified-except-typing'
Show the module name and qualified name of the annotation except
the "typing" module.
'smart'
Show the name of the annotation.
'fully-qualified'
Show the module name and qualified name of the annotation.
r r< r> r? r4 �'rF rc r- )r9 r> �.rB z%s.%s�None�typing.Annotatedr% NrP r& rQ r@ r )rT r= r6 rW �
startswith�endswithr r% r$ r] rY rZ r[ ro rU rX r5 r^ r& rV �_stringify_py37�_stringify_py36)r� r; r= ra r r r r{ E sJ
�
�
r{ c s t | dd�}d}|dkr,t | dd�r,| j}n�|dkr�t | dd�rH| j}n&t | dd�r\| j}nt| j��dd�}� d kr�d
| }q� d kr�d | }n`t| d�r�� d kr�d
| }nd | }| j}n4t| d
�r�t| j� �}n tr�t | t�r�d}nt
| �S t | dd��rt | j t t
f��s�n�|dv �r�t| j �dk�r�| j d tu �r�t| j �dk�r�d�� fdd�| j dd� D ��}d|||f S d|t| j d � �f S n&d�� fdd�| j D ��}d||f S �n@|dk�r$t| j �dk�r d| j v �r d �d d� | j D ��}d||f S d �d d� | j D ��S n�|d k�rpd�� fd d�| j dd� D ��}t| j d � �}d!||||f S |d"k�r�d�d#d� | j D ��}d$|||f S t| ��d%��r�t| j d � �S td&d� | j D ���r�|| S d�� fd'd�| j D ��}d$|||f S || S )(zstringify() for py37+.r% Nr4 r- rt rg r& rw r> �~%s.�fully-qualified�%s.ri z types.UnionrQ )r r
rF rc rd rR c 3 s | ]}t |� �V qd S r �r{ rJ rM r r rN � rO z"_stringify_py37.<locals>.<genexpr>�%sOptional[%sUnion[%s]]�%sOptional[%s]r c 3 s | ]}t |� �V qd S r r� rJ rM r r rN � rO � %sUnion[%s]rG c s s | ]}|rt |�V qd S r r� rJ r r r rN � rO c s s | ]}t |�V qd S r r� rJ r r r rN � rO r c 3 s | ]}t |� �V qd S r r� rJ rM r r rN � rO �%s%s[[%s], %s]rl c s s | ]}t |�V qd S r rn rJ r r r rN � rO �%s%s[%s]r� c s s | ]}t |�V qd S r rj rJ r r r rN � rO c 3 s | ]}t |� �V qd S r r� rJ rM r r rN � rO )r5 rt rg r& r{ ri r| r^ r) r6 ro rQ �list�tupler\ rU r] rW r� rs )r� r; r ra r� rb �returnsr rM r r� � sp
"�
"
r� c s� t | dd�}d}|dkr,t | dd�r,| j}n�|dkr�t | dd�rH| j}n<t | dd�r\| j}n(t | dd�rtt| j�}nt| ��d d�}� d
kr�d | }q܈ d kr�d
| }n4t| d�rԈ d
kr�d | }nd
| }| j}nt| �}t | t
j ��r4t| d��s4| j }|�r(d�
� fdd�|D ��}d|||f S || S �nzt | t
j��r�d}| j du �sbt| j �dk�rj| j }nT| jtk�r~| j }n@d�
� fdd�| j dd� D ��}t| j d �}d||||f S |du�r�d�
� fdd�|D ��}d|||f S n�t| d��r�| jt
ju �r�| j }|du�r�t|�dk�r�|d tu �r�t|�dk�rrd�
� fdd�|dd� D ��}d|||f S d|t|d � �f S n$d�
� fd d�|D ��}d ||f S || S ) zstringify() for py36.r% Nr4 r- rt rg r& ri rw r> r� r� r� rx rR c 3 s | ]}t |� �V qd S r r� ry rM r r rN � rO z"_stringify_py36.<locals>.<genexpr>r� rd c 3 s | ]}t |� �V qd S r r� rS rM r r rN � rO rc r� c 3 s | ]}t |� �V qd S r r� ry rM r r rN � rO rF c 3 s | ]}t |� �V qd S r r� ry rM r r rN rO r� r� r c 3 s | ]}t |� �V qd S r r� ry rM r r rN
rO r� )r5 rt rg r& r{ ri ro r| r^ r6 r- r} rQ r] r~ r\ r r
rU ) r� r; r ra r� r� r� rb r� r rM r r� � sr
� �
�
r� zsphinx.util.typingZDirectiveOption)NN)r9 )r9 )r9 )r9 )r9 )r9 )6r' rZ r- �structr �typesr r r r r r r r
r r r
Zdocutilsr Zdocutils.parsers.rst.statesr Zsphinx.deprecationr r r[ r r r) � ImportErrorrX �TextZ TextElementZ TextlikeNode�typerU rW r( Z PathMatcher�intZNodeZsystem_messageZ RoleFunctionZ
OptionSpecZ TitleGetterZ
InventoryItemZ Inventoryr. r8 rI r_ r` r{ r� r� r r r r �<module> sT
0
� � 8@a=JD��