o
Ni. @ s d Z ddlmZ ddlZddlmZ ddlmZ ddlm Z ddl
m Z ddl m
Z
mZ dd lmZ dd
lmZ dd lmZ dd lmZ dd
lmZmZ er`ddlmZ ddl m Z ddl m Z e e!Z"G dd de Z#dddZ$dS )zChangelog builder. ) annotationsN)path)
TYPE_CHECKING) package_dir)Builder)___)HTMLThemeFactory)logging)bold)copy_asset_file) ensurediros_path)Set)Sphinx)ExtensionMetadatac @ s\ e Zd ZdZdZedZdddZd d d
Zd d d
ddZ d ddZ
d ddZ dddZ dS ) ChangesBuilderzV
Write a summary with all versionadded/changed/deprecated/removed directives.
changesz#The overview file is in %(outdir)s.returnNonec C s2 | t| j}|d| _| j| | j d S )Ndefault)create_template_bridger appcreatetheme templatesinit)self
theme_factory r K/home/ubuntu/.local/lib/python3.10/site-packages/sphinx/builders/changes.pyr # s
zChangesBuilder.initstrc C s
t | jS N)r! outdirr r r r get_outdated_docs) s
z ChangesBuilder.get_outdated_docsaddedchanged
deprecatedremoved) versionaddedversionchangedr( versionremoved _docnamesSet[str]c
sX | j j}| jjj}i }g }i }||}|s"ttt d| d S ttt d |D ]}t
|j t r;|j d } n|j } | j
|j }
|jdd} | ru|jdru| rad| d|
d | } n d| d|
d
} || |j|jf q-| sz|jr|jptd }
| std } | rd| d|
d | } n d| d|
d
} ||
g | |j|jf q-| sq-d
|
d | } | jj|j }||j|fg | |j|jf q-| j j|| j j | j j t | t |t | | j j | j j!d }t"t#$| j%dddd}|&| j'(d| W d n 1 sw Y t"t#$| j%dddd}|&| j'(d| W d n 1 s>w Y d| d| d| d| gd7fd d ttt d! | jj)D ]}t"| j*|| jj j+d(}z|, }W n t-y t.t d"| Y W d qiw W d n 1 sw Y t#$| j%d#t/|d$ }t0t#1| t"|dd%d,}d&$ fd'd(t2|D }t3| j*|d)|d*}|&| j'(d+| W d n 1 sw Y qid,d- | j45i D }t6t#$t7d.d/d0d1| j%|| j'd2d3 t6t#$t7d.d4d0d5| j%d5 d2d6 d S )8Nzno 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:: z.. versionchanged:: z.. deprecated:: z.. versionremoved:: nointliner! r c s6 d| t | } D ]
}||v rd| } |S q |S )Nz z%s)htmlescape)r> r@ x)hltextr r hl{ s z*ChangesBuilder.write_documents..hlzcopying source files...z(could not read %r for changelog creationrstz.htmlzutf-8 c 3 s" | ] \}} |d |V qdS ) Nr ).0ir@ )rE r r s z1ChangesBuilder.write_documents..F)filenametextzchanges/rstsource.htmlc S s i | ] \}}d | |qS )theme_r )rI keyvalr r r
s z2ChangesBuilder.write_documents..themesr staticzdefault.css.jinjaT)contextrendererforcebasicz basic.css)rV )r> r? r@ r! r r! )8configr3 envdomainschangeset_domainget_changesets_forloggerinfor r
isinstancedescnametupletypemaptypecontentreplacedocname
startswithappendlinenomoduler
setdefault
capitalizetitlesastextr2
html_titlehtml_short_titlesorteditemshtml_show_copyrighthtml_show_sphinxopenr joinr# writer renderall_docsdoc2pathsource_encoding readlinesUnicodeDecodeErrorwarningr r
dirname enumerater! r get_optionsr r )r r- r3 domainr6 r7 r8
changesets changesetr` ttextrT entryrj titlectxfrf linestargetfnrM themectxr )rE rD r write_documents3 s
z ChangesBuilder.write_documentsrM r3 c C s> t |}dD ]}|d| d| d| d| d}q|S )N)r+ r* r( r, z.. z:: z.. z)rA rB re )r rM r3 directiver r r rE s
zChangesBuilder.hlc C s d S r" r r$ r r r finish s zChangesBuilder.finishN)r r )r r! )r- r. r r )rM r! r3 r! r r! )
__name__
__module__ __qualname____doc__namer epilogr r% rb r rE r r r r r r s
u
r r r r r c C s | t ddddS )NbuiltinT)r3 parallel_read_safeparallel_write_safe) add_builderr )r r r r setup s
r )r r r r )%r
__future__r rA osr typingr sphinxr sphinx.buildersr
sphinx.localer r sphinx.themingr sphinx.utilr
sphinx.util.consoler sphinx.util.fileutilr sphinx.util.osutilr
r collections.abcr sphinx.applicationr sphinx.util.typingr getLoggerr r] r r r r r r s*