B
d @ 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 deZ#e
ee$ef dddZ%dS )zChangelog builder. N)path)AnyDictListTuplecast) package_dir)Sphinx)Builder)ChangeSetDomain)___)HTMLThemeFactory)logging)bold)copy_asset_file) ensurediros_pathc @ st e Zd ZdZdZedZddddZeddd Z d
d d d
Z
e ddddZ eeedddZ
ddddZdS )ChangesBuilderzC
Write a summary with all versionadded/changed directives.
changesz#The overview file is in %(outdir)s.N)returnc C s2 | t| j}|d| _| j| | j d S )Ndefault)Zcreate_template_bridger appcreatetheme templatesinit)selfZ
theme_factory r d/work/yifan.wang/ringdown/master-ringdown-env/lib/python3.7/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_docsaddedchanged
deprecated) versionaddedversionchangedr$ )ignoredr c
s | j j}tt| jd}i }g }i }||}|sNtt t
d| d S tt t
d xB|D ]8}t |j t
r|j d } n|j } | j|j }
|jdd} | r|jdr| rd| |
| f } n d | |
f } || |j|jf qh| s|jrV|jptd
}
| std } | r,d| |
| f } n d | |
f } ||
g | |j|jf qh| s^qhd |
| f } | jj|j }||j|fg | |j|jf qhW | j j || j j | j j t | t |t | | j j!| j j"d
}t#t$%| j&dddd}|'| j()d| W d Q R X t#t$%| j&dddd}|'| j()d| W d Q R X d| d| d| gt*t+t+dfdd tt t
d x| jj,D ]}t#| j-|| jj j.d>}y |/ }W n* t0k
r t1t
d | wY nX W d Q R X t$%| j&d t2|d }t3t$4| t#|dd dJ}d % fd!d"t5|D }| j-|d#|d$}|'| j()d%| W d Q R X qW d&d' | j67i 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%s: %s: %sz%s: %s.ZBuiltinsz Module levelz
%s: %s) projectversionZ docstitleZ
shorttitle
libchanges
apichanges otherchangesZshow_copyrightZ show_sphinxz
index.htmlwutf8)encodingzchanges/frameset.htmlz changes.htmlzchanges/versionchanges.htmlz.. versionadded:: %sz.. versionchanged:: %sz.. deprecated:: %s)noliner c s6 d| t | }x D ]}||krd| }P qW |S )Nz z%s)htmlescape)r3 r4 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 ).0ir4 )r9 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):configr, r r envZ
get_domainZget_changesets_forloggerinfor r
isinstancedescnametupletypemaptypecontentreplacedocname
startswithappendlinenomoduler
setdefault
capitalizetitlesZastextr+ Z
html_titleZhtml_short_titlesorteditemsZhtml_show_copyrightZhtml_show_sphinxopenr joinr writer renderintstrZall_docsZdoc2pathZsource_encoding readlinesUnicodeDecodeErrorwarningr r dirname enumerater Z get_optionsr r )r r' r, domainr- r. r/ Z
changesetsr( rN ZttextrF entryrX titlectxfrT linesZtargetfnrA Zthemectxr )r9 r8 r r` + s
$zChangesBuilder.write)rA r, r c C s8 t |}x(dD ] }|d||f d||f }qW |S )N)r& r% r$ z
.. %s:: %sz.. %s:: %s)r5 r6 rS )r rA r, directiver r r r9 s
zChangesBuilder.hlc C s d S )Nr )r r r r finish s zChangesBuilder.finish)__name__
__module__ __qualname____doc__namer
epilogr rc r! rP r r` r9 rp r r r r r s br )r r c C s | t ddddS )NbuiltinT)r, Zparallel_read_safeZparallel_write_safe)Z add_builderr )r r r r setup s
rx )&rt r5 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 getLoggerrq rK r rc rx r r r r s"