^h7@SrSSKrSSKJr SSKrSSKrSSKrSSKrSSKJ r SSK J r SSK J r Jr SSKJr SSKJr SS KJr SS KJr SS KJrJr SS KJr S SKJr S SKJr \R@S:Xa \RBO \RDr#\#S5r$Sr%S\%l&Sr'Sr(S)Sjr)S*Sjr*S+Sjr+"SS\RX5r-Sr.Sr/\ r0\1"\Rd"S55r3Sr4"SS \55r6S!r7"S"S#\65r8\ S$5r9\ S%5r:S&r;S,S'jr N)Path)contextmanager)StringIO)PopenPIPE)patch)Config)get_output_error_code) list_strings) temp_pyfileTee) py3compat) decorators) skipdoctestwin32c[U5n[RRU5SnUVs/sH"n[RR X#5PM$ sn$s snf)aMake full paths for all the listed files, based on startPath. Only the base part of startPath is kept, since this routine is typically used with a script's ``__file__`` variable as startPath. The base of startPath is then prepended to all the listed files, forming the output list. Parameters ---------- startPath : string Initial path to use as the base for the results. This path is split using os.path.split() and only its first component is kept. files : string or list One or more files. Examples -------- >>> full_path('/foo/bar.py',['a.txt','b.txt']) ['/foo/a.txt', '/foo/b.txt'] >>> full_path('/foo',['a.txt','b.txt']) ['/a.txt', '/b.txt'] If a single file is given, the output is still a list:: >>> full_path('/foo','a.txt') ['/a.txt'] r)r ospathsplitjoin) startPathfilesbasefs O/home/james-whalen/.local/lib/python3.13/site-packages/IPython/testing/tools.py full_pathr&sK@  E 77== #A &D+0 25aRWW\\$ !5 22 2s)Ac[R"SU[R5nU(a[UR S55nSnX#4$[R"SU[R5nU(aSn[UR S55nX#4$[R"SU[R5nU(a7[UR S55n[UR S55nX#4$g)aKParse the output of a test run and return errors, failures. Parameters ---------- txt : str Text output of a test run, assumed to contain a line of one of the following forms:: 'FAILED (errors=1)' 'FAILED (failures=1)' 'FAILED (errors=1, failures=1)' Returns ------- nerr, nfail number of errors and failures. z^FAILED \(errors=(\d+)\)rrz^FAILED \(failures=(\d+)\)z(^FAILED \(errors=(\d+), failures=(\d+)\))rr)research MULTILINEintgroup)txterr_mnerrnfailfail_mboth_ms rparse_test_outputr+Ks& II13 EE 5;;q>"  YY4c2<< HF FLLO$  YYBC||%F 6<<?#FLLO$  Fc /SQ$)zEReturn a valid default argv for creating testing instances of ipython)z--quickz--colors=NoColorz--no-term-titlez --no-bannerz --autocall=0r.r,r default_argvr/ys  r,c4[5nSURlSURlSURl[ R"SSS9n[UR5URl UR5 SURl U$)z6Return a config object with good defaults for testing.NoColorFrztest_hist.sqliteF)suffixdeletei')r TerminalInteractiveShellcolors TerminalTerminalInteractiveShell term_titleautocalltempfileNamedTemporaryFilernameHistoryManager hist_fileclose db_cache_size)configrs rdefault_configrBsx XF-6F##*9?F++6/0F##,##+>uMA&*166lF#GGI*/F' Mr,c\[RSS/nU(aSRU5nU$)a7 Return appropriate IPython command line name. By default, this will return a list that can be used with subprocess.Popen, for example, but passing `as_string=True` allows for returning the IPython command as a string. Parameters ---------- as_string: bool Flag to allow to return the command as a string. z-mIPython )sys executabler) as_string ipython_cmds rget_ipython_cmdrJs+>>43Khh{+ r,cSnUc/n[5U-n[RR[5n[ 5n[RR XP5nXd-SU/-n[RR5n SU S'U RSS5 U R5H'up[U [5(aM[X5 M) [U[[[U S9n U R!["R$"SR U55=(d SS 9up["R&"U 5["R&"U5pU (a[(R*"S S U 5n X4$) aUtility to call 'ipython filename'. Starts IPython with a minimal and safe configuration to make startup as fast as possible. Note that this starts IPython in a subprocess! Parameters ---------- fname : str, Path Name of file to be executed (should have .py or .ipy extension). options : optional, list Extra command-line flags to be passed to IPython. commands : optional, list Commands to send in on stdin Returns ------- ``(stdout, stderr)`` of ipython subprocess. TNz--ignorePYTHONWARNINGSPYCHARM_HOSTED)stdoutstderrstdinenv )inputz \x1b\[[^h]+h)r/rrdirname__file__rJrenvironcopypopitems isinstancestrprintrr communicaterencodedecoder sub)fnameoptionscommands__tracebackhide__cmdargstest_dirrI full_fnamefull_cmdrRkvpouterrs ripexecrps..nw&Gwwx(H!#Kh.J$j'99H **// C%CGG d# !S!! !K  htD#FA}}9#3#3DIIh4G#H#PD}QHC$i&6&6s&; ff_b#. 8Or,rUcSn[XU5upgU(ayU(a_SRUR5R55SRUR5R55:XdeO[ SU<SU<35eSRUR5R55SRUR5R55:Xdeg)aUtility to call 'ipython filename' and validate output/error. This function raises an AssertionError if the validation fails. Note that this starts IPython in a subprocess! Parameters ---------- fname : str, Path Name of the file to be executed (should have .py or .ipy extension). expected_out : str Expected stdout of the process. expected_err : optional, str Expected stderr of the process. options : optional, list Extra command-line flags to be passed to IPython. Returns ------- None TrSz Running file z produced error: N)rprstrip splitlines ValueError)rc expected_out expected_errrdrerfrnros ripexec_validaterws4eh/HC  99SYY[3356$))""$//1; #S*+ + 99SYY[++- .$))'')3  r,c4\rSrSrSrS SjrSrSrSrSr g) TempFileMixini z_Utility class to create temporary Python/IPython files. Meant as a mixin class for test cases.c[X5n[US5(d/UlURRU5 X0lg)zMake a valid python temp file.tmpsN)r hasattrr{appendrc)selfsrcextrcs rmktmpTempFileMixin.mktmps7C%tV$$DI  r,c[US5(a+URHn[R"U5 M gg! M%=f)Nr{)r|r{runlink)r~rcs rtearDownTempFileMixin.tearDownsA 4 IIe$ # ! s >AcU$Nr.r~s r __enter__TempFileMixin.__enter__%s r,c$UR5 gr)r)r~exc_type exc_value tracebacks r__exit__TempFileMixin.__exit__(s  r,)rcr{N)z.py) __name__ __module__ __qualname____firstlineno____doc__rrrr__static_attributes__r.r,rryry s. r,ryz8Testing {0} In: {1!r} Expected: {2!r} Got: {3!r} c Sn[US[USS55nUH-upEU"U5nXe:XaM[RX4XV55e g)agUtility function for the common case of checking a function with a sequence of input/output pairs. Parameters ---------- func : callable The function to be tested. Should accept a single argument. pairs : iterable A list of (input, expected_output) tuples. Returns ------- None. Raises an AssertionError if any output does not match the expected value. T func_namerz N)getattr pair_fail_msgformat)funcpairsrfr<inpexpectedrns r check_pairsr3sR  4gdJ &L MD 3iN 4 4T NNr,zEDid not find {0!r} in printed output (on {1}): ------- {2!s} ------- c.\rSrSrSrSSjrSrSrSrg) AssertPrintsiUzContext manager for testing that code prints certain text. Examples -------- >>> with AssertPrints("abc", suppress=False): ... print("abcd") ... print("def") ... abcd def cXl[UR[[45(aUR/UlX lX0lgr)sr\r]_re_typechannelsuppress)r~rrrs r__init__AssertPrints.__init__as3 dffsHo . .ffXDF  r,c4[[UR5Ul[ 5Ul[ UR URS9Ul[[URUR(aUR 5 gUR5 g)N)r) rrFr orig_stream MyStringIObufferr teesetattrrrs rrAssertPrints.__enter__hsW"3 5 l t{{DLL9T\\$--4;;NTXXNr,cSnUbURR5 gURR5 [[UR UR 5 URR5nURHn[U[5(aHURU5(d0[RURUR U55eM`Xe;aMg[RX`R U55e URR5 g!URR5 f=fNTF)rr?flushrrFrrrgetvaluerr\rr!notprinted_msgrpatternr~etypevaluerrfprintedrs rrAssertPrints.__exit__ns    HHNN  HHNN  Ct'7'7 8kk**,GVVa**88G,,en.C.CAIIt||]d.ee,<X)>)>q,,PW)XX<   HHNN DHHNN sD2CD2/'D22E)rrrrrrN)rOT) rrrrrrrrrr.r,rrrUs !O r,rz>Found {0!r} in printed output (on {1}): ------- {2!s} ------- c\rSrSrSrSrSrg)AssertNotPrintsiz_Context manager for checking that certain output *isn't* produced. Counterpart of AssertPrintscSnUb6URR5 URR5 gURR5 [[UR UR 5 URR5nURHn[U[5(aHURU5(a0[RURUR U55eM`Xe;aMg[RX`R U55e URR5 g!URR5 f=fr)rr?rrrFrrrrrr\rr! printed_msgrrrs rrAssertNotPrints.__exit__s     HHNN  HHNN  Ct'7'7 8kk**,GVVa** xx00:1C1C 4<<2::00+2[-?-?<<.22+  HHNN DHHNN sE CE 'E E(r.N)rrrrrrrr.r,rrrs #r,rc#l# SSKJn URnSUlSv Xlg!Xlf=f7f)Nr)warncgrr.)akws rmute_warn..sr,) IPython.utilsr)r save_warns r mute_warnrs*" I%DI  I s4)414c## [USSS9R5 Sv [R"U5 g![R"U5 f=f7f)zGCreate an empty, named, temporary file for the duration of the context.wzutf-8)encodingN)openr?rr)r<s r make_tempfilers: sW%++-  $ $sA8AAAcB^[U5mSU4Sjjn[SU5$)zTemporarily replace the input() function to return the given values Use as a context manager: with fake_input(['result1', 'result2']): ... Values are returned in order. If input() is called again after the last value was used, EOFError is raised. cX>[T5$![an[S5UeSnAff=f)NzNo more inputs given)next StopIterationEOFError)prompteits r mock_inputfake_input..mock_inputs/ :8O :12 9 :s  ) $)zbuiltins.inputrU)iterr)inputsrrs @r fake_inputrs# fB: !: ..r,c[5US/-n[U5up#nUS:XdU5eSU;deSU;deSU;deX#4$)z)test that `ipython [subcommand] -h` worksz-hr TracebackOptions --help-allrJr  subcommandcmdrnrorcs rhelp_output_testrsd  z40 0C(-LCb 7C7 c !! !    3   8Or,c[5US/-n[U5up#nUS:XdU5eSU;deSU;deSU;deX#4$)z1test that `ipython [subcommand] --help-all` worksrrrrClassrrs rhelp_all_output_testrsb  z<8 8C(-LCb 7C7 c !! !    c>> 8Or,r2)Nr.)rUNr.r)>rrpathlibrr rFr:unittest contextlibrior subprocessrr unittest.mockrtraitlets.config.loaderr IPython.utils.processr IPython.utils.textr IPython.utils.ior r rrrUrdecrplatform skip_doctest null_deco doctest_decorr+__test__r/rBrJrprwTestCaseryrrrtypecompilerrobjectrrrrrrrrr.r,rrs;  %"*7+-# ,/<<7+B{''  !3!3H'V# $7t79+-,^H%%D O0  3  *6*X l4/(r,