U
\ShJ @ s d Z ddlmZ ddlZddlmZ ddlmZmZ ddl m
Z
ddl m Z ddl
mZ dd lmZ dd
lmZmZ dd lmZ dd lmZ dd
lmZ ddlmZ ddl m Z m Z e e Z!G dd deZ"dddddZ#dS )zChangelog builder. ) annotationsN)path)Anycast) package_dir)Sphinx)Builder)ChangeSetDomain)___)HTMLThemeFactory)logging)bold)copy_asset_file) ensurediros_pathc @ st e Zd ZdZdZedZddddZddd d
Zd d d
dZ dddddZ
ddddddZ ddddZ dS )ChangesBuilderzC
Write a summary with all versionadded/changed directives.
changesz#The overview file is in %(outdir)s.None)returnc C s2 | t| j}|d| _| j| | j d S )Ndefault)Zcreate_template_bridger appcreatetheme templatesinit)selfZ
theme_factory r J/root/rtd-docs/venv/lib/python3.8/site-packages/sphinx/builders/changes.pyr s
zChangesBuilder.initstrc C s | j S N)outdirr r r r get_outdated_docs$ s z ChangesBuilder.get_outdated_docsaddedchanged
deprecated) versionaddedversionchangedr& r )ignoredr c
s | j j}tt| jd}i }g }i }||}|sNtt t
d| d S tt t
d |D ]Z}t |j t
r|j d } n|j } | j|j }
|jdd} | r|jdr| rd| d |
d
| } nd| d |
d } || |j|jf qd| s|jrp|jptd }
| s"td
} | r@d| d |
d
| } nd| d |
d } ||
g | |j|jf qd| sxqdd|
d
| } | jj|j }||j|fg | |j|jf qd| j j || j j | j j t | t |t | | j j!| j j"d }t#t$%| j&dddd}|'| j()d| W 5 Q R X t#t$%| j&dddd}|'| j()d| W 5 Q R X d| d| d| gdddd fd d tt t
d | jj*D ]}t#| j+|| jj j,dJ}z |- }W n6 t.k
r t/t
d | Y W 5 Q R qY nX W 5 Q R X t$%| j&d!t0|d" }t1t$2| t#|dd#dJ}d$% fd%d&t3|D }| j+|d'|d(}|'| j()d)| W 5 Q R X qd*d+ | j45i D }t6t$%t7d,d-d.d/| j&|| j(d0 t6t$%t7d,d1d.d2| j& d S )3N changesetzno changes in version %s.zwriting summary file...r
zc-apizz : z: z.ZBuiltinsz Module levelz) projectversionZ docstitleZ
shorttitle
libchanges
apichanges otherchangesZshow_copyrightZ show_sphinxz
index.htmlwutf8)encodingzchanges/frameset.htmlz changes.htmlzchanges/versionchanges.htmlz.. versionadded:: %sz.. versionchanged:: %sz.. deprecated:: %sintr )noliner c s4 d| t | } D ]}||krd| } q0q|S )Nz z%s)htmlescape)r6 r7 x)hltextr r hll s z ChangesBuilder.write..hlzcopying source files...z(could not read %r for changelog creationrstz.htmlzutf-8 c 3 s | ]\}} |d |V qdS ) Nr ).0ir7 )r< r r s z'ChangesBuilder.write..F)filenametextzchanges/rstsource.htmlc S s i | ]\}}d | |qS )Ztheme_r )r@ keyvalr r r
s z(ChangesBuilder.write..themesr Zstaticz
default.css_t)contextrendererbasicz basic.css)8configr. r r envZ
get_domainZget_changesets_forloggerinfor r
isinstancedescnametupletypemaptypecontentreplacedocname
startswithappendlinenomoduler
setdefault
capitalizetitlesZastextr- Z
html_titleZhtml_short_titlesorteditemsZhtml_show_copyrightZhtml_show_sphinxopenr joinr! writer renderZall_docsZdoc2pathZsource_encoding readlinesUnicodeDecodeErrorwarningr r dirname enumerater Z get_optionsr r )r r) r. domainr/ r0 r1 Z
changesetsr* rQ ZttextrI entryr[ titlectxfrW linesZtargetfnrD Zthemectxr )r< r; r rc - s
" zChangesBuilder.write)rD r. r c C s> t |}dD ]*}|d| d| d| d| d}q|S )N)r( r' r& z.. z:: z.. z)r8 r9 rV )r rD r. directiver r r r< s
zChangesBuilder.hlc C s d S r r r" r r r finish s zChangesBuilder.finishN)
__name__
__module__ __qualname____doc__namer epilogr r# rS rc r< rq r r r r r s `r r zdict[str, Any])r r c C s | t ddddS )NbuiltinT)r. Zparallel_read_safeZparallel_write_safe)Z add_builderr )r r r r setup s
ry )$ru
__future__r r8 osr typingr 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 getLoggerrr rN r ry r r r r s$