
    Xh2                     2   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(  rejB                  nejD                  Z#e#de$de%e$   de%e$   fd       Z&d Z'de'_(        d Z)d Z*d)dZ+d*dZ,	 	 d+dZ- G d dej\                        Z/eZ0 e1 ejd                  d            Z3dZ4 G d  d!      Z5d"Z6 G d# d$e5      Z7e	d%        Z8d& Z9d,d'Z:d,d(Z;y)-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                     t        |t              sJ t        j                  j	                  |       d   }|D cg c]"  }t        j                  j                  ||      $ c}S c c}w )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   )
isinstancelistospathsplitjoin)r   r   basefs       I/var/www/html/myenv/lib/python3.12/site-packages/IPython/testing/tools.py	full_pathr    &   sN    6 eT"""77==#A&D+02aRWW\\$q!222s   'A#c                    t        j                  d| t         j                        }|r t        |j	                  d            }d}||fS t        j                  d| t         j                        }|r d}t        |j	                  d            }||fS t        j                  d| t         j                        }|r8t        |j	                  d            }t        |j	                  d            }||fS y)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_ms         r   parse_test_outputr.   F   s    & II13EE5;;q>"eYY4c2<<HFFLLO$eYYBC||%F6<<?#FLLO$e     Fc                  
    g dS )zEReturn a valid default argv for creating testing instances of ipython)z--quickz--colors=nocolorz--no-term-titlez--no-bannerz--autocall=0 r1   r/   r   default_argvr2   t   s     r/   c                  8   t               } d| j                  _        d| j                  _        d| j                  _        t        j                  dd      }t        |j                        | 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   s     r   default_configrE      sx    XF-6F##*9AF++6/0F##,##+=eLA&*166lF#GGI*/F'Mr/   c                 R    t         j                  ddg}| rdj                  |      }|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_cmds     r   get_ipython_cmdrM      s+     >>43Khh{+r/   c                    d}|g }t               |z   }t        j                  j                  t              }t               }t        j                  j                  ||       }||z   d|gz   }t        j                  j                         }	d|	d<   |	j                  dd       |	j                         D ]"  \  }
}t        |t              rt        |
|       $ t        |t        t        t        |	      }|j!                  t#        j$                  dj                  |            xs d	      \  }}t#        j&                  |      t#        j&                  |      }}|rt)        j*                  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 )r2   r   r   dirname__file__rM   r   environcopypopitemsr   strprintr   r   communicater   encodedecoder#   sub)fnameoptionscommands__tracebackhide__cmdargstest_dirrL   
full_fnamefull_cmdrU   kvpouterrs                  r   ipexecrr      s>   . nw&Gwwx(H!#Kh.JW$j'99H
**//
C %C GGd#		 1 !S!!QK	
 	htD#FA}}9#3#3DIIh4G#H#PD}QHC$i&6&6s&;C ff_b#.8Or/   rX   c                    d}t        | ||      \  }}|rp|r]dj                  |j                         j                               dj                  |j                         j                               k(  sJ t	        d| d|      dj                  |j                         j                               dj                  |j                         j                               k(  sJ y)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
    TrV   zRunning file z produced error: N)rr   r   strip
splitlines
ValueError)re   expected_outexpected_errrf   rg   rh   rp   rq   s           r   ipexec_validatery      s    4 eWh/HC
 99SYY[3356$))""$//1;    #S* + + 99SYY[++-.$))'')3   r/   c                   *    e Zd ZdZddZd Zd Zd Zy)TempFileMixinzcUtility class to create temporary Python/IPython files.

    Meant as a mixin class for test cases.c                     t        ||      }t        | d      sg | _        | j                  j                  |       || _        y)zMake a valid python temp file.tmpsN)r   hasattrr}   appendre   )selfsrcextre   s       r   mktmpzTempFileMixin.mktmp  s8    C%tV$DI		
r/   c                 z    t        | d      r(| j                  D ]  }	 t        j                  |        y y #  Y !xY w)Nr}   )r~   r}   r   unlink)r   re   s     r   tearDownzTempFileMixin.tearDown  sC     4  IIe$	 ! s   6:c                     | S Nr1   r   s    r   	__enter__zTempFileMixin.__enter__$  s    r/   c                 $    | j                          y r   )r   )r   exc_type	exc_value	tracebacks       r   __exit__zTempFileMixin.__exit__'  s    r/   N)z.py)__name__
__module____qualname____doc__r   r   r   r   r1   r/   r   r{   r{   	  s    .r/   r{   zEDid not find {0!r} in printed output (on {1}):
-------
{2!s}
-------
c                   $    e Zd ZdZddZd Zd Zy)AssertPrintszContext manager for testing that code prints certain text.

    Examples
    --------
    >>> with AssertPrints("abc", suppress=False):
    ...     print("abcd")
    ...     print("def")
    ...
    abcd
    def
    c                     || _         t        | j                   t        t        f      r| j                   g| _         || _        || _        y r   )sr   r_   _re_typechannelsuppress)r   r   r   r   s       r   __init__zAssertPrints.__init__A  s6    dffsHo.ffXDF r/   c                 0   t        t        | j                        | _        t	               | _        t        | j
                  | j                        | _        t        t        | j                  | j                  r| j
                         y | j                         y )N)r   )
getattrrI   r   orig_stream
MyStringIObufferr   teesetattrr   r   s    r   r   zAssertPrints.__enter__H  sW    "35 lt{{DLL9T\\$--4;;NTXXNr/   c                    d}	 |	 | j                   j                          y| j                   j                          t        t        | j
                  | j                         | j                  j                         }| j                  D ]~  }t        |t              rB|j                  |      r%J t        j                  |j                  | j
                  |             ||v rZJ t        j                  || j
                  |              	 | j                   j                          y# | j                   j                          w xY wNTF)r   rB   flushr   rI   r   r   r   getvaluer   r   r   r$   notprinted_msgformatpatternr   etypevaluer   rh   printedr   s          r   r   zAssertPrints.__exit__N  s     	  HHNN HHNNCt'7'78kk**,GVV Ya*88G,en.C.CAIIt||]d.ee,<X)>)>q$,,PW)XX<	Y
 HHNNDHHNNs   D$ B	D$ ,4D$ !'D$ $E N)rR   T)r   r   r   r   r   r   r   r1   r/   r   r   r   5  s    
!Or/   r   z>Found {0!r} in printed output (on {1}):
-------
{2!s}
-------
c                       e Zd ZdZd Zy)AssertNotPrintszcContext manager for checking that certain output *isn't* produced.

    Counterpart of AssertPrintsc                    d}	 |6| j                   j                          	 | j                   j                          y| j                   j                          t        t        | j
                  | j                         | j                  j                         }| j                  D ]~  }t        |t              rB|j                  |      s%J t        j                  |j                  | j
                  |             ||vrZJ t        j                  || j
                  |              	 | j                   j                          y# | j                   j                          w xY wr   )r   rB   r   r   rI   r   r   r   r   r   r   r   r$   printed_msgr   r   r   s          r   r   zAssertNotPrints.__exit__k  s    	   HHNN HHNNCt'7'78kk**,GVV 2a* xx0 :1C1C		4<<2: :0 G+ 2[-?-?4<<.2 2+2 HHNNDHHNNs   D> B	D> 4D> ;'D> >EN)r   r   r   r   r   r1   r/   r   r   r   g  s    #r/   r   c              #      K   t        | dd      j                          	 d t        j                  |        y# t        j                  |        w xY ww)zGCreate an empty, named, temporary file for the duration of the context.wzutf-8)encodingN)openrB   r   r   )r?   s    r   make_tempfiler     s;      	sW%++-
		$		$s   A: AAAc                 >    t        |       df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.
    c                 V    	 t              S # t        $ r}t        d      |d }~ww xY w)NzNo more inputs given)nextStopIterationEOFError)prompteits     r   
mock_inputzfake_input.<locals>.mock_input  s/    	:8O 	:129	:s   
 	(#(zbuiltins.inputrX   )iterr   )inputsr   r   s     @r   
fake_inputr     s#     
fB: !:..r/   c                     t               | dgz   }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rM   r
   
subcommandcmdrp   rq   rcs        r   help_output_testr     sh    

z40
0C(-LCb7C7c!!!38Or/   c                     t               | dgz   }t        |      \  }}}|dk(  sJ |       d|vsJ d|v sJ d|v sJ ||fS )z1test that `ipython [subcommand] --help-all` worksr   r   r   r   Classr   r   s        r   help_all_output_testr     sf    

z<8
8C(-LCb7C7c!!!c>>8Or/   r5   )Nr1   )rX   Nr1   r   )<r   r   pathlibr   r#   rI   r=   unittest
contextlibr   ior   
subprocessr   r   unittest.mockr   traitlets.config.loaderr	   IPython.utils.processr
   IPython.utils.textr   IPython.utils.ior   r   IPython.utilsr   rX   r   decr   platformskip_doctest	null_decodoctest_decor_   r   r    r.   __test__r2   rE   rM   rr   ry   TestCaser{   r   typecompiler   r   r   r   r   r   r   r   r   r1   r/   r   <module>r      s6   
  	 
   %  "  * 7 + - #  
 ,/<<7+B{''3 3T#Y 349 3 3>'V #  

$7t 79+-,^H%% D 



3 * *Xl 4  /(r/   