ifz%SrSSKJr SSKrSSKJr SSKJr SSKJr SSKJr SSK J r SSK r SSK r SSK r SS KJr SSKrSSKrSSKrSSKrSSKrSS KJr SS KJr SSKrSS KJr SS KJr SSKJr SSKJr 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. SSK-J/r/ SSK0J1r1 SSK2J3r3 SSK4J5r5 SSK6J7r7 \(a SSK8r8SSK9J:r: Sr;S rS#r?\;\<\=\>\?4r@SqASqBS$\CS%'SGS&jrDSHS'jrESIS(jrFSJS)jrGSKS*jrHSJS+jrI"S,S-\5rJ"S.S/\K5rLSLS0jrMSMSNS1jjrN"S2S3\,5rOSOS4jrPSPS5jrQSQS6jrR"S7S8\35rSSRS9jrTSSS:jrU\ STS;j5rV"S<S=\35rWSUS>jrXSVS?jrYSWS@jrZSWSAjr[SWSBjr\SXSCjr]\("SDSE9SYSFj5r^g)Zz4Discover and run doctests in modules and test files.) annotationsN)Callable) Generator)Iterable)Sequence)contextmanager)Path)Any) 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,r2choicesr3z--doctest-globappendpatz2Doctests file matching pattern, default: test*.txt doctestglob)r1r,metavarr2r3z--doctest-ignore-import-errorsz Ignore doctest collection errorsdoctest_ignore_import_errorsz--doctest-continue-on-failurez# UHn[UT5v M g7frHr).0globrNs rD _is_doctest..s8%$z$%%%s)rPsession isinitpath getoptionrR)rOrNrZglobss ` rDrWrWsO {{&&6>>+D+DT+J+J   ] + < }E 8%8 88rFc URS:H$)Nz __main__.py)r]rMs rDrTrTs 99 %%rFc0\rSrSrSSjrSSjrSrg)ReprFailDoctestcXlgrHreprlocation_lines)selfrps rD__init__ReprFailDoctest.__init__s #5rFcURH0up#UHnURU5 M URU5 M2 grH)rpline toterminal)rqtw reprlocationlinesrus rDrvReprFailDoctest.toterminals8#'#:#: L   # #B '$;rFroN)rpz0Sequence[tuple[ReprFileLocation, Sequence[str]]]returnNone)rwrr{r|)__name__ __module__ __qualname____firstlineno__rrrv__static_attributes__rJrFrDrlrls5"R5 5 (rFrlc,^\rSrSrSU4SjjrSrU=r$)MultipleDoctestFailuresc.>[TU]5 XlgrH)superrrfailures)rqr __class__s rDrr MultipleDoctestFailures.__init__s  rF)r)rz Sequence[doctest.DocTestFailure]r{r|)r}r~rrrrr __classcell__rs@rDrrs !!rFrc@^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)rrrcontinue_on_failure)rqrrrrrs rDrr8_init_runner_class..PytestDoctestRunner.__init__s G W;  W': $rFct>TR"X#U5nUR(aURU5 gUerH)DocTestFailurerr6)rqouttestexamplegotfailuredoctests rDreport_failure>_init_runner_class..PytestDoctestRunner.report_failures1,,TC@G'' 7# rFc>[US[5(aUSe[US[R5(a[R "S5 TR "X#U5nUR(aURU5 gUe)NzQuitting debugger) isinstancerbdbBdbQuitr exitUnexpectedExceptionrr6)rqrrrexc_inforrs rDreport_unexpected_exceptionK_init_runner_class..PytestDoctestRunner.report_unexpected_exceptionso(1+'788qk!(1+s{{33 1211$JG'' 7# rF)rNNrT) rdoctest.OutputChecker | Noner bool | Nonerintrboolr{r|)rdoctest.DocTestrdoctest.Examplerr?r{r|)rrrrrz>tuple[type[BaseException], BaseException, types.TracebackType]r{r|) r}r~rr__doc__rrrrrr)rrs@rDPytestDoctestRunnerrs 59#' (,  ;1 ;! ;  ; "&  ;   ; ; " %      " %   U      rFr)r DebugRunner)rrs @rD_init_runner_classrs!-g11-^ rFc<[c [5q[UUUUS9$)Nrrrr)rIrrs rD _get_runnerrs-)+  /  rFc^\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) rrrrunnerdtestobjrf_fixturemanagergetfixtureinfo _fixtureinfo names_closure fixturenames _initrequest)rqr]rZrrfm fixtureinfors rDrrDoctestItem.__init__sk &   \\ ) )''T$'G ''55 rFc >[TU]X!X4S9$)zThe public named constructor.)r]rZrr)rrV)rrZr]rrrs rDrVDoctestItem.from_parentsw"F"XXrFc00Ul[USS9Ulg)NT) _ispytest)funcargsr_requestrqs rDrDoctestItem._initrequests+- "448 rFc(URR5 [URRS9nURRS5R 5H up#X1U'M UR R RU5 g)N) getfixturedoctest_namespace)r _fillfixturesdictgetfixturevalueitemsrriupdate)rqrir]values rDsetupDoctestItem.setup sk ##% = =>==889LMSSUKD$KV &rFc[UR5 UR5 /nURR URUS9 U(a [ U5eg)N)r)_check_all_skippedr$_disable_output_capturing_for_darwinrrunr)rqrs rDruntestDoctestItem.runtest'sL4::& 11313  1 )(3 3 rFcP[R"5S:wagURRR S5nU(a`UR SS9 UR 5up#[RRU5 [RRU5 gg)zFDisable output capturing. Otherwise, stdout is lost to doctest (#985).DarwinNcapturemanagerT)in_) platformsystemrO pluginmanager getpluginsuspend_global_captureread_global_capturesysstdoutwritestderr)rqcapmanrerrs rDr0DoctestItem._disable_output_capturing_for_darwin1s| ??  ( **445EF   ) )d ) 3113HC JJ  S ! JJ  S ! rFc>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/sHunnXR-S-SSU3PM nnnU[/URS- S5URS-nO?S/nS nUR0R+5HnUR3S USU35 S nM [XRR5(a.XR5XeR6U 5R9S 5- nOt[:R<"UR>5nUS UR<3/- nU[@RB"UR>6Vs/sHnURES 5PM sn- nUR3X45 GMb [GU5$s snnfs snf)Nrrr4F03d z?EXAMPLE LOCATION UNKNOWN, not showing all tests of that examplez>>>z??? z... zUNEXPECTED EXCEPTION: )$rrrrrrrr repr_failurerrfilenamelinenor+r}r _get_checker_get_report_choicerOrh docstring splitlines enumeratemaxsourcer6output_differencersplitr from_exc_infor tracebackformat_exceptionstriprl)rqexcinforrrprrrrrmessagerxr report_choiceryixindentru inner_excinfors rDrDoctestItem.repr_failure=s     MMG22G4O4OP   H  '> ? ?}}--H  7'0 0GooG<>A;MNV#NN557DLL4xq!78"F8'#9#9::22[[-%+!. ; ;G3->3 >3@FFrFrc 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 rD_get_flag_lookupr&sZ &==%;;$99!! ' ? ? 11-/)+!  rFc`URS5n[5nSnUH nX2U-nM U$)Nr(r)getinir&)rOoptionflags_strflag_lookup_tableflag_accflags rDget_optionflagsr-s;mm$9:O(*Hd++ OrFcfURS5nU(aURS5(aSnU$)Nr;usepdbF)getvalue)rOrs rD_get_continue_on_failurer1s2 &0M N ??8 $ $"'  rFc"\rSrSrSrSSjrSrg)rXiNc## SSKnURRS5nURR U5n[ UR5nURR nSS0n[UR5n[SU[5[UR5S9nUR"5n U RX6XTS5n U R(a![RX R XS9v gg7f)Nrr-r}__main__Frrrrr]rr)rrOr(rN read_textr?r]r-rrr1 DocTestParser get_doctestexamplesrrV) rqrencodingtextrr]rirrrBrs rDr.DoctestTextfile.collects;;%%&89yy""8,tyy>yy~~Z(%dkk2 # N 8 E  &&(!!$tqA ==))99V*  sC=C?rJr{zIterable[DoctestItem])r}r~rrrr.rrJrFrDrXrXs CrFrXcr^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)rbrrs rDrd%_check_all_skipped..s%P-QiimmGLL%88-s25z!all tests skipped by +SKIP option)rallr:r)r all_skippedrs @rDrrs-P$--PPK 01rFc [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 rD _is_mockedrIs SMtT rFc#^# [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$rH)rI)r_stoprs rDF_patch_unwrap_mock_aware.._mock_aware_unwrap..sjo6Tt6TrFzGot 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` @rD_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 @rD_patch_unwrap_mock_awarer[sY..KJN +F "(GN% $s-AA A AAc\rSrSrSSjrSrg)rUic#~# 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)rqr source_linesrs rDrjBDoctestModule.collect..MockAwareDocTestFinder._find_linenosU"#x00%c637sM22%nnS1!7/$rF)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) rqtestsrr]modulerkriseenrs rDro;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)rqrqobjectrs rDrxBDoctestModule.collect..MockAwareDocTestFinder._from_module)s3 "&)*C*CDD!'!7/??rFrJr)r}r~rrr version_infopy_ver_info_minormicrois_find_lineno_brokenrjrorxrrrs@rDMockAwareDocTestFinderr_s # 0 0! 4 !G+Q%0OS5E5E5K5Ka5OQ%0OS5E5E5K5Ka5O " %(') ') @ @*rFrr:zunable to import module Fr5r6)r DocTestFinderrr CollectErrorrOr0rrNrfrparsefactoriesr-rrr1findr}r:rrVr])rqrrrqfinderrrrs rDr.DoctestModule.collects; @W%:%:; @z XXF $$33D9()%dkk2 # N 8 E  KK8D}}}!--yy.9)%% {{##$BCC/ }=>  s/D= C(BD=%D=(A D:5D=8D::D=rJNr>)r}r~rrr.rrJrFrDrUrUsZrFrUc8SSKn"SSUR5nU$)Nrc^\rSrSr\R "S\R 5r\R "S\R 5r\R "S\R5r SU4Sjjr S Sjr Sr U=r$) 2_init_checker_class..LiteralsOutputCheckeriUz(\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(dgSSjnU(a&U"UR U5nU"UR U5nU(a&U"UR U5nU"UR U5nU(aURX5n[TU]XU5$)NTFc2[R"USU5$)Nz\1\2)resub)regextxts rDremove_prefixesX_init_checker_class..LiteralsOutputChecker.check_output..remove_prefixes~svveWc22rF)rzre.Pattern[str]rr?r{r?)r check_outputr"r#r$_unicode_literal_re_bytes_literal_re_remove_unwanted_precision) rqwantrr allow_unicode allow_bytes allow_numberrrs rDr?_init_checker_class..LiteralsOutputChecker.check_outputssw#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) JrFrJ)rr?rr?rrr{r)rr?rr?r{r?)r}r~rrrcompileUNICODErrVERBOSErrrrrrs@rDLiteralsOutputCheckerrUs] !jj)CRZZPJJ'A2::NZZ & JJ) . @6  rFr)r OutputChecker)rrs rD_init_checker_classrRs"O 5 5Ob ! rFc8[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&rrJrFrDrrs+- ?rFc.SSKnUR"S5$)z+Register and return the ALLOW_UNICODE flag.rNrrregister_optionflagr%s rDr"r"s  & & 77rFc.SSKnUR"S5$)z)Register and return the ALLOW_BYTES flag.rNr rr%s rDr#r#s  & &} 55rFc.SSKnUR"S5$)z$Register and return the NUMBER flag.rNr!rr%s rDr$r$s  & &x 00rFc 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 rDrrsN  $W%9%9#W%9%9#W%9%90'2S2S"A      rFrf)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`. )rrJrFrDrrs  6MrF)rBrr{r|r)rYr rZrr{z&DoctestModule | DoctestTextfile | None)rNr r{r)rOrrNr rZrr{r)r{ztype[doctest.DocTestRunner]r) rrrrrrrrr{r)r{zdict[str, int])rOrr{r)rOrr{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__rrcollections.abcrrrr contextlibrrvrYospathlibr rrrrtypestypingr r rS_pytestr _pytest._code.coder rr _pytest._ior_pytest.compatr_pytest.configr_pytest.config.argparsingr_pytest.fixturesrr _pytest.nodesrr_pytest.outcomesrr_pytest.pathlibr_pytest.pythonr_pytest.python_apir_pytest.warning_typesrrtyping_extensionsr rrrrrrArIr&__annotations__rErKr[rSrWrTrlrRrrrrr&r-r1rXrrIr[rUrrr"r#r$rrrJrFrDrs:" $%$$%    ,/+&'!,$'#-!&!%/&#%%%+?(,  48 18/d    , A9& (l (!i! 2l-1 $  )    (CF$CFL  f>2%%:[F[|T!n(861 " yrF