3
T'íc! ã @ s¢ d Z ddlZddlZddlZddlZddlZddlmZ ddlm Z m
Z
m Z m Z m
Z
mZ ddlmZ ddlmZ ddlmZ ddlmZmZ dd lmZmZ dd
lm Z dd l m Z dd l m Z d
ddgZ!d+ee"e#ddddZ$d,ee"e#ddddZ%e"e"ddddZ&d-ee
e"e
ddddZ'e"e
d d d Z(G d d
d
Z)G d d dej*Z+G d!d dZ,ej-d"Z.d.e"e/e e"ddf d#d$d%Z0e"e"d&d'd(Z1d)d* Z2dS )/zSphinx test suite utilitiesé N)ÚStringIO)ÚIOÚAnyÚDictÚ GeneratorÚListÚPattern)Ú ElementTree)Únodes)ÚNode)Ú
directivesÚroles)Ú applicationÚlocale)ÚModuleAnalyzer)Úpath)ÚrelpathÚStructÚ
SphinxTestAppÚ#SphinxTestAppWrapperForSkipBuilding)ÚregexÚtextÚflagsÚreturnc C s& t j| ||s"ds"td| |f d S )NFz%r did not match %r)ÚreÚsearchÚAssertionError)r r r © r ú5/tmp/pip-build-gk9425m9/sphinx/sphinx/testing/util.pyÚassert_re_search s r c C s& t j| ||r"ds"td| |f d S )NFz%r did match %r)r r r )r r r r r r Úassert_not_re_search s r )ÚthingÚprefixr c C s" | j |s ds td| |f d S )NFz%r does not start with %r)Ú
startswithr )r! r" r r r Úassert_startswith# s
r$ Ú )ÚnodeÚclsÚxpathÚkwargsr c K s |rt |trÀt| |d fd|i| |dd
r¾t |d tr`t| |d fd|i| n^t | tjsxtd| t| dkstd|t| f t| d |dd
fd|d i| nÜt |trTt | ttjfsètd| t| t|kstd|t| t|f xt|D ]0\}}|d | }t| | |fd|i| q W nHt |t r~| |kstd
||| f n t | |std ||| f |rt | tjs¼td | xX|j
D ]L\}}|| ksêtd
||| f | | |ksÆtd|||| | f qÆW d S )Nr r( é z%The node%s does not have any childrenz&The node%s has %d child nodes, not onez[0]z"The node%s does not have any itemsz%The node%s has %d child nodes, not %rz[%d]zThe node %r is not %r: %rz$The node%s is not subclass of %r: %rz'The node%s does not have any attributesz)The node%s does not have %r attribute: %rz The node%s[%s] is not %r: %r) Ú
isinstanceÚlistÚ assert_nodeÚtupler
ÚElementr ÚlenÚ enumerateÚstrÚitems) r& r' r( r) ÚiZnodeclsr ÚkeyÚvaluer r r r- ( s>
(
"
r- )r r c C s0 t jdd t jdtd tj| S Q R X d S )NF)ÚrecordÚignore)Úcategory)ÚwarningsÚcatch_warningsÚfilterwarningsÚDeprecationWarningr Úparse)r r r r Ú etree_parseN s r? c @ s e Zd ZeddddZdS )r N)r) r c K s | j j| d S )N)Ú__dict__Úupdate)Úselfr) r r r Ú__init__U s zStruct.__init__)Ú__name__Ú
__module__Ú __qualname__r rC r r r r r T s c
sr e Zd ZU dZdZedZedeeee e
e e e e ee
dd fdd
Zde dd d
d Zed d
dZ ZS )r z
A subclass of :class:`Sphinx` that runs on the test root, with some
better default values for the initialization parameters.
NÚhtmlFr ) Ú buildernameÚsrcdirÚbuilddirÚfreshenvÚ
confoverridesÚstatusÚwarningÚtagsÚ docutilsconfÚparallelr c sð | d k r|d j | |d kr&|d }|} |j|} | jdd |jd}
|
jdd |d krbi }d}tjd d
| _tjj | _ t
j j | _ dd t
tjD | _y(t j|| | |
||||||||
d W n tk
rê | j Y nX d S )
Nz
docutils.confZ_buildT)Úexist_okÚdoctreesFc S s h | ]}|j d r|qS )Úvisit_)r# )Ú.0Úvr r r ú <setcomp>y s z)SphinxTestApp.__init__.<locals>.<setcomp>)rQ )Z
write_textZjoinpathÚmakedirsÚsysr Ú _saved_pathr Ú _directivesÚcopyÚ_saved_directivesr
Ú_rolesÚ _saved_rolesÚdirr
ÚGenericNodeVisitorÚ_saved_nodeclassesÚsuperrC Ú ExceptionÚcleanup)rB rH rI rJ rK rL rM rN rO rP rQ ZconfdirÚoutdirZ
doctreedirZwarningiserror)Ú __class__r r rC a s.
zSphinxTestApp.__init__)rS r c C s t jj tjj | jtjd d
< tjj dd | j
t _ | j
t_xVttjD ]H}|jdrN|| jkrNttjd|dd
ttjd|dd
qNW d S )NZautodoc_fodderrT é Zdepart_)r ÚcacheÚclearr Z translatorsrZ rY r ÚmodulesÚpopr] r r[ r_ r
r^ r` r
ra r# rb Údelattr)rB rS Úmethodr r r re s
zSphinxTestApp.cleanup)r c C s d| j j| jjf S )Nz<%s buildername=%r>)rg rD ZbuilderÚname)rB r r r Ú__repr__ s zSphinxTestApp.__repr__)
rG NNFNNNNNr )F)rD rE rF Ú__doc__Z_statusr Z_warningr2 r Úboolr r r ÚintrC re rp Ú
__classcell__r r )rg r r Y s
,
c @ sB e Zd ZdZeddddZeedddZeedd d
d Z dS ) r zª
This class is a wrapper for SphinxTestApp to speed up the test by skipping
`app.build` process if it is already built and there is even one output
file.
N)Úapp_r c C s
|| _ d S )N)Úapp)rB ru r r r rC s z,SphinxTestAppWrapperForSkipBuilding.__init__)ro r c C s t | j|S )N)Úgetattrrv )rB ro r r r Ú __getattr__ s z/SphinxTestAppWrapperForSkipBuilding.__getattr__)Úargsr) r c O s | j jj s| j j|| d S )N)rv rf ÚlistdirÚbuild)rB ry r) r r r r{ ¢ s z)SphinxTestAppWrapperForSkipBuilding.build)
rD rE rF rq r rC r2 r rx r{ r r r r r s zu(".*?")|u(\'.*?\'))ÚrootÚsuffixr c # sZ xTt j| ddD ]B\}}}t|}x. fdd|D D ]}|| }t|| V q6W qW d S )NT)Ú followlinksc s g | ]} s|j r|qS r )Úendswith)rU Úf)r} r r ú
<listcomp>¯ s z find_files.<locals>.<listcomp>)ÚosÚwalkr r )r| r} ÚdirpathZ_dirsÚfilesr Zfpathr )r} r Ú
find_files¬ s
r )r r c C s t jdd| S )Nz.*?mr% )r Úsub)r r r r Ú strip_escseq´ s r c s t j fdd}|S )zA
A simple decorator that does nothing, for tests to use.
c s
| |S )Nr )ry r) )r r r Úwrapper¼ s z!simple_decorator.<locals>.wrapper)Ú functoolsÚwraps)r r r )r r Úsimple_decorator¸ s r )r )r )Nr% )N)3rq r r r rY r: Úior Útypingr r r r r r Z xml.etreer Zdocutilsr
Zdocutils.nodesr Zdocutils.parsers.rstr r
Zsphinxr r Z
sphinx.pycoder Zsphinx.testing.pathr Zsphinx.util.osutilr Ú__all__r2 rs r r r$ r- r? r ZSphinxr r ÚcompileZ_unicode_literals_rerr r r r r r r r Ú<module> s8
&<