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 deZ#de
dee$ef fddZ%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)AnyDictListTuplecast) package_dir)Sphinx)Builder)ChangeSetDomain)___)HTMLThemeFactory)logging)bold)copy_asset_file) ensurediros_pathc @ sr e Zd ZdZdZedZdddZdefdd Z d
d d d
Z
de ddfddZ dededefddZ
dddZdS )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 )Ndefault)create_template_bridger appcreatetheme templatesinit)self
theme_factory r 9/usr/lib/python3/dist-packages/sphinx/builders/changes.pyr $ s
zChangesBuilder.initc C s | j S N)outdirr r r r! get_outdated_docs* s z ChangesBuilder.get_outdated_docsaddedchanged
deprecated) versionaddedversionchangedr( ignoredc
s2 | j j}tt| jd}i }g }i }||}|s'tt t
d| d S tt t
d |D ]}t |j t
r@|j d } n|j } | j|j }
|jdd} | rs|jdrs| rbd| |
| f } nd | |
f } || |j|jf q2| sx|jr|jp~td
}
| std } | rd| |
| f } nd | |
f } ||
g | |j|jf q2| sq2d |
| 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&dddd}|'| j()d| W d n 1 s w Y t#t$%| j&dddd}|'| j()d| W d n 1 s3w Y d| d| d| gdt*dt+dt+ffdd tt t
d | jj,D ]}t#| j-|| jj j.d(}z|/ }W n t0y t1t
d | Y W d q]w W d n 1 sw 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 sw Y q]d'd( | j67i 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%s: %s: %sz%s: %s.Builtinsz Module levelz
%s: %s) projectversion docstitle
shorttitle
libchanges
apichanges otherchangesshow_copyright show_sphinxz
index.htmlwutf8)encodingzchanges/frameset.htmlz changes.htmlzchanges/versionchanges.htmlz.. versionadded:: %sz.. versionchanged:: %sz.. deprecated:: %snoliner c s6 d| t | } D ]
}||v rd| } |S q |S )Nz z%s)htmlescape)r< r= x)hltextr r! hlt s z ChangesBuilder.write..hlzcopying source files...z(could not read %r for changelog creationrstz.htmlzutf-8 c 3 s" | ] \}} |d |V qdS ) Nr ).0ir= )rB r r! s z'ChangesBuilder.write..)filenametextzchanges/rstsource.htmlc S s i | ] \}}d | |qS )theme_r )rF keyvalr r r!
s z(ChangesBuilder.write..themesr staticz
default.css_t)contextrendererbasicz basic.css):configr1 r r env
get_domainget_changesets_forloggerinfor r
isinstancedescnametupletypemaptypecontentreplacedocname
startswithappendlinenomoduler
setdefault
capitalizetitlesastextr0
html_titlehtml_short_titlesorteditemshtml_show_copyrighthtml_show_sphinxopenr joinr# writer renderintstrall_docsdoc2pathsource_encoding readlinesUnicodeDecodeErrorwarningr r dirname enumerater get_optionsr r )r r+ r1 domainr4 r5 r6
changesetsr, r[ ttextrQ entryre titlectxfra linestargetfnrJ 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.. %s:: %s)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 ddddS )NbuiltinT)r1 parallel_read_safeparallel_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! s$