-PhT d Z ddlmZ ddlZddlmZ ddlmZ ddlm Z ddl
m Z ddl m
Z
mZ dd lmZ dd
lmZ dd lmZ erdd lmZ dd
lmZ ddlmZ ej e Z G d de Z ddZ dS )zChangelog builder. ) annotationsN)
TYPE_CHECKING) package_dir)bold)Builder)___)HTMLThemeFactory)logging)copy_asset_file)Set)Sphinx)ExtensionMetadatac b e Zd ZdZdZ ed ZddZddZd d
d d d
Z ddZ
ddZ ddZ dS )ChangesBuilderzLWrite a summary with all versionadded/changed/deprecated/removed directives.changesz#The overview file is in %(outdir)s.returnNonec | t | j }| d | _ | j | | j d S )Ndefault)create_template_bridger
appcreatetheme templatesinit)self
theme_factorys W/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/sphinx/builders/changes.pyr zChangesBuilder.init sX ##%%%(22
")))44
D$*----- strc * t | j S N)r! outdirr s r get_outdated_docsz ChangesBuilder.get_outdated_docs% s 4; r addedchanged
deprecatedremoved) versionaddedversionchangedr) versionremoved _docnamesSet[str]c
| j j }| j j j }i }g }i }| | }|s7t t t d | d S t t t d |D ]}|j
} | j |j }
|j
dd } | rT|j d r:| r d| d|
d| } n d| d|
d } | | |j |j f | s|j rv|j pt) d
}
| st) d } | r d| d|
d| } n d| d|
d } | |
g | |j |j f | sd |
d| } | j j |j }| |j |fg | |j |j f | j j || j j | j j t9 | t9 | t9 | | j j | j j d
}tA | j! dz dd 5 }|" | j# $ d| d d d n # 1 swxY w Y tA | j! dz dd 5 }|" | j# $ d| d d d n # 1 swxY w Y d| d| d| d| gd4fd t t t d | j j% D ]}tA | j & | | j j' 5 } |( }nC# tR $ r6 t * t d | Y d d d w xY w d d d n # 1 swxY w Y d!+ fd"tY | D }t[ | j & |d# |d$}| j# $ d%| }| j! d&z | d'z }|j. / d(d() tA |dd* 5 }|" | d d d n # 1 swxY w Y d+ | j0 1 i D }te tg j4 d,d-d.d/ | j! || j# d(0 te tg j4 d,d1d.d2 | j! d2z d(3 d S )5Nzno changes in version %s.zwriting summary file...
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:: z.. versionchanged:: z.. deprecated:: z.. versionremoved:: nointliner! r c \ d| z t j | z }D ]
}||v rd|z } n|S )Nz z%s)htmlescape)r@ rB xhltexts r hlz*ChangesBuilder.write_documents..hlt sO (2- D0A0AAD
997$>DE Kr zcopying source files...z(could not read %r for changelog creation c 3 < K | ]\ }} |d z | V dS ) N ).0irB rH s r z1ChangesBuilder.write_documents.. s5 MMy422a!eT??MMMMMMr F)filenametextzchanges/rstsource.htmlrstz.htmlT)parentsexist_okzutf-8c i | ] \ }}d |z | S )theme_rL )rM keyvals r
z2ChangesBuilder.write_documents.. s/
$.S#HsNC
r themesr staticzdefault.css.jinja)contextrendererforcebasicz basic.css)r^ )r@ rA rB r! r r! )5configr5 envdomainschangeset_domainget_changesets_forloggerinfor r descnametypemaptypecontentreplacedocname
startswithappendlinenomoduler
setdefault
capitalizetitlesastextr4
html_titlehtml_short_titlesorteditemshtml_show_copyrighthtml_show_sphinxopenr$ writer renderall_docsdoc2pathsource_encoding readlinesUnicodeDecodeErrorwarningjoin enumerater! parentmkdirr get_optionsr r joinpath)r r. r5 domainr8 r9 r:
changesets changesetrg ttextr\ entryrp titlectxfrl linesrQ renderedtargetfnthemectxrH rG s @@r write_documentsz ChangesBuilder.write_documents/ s +%!2<>
13
JL ..w77
KKR ; < <==w G G G F D 56677888# I )HL 0E '//c::G
I - 8 8 A A
B K( K KU K K' K KEE A( A AU A A AE!!5)*;Y=M"NOOOO
Y -
"):Qz]] 1 0 0H B K( K KU K K' K KEE A( A AU A A AE%%fb1188 % $: Ae . . 0 0AAAA (9:AACC ''):E(BBGGNN % $P {* / +6 !1!1!3!344 ,, "<#5#5#7#7 8 8 "k = ;7
$+ ,cF
C
C
C Iq
GGDN))*A3GG H H H I I I I I I I I I I I I I I I
$+.f
E
E
E O
GGDN))*GMM N N N O O O O O O O O O O O O O O O
+ * * ,7 , , (w ( ( ,7 , ,
D 56677888x( " "G!!'**T[5P
KKMMEE) NNEFF
77MMMMIe->->>H O ! !$ ! > > >hg666
"!!!!
"
"
"
"
"
"
"
"
"
"
"
"
"
"
"
26*2H2H2L2L2R2R2T2T
9h@S T T K ^
7Hk J J K+ %
sl /LL !L ?/M::M>M>Q:P*)Q:*2Q* Q:)Q**Q::Q> Q> 7UU U rQ r5 c ~ t j | }dD ]%}| d| d| d| d| d }&|S )N)r, r+ r) r- z.. z:: z.. z)rD rE rk )r rQ r5 directives r rH zChangesBuilder.hl si {4
I <<-i--G--/S /S/Sg/S/S/S DD r c d S r# rL r% s r finishzChangesBuilder.finish s r N)r r )r r! )r. r/ r r )rQ r! r5 r! r r! )
__name__
__module__ __qualname____doc__namer epilogr r& rh r rH r rL r r r r s VV D
R5
6
6F. . . . #"# Gq
q
q
q
f
r r r r r r c B | t ddddS )NbuiltinT)r5 parallel_read_safeparallel_write_safe) add_builderr )r s r setupr s. OON### " # r )r r r r ) r
__future__r rD typingr sphinxr sphinx._cli.util.colourr sphinx.buildersr
sphinx.localer r sphinx.themingr
sphinx.utilr sphinx.util.fileutilr collections.abcr
sphinx.applicationr sphinx.util.typingr getLoggerr re r r rL r r r s] " " " " " " ( ( ( ( ( ( # # # # # # + + + + + + 0 0 0 0 0 0 5######))))))444444 8 $ $W
W
W
W
W
W W
W
W
t r