File: //usr/lib/python3/dist-packages/sphinx/util/__pycache__/typing.cpython-310.pyc
o
�$�a�I � @ sb d Z ddlZddlZddlmZ ddlmZ ddlmZmZm Z m
Z
m Z m Z m
Z
mZmZmZ ddlmZ ddlmZ ddlmZmZ ejd krNdd
lmZ n
dd lmZ G d d
� d
�ZzddlmZ W n e yn dZY nw 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,dede de de e#ef fdd�Z.dede$fdd�Z/d e e de#fd d �Z0d e e de#fd d �Z1d e e de#fd!d"�Z2d#ede#fd$d%�Z3d#ede#fd&d'�Z4d#ede#fd(d)�Z5ed*d+ee#gef ie� dS )-z�
sphinx.util.typing
~~~~~~~~~~~~~~~~~~
The composite types for Sphinx.
:copyright: Copyright 2007-2021 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 @ s> e Zd ZdZd
dededdfdd�Zd ed
edefd d �ZdS )r z#A pseudo ForwardRef class for py36.T�arg� is_argument�returnNc C s
|| _ d S �N)r )�selfr r � r �4/usr/lib/python3/dist-packages/sphinx/util/typing.py�__init__ s
zForwardRef.__init__�globalns�localnsc 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 )� UnionTypeF)r z
struct.Structztypes.TracebackType�objr r r c C s� ddl m} zt�| ||�W S ty || di � Y S ty+ || di � Y S ty9 || di � Y S tyC i Y S w )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__)�sphinx.util.inspectr+ �typing�get_type_hints� NameError�AttributeError� TypeError�KeyError)r* r r r+ r r r r/ M s �r/ �typc C s t | dd�}|dkot| t�S )z&Check *typ* is system defined TypeVar.r% � r. )�getattr�
isinstancer )r4 �modnamer r r �is_system_TypeVarf s r9 �clsc C s| ddl m} z�| du s| tu rW dS | tu rW dS t| t�r!| W S | tv r,dt| W S |�| �rOtj dkrIt
| t | �t | �� d| j
| jf W S d| j W S tr~t| t�r~t| j�d krrd| jv rrd
�d d � | jD ��}d
| W S d
�dd � | jD ��W S | j
dv r�t| d�r�d| jd�dd � | jD ��f W S d| j W S tj dkr�t| �W S t| �W S ttfy� |�| � Y S w )�)Convert python class to a reST reference.r ��inspectNz:py:obj:`None`�...�:py:class:`%s`�r �
�:py:class:`%s.%s`� � | c s � � | ] }|rt |�V qd S r ��restify��.0�ar r r � <genexpr>� � � zrestify.<locals>.<genexpr>� Optional[%s]c s � � | ]}t |�V qd S r rF rH r r r rK � � � )� __builtin__�builtins�__args__z:py:class:`%s`\ [%s]�, c s rN r rF �rI r r r r rK � rO r )� sphinx.utilr= �NoneType�Ellipsisr7 �str�INVALID_BUILTIN_CLASSES� isNewType�sys� version_info�print�type�dirr% r$ r) �lenrR �join�hasattr�
_restify_py37�
_restify_py36r1 r2 �object_description)r: r= �argsr r r rG l sB
�
�rG c C s� ddl m} |�| �rU| jdkrU| jtu rUt| j�dkrF| jd tu rFt| j�dkr=d� dd � | jd
d� D ��}d | S d t
| jd � S d� d
d � | jD ��}d| S |�| �r�t | jt j
�rgt
| j�}n"t| dd
�r�| jdkr{d| j| jf }nd| j| jf }nt
| j�}t| dd
�}t| d�s� |S tdd � | jD ��r� |S | jdkr�| jdkr�d� dd � | jd
d� D ��}|d|t
| jd �f 7 }|S | jdkr�t|dd
�dkr�|dd� dd � | jD �� 7 }|S | jr�|dd� dd � | jD �� 7 }|S t | t j
��r
d | j| jf S t| d ��r)| jdk�r!d| j| jf S d| j| jf S t | t��r4d | j S | jdk�rBd | j| jf S d | j| jf S ) r; r r< r. rC ���� rS c s rN r rF rH r r r rK � rO z _restify_py37.<locals>.<genexpr>Nz8:py:obj:`~typing.Optional`\ [:obj:`~typing.Union`\ [%s]]� :py:obj:`~typing.Optional`\ [%s]c s rN r rF rH r r r rK � rO � :py:obj:`~typing.Union`\ [%s]�_name�:py:class:`~%s.%s`rB �
__origin__rR c s rN r �r9 rH r r r rK � rO r c s rN r rF rH r r r rK � rO � \ [[%s], %s]�Literal�\ [%s]c s rN r ��reprrH r r r rK � rO c s rN r rF rH r r r rK � rO �:py:obj:`~%s.%s`r& r? �:py:obj:`%s.%s`)rU r= �isgenericaliasr% rm r
r` rR rV ra rG r7 r. � _SpecialFormr6 rk rb �allr& r �__forward_arg__r$ )r: r= rf �text�originr r r rc � s\
� � � �
rc c C s. t | dd �}|dkr=t | dd �r| j}n:t | dd �r | j}n0t | dd �r(| j}n&t | dd �r4t| j�}nt| ��dd�}nt| d�rJd || jf }nt| �}t | t
j �r}t| d
�s}|dkrbd | }nd | }| j }|r{d
�
dd� |D ��}|d| S |S t | t
j�r�|dkr�d | }nd | }| j d u s�t| j �dkr�| j }n'| jtkr�| j }n d
�
dd� | j d d� D ��}t| j d �}|d||f S |r�d
�
dd� |D ��}|d| S |S t| d��r/| jt
ju �r/| j }|d u�r-t|�dk�r |d tu �r t|�dk�rd
�
dd� |d d� D ��}d| S dt|d � S d
�
dd� |D ��}d | S d S t| d��rK| jdk�rCd | j| jf S d | j| jf S t| d��rg| jdk�r_d | j| jf S d!| j| jf S t| d"��r�| jdk�r{d | j| jf S d!| j| jf S | jdk�r�d | j|f S d!| j|f S )#Nr% r. rk r& ry rm �typing.r5 �%s.%s�__tuple_params__z:py:class:`~typing.%s`r? rS c s rN r rF �rI �pr r r rK � rO z _restify_py36.<locals>.<genexpr>rq rh c s rN r rF rT r r r rK � rO rg ro c s rN r rF r r r r rK rO rC c s rN r rF r r r r rK rO z;:py:obj:`~typing.Optional`\ [:py:obj:`~typing.Union`\ [%s]]ri r c s rN r rF r r r r rK rO rj z:py:obj:`Union`rl rB rt ru r$ )r6 rk r& ry � stringifyrm rs �replacerb r7 r. � TupleMetarR ra � GenericMetar` r rG r
rV r% r$ )r: �module�qualname�reftext�params� param_strrf �resultr r r rd � s�
�
� rd �
annotationc C s" ddl m} t| t�r | �d�r| �d�r| dd� S | S t| t�r3| jdkr*| jS d� | j| jg�S |�
| �rHt j dkrEd | j| jf S | jS | sNt
| �S | tu rTd
S | tv r\t| S t| ��d �rdn t| d d
�dkr~t| dd
�r~t| d�r{t
| �S | jS | tu r�dS t j dkr�t| �S t| �S )z!Stringify type annotation object.r r< �'rC rg r. �.r@ r} �None�typing.Annotatedr% NrQ r& rR r> r )rU r= r7 rX �
startswith�endswithr r% r$ ra rZ r[ r\ rs rV rY r6 rb r& rW �_stringify_py37�_stringify_py36)r� r= r r r r� . s@
�
r� c C st t | dd�}|dkr.t | dd�r| j}n@t | dd�r | j}n6t | dd�r(| j}n,t| j�}n&t| d�r;d|| jf }nt| d�rFt| j�}ntrPt| t�rPd }nt | �S t | d
d��r8t| j
t t f�sf |S |d v r�t
| j
�d kr�| j
d
tu r�t
| j
�dkr�d�dd� | j
dd
� D ��}d| S dt| j
d � S d�dd� | j
D ��}d| S |d kr�t
| j
�d kr�d| j
v r�d�dd� | j
D ��}d| S d�dd� | j
D ��S |dkr�d�dd� | j
dd
� D ��}t| j
d
�}d |||f S |d k�r d�d d� | j
D ��}d ||f S t| ��d ��rt| j
d �S td!d� | j
D ���r'|S d�d"d� | j
D ��}d ||f S |S )#zstringify() for py37+.r% Nr. rk r& ry r} rm z types.UnionrR )r r
rC rg rh rS c s rN r �r� rH r r r rK y rO z"_stringify_py37.<locals>.<genexpr>�Optional[Union[%s]]rM r c s rN r r� rH r r r rK ~ rO � Union[%s]rD c s rE r r� rH r r r rK � rL c s rN r r� rH r r r rK � rO r c s rN r r� rH r r r rK � rO � %s[[%s], %s]rp c s rN r rr rH r r r rK � rO �%s[%s]r� c s rN r rn rH r r r rK � rO c s rN r r� rH r r r rK � rO )r6 rk r& ry r� rm rb r) r7 rs rR �list�tupler` rV ra rX r� rx )r� r� r� rf �returnsr r r r� Z s^
!�
r� c C s. t | dd�}|dkr=t | dd�r| j}n:t | dd�r | j}n0t | dd�r(| j}n&t | dd�r4t| j�}nt| ��dd �}nt| d�rJd
|| jf }nt| �}t | t
j �rpt| d �sp| j }|rnd �
d
d� |D ��}d||f S |S t | t
j�r�d}| j du s�t| j �dkr�| j }n&| jtkr�| j }n d �
dd� | j dd� D ��}t| j d �}d|||f S |dur�d �
dd� |D ��}d||f S |S t| d��r| jt
ju �r| j }|du�rt|�dk�r|d tu �rt|�dkr�d �
dd� |dd� D ��}d| S dt|d � S d �
dd� |D ��}d| S |S ) zstringify() for py36.r% Nr. rk r& ry rm r| r5 r} r~ rS c s rN r r� r r r r rK � rO z"_stringify_py36.<locals>.<genexpr>r� rh c s rN r r� rT r r r rK � rO rg r� c s rN r r� r r r r rK � rO rC c s rN r r� r r r r rK � rO r� rM r c s rN r r� r r r r rK � rO r� )r6 rk r& ry r� rm rs r� rb r7 r. r� rR ra r� r` r r
rV )r� r� r� r� r� rf r� r r r r� � sb
�
� �
r� zsphinx.util.typing�DirectiveOption)NN)6r' r[ r. �structr �typesr r r r r r r r
r r r
�docutilsr �docutils.parsers.rst.statesr �sphinx.deprecationr r r\ r r r) � ImportErrorrY �Text� TextElement� TextlikeNoder^ rV rX r( � PathMatcher�int�Node�system_message� RoleFunction�
OptionSpec� TitleGetter�
InventoryItem� Inventoryr/ r9 rG rc rd r� r� r� r r r r �<module> sZ
0
�� �$+;\,?:��