Dashboard
PHP:
8.2.30
OS:
Linux
User:
dh_nv8b2m
/
/
usr
/
lib
/
python3
/
dist-packages
/
sphinx
/
ext
/
autodoc
/
__pycache__
📤 Upload
📝 New File
📁 New Folder
Close
Editing: 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�� �= �
Save
Cancel