File: //lib/python3/dist-packages/sphinx/ext/autodoc/__pycache__/importer.cpython-310.pyc
o
�$�a- �
@ s� d Z ddlZddlZddlZddlmZmZmZmZm Z m
Z
m Z ddl m
Z
ddlmZmZ ddlmZmZ ddlmZ ddlmZmZmZmZmZm Z e� e!�Z"d ed
e#de#fdd�Z$d ed
e#de
e# fdd�Z%d(de#de&defdd�Z'de d fde#dee# de#deee#gef de&def dd �Z(d edee e#ef fd d �Z)G d d!� d!e �Z* d)d edee# ded"edee#e*f f
d#d$�Z+d edee# dedee#d%f fd&d'�Z,dS )*z�
sphinx.ext.autodoc.importer
~~~~~~~~~~~~~~~~~~~~~~~~~~~
Importer utilities for autodoc
:copyright: Copyright 2007-2021 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_getattrF)�Type)� ObjectMember�subject�name�returnc C sT z t | �r|�d�r|�d�s d| j|f W S W |S W |S W |S ty) Y |S w )zMangle the given name.�__z_%s%s)r �
startswith�endswith�__name__�AttributeError)r r � r �=/usr/lib/python3/dist-packages/sphinx/ext/autodoc/importer.py�mangle s ��� ��r! c C s� z8t | �r0|�d�s3d| j }|�|�r |�|dd�W S | jD ]}d|j }|�|�r/ W dS q W |S W |S W |S tyB Y |S w )zUnmangle the given name.r z_%s__� N)r r r r �replace�__mro__r )r r �prefix�clsr r r �unmangle+ s(
��
�
� ��r' �modname�warningiserrorc
C s� zCt �� �4 t jdtd� t�| �� t�| �W d � W d � W S 1 s+w Y W d � W dS 1 s<w Y W dS tyW } zt |t
� � �|�d}~ww )zR
Call importlib.import_module(modname), convert exceptions to ImportError
�ignore)�categoryN) �warnings�catch_warnings�filterwarnings�
ImportWarningr �skip_warningiserror� importlib�
import_module�
BaseException� ImportError� traceback�
format_exc)r( r) �excr r r r2 > s
��&���r2 � �objpath�objtype�
attrgetterc
C s |r
t �d| d�|�� nt �d| � z�d }d }t|�}|d u rbzt| |d�}t �d| |� W n. ty] } z"t �d| � |}d| v rR| �dd�\} }|�d|� n� W Y d }~nd }~ww |d u s |} d }
d } |D ]/} | }
t �d | � t| | �}
|| |
�} zt �d
| � W n t y� t �d
| f� Y nw | } qj||
| | gW S t
tf�y
} z[t |t
�r�|r�|}|r�d |d�|�| f }nd || f }t |t�r�|j \}}t |t
�r�|d
7 }n!t |t�r�|j r�|d|j d 7 }n|d| 7 }n|dt�� 7 }t �|� t|�|�d }~ww )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�listr2 r4 �rsplit�insertr! � TypeErrorr �
isinstance�args�
SystemExitr5 r6 )r( r9 r: r; r) �module�exc_on_importingr7 r �obj�parent� object_name�attrname� mangled_name�errmsg�real_exc�
traceback_msgr r r �
import_objectM sr ����
��
��rQ rG c C s� ddl m} t�dt� i }t| �D ]}zt| |d�}||f||< W q ty+ Y qw t| �D ] }||vr<||f||< q0t t
|� � ��S )z Get members of target module.r �� INSTANCEATTRz?sphinx.ext.autodoc.importer.get_module_members() is deprecated.N) �sphinx.ext.autodocrS r, �warnr �dirr r r �sortedr@ �values)rG rS �membersr �valuer r r �get_module_members� s" � � �r[ c @ s& e Zd ZU eed< eed< eed< dS )� Attributer �directly_definedrZ N)r �
__module__� __qualname__�str�__annotations__�boolr r r r r r\ � s
r\ �analyzerc C s� ddl m} || di �}i }t| �rD| j�� D ]\}}||vr't|d|�||< q| jd } |D ]}|| jvrCt| |�}t|d|�||< q/zt | �}
|
r^ddl m
} |
D ]
}t|d| �||< qSW n t t fyj Y nw t
| �D ])}z || |�}||v } t| |�}|r�||vr�t|| |�||< W qo ty� Y qow tt| ��D ] \}
}t|�D ]}t||�}|r�||vr�t||
dk|�||< q�q�|r�d�|�}|�� D ]\}}||kr�||vr�t|d|�||< q�|S )z,Get members and attributes of target object.r rR �__dict__Tr" �� SLOTSATTRr< )rT rS r � __members__�itemsr\ r$ rd r r rf rC �
ValueErrorrV r' r � enumerater r r? �find_attr_docs)r r9 r; rc rS �obj_dictrY r rZ �
superclass� __slots__rf r] �ir& � namespace�nsr r r �get_object_members� sb �
� ��
� �
��
�rr r c C s� ddl m}m} || di �}i }t| �rH| j�� D ]\}}||vr*|||| d�||< q| jd } |D ]}|| jvrGt| |�}|||| d�||< q2z!t | �}
|
rhddl m
} |
�� D ]\}} ||| | | d�||< qYW n t t fyt Y nw t
| �D ]:}z/|| |�}t|�r�t|�}t| |�}
|
r�|
|vr�||v r�||
|| d�||
< n||
|�||
< W qy ty� Y qyw z�t| �D ]�}zt|d�}t|d �}t�|�}|�� W n ty� d
}d
}Y n ty� d
}Y nw t|�D ]1}t||�}|�r ||v�r |�r||f|jv �rd �|j||f �} nd
} ||||| d�||< q�|�rE|j�� D ] \\}}} ||k�rC||v�rC||||d �| �d�||< �q&q�W |S t�yS Y |S w ) z+Get members and attributes of target class.r )rS r rd )�class_r" re )rs � docstringr^ r_ N�
)rT rS r r rg rh r$ rd r r rf rC ri rV r
r r' r r r �
for_module�analyzer
r � attr_docsr? )r r9 r; rS r rl rY r rZ rm rn rf rt � unmangledr& r( �qualnamerc rq r r r �get_class_members� s� �
� ���
� �
�
��
���!��r{ )F)N)-�__doc__r1 r5 r, �typingr r r r r r r �sphinx.deprecationr �sphinx.ext.autodoc.mockr
r �
sphinx.pycoder r
� sphinx.utilr �sphinx.util.inspectr r r r r r r rT r � getLoggerr r= r` r! r' rb r2 rQ r[ r\ rr r{ r r r r �<module> sH
$
���
� I��
�=
�