EiSrSSKJr SSKrSSKJr SSKJr SSKJr SSKJr SSK r SSK J r SSK r SSK r SS K Jr SSKrSSKrSS KJr SSKrSSKrSSKrSSKrSSKrSSKrSS KJr SS KJr SS KJr SSKJr SSKJr SSKJr SSKJ r SSKJ!r! SSK"J#r# SSK$J%r% SSK$J&r& SSK'J(r( SSK)J*r* SSK+J,r, SSK-J.r. SSK-J/r/ SSK0J1r1 SSK0J2r2 SSK0J3r3 SSK0J4r4 SSK0J5r5 SS K0J6r6 SS!K7J8r8 SS"K9J:r: SS#K;JJ?r? SS&K@JArA SS'KBJCrC SS(KBJDrD SS)KEJFrF SS*KEJGrG SS+KEJHrH SS,KIJJrJ SS-KIJKrK SS.KLJMrM SS/KLJNrN SS0KOJPrP SS1KQJRrR \!(aSSKSrSS2/rTS3/rUSTS4jrVSUS5jrW"S6S75rX\S?55r\\.isopensI??3'%&%&%&%  rE r/)rdstrreturnbool)sys version_infolocale getencodinggetpreferredencodingr=runrkosgetpidPIPEDEVNULLrWsplit IGNORE_PAMrcappend) selfr[outre open_filesrdfieldsfdfilenames rCget_open_files LsofFdLeakChecker.get_open_fileszs   w &))+H2259Hnn WdC $4 5??%%   &   IIdODd||D)AYqr]!!9QR=z)&&s++%%rn5$rEcp[R"SSS9 g![[R4a gf=f)N)r5z-vT)rYF)r=rsOSErrorCalledProcessErrorr{s rCrJ#LsofFdLeakChecker.matching_platforms9  NN> 6667  s 55T)wrappertryfirstc ## UR5nSv[[S5(a[R"5 UR5nUVs1sHoDSiM snUVs1sHoDSiM sn- nUVs/sHoDSU;dM UPM nnU(aS[ U5S3/SU5QSPSU5QSPS U5QS[ U5S3PS R "UR6PS PnUR[S RU555 $$s snfs snfs snf![[S5(a[R"5 UR5nUVs1sHoDSiM Os snfsnUVs1sHoDSiM Os snfsn- nUVs/sHoDSU;dM UPM Os snfnnU(aS[ U5S3/SU5QSPSU5QSPS U5QS[ U5S3PS R "UR6PS PnUR[S RU555 ff=f7f) Npypy_version_inforz***** z FD leakage detectedc38# UHn[U5v M g7fNrk.0r]s rC .s3lc!fflz *** Before:c38# UHn[U5v M g7frrrs rCrr-fc!fffrz *** After:c38# UHn[U5v M g7frrrs rCrrrrz*** function {}:{}: {} zSee issue #2366rg) rhasattrrngccollectlenformatlocationwarnr1join)r{itemlines1lines2tnew_fds leaked_fileserrors rCpytest_runtest_protocol)LsofFdLeakChecker.pytest_runtest_protocolsz$$& =s/00 ((*F%+,VtV,f/Ef!f/EEG'-Av!1AvLAS.//CD 3l3 " .f-  !  .f- S.//CD .44dmmD &  /$))E*:;<-/EA s/00 ((*F%+,VtV,f/Ef!f/EEG'-Av!1AvALAS.//CD 3l3 " .f-  !  .f- S.//CD .44dmmD &  /$))E*:;<sqID2>ID##I)D(7 I D-D-BI2?I1F? I F I( F?8F?>BIIN)rlzlist[tuple[str, str]])rlrm)rr(rlzGenerator[None, object, object]) __name__ __module__ __qualname____firstlineno__rrJrr__static_attributes__rrErCrIrIys(#JdT*=+=rErI PytestArgc[U5$)zReturn a helper which offers a gethookrecorder(hook) method which returns a HookRecorder instance which helps to make assertions about called hooks.)rrequests rC_pytestrs W rEc(\rSrSrSSjrSSjrSrg)rcXlgr_request)r{rs rC__init__PytestArg.__init__s rEcz[UR5nURRUR5 U$r) HookRecorder_pmr addfinalizerfinish_recording)r{hook hookrecorders rCgethookrecorderPytestArg.gethookrecorders.#DHH-  ""<#@#@ArErN)rr$rlNone)rlr)rrrrrrrrrErCrrs  rEcFUVs/sHoSS:wdM UPM sn$s snf)zDOnly return names from iterator values without a leading underscore.r_r)valuesxs rCget_public_namesrs" -v!1Av -- -s cJ\rSrSrSrSSjrS Sjr\(aS SjrSr gSr g) RecordedHookCallaA recorded call to a hook. The arguments to the hook call are set as attributes. For example: .. code-block:: python calls = hook_recorder.getcalls("pytest_runtest_setup") # Suppose pytest_runtest_setup was called once with `item=an_item`. assert calls[0].item is an_item cFURRU5 Xlgr)__dict__update_name)r{namekwargss rCrRecordedHookCall.__init__s V$ rEcfURR5nUS SUR<SU<S3$)Nrz)rcopyr)r{ds rC__repr__RecordedHookCall.__repr__s4 MM    gJ#DJJ>QE<TRR[X55 gr)callsrzr) hook_name hook_implsrr{s rCbefore%HookRecorder.__init__..before s JJ  .yA BrEcgrr)outcomerrrs rCafter$HookRecorder.__init__..afters rE)rrkrlr)r"_pluginmanagerrretadd_hookcall_monitoring_undo_wrapping)r{rKrrrs` rCrHookRecorder.__init__sC y!+-/ *. C ,CCFRrEc$UR5 gr)rrs rCrHookRecorder.finish_recordings rEc[U[5(aUR5nURVs/sHo"RU;dMUPM sn$s snf)z?Get all recorded calls to hooks with the given names (or name).) isinstancerkrxrr)r{namescalls rCgetcallsHookRecorder.getcallss? eS ! !KKME!%CzzU/BCCCs A Ac"SnSn[U5n[[R"S5R5nU(aUR S5upV[ URUS5HupxURU:Xaa[SXX5 [XdUR5(a[S[U5SU5 O[S[U5SU5 MmX7S-- n O%[S US U5 M [S U<S U<35 U(aMgg) NTrri NAMEMATCH CHECKERMATCHz->NOCHECKERMATCH- NONAMEMATCHwithzcould not find z check )listdictrn _getframef_localspop enumeraterrprintevalrreprr)) r{entries__tracebackhide__i backlocalsrrYindrs rCassert_containsHookRecorder.assert_containss  w-#--*334 !++a.KD&tzz!"~6 ::%+t2Et}}==nd5k4F.U S$G qLAmT6487thgeY?@grEc2Sn[UR5H&up4URU:XdMURU Us $ SU<S3/nURURVs/sHnSU3PM sn5 [ SR U55 gs snf)NTzcould not find call z, in:z rg)rrrextendr)r)r{rr r rlinesrs rCpopcallHookRecorder.popcall2s  ,GAzzT!JJqM -(xu56  3 11#h 34 TYYu 4s#Bc\URU5n[U5S:XdX45eUS$)Nrir)rr)r{rrs rCgetcallHookRecorder.getcall<s3t$6{a/$/ayrEcgrrr{rs rC getreportsHookRecorder.getreportsC#&rEcgrrrs rCrrI #rEcgrrrs rCrrO03rEcbURU5Vs/sHo"RPM sn$s snfr)rreport)r{rrs rCrrXs)#'--"67"6Q"6777s,Nc/nURUS9H~nU(d#URS:waUR(aM-U(aURU:waMFU(a XRR S5;dMmUR U5 M U(d[ SU<S35e[U5S:a[ SU<SU35eUS $) z5Return a testreport whose dotted import path matches.)rr::z$could not find test report matching z: no test reports at all!riz%found 2 or more testreports matching : r)rwhenpassednodeidrxrz ValueErrorr)r{ inamepartrr'rreps rC matchreportHookRecorder.matchreportas???/CCHH.3::D( ZZ-=-=d-C C c"06ymD**  v;?7 }BvhO ayrEcgrrrs rC getfailuresHookRecorder.getfailuresrrEcgrrrs rCr0r1rrEcgrrrs rCr0r1r!rEctURU5Vs/sHo"R(dMUPM sn$s snfr)rfailed)r{rr,s rCr0r1s+ $u5D55DDDs55c$URS5$)Npytest_collectreport)r0rs rCgetfailedcollections!HookRecorder.getfailedcollectionss 677rEc/n/n/nURS5HnUR(a<URS:Xa*[U[5(deUR U5 MNMPUR (aUR U5 MtUR(d SU<35eUR U5 M XU4$)Nr7pytest_runtest_logreportrzUnexpected outcome: )rr(r'rr/rzskippedr5)r{r(r=r5r,s rC listoutcomesHookRecorder.listoutcomess?? @ Czz88v%%c:6666MM#&&s#zzA%9##AAz c" &&rEc`UR5Vs/sHn[U5PM sn$s snfr)r>r)r{rs rC countoutcomesHookRecorder.countoutcomess) $ 1 1 34 31A 3444s+cFSnSSKJn UR5nU"UUUUS9 g)NTr) assertoutcome)r(r=r5)_pytest.pytester_assertionsrDr>)r{r(r=r5r rDoutcomess rCrDHookRecorder.assertoutcomes- =$$&   rEc"/URSS&gr)rrs rCclearHookRecorder.clears 1 rE)rrrr)rKr rrmrlrrlr)rstr | Iterable[str]rlzlist[RecordedHookCall])r zSequence[tuple[str, str]]rlr)rrkrlr)rzLiteral['pytest_collectreport']rlSequence[CollectReport])rz#Literal['pytest_runtest_logreport']rlzSequence[TestReport])r;)rrLrlz$Sequence[CollectReport | TestReport]))r<r7N)r+rkrrLr' str | NonerlzCollectReport | TestReport)rlrM)rlzgtuple[Sequence[TestReport], Sequence[CollectReport | TestReport], Sequence[CollectReport | TestReport]])rlz list[int])rrr)r(intr=rPr5rPrlr)rrrrrrrrrrrrrr-r0r8r>rArDrIrrrErCrrsHMS0S@DS S"D A,&.& !&& #2# ## & 3"3 . 33& 8"8 . 8&  # $<&.& !&& #2# ## & 3"3 . 33& E"E . E8' '05  rErLineCompc[5$)zaA :class: `LineComp` instance for checking that an input linearly contains a sequence of strings.)rQrrErClinecomprSs  :rE LineMatcherrc[$)zA reference to the :class: `LineMatcher`. This is instantiable with a list of lines (without their trailing newlines). This is useful for testing large texts, such as the output of commands. )rTrs rCLineMatcher_fixturerWs  rEPytesterc[XUSS9$)a Facilities to write tests/configuration files, execute pytest in isolation, and match against expected output, perfect for black-box testing of pytest plugins. It attempts to isolate the test run from external factors as much as possible, modifying the current working directory to ``path`` and environment variables during initialization. It is particularly useful for testing plugins. It is similar to the :fixture:`tmp_path` fixture but provides methods which aid in testing pytest itself. Tr)rX)rtmp_path_factory monkeypatchs rCpytesterr\s G{d KKrEc#|# [5n[5nSv UR5 UR5 g7fr)SysPathsSnapshotSysModulesSnapshotrestore) snappathssnapmodss rC _sys_snapshotrcs0 "I!#H   s:<c#N# SSKJn U"5nUv UR5 g7f)Nr) get_config)_pytest.configre_ensure_unconfigure)rerNs rC_config_for_testrhs ) \F L  #%z \d+\.\d\dsz (\d+) (\w+)c\rSrSrSrS SjrS SjrS Sjr\S Sj5r S SSjjr S r g) RunResultiz?The result of running a command from :class:`~pytest.Pytester`.c[U5UlX lX0l[ U5Ul[ U5UlX@lg![a XlNIf=fr) rrr*outlineserrlinesrTrWrXduration)r{rrmrnros rCrRunResult.__init__ sg '/}DH #! 1 1!(+  "(+ 5 " H sA AAc SUR<S[URR5S[URR5SUR SS3 $)Nz)rrrWrrXrors rCrRunResult.__repr__$s^dhh\*!!$T[[%6%6!7 89!!$T[[%6%6!7 89 c*" . rEc8URUR5$)a-Return a dictionary of outcome noun -> count from parsing the terminal output that the test process produced. The returned nouns will always be in plural form:: ======= 1 failed, 1 passed, 1 warning, 1 error in 0.13s ==== Will return ``{"failed": 1, "passed": 1, "warnings": 1, "errors": 1}``. )parse_summary_nounsrmrs rC parseoutcomesRunResult.parseoutcomes,s'' 66rEc j[U5HTn[RU5(dM[R U5nUVVs0sHupEU[ U5_M nnn O [ S5eSSS.nUR5VV s0sHupURX5U _M sn n$s snnfs sn nf)zExtract the nouns from a pytest terminal summary line. It always returns the plural noun for consistency:: ======= 1 failed, 1 passed, 1 warning, 1 error in 0.13s ==== Will return ``{"failed": 1, "passed": 1, "warnings": 1, "errors": 1}``. z(Pytest terminal summary report not foundwarningserrors)warningr) reversedrex_session_durationsearch rex_outcomefindallrPr*itemsget) clsrrdrFcountnounr to_pluralkvs rCrtRunResult.parse_summary_nouns8sUOD#**400&..t4=EFXMUtSZ'XF $ GH H" 4799;?;41 a#Q&;??G@s B)B/Nc PSn SSKJn UR5n U "U UUUUUUUUS9 g)z Assert that the specified outcomes appear with the respective numbers (0 means it didn't occur) in the text output from a test run. ``warnings`` and ``deselected`` are only checked if not None. Tr)assert_outcomes)r(r=r5ryxpassedxfailedrx deselectedN)rErru) r{r(r=r5ryrrrxrr rrFs rCrRunResult.assert_outcomesPs>"!?%%' ! rE)rornrmrrXrW) rzint | ExitCoderm list[str]rnrrofloatrlrr)rlzdict[str, int])rrrrrrNN)r(rPr=rPr5rPryrPrrPrrPrx int | Nonerrrlr) rrrrrrrru classmethodrtrrrrErCrkrksI# ## #  #  #6  7@@2#!%               rErkc,\rSrSrSSSjjrSSjrSrg) r_irNcLXl[[R5Ulgr)_SysModulesSnapshot__preserverrnmodules_SysModulesSnapshot__saved)r{preserves rCrSysModulesSnapshot.__init__ss"CKK( rEc8^TR(aATRRU4Sj[RR 555 [RR 5 [RRTR5 g)Nc3^># UH"upTRU5(dMX4v M$ g7fr)r)rrmr{s rCr-SysModulesSnapshot.restore..ys& #641$//!:L#6s- -)rrrrnrrrIrs`rCr`SysModulesSnapshot.restorews^ ?? LL   #&;;#4#4#6    4<<(rE) __preserve__savedr)rzCallable[[str], bool] | NonerlrrKrrrrrr`rrrErCr_r_rs ))rEr_c(\rSrSrSSjrSSjrSrg)r^icr[[R5[[R54Ulgr)rrnpath meta_path_SysPathsSnapshot__savedrs rCrSysPathsSnapshot.__init__sCHH~tCMM':: rEcfURu[RSS&[RSS&gr)rrnrrrs rCr`SysPathsSnapshot.restores!(, % S]]1%rE)rNrKrrrErCr^r^s ;5rEr^c\rSrSr%SrSr\rS\S'"SS\ 5r SS.S=S jjr \ S>S j5r S?S jrS@S jrSAS jrSBSjrS@SjrSCSDSjjrSESjrSFSjrSFSjrSFSjrSGSjrSFSjrS>SjrS>SjrSHSISjjrSJSjrSJSjrSHSKSjjrSLSjr SMSjr!SNS jr"SOS!jr#SPS"jr$SQS#jr%S$SS%.SRS&jjr&SSS'jr'SSS(jr(STS)jr)SUS*jr*SUS+jr+SVSWS,jjr,SXS-jr-SYSS..SZS/jjjr.S[S0jr/\0Rb\0Rb\4S\S1jjr2S\S2.S]S3jjr3S4r4S^S5jr5S_S6jr6S`S7jr7SS8.SaS9jjr8SbScS:jjr9SbSdS;jjr:S>2}}++55mD -44tD6]T4R!,,B  )3t/A/A+BC - / "E 2dii. &'" -) +s#rEcUR$)zBTemporary directory path used to create files/run tests from, etc.)rrs rCr Pytester.pathszzrEc$SUR<S3$)Nz )rrs rCrPytester.__repr__sDII=**rEclURR5 URR5 g)z Clean up global state artifacts. Some methods modify the global interpreter state and this tries to clean this up. It does not remove the temporary directory however so it can be looked at after the test run has finished. N)rr`rrs rCrPytester._finalizes( ""**, '')rEcSn[US9$)Nc$URS5$)N)zopereadlinerbrUs rCpreserve_module=Pytester.__take_sys_modules_snapshot..preserve_modules??#78 8rE)r)r_)r{rs rC__take_sys_modules_snapshot$Pytester.__take_sys_modules_snapshots 9"?;;rEcr[USS9=UlnURRUR5 U$)zFCreate a new :class:`HookRecorder` for a :class:`PytestPluginManager`.Tr)rreprecrrr)r{rKrs rCmake_hook_recorderPytester.make_hook_recorders3(4]d(SS v ""6#:#:; rEcNURRUR5 g)zQCd into the temporary directory. This is done automatically upon instantiation. N)rrrrs rCrPytester.chdirs  *rEc^^ [UR55nUc [S5eU(a'URS5(d[ SUSU35eS U4Sjjm U(a:SR U 4SjU55nUR nURSXv45 SnUHupyURRU5RU5n U RRS S S 9 [U 5n SR U 4S jU R55nU RUR!5TS 9 UbMU nM UceU$)Nzext must not be None.z1pytester.makefile expects a file extension, try .z instead of cf>[U[5(aURT5$[U5$r)rbytesdecoderk)sr[s rCto_text#Pytester._makefile..to_texts')3Au)=)=188H% I3q6 IrErgc34># UH nT"U5v M g7frr)rrrs rCr%Pytester._makefile..s95awqzz5rT)parentsexist_okc34># UH nT"U5v M g7frr)rrdrs rCrrsGwt}}rr[)rz Any | bytesrlrk)rr TypeErrorrcr*rrinsertrjoinpath with_suffixparentmkdirrr write_textstrip) r{extrfilesr[rsourcebasenamervaluepsource_rs ` @rC _makefilePytester._makefiles%U[[]# ;23 3 s~~c**CC5 UXTYZ  J YY9599FzzH LLX. /$OH ""8,88=A HHNN4$N 7UmGYYGGGF LL(L ;{ % rEc&URXU5$)a=Create new text file(s) in the test directory. :param ext: The extension the file(s) should use, including the dot, e.g. `.py`. :param args: All args are treated as strings and joined using newlines. The result is written as contents to the file. The name of the file is based on the test function requesting this fixture. :param kwargs: Each keyword is the name of a file, while the value of it will be written as contents of the file. :returns: The first created file. Examples: .. code-block:: python pytester.makefile(".txt", "line1", "line2") pytester.makefile(".ini", pytest="[pytest]\naddopts=-rs\n") To create binary files, use :meth:`pathlib.Path.write_bytes` directly: .. code-block:: python filename = pytester.path.joinpath("foo.bin") filename.write_bytes(b"...") r)r{rargsrs rCmakefilePytester.makefiles<~~c00rEc URUS9$)zXWrite a conftest.py file. :param source: The contents. :returns: The conftest.py file. )conftest) makepyfiler{rs rC makeconftestPytester.makeconftest8s //rEc"URSUS9$)zPWrite a tox.ini file. :param source: The contents. :returns: The tox.ini file. z.ini)toxrr s rCmakeiniPytester.makeini@s }}V}00rEc"URSUS9$)zoWrite a pytest.toml file. :param source: The contents. :returns: The pytest.toml file. .. versionadded:: 9.0 .toml)pytestrr s rCmaketomlPytester.maketomlHs}}WV}44rEcRURU5n[[U55S$)z7Return the pytest section from the tox.ini config file.r)rrrk)r{rrs rC getinicfgPytester.getinicfgRs$ LL Q **rEc"URSUS9$)ztWrite a pyproject.toml file. :param source: The contents. :returns: The pyproject.ini file. .. versionadded:: 6.0 r) pyprojectrr s rCmakepyprojecttomlPytester.makepyprojecttomlWs}}W}77rEc&URSX5$)aShortcut for .makefile() with a .py extension. Defaults to the test name with a '.py' extension, e.g test_foobar.py, overwriting existing files. Examples: .. code-block:: python def test_something(pytester): # Initial file is created test_something.py. pytester.makepyfile("foobar") # To create multiple files, pass kwargs accordingly. pytester.makepyfile(custom="foobar") # At this point, both 'test_something.py' & 'custom.py' exist in the test directory. .pyrr{rrs rCr Pytester.makepyfileas$~~eT22rEc&URSX5$)aShortcut for .makefile() with a .txt extension. Defaults to the test name with a '.txt' extension, e.g test_foobar.txt, overwriting existing files. Examples: .. code-block:: python def test_something(pytester): # Initial file is created test_something.txt. pytester.maketxtfile("foobar") # To create multiple files, pass kwargs accordingly. pytester.maketxtfile(custom="foobar") # At this point, both 'test_something.txt' & 'custom.txt' exist in the test directory. z.txtrr!s rC maketxtfilePytester.maketxtfileus$~~fd33rENcjUc URnURR[U55 g)zPrepend a directory to sys.path, defaults to :attr:`path`. This is undone automatically when this object dies at the end of each test. :param path: The path. N)rrsyspath_prependrk)r{rs rC syspathinsertPytester.syspathinserts* <99D ))#d)4rEcDURU- nUR5 U$)zCreate a new (sub)directory. :param name: The name of the directory, relative to the pytester path. :returns: The created directory. :rtype: pathlib.Path )rrr{rrs rCrPytester.mkdirs  II   rEcURU- nUR5 URS5R5 U$)zCreate a new python package. This creates a (sub)directory with an empty ``__init__.py`` file so it gets recognised as a Python package. __init__.py)rrrtouchr+s rCmkpydirPytester.mkpydirs5 II    =!'')rEcURRRS5nUc [S5eURRRU- nURR R S5H/nUR(deUR"UR6nM1 UcWURnX5- nX5S-- nUR5(aUnO9UR5(aUnO![USU35eURU5nUR5(aPURS5R5(d,[R"XRSSS9 UR$UR5(a=URRUR 5n [R""X5 U $[S US 35e) zCopy file from project's directory into the testdir. :param name: The name of the file to copy. :return: Path to the copied directory (inside ``self.path``). :rtype: pathlib.Path r?z2pytester_example_dir is unset, can't copy examplespytester_example_pathr z( can't be found as module or package in r.T)symlinks dirs_exist_okz example "z%" is not found as a file or directory)rrNgetinir*rootpathr iter_markersrrris_diris_file LookupErrorshutilcopytreerrr) r{r example_dir_ example_dir extra_element func_name maybe_dir maybe_file example_pathresults rC copy_examplePytester.copy_examples}}++223IJ  QR R MM0099LH !]]//<<=TUM %% %%%.. 0B0BCKV < I#/I$E(9:J!!( ##%%) ! k!I+W'//5L    )>)>})M)U)U)W)W OOL))dRV W99   ! ! # #YY'' (9(9:F KK -ML>)NO rEc`[R"U5nS[U5;de[[R R U55nURRUS9 UR[U5/SS9SnURRU[RS9 U$)zGet the collection node of a file. :param config: A pytest config. See :py:meth:`parseconfig` and :py:meth:`parseconfigure` for creating it. :param arg: Path to the file. :returns: The node. r%sessionFgenitemsrrJ exitstatus) r% from_configrkr rtrabspathrpytest_sessionstartperform_collectpytest_sessionfinishrOK)r{rNargrJrress rCgetnodePytester.getnodes%%f-3s8### % & '''8%%s1vh%?B ((X[[(Q rEc@[U5nURU5n[R"U5n[ UR U5nUR RUS9 URU/SS9SnUR RU[RS9 U$)zReturn the collection node of a file. This is like :py:meth:`getnode` but uses :py:meth:`parseconfigure` to create the (configured) pytest Config instance. :param path: Path to the file. :returns: The node. rIFrKrrM) r parseconfigurer%rOr,rrrQrRrSrrT)r{rrNrJrrVs rC getpathnodePytester.getpathnodesDz$$T*%%f-  d + '''8%%qcE%:1= ((X[[(Q rEczUSRn/nUH#nURURU55 M% U$)zGenerate all test items from a collection node. This recurses into the collection node and returns a list of all the test items contained within. :param colitems: The collection nodes. :returns: The collected items. r)rJrrL)r{colitemsrJrEcolitems rCrLPytester.genitemss>1+%%G MM'**73 4  rEcURU5nURRnUR5nU"U5$)zRun the "test_func" Item. The calling test instance (class containing the test method) must provide a ``.getrunner()`` method which should return a runner which can run the test protocol for a single item, e.g. ``_pytest.runner.runtestprotocol``. )getitemrinstance getrunner)r{rrtestclassinstancerunners rCrunitemPytester.runitems:||F# MM22",,.d|rEc`URU5n/[U5QUPnUR"U6$)a7Run a test module in process using ``pytest.main()``. This run writes "source" into a temporary file and runs ``pytest.main()`` on it, returning a :py:class:`HookRecorder` instance for the result. :param source: The source code of the test module. :param cmdlineargs: Any extra command line arguments to use. )r r inline_run)r{r cmdlineargsrrs rCinline_runsourcePytester.inline_runsource$s5 OOF #(4 $(a(''rEcUR"S/UQ76nURS5Vs/sHo3RPM nnXB4$s snf)aRun ``pytest.main(['--collect-only'])`` in-process. Runs the :py:func:`pytest.main` function to run all of pytest inside the test process itself like :py:meth:`inline_run`, but returns a tuple of the collected items and a :py:class:`HookRecorder` instance. z--collect-onlypytest_itemcollected)rjrr)r{rrecrrs rCinline_genitemsPytester.inline_genitems2sHoo.66!$.D!EF!EA!EFzGsAr)rno_reraise_ctrlcc^^ ^ SSKJm [R"5 [ U5n/nUR TR 5R5 UR [5R5 /m "U U U4SjS5nUR U"55 [UVs/sHn[U5PM snUS9n[T 5S:XaT R5nO "SS5nXxl U[R:XaJU(dCUR!S 5n U (a+U S R"R$[&:Xa ['5eUUH n U "5 M $s snf!UH n U "5 M f=f) aRun ``pytest.main()`` in-process, returning a HookRecorder. Runs the :py:func:`pytest.main` function to run all of pytest inside the test process itself. This means it can return a :py:class:`HookRecorder` instance which gives more detailed results from that run than can be done by matching stdout/stderr from :py:meth:`runpytest`. :param args: Command line arguments to pass to :py:func:`pytest.main`. :param plugins: Extra plugin instances the ``pytest.main()`` instance should use. :param no_reraise_ctrlc: Typically we reraise keyboard interrupts from the child run. If True, the KeyboardInterrupt exception is captured. r)gc_collect_iterations_keyc4>\rSrSr\SUUU4Sjj5rSrg)1Pytester.inline_run..PytesterHelperPluginilcx>TRTRUR55 SURT'g)Nr)rzrrKstash)rNrurpr{s rCrPBPytester.inline_run..PytesterHelperPlugin.pytest_configurems2JJt66v7K7KLM?@FLL!:;rErNrNrrlr)rrrr staticmethodrPr)rurpr{srCPytesterHelperPluginrwls@@@rEr})rric\rSrSrSrg)#Pytester.inline_run..repreci{rNrrrErCrr{srErpytest_keyboard_interrupt)_pytest.unraisableexceptionru importlibinvalidate_cachesrrzrr`r^rrkrrrr INTERRUPTEDrexcinfotypeKeyboardInterrupt) r{rrsr finalizersr}rrrr finalizerrurps ` @@rCrjPytester.inline_run=s<, J ##%w- -    d>>@HH I   .088 9C @ @ NN/1 2-1A-w?C3x1}Jh***3C(CDU2Y..337HH+--'  (%.$(  (sABE)$E))E;c8URSS5nU(aUR5 [R"5n[ S5nUR 5 UR "U0UD6nUR5upUR5 [ R"R%U 5 [ R&R%U 5 UR(ce[+UR(U R-5U R-5UR/5R05n XklU $![aNnURSn[URS5nO![a Of=f"SS5nSnAGNSnAf[a# [R"5 "SS5nGNEf=f!UR5upUR5 [ R"R%U 5 [ R&R%U 5 f=f) zlReturn result of running pytest in-process, providing a similar interface to what self.runpytest() provides.r(Frnrc\rSrSr\rSrg),Pytester.runpytest_inprocess..reprecirN)rrrrrrrrErCrrsCrErNc$\rSrSr\"S5rSrg)rirTrN)rrrrrrrrrErCrrs "1+CrE)rr(rInstantrstart_capturingrj SystemExitrrr* Exception traceback print_exc readouterrstop_capturingrnrWwriterXrrk splitlineselapsedsecondsr) r{rrr(instantcapturererr|errrVs rCrunpytest_inprocessPytester.runpytest_inprocesss  ?E:     .."#E*! " &$9&9$))+HC  " " $ JJ  S ! JJ  S !zz%%% JJ(#..*:GOOF7,F40F73F44F77A"HcURU5nURS:XaUR"U0UD6$URS:XaUR"U0UD6$[ SUR35e)zRun pytest inline or in a subprocess, depending on the command line option "--runpytest" and return a :py:class:`~pytest.RunResult`.r;r=zUnrecognized runpytest option: )_ensure_basetemprrrunpytest_subprocess RuntimeError)r{rrnew_argss rCr<Pytester.runpytestso((. <<; &++X@@ @ \\\ ),,hA&A A AsA;cDUR"U6nUR5 U$)zReturn a new pytest configured Config instance. Returns a new :py:class:`pytest.Config` instance like :py:meth:`parseconfig`, but also calls the :hook:`pytest_configure` hook. )r _do_configure)r{rrNs rCrZPytester.parseconfigures%!!4( rEc~URU5nUHnURU:XdMUs $ U<SUSU35e)aUReturn the test item for a test function. Writes the source to a python file and runs pytest's collection on the resulting module, returning the test item for the requested function name. :param source: The module source. :param funcname: The name of the test function for which to return a test item. :returns: The test item. z item not found in module: z items: )getitemsr)r{rfuncnamerrs rCrbPytester.getitemsL  f%DyyH$  VXL .s:'3 #'rirWrXzrunning:z in:wutf8r)rrWrXNcx>SnTST3nTR5 TR5 TRU5e)NTz! second timeout expired running: )killwaitr)r timeout_messagerrr{rs rChandle_timeout$Pytester.run..handle_timeouts=$(!%,I-Nwi"X  ))/::rErK)tuplerrrr raopenrrrrrrr=rflushreadr _dump_linesrnrWrX contextlibsuppressr*rrkrr)r{rrrr p1p2f1f2rrrr|rrs`` ` @rCrs Pytester.rungsJ!:':: YY   ) YY   ) j#7# j$((*% WWS6W *b''#'2OSUnn&GJJ E {{& !!# ; ;jjl%**W-C HHJ HHJ93P *<WWfW %WWfW-E'')&&(C'')&&(C.F % cjj) cjj)   ,3-C-c(9(A(ABB"00%"$%33P2O * *<.F-E % %- ,sy I<A.I* I I*:I<J(=J%J J0I'#I*&I''I** I9 4I<< J  J J J-0 J>chUH n[X2S9 M g![a [SUS35 gf=f)N)filezcouldn't print to z because of encoding)rUnicodeEncodeError)r{rfprds rCrPytester._dump_liness> Ad$! A &rd*>? @ As 11c&[RS4$)Nz-mpytest)rn executablers rC_getpytestargsPytester._getpytestargss~~z))rEcBUR[RU5$)z8Run a python script using sys.executable as interpreter.rsrnr)r{scripts rC runpythonPytester.runpythonsxx//rEcDUR[RSU5$)zRun ``python -c "command"``.z-cr)r{commands rC runpython_cPytester.runpython_csxxg66rE)rcSn[URSSS9nSU3/UQ7nURH-n[U[5(d[ SU35eSU/UQ7nM/ UR 5U-nUR"USU06$) aTRun pytest as a subprocess with given arguments. Any plugins added to the :py:attr:`plugins` list will be added using the ``-p`` command line option. Additionally ``--basetemp`` is used to put any temporary files and directories in a numbered directory prefixed with "runpytest-" to not conflict with the normal numbered pytest location for temporary files and directories. :param args: The sequence of arguments to pass to the pytest subprocess. :param timeout: The period in seconds after which to timeout and raise :py:class:`Pytester.TimeoutExpired`. :returns: The result. Tz runpytest-)rootprefixmodez --basetemp=zeSpecifying plugins as objects is not supported in pytester subprocess mode; specify by name instead: rVr)r-rrrrkr*rrs)r{rrr rplugins rCrPytester.runpytest_subprocesss&! 499\ NaS!)D)llFfc** 006x9&(4(D #""$t+xx/w//rEcURS- nURSS9 SR[[UR 555nUSUSU3nUR XRS9$)zRun pytest using pexpect. This makes sure to use the right pytest and sets up the temporary directory locations. The pexpect child is returned. z temp-pexpectr)r z --basetemp=)expect_timeout)rrrmaprkrspawn)r{stringrrinvokecmds rC spawn_pytestPytester.spawn_pytestse99~-E"#c4#6#6#89: XJax8zz#z==rEc[SS5n[[S5(a$S[R"5;a [ S5 [US5(d [ S5 UR RS5RS 5nUR"XUS 9nURRUR5 U$) z=Run a command using pexpect. The pexpect child is returned. pexpectz3.0r64zpypy-64 bit not supportedrzpexpect.spawn not availablez spawn.outwb)logfiler) r*rrnplatformmachiner+rrrrrrr)r{r rrrchilds rCrPytester.spawns y%0 3+ , ,9I9I9K1K , -w(( . /))$$[166t< cNK ""7==1 rE) rrrrrrrrrrNr) rr$rZr0r[r&rrmrlr)rlr rrK)rlr_)rKr rlr)zutf-8) rrkrzSequence[Any | bytes]rzdict[str, str]r[rkrlr )rrkrrkrrkrlr )rrkrlr )rrkrlrr)rzstr | os.PathLike[str] | Nonerlr)rstr | os.PathLike[str]rlr )rrOrlr )rNrrUrrlCollector | Item)rrrlr)r^zSequence[Item | Collector]rl list[Item])rrkrlr )rrkrlr)rlztuple[list[Item], HookRecorder])rrrsrmrlr)rrrr rlrk)r Sequence[str | os.PathLike[str]]rlzlist[str | os.PathLike[str]])rrrlr) test_func)rrrrkrlr()rrrlr)r)rrrrm)rr'rrkrlzItem | Collector | None)rrrW int | TextIOrXrr"NotSetType | bytes | IO[Any] | int)rrr float | Nonerrrlrk)rlztuple[str, ...])rzos.PathLike[str]rlrk)rrkrlrk)rrrrrlrk)g$@)rrkrrrl pexpect.spawn)r rkrrrlr)rEc(\rSrSrSSjrSSjrSrg)rQic"[5Ulgr)r stringiors rCrLineComp.__init__s  DrEcSnURR5nURRS5 URRS5 UR S5n[ U5R U5 g)zAssert that ``lines2`` are contained (linearly) in :attr:`stringio`'s value. Lines are matched using :func:`LineMatcher.fnmatch_lines `. TrrgN)r$rHtruncateseekrxrT fnmatch_lines)r{rr valrs rCassert_contains_linesLineComp.assert_contains_liness` !mm$$& q! 14F))&1rE)r$NrKr Sequence[str]rlr)rrrrrr+rrrErCrQrQs E 2rEc&\rSrSrSrSSjrSSjrSSjrSSjrSSjr SSjr SS jr SS jr \ SS j5rS S .SSjjrS S .SSjjrS S .S SjjrS!SjrS!SjrS"SjrS#SjrSSjrSrg)$rTi zFlexible matching of text. This is a convenience class to test large texts like the output of commands. The constructor takes a list of lines without their trailing newlines, i.e. ``text.splitlines()``. cXl/Ulgr)r _log_output)r{rs rCrLineMatcher.__init__*s &(rEc8SRUR5$)zgReturn the entire original text. .. versionadded:: 6.2 You can use :meth:`str` in older versions. rg)rrrs rC__str__LineMatcher.__str__.s yy$$rEc[U[5(a [U5n[U[5(aUR5RnU$r)rrkrrr)r{rs rC _getlinesLineMatcher._getlines6s; fc " "F^F ff % %\\^))F rEc4SnURU[5 g)zTCheck lines exist in the output in any order (using :func:`python:fnmatch.fnmatch`).TN)_match_lines_randomrr{rr s rCfnmatch_lines_random LineMatcher.fnmatch_lines_random=s    1rEc.SnURUS5 g)zMCheck lines exist in the output in any order (using :func:`python:re.match`).Tc@[[R"X55$rrmrematchrpats rC3LineMatcher.re_match_lines_random..Es4@S;TrEN)r:r;s rCre_match_lines_random!LineMatcher.re_match_lines_randomBs    )TUrEcSnURU5nUHonURH3nXE:XdU"XT5(dMURS[U55 MD SU<S3nURU5 UR U5 Mq g)NTz matched: line  not found in output)r7r_logr _fail)r{r match_funcr rdrmsgs rCr:LineMatcher._match_lines_randomGs{!'DZZ9 1 3 3IIk4:6 dX%9: # 3rEc[UR5H.up#X:Xd[X15(dMURUS-Ss $ [SU<S35e)zcReturn all lines following the given line in the text. The given line can contain glob wildcards. riNrJrK)rrrr*)r{fnliner rds rCget_lines_afterLineMatcher.get_lines_afterVsT !,GA~!6!6zz!a%'**-5 *>?@@rEcfURRSRSU555 g)Nrc38# UHn[U5v M g7frr)rrs rCr#LineMatcher._log..as(>AQr)r1rzr)r{rs rCrLLineMatcher._log`s% (>(> >?rEc8SRUR5$)Nrg)rr1rs rC _log_textLineMatcher._log_textcsyy))**rEF consecutivec4SnURU[SUS9 g)amCheck lines exist in the output (using :func:`python:fnmatch.fnmatch`). The argument is a list of lines which have to match and can use glob wildcards. If they do not match a pytest.fail() is called. The matches and non-matches are also shown as part of the error message. :param lines2: String patterns to match. :param consecutive: Match lines consecutively? Trr\N) _match_linesrr{rr]r s rCr)LineMatcher.fnmatch_linesgs!! &'9+NrEc.SnURUSSUS9 g)a]Check lines exist in the output (using :func:`python:re.match`). The argument is a list of lines which have to match using ``re.match``. If they do not match a pytest.fail() is called. The matches and non-matches are also shown as part of the error message. :param lines2: string patterns to match. :param consecutive: match lines consecutively? Tc@[[R"X55$rr@rCs rCrE,LineMatcher.re_match_lines..sd288C#67rEre.matchr\N)r_r`s rCre_match_linesLineMatcher.re_match_linesvs)!   7 #  rEcL[U[RR5(d![ S[ U5R 35eURU5nURSSn/nSn[U5S-nSn UGHn Sn U(GabURS5n X:XaURS[U 55 Sn MCU"X5(aKURUS3[U 55 URS RS US 9[U 55 Sn MU(aXU (aQS U <3n URU 5 URS RS US 9[U 55 URU 5 U (d+URS RS US 9[U 55 Sn URS RSUS 9[U 55 URU 5 U(aGMbSU <3n URU 5 URU 5 GM /Ulg)a Underlying implementation of ``fnmatch_lines`` and ``re_match_lines``. :param Sequence[str] lines2: List of string patterns to match. The actual format depends on ``match_func``. :param match_func: A callable ``match_func(line, pattern)`` where line is the captured line from stdout/stderr and pattern is the matching pattern. :param str match_nickname: The nickname for the match function that will be logged to stdout when a match occurs. :param consecutive: Match lines consecutively? zinvalid type for lines2: NTriFrz exact match:: {:>{width}}with:widthzno consecutive match: nomatch:and:zremains unmatched: )r collectionsabcrrrrr7rrrrLr rrMrzr1)r{rrNmatch_nicknamer]r extralinesr wnickstartedrdnomatchprintednextlinerOs rCr_LineMatcher._match_liness.&+//":":;;7V 8M8M7NOP P'A  N#a'D"N!::a=#IInd4j9"G//II 02DJ?II%,,WE,BDN#G"w 6th? # )000FX 3) )0050I4PT:*.IIm2262GhX!!(+7&:,D84 # 3CDrEc6SnURU[S5 g)z~Ensure captured lines do not match the given pattern, using ``fnmatch.fnmatch``. :param str pat: The pattern to match lines. TrN)_no_match_linerr{rDr s rCno_fnmatch_lineLineMatcher.no_fnmatch_lines ! C)4rEc0SnURUSS5 g)zEnsure captured lines do not match the given pattern, using ``re.match``. :param str pat: The regular expression to match lines. Tc@[[R"X55$rr@rCs rCrE.LineMatcher.no_re_match_line..s4(;#> XrEc[U5$)z Return the entire original text.rrs rCrkLineMatcher.strs 4yrE)r1rN)rrrlrr)rzstr | Sequence[str] | Sourcerlr.r-)rr.rNCallable[[str, str], bool]rlr)rRrkrlr.rK)rr.r]rmrlr) rr.rNrrrrkr]rmrlr)rDrkrlr)rDrkrNrrrrkrlr)rOrkrlr)rrrrrrr4r7r<rGr:rSrLr!rZr)rfr_r|rrzrMrkrrrErCrTrT s")%2 V  #  1K    A@++=B O# O59 O  O =B # 59  6" AA/A A  A AF5 $>PS . rE)rBr!rlrr{)rr$rlr)rz Iterable[str]rlr)rlrQ)rr$rlztype[LineMatcher])rr$rZr0r[r&rlrX)rlzGenerator[None])rlzGenerator[Config])kr __future__rcollections.abcrprrrrrrrrior rprtpathlibr rrAr<r=rnrtypingr r r rrrrrweakrefr iniconfigrrrr _pytest._coder_pytest.capturer_pytest.compatrrrfrrrrrr _pytest.config.argparsingr!_pytest.deprecatedr"_pytest.fixturesr#r$ _pytest.mainr%_pytest.monkeypatchr& _pytest.nodesr'r(_pytest.outcomesr)r*r+_pytest.pathlibr,r-_pytest.reportsr.r/_pytest.tmpdirr0_pytest.warning_typesr1rpytest_pluginsryrDrPrIrrrrrSrWr\rcrhcompiler|r~rkr_r^rXrQrTrrErCrs] #$%$$     %$ -!%(!##.,-$+ +#!)!'-)&*1(( 2 F=F=X  . ---6OOOd    m  L  L/> LMX L  L  L    ! !zz-0jj( i i i X ) )55BBBJ22$__rE