_common.pyc
1 o 2 #��c�q � 3 @ s2 d Z ddlmZ ddlmZ ddlZddlZddlZddlZddlZddl Z ddl 4 Z 5 ddl Z ddl Z ddl Z ddlmZ ddl mZ ddl mZ ddl mZ zdd l mZ W n eya dZY nw zdd 6 l mZ W n eyu dZY nw e jd kr�ddlZndZe jd d kZee�d d��Ze� Z g d�Z ej dkZ ej dkZ e j!�"d�Z#e j!�"d�Z$e$Z%e j!�"d�Z&e j!�"d�Z'e j!�"d�Z(e&p�e'p�e(Z)e j!�"d�Z*e j!�"d�Z+dZ,dZ-dZ.dZ/d Z0d Z1d Z2d Z3d Z4d!Z5d"Z6d#Z7d$Z8d%Z9d&Z:d'Z;d(Z<d)Z=d*Z>d+Z?d,Z@d-ZAd.ZBd/ZCd0ZDd1ZEedu �rd2ZFd3ZGdZHnG d4d5� d5ejI�ZJeK� �LeJjM� edu �r.d6ZNd7ZOnG d8d9� d9ejI�ZPeK� �LePjM� e �Q� ZRe�sHd:ZSnze �T� ZSW n eU�y_ e �r[d;nd:ZSY nw ed<g d=��ZVed>g d?��ZWed@g dA��ZXedBg dC��ZYedDg dE��ZZedFg dG��Z[edHg dI��Z\edJg dK��Z]edLg dM��Z^edNg dO��Z_edPg dQ��Z`edRg dS��ZaedTg dU��ZbedVdWdXg�ZcedYg dZ��Zded[d\d]g�Zeed^g d_��Zfed`g da��Zgedbg da��Zhedcg dd��Ziededfdgg�Zjedhdidjg�Zkedkg dl��Zledmdndog�Zmeeegeegfeegegfegegfeegegfegegfeegeegfegeegfegeegfdp�Znedu�rQen�Legegfegegfdq�� edu�rben�Ldregeegfi� G dsdt� dteo�ZpG dudv� dvep�ZqG dwdx� dxeq�ZrG dydz� dzep�ZsG d{d|� d|ep�Ztd�d}d~�Zudd�� Zvd�d�� Zwd�d�� Zxd�d�� Zyevd�d�� �Zzd�d�� Z{d�d�� Z|d�d�� Z}d�d�d��Z~d�d�� ZG d�d�� d��Z�d�d�� Z�e�� Z�e�j�e�_�e�j�e�_�d�Z�d�d�� Z�d�d�� Z�e e�fd�d��Z�e fd�d��Z�d�d�d��Z�d�d�� Z�e�r�d�d�� Z�nd�d�� Z�eve j�fd�d���Z�d�d�d��Z�dd�e j�fd�d��Z�d�d�� Z�dS )�z9Common objects shared by __init__.py and _ps*.py modules.� )�division)�print_functionN)� 7 namedtuple)�AF_INET)� 8 SOCK_DGRAM)� SOCK_STREAM)�AF_INET6)�AF_UNIX)� � r 9 � PSUTIL_DEBUG)R�FREEBSD�BSD�LINUX�NETBSD�OPENBSD�MACOS�OSX�POSIX�SUNOS�WINDOWS� 10 CONN_CLOSE�CONN_CLOSE_WAIT� CONN_CLOSING�CONN_ESTABLISHED�CONN_FIN_WAIT1�CONN_FIN_WAIT2� CONN_LAST_ACK� CONN_LISTEN� CONN_NONE� CONN_SYN_RECV� CONN_SYN_SENT�CONN_TIME_WAIT�NIC_DUPLEX_FULL�NIC_DUPLEX_HALF�NIC_DUPLEX_UNKNOWN� STATUS_DEAD�STATUS_DISK_SLEEP� STATUS_IDLE� STATUS_LOCKED�STATUS_RUNNING�STATUS_SLEEPING�STATUS_STOPPED�STATUS_SUSPENDED�STATUS_TRACING_STOP�STATUS_WAITING�STATUS_WAKE_KILL� STATUS_WAKING� STATUS_ZOMBIE� STATUS_PARKED�ENCODING� ENCODING_ERRSr �pconn� pcputimes�pctxsw�pgids�pio�pionice� popenfile�pthread�puids�sconn� scpustats�sdiskio� sdiskpart� 11 sdiskusage�snetio�snicaddr� snicstats�sswap�suser� conn_tmap�deprecated_method� isfile_strict�memoize�parse_environ_block�path_exists_strict� usage_percent� supports_ipv6�sockfam_to_enum�socktype_to_enum� wrap_numbers� open_text� open_binary�cat�bcat� bytes2human�conn_to_ntuple�debug�hilite�term_supports_colors� print_color�posix�nt�linux�darwin)�freebsdZ midnightbsd�openbsd�netbsd)�sunos�solaris�aix�runningZsleepingz 12 disk-sleep�stoppedz tracing-stop�zombieZdeadz wake-killZwaking�idle�locked�waiting� suspendedZparkedZ ESTABLISHEDZSYN_SENTZSYN_RECVZ FIN_WAIT1Z FIN_WAIT2Z TIME_WAIT�CLOSEZ 13 CLOSE_WAITZLAST_ACK�LISTENZCLOSING�NONE� � c @ s e Zd ZdZdZdZdS )� NicDuplexrr rs r N)�__name__� 14 __module__� __qualname__r# r$ r% � rx rx ��C:\Users\Jacks.GUTTSPC\AppData\Local\Packages\PythonSoftwareFoundation.Python.3.10_qbz5n2kfra8p0\LocalCache\local-packages\Python310\site-packages\psutil\_common.pyrt � s rt ����������c @ s e Zd ZdZdZdS )� BatteryTimerz r{ N)ru rv rw �POWER_TIME_UNKNOWN�POWER_TIME_UNLIMITEDrx rx rx ry r| � s r| �replace�surrogateescaperG )�total�used�free�percent�sin�soutrC )r� r� r� r� rA )� 15 read_count� write_count� 16 read_bytes� write_bytes� read_time� 17 write_timerB )�device� 18 mountpoint�fstype�opts�maxfile�maxpathrD )� 19 bytes_sent� 20 bytes_recv� packets_sent� packets_recv�errin�errout�dropin�dropoutrH )�name�terminal�host�started�pidr? )�fd�family�type�laddr�raddr�statusr� rE )r� �address�netmask� broadcast�ptprF )�isup�duplex�speed�mtu�flagsr@ )� ctx_switches� 21 interrupts�soft_interrupts�syscalls�scpufreq)�current�min�max�shwtemp)�labelr� �high�critical�sbattery)r� �secsleft� power_plugged�sfanr� r� r7 )�user�system� children_user�children_systemr< �pathr� r= )�id� user_timeZ system_timer> )�real� effective�savedr9 r: )r� r� r� r� r; �ioclass�valuer8 Z voluntaryZ involuntaryr6 )r� r� r� r� r� r� �addr�ip�port)�all�tcp�tcp4�udp�udp4�inet�inet4�inet6)�tcp6�udp6�unixc @ s, e Zd ZdZdZdd� Zdd� Zdd� Zd S ) 22 �ErrorzQBase exception class. All other psutil exceptions inherit 23 from this one. 24 �psutilc C sH t �� }|D ]}t| |d �}|r|||< q|dkr!|dkr!|||< q|S )Nr� r )� collections� OrderedDict�getattr)�self�attrs�infor� r� rx rx ry � _infodict s 25 �zError._infodictc C sP | � d�}|rdd�dd� |�� D �� }nd }d�dd� t| dd �|fD ��S ) 26 N)r� �ppidr� z(%s)�, c S � g | ] 27 \}}d ||f �qS �z%s=%rrx ��.0�k�vrx rx ry � 28 <listcomp>+ � z!Error.__str__.<locals>.<listcomp>� c S s g | ]}|r|�qS rx rx )r� �xrx rx ry r� . s �msg� )r� �join�itemsr� �r� r� �detailsrx rx ry �__str__& s 29 � z Error.__str__c C s2 | � d�}d�dd� |�� D ��}d| jj|f S )N)r� r� r� �secondsr� r� c S r� r� rx r� rx rx ry r� 3 r� z"Error.__repr__.<locals>.<listcomp>z psutil.%s(%s))r� r� r� � __class__ru r� rx rx ry �__repr__0 s 30 zError.__repr__N)ru rv rw �__doc__r� r� r� rx rx rx ry r� s 31 32 r� c @ � e Zd ZdZdZddd�ZdS )� NoSuchProcesszXException raised when a process with a certain PID doesn't 33 or no longer exists. 34 r� Nc C �$ t �| � || _|| _|pd| _d S )Nzprocess no longer exists�r� �__init__r� r� r� �r� r� r� r� rx rx ry r� = � 35 zNoSuchProcess.__init__�NN�ru rv rw r� r� rx rx rx ry r� 7 � r� c @ r� )� ZombieProcessa1 Exception raised when querying a zombie process. This is 36 raised on macOS, BSD and Solaris only, and not always: depending 37 on the query the OS may be able to succeed anyway. 38 On Linux all zombie processes are querable (hence this is never 39 raised). Windows doesn't have zombie processes. 40 r� Nc C s$ t �| |||� || _|pd| _d S )Nz"PID still exists but it's a zombie)r� r� r� r� )r� r� r� r� r� rx rx ry r� M s zZombieProcess.__init__�NNNr rx rx rx ry r D s r c @ r� )� AccessDeniedz@Exception raised when permission to perform an action is denied.r� Nc C r� )Nr� r� r� rx rx ry r� W r� zAccessDenied.__init__r r rx rx rx ry r S s r c @ r� )�TimeoutExpiredzWRaised on Process.wait(timeout) if timeout expires and process 41 is still alive. 42 r� Nc C s* t �| � || _|| _|| _d| | _d S )Nztimeout after %s seconds)r� r� r� r� r� r� )r� r� r� r� rx rx ry r� d s 43 44 zTimeoutExpired.__init__r r rx rx rx ry r ^ r r c C s@ z 45 t | �| d }W n 46 ty Y dS w |dur t||�}|S )z5Calculate percentage usage of 'used' against 'total'.�d g N)�float�ZeroDivisionError�round)r� r� �round_�retrx rx ry rO q s � 47 rO c s2 t ���� �fdd��}� fdd�}i � ||_|S )a A simple memoize decorator for functions supporting (hashable) 48 positional arguments. 49 It also provides a cache_clear() function for clearing the cache: 50 51 >>> @memoize 52 ... def foo() 53 ... return 1 54 ... 55 >>> foo() 56 1 57 >>> foo.cache_clear() 58 >>> 59 c sL | t t|�� ��f}z� | W S ty% �| i |�� }� |< | Y S w �N)� frozenset�sortedr� �KeyError)�args�kwargs�keyr ��cache�funrx ry �wrapper� s 60 �zmemoize.<locals>.wrapperc s � � � dS )z Clear cache.N)�clearrx )r rx ry � cache_clear� � z memoize.<locals>.cache_clear)� functools�wrapsr )r r r rx r ry rL } s rL c s6 t �� �� fdd��}dd� }dd� }||_||_|S )a� A memoize decorator which is disabled by default. It can be 61 activated and deactivated on request. 62 For efficiency reasons it can be used only against class methods 63 accepting no arguments. 64 65 >>> class Foo: 66 ... @memoize 67 ... def foo() 68 ... print(1) 69 ... 70 >>> f = Foo() 71 >>> # deactivated (default) 72 >>> foo() 73 1 74 >>> foo() 75 1 76 >>> 77 >>> # activated 78 >>> foo.cache_activate(self) 79 >>> foo() 80 1 81 >>> foo() 82 >>> foo() 83 >>> 84 c sj z| j � }W |S ty � | � Y S ty4 � | �}z || j � < W Y |S ty3 Y Y |S w w r )�_cache�AttributeErrorr )r� r �r rx ry r � s � ���z'memoize_when_activated.<locals>.wrapperc S s 85 i | _ dS )zjActivate cache. Expects a Process instance. Cache will be 86 stored as a "_cache" instance attribute.N)r ��procrx rx ry �cache_activate� s 87 z.memoize_when_activated.<locals>.cache_activatec S s z| ` W dS ty Y dS w )zDeactivate and clear cache.N)r r r rx rx ry �cache_deactivate� s 88 89 �z0memoize_when_activated.<locals>.cache_deactivate)r r r" r# )r r r" r# rx r ry �memoize_when_activated� s r$ c 90 C sV zt �| �}W n ty$ } z|jtjtjfv r� W Y d}~dS d}~ww t�|j�S )z�Same as os.path.isfile() but does not swallow EACCES / EPERM 91 exceptions, see: 92 http://mail.python.org/pipermail/python-dev/2012-June/120787.html 93 NF)�os�stat�OSError�errno�EPERM�EACCES�S_ISREG�st_mode)r� �st�errrx rx ry rK � s �� rK c 94 C sL zt �| � W dS ty% } z|jtjtjfv r� W Y d}~dS d}~ww )z�Same as os.path.exists() but does not swallow EACCES / EPERM 95 exceptions, see: 96 http://mail.python.org/pipermail/python-dev/2012-June/120787.html 97 NFT)r% r& r' r( r) r* )r� r. rx rx ry rN � s ���rN c C sv t jrtdu r dS z&t � tt j�} t�| �� | �d� W d � W dS 1 s(w Y W dS t jy: Y dS w )z2Return True if IPv6 is supported on this platform.NF)z::1r T)�socket�has_ipv6r r � 98 contextlib�closing�bind�error)�sockrx rx ry rP � s 99 ���rP c C sx i }d}t } | �d|�}||kr |S | �d||�}||kr7| ||� }| |d |� }|r3|�� }|||< |d }q)zCParse a C environ block of environment variables into a dictionary.r T� �=rs )r �find�upper)�datar �posZWINDOWS_�next_posZ equal_posr r� rx rx ry rM s" � �rM c C �0 t du r| S zt�| �W S ty | Y S w )z�Convert a numeric socket family value to an IntEnum member. 100 If it's not a known member, return the numeric value itself. 101 N)�enumr/ � AddressFamily� 102 ValueError��numrx rx ry rQ $ � �rQ c C r= )zConvert a numeric socket type value to an IntEnum member. 103 If it's not a known member, return the numeric value itself. 104 N)r> r/ � 105 SocketKindr@ rA rx rx ry rR 1 rC rR c C s� |t jtfv r|r t|� }|rt|� }|t jkr%|ttfv r%|�|t�}nt}t|�}t|�}|du r<t | |||||�S t 106 | ||||||�S )z2Convert a raw connection tuple to a proper ntuple.N) r/ r r r� r �getr rQ rR r6 r? )r� �fam�type_r� r� r� Z 107 status_mapr� rx rx ry rY > s rY c s � fdd�}|S )z�A decorator which can be used to mark a method as deprecated 108 'replcement' is the method name which will be called instead. 109 c s: d| j �f � | jd u r� | _t�| �� �fdd��}|S )Nz8%s() is deprecated and will be removed; use %s() insteadc s$ t j� tdd� t| ��|i |��S )Nrr )�category� 110 stacklevel)�warnings�warn�DeprecationWarningr� )r� r r )r� � replacementrx ry �inner[ s z/deprecated_method.<locals>.outer.<locals>.inner)ru r� r r )r rN �rM )r� ry �outerU s � 111 z deprecated_method.<locals>.outerrx )rM rP rx rO ry rJ Q s rJ c @ sB e Zd ZdZdd� Zdd� Zdd� Zdd � Zdd d �Zd d� Z d 112 S )� _WrapNumberszNWatches numbers so that they don't overflow and wrap 113 (reset to zero). 114 c C s t �� | _i | _i | _i | _d S r )� threading�Lock�lockr � reminders� reminder_keys�r� rx rx ry r� h s 115 116 z_WrapNumbers.__init__c C sX || j vsJ �|| jvsJ �|| jvsJ �|| j |< t�t�| j|< t�t�| j|< d S r )r rU rV r� � defaultdict�int�set)r� � 117 input_dictr� rx rx ry � _add_dictn s 118 z_WrapNumbers._add_dictc C s\ | j | }t|�� �t|�� � }|D ]}| j| | D ]}| j| |= q | j| |= qdS )z�In case the number of keys changed between calls (e.g. a 119 disk disappears) this removes the entry from self.reminders. 120 N)r rZ �keysrV rU )r� r[ r� �old_dictZ gone_keysZgone_key�remkeyrx rx ry �_remove_dead_remindersv s 121 �z#_WrapNumbers._remove_dead_remindersc C s || j vr | �||� |S | �||� | j | }i }|�� D ]\}|| }z|| }W n ty7 |||< Y q w g }tt|��D ]3} || } 122 || } || f} | 123 | k rg| j| | | 7 < | j| | � | � |� 124 | 125 | j| | � q@t |�||< q || j |< |S )zkCache dict and sum numbers which overflow and wrap. 126 Return an updated copy of `input_dict` 127 ) r r\ r` r] r �range�lenrU rV �add�append�tuple) r� r[ r� r^ �new_dictr Z input_tupleZ old_tuple�bits�iZ input_value� old_valuer_ rx rx ry �run� s4 128 129 � 130 z_WrapNumbers.runNc C s� | j �: |du r| j�� | j�� | j�� n | j�|d� | j�|d� | j�|d� W d � dS W d � dS 1 s@w Y dS )z>Clear the internal cache, optionally only for function 'name'.N)rT r r rU rV �pop)r� r� rx rx ry r � s 131 132 �"�z_WrapNumbers.cache_clearc C s: | j � | j| j| jfW d � S 1 sw Y dS )z5Return internal cache dicts as a tuple of 3 elements.N)rT r rU rV rW rx rx ry � 133 cache_info� s $�z_WrapNumbers.cache_infor ) 134 ru rv rw r� r� r\ r` rj r rl rx rx rx ry rQ c s 135 ' rQ c C s6 t j� t �| |�W d � S 1 sw Y dS )z�Given an `input_dict` and a function `name`, adjust the numbers 136 which "wrap" (restart from zero) across different calls by adding 137 "old value" to "new value" and return an updated dict. 138 N)�_wnrT rj )r[ r� rx rx ry rS � s 139 $�rS i � c C s t | dtd�S )N�rb�� buffering)�open�FILE_READ_BUFFER_SIZE)�fnamerx rx ry rU � � rU c C s\ t s t| dtd�S t| dtttd�}zt|_W |S ty" Y |S ty- |�� � w )z�On Python 3 opens a file in text mode by using fs encoding and 140 a proper en/decoding errors handler. 141 On Python 2 this is just an alias for open(name, 'rt'). 142 �rtro )rp �encoding�errors) �PY3rq rr r4 r5 � _CHUNK_SIZEr � Exception�close)rs �fobjrx rx ry rT � s � � ��rT c C s� |t u r || �� }|�� W d � S 1 sw Y dS z || �� }|�� W d � W S 1 s3w Y W dS ttfyG | Y S w )z�Read entire file content and return it as a string. File is 143 opened in text mode. If specified, `fallback` is the value 144 returned in case of error, either if the file does not exist or 145 it can't be read(). 146 N)�_DEFAULT�read�IOErrorr' )rs �fallback�_open�frx rx ry rV � s 147 $� 148 (��rV c C s t | |td�S )z,Same as above but opens file in binary mode.)r� r� )rV rU )rs r� rx rx ry rW s rW �%(value).1f%(symbol)sc C s� d}i }t |dd� �D ]\}}d|d d > ||< q t|dd� �D ]}| || kr:t| �|| }|t� S q#|t|d | d� S )z�Used by various scripts. See: 149 http://goo.gl/zeJZl 150 151 >>> bytes2human(10000) 152 '9.8K' 153 >>> bytes2human(100001221) 154 '95.4M' 155 ) �B�K�M�G�T�P�E�Z�Yrs N� 156 r )�symbolr� )� enumerate�reversedr �locals�dict)�n�format�symbols�prefixrh �sr� r� rx rx ry rX s �rX c C s t jd jS )z+Return updated psutil.PROCFS_PATH constant.r� )�sys�modules� PROCFS_PATHrx rx rx ry �get_procfs_path r r� c C s | j ttd�S )N)rv rw )�decoder4 r5 �r� rx rx ry r� % rt r� c C s | S r rx r� rx rx ry r� ( s c C sX t jdkrdS zdd l}| �� sJ �|�� |�d�dks J �W dS ty+ Y dS w )Nr_ Tr �colorsF)r% r� �curses�isatty� setupterm�tigetnumrz )�filer� rx rx ry r\ 1 s 157 ��r\ Fc C s� t � s| S g }tddddddddd d 158 � }d |d < z|| }W n ty/ td t|�� � ��w |�|� |r<|�d� dd�|�| f S )z*Return an highlighted version of 'string'.�32Z91�33Z93�34�35�36�37�30) �green�red�brown�yellow�blue�violet� lightblue�grey�darkgrey�29Nz#invalid color %r; choose between %s�1z [%sm%s[0m�;)r\ r� r r@ �listr] rd r� )r� �color�bold�attrr� rx rx ry r[ @ s$ � 159 �� 160 161 r[ c C s t � s t| |d� dS trtt| ||�|d� dS ddl}d}|jjj}|jjj}t ddddd�}||d< z|| }W n t 162 yN t d |t |� � �f ��w |rY|dkrY|d 163 7 }|tju r`d nd } |j|_|| �} 164 || 165 |� zt| |d� W || 166 |� dS || 167 |� w ) z$Print a colorized version of string.�r� r N� rr r � )r� r� r� r� z#invalid color %r; choose between %r� i����i����)r\ �printr r[ �ctypes�windll�Kernel32� GetStdHandle�SetConsoleTextAttributer� r r@ r� r] r� �stderr�c_ulong�restype) r� r� r� r� r� Z DEFAULT_COLORr� r� r� Z handle_id�handlerx rx ry r] S s6 168 � �� 169 r] c C sr t r7ddl}|�|�� j�\}}}}}t| t�r)t| ttt f�r%d| } nd| } t 170 d||| f t j d� dS dS )z@If PSUTIL_DEBUG env var is set, print a debug message to stderr.r Nz ignoring %sz ignoring %rzpsutil-debug [%s:%s]> %sr� ) r �inspect� getframeinfo� currentframe�f_back� 171 isinstancerz r' r �EnvironmentErrorr� r� r� )r� r� rs �lineno� func_name�lines�indexrx rx ry rZ v s � 172 173 174 ��rZ r )r� )NF)�r� � 175 __future__r r r� r1 r( r r% r/ r& r� rR rJ r r r r r � ImportErrorr � version_infor> rx �bool�getenvr �objectr} �__all__r� r r �platform� 176 startswithr r r r r r r r �AIXr* r+ r' r, r. r2 r& r0 r1 r( r) r/ r- r3 r r! r r r r" r r r r r r r# r$ r% �IntEnumrt �globals�update� __members__r} r~ r| �getfilesystemencodingr4 r5 �getfilesystemencodeerrorsr rG rC rA rB rD rH r? rE rF r@ r� r� r� r� r7 r< r= r> r9 r: r; r8 r6 r� rI rz r� r� r r r rO rL r$ rK rN rP rM rQ rR rY rJ rQ rS rm r rl rr rU rT rV rW rX r� r� �stdoutr\ r[ r] rZ rx rx rx ry �<module> sh � � 177 178 179 % 180 181 182 � ����� 183 184 � 185 186 187 � 188 � 189 ! 190 ? 191 192 W 193 194 195 196 � #