B \Y@sHdZddlmZddlZddlZddlZddlmZddlm Z ddl Z ddl m Z m Z ddlmZe jd d d d Ze jd dZe jddZe jdd ddZe jdd ddZe jdd ddZe ddZGdddeZe jddZe jddd d!d"Ze jd#d$Ze jd d d%d&Ze jd'd(ZdS))z sphinx.testing.fixtures ~~~~~~~~~~~~~~~~~~~~~~~ Sphinx test fixtures for pytest :copyright: Copyright 2007-2019 by the Sphinx team, see AUTHORS. :license: BSD, see LICENSE for details. )print_functionN) namedtuple) gettempdir)StringIO string_types)utilZsession)scopecCsdS)Nr r r 6lib/python3.7/site-packages/sphinx/testing/fixtures.pyrootdirsr cs*t|jdr|jd}n |jd}ii}|dk rxx@tt|D]0}xt|jD]\}} | |<qTW||j qDWfddt D} |drd|krt d|d|d<||d} || |d d } ||d| |d<} |r| s|d | }|| td d | |S)zo parameters that is specified by 'pytest.mark.sphinx' for sphinx.application.Sphinx initialization iter_markersZsphinxNcsg|] }|qSr r ).0i)pargsr r ;szapp_params.. shared_resultsrcdirz9You can not spcify shared_result and srcdir in same time.testrootrootztest- app_paramsz args,kwargs)hasattrnoder get_markerreversedlist enumerateargsupdatekwargssortedkeyspytest ExceptionrestorepopgetexistsZcopytreer)request test_paramsrsphinx_test_tempdirr Zmarkersrinforarr$rrZ testroot_pathr )rr r#s.         rcCsjt|jdr|jd}n |jd}|r0|jni}ddi}|||drft|dtsft d|S)a| test parameters that is specified by 'pytest.mark.test_params' :param Union[str] shared_result: If the value is provided, app._status and app._warning objects will be shared in the parametrized test functions and/or test functions that have same 'shared_result' value. **NOTE**: You can not specify shared_result and srcdir in same time. get_closest_markerr)rNz@You can only provide a string type of value for "shared_result" ) rrr-rrr isinstancerr"r#)r(envrresultr r r r)Ts    r)Zfunctionccs|\}}|||}|Vtd|ddtd|jjtd|jtd|jtdd|jtd d|j|d r| |d |d S) z3 provides sphinx.application.Sphinx object z # testroot:rrz # builder:z # srcdir:z # outdir:z # status: z # warning:rN) printr&ZbuildernamerZoutdir_statusgetvalue_warningstore)r)rmake_apprrrapp_r r r appps   r:cCs|jS)z> compat for testing with previous @with_app decorator )r4)r:r r r statussr;cCs|jS)z> compat for testing with previous @with_app decorator )r6)r:r r r warningsr<c#sb|dddgtjdd}fdd}|V|tjdd<xtD] }|qNWdS)z provides make_app function to initialize SphinxTestApp instance. if you want to initialize 'app' in your test function. please use this instead of using SphinxTestApp class directory. zsphinx.application.abspathcSs|S)Nr )xr r r szmake_app..NcsRtt}}|d||d|tj||}|drNt|}|S)Nr;r<r)r setdefaultrZ SphinxTestAppappendZ#SphinxTestAppWrapperForSkipBuilding)rrr;r<r9)appsr)r r makes     zmake_app..make)setattrsyspathrZcleanup)r)Z monkeypatchZsyspathrBr9r )rAr)r r8s r8c@s eZdZiZddZddZdS) SharedResultcCs2||jkrdS|j|jd}||j|<dS)N)r;r<)cacher4r5r6)selfkeyr9datar r r r7s  zSharedResult.storecCs2||jkriS|j|}t|dt|ddS)Nr;r<)r;r<)rGr)rHrIrJr r r r$s    zSharedResult.restoreN)__name__ __module__ __qualname__rGr7r$r r r r rFs rFcCstS)N)rFr r r r rsrmoduleT)r ZautousecCstjdS)N)rFrGclearr r r r _shared_result_cachesrPcCs^t|jdd}y,|r8tj|dgtjtjd}|dSWntk rNYnXtddS)zt The test will be skipped when using 'if_graphviz_found' fixture and graphviz dot command is not found. graphviz_dotz-V)stdoutstderrNzgraphviz "dot" is not available) getattrZconfig subprocessPopenPIPEZ communicateOSErrorr"skip)r:rQdotr r r if_graphviz_founds  r\cCsttjdtS)z= temporary directory that wrapped with `path` class. ZSPHINX_TEST_TEMPDIR)rrEosenvironr&rabspathr r r r r*sr*cCs t|S)zz temporary directory that wrapped with `path` class. this fixture is for compat with old test implementation. )rrE)Ztmpdirr r r tempdirsr`)__doc__Z __future__rr]rVrD collectionsrZtempfilerr"ZsixrrrRrZfixturer rr)r:r;r<r8objectrFrrPr\r*r`r r r r  s,    1