| 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/builders/__pycache__/ |
Upload File : |
a
�ab� � @ s� d Z ddlZddlmZ ddlmZmZmZmZm Z ddl
m Z ddl m
Z
ddlmZ ddlmZ dd lmZmZ dd
lmZ dd lmZ dd lmZ dd
lm Z ddl m Z m Z e� e!�Z"G dd� de�Z#e
ee$ef d�dd�Z%dS )z�
sphinx.builders.changes
~~~~~~~~~~~~~~~~~~~~~~~
Changelog builder.
:copyright: Copyright 2007-2022 by the Sphinx team, see AUTHORS.
:license: BSD, see LICENSE for details.
� N)�path)�Any�Dict�List�Tuple�cast)� package_dir)�Sphinx)�Builder)�ChangeSetDomain)�_�__)�HTMLThemeFactory)�logging)�bold)�copy_asset_file)� ensuredir�os_pathc @ st e Zd ZdZdZed�Zdd�dd�Zed�dd �Z d
d d d
�Z
e dd�dd�Z eeed�dd�Z
dd�dd�ZdS )�ChangesBuilderzC
Write a summary with all versionadded/changed directives.
Zchangesz#The overview file is in %(outdir)s.N)�returnc C s2 | � � t| j�}|�d�| _| j�| | j� d S )N�default)Zcreate_template_bridger �appZcreate�theme� templates�init)�selfZ
theme_factory� r �;/usr/lib/python3.9/site-packages/sphinx/builders/changes.pyr $ s
zChangesBuilder.initc C s | j S �N)�outdir�r r r r �get_outdated_docs* s z ChangesBuilder.get_outdated_docsZaddedZchanged�
deprecated)� versionadded�versionchangedr" )�ignoredr c
s@ | j j}tt| j�d��}i }g }i }|�|�}|sNt�t t
d�| �� d S t�t t
d��� |D �]8}t |j t
�r�|j d } n|j } | j|j }
|j�dd�} | r�|j�d�r�| r�d| |
| f } n d | |
f } |�| |j|jf� qd| s�|j�rR|j�ptd
�}
| �std �} | �r(d| |
| f } n d | |
f } |�|
g ��| |j|jf� qd| �sZqdd |
�� | f } | jj|j �� }|�|j|fg ��| |j|jf� qd| j j || j j | j j t |� � �t |�t |� � �| j j!| j j"d
� }t#t$�%| j&d�ddd��$}|�'| j(�)d|�� W d � n1 �s$0 Y t#t$�%| j&d�ddd��$}|�'| j(�)d|�� W d � n1 �sr0 Y d| d| d| g�t*t+t+d��fdd� � t�t t
d��� | jj,D �] }t#| j�-|�| jj j.d��T}z |�/� }W n6 t0�y& t�1t
d �|� Y W d � �q�Y n0 W d � n1 �s>0 Y t$�%| j&d t2|��d }t3t$�4|�� t#|dd d��T}d �%� fd!d"�t5|�D ��}| j�-|d �|d#�}|�'| j(�)d$|�� W d � n1 �s�0 Y �q�d%d&� | j6�7i �� � D �}t8t$�%t9d'd(d)d*�| j&|| j(d+� t8t$�%t9d'd,d)d-�| j&� d S ).N� changesetzno changes in version %s.zwriting summary file...r �
� zc-apiz<b>%s</b>: <i>%s:</i> %sz<b>%s</b>: <i>%s</i>.ZBuiltinsz Module levelz
<i>%s:</i> %s) �project�versionZ docstitleZ
shorttitle�
libchanges�
apichanges� otherchangesZshow_copyrightZ show_sphinxz
index.html�w�utf8)�encodingzchanges/frameset.htmlz changes.htmlzchanges/versionchanges.htmlz.. versionadded:: %sz.. versionchanged:: %sz.. deprecated:: %s)�no�liner c s4 d| t �|� }� D ]}||v rd| } q0q|S )Nz<a name="L%s"> </a>z<span class="hl">%s</span>)�html�escape)r1 r2 �x)�hltextr r �hlt s z ChangesBuilder.write.<locals>.hlzcopying source files...z(could not read %r for changelog creationZrstz.htmlzutf-8� c 3 s | ]\}}� |d |�V qdS )� Nr )�.0�ir2 )r7 r r � <genexpr>� � z'ChangesBuilder.write.<locals>.<genexpr>)�filename�textzchanges/rstsource.htmlc S s i | ]\}}d | |�qS )Ztheme_r )r: �key�valr r r �
<dictcomp>� r= z(ChangesBuilder.write.<locals>.<dictcomp>Zthemesr Zstaticz
default.css_t)�contextZrendererZbasicz basic.css):Zconfigr* r r �envZ
get_domainZget_changesets_for�logger�infor r
�
isinstance�descname�tuple�typemap�typeZcontent�replace�docname�
startswith�append�lineno�moduler �
setdefault�
capitalizeZtitlesZastextr) Z
html_titleZhtml_short_title�sorted�itemsZhtml_show_copyrightZhtml_show_sphinx�openr �joinr �writer Zrender�int�strZall_docsZdoc2pathZsource_encoding� readlines�UnicodeDecodeErrorZwarningr r �dirname� enumerater Z get_optionsr r )r r% r* �domainr+ r, r- Z
changesetsr& rH ZttextrC �entryrQ �title�ctx�frM �linesZtargetfnr? Zthemectxr )r7 r6 r rX 3 s�
� � � �
� 44� � 8 �8�
��zChangesBuilder.write)r? r* r c C s4 t �|�}dD ] }|�d||f d||f �}q|S )N)r$ r# r" z
.. %s:: %sz<b>.. %s:: %s</b>)r3 r4 rL )r r? r* Z directiver r r r7 � s
�zChangesBuilder.hlc C s d S r r r r r r �finish� s zChangesBuilder.finish)�__name__�
__module__� __qualname__�__doc__�namer
�epilogr rZ r! rJ r rX r7 re r r r r r s �br )r r c C s | � t� dddd�S )NZbuiltinT)r* Zparallel_read_safeZparallel_write_safe)Z add_builderr )r r r r �setup� s
�rl )&ri r3 �osr �typingr r r r r Zsphinxr Zsphinx.applicationr Zsphinx.buildersr
Zsphinx.domains.changesetr Z
sphinx.localer r
Zsphinx.themingr Z sphinx.utilr Zsphinx.util.consoler Zsphinx.util.fileutilr Zsphinx.util.osutilr r Z getLoggerrf rE r rZ rl r r r r �<module> s"