3
T'ícÙ ã @ 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 ej e!Z"G dd deZ#e
ee$ef dddZ%dS )zChangelog builder.é N)Úpath)ÚAnyÚDictÚListÚTupleÚcast)Ú package_dir)ÚSphinx)ÚBuilder)ÚChangeSetDomain)Ú_Ú__)ÚHTMLThemeFactory)Úlogging)Úbold)Úcopy_asset_file)Ú ensuredirÚos_pathc @ st e Zd ZdZdZedZddddZeddd Z d
d d d
Z
e ddddZ eeedddZ
ddddZdS )ÚChangesBuilderzC
Write a summary with all versionadded/changed directives.
Zchangesz#The overview file is in %(outdir)s.N)Úreturnc C s2 | j t| j}|jd| _| jj| | j d S )NÚdefault)Zcreate_template_bridger ÚappÚcreateÚthemeÚ templatesÚinit)ÚselfZ
theme_factory© r ú9/tmp/pip-build-gk9425m9/sphinx/sphinx/builders/changes.pyr s
zChangesBuilder.initc C s | j S )N)Úoutdir)r r r r Úget_outdated_docs" s z ChangesBuilder.get_outdated_docsÚaddedÚchangedÚ
deprecated)Ú versionaddedÚversionchangedr# )Úignoredr c ) sä | j j}tt| jjd}i }g }i }|j|}|sNtjt t
d| d S tjt t
d xB|D ]8}t |j t
r|j d } n|j } | j|j }
|jjdd} | rì|jjdrì| rÊd| |
| f } n d | |
f } |j| |j|jf qh| sø|jrV|jptd
}
| std } | r,d| |
| f } n d | |
f } |j|
g j| |j|jf qh| s^qhd |
j | f } | jj|j j }|j|j|fg j| |j|jf qhW | j j || j j | j j t |j t |t |j | j j!| j j"d
}t#t$j%| j&dddd}|j'| j(j)d| W d Q R X t#t$j%| j&dddd}|j'| j(j)d| W d Q R X d| d| d| gt*t+t+dfdd tjt t
d xô| jj,D ]è}t#| jj-|| jj j.d>}y |j/ }W n* t0k
rô tj1t
d | wY nX W d Q R X t$j%| j&d t2|d }t3t$j4| t#|dd dJ}d j% fd!d"t5|D }| jj-|d |d#}|j'| j(j)d$| W d Q R X qW d%d& | j6j7i j D }t8t$j%t9d'd(d)d*| j&|| j(d+ t8t$j%t9d'd,d)d-| j& d S ).NÚ changesetzno changes in version %s.zwriting summary file...r Ú
ú zc-apiz<b>%s</b>: <i>%s:</i> %sz<b>%s</b>: <i>%s</i>.ZBuiltinsz Module levelz
<i>%s:</i> %s) ÚprojectÚversionZ docstitleZ
shorttitleÚ
libchangesÚ
apichangesÚ otherchangesZshow_copyrightZ show_sphinxz
index.htmlÚwÚutf8)Úencodingzchanges/frameset.htmlz changes.htmlzchanges/versionchanges.htmlz.. versionadded:: %sz.. versionchanged:: %sz.. deprecated:: %s)ÚnoÚliner c s6 d| t j| }x D ]}||krd| }P qW |S )Nz<a name="L%s"> </a>z<span class="hl">%s</span>)ÚhtmlÚescape)r2 r3 Úx)Úhltextr r Úhll s
z ChangesBuilder.write.<locals>.hlzcopying source files...z(could not read %r for changelog creationZrstz.htmlzutf-8Ú c 3 s | ]\}} |d |V qdS )é Nr )Ú.0Úir3 )r8 r r ú <genexpr> s z'ChangesBuilder.write.<locals>.<genexpr>)ÚfilenameÚtextzchanges/rstsource.htmlc S s i | ]\}}|d | qS )Ztheme_r )r; ÚkeyÚvalr r r ú
<dictcomp> s z(ChangesBuilder.write.<locals>.<dictcomp>Zthemesr Zstaticz
default.css_t)ÚcontextZrendererÚbasicz basic.css):Úconfigr+ r r ÚenvZ
get_domainZget_changesets_forÚloggerÚinfor r
Ú
isinstanceÚdescnameÚtupleÚtypemapÚtypeÚcontentÚreplaceÚdocnameÚ
startswithÚappendÚlinenoÚmoduler Ú
setdefaultÚ
capitalizeÚtitlesZastextr* Z
html_titleZhtml_short_titleÚsortedÚitemsZhtml_show_copyrightZhtml_show_sphinxÚopenr Újoinr Úwriter ÚrenderÚintÚstrZall_docsZdoc2pathZsource_encodingÚ readlinesÚUnicodeDecodeErrorÚwarningr r ÚdirnameÚ enumerater Z get_optionsr r )r r& r+ Údomainr, r- r. Z
changesetsr' rJ ZttextrC ÚentryrT ÚtitleÚctxÚfrP ÚlinesZtargetfnr? Zthemectxr )r8 r7 r r\ + s
$zChangesBuilder.write)r? r+ r c C s8 t j|}x(dD ] }|jd||f d||f }qW |S )Nr% r$ r# z
.. %s:: %sz<b>.. %s:: %s</b>)r% r$ r# )r4 r5 rO )r r? r+ Z directiver r r r8 s
zChangesBuilder.hlc C s d S )Nr )r r r r Úfinish s zChangesBuilder.finish)Ú__name__Ú
__module__Ú __qualname__Ú__doc__Únamer
Úepilogr r_ r rL r r\ r8 rk r r r r r s br )r r c C s | j t ddddS )NÚbuiltinT)r+ Zparallel_read_safeZparallel_write_safe)Z add_builderr )r r r r Úsetup s
rs )&ro r4 Úosr Útypingr r r r r Zsphinxr Zsphinx.applicationr Zsphinx.buildersr
Zsphinx.domains.changesetr Z
sphinx.localer r
Zsphinx.themingr Z sphinx.utilr Zsphinx.util.consoler Zsphinx.util.fileutilr Zsphinx.util.osutilr r Ú getLoggerrl rG r r_ rs r r r r Ú<module> s"