o
    hz)                     @   s  d Z ddlZddlZddlZddlmZ ddl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 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 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 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 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  ddlm!Z! ddlm"Z" dd  Z#G d!d" d"eZ$ej%j&d#d$ej%j'ed%d&G d'd( d(e$Z(ej%j'ed)d&G d*d+ d+e(Z)G d,d- d-e$Z*dS ).aY  Notes about unicode handling in psutil
======================================.

Starting from version 5.3.0 psutil adds unicode support, see:
https://github.com/giampaolo/psutil/issues/1040
The notes below apply to *any* API returning a string such as
process exe(), cwd() or username():

* all strings are encoded by using the OS filesystem encoding
  (sys.getfilesystemencoding()) which varies depending on the platform
  (e.g. "UTF-8" on macOS, "mbcs" on Win)
* no API call is supposed to crash with UnicodeDecodeError
* instead, in case of badly encoded data returned by the OS, the
  following error handlers are used to replace the corrupted characters in
  the string:
    * sys.getfilesystemencodeerrors() or "surrogatescape" on POSIX and
      "replace" on Windows.

For a detailed explanation of how psutil handles unicode see #1040.

Tests
=====

List of APIs returning or dealing with a string:
('not tested' means they are not tested to deal with non-ASCII strings):

* Process.cmdline()
* Process.cwd()
* Process.environ()
* Process.exe()
* Process.memory_maps()
* Process.name()
* Process.net_connections('unix')
* Process.open_files()
* Process.username()             (not tested)

* disk_io_counters()             (not tested)
* disk_partitions()              (not tested)
* disk_usage(str)
* net_connections('unix')
* net_if_addrs()                 (not tested)
* net_if_stats()                 (not tested)
* net_io_counters()              (not tested)
* sensors_fans()                 (not tested)
* sensors_temperatures()         (not tested)
* users()                        (not tested)

* WindowsService.binpath()       (not tested)
* WindowsService.description()   (not tested)
* WindowsService.display_name()  (not tested)
* WindowsService.name()          (not tested)
* WindowsService.status()        (not tested)
* WindowsService.username()      (not tested)

In here we create a unicode path with a funky non-ASCII name and (where
possible) make psutil return it back (e.g. on name(), exe(), open_files(),
etc.) and make sure that:

* psutil never crashes with UnicodeDecodeError
* the returned path matches
    N)closing)BSDMACOS)NETBSD)OPENBSD)POSIX)WINDOWS)ASCII_FS)
CI_TESTING)HAS_ENVIRON)HAS_MEMORY_MAPS)HAS_NET_CONNECTIONS_UNIX)INVALID_UNICODE_SUFFIX)PYPYTESTFN_PREFIX)UNICODE_SUFFIX)PsutilTestCase)bind_unix_socket)chdir)copyload_shared_lib)create_py_exe)
get_testfn)pytest)
safe_mkdir)safe_rmpath)skip_on_access_denied)spawn_subproc)	terminatec              	   C   s   d}t | d}zGzt| t| t|gd}t||d  t|d  W n ttfy?   Y W |dur9t| t| dS w W |durIt| t| dS |durWt| t| w )z`Return True if both the fs and the subprocess module can
    deal with a unicode file name.
    Nsuffix)cmdz-2FT)	r   r   r   r   shutilcopyfileUnicodeEncodeErrorOSErrorr   )r!   sproctestfn r)   O/var/www/html/ai/venv/lib/python3.10/site-packages/psutil/tests/test_unicode.pytry_unicodeh   s*   

r+   c                       s0   e Zd ZdZe fddZ fddZ  ZS )BaseUnicodeTestNc                    sT   t    d| _d | _| jd ur(t| jsd| _d S t| jd| _t| j d S d S )NFTr    )super
setUpClass
skip_tests
funky_namefunky_suffixr+   r   r   )cls	__class__r)   r*   r.      s   



zBaseUnicodeTest.setUpClassc                    s   t    | jrtdd S )Nzcan't handle unicode str)r-   setUpr/   r   skipselfr3   r)   r*   r5      s   

zBaseUnicodeTest.setUp)__name__
__module____qualname__r1   classmethodr.   r5   __classcell__r)   r)   r3   r*   r,      s
    r,   serial)namezASCII fsreasonc                   @   s   e Zd ZdZeZdd Zdd Zdd Zdd	 Z	d
d Z
ejjeo"eddejjep+edddd Zejje dddd Zejje ddejje dde dd Zdd Zejje dddd ZdS )
TestFSAPIsz1Test FS APIs with a funky, valid, UTF8 path name.c                 C   sF   t   t d | jtdv W  d    S 1 sw   Y  d S )Nignore.)warningscatch_warningssimplefilterr0   oslistdirr7   r)   r)   r*   expect_exact_path_match   s   

$z"TestFSAPIs.expect_exact_path_matchc                 C   sf   | j ddg}| |}t|j}| }t|tsJ |  r/t	j
|t	j
| j ks1J d S d S Nz-cz2import time; [time.sleep(0.1) for x in range(100)])r0   r   psutilProcesspidexe
isinstancestrrJ   rH   pathnormcase)r8   r"   subpprO   r)   r)   r*   test_proc_exe   s   
zTestFSAPIs.test_proc_exec                 C   sZ   | j ddg}| |}t|j }t|tsJ |  r)|t	j
| j ks+J d S d S rK   )r0   r   rL   rM   rN   r?   rP   rQ   rJ   rH   rR   basename)r8   r"   rT   r?   r)   r)   r*   test_proc_name   s   
zTestFSAPIs.test_proc_namec                 C   s^   | j ddg}| |}t|j}| }|D ]	}t|ts J q|  r+||ks-J d S d S rK   )	r0   r   rL   rM   rN   cmdlinerP   rQ   rJ   )r8   r"   rT   rU   rY   partr)   r)   r*   test_proc_cmdline   s   
zTestFSAPIs.test_proc_cmdlinec                 C   s   | j d }| t| t| t| t }| }W d    n1 s&w   Y  t| t	s4J | 
 r>||ks@J d S d S N2)r0   
addCleanupr   r   r   rL   rM   cwdrP   rQ   rJ   )r8   dnamerU   r_   r)   r)   r*   test_proc_cwd   s   


zTestFSAPIs.test_proc_cwdzfails on PYPY + WINDOWSr@   zbroken on NETBSD or OPENBSDc                 C   s   t  }t| }t| jd t| }W d    n1 s!w   Y  ||  j}t|t	s4J t
r=|s=td|  rPtj|tj| jksRJ d S d S )Nrbzopen_files on BSD is broken)rL   rM   set
open_filesopenr0   poprR   rP   rQ   r   r   r6   rJ   rH   rS   )r8   rU   startnewrR   r)   r)   r*   test_proc_open_files   s   
zTestFSAPIs.test_proc_open_filesz
POSIX onlyc                 C   s   | j | jd}t|}t|- t dd }t|jt	s!J |js-t
r-tr-td|j|ks4J W d    d S 1 s?w   Y  d S )Nr    unixr   zunreliable on OSX)r   r1   r   r   rL   rM   net_connectionsrP   laddrrQ   r   r   r   r6   )r8   r?   sockconnr)   r)   r*   test_proc_net_connections   s   

"z$TestFSAPIs.test_proc_net_connectionszcan't list UNIX socketsc                 C   s~   dd }| j | jd}t|}t|" tjdd}||}t|jts&J |j|ks-J W d    d S 1 s8w   Y  d S )Nc                 S   s.   | D ]}t j|jtr|  S qtd)Nzconnection not found)rH   rR   rW   rl   
startswithr   
ValueError)consrn   r)   r)   r*   	find_sock   s
   z2TestFSAPIs.test_net_connections.<locals>.find_sockr    rj   )kind)	r   r1   r   r   rL   rk   rP   rl   rQ   )r8   rs   r?   rm   rr   rn   r)   r)   r*   test_net_connections   s   
"zTestFSAPIs.test_net_connectionsc                 C   s,   | j d }| t| t| t| d S r\   )r0   r^   r   r   rL   
disk_usage)r8   r`   r)   r)   r*   test_disk_usage  s   
zTestFSAPIs.test_disk_usagenot supportedc                    s   t | jd5}dd   fddt  D }dd |D } ||v s'J |D ]	}t|ts2J q)W d    d S 1 s>w   Y  d S )Nr    c                 S   s   t jt j| S N)rH   rR   realpathrS   )rU   r)   r)   r*   normpath  s   z-TestFSAPIs.test_memory_maps.<locals>.normpathc                    s   g | ]} |j qS r)   )rR   .0xr{   r)   r*   
<listcomp>  s    
z/TestFSAPIs.test_memory_maps.<locals>.<listcomp>c                 S   s   g | ]}t |v r|qS r)   r   r|   r)   r)   r*   r     s    )r   r1   rL   rM   memory_mapsrP   rQ   )r8   
funky_pathlibpathsrR   r)   r   r*   test_memory_maps  s   

"zTestFSAPIs.test_memory_mapsN)r9   r:   r;   __doc__r   r1   rJ   rV   rX   r[   ra   r   markskipifr   r	   r   r   ri   r   ro   r   r   ru   rw   r   r   r)   r)   r)   r*   rB      s0    

rB   zunreliable on CIc                   @   s   e Zd ZdZeZdd ZdS )TestFSAPIsWithInvalidPathz-Test FS APIs with a funky, invalid path name.c                 C   s   t  S ry   r   r7   r)   r)   r*   rJ   %  s   z1TestFSAPIsWithInvalidPath.expect_exact_path_matchN)r9   r:   r;   r   r   r1   rJ   r)   r)   r)   r*   r     s    r   c                   @   sB   e Zd ZdZeZejje	 ddejje
oedddd ZdS )TestNonFSAPISz&Unicode tests for non fs-related APIs.rx   r@   zsegfaults on PYPY + WINDOWSc                 C   sx   t j }| j|d< | j|d}t|j}| }| D ]\}}t	|t
s)J t	|t
s0J q|d | jks:J d S )N	FUNNY_ARG)env)rH   environcopyr1   r   rL   rM   rN   itemsrP   rQ   )r8   r   r'   rU   kvr)   r)   r*   test_proc_environ3  s   

zTestNonFSAPIS.test_proc_environN)r9   r:   r;   r   r   r1   r   r   r   r   r   r	   r   r)   r)   r)   r*   r   .  s    r   )+r   rH   r#   rE   
contextlibr   rL   r   r   r   r   r   r	   psutil.testsr
   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r   r+   r,   r   xdist_groupr   rB   r   r   r)   r)   r)   r*   <module>   sT   > 