Xi dZddlZddlZddlZddlZddlZddlZddlZddlZddl Z ddl Z ddl Z ddl Z ddl Z ddlZddlZddlZddlZddlZddlZddlZddlZddlZddlZddlZddlZddlZddlZddlZddlmZddlmZddlmZ ddl Z n #e!$rdZ YnwxYwddl"Z"ddl"m#Z#ddl"m$Z$ddl"m%Z%dd l"m&Z&dd l"m'Z'dd l"m(Z(dd l"m)Z)dd l"m*Z*ddl+m,Z,ddl+m-Z-ddl+m.Z.ddl+m/Z/ddl+m0Z0e(rddl1m2Z2gdZ3dej4vZ5de j6vpde j6vZ7e7Z8de j6vZ9de j6vZ:ej;dkZ<e j=>dvZ?e j=dkZ@e.dZAe%reAdkZBeAdkZCnd ZBd ZCd!ZDd"ZEd#ZFd$ZGe8reDd%zZDeGd%zZGeEd&zZEeFd%zZFd'e jHd(ZId)ZJd*Kd+d,ZLejM>d-vZNe j6Od.pKe jPQe jPRe jPSeTd/d/ZUe jPReUd0ZVe jPQe jPSeTZWeXe"jYd1ZZeXe"jYd2Z[eXe"d3Z\eXe"jYd4Z]eXe"jYd5Z^e(oe) Z_eXe"d6Z`eXe"jYd7ZaeXe"jYd8ZbeXe"jYd9ZceXe"d:ZdeXe"d;ZeeXe"d<ZfeXe"jYd=Zge%se#oe jhdkZi edoeje"jkZln9#em$r1ejnejoepejqd ZlYnwxYw eXe"d>oeje"jrZsn9#em$r1ejnejoepejqd ZsYnwxYwd?Ztet\ZuZvewe jxd@ZyejneyjzdAe{e"DZ|e}edBe~ZeZeZGdCdDZeej_me eZ eejdE<eGdFdGejZdHZeddIZedJZdKZedLZedMZejeGfdNZddOZdPZdQZGdRdSZee"jdeGdTUdVZeeefdeGdTUddXZeee jjmfdeGdTUdYZdZZd[Zejd\Zd]Zdd^Zdd`ZGdadbejZe je5dcde jdefGdgdheZdiZdjZGdkdlZGdmdnZeDfdoZddpZddqZddsZeedfdtZejfduZddwZdxZejdyZdzZd{Zd|Zd}Zd~ZdZdZe(rejddZnejddZejndZe(rejejddSdS)zTest utilities.N)AF_INET)AF_INET6) SOCK_STREAM)AIX)LINUX)MACOS)NETBSD)OPENBSD)POSIX)SUNOS)WINDOWS) bytes2human)debug)memoize) print_color) supports_ipv6)wait_pid)JDEVNULLGLOBAL_TIMEOUTTOLERANCE_SYS_MEM NO_RETRIESPYPY PYTHON_EXEPYTHON_EXE_ENVROOT_DIR SCRIPTS_DIR TESTFN_PREFIXUNICODE_SUFFIXINVALID_UNICODE_SUFFIX CI_TESTINGVALID_PROC_STATUSESTOLERANCE_DISK_USAGEIS_64BITHAS_CPU_AFFINITY HAS_CPU_FREQ HAS_ENVIRONHAS_PROC_IO_COUNTERS HAS_IONICEHAS_MEMORY_MAPSHAS_PROC_CPU_NUM HAS_RLIMITHAS_SENSORS_BATTERY HAS_BATTERYHAS_SENSORS_FANSHAS_SENSORS_TEMPERATURESHAS_NET_CONNECTIONS_UNIX MACOS_11PLUS MACOS_12PLUSCOVERAGEAARCH64PYTEST_PARALLELpyrun terminate reap_children spawn_subproc spawn_zombiespawn_children_pair ThreadTaskunittestskip_on_access_deniedskip_on_not_implementedretry_on_failureTestMemoryLeakPsutilTestCaseprocess_namespacesystem_namespaceis_win_secure_system_proc fake_pytestchdir safe_rmpath create_py_exe create_c_exe get_testfn get_winverkernel_version call_until wait_for_pid wait_for_filecheck_net_addressfilter_proc_net_connections get_free_port bind_socketbind_unix_sockettcp_socketpairunix_socketpaircreate_sockets reload_moduleimport_module_by_pathwarncopyload_shared_lib is_namedtuple__pypy__GITHUB_ACTIONS CIBUILDWHEEL COVERAGE_RUNPYTEST_XDIST_WORKERl>arm64aarch64riscv64ctjd}ttt|ddd}|dkrdt jtj dddgdd id }ttt|ddd}|S) Nr.) z-sS-cz-import platform; print(platform.mac_ver()[0])SYSTEM_VERSION_COMPAT0T)envuniversal_newlines) platformmac_vertuplemapintsplit subprocess check_outputsys executable) version_strversions m/var/www/development/aibuddy-work/election-extract/venv/lib/python3.11/site-packages/psutil/tests/__init__.py macos_versionr}zs"$$Q'KC[..s33BQB78899G(!-?   )#.#    C!2!23!7!7!;<<== N)ri) rFriiPiz@psutil--u-ƒőősfutf8surrogateescape>us-asciiasciiPSUTIL_ROOT_DIRz..scripts cpu_affinityenviron getloadavgionice memory_mapsnet_io_counterscpu_num io_countersrlimitsensors_battery sensors_fanssensors_temperaturesthreadscpu_freqc .d}tj}ttdd}t r%tjdkr|tj|d<||fStrtj|fStr|tjp|tj tjpd|tj djtjddp-|tj}|st%d||fStj tj}tj |s J|||fS)Nc tj|dgtjtj|S#tj$rYdSwxYw)Nz-V)stdoutstderr)rv check_callPIPECalledProcessError)exes r|attemptz_get_py_exe..attempts^   !d JOJO     J,   44 s-1AA_base_executable)r__PYVENV_LAUNCHER__z python{}.{}rhz"can't find python exe real abspath)osrcopygetattrrxr version_inforyr_rpathrealpathshutilwhichformatpsutilProcessr ValueErrorexists)rrnbasers r| _get_py_exers *//  C 3*D 1 1D3#v--$2B&)^ !"Sy ~s""  GCN # # /wrw''7788 /w 1]133CBQB3GHII / wv~''++--..  CABB BCxgs~..w~~c""''C'''Cxr~zr+cbg|],}|dtt|-S)STATUS_ startswithrr.0xs r| r sCq||I/F/F FAr~AF_UNIXceZdZdZedZedZed dZed dZed dZ ed d Z Gd d Z dS)rFzA class that mimics some basic pytest APIs. This is meant for when unit tests are run in production, where pytest may not be installed. Still, the user can test psutil installation via: $ python3 -m psutil.tests c4d}tj|dS)Nc>tjdtddS)Nz._warn_on_exit!s. MN      r~)atexitregister)rs r|rzfake_pytest._warn_on_exits)     &&&&&r~ctjt}tjd||S)zMimics pytest.main(). It has the same effect as running `python3 -m unittest -v` from the project root directory. rh) verbosity)r= TestLoaderdiscoverHERETextTestRunnerrun)argskwsuites r|mainzfake_pytest.main*sG #%%..t44!,,,00777 r~NchGddtjdfd }|||S)zMimics `pytest.raises`.c(eZdZdZedZdS))fake_pytest.raises..ExceptionInfoNc|jSN)_excselfs r|valuez/fake_pytest.raises..ExceptionInfo.value:s y r~)__name__ __module__ __qualname__rpropertyrrr~r| ExceptionInfor7s2D  ! !X ! ! !r~rNc3K} |Vt|d#|$rN}|r:tj|t|sd|d|d}t|||_Yd}~dSd}~wwxYw)Nz not raised"z" does not match ")AssertionErrorresearchstrr)excmatcheinfoerrmsgrs r|contextz#fake_pytest.raises..context>s!MOOE < %%:%:%:;;;  ! ! !.5#c((!;!;.=e==s===C(---   !s%A8AA33A8)rr) contextlibcontextmanager)rrrrs @r|raiseszfake_pytest.raises3sp ! ! ! ! ! ! ! !  " < < < < < # " <ws%((((r~c|r'tj||Stj|S)zMimics `pytest.warns`.)r=TestCaseassertWarnsRegex assertWarns)warningrs r|warnszfake_pytest.warnsMsI  H$&&77GG G ""..w777r~c*tj|)zMimics `unittest.SkipTest`.)r=SkipTestreasons r|skipzfake_pytest.skipTs'''r~cNtj|S)zMimics `pytest.fail`.)r=rfailrs r|rzfake_pytest.failYs! ""''///r~c@eZdZeddZGddZdS)fake_pytest.markrc,tj||S)z'Mimics `@pytest.mark.skipif` decorator.)r=skipIf) conditionrs r|skipifzfake_pytest.mark.skipif`s?9f55 5r~c eZdZdZddZdZdS)fake_pytest.mark.xdist_groupz4Mimics `@pytest.mark.xdist_group` decorator (no-op).NcdSrrrnames r|__init__z%fake_pytest.mark.xdist_group.__init__hsr~c|Srr)r cls_or_meths r|__call__z%fake_pytest.mark.xdist_group.__call__ks""r~r)rrr__doc__r rrr~r| xdist_groupres= F F     # # # # #r~rNr)rrr staticmethodrrrr~r|markr^sZ  6 6 6  6 # # # # # # # # # #r~rrr) rrrrrrrrrrrrrr~r|rFrFs''\'\)))\)2888\8 (((\(000\0##########r~rFpytestcFeZdZdZfdZdZdZdZdZdZ dZ xZ S) r<z6A thread task which does nothing expect staying alive.ctd|_d|_t j|_dS)NFMbP?)superr _running _interval threadingEvent_flag)r __class__s r|r zThreadTask.__init__s:  _&& r~cX|jj}d|d|jdt|ddS)N)rrridr s r|__repr__zThreadTask.__repr__s8~&C4CC$-CCRXXCCCCCr~c.||Sr)startrs r| __enter__zThreadTask.__enter__s  r~c.|dSr)stop)rrkwargss r|__exit__zThreadTask.__exit__s r~c|jrtdtj||jdS)zStart thread and keep it running until an explicit stop() request. Polls for shutdown every 'timeout' seconds. zalready startedN)rrrThreadr%rwaitrs r|r%zThreadTask.startsL = 0.// /t$$$ r~cd|_|j|jr"tj|j|j dSdS)NT)rrsettimesleeprrs r|rzThreadTask.runsW  m ' Jt~ & & &m ' ' ' ' 'r~ch|jstdd|_|dS)z8Stop thread execution and and waits until it is stopped.zalready stoppedFN)rrjoinrs r|r(zThreadTask.stops3} 0.// /  r~) rrrrr r#r&r*r%rr( __classcell__)rs@r|r<r<s@@''''' DDD''' r~r<cFtjfd}|S)NcP |i|S#t$rtwxYwr) Exceptionr8)rr)funs r|wrapperz&_reap_children_on_err..wrappersD 3''' '    OOO  s % functoolswraps)r8r9s` r|_reap_children_on_errr=s8_S Nr~c |dt|dt|dtj|dtt rd}|d||t tj} t|d |d }td |g}tj |fi|}t |t|d d t|nT#t|wxYwtj |fi|}t |t|j|S)aCreate a python subprocess which does nothing for some secs and return it as a subprocess.Popen instance. If "cmd" is specified that is used instead of python. By default stdin and stdout are redirected to /dev/null. It also attempts to make sure the process is in a reasonably initialized state. The process is registered for cleanup on reap_children(). stdinrcwdrn creationflagsNdirzimport time;open(r'z6', 'w').close();[time.sleep(0.1) for x in range(100)];rkTdeleteempty) setdefaultrrgetcwdrr rKrHrrvPopen_subprocesses_startedaddrPrOpid)cmdkwdsCREATE_NO_WINDOWtestfnpylinesprocs r|r9r9s~ OOGW%%%OOHg&&&OOE29;;'''OOE>***;% )9::: { ,,,    9 999  tV,C$S11D11E ! % %e , , , &T : : : :     K     ----!!%(((UY Ls B (child) -> C (grandchild). Return a (child, grandchild) tuple. The 2 processes are fully initialized and will live for 60 secs and are registered for cleanup on reap_children(). NrCzl import subprocess, os, sys, time s = "import os, time;" s += "f = open('z', 'w');" s += "f.write(str(os.getpid()));" s += "f.close();" s += "[time.sleep(0.1) for x in range(100 * 6)];" p = subprocess.Popen([r'z.', '-c', s]) p.wait() r)rBTFrE)rKrrItextwrapdedentrbasenamerr r6rrrMrtrP _pids_startedrLrH)tfilerQssubpchildgrandchild_pid grandchilds r|r;r;sP E BIKK ( ( (F O  W--f55  &0       #333KD%%((KD%tx((]6$eLLLMM.)))^N33 z"F         F        s CD#D>cztjsJt}tjd|d}d}t |} |tt|\}}| \}} tj | gggtt| d}t|tj|t#fd|f||t'||t'|SS#|wxYw#|t'||t'|wwxYw)zCreate a zombie process and return a (parent, zombie) process tuple. In order to kill the zombie parent must be terminate()d first, then zombie must be wait()ed on. a  import os, sys, time, socket, contextlib child_pid = os.fork() if child_pid > 0: time.sleep(3000) else: # this is the zombie process with socket.socket(socket.AF_UNIX) as s: s.connect('za') pid = bytes(str(os.getpid()), 'ascii') s.sendall(pid) NcHtjkSr)statusr STATUS_ZOMBIE)zombiesr|zspawn_zombie..*sv}}&2FFr~)rr rKrUrVrU settimeoutrr6acceptselectfilenortrecvrXrLrrNcloserH) unix_filesrcrYsockparentconn_zpidrds @r|r:r: s < I /  &    C E I & &D '''c ++--a  M4;;==/2r> B B Btyy''D   d # # #^D))F FFFF G G GF# JJLLL I         JJLLLL I        s&AF BE* F*FF7F:c |dd|ddt} t|d5}||dddn #1swxYwYt t |jgfi|}t|j||fS#t$rt|wxYw)zRun python 'src' code string in a separate interpreter. Returns a subprocess.Popen instance and the test file where the source code was written. rNrw) rHrKopenwriter9rr rOrMr7rH)rmrOsrcfilefr[s r|r6r65s   OOHd###OOHd###llG '3   1 GGCLLL               j!&1::T::TXg G s/B* A." B*.A22B*5A263B**Cc ttrdnd}|dtj|dtj|dd|d|t |t rt j|}tj|fi|}t || t\}}|j dkrt||z|rt||d r |d d }|S) zURun cmd in a subprocess and return its output. raises RuntimeError on error. rArrrroTrBtimeout N)r rHrvr isinstancershlexrurJrKrL communicater returncode RuntimeErrorr[endswith)rNrOflagsprrs r|shrIs# ! 'IIaEOOHjo...OOHjo...OO($///OOOU+++#sk#%%%%Aa   ]]>]::NFF|q6F?+++  V  t Mr~c d d fd} fd fd}d}|} t|try|||t|tjtjfr ||t|tr|n|j}t j|r J|St|tjtjfry ||t|tjtjfr ||t|tr|n|j}t j|r J|St|tjry|||t|tjtjfr ||t|tr|n|j}t j|r J|Std|#t|tjtjfr ||t|tr|n|j}t j|r J|wxYw)aTerminate a process and wait() for it. Process can be a PID or an instance of psutil.Process(), subprocess.Popen() or psutil.Popen(). If it's a subprocess.Popen() or psutil.Popen() instance also closes its stdin / stdout / stderr fds. PID is wait()ed even if the process is already gone (kills zombies). Does nothing if the process does not exist. Return process exit status. c||tr]t|tjrE t j|j|S#t j$rYdSwxYwdSdSr) r-r r~rvrJrrrM NoSuchProcess)procr{s r|r-zterminate..waitms '  z$ (899  ~dh//44W==='         s+A$$A76A7ctrtr tj}tr/|tjkr|tj||dSr)rr_signalSIGKILLr send_signalSIGCONT)rsigs r|sendsigzterminate..sendsigvs^  !^ !.C  -SFN**   V^ , , , r~c |n1#t$rYn%t$r}tr |jdkr d}~wwxYw||S)N)ProcessLookupErrorOSErrorr winerror)rr{rrrr-s r|term_subprocess_procz'terminate..term_subprocess_procs  GD#    !    D    3<1,,  tD'"""s  > >9>cb |n#tj$rYnwxYw||Sr)rr)rr{rrr-s r|term_psutil_procz#terminate..term_psutil_procsR  GD#    #    D tD'"""s ""c tj|}||S#tj$rtrt ||cYSYdSwxYwr)rrrr r)rMr{rrs r|term_pidzterminate..term_pidsy 3>#&&D $#D'22 2 # . . . .W----- . . . .s#&AAc|jr|j|jr|j|jr|jdSdSr)rrkrr?rs r| flush_popenzterminate..flush_popensl ; K      ; K      :  J         r~z wrong type ) r~rtrvrJrrM pid_existsr TypeError) proc_or_pidr wait_timeoutrrrrrMrrr-s ` @@@r|r7r7bs # # # # # # ########33333 A / a   18A|,, a**FL9 : :  KNNNa%%0aa15$S))..3....FNFL9 : : 1##A|44 a**FL9 : :  KNNNa%%0aa15$S))..3....:+ , , 1''<88 a**FL9 : :  KNNNa%%0aa15$S))..3.... /!//00 0 a**FL9 : :  KNNNa%%0aa15$S))..3.......s G621G6%G6$G66A/I%ctj|}tr/t}t |t/t r/t }t |t /|rg|D]}t |dtj|t\}}|D]2}td|dt |tj 1dSdS)aTerminate and wait() any subprocess started by this test suite and any children currently running, ensuring that no processes stick around to hog resources. If recursive is True it also tries to terminate and wait() all grandchildren started by this process.  recursiveN)rrzzcouldn't terminate process z; attempting kill())r) rrchildrenrKpopr7rX wait_procsrr[rr)rrr[rMrrqalives r|r8r8s~((9(==H $((**$  !!#  - , ,A ad + + + + +$X~FFF5 - -A GqGGG H H H aV^ , , , , , -- - -r~ctstdd}tjd}|D]"}|s|dkr||z }"|st d|d}d}|d}t|d}t|dkrt|d}t|dkrt|d}|||fS) z"Return a tuple such as (2, 6, 36).z not POSIXrrhrgz can't parse rrr) r NotImplementedErrorrunameisdigitrrurtlen)rZrcminormicronumsmajors r|rMrMs /!+... A HJJqME  99;; !s(( FAA  3111222 E E 773<.wrapper$sC  3//////~C{. C(((JJLLLHHHH Is A2AA)r;r< decorator)rr8r9s`` r|rzretry.__call__#sF            !r~) rrrrr7r rr1rrr~r|rrsl    &&&r~rr)rrr{rc|tjvrtj|tj|dS)zWait for pid to show up in the process list then return. Used in the test suite to give time the sub process to initialize. N)rpidsrrrMs r|rOrO9s< &+--"3''' N3r~Tct|d5}|}dddn #1swxYwY|s|sJ|rt||S)z8Wait for a file to be written on disk with some content.rbN)rureadrH)fnamerFrGrxdatas r|rPrPHs eT  avvxx   E Ks 266c"|}|sJ|S)z1Keep calling function until it evaluates to True.r)r8rets r|rNrNYs #%%C JJJ Jr~cDd} tj|}tj|jr t jt j|}nt jtj|}tr |dS||dS#t$rYdSwxYw)z?Convenience function for removing temporary test files or dirs.cBtjtz}tj|krl |S#t$rYn*t$r}|}t d|Yd}~nd}~wwxYwtjdtj|kl|)Nz ignoring g{Gz?)r0rFileNotFoundErrorrr[r1)r8rrqrs r| retry_funzsafe_rmpath..retry_funns )++.ikkG## (suu $    ( ( (&&&'''''''' ( Jt   ikkG## s > A1 A1A,,A1N) rstatS_ISDIRst_moder;partialrrmtreeremover r)rrstr8s r|rHrHks"  WT]] < # # 5#FM488CC#BIt44C   CEEEEE IcNNNNN      sA=B B BBcR tj|dS#t$rYdSwxYw)z.Convenience function for creating a directory.N)rmkdirFileExistsErrorrCs r| safe_mkdirrs:        s  &&c#Ktj} tj|dVtj|dS#tj|wxYw)z@Context manager which temporarily changes the current directory.N)rrIrG)dirnamecurdirs r|rGrGs]Y[[F   s AAcDtj|r J|tjt |t jt|tr;tj |}tj ||j tj z|S)z6Create a Python executable file in the given location.)rrrrrrHrcopyfilerr rchmodrS_IEXEC)rrs r|rIrIs}w~~d##))T))) OK&&& OJ%%% 2 WT]] rzDL0111 Kr~cvtj|r J|tjdst jdS|tjd}nt|ts J|tj t|ttdd5}||dddn #1swxYwY t#jd|jd|gt|jn#t|jwxYw|S) z5Create a compiled C executable in the given location.gcczgcc is not installedNz #include int main() { pause(); return 1; } z.csuffixrtz-o)rrrrrrrrUrVr~rrrrHrurKrvrvrr )rc_coderxs r|rJrJsaw~~d##))T))) <  3{1222 ~"&#&&..... OK&&& j%%%s + +q uafdD9:::AF AF KsC""C&)C&.D D6rc tjt||}tj|s;tj|}tjt||Sw)zReturn an absolute pathname of a file or dir that did not exist at the time this call is made. Also schedule it for safe deletion at interpreter exit. It's technically racy but probably not really due to the time variant. T)prefixrrD) tempfilemktemprrrrrrrrH)rrDr rs r|rKrKsd mFLLLw~~d## 7##D))D OK . . .K r~cVeZdZdZdZddZdZdZdZd Z d Z d Z d Z d Z dZdS)rBzTest class providing auto-cleanup wrappers on top of process test utilities. All test classes should derive from this one, even if we use pytest. c|jj}|dsd|z}d||jj|jS)Nzpsutil.z psutil.tests.z{}.{}.{})rrrrr_testMethodName)rfqmods r|__str__zPsutilTestCase.__str__sU) ** ,#e+E   N #     r~rNc^t||}|t||S)N)rrD)rK addCleanuprH)rrrDrs r|rKzPsutilTestCase.get_testfns-&c222  U+++ r~cTt|i|}|t||Sr)r9rr7)rrrOrSs r|r9zPsutilTestCase.spawn_subprocs-t,t,,  5))) r~c|j|i|} tj|jS#tj$r||jwxYwr)r9rrrMrassert_pid_gone)rrr)rSs r| spawn_psproczPsutilTestCase.spawn_psprocsg""D3F33 >%),, ,#      + + +  s (+Act\}}|t||t|||fSr)r;rr7)rchild1child2s r|r;z"PsutilTestCase.spawn_children_pairsD,..  6***  6***r~ct\}}|t||t|||fSr)r:rr7)rrords r|r:zPsutilTestCase.spawn_zombiesB%  6***  6***r~ct|i|\}}|t||t||Sr)r6rrHr7)rrrOrSrws r|r6zPsutilTestCase.pyrun sE---w  W---  5))) r~cbt|tjsJ|j|jksJ|j|jksJ|jr |jsJt|tjr&|j|jksJ|j |jdksJt|t|dSNr) r~rErrorrMr _name ZombieProcessppid_ppidrrepr)rrrs r|_check_proc_exczPsutilTestCase._check_proc_excs#v|,,,,,w$(""""x4:%%%% 8 8OOO c6/ 0 0 %8tz))))x#x1}}}} C S r~c tj|}td|d#tj$rtdtj$r }|j|ksJ|jJYd}~nd}~wwxYwtj|r J||tjvsJ|dtj DvsJdS)Nzdid not raise NoSuchProcess ()z&wasn't supposed to raise ZombieProcesscg|] }|j Srrrs r|rz2PsutilTestCase.assert_pid_gone..)s@@@Q15@@@r~) rrrrrrMr rr process_iter)rrMrrs r|rzPsutilTestCase.assert_pid_gones J>#&&D!!H!H!H!HII I # K K K !IJJ J# $ $ $7c>>>>8######## $ $S))..3...&+--''''@@&*=*?*?@@@@@@@@@s),A5A00A5c||jt|}||jdD]\}}|t ||5 |}d|d|}t|#tj $rtj $r }| ||Yd}~nd}~wwxYw dddn #1swxYwY| ddS)NT clear_cacherr zProcess.z!() didn't raise NSP and returned rrz) rrMrCiterallsubTestrrrrrr r-)rrnsr8r rrrs r|assert_proc_gonezPsutilTestCase.assert_proc_gone+s TX&&& t $ $T:: . .IC3t99488 . . .#%%C$4$$$$)---++444((s3333333343 . . . . . . . . . . . . . . . ! s</C 1 B;C C0C C  CC  C$ 'C$ cd}tj|j}||ksJts0ts)t s"t |t |ksJ|tjksJ| sJtj |jsJ| ||t|}| |jdD]\}}|t!||5 |n>#tjtjf$r }|||Yd}~nd}~wwxYwdddn #1swxYwYt(r/t+jtj5}|dddn #1swxYwY|||jt+jtj5}|dddn #1swxYwY|||jt+jtj5}|dddn #1swxYwY|||j||||| sJtj |jsJ||dS)NctrdS|jtjvsJ|jdtjDvsJit_|jdtjDvsJdS)Ncg|] }|j Srrrs r|rzMPsutilTestCase.assert_proc_zombie..assert_in_pids..DEEE!EEEr~cg|] }|j Srrrs r|rzMPsutilTestCase.assert_proc_zombie..assert_in_pids..Frr~)rrMrrr _pmaprs r|assert_in_pidsz9PsutilTestCase.assert_proc_zombie..assert_in_pids?s 8v{}},,,,8EEv/B/D/DEEEEEEEFL8EEv/B/D/DEEEEEEEEEr~Trr)rrrMr r r hashrbrc is_runningras_dictrCrrrrr AccessDeniedr rrrcmdlinerrrsuspendresumer7kill) rrrclonerr8r rcms r|assert_proc_zombiez!PsutilTestCase.assert_proc_zombie>s F F Ftx(( u}}}} -6 -U -::e,,,,{{}} 44444      ***** t t $ $T:: 4 4IC3t99488 4 44CEEEE,f.AB444((s333333334 4 4 4 4 4 4 4 4 4 4 4 4 4 4 4  1v344                   rx 0 0 0v344                   rx 0 0 0v344 #  """ # # # # # # # # # # # # # # #  rx 0 0 0          *****tsr$E;& D10E;1E, E'"E;'E,,E;;E? E? -GGGH33H7:H77JJJrN)rrrrrrKr9rr;r:r6r rrr(rr~r|rBrBs               A A A&66666r~rBzunreliable on PYPYrserial)r ceZdZdZdZdZdZerdndZdZ e j Z e ejdZedZed Zd Zd Zd Zd ZdZdZdZ ddZdZdS)rAaTest framework class for detecting function memory leaks, typically functions implemented in C which forgot to free() memory from the heap. It does so by checking whether the process memory usage increased before and after calling the function many times. Note that this is hard (probably impossible) to do reliably, due to how the OS handles memory, the GC and so on (memory can even decrease!). In order to avoid false positives, in case of failure (mem > 0) we retry the test for up to 5 times, increasing call repetitions each time. If the memory keeps increasing then it's a failure. If available (Linux, OSX, Windows), USS memory is used for comparison, since it's supposed to be more precise, see: https://gmpy.dev/blog/2016/real-process-memory-and-environ-in-python If not, RSS memory is used. mallinfo() on Linux and _heapwalk() on Windows may give even more precision, but at the moment are not implemented. PyPy appears to be completely unstable for this framework, probably because of its JIT, so tests on PYPY are skipped. Usage: class TestLeaks(psutil.tests.TestMemoryLeak): def test_fun(self): self.execute(some_function) rirrT PSUTIL_DEBUGc.tjddS)NF)r _set_debugclss r| setUpClasszTestMemoryLeak.setUpClasss%     r~c8tj|jdSr)rr/_psutil_debug_origr0s r| tearDownClasszTestMemoryLeak.tearDownClasss#011111r~c`|j}t|d|jS)Nuss) _thisprocmemory_full_inforrss)rmems r|_get_memzTestMemoryLeak._get_mems+n--//sE37+++r~cttr|jS|jSr)r r8num_fds num_handlesrs r| _get_num_fdszTestMemoryLeak._get_num_fdss2  0>))++ +>--// /r~cP|jrt|dtjdSdS)Nyellow)colorfile)verboserrxr)rrs r|_logzTestMemoryLeak._logs3 < > 8#* = = = = = = > >r~c>|}|||}||z }|dkrd|d}tj|S|dkr4trdnd}|dkr|dz }|d|d |}tj|Sd S) zMakes sure num_fds() (POSIX) or num_handles() (Windows) does not increase after calling a function. Used to discover forgotten close(2) and CloseHandle syscalls. rznegative diff z8 (gc probably collected a resource from a previous test)fdhandlerrZz unclosed z after calling N)r@callrrr )rr8beforeafterdiffrtype_s r| _check_fdszTestMemoryLeak._check_fdss ""$$ #!!##v~ !882222 ;s## # !88!/DDxEaxx BBUBB3BBC;s## # 8r~c*tjd|}t|D]}||}~~tjd|}tjgksJ||z }|S)zGet 2 distinct memory samples, before and after having called fun repeatedly, and return the memory difference. r) generation)gccollectr<rrJgarbage)rr8timesmem1rrmem2rMs r| _call_ntimeszTestMemoryLeak._call_ntimess a    }}u  A))C..C33 a    }}zRd{ r~c g}d}|}td|dzD]}|||} d|t| t| |z |} || | |kp| |k} | r|dkr|| dS|dkrt || ||z }| }tjd |S)Nrrz,Run #{}: extra-mem={}, per-call={}, calls={}z. ) rrXrrappendrFprintrrr3) rr8rUr tolerancemessagesprev_memincreaseidxr;rsuccesss r| _check_memzTestMemoryLeak._check_memsGaK((  C##C//C@GGC  C%K(( C OOC Y&9#/G 77IIcNNNtt!88GGG #!{499X..///r~c|Srr)rr8s r|rJzTestMemoryLeak.calls suu r~Nc||n|j}||n|j}||n|j}||n|j} |dks Jd|dks Jd|dks Jd|dks Jdn.#t$r!}t t |d}~wwxYw|||||| ||||dS) zTest a callable.Nrztimes must be >= 1rzwarmup_times must be >= 0zretries must be >= 0ztolerance must be >= 0)rUrr\) rU warmup_timesrr\rrrrXrOrb)rr8rUrerr\rs r|executezTestMemoryLeak.execute s$* (4LL$:K %0''dl!*!6IIDN  'A:::3:::1$$$&A$$$a<<>>#;>>>> ' ' 'SXX&& & ' #|,,,  5'YOOOOOsAA// B9BBc 2fd}|j|fi|dS)znConvenience method to test a callable while making sure it raises an exception on every call. cd tjdS#$rYdSwxYw)Nz did not raise )rr)rr8sr|rJz*TestMemoryLeak.execute_w_exc..call&sX A{c#?#?##?#?@@@    s &//N)rf)rrr8r)rJs `` r| execute_w_exczTestMemoryLeak.execute_w_exc!sJ  A A A A A A  T$$V$$$$$r~)NNNN)rrrrrUrer\r rrErrr8boolrgetenvr4 classmethodr2r5r<r@rFrOrXrbrJrfrirr~r|rArAs8> ELI%bbAGG  Iibi7788!![!22[2,,, 000 >>>$$$,   0008KOPPPP, % % % % %r~rAcntd} ||dkS#t$rYdSwxYw)Nci}td}|ddD]C}d|dD}|dt|d}}|||<D|S)Nztasklist.exe /NH /FO csvrc:g|]}|ddS)rr)replacers r|rz@is_win_secure_system_proc..get_procs..8s&@@@1AIIc2&&@@@r~,r)r splitlinesrurt)routlinebitsr rMs r| get_procsz,is_win_secure_system_proc..get_procs3s{+,,NN$$QRR(  D@@ 3@@@DQT!W#DCHH r~z Secure SystemF)rKeyError)rMrvs r|rErE1sX  Wy{{3?22 uus & 44ctj}t|dr|St|dr&t j|SdS)Nrrr)rrhasattrrrandomchoicer)rs r|_get_eligible_cpur|Cs`Aq)/yy{{ N # #/}Q^^--... 1r~ceZdZdZddifddifgZddifddddifd difd difd difd difd difddifddifg Zddifddifddifddifddifddifddifddifddddifddifddifddifddifd difd!difd"difd#difgZer$ed$difgz Zed%difgz Zed&difgz Zed'difgz Zer ed(difgz Ze r ed)difgz Ze red*e j fifgz Ze r ed+difgz Zer ed,difgz Zer ed-difgz Zer ed.difgz Zer ed/dd0d1ifgz ZgZer eddifgz Znede jfifgz Ze red*e j d2fifgz Ze r"ered)e jd3fifgz Zned)e jfifgz Ze red+egfifgz Zd4ejfifd5difd6difd7difd8difgZered4ejfifgz Zed4ejfifgz ZeezezezZd9Zd?d:Zd;Z e!d<Z"e!d=Z#d>S)@rCaA container that lists all Process class method names + some reasonable parameters to be called with. Utility methods (parent(), children(), ...) are excluded. >>> ns = process_namespace(psutil.Process()) >>> for fun, name in ns.iter(ns.getters): ... fun() cpu_percentrmemory_percentr rrT connectionsroneshotroparentsrMr-rr" cpu_times create_timer@rr9 memory_infor net_connectionskindrnicenum_ctx_switches num_threads open_filesrrbrusernameuidsgidsterminalr>rrrrrrr?rgroupedF)r`irrr#r$r7r%c||_dSr)_proc)rrs r|r zprocess_namespace.__init__s  r~c#Kt|}tj||D]L\}}}|r|t |j|}t j|g|Ri|}||fVMdSz_Given a list of tuples yields a set of (fun, fun_name) tuples in random order. N)listrzshufflerrrr;r)rlsrfun_namerrOr8s r|rzprocess_namespace.iters"XXr$& " " HdD #  """$*h//C#C7$777$77C/ ! ! ! !  " "r~cR|j|jjddS)z&Clear the cache of a Process instance.T) _ignore_nspN)r_initrMrs r|rzprocess_namespace.clear_caches' T:::::r~c|D]<\}}}d|z}t||s!|jjd|d}t|=dS)z}Given a TestCase instance and a list of tuples checks that the class defines the required test method names. test_z class should define a z methodN)ryrrAttributeError)r1 test_classrrrq meth_namers r|test_class_coveragez%process_namespace.test_class_coverages~ ! * *NHa(*I:y11 *!+4--!---%S)))  * * *r~cd|jD}d|jD}dttjD}||z|z }|rt d|dS)Nch|] }|d Srrrs r| z)process_namespace.test..s&&&!&&&r~ch|] }|d Srrrs r|rz)process_namespace.test..s---A1Q4---r~c*h|]}|ddk|S)rrqrrs r|rz)process_namespace.test..s!???q1Q43;;;;;r~zuncovered Process class names: )rignoredrDrrr)r1thisrklassleftouts r|testzprocess_namespace.tests&&cg&&&-----??C//???'>U*  LJwJJKK K L Lr~N)T)$rrrrutilsrgettersr r'r(r+r RLIMIT_NOFILEr$r*r&r r)settersNORMAL_PRIORITY_CLASSrIOPRIO_CLASS_NONE IOPRIO_NORMALr|rSIGTERMkillers CTRL_C_EVENTCTRL_BREAK_EVENTrr rrrlrrrr~r|rCrCLssR $'7R&@ AE B R+t,- B r2 B 2r B B r G B b" B B B R$ B R B0 R R$ B r2 R 2r B R#G& )VR$%%VR$%%ZR())YB'((-]B+,,(Xr2&''=X 46;<<.^R,--)YB'(()YB'((-]B+,,=]BE(:;<<G CVT2&''Vf:CDD '/G #g -C " " " ";;; * *[ *LL[LLLr~rCc eZdZdZddifddddifddddifddifd dd difd dd difd dd difd dddifdejfifddddifddifddifddddifdejfifddifddifddifddifgZere re rn eddd difgz Ze r eddifgz Ze r eddifgz Ze r eddifgz Zer eddifgz Zered difgz Zed!d"ifgz Zd#difd$ejgfifd%difd&difgZeZed'ZejZd(S))rDzA container that lists all the module-level, system-related APIs. Utilities such as cpu_percent() are excluded. Usage: >>> ns = system_namespace >>> for fun, name in ns.iter(ns.getters): ... fun() boot_timer cpu_countlogicalFT cpu_statsrpercpudisk_io_countersperdiskdisk_partitionsr disk_usagerr net_if_addrs net_if_statsrpernicrr swap_memoryusersvirtual_memoryrrrrrwin_service_iterwin_service_get)algr rr~cpu_times_percentc#Kt|}tj||D]6\}}}tt|}t j|g|Ri|}||fV7dSr)rrzrrrr;r)rrrrOr8s r|rzsystem_namespace.iter s "XXr$& " " HdD&(++C#C7$777$77C/ ! ! ! ! " "r~N)rrrrrrIgetpidrr%rr4HAS_GETLOADAVGr/r.r,r rrrrrrrCrrr~r|rDrDsV b" b9e,- b9d+, b" b8U+, b8T*+ R)T!23 B .   ~r* B0 R R B4 01   ~r* R B "b 2r"%G(<  .logfun s& """444444r~N)rr{rr)rrrrr7)rrs r|r@r@s@ 555 !6;#89    r~cfd}|S)z,Decorator to Ignore AccessDenied exceptions.cJtjfd}|S)Ncr |i|S#tj$rstjdcYSwxYw)Nzraises AccessDenied)rr!rr)rr)r8only_ifs r|r9z9skip_on_access_denied..decorator..wrapper/sc :sD+F+++& : : :&"{#899999  :s  (66r:r8r9rs` r|rz(skip_on_access_denied..decorator.s>    : : : : :   :r~rrrs` r|r>r>+s$      r~cfd}|S)z3Decorator to Ignore NotImplementedError exceptions.cJtjfd}|S)Nc| |i|S#t$r&sjd}tj|cYSwxYw)Nz2 was skipped because it raised NotImplementedError)rrrr)rr)rr8rs r|r9z;skip_on_not_implemented..decorator..wrapperBsz (sD+F+++& ( ( (&"|+++{3''''' (s  -;;r:rs` r|rz*skip_on_not_implemented..decoratorAs>    ( ( ( ( (   (r~rrs` r|r?r?>s$" r~ 127.0.0.1ctj5}||df|dcdddS#1swxYwYdS)z6Return an unused TCP port. Subject to race conditions.rrN)socketbind getsockname)hostrns r|rSrS[s %D 4)!!!$%%%%%%%%%%%%%%%%%%s1AAAc||tthvrd}tj||} tjdvr+|tjtjd|||tj kr| d|S#t$r| wxYw)zBinds a generic socket.Nrr>ntcygwinrr) rrrrr  setsockopt SOL_SOCKET SO_REUSEADDRrrlistenr7rk)familytypeaddrrns r|rTrTbs |7H"555 = & &D  7* * * OOF-v/BA F F F $ 6% % % KKNNN   s A4B CcptjsJtj|r J|t jt j|} |||t jkr| dn##t$r| wxYw|S)zBind a UNIX socket.r) rr rrrrrrrrr7rk)r rrns r|rUrUss <w~~d##))T))) = . .D $ 6% % % KKNNN    Ks :B B3rc"tj|t5}|||d|}tj|t} |||} |\}}||kr||fcdddS|B#t$r|wxYw#1swxYwYdS)z^Build a pair of TCP sockets connected to each other. Return a (server, client) tuple. rTN) rrrrrconnectrgrkr)rrllrcaddras r|rVrVs= v{ + +r   ! ~~ M&+ . .  IIdOOOMMOOE ))++45==q6       GGIII  s+AD5A C! C!! DDD DctjsJdx}} t|tj}|dtjtjtj}|d||n;#t$r.|| || wxYw||fS)zBuild a pair of UNIX sockets connected to each other through the same UNIX file name. Return a (server, client) tuple. Nrr) rr rUrr setblockingrrr7rk)r serverclients r|rWrWs <FV !$V-?@@@1v~v/ABB1t    LLNNN   LLNNN  F s BB8Cc#^Kg}dx}} |ttjtjttjtjft r[|ttjtjttjtjftrmtrft}t}t|\}}t|tj}|||fD]}| ||V|D]}|||fD]}|t|dS#|D]}|||fD]}|t|wxYw)z1Open as many socket families / types as possible.Nr)extendrTrrr SOCK_DGRAMrrr r0rKrWrUrZrkrH)socksfname1fname2s1s2s3rZrs r|rXrXs EFV# (: ; ; (9 : :     ??  LLFOV-?@@FOV->??     - \\F\\F$V,,FB!&v/@AAAB"b\   Q   A GGIIIIf% # #E E""" # #  A GGIIIIf% # #E E""" #s D.s0001A000r~rgrrz([a-fA-F0-9]{2}[:|\-]?){6}Nzunknown family )r~enumIntEnumrrrur ipaddress IPv4Addressrr IPv6AddressrAF_LINKrrr)rroctsnums r|rQrQs= fdl + +33V333 00 30004yyA~~~t~~~ ) )C????s?????D????d##### 6? " "$$$**d***d##### 6> ! !x5t<<HH$HHHHH5655666r~cd}d}d}d}d}||||||||||dS)z*Check validity of a connection namedtuple.cDt|dk}t|dvsJt||d|jksJ|j|d|jksJ|j|d|jksJ|j|d|jksJ|j|d|jksJ|j|d|jksJ|j|r |d |jksJ|jdSdS) Nr>rrrrrhrrrr)rrHrrladdrraddrrbrM)rphas_pids r| check_ntuplez-check_connection_ntuple..check_ntuples5d))q.4yyF"""CII"""Aw$'!!!47!!!Aw$+%%%t{%%%Aw$)###TY###Aw$*$$$dj$$$Aw$*$$$dj$$$Aw$+%%%t{%%%  17dh&&&&&& 1 1&&r~cN|jttthvsJ|jt |jt js J||jtkrtj|j|j5} | |j ddfn-#t$r }|j tj krYd}~nd}~wwxYwddddS#1swxYwYdS|jtkr$|jtjksJ|jdSdSr)rrrrr~rrrrrr rerrno EADDRNOTAVAILrbr CONN_NONE)rprZrs r| check_familyz-check_connection_ntuple..check_familyss{w'::::DK:::$+t|44::d::: ;' ! ! t{DI66 !FFDJqM1-....yE$77787777                   [G # #;&"2222DK222$ #22s<C""B('C"( C2C C" CC""C&)C&cpttdt}|jtjtj|hvsJ|jt |jtjs J||jtjkr$|j tj ksJ|j dSdS)NSOCK_SEQPACKET) rrobjectrrrr~rrrbrr)rprs r| check_typez+check_connection_ntuple..check_types )9688DDy          9    $)T\2288D888 9) ) );&"2222DK222 * )22r~c|j|jfD]}|jtthvrt |t sJt||sFt |jtsJt|jd|jcxkrdksnJ|jt|j |j|jtkr,t |tsJt|dS)Nri)r r rrrr~rrrportrtrQiprr)rprs r| check_addrsz,check_connection_ntuple..check_addrssZ, 9 9D{w111!$..::T :::!$)S11BB4 ??BBBDI......... ...!$'4;7777''!$,,88d4jj888 9 9r~ct|jtsJ|jdttD}|j|vsJ|j|jt thvr6|jtkr&|jtj ksJ|jdS|jtj ksJ|jdS)Ncbg|],}|dtt|-S)CONN_rrs r|rzAcheck_connection_ntuple..check_status..sC   #$q||G7L7L FA     r~) r~rbrrDrrrrrrr)rpvalidss r| check_statusz-check_connection_ntuple..check_statuss$+s++88T[888  (+F    {f$$$dk$$$ ;7H- - -$){2J2J;&"2222DK22222;&"2222DK22222r~Nr)rprrrrr!s r|check_connection_ntupler"s 1 1 1@@@" @ @ @ 9 9 9 @ @ @LLJtKLr~cg}|D]V}tr8|jtjkr#trd|jvrt d|A||W|S)ztOur process may start with some open UNIX sockets which are not initialized by us, invalidating unit tests. z/syslogz skipping )r rrrrr rrZ)consnewrps r|rRrR.sv C  T[FN22 dj00($(())) 4 Jr~c*tj|Sr) importlibreload)modules r|rYrYAs  F # ##r~c<tjtj|d}tj||}tj|}|j ||Sr) rrsplitextrWr'utilspec_from_file_locationmodule_from_specloader exec_module)rr specmods r|rZrZEss 7  BG,,T22 3 3A 6D > 1 1$ = =D . ) )$ / /CKC   Jr~c>tj|tddS)zRaise a warning msg.rhrNr)rs r|r[r[Rs M#{q111111r~ct|}|j}t|dks|dturdSt |dd}t |tsdSt d|DS)z-Check if object is an instance of namedtuple.rrF_fieldsNc3@K|]}t|tVdSr)r~r)rns r| z is_namedtuple..`s,--az!S!!------r~)r __bases__rrrrr~r)rtbrxs r|r]r]Ws{ QA A 1vv{{ad%''u9d##A a  u --1--- - --r~c#|Ktrdnddt|z}fdtjD}t j|}tj|| tj ||Vt|dS#t|wxYw)zCtx manager which picks up a random shared CO lib used by this process, copies it in another location and loads it in memory via ctypes. Return the new absolutized path. pypypythonz.sorcg|]R}tj|jdk0|jvK|jSS)r)rrr+lower)rrrexts r|rz'copyload_shared_lib..ns[   w''*c11cQV\\^^6K6K F6K6K6Kr~N) rrKrrrrzr{rrctypesCDLLrH)rdstlibsrmrrAs @@r|r\r\es *ff( ---     ^%%1133    mD!!S!!!  K   III      K    s B**B;c# Kddlm}ddlm}d t| z} fdt jD}tr1|s/dt jD}tj |}tj ||d} tj |}|V|Ctj jj}|jg|_||j}|dkr |t'|dS#|Ctj jj}|jg|_||j}|dkr |t'|wxYw) zCtx manager which picks up a random shared DLL lib used by this process, copies it in another location and loads it in memory via ctypes. Return the new absolutized, normcased path. r)WinError)wintypesz.dllrcg|]}|jrZdtj|jvr"d|jv|jS)r>wow64)rr@rrrW)rrrAs r|rz'copyload_shared_lib..s   v||~~&&s++ BG,,QV44::<<<<qv||~~-- F.--r~cg|]A}dtj|jv:|jBS)r=)rrrWr@rs r|rz'copyload_shared_lib..sMRW--af55;;=======r~N)rBrGrHrKrrrrrzr{rrWinDLLwindllkernel32 FreeLibraryHMODULEargtypes_handlerH) rrGrHrDrErmcfilerOrrAs @r|r\r\}s $########### ---    ^%%1133      ))5577D mD!!S!!! M#&&EIII $m4@ (0(8'9 $!k%-00!88"(**$        $m4@ (0(8'9 $!k%-00!88"(**$     s :D((AE>c&tddS)NTr)r8rr~r|cleanup_test_procsrUsD!!!!!!r~c*tj|Sr)rxexit)rrqs r|reres#r~r)F)TFr))r)rr)rrrrBrrr;rRr'rrrprzrrhrrrrrrvrxrrUrr0 tracebackr=rrrrr ImportErrorrrrrr r r r r psutil._commonrrrrrpsutil._psposixr__all__builtin_module_namesrrr_r r3r5maxsizer#machiner@r4RISCV64r}r1r2rrr"rrrrdecodergetfilesystemencodingASCII_FSgetrrr3r__file__rrrryrr$r&rr(r)r0HAS_NET_IO_COUNTERSr*r'r+r,r.r/ HAS_THREADSgetuid SKIP_SYSCONSrjrr-r7rrr[ format_excrr%rrrrudevnullrrkrDr!rrrr/rKrXrFrrmodulesrr,r<r=r9r;r:r6rrr7r8rMrLrrrOrrPrNrHrrrGrIrJrKrrBrrrrArEr|rCrDr@r>r?rSrTrUrVrWrXrQr"rRrYrZr[r]r\rUrr~r|rmsv         MMMM FFF &&&&&& """"""&&&&&&(((((()((((((# # # ZS--!RZ/O>RZ3O  RZ ''2:5 ;  (    " " $ $(< < (    )  (  =??X-L =??g-LLLL  #' !OJaNA *929;;))) %,,V5FGG $3 $ & & , , . .2G G :>>+ , , 0@0@GLL**D$7711gll8Y//  w112276>>::gfni00 .. WV^X . . '&.-88 .Ygf&78876>955wv~}== WV^X . . gf&78876>22"76+ABBgfni00  2)")++"2 %H$$/Ev/E/G/G*H*HKKFO%I%e-AY-A-C-CDDEEEKKK76:..J448I8I3J3JLLFO%I%e-AY-A-C-CDDEEELLL)))X)[]] N $rz4   #F  '&)VVXX . . U#U#U#U#U#U#U#U#r,  > F'CK(((((!(((`   &&&&R###L&&&R&0 &~NQ/Q/Q/Q/h----J!!!066666666r"        .1       v{45          D    4    &\\\\\X&\\\ZD!566h''g%g%g%g%g%^g%g%('76g%T$   FLFLFLFLFLFLFLFLRC@C@C@C@C@C@C@C@L(     &:%%%%[t"!' 2    .. ###<777(HHHV   &$$$222 . . . E.****f""" @FM&.">">?????@@s6B BBN//3O%$O%)$P3QQ