tfh2ZdZddlZddlmZddlmZmZddlm Z m Z m Z ddl m Z ddlmZddlZddlmZdd lmZdd lmZd d lmZd dlmZmZmZmZmZmZmZde de fde de ffdZ Gddej!j"j#Z$Gddej!j"j#Z%dS)z3 Tests for L{twisted.application.runner._pidfile}. N)wraps)getpidname)AnyCallableOptional) verifyObject)NoReturn)FilePath)platform)SkipTest)_pidfile)AlreadyRunningErrorInvalidPIDFileErrorIPIDFile NonePIDFile NoPIDFoundPIDFileStalePIDFileErrorf.returnc vtdtdtdtdtffd }|S)a= Decorator for tests that are not expected to work on all platforms. Calling L{PIDFile.isRunning} currently raises L{NotImplementedError} on non-POSIX platforms. On an unsupported platform, we expect to see any test that calls L{PIDFile.isRunning} to raise either L{NotImplementedError}, L{SkipTest}, or C{self.failureException}. (C{self.failureException} may occur in a test that checks for a specific exception but it gets NotImplementedError instead.) @param f: The test method to decorate. @return: The wrapped callable. selfargskwargsrc4tjdk}|r |g|Ri|S|jtt|jf|g|Ri|}t |tr7|t| ddSdS)Nposixz isRunning is not implemented on ) r getType assertRaisesNotImplementedErrorr failureException isinstance assertTruestr startswith)rrr supporteders k/var/www/surfInsights/venv3-11/lib/python3.11/site-packages/twisted/application/runner/test/test_pidfile.pywrapperz$ifPlatformSupported..wrapper3s$&&'1  W1T+D+++F++ +!!$h0EF   A!011 WA 1 12T U UVVVVV W W)rr)rr+s` r*ifPlatformSupportedr-!s`$ 1XXWcW#WWWWWWWXW Nr,cdeZdZdZddeedeefdZddZ ddZ ddZ dd Z dd Z dd Zdd Zdd ZddZddZddZeddZeddZeddZeddZeddZeddZddZddZeddZeddZdS) PIDFileTestsz Tests for L{PIDFile}. Ncontentrcvt|}||||SN)r mktemp setContent)rr0filePaths r*r5zPIDFileTests.filePathLs6DKKMM**      ( ( (r,crt|}tt|dS)z5 L{PIDFile} conforms to L{IPIDFile}. N)rr5r rrpidFiles r*test_interfacezPIDFileTests.test_interfaceRs/$--//**Xw'''''r,cX|tjdddS)zR L{PIDFile._format} returns the expected format when given a PID. 9pids1337 N) assertEqualr_format)rs r*test_formatWithPIDzPIDFileTests.test_formatWithPIDYs- T222I>>>>>r,cd}t|tj|}|||dS)zK L{PIDFile.read} returns the PID from the given file path. r;r<N)rr5r?r>readrr=r8s r*test_readWithPIDzPIDFileTests.test_readWithPID_sS$--C(@(@(@AABB gllnn-----r,cd}t|d}|t|j}|t |d|dS)f L{PIDFile.read} raises L{InvalidPIDFileError} when given an empty file path. r,#non-integer PID value in PID file: Nrr5r!rrBr>r&rpidValuer8r)s r*test_readEmptyPIDzPIDFileTests.test_readEmptyPIDise $--,,--   17< @ @ Q!Sx!S!STTTTTr,cd}t||}|t|j}|t |d|dS)rFs$foo!rGNrHrIs r*test_readWithBogusPIDz"PIDFileTests.test_readWithBogusPIDtse $--1122   17< @ @ Q!Sx!S!STTTTTr,ct|}|t|j}|t |ddS)zc L{PIDFile.read} raises L{NoPIDFound} when given a non-existing file path. PID file does not existN)rr5r!rrBr>r&rr8r)s r*test_readDoesntExistz!PIDFileTests.test_readDoesntExistsS $--//**   j', 7 7 Q!:;;;;;r,c0ddtdtfd}|td|t |}|t|j}| |j tj dS)z L{PIDFile.read} re-raises L{OSError} if the associated C{errno} is anything other than L{errno.ENOENT}. rmoderc6ttjd)Nz I/O error)OSErrorerrnoEIO)rTs r*oopsz>PIDFileTests.test_readOpenRaisesOSErrorNotENOENT..oopss%)[11 1r,openN)rS) r&r patchr rr5r!rVrBr>rWrX)rrYr8errors r*#test_readOpenRaisesOSErrorNotENOENTz0PIDFileTests.test_readOpenRaisesOSErrorNotENOENTs  2 2s 2X 2 2 2 2 8VT***$--//**!!'7<88 ei00000r,cd}t|}|||||dS)z9 L{PIDFile._write} stores the given PID. iN)rr5_writer>rBrCs r* test_writePIDzPIDFileTests.test_writePIDsT$--//**s -----r,ct|}|t|jddS)zS L{PIDFile._write} raises L{ValueError} when given an invalid PID. burpN)rr5r! ValueErrorr_r7s r*test_writePIDInvalidz!PIDFileTests.test_writePIDInvalids9$--//** *gnf=====r,ct|}|||t dS)zT L{PIDFile.writeRunningPID} stores the PID for the current process. N)rr5writeRunningPIDr>rBrr7s r*test_writeRunningPIDz!PIDFileTests.test_writeRunningPIDsS$--//**!!! 22222r,c"t|d}||j|||jdS)z9 L{PIDFile.remove} removes the PID file. r,N)rr5r%existsremove assertFalser7s r* test_removezPIDFileTests.test_removesw$--,,-- (//11222 )002233333r,c t|}|ddtdtddfd}|t d|||dS)zR L{PIDFile.isRunning} returns true for a process that does exist. r;r=signalrNcdSr2r=rns r*killz2PIDFileTests.test_isRunningDoesExist..kill Fr,rrrr5r_intr[rr% isRunningrr8rrs r*test_isRunningDoesExistz$PIDFileTests.test_isRunningDoesExists $--//**t c 3 4     8VT*** ))++,,,,,r,ct|}|||dS)a@ L{PIDFile.isRunning} returns true for this process (which is running). @note: This differs from L{PIDFileTests.test_isRunningDoesExist} in that it actually invokes the C{kill} system call, which is useful for testing of our chosen method for probing the existence of a process. N)rr5rfr%rvr7s r*test_isRunningThiszPIDFileTests.test_isRunningThissO$--//**!!! ))++,,,,,r,ct|}|ddtdtddfd}|t d||t|jdS)z{ L{PIDFile.isRunning} raises L{StalePIDFileError} for a process that does not exist (errno=ESRCH). r;r=rnrNc6ttjdNzNo such processrVrWESRCHrqs r*rrz5PIDFileTests.test_isRunningDoesNotExist..kill%+'899 9r,rr) rr5r_rur[rr!rrvrws r*test_isRunningDoesNotExistz'PIDFileTests.test_isRunningDoesNotExists $--//**t :c :3 :4 : : : : 8VT*** +W->?????r,c t|}|ddtdtddfd}|t d|||dS)zx L{PIDFile.isRunning} returns true for a process that we are not allowed to kill (errno=EPERM). r;r=rnrNc6ttjd)NzOperation not permitted)rVrWEPERMrqs r*rrz3PIDFileTests.test_isRunningNotAllowed..kills%+'@AA Ar,rrrtrws r*test_isRunningNotAllowedz%PIDFileTests.test_isRunningNotAlloweds $--//**t Bc B3 B4 B B B B 8VT*** ))++,,,,,r,ctdkrtdt|}|d||dS)ac L{PIDFile.isRunning} returns true for a process that we are not allowed to kill (errno=EPERM). @note: This differs from L{PIDFileTests.test_isRunningNotAllowed} in that it actually invokes the C{kill} system call, which is useful for testing of our chosen method for probing the existence of a process that we are not allowed to kill. @note: In this case, we try killing C{init}, which is process #1 on POSIX systems, so this test is not portable. C{init} should always be running and should not be killable by non-root users. rzThis test assumes POSIXN) SYSTEM_NAMEr rr5r_r%rvr7s r*test_isRunningInitzPIDFileTests.test_isRunningInitsi ' ! !455 5$--//**q ))++,,,,,r,ct|}|dtdtddfd}|t d||t|jdS)z L{PIDFile.isRunning} re-raises L{OSError} if the attached C{errno} value from L{os.kill} is not an expected one. r=rnrNc6ttjd)Nz File exists)rVrWEEXISTrqs r*rrz5PIDFileTests.test_isRunningUnknownErrno..kills%, 66 6r,rr) rr5rfrur[rr!rVrvrws r*test_isRunningUnknownErrnoz'PIDFileTests.test_isRunningUnknownErrnos $--//**!!! 7c 73 74 7 7 7 7 8VT*** '7#455555r,ct|}||dS)zS L{PIDFile.isRunning} returns false if the PID file doesn't exist. N)rr5rkrvr7s r*test_isRunningNoPIDFilez$PIDFileTests.test_isRunningNoPIDFile#s?$--//** **,,-----r,ct|}||j|5||j||tdddn #1swxYwY||jdS)z When used as a context manager, a L{PIDFile} will store the current pid on entry, then removes the PID file on exit. N)rr5rkrir%r>rBrr7s r*test_contextManagerz PIDFileTests.test_contextManager+s $--//** )0022333  7 7 OOG,3355 6 6 6   W\\^^VXX 6 6 6 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 )002233333sA!B==CCct|}|ddtdtddfd}|t d||t|j}| t|d|5| | tddddS#1swxYwYdS) z When used as a context manager, a L{PIDFile} will replace the underlying PIDFile rather than raising L{AlreadyRunningError} if the contained PID file exists but refers to a non-running PID. r;r=rnrNc6ttjdr}r~rqs r*rrz9PIDFileTests.test_contextManagerDoesntExist..killCrr,rrz'PID file refers to non-existing process) rr5r_rur[rr!rrvr>r&rBr)rr8rrr)s r*test_contextManagerDoesntExistz+PIDFileTests.test_contextManagerDoesntExist9s.$--//**t :c :3 :4 : : : : 8VT***   /1B C C Q!JKKK  7 7   W\\^^VXX 6 6 6 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7 7s,5C..C25C2c`t|}|ddtdtddfd}|t d||||t|j dS)z When used as a context manager, a L{PIDFile} will raise L{AlreadyRunningError} if the there is already a running process with the contained PID. r;r=rnrNcdSr2rprqs r*rrz.killXrsr,rr) rr5r_rur[rr%rvr!r __enter__rws r*!test_contextManagerAlreadyRunningz.PIDFileTests.test_contextManagerAlreadyRunningNs$--//**t c 3 4     8VT*** ))++,,, -w/@AAAAAr,r2rN)__name__ __module__ __qualname____doc__rbytesr r&r5r9r@rDrKrMrQr]r`rdrgrlr-rxrzrrrrrrrrrpr,r*r/r/Gsk8C= ((((???? .... U U U U U U U U<<<<1111 . . . .>>>>33334444 - - - - - - - - @ @ @ @ - - - -----, 6 6 6 6.... 4 4 4 47777(BBBBBBr,r/cJeZdZdZd dZd dZd dZd dZd dZd d Z d d Z dS) NonePIDFileTestsz# Tests for L{NonePIDFile}. rNcLt}tt|dS)z9 L{NonePIDFile} conforms to L{IPIDFile}. N)rr rr7s r*r9zNonePIDFileTests.test_interfacegs#--Xw'''''r,ct}|t|j}|t |ddS)z; L{NonePIDFile.read} raises L{NoPIDFound}. rON)rr!rrBr>r&rPs r* test_readzNonePIDFileTests.test_readnsG--   j', 7 7 Q!:;;;;;r,ct}|t|jd}||jt jdS)zZ L{NonePIDFile._write} raises L{OSError} with an errno of L{errno.EPERM}. rN)rr!rVr_r>rWrrr8r\s r* test_writezNonePIDFileTests.test_writewsF--!!'7>1== ek22222r,ct}|t|j}||jt jdS)zk L{NonePIDFile.writeRunningPID} raises L{OSError} with an errno of L{errno.EPERM}. N)rr!rVrfr>rWrrs r*rgz%NonePIDFileTests.test_writeRunningPIDsE --!!'7+BCC ek22222r,ct}|t|j}||jt jdS)zZ L{NonePIDFile.remove} raises L{OSError} with an errno of L{errno.EPERM}. N)rr!rVrjr>rWENOENTrs r*rlzNonePIDFileTests.test_removesD--!!'7>:: el33333r,crt}||ddS)z< L{NonePIDFile.isRunning} returns L{False}. FN)rr>rvr7s r*test_isRunningzNonePIDFileTests.test_isRunnings5-- **,,e44444r,cZt}|5 ddddS#1swxYwYdS)zo When used as a context manager, a L{NonePIDFile} doesn't raise, despite not existing. N)rr7s r*rz$NonePIDFileTests.test_contextManagersz --                      s  $$r) rrrrr9rrrgrlrrrpr,r*rrbs((((<<<<3333333344445555r,r)&rrW functoolsrosrrrtypingrrrzope.interface.verifyr typing_extensionsr twisted.trial.unittesttwistedtwisted.python.filepathr twisted.python.runtimer r runnerrrrrrrrrr-trialunittestTestCaser/rrpr,r*rs ******************......&&&&&&,,,,,,++++++++++++#8CH-#(382D####LXBXBXBXBXB7=)2XBXBXBvAAAAAw}-6AAAAAr,