o
    OTh6                     @   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e$de%e$ de%e$ fddZ&dd Z'de'_(dd Z)dd Z*d:ddZ+d;d d!Z,	"	d<d#d$Z-G d%d& d&ej.Z/d'Z0d(d) Z1eZ2e3e4d"Z5d*Z6G d+d, d,e7Z8d-Z9G d.d/ d/e8Z:e	d0d1 Z;e	d2d3 Z<d4d5 Z=d=d6d7Z>d=d8d9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win32	startPathfilesreturnc                    s0   t |tsJ tj| d   fdd|D S )a  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 : 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']

    r   c                    s   g | ]	}t j |qS  )ospathjoin).0fbaser   X/home/air/segue/gemini/backup/venv/lib/python3.10/site-packages/IPython/testing/tools.py
<listcomp>C   s    zfull_path.<locals>.<listcomp>)
isinstancelistr   r   split)r   r   r   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_outputF   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_argvt   s   r0   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   rB   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   
rI   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 )r0   r   r   dirname__file__rI   r   environcopypopitemsr   strprintr   r   communicater   encodedecoder$   sub)fnameoptionscommands__tracebackhide__cmdargstest_dirrH   
full_fnamefull_cmdrP   kvpouterrr   r   r   ipexec   s*   



 rm   rS   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
    TrQ   z"Running file %r produced error: %rN)rm   r   strip
splitlines
ValueError)r`   expected_outexpected_errra   rb   rc   rk   rl   r   r   r   ipexec_validate   s   

rs   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   hasattrrv   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 )Nrv   )rw   rv   r   unlink)ry   r`   r   r   r   tearDown  s   

zTempFileMixin.tearDownc                 C   s   | S Nr   ry   r   r   r   	__enter__   s   zTempFileMixin.__enter__c                 C   s   |    d S r   )r~   )ry   exc_type	exc_value	tracebackr   r   r   __exit__#  s   zTempFileMixin.__exit__N)ru   )__name__
__module____qualname____doc__r|   r~   r   r   r   r   r   r   rt     s    
rt   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pairsrc   r<   inpexpectedrk   r   r   r   check_pairs.  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
    rM   Tc                 C   s0   || _ t| j ttfr| j g| _ || _|| _d S r   )sr   rZ   _re_typechannelsuppress)ry   r   r   r   r   r   r   __init__\  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   rE   r   orig_stream
MyStringIObufferr   teesetattrr   r   r   r   r   r   c  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   rE   r   r   r   getvaluer   r   r   r%   notprinted_msgr   patternry   etypevaluer   rc   printedr   r   r   r   r   i  s   



"zAssertPrints.__exit__N)rM   T)r   r   r   r   r   r   r   r   r   r   r   r   P  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   rE   r   r   r   r   r   r   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}   )r<   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.
    rS   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rS   )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rI   r	   
subcommandcmdrk   rl   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   r2   )Nr   )rS   Nr   r   )@r   r   pathlibr   r$   rE   r:   unittest
contextlibr   ior   
subprocessr   r   unittest.mockr   traitlets.config.loaderr   IPython.utils.processr	   IPython.utils.textr
   IPython.utils.ior   r   r   r   rS   r   decr   platformskip_doctest	null_decodoctest_decorZ   r    r"   r/   __test__r0   rB   rI   rm   rs   TestCasert   r   r   r   typecompiler   r   objectr   r   r   r   r   r   r   r   r   r   r   r   <module>   s\     +	

:
/",
	

