o
    ˷e7                     @   s  d Z ddlZddlmZ ddlZddlZddlZddlZddlm	Z	 ddl
mZ ddlmZmZ ddlmZ ddlmZ dd	lmZ dd
lmZ ddlmZmZ ddlmZ ddlmZ ddlmZ ej dkrjej!nej"Z#e#dd Z$dd Z%de%_&dd Z'dd Z(d7ddZ)d8ddZ*		d9d d!Z+G d"d# d#ej,Z-d$Z.d%d& Z/eZ0e1e2dZ3d'Z4G d(d) d)e5Z6d*Z7G d+d, d,e6Z8e	d-d. Z9e	d/d0 Z:d1d2 Z;d:d3d4Z<d:d5d6Z=dS );zWGeneric testing tools.

Authors
-------
- Fernando Perez <Fernando.Perez@berkeley.edu>
    N)Path)contextmanager)StringIO)PopenPIPE)patch)Config)get_output_error_code)list_strings)temp_pyfileTee)	py3compat   )
decorators)skipdoctestwin32c                    s*   t |}tj| d   fdd|D S )aP  Make 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   c                    s   g | ]	}t j |qS  )ospathjoin).0fbaser   L/var/www/ideatree/venv/lib/python3.10/site-packages/IPython/testing/tools.py
<listcomp>H   s    zfull_path.<locals>.<listcomp>)r
   r   r   split)	startPathfilesr   r   r   	full_path&   s    r   c                 C   s   t d| t j}|rt|d}d}||fS t d| t j}|r.d}t|d}||fS t d| t j}|rJt|d}t|d}||fS dS )a  Parse 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+)\)r   r   z^FAILED \(failures=(\d+)\)z(^FAILED \(errors=(\d+), failures=(\d+)\)   )r   r   )research	MULTILINEintgroup)txterr_mnerrnfailfail_mboth_mr   r   r   parse_test_outputK   s$   r,   Fc                   C   s   g dS )zEReturn a valid default argv for creating testing instances of ipython)z--quickz--colors=NoColorz--no-term-titlez--no-bannerz--autocall=0r   r   r   r   r   default_argvy   s   r-   c                  C   sN   t  } d| j_d| j_d| j_tjddd}t|j	| j
_|  d| j
_| S )z6Return a config object with good defaults for testing.NoColorFr   ztest_hist.sqliteF)suffixdeletei'  )r   TerminalInteractiveShellcolors TerminalTerminalInteractiveShell
term_titleautocalltempfileNamedTemporaryFiler   nameHistoryManager	hist_fileclosedb_cache_size)configr   r   r   r   default_config   s   r?   c                 C   s   t jddg}| 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-mIPython )sys
executabler   )	as_stringipython_cmdr   r   r   get_ipython_cmd   s   
rF   r   c                 C   s   d}|du rg }t  | }tjt}t }tj|| }|| d|g }tj }	d|	d< |		dd |	
 D ]\}
}t|tsFt|
| q8t|ttt|	d}|jtd|p[dd	\}}t|t|}}|rttd
d|}||fS )a  Utility 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--ignorePYTHONWARNINGSPYCHARM_HOSTED)stdoutstderrstdinenv
)inputz\x1b\[[^h]+h )r-   r   r   dirname__file__rF   r   environcopypopitems
isinstancestrprintr   r   communicater   encodedecoder!   sub)fnameoptionscommands__tracebackhide__cmdargstest_dirrE   
full_fnamefull_cmdrM   kvpouterrr   r   r   ipexec   s*   



 rk   rP   c                 C   s   d}t | ||\}}|r+|r#d|  d|  ks"J ntd| |f d|  d|  ks?J dS )a9  Utility 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
    TrN   z"Running file %r produced error: %rN)rk   r   strip
splitlines
ValueError)r^   expected_outexpected_errr_   r`   ra   ri   rj   r   r   r   ipexec_validate   s   

rq   c                   @   s2   e Zd ZdZdddZdd Zdd Zd	d
 ZdS )TempFileMixinzcUtility class to create temporary Python/IPython files.

    Meant as a mixin class for test cases..pyc                 C   s0   t ||}t| dsg | _| j| || _dS )zMake a valid python temp file.tmpsN)r   hasattrrt   appendr^   )selfsrcextr^   r   r   r   mktmp  s
   


zTempFileMixin.mktmpc                 C   s6   t | dr| jD ]}zt| W q   Y qd S d S )Nrt   )ru   rt   r   unlink)rw   r^   r   r   r   tearDown  s   

zTempFileMixin.tearDownc                 C   s   | S Nr   rw   r   r   r   	__enter__%  s   zTempFileMixin.__enter__c                 C   s   |    d S r}   )r|   )rw   exc_type	exc_value	tracebackr   r   r   __exit__(  s   zTempFileMixin.__exit__N)rs   )__name__
__module____qualname____doc__rz   r|   r   r   r   r   r   r   rr   
  s    
rr   z8Testing {0}

In:
  {1!r}
Expected:
  {2!r}
Got:
  {3!r}
c                 C   sN   d}t | dt | dd}|D ]\}}| |}||ks$J t||||qdS )a  Utility 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_namer   z	<unknown>N)getattrpair_fail_msgformat)funcpairsra   r9   inpexpectedri   r   r   r   check_pairs3  s   r   zEDid not find {0!r} in printed output (on {1}):
-------
{2!s}
-------
c                   @   s*   e Zd ZdZdddZdd Zdd	 Zd
S )AssertPrintszContext manager for testing that code prints certain text.

    Examples
    --------
    >>> with AssertPrints("abc", suppress=False):
    ...     print("abcd")
    ...     print("def")
    ...
    abcd
    def
    rJ   Tc                 C   s0   || _ t| j ttfr| j g| _ || _|| _d S r}   )srW   rX   _re_typechannelsuppress)rw   r   r   r   r   r   r   __init__a  s
   

zAssertPrints.__init__c                 C   sN   t t| j| _t | _t| j| jd| _tt| j| j	r!| j d S | j d S )N)r   )
r   rB   r   orig_stream
MyStringIObufferr   teesetattrr   r~   r   r   r   r   h  s   &zAssertPrints.__enter__c                 C   s   d}zP|d urW | j   dS | j   tt| j| j | j }| j	D ]&}t
|tr<||s;J t|j| j|q$||v sJJ t|| j|q$W | j   dS | j   w NTF)r   r<   flushr   rB   r   r   r   getvaluer   rW   r   r"   notprinted_msgr   patternrw   etypevaluer   ra   printedr   r   r   r   r   n  s   



"zAssertPrints.__exit__N)rJ   T)r   r   r   r   r   r   r   r   r   r   r   r   U  s
    
r   z>Found {0!r} in printed output (on {1}):
-------
{2!s}
-------
c                   @   s   e Zd ZdZdd ZdS )AssertNotPrintszcContext manager for checking that certain output *isn't* produced.

    Counterpart of AssertPrintsc                 C   s   d}zU|d ur| j   W | j   dS | j   tt| j| j | j }| j	D ]&}t
|trA||r@J t|j| j|q)||vsOJ t|| j|q)W | j   dS | j   w r   )r   r<   r   r   rB   r   r   r   r   r   rW   r   r"   printed_msgr   r   r   r   r   r   r     s&   





zAssertNotPrints.__exit__N)r   r   r   r   r   r   r   r   r   r     s    r   c                  c   s:    ddl m}  | j}dd | _z	d V  W || _d S || _w )Nr   )warnc                  _   s   d S r}   r   )akwr   r   r   <lambda>  s    zmute_warn.<locals>.<lambda>)IPython.utilsr   )r   	save_warnr   r   r   	mute_warn  s   
r   c              	   c   s8    t | ddd  zdV  W t|  dS t|  w )zGCreate an empty, named, temporary file for the duration of the context.wzutf-8)encodingN)openr<   r   r{   )r9   r   r   r   make_tempfile  s
   r   c                    s    t |  d fdd	}td|S )a  Temporarily 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.
    rP   c              
      s.   zt  W S  ty } ztd|d }~ww )NzNo more inputs given)nextStopIterationEOFError)prompteitr   r   
mock_input  s   

zfake_input.<locals>.mock_inputzbuiltins.inputNrP   )iterr   )inputsr   r   r   r   
fake_input  s   
r   c                 C   X   t  | dg }t|\}}}|dksJ |d|vsJ d|v s"J d|v s(J ||fS )z)test that `ipython [subcommand] -h` worksz-hr   	TracebackOptions
--help-allrF   r	   
subcommandcmdri   rj   rcr   r   r   help_output_test     r   c                 C   r   )z1test that `ipython [subcommand] --help-all` worksr   r   r   r   Classr   r   r   r   r   help_all_output_test  r   r   r/   )Nr   )rP   Nr   r   )>r   r   pathlibr   r!   rB   r7   unittest
contextlibr   ior   
subprocessr   r   unittest.mockr   traitlets.config.loaderr   IPython.utils.processr	   IPython.utils.textr
   IPython.utils.ior   r   r   r   rP   r   decr   platformskip_doctest	null_decodoctest_decor   r,   __test__r-   r?   rF   rk   rq   TestCaserr   r   r   r   typecompiler   r   objectr   r   r   r   r   r   r   r   r   r   r   r   <module>   s\    
$+	

:
/",
	

