File: //usr/lib/python3/dist-packages/sphinx/builders/__pycache__/changes.cpython-310.pyc
o
�$�a� � @ 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#de
dee$ef fdd�Z%dS )z�
sphinx.builders.changes
~~~~~~~~~~~~~~~~~~~~~~~
Changelog builder.
:copyright: Copyright 2007-2021 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 @ sr e Zd ZdZdZed�Zddd�Zdefdd �Z d
d d d
�Z
de ddfdd�Z dededefdd�Z
ddd�ZdS )�ChangesBuilderzC
Write a summary with all versionadded/changed directives.
�changesz#The overview file is in %(outdir)s.�returnNc C s2 | � � t| j�}|�d�| _| j�| | j� d S )N�default)�create_template_bridger �app�create�theme� templates�init)�self�
theme_factory� r �9/usr/lib/python3/dist-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_docs�added�changed�
deprecated)� versionadded�versionchangedr( �ignoredc
s2 | j j}tt| j�d��}i }g }i }|�|�}|s't�t t
d�| �� d S t�t t
d��� |D ]�}t |j t
�r@|j d } n|j } | j|j }
|j�dd�} | rs|j�d�rs| rbd| |
| f } nd | |
f } |�| |j|jf� q2| sx|jr�|jp~td
�}
| s�td �} | r�d| |
| f } nd | |
f } |�|
g ��| |j|jf� q2| s�q2d |
�� | f } | jj|j �� }|�|j|fg ��| |j|jf� q2| j j || j j | j j t |� � �t |�t |� � �| j j!| j j"d
� }t#t$�%| j&d�ddd��}|�'| j(�)d|�� W d � n 1 �s w Y t#t$�%| j&d�ddd��}|�'| j(�)d|�� W d � n 1 �s3w Y d| d| d| g�dt*dt+dt+f�fdd � � t�t t
d ��� | jj,D ]�}t#| j�-|�| jj j.d��(}z|�/� }W n t0�y� t�1t
d �|� Y W d � �q]w W d � n 1 �s�w Y t$�%| j&d t2|��d }t3t$�4|�� t#|dd!d��*}d"�%� fd#d$�t5|�D ��}| j�-|d �|d%�}|�'| j(�)d&|�� W d � n 1 �s�w Y �q]d'd(� | j6�7i �� � D �}t8t$�%t9d)d*d+d,�| j&|| j(d-� t8t$�%t9d)d.d+d/�| j&� d S )0N� changesetzno changes in version %s.zwriting summary file...r �
� zc-apiz<b>%s</b>: <i>%s:</i> %sz<b>%s</b>: <i>%s</i>.�Builtinsz Module levelz
<i>%s:</i> %s) �project�version� docstitle�
shorttitle�
libchanges�
apichanges� otherchanges�show_copyright� show_sphinxz
index.html�w�utf8)�encodingzchanges/frameset.htmlz changes.htmlzchanges/versionchanges.htmlz.. versionadded:: %sz.. versionchanged:: %sz.. deprecated:: %s�no�liner c s6 d| t �|� }� D ]
}||v rd| } |S q |S )Nz<a name="L%s"> </a>z<span class="hl">%s</span>)�html�escape)r< r= �x)�hltextr r! �hlt s �z ChangesBuilder.write.<locals>.hlzcopying source files...z(could not read %r for changelog creation�rstz.htmlzutf-8� c 3 s" � | ] \}}� |d |�V qdS )� Nr )�.0�ir= )rB r r! � <genexpr>� s � z'ChangesBuilder.write.<locals>.<genexpr>)�filename�textzchanges/rstsource.htmlc S s i | ] \}}d | |�qS )�theme_r )rF �key�valr r r! �
<dictcomp>� s z(ChangesBuilder.write.<locals>.<dictcomp>�themesr �staticz
default.css_t)�context�renderer�basicz basic.css):�configr1 r r �env�
get_domain�get_changesets_for�logger�infor r
�
isinstance�descname�tuple�typemap�type�content�replace�docname�
startswith�append�lineno�moduler �
setdefault�
capitalize�titles�astextr0 �
html_title�html_short_title�sorted�items�html_show_copyright�html_show_sphinx�openr �joinr# �writer �render�int�str�all_docs�doc2path�source_encoding� readlines�UnicodeDecodeError�warningr r �dirname� enumerater � get_optionsr r )r r+ r1 �domainr4 r5 r6 �
changesetsr, r[ �ttextrQ �entryre �title�ctx�fra �lines�targetfnrJ �themectxr )rB rA r! rr 3 s�
�
� � �
� � �� � �� � � ���
��zChangesBuilder.writerJ r1 c C s4 t �|�}dD ]}|�d||f d||f �}q|S )N)r* r) r( z
.. %s:: %sz<b>.. %s:: %s</b>)r> r? r` )r rJ r1 � directiver r r! rB � s
�zChangesBuilder.hlc C s d S r" r r$ r r r! �finish� s zChangesBuilder.finish)r N)�__name__�
__module__� __qualname__�__doc__�namer
�epilogr ru r% r] r rr rB r� r r r r! r s
�br r r c C s | � t� dddd�S )N�builtinT)r1 �parallel_read_safe�parallel_write_safe)� add_builderr )r r r r! �setup� s
�r� )&r� r> �osr �typingr r r r r �sphinxr �sphinx.applicationr �sphinx.buildersr
�sphinx.domains.changesetr �
sphinx.localer r
�sphinx.themingr � sphinx.utilr �sphinx.util.consoler �sphinx.util.fileutilr �sphinx.util.osutilr r � getLoggerr� rX r ru r� r r r r! �<module> s$