| 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/autodoc/__pycache__/ |
Upload File : |
a
�ab- � @ s� d Z ddlZddlZddlZddlmZmZmZmZm Z m
Z
m Z ddl m
Z
ddlmZmZ ddlmZmZ ddlmZ ddlmZmZmZmZmZm Z e� e �Z!ee"e"d �d
d �Z#ee"e
e" d �d d
�Z$d"e"e%ed�dd�Z&de dfe"ee" e"eee"gef e%ed�dd�Z'eee e"ef d�dd�Z(G dd� de �Z)d#eee" eeee"e)f d�d d �Z*eee" eee"d f d �d d!�Z+dS )$z�
sphinx.ext.autodoc.importer
~~~~~~~~~~~~~~~~~~~~~~~~~~~
Importer utilities for autodoc
:copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
:license: BSD, see LICENSE for details.
� N)�Any�Callable�Dict�List�
NamedTuple�Optional�Tuple)�RemovedInSphinx50Warning)�ismock�
undecorate)�ModuleAnalyzer� PycodeError)�logging)�getannotations�getmro�getslots�isclass� isenumclass� safe_getattr)�subject�name�returnc C sH z0t | �r.|�d�r.|�d�s.d| j|f W S W n tyB Y n0 |S )zMangle the given name.�__z_%s%s)r �
startswith�endswith�__name__�AttributeError)r r � r �?/usr/lib/python3.9/site-packages/sphinx/ext/autodoc/importer.py�mangle s r c C sz zbt | �r`|�d�s`d| j }|�|�r8|�|dd�W S | jD ] }d|j }|�|�r> W dS q>W n tyt Y n0 |S )zUnmangle the given name.r z_%s__� N)r r r r �replace�__mro__r )r r �prefix�clsr r r �unmangle+ s
r% F)�modname�warningiserrorr c
C s� z�t �� �d t jdtd� t�| ��* t�| �W d � W d � W S 1 sV0 Y W d � n1 st0 Y W n4 ty� } z t |t
� � �|�W Y d}~n
d}~0 0 dS )zR
Call importlib.import_module(modname), convert exceptions to ImportError
�ignore)�categoryN) �warnings�catch_warnings�filterwarnings�
ImportWarningr Zskip_warningiserror� importlib�
import_module�
BaseException� ImportError� traceback�
format_exc)r& r' �excr r r r/ > s
Zr/ � )r& �objpath�objtype�
attrgetterr' r c
C s2 |rt �d| d�|�� n t �d| � �zd }d }t|�}|d u r�z t| |d�}t �d| |� W q: ty� } zDt �d| � |}d| v r�| �dd�\} }|�d|� n� W Y d }~q:d }~0 0 q:|} d }
d } |D ]`} | }
t �d | � t| | �}
|| |
�} zt �d
| � W n" t �y* t �d
| f� Y n0 | } q�||
| | gW S t
tf�y, } z�t |t
��rj|�rj|}|�r�d |d�|�| f }n d || f }t |t��r�|j \}}t |t
��r�|d
7 }n4t |t��r�|j �r�|d|j d 7 }n |d| 7 }n|dt�� 7 }t �|� t|�|�W Y d }~n
d }~0 0 d S )Nz[autodoc] from %s import %s�.z[autodoc] import %s)r' z[autodoc] import %s => %rz [autodoc] import %s => failedr r z[autodoc] getattr(_, %r)z[autodoc] => %rz.autodoc: failed to import %s %r from module %rz autodoc: failed to import %s %rzJ; the module executes module level statement and it might call sys.exit().z(; the following exception was raised:
%s)�logger�debug�join�listr/ r1 �rsplit�insertr � TypeErrorr �
isinstance�args�
SystemExitr2 r3 )r& r6 r7 r8 r' �moduleZexc_on_importingr4 r �obj�parentZ object_name�attrnameZ mangled_name�errmsgZreal_excZ
traceback_msgr r r �
import_objectM sd
�
rI )rD r c C s� ddl m} t�dt� i }t| �D ]8}z t| |d�}||f||< W q$ tyZ Y q$Y q$0 q$t| �D ]}||vrf||f||< qft t
|� � ��S )z Get members of target module.r �� INSTANCEATTRz?sphinx.ext.autodoc.importer.get_module_members() is deprecated.N) �sphinx.ext.autodocrK r* �warnr �dirr r r �sortedr= �values)rD rK �membersr �valuer r r �get_module_members� s � rS c @ s& e Zd ZU eed< eed< eed< dS )� Attributer �directly_definedrR N)r �
__module__� __qualname__�str�__annotations__�boolr r r r r rT � s
rT )r r6 r8 �analyzerr c C s� ddl m} || di �}i }t| �r�| j�� D ] \}}||vr.t|d|�||< q.| jd } |D ](}|| jvr^t| |�}t|d|�||< q^z6t | �}
|
r�ddl m
} |
D ]}t|d| �||< q�W n t t fy� Y n0 t
| �D ]^}z@|| |�}||v } t| |�}|�r ||v�r t|| |�||< W q� t�y: Y q�Y q�0 q�tt| ��D ]H\}
}t|�D ]4}t||�}|�rZ||v�rZt||
dk|�||< �qZ�qJ|�r�d�|�}|�� D ].\}}||k�r�||v�r�t|d|�||< �q�|S )z,Get members and attributes of target object.r rJ �__dict__Tr �� SLOTSATTRr9 )rL rK r � __members__�itemsrT r" r\ r r r^ r@ �
ValueErrorrN r% r � enumerater r r< Zfind_attr_docs)r r6 r8 r[ rK �obj_dictrQ r rR �
superclass� __slots__r^ rU �ir$ � namespace�nsr r r �get_object_members� sP
ri � ObjectMember)r r6 r8 r c C s� ddl m}m} || di �}i }t| �r�| j�� D ]"\}}||vr2|||| d�||< q2| jd } |D ]*}|| jvrdt| |�}|||| d�||< qdzBt | �}
|
r�ddl m
} |
�� D ] \}} ||| | | d�||< q�W n t t fy� Y n0 t
| �D ]�}zf|| |�}t|��rt|�}t| |�}
|
�rZ|
|v�rZ||v �rL||
|| d�||
< n||
|�||
< W q� t�yt Y q�Y q�0 q�z0t| �D �] }z*t|d�}t|d �}t�|�}|�� W n2 t�y� d
}d
}Y n t�y� d
}Y n0 t|�D ]d}t||�}|�r�||v�r�|�r:||f|jv �r:d �|j||f �} nd
} ||||| d�||< �q�|�r�|j�� D ]<\\}}} ||k�rf||v�rf||||d �| �d�||< �qf�q�W n t�y� Y n0 |S ) z+Get members and attributes of target class.r )rK rj r\ )�class_r r] )rk � docstringrV rW N�
)rL rK rj r r_ r` r" r\ r r r^ r@ ra rN r
r r% r r r Z
for_moduleZanalyzer
r Z attr_docsr< )r r6 r8 rK rj rc rQ r rR rd re r^ rl Z unmangledr$ r& �qualnamer[ rh r r r �get_class_members� s�
�
��ro )F)N),�__doc__r. r2 r* �typingr r r r r r r Zsphinx.deprecationr Zsphinx.ext.autodoc.mockr
r Z
sphinx.pycoder r
Z sphinx.utilr Zsphinx.util.inspectr r r r r r �Typerj Z getLoggerr r: rX r r% rZ r/ rI rS rT ri ro r r r r �<module> s:
$
� � I � � =
�