B
\ @ s d Z ddlZddlmZ ddlmZ ddlmZ ddlm Z ddl
m Z ddl m
Z
dd lmZmZ dd
lmZ dd lmZ dd lmZ dd
lmZ ddlmZmZ ddl m Z e e Z G dd de Z!dd Z"dS )z
sphinx.builders.changes
~~~~~~~~~~~~~~~~~~~~~~~
Changelog builder.
:copyright: Copyright 2007-2019 by the Sphinx team, see AUTHORS.
:license: BSD, see LICENSE for details.
N)path)cast) iteritems) package_dir)Builder)ChangeSetDomain)___)HTMLThemeFactory)logging)bold)copy_asset_file) ensurediros_path)
htmlescapec @ sP e Zd ZdZdZedZdd Zdd Zdd d
d Z d d
Z
dd Z dd Z dS )ChangesBuilderzC
Write a summary with all versionadded/changed directives.
Zchangesz#The overview file is in %(outdir)s.c C s2 | t| j}|d| _| j| | j d S )Ndefault)Zcreate_template_bridger
appZcreatetheme templatesinit)selfZ
theme_factory r 6lib/python3.7/site-packages/sphinx/builders/changes.pyr - s
zChangesBuilder.initc C s | j S )N)outdir)r r r r get_outdated_docs4 s z ChangesBuilder.get_outdated_docsZaddedZchanged
deprecated) versionaddedversionchangedr c
s | j j}tt| jd}i }g }i }|| jjkrLtt t
d| d S tt d xH| |D ]8}t |j
tr|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 |t t!|| j j"| j j#d
}t$%t&'| j(ddd}|)| j*+d| W d Q R X t$%t&'| j(ddd}|)| j*+d| W d Q R X d| d| d| gfdd tt t
d x| jj,D ]}t$%| j-|d| jj j.>}y |/ }W n* t0k
r t1t
d| wY nX W d Q R X t&'| j(d t2|d }t3t&4| t$%|dd J}d ' fd d!t5|D }| j-|d |d"}|)| j*+d#| W d Q R X qW t6d$d! t!| j78i D }t9t&'t:d%d&d'd(| j(|| j*d) t9t&'t:d%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.htmlwutf8zchanges/frameset.htmlz changes.htmlzchanges/versionchanges.htmlz.. versionadded:: %sz.. versionchanged:: %sz.. deprecated:: %sc s4 d| t | }x D ]}||krd| }P qW |S )Nz z%s)r )Znolinex)hltextr r hl~ s
z ChangesBuilder.write..hlzcopying source files...rz(could not read %r for changelog creationZrstz.htmlzutf-8 c 3 s | ]\}} |d |V qdS ) Nr ).0ir) )r, r r s z'ChangesBuilder.write..)filenametextzchanges/rstsource.htmlc s s | ]\}}d | |fV qdS )Ztheme_Nr )r0 keyvalr r r r2 s Zthemesr Zstaticz
default.css_t)contextZrendererZbasicz basic.css);Zconfigr# r r envZ
get_domainZversionchangesloggerinfor r Zget_changesets_for
isinstancedescnametupletypemaptypeZcontentreplacedocname
startswithappendlinenomoduler
setdefault
capitalizeZtitlesZastextr" Z
html_titleZhtml_short_titlesortedr Zhtml_show_copyrightZhtml_show_sphinxcodecsopenr joinr writer ZrenderZall_docsZdoc2pathZsource_encoding readlinesUnicodeDecodeErrorZwarningr r dirname enumeratedictr Z get_optionsr
r )r Zignoredr# Zdomainr$ r% r& r r< Zttextr7 entryrE titleZctxfrA linesZtargetfnr4 Zthemectxr )r, r+ r rL > s
$zChangesBuilder.writec C s6 t |}x(dD ] }|d||f d||f }qW |S )N)r r r z
.. %s:: %sz.. %s:: %s)r r@ )r r4 r# Z directiver r r r, s
zChangesBuilder.hlc C s d S )Nr )r r r r finish s zChangesBuilder.finishN)
__name__
__module__ __qualname____doc__namer Zepilogr r r> rL r, rV r r r r r & s br c C s | t ddddS )NZbuiltinT)r# Zparallel_read_safeZparallel_write_safe)Z add_builderr )r r r r setup s
r\ )#rZ rI osr typingr Zsixr Zsphinxr Zsphinx.buildersr Zsphinx.domains.changesetr Z
sphinx.localer r Zsphinx.themingr
Z sphinx.utilr Zsphinx.util.consoler Zsphinx.util.fileutilr
Zsphinx.util.osutilr r Zsphinx.util.pycompatr Z getLoggerrW r9 r r\ r r r r
s$