Dashboard
PHP:
8.2.30
OS:
Linux
User:
dh_nv8b2m
/
/
usr
/
lib
/
python3
/
dist-packages
/
sphinx
/
builders
/
__pycache__
📤 Upload
📝 New File
📁 New Folder
Close
Editing: 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$
Save
Cancel