File: //usr/lib/python3/dist-packages/sphinx/pycode/__pycache__/__init__.cpython-310.pyc
o
�$�a � @ s� d Z ddlZddlZddlZddlmZ ddlmZ ddlm Z ddl
m Z ddl m
Z
ddlmZmZmZmZmZmZ dd lmZ dd
lmZ dd lmZ dd lm Z G d
d� d�Z dS )z�
sphinx.pycode
~~~~~~~~~~~~~
Utilities parsing and analyzing Python code.
:copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS.
:license: BSD, see LICENSE for details.
� N)� OrderedDict)�
import_module)� Signature��StringIO)�path)�IO�Any�Dict�List�Optional�Tuple)�ZipFile)�RemovedInSphinx50Warning)� PycodeError)�Parserc
@ s� e Zd ZU eeeef ef ed< eeeef ee f ed< ee ed< eeee f ed< eee f ed< eeeee e f f ed< i Z
eeeef e f ed< e ded ee
e e
e f fd
d ��Zed$d
ededed d fdd��Zededed d fdd��Zededed d fdd��Zeded d fdd��Zdededed dfdd�Zd%d d �Zd%d d �Zd eeeef ee f fd d!�Zd eeeee e f f fd"d#�ZdS )&�ModuleAnalyzer� annotations� attr_docs�finals� overloads�tagorder�tags�cache�modname�returnc
C s� zt | �}W n ty } ztd| |�|�d}~ww t|dd�}t|dd�}|rGt|dd�rGz|�| �}|r<||fW S W n tyF Y nw |du ro|rot|dd�roz|�| �}W n tyn } ztd| |�|�d}~ww |du rytd| ��t�t� |��}|�
� � d �r�|dd
� }t� |�s�t� |d �r�|d 7 }n.|�
� � d �s�td
| ��dtj
|v r�dt�tj
� }t�||d�\}}t� |�r�|dfS t� |�s�td| ��|dfS )z�Try to find the source code for a module.
Returns ('filename', 'source'). One of it can be None if
no filename or source found
zerror importing %rN�
__loader__�__file__�
get_source� get_filenamez error getting filename for %rz no source found for module %r)z.pyoz.pyc����w)z.pyz.pywz source is not a .py file: %r�.egg�
(?<=\.egg)� z source file is not present: %r)r � Exceptionr �getattrr � ImportErrorr r �normpath�abspath�lower�endswith�isfile�sep�re�escape�split) r �mod�err�loader�filename�source�pat�eggpath�_� r9 �8/usr/lib/python3/dist-packages/sphinx/pycode/__init__.py�get_module_source& sT ��
� ��� �
z ModuleAnalyzer.get_module_source�<string>�string�srcnamec C s | t |�||�S )Nr )�clsr= r r> r9 r9 r: �
for_stringV s zModuleAnalyzer.for_stringr4 c
C s� d|f| j v r| j d|f S z't�|��}| |||�}|| j d|f< W d � W |S 1 s.w Y W |S tye } z$dtj |v rR| �||� }| j d|f< ntd| |�|�W Y d }~|S d }~ww )N�filer" �error opening %r)r �tokenize�openr% r r- �for_eggr )r? r4 r �f�objr2 r9 r9 r: �for_file[ s$ ���
���zModuleAnalyzer.for_filec
C s� t �tj�}t �d| |�\}}z&t|��}|�|��� }| �|||�W d � W S 1 s/w Y W d S t yJ } zt
d| |�|�d }~ww )Nr# rB ) r. r/ r r- r0 r �read�decoder@ r% r ) r? r4 r �SEPr7 �relpath�egg�code�excr9 r9 r: rE j s
(���zModuleAnalyzer.for_eggc
C s� d|f| j v r| j d|f }t|t�r|�|S z!| �|�\}}|d ur-| �|||p*d�}n
|d ur7| �||�}W n tyL } z|| j d|f< � d }~ww || j d|f< |S )N�moduler< )r �
isinstancer r; r@ rH )r? r �entryr4 r5 rG r2 r9 r9 r: �
for_moduleu s&
���zModuleAnalyzer.for_moduler5 Nc C s || _ || _|�� | _d| _d S )NF)r r> rI rN � _analyzed)�selfr5 r r> r9 r9 r: �__init__� s
zModuleAnalyzer.__init__c C s t jdtdd� | �� dS )zParse the source code.z%ModuleAnalyzer.parse() is deprecated.� )�
stacklevelN)�warnings�warnr �analyze�rU r9 r9 r: �parse� s � zModuleAnalyzer.parsec
C s� | j rdS zDt| j�}|�� t� | _|j�� D ]\}}|r)|�� dg | j|< qdg| j|< q|j | _ |j
| _
|j | _ |j | _
|j| _d| _ W dS ty_ } z
td| j|f �|�d}~ww )zAnalyze the source code.N� Tzparsing %r failed: %r)rT r rN r] r r �comments�items�
splitlinesr r r � definitionsr � defordersr r% r r> )rU �parser�scope�commentrO r9 r9 r: r[ � s(
��zModuleAnalyzer.analyzec C � | � � | jS )z?Find class and module-level attributes and their documentation.)r[ r r\ r9 r9 r: �find_attr_docs� � z ModuleAnalyzer.find_attr_docsc C rg )z?Find class, function and method definitions and their location.)r[ r r\ r9 r9 r: � find_tags� ri zModuleAnalyzer.find_tags)r< )r N)�__name__�
__module__� __qualname__r
r
�str�__annotations__r r �intr r � staticmethodr r; � classmethodr@ rH rE rS r rV r] r[ rh rj r9 r9 r9 r: r s2
$/ �
"$r ) �__doc__r. rC rY � collectionsr � importlibr �inspectr �ior �osr �typingr r r
r r r
�zipfiler �sphinx.deprecationr �
sphinx.errorsr �sphinx.pycode.parserr r r9 r9 r9 r: �<module> s