Fe d Z ddlmZ ddlZddlmZ ddlmZmZm Z ddl
m Z ddl m
Z
ddlmZ dd lmZmZ dd
lmZ dd lmZ dd lmZ dd
lmZ ddlm Z m Z erddl m Z ej@ e! Z" G d de
Z#ddZ$y)zChangelog builder. ) annotationsN)path)
TYPE_CHECKINGAnycast) package_dir)Builder)ChangeSetDomain)___)HTMLThemeFactory)logging)bold)copy_asset_file) ensurediros_path)Sphinxc X e Zd ZdZdZ ed ZddZddZdddd Z dd
Z
dd Z dd Z y
)ChangesBuilderzC
Write a summary with all versionadded/changed directives.
changesz#The overview file is in %(outdir)s.c | j t | j }|j d | _ | j
j
| | j y )Ndefault)create_template_bridger
appcreatetheme templatesinit)self
theme_factorys 9/usr/lib/python3/dist-packages/sphinx/builders/changes.pyr zChangesBuilder.init sF ##%(2
")))4
D$**- c , t | j S N)stroutdirr s r! get_outdated_docsz ChangesBuilder.get_outdated_docs& s 4;; r" addedchanged
deprecated) versionaddedversionchangedr+ c
>
| j j }t t | j j d }i }g }i }|j
| }|s+t j t t d |z y t j t t d |D ] }t |j t r|j d } n |j } | j |j }
|j j# dd } | r[|j$ j' d r@| r d| d |
d
| } n d| d |
d } |j) | |j$ |j* f | s |j, rw|j, xs t/ d }
| s t/ d
} | r d| d |
d
| } n d| d |
d } |j1 |
g j) | |j$ |j* f Q| sUd|
j3 d
| } | j j4 |j$ j7 }|j1 |j$ |fg j) | |j$ |j* f | j j8 || j j: | j j< t? |jA t? | t? |jA | j jB | j jD d }tG tI jJ | jL d dd 5 }|jO | jP jS d| d d d tG tI jJ | jL d dd 5 }|jO | jP jS d| d d d d|z d|z d|z gd-fd t j t t d | j jT D ]1 }tG | j jW | | j j jX 5 } |j[ } d d d tI jJ | jL d ta | d z }tc tI jd | tG |dd 5 }d jK fd!tg D }| j jW |d" |d#}|jO | jP jS d$| d d d 4 | jh jk i jA D ci c] \ }}d%|z |
}}}tm tI jJ tn d&d'd(d) | jL || jP * tm tI jJ tn d&d+d(d, | jL y # 1 sw Y xY w# 1 sw Y LxY w# t\ $ r+ t j_ t d | Y d d d 1w xY w# 1 sw Y xY w# 1 sw Y LxY wc c}}w ).N changesetzno changes in version %s.zwriting summary file...r
zc-apizz : z: z.Builtinsz Module levelz) projectversion docstitle
shorttitle
libchanges
apichanges otherchangesshow_copyright show_sphinxz
index.htmlwutf8)encodingzchanges/frameset.htmlz changes.htmlzchanges/versionchanges.htmlz.. versionadded:: %sz.. versionchanged:: %sz.. deprecated:: %sc d d| z t j | z }D ] }||v sd|z } |S |S )Nz z%s)htmlescape)nolinexhltexts r! hlz ChangesBuilder.write..hln sJ (2- D0AAD
97$>DK
Kr" zcopying source files...z(could not read %r for changelog creationrstz.htmlzutf-8 c 3 < K | ] \ }} |d z | yw) N ).0irC rF s r! z'ChangesBuilder.write.. s Q9Atr!a% Qs F)filenametextzchanges/rstsource.htmltheme_themesr staticz
default.css_t)contextrendererbasicz basic.css)rB intrC r% returnr% )8configr4 r r
env
get_domainget_changesets_forloggerinfor r
isinstancedescnametupletypemaptypecontentreplacedocname
startswithappendlinenomoduler
setdefault
capitalizetitlesastextr3
html_titlehtml_short_titlesorteditemshtml_show_copyrighthtml_show_sphinxopenr joinr& writer renderall_docsdoc2pathsource_encoding readlinesUnicodeDecodeErrorwarningr r dirname enumerater get_optionsr r )r ignoredr4 domainr7 r8 r9
changesetsr/ r` ttextrT entryrj titlectxfrf linestargetfnrP keyvalthemectxrF rE s @@r! rw zChangesBuilder.write/ s ++%%otxx':':;'GH<>
13
JL ..w7
KKR ; >@
CD KKME
yyeWW5EFPH dll8, -hg6
N!ww Q %@P QQ $ 1 1'5 A --.FLM
N
N N$ JJ**2.4468JS#HsNC' 8 8 +xHo^ X P +x(KX %O I I O O* * NN2&P#QSZ[
N
N8sU %,X.,X;Y?YA.Z +Z.X8;Y(Y<0Y?;Y<<Y??Z Z c | t j | }dD ]! }|j d| d| d| d| d }# |S )N)r- r, r+ z.. z:: z.. z)r@ rA re )r rP r4 directives r! rF zChangesBuilder.hl sX {{4 I FI<<#i[G9 ="( 3wit DFD F r" c y r$ rK r' s r! finishzChangesBuilder.finish s r" N)rX None)rX r% )r r rX r )rP r% r4 r% rX r% )
__name__
__module__ __qualname____doc__namer epilogr r( rb rw rF r rK r" r! r r sF D
5
6F. #"G ^%@
r" r c 8 | j t ddddS )NbuiltinT)r4 parallel_read_safeparallel_write_safe) add_builderr )r s r! setupr s# OON# " # r" )r r rX zdict[str, Any])%r
__future__r r@ osr typingr r r sphinxr sphinx.buildersr sphinx.domains.changesetr
sphinx.localer r sphinx.themingr
sphinx.utilr sphinx.util.consoler sphinx.util.fileutilr sphinx.util.osutilr r sphinx.applicationr getLoggerr r] r r rK r" r! r s^ " + + # 4 + $ 0 1) 8 $~
W ~
Br"