7 f2dZddlmZddlZddlZddlZddlmZddlm Z ddl m Z m Z m Z ddlZddlmZmZe r ddlmZdd lmZd d gZd Zejd d9dZGddZejd:dZeddZejd;dZejdd-Z!ejd?d.Z"ejd/d01d@d3Z#ejdAd4Z$ejd dBd7Z%ejd8Z&dS)CzSphinx test fixtures for pytest) annotationsN) namedtuple)StringIO) TYPE_CHECKINGAnyCallable) SphinxTestApp#SphinxTestAppWrapperForSkipBuilding) Generator)Pathzsphinx(builder, testroot=None, freshenv=False, confoverrides=None, tags=None, docutilsconf=None, parallel=0): arguments to initialize the sphinx test application.z0test_params(shared_result=...): test parameters.cFtD]}|d|dS)zRegister custom markersmarkersN)DEFAULT_ENABLED_MARKERSaddinivalue_line)configmarkers M/var/www/equiseq/venv/lib/python3.11/site-packages/sphinx/testing/fixtures.pypytest_configurers4)33 6222233session)scopereturn str | NonecdSNrrrrootdirr#s 4rc.eZdZUiZded<d d Zdd Zd S) SharedResultzdict[str, dict[str, str]]cachekeystrapp_r rrc||jvrdS|j|jd}||j|<dS)Nstatuswarning)r _statusgetvalue_warning)selfr!r#datas rstorezSharedResult.store+sS $*   Fl++--}--//   3rdict[str, StringIO]c||jvriS|j|}t|dt|ddS)Nr&r'r%)r r)r+r!r,s rrestorezSharedResult.restore4sL dj Iz#tH~..Y00   rN)r!r"r#r rr)r!r"rr.)__name__ __module__ __qualname__r __annotations__r-r0rrrrr(sO')E))))      rrrequestr test_paramsdict shared_resultsphinx_test_tempdirr"r _app_paramscii}tt|jdD];}t |jD] \}}||< ||j<fdt D} |drUd|vrd} tj | |d|d<| |d} || | dd} ||d| z x|d<} |r1| s|d| zz }t!j|| t%| |S) zp Parameters that are specified by 'pytest.mark.sphinx' for sphinx.application.Sphinx initialization sphinxc g|] }| Srr).0ipargss r zapp_params..Qs 3 3 3E!H 3 3 3rr8srcdirz:You can not specify shared_result and srcdir in same time.testrootrootztest-)reversedlistnode iter_markers enumerateargsupdatekwargssortedkeyspytest Exceptionr0popgetexistsshutilcopytreer:)r5r6r8r9rrLinfor?arJmsgr0rCrB testroot_pathr@s @r app_paramsrZ>s EFgl77AABBCC##di((  DAqE!HH dk"""" 3 3 3 3fUZZ\\22 3 3 3D?# v  NC"3'' '&7x'' O(DEE gzz*f--H 3fjj86T6T TTF8v/v}}/7X#56  v... tV $ $$rz args,kwargsc|jd}|r|jni}ddi}|||dr1t |dt sd}t j||S)au Test parameters that are 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 both shared_result and srcdir. r6r8Nz?You can only provide a string type of value for "shared_result")rGget_closest_markerrLrK isinstancer"rOrP)r5envrLresultrXs rr6r6ls , ) )- 8 8C &SZZBFF MM& o$z&2I3'O'O$Os### MrrZtuple[dict, dict]make_appr$Generator[SphinxTestApp, None, None]c#K|\}}||i|}|Vtd|ddtd|jjtd|jtd|jtdd|jztd d|jz|d r| |d |d Sd S) z9 Provides the 'sphinx.application.Sphinx' object z # testroot:rCrDz # builder:z # srcdir:z # outdir:z # status: z # warning:r8N) printrRbuildernamerBoutdirr(r)r*r-)r6rZrar8rJrLr#s rappris LD& 8T $V $ $D JJJ -J77888 , )*** +t{### +t{### +tdl33555666 ,t}55777888?#@K8$?????@@rrir rc|jSzJ Back-compatibility for testing with previous @with_app decorator )r(ris rr&r&s ;rc|jSrk)r*rls rr'r's <r monkeypatchGenerator[Callable, None, None]c#Kgtjdd}fd}|V|tjdd<tD]}|dS)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. Nctt}}|d||d|t|i|}|drt |}|S)Nr&r'r8)r setdefaultr appendr )rJrLr&r'r#appsr6s rmakezmake_app..makes"**hjj(F+++)W---!42622 D  ' =6t<>rmoduleT)rautouseNonecBtjdSr)rr clearrrr_shared_result_cachersrct|jdd} |rtj|dgddSn#t$rYnwxYwt jddS)zt The test will be skipped when using 'if_graphviz_found' fixture and graphviz dot command is not found. graphviz_dotz-VT)capture_outputNzgraphviz "dot" is not available)getattrr subprocessrunOSErrorrOskip)rirs rif_graphviz_foundrs 3:~r::L   NL$/ E E E E F        K122222s5 AAtmp_path_factoryr c*|S)zTemporary directory.) getbasetemp)rs rr9r9s  ' ' ) ))rc#LK ttj}dVttjD]%}||vrtj|&dS#ttjD]%}||vrtj|&wxYw)z Rollback sys.modules to its value before testing to unload modules during tests. For example, used in test_ext_autosummary.py to permit unloading the target module to clear its cache. N)rFrvmodulesrQ) sysmodulesmodnames rrollback_sysmodulesrs)#+&&  CK(( ) )Gj(( ((( ) )tCK(( ) )Gj(( ((( )s A""AB#)rr) r5rr6r7r8rr9r"rr"rr:)r5rrr7) r6r7rZr`rarr8rrrb)rir rr)r6r7rnrrro)rr)rr})rir rr})rrrr )'__doc__ __future__rrTrrv collectionsriortypingrrrrOsphinx.testing.utilr r collections.abcr pathlibr rrfixturerrrZr:r6rir&r'rar8rrr9rrrrrsF%%""""""  """"""////////// RRRRRRRR)))))) `7 333 i   !         ,'%'%'%'%Tj 66 .@@@@(2h---.- 3 3 3 3 i   ***! * )))))r