| 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/pycode/__pycache__/ |
Upload File : |
a
�ab � @ 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-2022 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 eee
e e
e f d�d d
��Zed#eeed d �d
d��Zeeed d�dd��Zeeed d�dd��Zeed d�dd��Zeeedd�dd�Zdd�dd �Zdd�d d �Zeeeef ee f d�d d �Zeeeee e f f d�d!d"�ZdS )$�ModuleAnalyzer� annotations� attr_docs�finals� overloads�tagorder�tags�cache)�modname�returnc
C s� z t | �}W n4 ty@ } z td| |�|�W Y d}~n
d}~0 0 t|dd�}t|dd�}|r�t|dd�r�z |�| �}|r�||fW S W n ty� Y n0 |du r�|r�t|dd�r�z|�| �}W n4 ty� } z td| |�|�W Y d}~n
d}~0 0 |du �r td| ��t�t� |��}|�
� � d ��r^|dd
� }t� |��s�t� |d ��r�|d 7 }nd|�
� � d ��s|td
| ��nFdtj
|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 �:/usr/lib/python3.9/site-packages/sphinx/pycode/__init__.py�get_module_source& sF &
&
z ModuleAnalyzer.get_module_source�<string>)�stringr �srcnamer c C s | t |�||�S )Nr )�clsr= r r> r9 r9 r: �
for_stringV s zModuleAnalyzer.for_string)r4 r r c
C s� d|f| j v r | j d|f S zHt�|��*}| |||�}|| j d|f< W d � n1 sX0 Y W n^ ty� } zFdtj |v r�| �||� }| j d|f< ntd| |�|�W Y d }~n
d }~0 0 |S )N�filer" �error opening %r)r �tokenize�openr% r r- �for_eggr )r? r4 r �f�objr2 r9 r9 r: �for_file[ s 0 &zModuleAnalyzer.for_filec
C s� t �tj�}t �d| |�\}}zJt|��.}|�|��� }| �|||�W d � W S 1 s^0 Y W n4 t y� } z t
d| |�|�W Y d }~n
d }~0 0 d S )Nr# rB ) r. r/ r r- r0 r �read�decoder@ r% r ) r? r4 r ZSEPr7 �relpathZegg�code�excr9 r9 r: rE j s
2zModuleAnalyzer.for_eggc
C s� d|f| j v r.| j d|f }t|t�r*|�|S zB| �|�\}}|d urZ| �|||pTd�}n|d urn| �||�}W n4 ty� } z || j d|f< � W Y d }~n
d }~0 0 || 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_moduleN)r5 r r> r c C s || _ || _|�� | _d| _d S )NF)r r> rI rL � _analyzed)�selfr5 r r> r9 r9 r: �__init__� s
zModuleAnalyzer.__init__)r c C s t jdtdd� | �� dS )zParse the source code.z%ModuleAnalyzer.parse() is deprecated.� )�
stacklevelN)�warnings�warnr �analyze�rS r9 r9 r: �parse� s �zModuleAnalyzer.parsec
C s� | j r
dS z�t| j�}|�� t� | _|j�� D ].\}}|rR|�� dg | j|< q0dg| j|< q0|j | _ |j
| _
|j | _ |j | _
|j| _d| _ W n8 ty� } z td| j|f �|�W Y d}~n
d}~0 0 dS )zAnalyze the source code.N� Tzparsing %r failed: %r)rR r rL r[ r r Zcomments�items�
splitlinesr r r Z definitionsr Z defordersr r% r r> )rS �parserZscopeZcommentrM r9 r9 r: rY � s$
zModuleAnalyzer.analyzec C s | � � | jS )z?Find class and module-level attributes and their documentation.)rY r rZ r9 r9 r: �find_attr_docs� s z ModuleAnalyzer.find_attr_docsc C s | � � | jS )z?Find class, function and method definitions and their location.)rY r rZ r9 r9 r: � find_tags� s zModuleAnalyzer.find_tags)r< )�__name__�
__module__� __qualname__r
r
�str�__annotations__r r �intr r � staticmethodr r; � classmethodr@ rH rE rQ r rT r[ rY r` ra r9 r9 r9 r: r s0
"/�
"r ) �__doc__r. rC rW � collectionsr � importlibr �inspectr �ior �osr �typingr r r
r r r
�zipfiler Zsphinx.deprecationr Z
sphinx.errorsr Zsphinx.pycode.parserr r r9 r9 r9 r: �<module> s