?gf~%SrSSKJr SSKrSSKJr SSKrSSKrSSKrSSK J r SSK r SSK r SSK r SSKrSSKJr SSKJr SSKJr SS KJr SS KJr SS KJr SS KJr SSKrSS KJr SSKJr SSKJr SSKJr SSKJr SSK J!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. SSK/J0r0 SSK1J2r2 SSK3J4r4 SSK5J6r6 \(a SSK7r7SSK8J9r9 S r:S!r;S"r\:\;\<\=\>4r?Sq@SqAS%\BS&'SHS'jrCSIS(jrDSJS)jrESKS*jrFSLS+jrGSKS,jrH"S-S.\5rI"S/S0\J5rKSMS1jrLSNSOS2jjrM"S3S4\+5rNSPS5jrOSQS6jrPSRS7jrQ"S8S9\25rRSSS:jrSSTS;jrT\SUS<j5rU"S=S>\25rVSVS?jrWSWS@jrXSXSAjrYSXSBjrZSXSCjr[SYSDjr\\'"SESF9SZSGj5r]g)[z4Discover and run doctests in modules and test files.) annotationsN)contextmanager)Path)Any)Callable) Generator)Iterable)Pattern)Sequence) TYPE_CHECKING)outcomes) ExceptionInfo)ReprFileLocation) TerminalRepr)TerminalWriter safe_getattr)Config)Parser)fixture) TopRequest) Collector)Item)OutcomeException)skip fnmatch_ex)Module)approx) PytestWarning)Selfnonecdiffndiffudiffonly_first_failurez"type[doctest.OutputChecker] | None CHECKER_CLASSc TURSSSS/S9 URSSSS 9 URS 5nURS S S SSS9 URS[RSS[ SS9 URSS/SSSS9 URSS S SSS9 URSS S S S!S9 g)"Ndoctest_optionflagszOption flags for doctestsargsELLIPSIS)typedefaultdoctest_encodingzEncoding used for doctest fileszutf-8)r-collectz--doctest-modules store_trueFzRun doctests in all .py modulesdoctestmodules)actionr-helpdestz--doctest-reportr%z9Choose another output format for diffs on doctest failure doctestreport)r,r-r3choicesr4z--doctest-globappendpatz2Doctests file matching pattern, default: test*.txt doctestglob)r2r-metavarr3r4z--doctest-ignore-import-errorsz Ignore doctest collection errorsdoctest_ignore_import_errorsz--doctest-continue-on-failurez# UHn[UT5v M g7frIr).0globrOs rE _is_doctest..s8%$z$%%%s)rQsession isinitpath getoptionrS)rPrOr[globss ` rErXrXsO {{&&6>>+D+DT+J+J   ] + < }E 8%8 88rGc URS:H$)Nz __main__.py)r^rNs rErUrUs 99 %%rGc0\rSrSrSSjrSSjrSrg)ReprFailDoctestcXlgrIreprlocation_lines)selfrqs rE__init__ReprFailDoctest.__init__s #5rGcURH0up#UHnURU5 M URU5 M2 grI)rqline toterminal)rrtw reprlocationlinesrvs rErwReprFailDoctest.toterminals8#'#:#: L   # #B '$;rGrpN)rqz0Sequence[tuple[ReprFileLocation, Sequence[str]]]returnNone)rxrr|r})__name__ __module__ __qualname____firstlineno__rsrw__static_attributes__rKrGrErmrms5"R5 5 (rGrmc,^\rSrSrSU4SjjrSrU=r$)MultipleDoctestFailuresc.>[TU]5 XlgrI)superrsfailures)rrr __class__s rErs MultipleDoctestFailures.__init__s  rG)r)rz Sequence[doctest.DocTestFailure]r|r})r~rrrrsr __classcell__rs@rErrs !!rGrc@^SSKm"U4SjSTR5nU$)Nrc>^\rSrSrSrSSU4SjjjrS U4SjjrS U4SjjrSrU=r $) /_init_runner_class..PytestDoctestRunnerzpRunner to collect failures. Note that the out variable in this case is a list instead of a stdout-like object. c.>[TU]XUS9 X@lg)N)checkerverbose optionflags)rrscontinue_on_failure)rrrrrrrs rErs8_init_runner_class..PytestDoctestRunner.__init__s G W;  W': $rGct>TR"X#U5nUR(aURU5 gUerI)DocTestFailurerr7)rrouttestexamplegotfailuredoctests rEreport_failure>_init_runner_class..PytestDoctestRunner.report_failures1,,TC@G'' 7# rGc>[US[5(aUSe[US[R5(a[R "S5 TR "X#U5nUR(aURU5 gUe)NzQuitting debugger) isinstancerbdbBdbQuitr exitUnexpectedExceptionrr7)rrrrrexc_inforrs rEreport_unexpected_exceptionK_init_runner_class..PytestDoctestRunner.report_unexpected_exceptionso(1+'788qk!(1+s{{33 1211$JG'' 7# rG)rNNrT) rdoctest.OutputChecker | Noner bool | Nonerintrboolr|r})rdoctest.DocTestrdoctest.Examplerr@r|r})rrrrrz>tuple[type[BaseException], BaseException, types.TracebackType]r|r}) r~rrr__doc__rsrrrr)rrs@rEPytestDoctestRunnerrs 59#' (,  ;1 ;! ;  ; "&  ;   ; ; " %      " %   U      rGr)r DebugRunner)rrs @rE_init_runner_classrs!-g11-^ rGc<[c [5q[UUUUS9$)Nrrrr)rJrrs rE _get_runnerrs-)+  /  rGc^\rSrSrS U4Sjjr\S U4Sjj5rS SjrS SjrS Sjr S Sjr SU4Sjjr SS jr S r U=r$) DoctestItemc>[TU]X5 X0lX@lSUlUR R nURUSSS9nX`lURUl UR5 g)N)nodefunccls) rrsrunnerdtestobjrg_fixturemanagergetfixtureinfo _fixtureinfo names_closure fixturenames _initrequest)rrr^r[rrfm fixtureinfors rErsDoctestItem.__init__sk &   \\ ) )''T$'G ''55 rGc >[TU]X!X4S9$)zThe public named constructor.)r^r[rr)rrW)rr[r^rrrs rErWDoctestItem.from_parentsw"F"XXrGc00Ul[USS9Ulg)NT) _ispytest)funcargsr_requestrrs rErDoctestItem._initrequests+- "448 rGc(URR5 [URRS9nURRS5R 5H up#X1U'M UR R RU5 g)N) getfixturedoctest_namespace)r _fillfixturesdictgetfixturevalueitemsrrjupdate)rrrjr^values rEsetupDoctestItem.setup sk ##% = =>==889LMSSUKD$KV &rGc[UR5 UR5 /nURR URUS9 U(a [ U5eg)N)r)_check_all_skippedr$_disable_output_capturing_for_darwinrrunr)rrrs rEruntestDoctestItem.runtest'sL4::& 11313  1 )(3 3 rGcP[R"5S:wagURRR S5nU(a`UR SS9 UR 5up#[RRU5 [RRU5 gg)zFDisable output capturing. Otherwise, stdout is lost to doctest (#985).DarwinNcapturemanagerT)in_) platformsystemrP pluginmanager getpluginsuspend_global_captureread_global_capturesysstdoutwritestderr)rrcapmanrerrs rEr0DoctestItem._disable_output_capturing_for_darwin1s| ??  ( **445EF   ) )d ) 3113HC JJ  S ! JJ  S ! rGc>SSKnSn[URURUR45(aUR/nO5[UR[ 5(aURR nUc[TU]!U5$/nUGH^nURnURnURnURcSn OURUR-S-n [U5Rn [XU 5n [!5n [#UR$R'S55n U bURR(ceURR(R+S5nURce[-U5VVs/sHunnSXR-S-U4-PM nnnU[/URS- S5URS-nO?S/nSnUR0R+5HnUR3S US U35 S nM [XRR5(a.XR5XeR6U 5R9S 5- nOt[:R<"UR>5nUS UR<3/- nU[@RB"UR>6Vs/sHnURES 5PM sn- nUR3X45 GMa [GU5$s snnfs snf)Nrrr5Fz%03d %s z?EXAMPLE LOCATION UNKNOWN, not showing all tests of that examplez>>>z???  z... zUNEXPECTED EXCEPTION: )$rrrrrrrr repr_failurerrfilenamelinenor,r~r _get_checker_get_report_choicerPri docstring splitlines enumeratemaxsourcer7output_differencersplitr from_exc_infor tracebackformat_exceptionstriprm)rrexcinforrrqrrrrrmessageryr report_choicerzixindentrv inner_excinfors rErDoctestItem.repr_failure=s     MMG22G4O4OP   H  '> ? ?}}--H  7'0 0GooG<>A;MNV#NN557DLL4xq!78"F8'#9#9::22[[-%+!. ; ;GLcbURURRSUR34$)Nz [doctest] )rOrrr^rs rE reportinfoDoctestItem.reportinfo}s(yy$**++z$))-EEErG)rrrrrrr) r^r@r[DoctestTextfile | DoctestModulerdoctest.DocTestRunnerrrr|r}) r[rr^r@rrrrr|r!r|r})r zExceptionInfo[BaseException]r|zstr | TerminalRepr)r|z.tuple[os.PathLike[str] | str, int | None, str])r~rrrrs classmethodrWrrrrrrrrrs@rErrs0&     & Y/ Y Y & Y  Y  Y Y9'4 ">3->3 >3@FFrGrc SSKn[URURURUR UR UR[5[5[5S9 $)Nr) DONT_ACCEPT_TRUE_FOR_1DONT_ACCEPT_BLANKLINENORMALIZE_WHITESPACEr+IGNORE_EXCEPTION_DETAILCOMPARISON_FLAGS ALLOW_UNICODE ALLOW_BYTESNUMBER) rrrrrr+rr_get_allow_unicode_flag_get_allow_bytes_flag_get_number_flagrs rE_get_flag_lookupr&sZ &==%;;$99!! ' ? ? 11-/)+!  rGc`URS5n[5nSnUH nX2U-nM U$)Nr)r)getinir&)rPoptionflags_strflag_lookup_tableflag_accflags rEget_optionflagsr-s;mm$9:O(*Hd++ OrGcfURS5nU(aURS5(aSnU$)Nr<usepdbF)getvalue)rPrs rE_get_continue_on_failurer1s2 &0M N ??8 $ $"'  rGc"\rSrSrSrSSjrSrg)rYiNc## SSKnURRS5nURR U5n[ UR5nURR nSS0n[UR5n[SU[5[UR5S9nUR"5n U RX6XTS5n U R(a![RX R XS9v gg7f)Nrr.r~__main__Frrrrr^rr)rrPr(rO read_textr@r^r-rrr1 DocTestParser get_doctestexamplesrrW) rrrencodingtextrr^rjrrrCrs rEr/DoctestTextfile.collects;;%%&89yy""8,tyy>yy~~Z(%dkk2 # N 8 E  &&(!!$tqA ==))99V*  sC=C?rKr|zIterable[DoctestItem])r~rrrrr/rrKrGrErYrYs CrGrYcr^SSKm[U4SjUR55nU(a [S5 gg)zRRaise pytest.skip() if all examples in the given DocTest have the SKIP option set.rNc3n># UH*oRRTRS5v M, g7f)FN)optionsgetSKIP)rcrrs rEre%_check_all_skipped..s%P-QiimmGLL%88-s25z!all tests skipped by +SKIP option)rallr:r)r all_skippedrs @rErrs-P$--PPK 01rGc [USS5SL$)ziReturn if an object is possibly a mock object by checking the existence of a highly improbable attribute.1pytest_mock_example_attribute_that_shouldnt_existNr)rs rE _is_mockedrIs SMtT rGc#^# [RmSS.SU4SjjjnU[lSv T[lg!T[lf=f7f)z|Context manager which replaces ``inspect.unwrap`` with a version that's aware of mock objects and doesn't recurse into them.Nstopc>^^Ub U[La T"T[S9$UmT"TUU4SjS9$![a*n[R"SU<ST<S3[5 eSnAff=f)NrKc8>[U5=(d T"T5$rI)rI)r_stoprs rEF_patch_unwrap_mock_aware.._mock_aware_unwrap..sjo6Tt6TrGzGot z when unwrapping z. This is usually caused by a violation of Python's object protocol; see e.g. https://github.com/pytest-dev/pytest/issues/5080)rI Exceptionwarningswarnr )rrLerO real_unwraps` @rE_mock_aware_unwrap4_patch_unwrap_mock_aware.._mock_aware_unwrapst |tz1"4j99Et*TU U  MMqe,TH5CC    s* * A%AA)rzCallable[..., Any]rLzCallable[[Any], Any] | Noner|r)inspectunwrap)rWrVs @rE_patch_unwrap_mock_awarer[sY..KJN +F "(GN% $s-AA A AAc\rSrSrSSjrSrg)rVic#~# SSKn"SSUR5nURnURRRU5 U"5n[UR 5n[SU[5[UR 5S9nUR!WUR"5H6nUR$(dM[&R)XR*XgS9v M8 g![Ra> UR R S5(a[SUR<35 GNef=f7f) Nrcz^\rSrSr\R SSr\S:=(dQ \S:H=(a \R RS:=(d% \S:H=(a \R RS:r\(aU4Sjr \R S :a SU4S jjr \R S :a U4S jr S r U=r $S r U=r $)5DoctestModule.collect..MockAwareDocTestFinderiN) r)ra rac>[U[5(a [USU5n[US5(a[R "U5n[ TU]UU5$)zOn older Pythons, doctest code does not take into account `@property`. https://github.com/python/cpython/issues/61648 Moreover, wrapped Doctests need to be unwrapped so the correct line number is returned. #8796 fget __wrapped__)rpropertygetattrhasattrrYrZr _find_lineno)rrr source_linesrs rErjBDoctestModule.collect..MockAwareDocTestFinder._find_linenosU"#x00%c637sM22%nnS1!7/$rG)ra c >[U5(ag[5 [TU] XX4XVU5 SSS5 g!,(df  g=f)zOverride _find to work around issue in stdlib. https://github.com/pytest-dev/pytest/issues/3456 https://github.com/python/cpython/issues/69718 N)rIr[r_find) rrtestsrr^modulerkrjseenrs rEro;DoctestModule.collect..MockAwareDocTestFinder._finds8"#13 !l4433s 9 A)ra cx>[U[R5(a URn[TU]X5$)z`cached_property` objects are never considered a part of the 'current module'. As such they are skipped by doctest. Here we override `_from_module` to check the underlying function instead. https://github.com/python/cpython/issues/107995 )r functoolscached_propertyrr _from_module)rrrqobjectrs rErxBDoctestModule.collect..MockAwareDocTestFinder._from_module)s3 "&)*C*CDD!'!7/??rGrKr)r~rrrr version_infopy_ver_info_minormicrois_find_lineno_brokenrjrorxrrrs@rEMockAwareDocTestFinderr_s # 0 0! 4 !G+Q%0OS5E5E5K5Ka5OQ%0OS5E5E5K5Ka5O " %(') ') @ @*rGrr;zunable to import module Fr5r6)r DocTestFinderrr CollectErrorrPr0rrOrgrparsefactoriesr-rrr1findr~r:rrWr^)rrrrrqfinderrrrs rEr/DoctestModule.collects; @W%:%:; @z XXF $$33D9()%dkk2 # N 8 E  KK8D}}}!--yy.9)%% {{##$BCC/ }=>  s/D= C(BD=%D=(A D:5D=8D::D=rKNr>)r~rrrr/rrKrGrErVrVsZrGrVcH^SSKnSSKm"U4SjSUR5nU$)Nrc>^\rSrSrYR SYR 5rYR SYR 5rYR SYR5r SUU4Sjjr S Sjr Sr U=r $) 2_init_checker_class..LiteralsOutputCheckeriVz(\W|^)[uU]([rR]?[\'\"])z(\W|^)[bB]([rR]?[\'\"])a (?P (?P (?P [+-]?\d*)\.(?P\d+) | (?P [+-]?\d+)\. ) (?: [Ee] (?P [+-]?\d+) )? | (?P [+-]?\d+) (?: [Ee] (?P [+-]?\d+) ) ) c>[TU]XU5(agU[5-nU[5-nU[ 5-nU(dU(dU(dgSU 4SjjnU(a&U"UR U5nU"UR U5nU(a&U"UR U5nU"UR U5nU(aURX5n[TU]XU5$)NTFc*>TRUSU5$)Nz\1\2)sub)regextxtres rEremove_prefixesX_init_checker_class..LiteralsOutputChecker.check_output..remove_prefixessvveWc22rG)rz Pattern[str]rr@r|r@)r check_outputr"r#r$_unicode_literal_re_bytes_literal_re_remove_unwanted_precision) rrwantrr allow_unicode allow_bytes allow_numberrrrs rEr?_init_checker_class..LiteralsOutputChecker.check_outputtsw#D{;;'*A*CCM%(=(??K&)9);;L \ 3&t'?'?F%d&>&>D&t'='=tD%d&<&.LiteralsOutputChecker._remove_unwanted_precisionsT11$78E0056D5zSY& FE('(wwz':'(ww{';# ww{3H!)!1As8} 'X.I#veAGGI.>B N'SS 0aggi&01AGGI=EEGfDTDV@WWeeg 1QUUWqwwy5HIIF) JrGrK)rr@rr@rrr|r)rr@rr@r|r@)r~rrrcompileUNICODErrVERBOSErrrrr)rrs@rELiteralsOutputCheckerrVsc !jj)CRZZPJJ'A2::NZZ & JJ) . @ @6  rGr)rr OutputChecker)rrrs @rE_init_checker_classrRs& O 5 5Ob ! rGc8[c [5q[5$)aReturn a doctest.OutputChecker subclass that supports some additional options: * ALLOW_UNICODE and ALLOW_BYTES options to ignore u'' and b'' prefixes (respectively) in string literals. Useful when the same doctest should run in Python 2 and Python 3. * NUMBER to ignore floating-point differences smaller than the precision of the literal number in the doctest. An inner class is used to avoid importing "doctest" at the module level. )r'rrKrGrErrs+- ?rGc.SSKnUR"S5$)z+Register and return the ALLOW_UNICODE flag.rNrrregister_optionflagr%s rEr"r"s  & & 77rGc.SSKnUR"S5$)z)Register and return the ALLOW_BYTES flag.rNr rr%s rEr#r#s  & &} 55rGc.SSKnUR"S5$)z$Register and return the NUMBER flag.rNr!rr%s rEr$r$s  & &x 00rGc SSKn[UR[UR[ UR [UR[S0U$)zReturn the actual `doctest` module flag value. We want to do it as late as possible to avoid importing `doctest` and all its dependencies when parsing options, as it adds overhead and breaks tests. rN) rDOCTEST_REPORT_CHOICE_UDIFF REPORT_UDIFFDOCTEST_REPORT_CHOICE_CDIFF REPORT_CDIFFDOCTEST_REPORT_CHOICE_NDIFF REPORT_NDIFF(DOCTEST_REPORT_CHOICE_ONLY_FIRST_FAILUREREPORT_ONLY_FIRST_FAILUREDOCTEST_REPORT_CHOICE_NONE)keyrs rErrsN  $W%9%9#W%9%9#W%9%90'2S2S"A      rGrg)scopec[5$)a`Fixture that returns a :py:class:`dict` that will be injected into the namespace of doctests. Usually this fixture is used in conjunction with another ``autouse`` fixture: .. code-block:: python @pytest.fixture(autouse=True) def add_np(doctest_namespace): doctest_namespace["np"] = numpy For more details: :ref:`doctest_namespace`. )rrKrGrErrs  6MrG)rCrr|r}r)rZrr[rr|z&DoctestModule | DoctestTextfile | None)rOrr|r)rPrrOrr[rr|r)r|ztype[doctest.DocTestRunner]r) rrrrrrrrr|r)r|zdict[str, int])rPrr|r)rPrr|r)rrr|r})rryr|r)r|zGenerator[None])r|ztype[doctest.OutputChecker])r|zdoctest.OutputChecker)r|r)rr@r|r)r|zdict[str, Any])^r __future__rr contextlibrrvrYospathlibrrrrtypestypingrrrr r r r rS_pytestr _pytest._code.coderrr _pytest._ior_pytest.compatr_pytest.configr_pytest.config.argparsingr_pytest.fixturesrr _pytest.nodesrr_pytest.outcomesrr_pytest.pathlibr_pytest.pythonr_pytest.python_apir_pytest.warning_typesr rtyping_extensionsr!rrrrrrBrJr'__annotations__rFrLr\rTrXrUrmrRrrrrr&r-r1rYrrIr[rVrrr"r#r$rrrKrGrErs:" %    ,/+&'!,$'#-!&!%/&#%%%+?(,  48 18/d    , A9& (l (!i! 2l-1 $  )    (CF$CFL  f>2%%:[F[|U!p(861 " yrG