| 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/__pycache__/ |
Upload File : |
a
�abg7 � @ s d Z ddlZddlZddlZddlZddlmZ ddlmZ ddl m
Z
m Z m Z m
Z
mZmZmZ ddlZddlmZ ddlmZ ddlmZ dd lmZ dd
lmZ dd l m Z e� e �Z de
e!e!dd
�dd�Z"e!e!e
e d�dd�Z#G dd� de�Z$ee e!e f d�dd�Z%dS )a-
sphinx.ext.coverage
~~~~~~~~~~~~~~~~~~~
Check Python modules and C API for coverage. Mostly written by Josip
Dzolonga for the Google Highly Open Participation contest.
:copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
:license: BSD, see LICENSE for details.
� N)�
import_module)�path)�IO�Any�Dict�List�Pattern�Set�Tuple)�Sphinx)�Builder)�__)�logging)�red)� safe_getattr�-)�f�text�char�returnc C s( | � |d � | � |t|� d � d S )N�
)�write�len)r r r � r �7/usr/lib/python3.9/site-packages/sphinx/ext/coverage.py� write_header s r )�name�expsr c C sL g }|D ]>}z|� t�|�� W q tyD t�td�|| � Y q0 q|S )Nzinvalid regex %r in %s)�append�re�compile� Exception�logger�warningr
)r r Zlst�expr r r �compile_regex_list% s r% c @ s� e Zd ZdZdZedej d �Zdd�dd�Z e
d�d d
�Z e dd �d d
�Z
dd�dd�Zdd�dd�Ze
ed�dd�Zdd�dd�Zdd�dd�Zdd�dd�ZdS )�CoverageBuilderz:
Evaluates coverage of code in the documentation.
ZcoveragezNTesting of coverage in the sources finished, look at the results in %(outdir)sz python.txt.N)r c C s� g | _ | jjD ]$}t�| j|�}| j �t�|�� qg | _| jj �
� D ]F\}}z| j� |t �
|�f� W qF ty� t�td�|� Y qF0 qFi | _| jj�
� D ]\}}td|�| j|< q�td| jj�| _td| jj�| _td| jj�| _td| jj�| _ d S )Nz&invalid regex %r in coverage_c_regexes�coverage_ignore_c_items�coverage_ignore_modules�coverage_ignore_classes�coverage_ignore_functions�coverage_ignore_pyobjects) �
c_sourcefiles�config�coverage_c_pathr �joinZsrcdir�extend�glob� c_regexes�coverage_c_regexes�itemsr r r r! r" r# r
� c_ignorexpsr' r% r( �
mod_ignorexpsr) �
cls_ignorexpsr* �
fun_ignorexpsr+ � py_ignorexps)�self�patternr r$ r r r r �init7 s6 � ����zCoverageBuilder.initc C s dS )Nzcoverage overviewr )r: r r r �get_outdated_docsQ s z!CoverageBuilder.get_outdated_docs)�ignoredr c G s0 i | _ | �� | �� i | _| �� | �� d S )N)�py_undoc�build_py_coverage�write_py_coverage�c_undoc�build_c_coverage�write_c_coverage)r: r> r r r r T s zCoverageBuilder.writec C s� | j jd d }| jD ]�}t� }t|��~}|D ]h}| jD ]\\}}|�|�}|r8|�� d } | |vr8| j� |g �D ]}
|
�| �rp q8qp|�
|| f� q8q8q.W d � n1 s�0 Y |r|| j |< qd S )N�c�objectsr ) �env�
domaindatar, �set�openr2 �match�groupsr5 �get�addrB ) r: Z c_objects�filename�undocr �line�keyZregexrK r r$ r r r rC ] s"
$z CoverageBuilder.build_c_coveragec
C s t �| jd�}t|d���}| jjr.t|dd� |�d� | j� � D ]�\}}t||� t
|�D ]z\}}|�d||f � | jj r\| j j
s�| j jr�t�td�|||� q\t�td�d d
d |d | td
� | � q\|�d� qBW d � n1 s�0 Y d S )Nzc.txt�wzUndocumented C API elements�=r z * %-50s [%9s]
z&undocumented c api: %s [%s] in file %s�undocumented zc z
api �%-30sz [%9s]z - in file )r r/ �outdirrJ r- �coverage_write_headliner r rB r4 �sorted�coverage_show_missing_items�app�quiet�warningiserrorr" r# r
�infor )r: � output_file�oprO rP �typr r r r rD r s,
����z CoverageBuilder.write_c_coverage)� full_namer c C s | j D ]}|�|�r dS qdS )NTF)r9 �search)r: rb r$ r r r � ignore_pyobj� s
z CoverageBuilder.ignore_pyobjc C s� | j jd d }| j jd d }| jj}|D �]l}d}| jD ]}|�|�r<d} qTq<|s,| �|�rdq,z t|�}W nP ty� } z8t �
t d�||� d|i| j |< W Y d }~q,W Y d }~n
d }~0 0 g } i }
t
�|�D �]�\} } | d d kr�q�t| d
�s�q�| j|k�rq�d || f }
| �|
��r q�t
�| ��rr|
|v�r�| jD ]}|�| ��r< �q��q<|�rf| j�sfq�| �| � q�t
�| �r�| jD ]}|�| ��r� qԐq�|
|v�r�|�r�| j�s�q�g |
| < q�g }t| �D ]�}|| jv�rސq�zt| |�}W n t�y Y �q�Y n0 t
�|��s$t
�|��s$�q�|d d k�r6�q�|�rH|j�sH�q�d |
|f }| �|��rd�q�||v�r�|�|� �q�|r�||
| < q�| |
d �| j |< q,d S )
N�pyrF �modulesFTz#module %s could not be imported: %s�errorr �_�
__module__z%s.%s)�funcs�classes) rG rH r- � coverage_skip_undoc_in_sourcer6 rK rd r � ImportErrorr" r# r
r? �inspectZ
getmembers�hasattrri Z
isfunctionr8 �__doc__r Zisclassr7 �dir�__dict__r �AttributeErrorZismethod)r: rF rf Z
skip_undocZmod_name�ignorer$ �mod�errrj rk r �objrb �attrsZ attr_name�attrZfull_attr_namer r r r@ � s�
"
�
z!CoverageBuilder.build_py_coveragec
C s� t �| jd�}g }t|d����}| jjr4t|dd� t| j� � �}|D �]>}| j| }d|v rr|�
||d f� qF|d s�|d s�qFt||� |d �r:|� d� |� d d
� |d D �� | jj
�r0| jjs�| jjr�|d D ]}t�td �||� q�n:|d D ]0}t�td �d
d d| td� | � � q�|� d� |d rF|� d� t|d �� �D �] \}} | �s�|� d| � | jj
�rx| jj�s�| jj�r�t�td�||� n*t�td �d
d d| td� | � n�|� d| � |� dd
� | D �� | jj
�r\| jj�s| jj�r:| D ]}
t�td�|||
� �q n>| D ]8}
t�td �d
d d|d |
td� | � �q>�q\|� d� qF|�r�t|d� |� d d
� |D �� W d � n1 �s�0 Y d S ) Nz
python.txtrS zUndocumented Python objectsrT rg rk rj z Functions:
c s s | ]}d | V qdS )� * %s
Nr ��.0�xr r r � <genexpr>� � z4CoverageBuilder.write_py_coverage.<locals>.<genexpr>z&undocumented python function: %s :: %srU zpy z
function rV z
- in module r z Classes:
rz z#undocumented python class: %s :: %sz
class z * %s -- missing methods:
c s s | ]}d | V qdS )z - %s
Nr r{ r r r r~ r z*undocumented python method: %s :: %s :: %sz
method �.z Modules that failed to importc s s | ]}d | V qdS )z * %s -- %s
Nr r{ r r r r~ ) r )r r/ rW rJ r- rX r rY r? �keysr r �
writelinesrZ r[ r\ r] r" r# r
r^ r r4 ) r: r_ Zfailedr` r� r rP �func�
class_name�methodsZmethr r r rA � s�
� ���
�
�����
�
�
����
z!CoverageBuilder.write_py_coveragec C sP t �| jd�}t|d��$}t�| j| jf|� W d � n1 sB0 Y d S )Nz undoc.pickle�wb)r r/ rW rJ �pickle�dumpr? rB )r: Z
picklepathZdumpfiler r r �finish+ s zCoverageBuilder.finish)�__name__ri � __qualname__rp r r
r �sep�epilogr< �strr= r r rC rD �boolrd r@ rA r� r r r r r& / s �� [Cr& )r[ r c C s� | � t� | �dg d� | �dg d� | �dg d� | �dg d� | �dg d� | �di d� | �di d� | �d d
d� | �d dd� | �d dd� tjd
d
�S )Nr( Fr* r) r+ r. r3 r' rX Trl rZ )�versionZparallel_read_safe)Z add_builderr& Zadd_config_value�sphinxZ__display_version__)r[ r r r �setup2 s
r� )r )&rp r1 rn r� r � importlibr �osr �typingr r r r r r r
r� Zsphinx.applicationr Zsphinx.buildersr Z
sphinx.localer
Z sphinx.utilr Zsphinx.util.consoler Zsphinx.util.inspectr Z getLoggerr� r" r� r r% r& r� r r r r �<module> s* $