o Zh6@sdZddlZddlmZddlZddlZddlZddlZddlm Z ddl m Z ddl m Z mZddlmZddlmZdd lmZdd lmZdd lmZmZdd lmZd dlmZd dlmZej dkrjej!nej"Z#e#de$de%e$de%e$fddZ&ddZ'de'_(ddZ)ddZ*d:ddZ+d;d d!Z, " dd=d8d9Z?dS)>zWGeneric testing tools. Authors ------- - Fernando Perez N)Path)contextmanager)StringIO)PopenPIPE)patch)Config)get_output_error_code) list_strings) temp_pyfileTee) py3compat) decorators) skipdoctestwin32 startPathfilesreturncs0t|tsJtj|dfdd|DS)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 : 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'] rcsg|] }tj|qS)ospathjoin).0fbaserL/var/www/html/lang_env/lib/python3.10/site-packages/IPython/testing/tools.py Cszfull_path..) isinstancelistrrsplit)rrrrr full_path&sr"cCstd|tj}|rt|d}d}||fStd|tj}|r.d}t|d}||fStd|tj}|rJt|d}t|d}||fSdS)aParse 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)txtZerr_mZnerrZnfailZfail_mZboth_mrrrparse_test_outputFs$r*FcCsgdS)zEReturn a valid default argv for creating testing instances of ipython)z--quickz--colors=NoColorz--no-term-titlez --no-bannerz --autocall=0rrrrr default_argvtsr+cCsNt}d|j_d|j_d|j_tjddd}t|j |j _ | d|j _ |S)z6Return a config object with good defaults for testing.ZNoColorFrztest_hist.sqliteF)suffixdeletei')rTerminalInteractiveShellcolorsZ TerminalTerminalInteractiveShellZ term_titleZautocalltempfileNamedTemporaryFilernameZHistoryManagerZ hist_filecloseZ db_cache_size)configrrrrdefault_config}sr6cCstjddg}|r d|}|S)aW 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-mZIPython )sys executabler) as_string ipython_cmdrrrget_ipython_cmds  r<rcCsd}|durg}t|}tjt}t}tj||}||d|g}tj} d| d<| dd| D]\} } t | t sFt | | q8t|ttt| d} | jtd|p[dd \} }t| t|} }| rttd d | } | |fS) 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--ignoreZPYTHONWARNINGSZPYCHARM_HOSTED)stdoutstderrstdinenv )inputz \x1b\[[^h]+h)r+rrdirname__file__r<renvironcopypopitemsrstrprintrr communicater encodedecoder$sub)fnameoptionscommands__tracebackhide__ZcmdargsZtest_dirr;Z full_fnameZfull_cmdrAkvpouterrrrripexecs*       rZrDcCsd}t|||\}}|r+|r#d|d|ks"Jntd||fd|d|ks?JdS)a9Utility 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 TrBz"Running file %r produced error: %rN)rZrstrip splitlines ValueError)rQZ expected_outZ expected_errrRrSrTrXrYrrripexec_validates   r^c@s2eZdZdZd ddZddZddZd d Zd S) TempFileMixinzcUtility class to create temporary Python/IPython files. Meant as a mixin class for test cases..pycCs0t||}t|ds g|_|j|||_dS)zMake a valid python temp file.tmpsN)r hasattrraappendrQ)selfsrcextrQrrrmktmp s    zTempFileMixin.mktmpcCs6t|dr|jD]}zt|WqYqdSdS)Nra)rbrarunlink)rdrQrrrtearDowns  zTempFileMixin.tearDowncCs|SNrrdrrr __enter__ szTempFileMixin.__enter__cCs |dSrj)ri)rdexc_type exc_value tracebackrrr__exit__#s zTempFileMixin.__exit__N)r`)__name__ __module__ __qualname____doc__rgrirlrprrrrr_s   r_z8Testing {0} In: {1!r} Expected: {2!r} Got: {3!r} cCsNd}t|dt|dd}|D]\}}||}||ks$Jt||||qdS)aUtility 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_namerqz N)getattr pair_fail_msgformat)funcpairsrTr3inpexpectedrXrrr check_pairs.s  r}zEDid not find {0!r} in printed output (on {1}): ------- {2!s} ------- c@s*eZdZdZd ddZddZdd Zd S) AssertPrintszContext manager for testing that code prints certain text. Examples -------- >>> with AssertPrints("abc", suppress=False): ... print("abcd") ... print("def") ... abcd def r>TcCs0||_t|jttfr|jg|_||_||_dSrj)srrK_re_typechannelsuppress)rdrrrrrr__init__\s   zAssertPrints.__init__cCsNtt|j|_t|_t|j|jd|_tt|j|j r!|jdS|jdS)N)r) rvr8r orig_stream MyStringIObufferr teesetattrrrkrrrrlcs&zAssertPrints.__enter__cCsd}zP|durW|jdS|jtt|j|j|j}|j D]&}t |t r<| |s;Jt |j|j|q$||vsJJt ||j|q$W|jdS|jwNTF)rr4flushrr8rrrgetvaluerrrr%notprinted_msgrxpatternrdetypevaluerorTZprintedrrrrrpis    "zAssertPrints.__exit__N)r>T)rqrrrsrtrrlrprrrrr~Ps   r~z>Found {0!r} in printed output (on {1}): ------- {2!s} ------- c@seZdZdZddZdS)AssertNotPrintszcContext manager for checking that certain output *isn't* produced. Counterpart of AssertPrintscCsd}zU|dur|jW|jdS|jtt|j|j|j}|j D]&}t |t rA| |r@Jt |j|j|q)||vsOJt ||j|q)W|jdS|jwr)rr4rrr8rrrrrrrr% printed_msgrxrrrrrrps&      zAssertNotPrints.__exit__N)rqrrrsrtrprrrrrs rccs:ddlm}|j}dd|_z dVW||_dS||_w)Nr)warnc_sdSrjr)akwrrrszmute_warn..) IPython.utilsr)rZ save_warnrrr mute_warns  rc cs8t|dddz dVWt|dSt|w)zGCreate an empty, named, temporary file for the duration of the context.wzutf-8)encodingN)openr4rrh)r3rrr make_tempfiles rcs t|dfdd }td|S)aTemporarily 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. rDc s.ztWSty}ztd|d}~ww)NzNo more inputs given)next StopIterationEOFError)prompteitrr mock_inputs   zfake_input..mock_inputzbuiltins.inputNrD)iterr)Zinputsrrrr fake_inputs  rcCXt|dg}t|\}}}|dksJ|d|vsJd|vs"Jd|vs(J||fS)z)test that `ipython [subcommand] -h` worksz-hr TracebackOptions --help-allr<r  subcommandcmdrXrYrcrrrhelp_output_test   rcCr)z1test that `ipython [subcommand] --help-all` worksrrrrClassrrrrrhelp_all_output_testrrr,)Nr)rDNrr)@rtrpathlibrr$r8r1Zunittest contextlibrior subprocessrrZ unittest.mockrZtraitlets.config.loaderrZIPython.utils.processr ZIPython.utils.textr ZIPython.utils.ior r rr rDrdecrplatformZ skip_doctestZ null_decoZ doctest_decorKr r"r*Z__test__r+r6r<rZr^ZTestCaser_rwr}rtypecompilerrobjectr~rrrrrrrrrrrs\           + : /",