h*(SrSSKrSSKrSSKrSSKrSSKrSSKrSSKrSSKJ r SSK J r SSK J r SSKJrJrJr SSKJr SSKJr SS KJrJrJrJrJr SS KJr SS KJrJ r J!r! SS K"J#r#J$r$J%r% SS K&J'r' SSK(J)r)J*r* SSK+J,r, \%RZR]5(dSr/OSr/Sr0\0"5r1Sr2"SS\Rf5r4"SS\Rj5r6S\Sjr7"SS\,5r8"SS\85r9"SS\85r:"SS\85r;"S S!\85r<\2"S"S#\<55r=\*"S$S%\<55r>"S&S'\<5r?"S(S)\<5r@"S*S+\,5rA"S,S-\,5rB"S.S/\Rj5rC"S0S1\ R5rE"S2S3\,5rF"S4S5\,5rG"S6S7\,5rH"S8S9\,5rI"S:S;\,5rJ"S<S=\,5rK"S>S?\,5rL"S@SA\,5rM"SBSC\,5rN"SDSE\,5rO"SFSG\,5rP"SHSI5rQ"SJSK\,\Q5rR\ "\5"SLSM55rS"SNSO5rT"SPSQ5rU"SRSS\,\U5rV\ "\ R5"STSU55rX"SVSW5rY"SXSY\,5rZ"SZS[\,5r[g)]z FTP tests. N)BytesIO) implementer) verifyClass)checkers credentialsportal)UnauthorizedLogin)IRealm)defererrorprotocolreactortask) IConsumer)basicftploopback)failurefilepathruntime) proto_helpers)HAS_IPV6skipWithoutIPv6)TestCasezCannot run on Windowsc[(dgSnSnSn[R"[R5nURS5 UR S5 [R"[R 5nUR SUR5S45 SnU(aUR5 U(aUR5 U$![a N$(!    $$    sBC C! C!c*[(dSUlU$)NzR@"5m U U U U4SjnUTR.lURC5R6n[DRF"[0TRH5nURKSU5nU U4S jnURMU5 TR9[NRP[0T 5 [>RR"T U/5$) N) anonymousRootuserHomez test-userz test-password)r userAnonymousr interfacec>TR?T"U5nURTlU4SjnTR U5 TR S5 TR U5 U$)Nc~>TRRb%TRRR5 ggr7serverProtocol transportloseConnectionr:sr+ cleanupServerQFTPServerTestCase.setUp.._rememberProtocolInstance..cleanupServers2&&00<''11@@B=r2)r? buildProtocolwrappedProtocolr addCleanuprfrC)addrr rrd1 protocolsr;s r+_rememberProtocolInstance:FTPServerTestCase.setUp.._rememberProtocolInstancesX *$T*H"*":":D  C OOM * KK    X &Or2rc>UTlTRTRRR5 TR TR5 gr7)r)rrrrC)r)rr;s r+ gotClient*FTPServerTestCase.setUp..gotClients8 DK OODKK11@@ A   T[[ )r2)*mktemp directoryosmkdirrFilePathdirPathrPortalrFTPRealmregisterCheckerrAllowAnonymousAccessr IAnonymous'InMemoryUsernamePasswordDatabaseDontUseusernamepasswordaddUserIUsernamePassword FTPFactoryryr?r listenTCP bindAddressror stopListeningrr r^getHostr ClientCreator clientFactory connectTCP addCallbackrwaitUntilAllDisconnected gatherResults) r;p users_checkerrorportNum clientCreatord2rrrrs ` @@@r+setUpFTPServerTestCase.setUps   ((8  MM LL"nn   (779;;Q;QR HHJ # ' dmmT]]; -)F)FG~~Qd>P>PQ ",, t||t'7'7   D **+ 22 ^^    &? ",,.%% ..w8J8JK  % %k7 ; * y!  >>S""B8,,r2Ncl^^^Uc[R"S5nUUU4SjnURU5$)z Asserts that a sending an FTP command receives the expected response. Returns a Deferred. Optionally accepts a deferred to chain its actions to. Ncj>TRRT5nUU4SjnURU5$)Nc*>TRTU5 gr7 assertEqual) responseLinesexpectedResponseLinesr;s r+ gotResponseRFTPServerTestCase.assertCommandResponse..queueCommand..gotResponses  !6 Fr2r)queueStringCommandr)ignoredr_rcommandrr;s r+ queueCommand=FTPServerTestCase.assertCommandResponse..queueCommands. ..w7A G==- -r2)r succeedr)r;rr chainDeferredrs``` r+assertCommandResponse'FTPServerTestCase.assertCommandResponses1  !MM$/M .((66r2c^^^Uc[R"S5nUU4SjnURU5 TRU[R 5 UU4SjnURU5$)Nc:>TRRT5$r7r)r)rrr;s r+r;FTPServerTestCase.assertCommandFailed..queueCommands;;11': :r2cL>Tb TRTURS5 ggNrrargs) exceptionexpectedResponser;s r+failed5FTPServerTestCase.assertCommandFailed..faileds(+  !19>>!3DE,r2)r rr assertFailurer CommandFailed)r;rrrrrs``` r+assertCommandFailed%FTPServerTestCase.assertCommandFaileds[  !MM$/M ; !!,/ =#*;*;< F((00r2cLURSS/5nURSS/US9$)NUSER anonymous8331 Guest login ok, type your email address as password.PASS test@twistedmatrix.com2230 Anonymous login ok, access restrictions apply.rrr;r_s r+_anonymousLogin!FTPServerTestCase._anonymousLoginsA  & &  G H )) ) A B*  r2cURSUR-SUR-/5nURSUR-S/US9$)z` Authenticates the FTP client using the test account. @return: L{Deferred} of command response zUSER %sz331 Password required for %s.zPASS %sz230 User logged in, proceedr)rrrrs r+ _userLoginFTPServerTestCase._userLogins^  & &  ' , > ? ))  ' * +*  r2c[R"SU5nURUSU35 [R"UR S55$)z Decode an FTP response specifying a protocol/address/port combination, using the syntax defined in RFC 2428 sections 2 and 3. @return: a 3-tuple of (protocol, host, port). z\((.*)\)zNo extended address found in r)researchassertIsNotNonerdecodeExtendedAddressgroup)r;rEmatchs r+decodeExtendedAddressLine+FTPServerTestCase.decodeExtendedAddressLinesE +t, U&CD6$JK((Q88r2)r)rrr?rrorrr7)NN)rRrSrTrU__doc__rFTPClientBasicrryrrrrrrrrWrOr2r+rsrsts> &&MMKC-J7*1   9r2rsc"\rSrSrSrSrSrSrg)FTPAnonymousTestsiz Simple tests for an FTP server with different anonymous username. The new anonymous username used in this test case is "guest" guestcLURSS/5nURSS/US9$)z Tests whether the changing of the anonymous username is working or not. The FTP server should not comply about the need of password for the username 'guest', letting it login as anonymous asking just an email address as password. z USER guestrrrrrrs r+test_anonymousLogin%FTPAnonymousTests.test_anonymousLoginsC  & & UV )) ) A B*  r2rON)rRrSrTrUrryrrWrOr2r+rrs M r2rc\rSrSrSrSrSrSrSrSr Sr S r S r S r S rS rSrSrSrSrSr\S5rSrSrSrSrSrSrSrSrSrSr Sr!Sr"S r#S!r$S"r%S#r&S$r'S%r(g&)'BasicFTPServerTestsi)z$ Basic functionality of FTP server. c^STRl[R"[[ 5nUR STRR5R5nURS5nURU4Sj5nU$)zV When the connection limit is reached, the server should send an appropriate response rrcUR$r7)r_)protos r+r>BasicFTPServerTests.test_tooManyConnections..gotClient7s 77Nr2c>>TRSUR5 g)Ns;421 Too many users right now, try again in a few minutes. rr])rr;s r+onConnectionLostEBasicFTPServerTests.test_tooManyConnections..onConnectionLost;s   T  r2) r?connectionLimitr rrrYrrorr)r;ccr_rrs` r+test_tooManyConnections+BasicFTPServerTests.test_tooManyConnections.s| () $  # #G-? @ MM+tyy'8'8':'?'? @         r2c^/SQnS/nU4SjnU4Sjn/nUH`nTRRU5nTRU[R5 UR X65 UR U5 Mb UH@nTRRU5nUR XF5 UR U5 MB [R"USS9$)z When not logged in, most commands other than USER and PASS should get NOT_LOGGED_IN errors, but some can be called before USER and PASS. ) CDUPCWDLISTMODEPASVPWDRETRSTRUSYSTTYPEFEATc>URSnTRUSRS5U<SUS<35 g)Nr530z# - Response didn't start with 530: )r assertTrue startswith)rrfailureResponseLinesr;s r+checkFailResponseDBasicFTPServerTests.test_NotLoggedInReply..checkFailResponseXsC#,>>!#4 OO$R(33E:(, r2c`>USnTRURS5U<SU<35 g)Nrrz - Response start with 530: ) assertFalser)resultrr;s r+checkPassResponseDBasicFTPServerTests.test_NotLoggedInReply..checkPassResponsecs5AYF   !!%( r2TfireOnOneErrback) r)rrrrrrCr DeferredList)r;loginRequiredCommandListloginNotRequiredCommandListrr deferredsrdeferreds` r+test_NotLoggedInReply)BasicFTPServerTests.test_NotLoggedInReplyDs $  (.h#   /G{{55g>H   x):): ;  !2 <   X & 0 3G{{55g>H  !2 <   X &3 !!)dCCr2c(URSS/5$)z0 Issuing PASS before USER should give an error. zPASS fooz=503 Incorrect sequence of commands: USER required before PASSrr:s r+test_PASSBeforeUSER'BasicFTPServerTests.test_PASSBeforeUSER|s ''  L M  r2c(URSS/5$)z4 Issuing USER without a username is a syntax error. USERz,500 Syntax error: USER requires an argument.r#r:s r+test_NoParamsForUSER(BasicFTPServerTests.test_NoParamsForUSERs '' CD  r2c\URRS5nURSS/US9$)z4 Issuing PASS without a password is a syntax error. USER fooPASSz,500 Syntax error: PASS requires an argument.r)r)rrrs r+test_NoParamsForPASS(BasicFTPServerTests.test_NoParamsForPASSs< KK * *: 6'' CDTU(  r2c^SnUTRRlTRR S5nTR SS/US9 UR U4Sj5nU$)z9 Unexpected exceptions from the login handler are caught c@[R"[S55$)Nztest exceptionr failAssertionError)rkwargss r+_fake_loginhandler?BasicFTPServerTests.test_loginError.._fake_loginhandlers::n-=>? ?r2r+zPASS barz5550 Requested action not taken: internal server errorrc>TR5nTRS[U55 TRUSR[ 5 g)NrrflushLoggedErrorsrlenassertIsInstancevaluer3rlogsr;s r+ checkLogs6BasicFTPServerTests.test_loginError..checkLogss=))+D   QD *  ! !$q'-- @r2)rrloginr)rrr)r;r5r_r?s` r+test_loginError#BasicFTPServerTests.test_loginErrorss  @,>""( KK * *: 6    D E !  A  A r2c"UR5$)z Login with userid 'anonymous' rr:s r+test_AnonymousLogin'BasicFTPServerTests.test_AnonymousLogins##%%r2cFUR5nURSS/US9$)zU Issuing QUIT should return a 221 message. @return: L{Deferred} of command response QUITz 221 Goodbye.rrrrs r+ test_QuitBasicFTPServerTests.test_Quits.  "))&>2BRS)TTr2c(SURl[R"5nURRR U[ R5 URSS/5nURSS/US9nURSS/US9nU$) z Reconfigure the server to disallow anonymous access, and to have an IUsernamePassword checker that always rejects. @return: L{Deferred} of command response Frz$331 Password required for anonymous.rz!530 Sorry, Authentication failed.rrz$530 Please login with USER and PASS.) r?allowAnonymousrrrrrrrr)r;denyAlwaysCheckerr_s r+test_AnonymousLoginDenied-BasicFTPServerTests.test_AnonymousLoginDenieds', #$LLN ++ {<<  & & EF   $ $ ) 0 1 %   $ $ :;1 % r2cFUR5nURSS/US9$)z When an anonymous user attempts to edit the server-side filesystem, they will receive a 550 error with a descriptive message. @return: L{Deferred} of command response z MKD newdirz:550 Anonymous users are forbidden to change the filesystemrrrrs r+test_anonymousWriteDenied-BasicFTPServerTests.test_anonymousWriteDenieds6  "''  I J(  r2cFUR5nURSS/US9$)zD Send an invalid command. @return: L{Deferred} of command response GIBBERISHz'502 Command 'GIBBERISH' not implementedrrSrs r+test_UnknownCommand'BasicFTPServerTests.test_UnknownCommands6  "'' CDTU(  r2cFUR5nURSS/US9$)zJ Send RETR before sending PORT. @return: L{Deferred} of command response RETR foozR503 Incorrect sequence of commands: PORT, PASV, EPRT, or EPSV required before RETRrrSrs r+test_RETRBeforePORT'BasicFTPServerTests.test_RETRBeforePORT=  "'' A  (  r2cFUR5nURSS/US9$)zJ Send STOR before sending PORT. @return: L{Deferred} of command response zSTOR foozR503 Incorrect sequence of commands: PORT, PASV, EPRT, or EPSV required before STORrrSrs r+test_STORBeforePORT'BasicFTPServerTests.test_STORBeforePORTr^r2cnUR5nURSS/US9 URSS/US9 U$)zL Send command with bad arguments. @return: L{Deferred} of command response zMODE zz&504 Not implemented for parameter 'z'.rzSTRU Iz&504 Not implemented for parameter 'I'.rSrs r+test_BadCommandArgs'BasicFTPServerTests.test_BadCommandArgssY  "   ?@PQ !    ?@PQ ! r2c0UR[R"S5S5 [S5n[S5HVn[ U5nSX2'SR [ [U55nUR[[RU5 MX g)z Decode a host port. z25,234,129,22,100,23)z 25.234.129.22id,N) rrdecodeHostPortrangelistjoinmapstr assertRaises ValueError)r;numsibadValuess r+test_DecodeHostPort'BasicFTPServerTests.test_DecodeHostPort$sz    5 68P QxqADzHHKS(+,A   j#*<*TRRS5$)Nrr_r;s r+/BasicFTPServerTests.test_PASV..: > >v Fr2c>[R"USSS5upTRUTRRR 5R 5 g)zm Extract the host and port from the resonse, and verify the server is listening of the port it claims to be. r N)rrirrdtpPortrro)rrnror;s r+cb)BasicFTPServerTests.test_PASV..cb<sN ++M",=ab,ABJD   T4#6#6#>#>#F#F#H#M#M Nr2cL>TRRR5$r7r~rys r+r{r|F 3 3 = = L L Nr2rrr;r_rs` r+ test_PASVBasicFTPServerTests.test_PASV2sF  " FG O b NOr2c^[R"STRSS9nTRUR5 UR 5R n[R"[TR5nURSU5nU4SjnURU5 URU4Sj5 TRSS/US9$) zI The C{PASV} command is rejected for IPv6 clients. Use C{EPSV} instead. r::1rzcr>UTlTRTRRR5 gr7)r)rrr)r)r;s r+r.gotClientUs& DK OODKK11@@ Ar2c$>TR5$r7rErys r+r{;BasicFTPServerTests.test_PASVDeniedIfIPv6..Zs 4 4 6r2rz3502 PASV available only for IPv4 (use EPSV instead)r) rrr?rrrror rrrrr)r;rorrr_rs` r+test_PASVDeniedIfIPv6)BasicFTPServerTests.test_PASVDeniedIfIPv6Is   DLLEB **+,,.%% ..w8J8JK  $ $UG 4 B i  67''  B C(  r2cnUR5nURSS/US9 URSS/US9 U$)zZ When the client sends the command C{EPSV ALL}, a subsequent C{PASV} command is rejected. EPSV ALL200 EPSV ALL OKrrzD503 Incorrect sequence of commands: may not send PASV after EPSV ALLrrrrs r+test_EPSVALLBeforePASV*BasicFTPServerTests.test_EPSVALLBeforePASVasR  " "":0A/BRS"T    S T ! r2c^TR5nURU4Sj5 U4SjnURU5 URU4Sj5 U$)zl When the client sends the command C{EPSV}, the server responds with a port, and is listening on that port. c:>TRRS5$NEPSVrrys r+r{/BasicFTPServerTests.test_EPSV..ur}r2c>TRUSSS5u pTRUTRRR 5R 5 gze Extract the port from the response, and verify the server is listening on the port it claims to be. r rNrrrrrrorrzror;s r+r)BasicFTPServerTests.test_EPSV..cbwP 77 b8I!"8MNJAq   T4#6#6#>#>#F#F#H#M#M Nr2cL>TRRR5$r7r~rys r+r{rrr2rrs` r+ test_EPSVBasicFTPServerTests.test_EPSVosF  " FG O b NOr2c^TR5nURU4Sj5 U4SjnURU5 URU4Sj5 U$)z When the client sends the command C{EPSV} with a network protocol number, the server responds with a port, and is listening on that port. c:>TRRS5$)NzEPSV 2rrys r+r{;BasicFTPServerTests.test_EPSVWithProtocol..s > >x Hr2c>TRUSSS5u pTRUTRRR 5R 5 grrrs r+r5BasicFTPServerTests.test_EPSVWithProtocol..cbrr2cL>TRRR5$r7r~rys r+r{rrr2rrs` r+test_EPSVWithProtocol)BasicFTPServerTests.test_EPSVWithProtocolsF  " HI O b NOr2cnUR5nURSS/US9 URSS/US9 U$)zC Sending EPSV with a bad protocol number returns a suitable error. z EPSV nonsense)501 syntax error in argument(s) nonsense.rz EPSV 65535-522 Network protocol not supported, use (1,2)rSrs r+test_EPSVWithBadProtocol,BasicFTPServerTests.test_EPSVWithBadProtocolsY  "    8 9 !    < = ! r2c^TR5nTRSS/US9 URU4Sj5 U4SjnURU5 URU4Sj5 U$)z= The client may send the command C{EPSV ALL} before C{EPSV}. rrrc:>TRRS5$rrrys r+r{.r}r2c>TRUSSS5u pTRUTRRR 5R 5 grrrs r+r6BasicFTPServerTests.test_EPSVALLBeforeEPSV..cbrr2cL>TRRR5$r7r~rys r+r{rrr2)rrrrs` r+test_EPSVALLBeforeEPSV*BasicFTPServerTests.test_EPSVALLBeforeEPSVs`  " "":0A/BRS"T FG O b NOr2cUR5nURSS/US9 URS[R"SS5-S/US9 U$)zZ When the client sends the command C{EPSV ALL}, a subsequent C{PORT} command is rejected. rrrPORT rrzD503 Incorrect sequence of commands: may not send PORT after EPSV ALL)rrrrrkrs r+test_EPSVALLBeforePORT*BasicFTPServerTests.test_EPSVALLBeforePORTsd  " "":0A/BRS"T   c((a8 8 S T ! r2cnUR5nURSS/US9 URSS/US9 U$)zZ When the client sends the command C{EPSV ALL}, a subsequent C{EPRT} command is rejected. rrrzEPRT |1|127.0.0.1|0|zD503 Incorrect sequence of commands: may not send EPRT after EPSV ALLrrs r+test_EPSVALLBeforeEPRT*BasicFTPServerTests.test_EPSVALLBeforeEPRTsR  " "":0A/BRS"T   " S T ! r2cJUR5nURSS/US9 U$)z/ SYST command will always return UNIX Type: L8 r z215 UNIX Type: L8rrJrs r+ test_SYSTBasicFTPServerTests.test_SYSTs1  " ""6,?+@PQ"Rr2c^TRRTR5R5 TRRTR5RS5R 5 TR 5nTR SS/US9 TR SS/US9 U4SjnURU5 U$)zn Sending the RNFR command followed by RNTO, with valid filenames, will perform a successful rename operation. fooRNFR foo6350 Requested file action pending further information.rzRNTO bar&250 Requested File Action Completed OKc>TRTRRTR5RS5R 55 U$Nbar)rrchildrexistsrr;s r+ check_rename:BasicFTPServerTests.test_RNFRandRNTO..check_renames; OODLL..t}}=CCEJQQS TMr2)rrrcreateDirectorytouchrrr)r;r_rs` r+test_RNFRandRNTO$BasicFTPServerTests.test_RNFRandRNTOs 4==)99; 4==)//6<<> OO  ""  E F # "" ABRS #   l#r2cnUR5nURSS/US9 URSS/US9 U$)z Sending the RNFR command followed by any command other than RNTO should return an error informing users that RNFR should be followed by RNTO. rrrzOTHER don-tcarez<503 Incorrect sequence of commands: RNTO required after RNFRrrs r+test_RNFRwithoutRNTO(BasicFTPServerTests.test_RNFRwithoutRNTOsY  " ""  E F #    K L ! r2cSnXRlUR[URR[ R "55 g)z Exceptions other than L{error.CannotListenError} which are raised by C{listenFactory} should be raised to the caller of L{FTP.getDTPPort}. c[5er7) RuntimeError portNumberr?r4s r+ listenFactoryEBasicFTPServerTests.test_portRangeForwardError..listenFactorys . r2N)rrror getDTPPortr Factory)r;rs r+test_portRangeForwardError.BasicFTPServerTests.test_portRangeForwardErrors?  !-:)  $--88(:J:J:L r2c&SnXRlURR[R"55nUR US5 [ SS5URlURR[R"55nUR US5 [ SS5URlUR[RURR[R"55 g)a  L{FTP.passivePortRange} should determine the ports which L{FTP.getDTPPort} attempts to bind. If no port from that iterator can be bound, L{error.CannotListenError} should be raised, otherwise the first successful result from L{FTP.listenFactory} should be returned. cBUS;a[R"SUS5eU$)N)ViViV localhostr )r CannotListenErrorrs r+r9BasicFTPServerTests.test_portRange..listenFactory%s&22--k:wOO r2rriiVN) rrrr rrrjpassivePortRangeror r)r;rros r+test_portRange"BasicFTPServerTests.test_portRanges  -:)""--h.>.>.@A q!/4UE/B,""--h.>.>.@A u%/4UE/B,   # #T%8%8%C%CXEUEUEW r2c[SS5nXRlURRS5nUR XR R5 g)z The L{FTP} instances created by L{ftp.FTPFactory.buildProtocol} have their C{passivePortRange} attribute set to the same object the factory's C{passivePortRange} attribute is set to. iiN)rjr?rrrr)r; portRanger s r+"test_portRangeInheritedFromFactory6BasicFTPServerTests.test_portRangeInheritedFromFactory8sH $% (1 %<<--d3 $<$<$M$MNr2ch^TRRS5nU4SjnURU5$)z When the server receives 'FEAT', it should report the list of supported features. (Additionally, ensure that the server reports various particular features that are supported by all Twisted FTP servers.) r c>TRSUS5 TRSU5 TRSU5 TRSU5 TRSU5 TRSUS5 g) Nz 211-Features:rz MDTMz PASVz TYPE A;Iz SIZEz211 Endr )rassertIn)rr;s r+r2BasicFTPServerTests.test_FEAT..gotResponseKse   _mA.> ? MM'= 1 MM'= 1 MM+} 5 MM'= 1   Y b(9 :r2r)r;r_rs` r+ test_FEATBasicFTPServerTests.test_FEATCs/ KK * *6 2 ;}}[))r2cJUR5nURSS/US9 U$)z When the server receives 'OPTS something', it should report that the FTP server does not support the option called 'something'. zOPTS somethingz'502 Option 'something' not implemented.rrSrs r+ test_OPTSBasicFTPServerTests.test_OPTSUs8  "    6 7 ! r2c^TRRTR5R5 TRRTR5RS5R5 TR 5nU4SjnU4SjnUR U5 UR U5 TR SS/US9 U$)zT Any FTP error raised inside STOR while opening the file is returned to the client. folderc:>TRRS5$)z- Send the PASV command required before port. rrrs r+sendPASVCBasicFTPServerTests.test_STORreturnsErrorFromOpen..sendPASVns;;11&9 9r2c>TRRRRS5 [ 5TRlU$)zs Fake an incoming connection and create a mock DTPInstance so that PORT command will start processing the request. N)r dtpFactoryrrfobject dtpInstancers r+mockDTPInstanceJBasicFTPServerTests.test_STORreturnsErrorFromOpen..mockDTPInstancets:    * * 3 3 < [R"[55$)zW Override openForWriting. @param ignore: ignored, used for callback @return: an error r1)ignores r+failingOpenForWriting[BasicFTPServerTests.test_STORunknownErrorBecomesFileNotFound..failingOpenForWritings::n./ /r2c:>TRRS5$)z[ Send the PASV command required before port. @param result: parameter used in L{Deferred} rrrs r+rNBasicFTPServerTests.test_STORunknownErrorBecomesFileNotFound..sendPASVs ;;11&9 9r2c>TRRRRS5 [ 5TRlTTRR lU$)z Fake an incoming connection and create a mock DTPInstance so that PORT command will start processing the request. @param result: parameter used in L{Deferred} N)rrrrfrrshellopenForWriting)rr r;s r+rUBasicFTPServerTests.test_STORunknownErrorBecomesFileNotFound..mockDTPInstancesN    * * 3 3 < TR5nTRS[U55 TRUSR[ 5 g)zU Check that unknown errors are logged. @param result: parameter used in L{Deferred} rrNr8r=s r+r?OBasicFTPServerTests.test_STORunknownErrorBecomesFileNotFound..checkLogss? ))+D   QD *  ! !$q'-- @r2zSTOR somethingz)550 something: No such file or directory.r)rrr)r;r_rrr?r s` @r+(test_STORunknownErrorBecomesFileNotFound       A.  . (*"(  4&   6 O*$ "H:r2rcH\rSrSrSr\R rSrSr Sr Sr Sr g) FTPServerAdvancedClientTestsiz2 Test FTP server with the L{ftp.FTPClient} class. c^U4SjnTRRS5up#URU5 [R"X#/5$)zT Try to make an STOR as anonymous, and check that we got a permission denied error. c>UR[R5 TRURR SSS5 g)Nrz550 foo: Permission denied.)traprrrr<rresr;s r+eb;FTPServerAdvancedClientTests.test_anonymousSTOR..ebs8 HHS&& '   SYY^^A.q13P Qr2r)r) storeFile addErrbackr r)r;rrrs` r+test_anonymousSTOR/FTPServerAdvancedClientTests.test_anonymousSTORs@  R&&u- b""B8,,r2c^^"SS[R5mU4SjnTR[RSU5 U4SjnTRR S5up4UR U5 [R"X4/5$)zU Any FTP error raised by STOR while transferring the file is returned to the client. c\rSrSrSrSrg)XFTPServerAdvancedClientTests.test_STORtransferErrorIsReturned..FailingFileWritericV[R"[R"S55$)N failing_filer r2rIsADirectoryErrorr:s r+receive`FTPServerAdvancedClientTests.test_STORtransferErrorIsReturned..FailingFileWriter.receiveszz#"7"7"GHHr2rONrRrSrTrUr)rWrOr2r+FailingFileWriterr$s Ir2r,c<>[R"T"S55$r7r rabr,s r+ failingSTORRFTPServerAdvancedClientTests.test_STORtransferErrorIsReturned..failingSTOR==!24!89 9r2rcL>UR[R5 TR5nTR S[ U55 TR USR[R5 TR URRSSS5 g)Nrrz 550 failing_file: is a directory) rrrr9rr:r;r<r(rrr>r;s r+rIFTPServerAdvancedClientTests.test_STORtransferErrorIsReturned..ebsx HHS&& '))+D   QD *  ! !$q'--1F1F G   SYY^^A.q13U Vr2r& r _FileWriterpatchFTPAnonymousShellr)rrr rr;r2rrrr,s` @r+ test_STORtransferErrorIsReturned=FTPServerAdvancedClientTests.test_STORtransferErrorIsReturnedsp I I : 3((*:KH W&&~6 b""B8,,r2c^^"SS[R5mU4SjnTR[RSU5 U4SjnTRR S5up4UR U5 [R"X4/5$)z Any non FTP error raised by STOR while transferring the file is converted into a critical error and transfer is closed. The unknown error is logged. c\rSrSrSrSrg)aFTPServerAdvancedClientTests.test_STORunknownTransferErrorBecomesAbort..FailingFileWriteric>[R"[55$r7r1r:s r+r)iFTPServerAdvancedClientTests.test_STORunknownTransferErrorBecomesAbort..FailingFileWriter.receiveszz."233r2rONr+rOr2r+r,rAs 4r2r,c<>[R"T"S55$r7r.r/s r+r2[FTPServerAdvancedClientTests.test_STORunknownTransferErrorBecomesAbort..failingSTORr4r2rc8>UR[R5 TR5nTR S[ U55 TR USR[5 TR URRSSS5 g)Nrrz.426 Transfer aborted. Data connection closed.) rrrr9rr:r;r<r3rr6s r+rRFTPServerAdvancedClientTests.test_STORunknownTransferErrorBecomesAbort..ebsu HHS&& '))+D   QD *  ! !$q'-- @    q!!$&V r2r&r8r<s` @r+)test_STORunknownTransferErrorBecomesAbortFFTPServerAdvancedClientTests.test_STORunknownTransferErrorBecomesAbortsm 4 4 : 3((*:KH &&~6 b""B8,,r2c^^"SS[R5mU4SjnTR[RSU5 U4Sjn[ 5nTR R SU5nURU5 U$)zR Any errors during reading a file inside a RETR should be returned to the client. c\rSrSrSrSrg)JFTPServerAdvancedClientTests.test_RETRreadError..FailingFileReadericV[R"[R"S55$)Nblahr')r;consumers r+sendOFTPServerAdvancedClientTests.test_RETRreadError..FailingFileReader.sendszz#"7"7"?@@r2rON)rRrSrTrUrPrWrOr2r+FailingFileReaderrLs Ar2rRc<>[R"T"S55$r7r.)r0r1rRs r+ failingRETRDFTPServerAdvancedClientTests.test_RETRreadError..failingRETR r4r2openForReadingc>TR5 UR"[R5 TR UR R SSS5 TR UR R SSS5 g)Nrz3125 Data connection already open, starting transferrz550 blah: is a directory)r9rrrrr<r)rr;s r+check_responseGFTPServerAdvancedClientTests.test_RETRreadError..check_response'sp  " " $ LL** +    ""1%a(E    W]]//2157Q Rr2r&)r _FileReaderr:r;rYr) retrieveFiler)r;rTrXrr_rRs` @r+test_RETRreadError/FTPServerAdvancedClientTests.test_RETRreadErrorsj A A : 3((*:KH S#$ KK $ $^U ; ^$r2rON) rRrSrTrUrr FTPClientrr r=rHr\rWrOr2r+rrs'MMM --:-@r2rcz\rSrSrSrSSjrSSjrSrSrSr S r S r S r S r S rSrSrSrSrSrSrg) FTPServerPasvDataConnectionTestsi6z PASV data connection. Nch^TRRS5nU4SjnURU5$) Establish a passive data connection (i.e. client connecting to server). @param ignored: ignored @return: L{Deferred.addCallback} rc>TRUSS5 [R"USSS5up[R"[ [ 5nURSU5$)Nr z0^227 Entering Passive Mode \((?:\d+,){5}\d+\)\.$rr) assertRegexrrir rrrYr)rrnrorr;s r+gotPASVEFTPServerPasvDataConnectionTests._makeDataConnection..gotPASVEsb   b!#V ++M",=ab,ABJD''1CDB==d3 3r2r)r;rr_res` r+_makeDataConnection4FTPServerPasvDataConnectionTests._makeDataConnection;s/ KK * *6 2 4}}W%%r2c^^Uc[R"S5nURTR5 UU4SjnURU5 SnURU5$)z Download file. @param command: command to run @param chainDeferred: L{Deferred} used to queue commands. @return: L{Deferred} of command response Nc>TRRT5nURn[R"X/5$r7)r)rr_r r) downloaderrrrr;s r+r@FTPServerPasvDataConnectionTests._download..queueCommand`s5//8BB&&x0 0r2c"UupUR$r7rb)rrrks r+ downloadDone@FTPServerPasvDataConnectionTests._download..downloadDoneis$* !W$$ $r2)r rrrg)r;rrrrns`` r+ _download*FTPServerPasvDataConnectionTests._downloadSsZ  !MM$/M!!$":":; 1 !!,/ %((66r2cr^TR5nTRSUS9 U4SjnURU5$)z= When listing empty folders, LIST returns an empty response. rrc*>TRSU5 gr\rrs r+ checkEmptyCFTPServerPasvDataConnectionTests.test_LISTEmpty..checkEmptyxs   S& )r2rrpr)r;r_rts` r+test_LISTEmpty/FTPServerPasvDataConnectionTests.test_LISTEmptyos;  " vQ/ *}}Z((r2cj^[R"[RRTRS55 [R"[RRTRS55 TR 5nTR SUS9 U4SjnURU5$)ze LIST ignores requests for folder with names like '-al' and will list the content of current folder. rrzLIST -aLrc>/nUR5H&nURURS5S5 M( TRS[ U55 TR SU5 TR SU5 g)N r foobar) splitlinesrCsplitrr:r)downloadnamesrEr;s r+ checkDownloadOFTPServerPasvDataConnectionTests.test_LISTWithBinLsFlags..checkDownloadseE ++- TZZ-b12.   QE + MM&% ( MM&% (r2rrpathrlrrrprr;r_rs` r+test_LISTWithBinLsFlags8FTPServerPasvDataConnectionTests.test_LISTWithBinLsFlags}sy dnne45 dnne45  " z3 )}}]++r2c^[R"[RRTRS55 [R"[RRTRS55 TR 5nTR SUS9 U4SjnURU5 TR SUS9 U4SjnURU5 TR SUS9 U4S jnURU5 U4S jnURU5 TR SUS9 U4S jnURU5$) zk LIST returns all folder's members, each member listed on a separate line and with name and other details. rrrrc`>TRS[USSRS555 g)Nr| )rr:rrr;s r+rLFTPServerPasvDataConnectionTests.test_LISTWithContent..checkDownloads)   QHSbM$7$7$@ A Br2NLST cv>USSRS5nUR5 TRSS/U5 g)Nrrr~r}rsortrr filenamesr;s r+rrs8 " ++G4I NN    ff-y 9r2zLIST fooc*>TRSU5 gr\rrs r+rr   S( +r2c:>TRRS5$)NzCWD foor)rr;s r+chdirDFTPServerPasvDataConnectionTests.test_LISTWithContent..chdirs;;11)< TRSU5 gr\rrs r+rrrr2r)r;r_rrs` r+test_LISTWithContent5FTPServerPasvDataConnectionTests.test_LISTWithContents dnne45 dnne45  " vQ/ C m$ wa0 : m$ z3 , m$ = e vQ/ ,}}]++r2c^^^^TR5nSU4SjjmUU4SjnURU5 TRUS3US9 UUU4SjnURU5$)a Exercise handling by the implementation of I{LIST} or I{NLST} of certain return values and types from an L{IFTPShell.list} implementation. This will issue C{command} and assert that if the L{IFTPShell.list} implementation includes C{listOutput} as one of the file entries then the result given to the client is matches C{expectedOutput}. @param command: Either C{b"LIST"} or C{b"NLST"} @type command: L{bytes} @param listOutput: A value suitable to be used as an element of the list returned by L{IFTPShell.list}. Vary the values and types of the contents to exercise different code paths in the server's handling of this result. @param expectedOutput: A line of output to expect as a result of C{listOutput} being transformed into a response to the command issued. @type expectedOutput: L{bytes} @return: A L{Deferred} which fires when the test is done, either with an L{Failure} if the test failed or with a function object if it succeeds. The function object is the function which implements L{IFTPShell.list} (and is useful to make assertions about what warnings might have been emitted). @rtype: L{Deferred} c2>[R"T/5$r7r.)segmentskeys listOutputs r+ patchedListEFTPServerPasvDataConnectionTests._listTestHelper..patchedLists==*. .r2c>>TTRRlU$r7)rrrk)rrr;s r+loggedInBFTPServerPasvDataConnectionTests._listTestHelper..loggedIns-8D   % % *Mr2z somethingrc,>TRTU5 T$r7r)rexpectedOutputrr;s r+rGFTPServerPasvDataConnectionTests._listTestHelper..checkDownloads   ^X 6 r2)rO)rrrp)r;rrrr_rrrs` `` @r+_listTestHelper0FTPServerPasvDataConnectionTests._listTestHelpersX<  " /  h '*-Q? }}]++r2c bURSSSS[R"S5SSSS44S5$) zp Unicode filenames returned from L{IFTPShell.list} are encoded using UTF-8 before being sent with the response. r my resumérruserrLdrwxrwxrwx 0 user group 0 Jan 01 1970 my resumé rr Permissionsr:s r+test_LISTUnicode1FTPServerPasvDataConnectionTests.test_LISTUnicodesD ## Ax++E2Aq&'J  3   r2c bURSSSS[R"S5SSSS44S5$) z When LIST receive a filename as byte string from L{IFTPShell.list} it will just pass the data to lower level without any change. @return: L{_listTestHelper} r my resumérrrrrrrr:s r+test_LISTNonASCIIBytes7FTPServerPasvDataConnectionTests.test_LISTNonASCIIBytes sD## #Ax++E2Aq&'J  3   r2cx^TR5n[SSS5Hn[[RR TR SU4-5S5nURSU-5 SSS5 TRSU4-US 9 U4U4S jjnURU5 M U$!,(df  NB=f) z2 Download many large files. @return: L{Deferred} iiiz%d.txtwbxNz RETR %d.txtrc<>TRU[U55 gr7rr:)rsizer;s r+rOFTPServerPasvDataConnectionTests.test_ManyLargeDownloads..checkDownload*s  s8}5r2) rrjopenrrrlrwriterpr)r;r_rfObjrs` r+test_ManyLargeDownloads8FTPServerPasvDataConnectionTests.test_ManyLargeDownloadss  "&&#.Dbggll4>>8tg3EFMQU 4$;'N NN=D72!N D-1 6 MM- (/NMs B++ B9 c4^TRRS5R5 TR5nUR TR 5 U4SjnUR U5 SnUR U5 U4SjnUR U5 U$)zW When RETR is called for a folder, it will fail complaining that the path is a folder. rcr>URR5 TRRS5nU$)Nr[)rrr)r)rkrr;s r+ retrFolderHFTPServerPasvDataConnectionTests.test_downloadFolder..retrFolder;s.  / / 1{{55jAHOr2c[S5e)Nz(Downloading a folder should not succeed.)r3)rs r+ failOnSuccessKFTPServerPasvDataConnectionTests.test_downloadFolder..failOnSuccessBs !KL Lr2c>UR"[R5 TRS/URR S5 TR 5nTRS[U5S5 g)Nz550 foo: is a directoryrz6No errors should be logged while downloading a folder.)rrrrr<rr9r:)rcurrent_errorsr;s r+ checkErrorHFTPServerPasvDataConnectionTests.test_downloadFolder..checkErrorGsb LL** +   78'--:L:LQ:O P!335N   N#H r2)rrrrrrgr)r;r_rrrs` r+test_downloadFolder4FTPServerPasvDataConnectionTests.test_downloadFolder0s 5!113  " d../  j! M m$  Z r2c^TR5nTRRS5R5 TRRS5R 5 TR SUS9 U4SjnUR U5$)zX NLST with no argument returns the directory listing for the current working directory. test.txtrrrcv>USSRS5nUR5 TRSS/U5 g)Nrrr}test.txtrrs r+rFFTPServerPasvDataConnectionTests.test_NLSTEmpty..checkDownloadcs8 " ++G4I NN    fk2I >r2)rrrrrrprrs` r+test_NLSTEmpty/FTPServerPasvDataConnectionTests.test_NLSTEmptyTsq  " :&,,. 5!113 wa0 ? }}]++r2cr^TR5nTRSUS9 U4SjnURU5$)z8 NLST on a non-existent file/directory returns nothing. zNLST nonexistent.txtrc*>TRSU5 gr\rrs r+rLFTPServerPasvDataConnectionTests.test_NLSTNonexistent..checkDownloadsrr2rvrs` r+test_NLSTNonexistent5FTPServerPasvDataConnectionTests.test_NLSTNonexistentjs:  " -Q? ,}}]++r2c bURSSSS[R"S5SSSS44S5$) z[ NLST will receive Unicode filenames for IFTPShell.list, and will encode them using UTF-8. NLSTrrrrrr my resumé rr:s r+test_NLSTUnicode1FTPServerPasvDataConnectionTests.test_NLSTUnicodexsD ## Ax++E2Aq&'J  $   r2c bURSSSS[R"S5SSSS44S5$) z: NLST will just pass the non-Unicode data to lower level. rrrrrrrrrr:s r+test_NLSTNonASCIIBytes7FTPServerPasvDataConnectionTests.test_NLSTNonASCIIBytessD## #Ax++E2Aq&'J  $   r2c^TR5nTRRS5R5 TR SUS9 U4SjnUR U5$)z> NLST on an existent file returns only the path to that file. rz NLST test.txtrcT>USSRS5nTRS/U5 g)Nrrr)rrrs r+rMFTPServerPasvDataConnectionTests.test_NLSTOnPathToFile..checkDownloads+ " ++G4I   k]I 6r2)rrrrrprrs` r+test_NLSTOnPathToFile6FTPServerPasvDataConnectionTests.test_NLSTOnPathToFilesV  " :&,,. a8 7}}]++r2rOr7)rRrSrTrUrrgrprwrrrrrrrrrrrrrWrOr2r+r`r`6sU&078 ),.3,j/,b   ","H,, ,    ,r2r`c\rSrSrSrSrSrg)*FTPServerIPv4MappedPasvDataConnectionTestsiz The C{PASV} command doesn't work for IPv6 connections (that's why C{EPSV} was invented). However, it's possible to use it from an IPv4 client connecting to a dual-stack server using IPv4-mapped addresses, if the system's IPv6 stack supports that. rrON)rRrSrTrUrrrWrOr2r+rrsKr2rc"\rSrSrSrSSjrSrg) FTPServerEpsvDataConnectionTestsiz EPSV data connection. Nch^TRRS5nU4SjnURU5$)rbrc>TRUSSS5u p[R"[[5nUR SU5$)Nr rr)rr rrrYr)rrzrorr;s r+gotEPSVEFTPServerEpsvDataConnectionTests._makeDataConnection..gotEPSVsG77 b8I!"8MNJAq''1CDB==- -r2r)r;rr_rs` r+rg4FTPServerEpsvDataConnectionTests._makeDataConnections/ KK * *6 2 . }}W%%r2rOr7)rRrSrTrUrrgrWrOr2r+rrs &r2rc:\rSrSrSrSrS SjrSrSrSr S r g) FTPServerPortDataConnectionTestsizV Test the C{PORT} command. This opens a data connection to a given address and port. c:/Ul[RU5$r7 dataPortsr`rr:s r+r&FTPServerPortDataConnectionTests.setUp/55d;;r2Ncp^[R"5m"U4SjS[R5n[R "SU"5SS9nUR RU5 S[R"SUR5R5-nURRU5 T$)Nc&>\rSrSr\rU4SjrSrg)IFTPServerPortDataConnectionTests._makeDataConnection..DataFactoryic>[RRX5n[R"STR U5 U$rr ServerFactoryrr callLaterrfr;rrrs r+rWFTPServerPortDataConnectionTests._makeDataConnection..DataFactory.buildProtocol6**88D!!!X%6%6:r2rONrRrSrTrUrYr rrWrsr+ DataFactoryr)H  r2rrrrzr)r r^r rrrrrCrrkrror)rr;rrdataPortcmdrs @r+rg4FTPServerPortDataConnectionTests._makeDataConnections>># (00 $$Q M h'**;8H8H8J8O8OPP &&s+r2cURVs/sH#n[R"UR5PM% nn[R"[R U5nUR U5 [R"USS9$s snfzw Tear down the connection. @return: a L{defer.DeferredList} that fires when all open data ports have been closed. Trrr maybeDeferredrr`tearDownrCr)r;rolr_s r+r)FTPServerPortDataConnectionTests.tearDownslBF PU !3!3 4 P    @ I I4 P  !!!d;; Q*Bcz^TR5nSnURU5 U4SjnURU5$)zQ When C{PORT} is asked to connect to a closed port, it returns a suitable error. c^[R"S[R"5SS9nUR 5R mUR 5nURU4Sj5 U$)Nrrrzc>T$r7rOrzrs r+r{[FTPServerPortDataConnectionTests.test_PORTCannotConnect..loggedIn..Gr2rrr rrrorrrror_rs @r+rIFTPServerPortDataConnectionTests.test_PORTCannotConnect..loggedInS$$Q(8(8(:kRDlln))G""$A MM+ ,Hr2cZ>TRS[R"SU5-S/5$)Nrr425 Can't open data connection.)rrrkrr;s r+ gotPortNumKFTPServerPortDataConnectionTests.test_PORTCannotConnect..gotPortNum s1++#,,['BB23 r2rr;r_rr#s` r+test_PORTCannotConnect7FTPServerPortDataConnectionTests.test_PORTCannotConnects<  "  h  }}Z((r2ch^TRRS5R5 TRRS5R5 TRRS5R5 TR5nTR SUS9 U4SjnUR U5$)z^ When Unix shell globbing is used with NLST only files matching the pattern will be returned. rzceva.txtzno.matchz NLST *.txtrcv>USSRS5nUR5 TRSS/U5 g)Nrrsceva.txtrrrs r+rIFTPServerPortDataConnectionTests.test_nlstGlobbing..checkDownloads8 " ++G4I NN    k;7 Cr2)rrrrrprrs` r+test_nlstGlobbing2FTPServerPortDataConnectionTests.test_nlstGlobbings :&,,. :&,,. :&,,.  " |15 D }}]++r2rr7) rRrSrTrUrrrgrr&r+rWrOr2r+rrs  <& <):,r2rcF\rSrSrSrSrS SjrSrSrSr S r S r S r g) FTPServerEprtDataConnectionTestsi%z Test the C{EPRT} command. This opens a data connection to a given protocol, address, and port, in a format compatible with both IPv4 and IPv6. c:/Ul[RU5$r7rr:s r+r&FTPServerEprtDataConnectionTests.setUp-rr2NcF^[R"5m"U4SjS[R5n[R "SU"5SS9nUR RU5 SUR5R-nURRU5 T$)Nc&>\rSrSr\rU4SjrSrg)IFTPServerEprtDataConnectionTests._makeDataConnection..DataFactoryi6c>[RRX5n[R"STR U5 U$rrrs r+rWFTPServerEprtDataConnectionTests._makeDataConnection..DataFactory.buildProtocol9rr2rONrrsr+rr46r r2rrrrzEPRT |1|127.0.0.1|%s|) r r^r rrrrrCrror)rr s @r+rg4FTPServerEprtDataConnectionTests._makeDataConnection1s}>># (00 $$Q M h'%(8(8(:(?(?? &&s+r2cURVs/sH#n[R"UR5PM% nn[R"[R U5nUR U5 [R"USS9$s snfrr)r;rodlr_s r+r)FTPServerEprtDataConnectionTests.tearDownDslCG.. Q.$e!!$"4"45. Q    @ I I4 P ! !!"t<<Rrcz^TR5nSnURU5 U4SjnURU5$)zQ When C{EPRT} is asked to connect to a closed port, it returns a suitable error. c^[R"S[R"5SS9nUR 5R mUR 5nURU4Sj5 U$)Nrrrzc>T$r7rOrs r+r{[FTPServerEprtDataConnectionTests.test_EPRTCannotConnect..loggedIn..^rr2rrs @r+rIFTPServerEprtDataConnectionTests.test_EPRTCannotConnect..loggedInXrr2c0>TRSU-S/5$)Nr7r!r#r"s r+r#KFTPServerEprtDataConnectionTests.test_EPRTCannotConnect..gotPortNumes$++''14U3V r2rr%s` r+test_EPRTCannotConnect7FTPServerEprtDataConnectionTests.test_EPRTCannotConnectPs<  "  h  }}Z((r2cFUR5nURSS/US9$)z@ C{EPRT} returns a syntax error if it can't decode the address. z EPRT nonsenserrrSrs r+test_EPRTBadAddress4FTPServerEprtDataConnectionTests.test_EPRTBadAddressls6  "''  8 9(  r2cFUR5nURSS/US9$)zG C{EPRT} returns a syntax error if the network protocol is ill-formed. z%EPRT |not-a-protocol|127.0.0.1|12345|z/501 syntax error in argument(s) not-a-protocol.rrSrs r+test_EPRTInvalidNetworkProtocol@FTPServerEprtDataConnectionTests.test_EPRTInvalidNetworkProtocolws6  "'' 3 > ?(  r2cFUR5nURSS/US9$)zB C{EPRT} returns an error if the network protocol is unsupported. zEPRT |3|127.0.0.1|12345|rrrSrs r+#test_EPRTUnsupportedNetworkProtocolDFTPServerEprtDataConnectionTests.test_EPRTUnsupportedNetworkProtocols6  "'' & < =(  r2r-r7) rRrSrTrUrrrgrrCrFrIrLrWrOr2r+r/r/%s*<& =)8      r2r/cB\rSrSrSrSrSrSrSrSr Sr S r S r g ) DTPFactoryTestsiz Tests for L{ftp.DTPFactory}. c[R"5Ul"SS5nU"5Ul[R "URSUR5Ulg)zN Create a fake protocol interpreter and a L{ftp.DTPFactory} instance to test. c\rSrSrSrSrg)2DTPFactoryTests.setUp..ProtocolInterpreteriNrOrRrSrTrUrrWrOr2r+ProtocolInterpreterrRKr2rTN)rClockrprotocolInterpreterr DTPFactoryr?r;rTs r+rDTPFactoryTests.setUpsF zz|   $7#8 ~~d&>&>dllS r2c/nURURR[R5nUR UR 5 URRS5 URRS5 URU5 URRS5 URU5 URURR5 g)z L{ftp.DTPFactory.setTimeout} uses the reactor passed to its initializer to set up a timed event to time out the DTP setup after the specified number of seconds. rfrN) rr?rrPortConnectionErrorrrC setTimeoutradvancerrcallsr;finishedr_s r+test_setTimeoutDTPFactoryTests.test_setTimeouts   t||44c6M6M N hoo& " Q " Q ! ++,r2cURRS5nURU[R5 UR URRS55 g)zj A L{ftp.DTPFactory} instance's C{buildProtocol} method can be used once to create a L{ftp.DTP} instance. N)r?rr;rDTP assertIsNone)r;r s r+test_buildProtocolOnce&DTPFactoryTests.test_buildProtocolOncesK <<--d3 h0 $,,44T:;r2cURRS5 URRS5 URURR 5 g)zv If a timeout has been set up using L{ftp.DTPFactory.setTimeout}, it is cancelled by L{ftp.DTPFactory.buildProtocol}. N)r?r^rrrr`r:s r+test_timeoutAfterConnection+DTPFactoryTests.test_timeoutAfterConnections@ # ""4( ++,r2c.URURR[R5nURR S5 UR RS5 URURRS55 U$)z If L{ftp.DTPFactory.buildProtocol} is called after the timeout specified by L{ftp.DTPFactory.setTimeout} has elapsed, L{None} is returned. rkN) rr?rrr]r^rr_rgrrs r+test_connectionAfterTimeout+DTPFactoryTests.test_connectionAfterTimeoutsr   t||44c6M6M N # R  $,,44T:;r2c/nURURR[R5nUR UR 5 URRS5 URU5 URRSS5 URU5 URRS5 U$)z L{ftp.DTPFactory.deferred} fails with L{PortConnectionError} when L{ftp.DTPFactory.clientConnectionFailed} is called. If the timeout specified with L{ftp.DTPFactory.setTimeout} expires after that, nothing additional happens. rkN) rr?rrr]rrCr^rclientConnectionFailedrrr_ras r+!test_timeoutAfterConnectionFailed1DTPFactoryTests.test_timeoutAfterConnectionFaileds   t||44c6M6M N hoo& # " ++D$7 ! R r2c:URURR[R5nURR S5 UR RS5 URRS[R"S55 U$)z If L{ftp.DTPFactory.clientConnectionFailed} is called after the timeout specified by L{ftp.DTPFactory.setTimeout} has elapsed, nothing beyond the normal timeout before happens. rkNr) rr?rrr]r^rr_rrr TimeoutErrorrs r+!test_connectionFailedAfterTimeout1DTPFactoryTests.test_connectionFailedAfterTimeoutst   t||44c6M6M N # R  ++D%2D2DU2KLr2)r?rWrN) rRrSrTrUrrrcrhrlrorsrwrWrOr2r+rOrOs+ T-: <-($r2rOc$\rSrSrSrSrSrSrg)DTPTestsizh Tests for L{ftp.DTP}. The DTP instances in these tests are generated using DTPFactory.buildProtocol() c[R"5Ul"SS5nU"5Ul[R "URSUR5Ul[R"5Ul g)zk Create a fake protocol interpreter, a L{ftp.DTPFactory} instance, and dummy transport to help with tests. c\rSrSrSrSrg)+DTPTests.setUp..ProtocolInterpreteriNrOrSrOr2r+rTr}rUr2rTN) rrVrrWrrXr?r StringTransportWithDisconnectionrrYs r+rDTPTests.setUpsV zz|   $7#8 ~~d&>&>dllS &GGIr2cURRS5nURUR5 SnUR U5 URR 5nUR US-U5 g)zZ L{ftp.DTP.sendLine} writes the line passed to it plus a line delimiter to its transport. Ns line contentr)r?rmakeConnectionrsendLiner<r)r;r lineContentdataSents r+test_sendLineNewlineDTPTests.test_sendLineNewline%sd ll006 ""4>>2% [)>>'') w.9r2)r?rWrrN)rRrSrTrUrrrrWrOr2r+rzrzs J :r2rzc$\rSrSrSrSrSrSrg) PrintLinesi7z+ Helper class used by FTPFileListingTests. cXlgr7_lines)r;r8s r+r<PrintLines.__init__<s r2cURH0nURRURS5S-5 M2 URR 5 g)Nzlatin-1r)rrrrlrrDs r+r@PrintLines.connectionMade?s@KKD NN Y!7'!A B  %%'r2rN)rRrSrTrUrr<r@rWrOr2r+rr7s(r2rc \rSrSrSrSrSrg)MyFTPFileListProtocoliEcP/Ul[RRU5 gr7)otherrFTPFileListProtocolr<r:s r+r<MyFTPFileListProtocol.__init__Fs  ((.r2c:URRU5 gr7)rrCrDs r+ unknownLine!MyFTPFileListProtocol.unknownLineJrHr2)rN)rRrSrTrUr<rrWrOr2r+rrEs / r2rc>\rSrSrSrSrSrSrSrSr Sr S r g ) FTPFileListingTestsiNc^[5m[R"[U5T5nUR U4Sj5 U$)Nc4>TRTR4$r7)filesr)rzfileLists r+r{6FTPFileListingTests.getFilesForLines..Rs @r2)rr loopbackAsyncrr)r;r8r_rs @r+getFilesForLines$FTPFileListingTests.getFilesForLinesOs4(*  " ":e#4h ? @Ar2cV^SnU4SjnTRU/5RU5$)zn This example line taken from the docstring for FTPFileListProtocol @return: L{Deferred} of command response z<-rw-r--r-- 1 root other 531 Jan 29 03:26 READMEc>UuupTRUS[U535 TRUSS:HS5 TRUSS:HS5 TRUSS :HS5 TRUS S :HS5 TRUS S :HS5 TRUSS:HS5 TRUSS:HS5 TRUSS:HS5 TRUSS5 g)Nzunexpect unparsable lines: filetype-misparsed fileitemperms rw-r--r--misparsed permsownerrootrrrdate Jan 29 03:26filenameREADMEnlinksrmisparsed nlinks linktargetmisparsed linktarget)rreprr) fileOtherfilerr;s r+check/FTPFileListingTests.test_OneLine..check]s( Wd   U&A$u+$O P OOD,35I J OODM[8:K L OODMV35I J OODMW46J K OODLC/1E F OODLN:

Azwoohoo! c>UuupunTRUS:HS5 TRUSS:HS5 TRUSS:HS5 TRUS S :HS 5 TRUS S :HS5 TRUSS:HS5 TRUSS:HS5 TRUSS:HS5 TRUSS:HS5 TRUSS5 TRUSS:HS5 TRUSS:HS5 TRUS S :HS 5 TRUS S :HS5 TRUSS:HS5 TRUSS:HS5 TRUSS :HS5 TRUSS:HS5 TRUSS:HS5 g)!Nz woohoo! zincorrect other linerr_rrrrrrzmisparsed ownerrrzmisparsed grouprrzmisparsed sizerz Jan 9 2003zmisparsed daterAmisparsed filenamerr|rrrrrrB)rr)rfile1file2rr;s r+r4FTPFileListingTests.test_VariantLines..checkts)/ &^eXe OOE\13I J OOE*-46J K OOE'Nk9;L M OOE'Nf46G H OOE'Ng57H I OOE&MS02B C OOE&M^;=M N OOE*-46J K OOE(Oq02D E   U<02H I OOE*-46J K OOE'Nk9;L M OOE'Nf46G H OOE'Ng57H I OOE&MQ.0@ A OOE&M^;=M N OOE*-46J K OOE(Oq02D E OOE,/368N Or2r)r;line1line2line3rs` r+test_VariantLines%FTPFileListingTests.test_VariantLinesls>JN P0$$eE%:;GGNNr2cT^U4SjnTRSS/5RU5$)z Unknown lines. cx>UupTRUS5 TRUSS/:HS[U5-5 g)Nzunexpected file entrieszABC z not a file zincorrect unparsable lines: %s)rrrrrothersr;s r+r3FTPFileListingTests.test_UnknownLine..checks@$OU   U$= > OO7N3304<? r2ABCz not a filer)r;rs` r+test_UnknownLine$FTPFileListingTests.test_UnknownLines+  $$e\%:;GGNNr2cZ^SnSnU4SjnTRX/5RU5$)zM Will parse filenames and linktargets containing unescaped space characters. z9drw-r--r-- 2 root other 531 Jan 9 2003 A BzDlrw-r--r-- 1 root other 1 Jan 29 03:26 B A -> D C/A Bc>UupTR/US5 TRSUSSS5 TRSUSSS5 TRSUSS S 5 g Nzunexpected others entrieszA BrrrzB ArzD C/A Brrrrs r+rBFTPFileListingTests.test_filenameWithUnescapedSpace..checkq$OU   R)D E   UE!HZ$8:N O   UE!HZ$8:N O   Ya(>@V Wr2rr;rrrs` r+test_filenameWithUnescapedSpace3FTPFileListingTests.test_filenameWithUnescapedSpaces9 L U  X$$e^4@@GGr2cZ^SnSnU4SjnTRX/5RU5$)zK Will parse filenames and linktargets containing escaped space characters. z:drw-r--r-- 2 root other 531 Jan 9 2003 A\ BzElrw-r--r-- 1 root other 1 Jan 29 03:26 B A -> D\ C/A Bc>UupTR/US5 TRSUSSS5 TRSUSSS5 TRSUSS S 5 grrrs r+r@FTPFileListingTests.test_filenameWithEscapedSpace..checkrr2rrs` r+test_filenameWithEscapedSpace1FTPFileListingTests.test_filenameWithEscapedSpaces9 N W  X$$e^4@@GGr2c^^^[R"5mSm"U4SjS[R5nUU4Sjn[R "U"5T5nUR U5$)zc This example derived from bug description in issue 514. @return: L{Deferred} of command response s<-rw-r--r-- 1 root other 531 Jan 29 2003 README c">\rSrSrU4SjrSrg)0FTPFileListingTests.test_Year..PrintLineicp>URRT5 URR5 gr7)rrr)r; exampleLines r+r@?FTPFileListingTests.test_Year..PrintLine.connectionMades%$$[1--/r2rON)rRrSrTrUr@rW)rsr+ PrintLiners  0 0r2rc>TRSnTRUSS:HS5 TRUSS:HS5 TRUSS:HS5 g) Nrrrrrz Jan 29 2003rr)rr)rrrr;s r+r,FTPFileListingTests.test_Year..checksZ>>!$D OODLC/1E F OODLM9;O P OOD,8:N Or2)rrr Protocolrrr)r;rrr_rrs` @@r+ test_YearFTPFileListingTests.test_YearsU **,V  0)) 0  P  " "9; 9}}U##r2rON) rRrSrTrUrrrrrrrrWrOr2r+rrNs+ @. OD OH&H&$r2rc$\rSrSrSrSrSrSrg)1FTPClientFailedRETRAndErrbacksUponDisconnectTestsiz2 FTP client fails and RETR fails and disconnects. c^[R"5nSUl[R"SUSS9nUR UR 5 UR5RnSSSSSUS - US -4-S /mU4S jUl [R"[[RS S9nURSU5nSnURU5 URU[R 5$)z RETR fails. rrrzz1220 ready, dude (vsFTPd 1.0.0: beat me, break me)z 331 Please specify the password.z230 Login successful. Have fun.z200 Binary it is, then.z+227 Entering Passive Mode (127,0,0,1,%d,%d)z550 Failed to open file.c>[T5$r7)r)r responsess r+r{SFTPClientFailedRETRAndErrbacksUponDisconnectTests.test_FailedRETR..s z)'.gotClients$!!#A&&'@!D Dr2)r rnoisyrrrrrrorrrr^rrrr)r;r0rorrr_rrs @r+test_FailedRETRAFTPClientFailedRETRAndErrbacksUponDisconnectTests.test_FailedRETRs      A= **+,,.%% @ . - % 9!|Wt^, - '  =  # #GS]]A F MM+w / E i !!!S%6%677r2cj^[R"5n[R"5nUR U5 XlUR S[55n/mU4SjnURU5 SSK J n UR[R"U55 URTT5 U$)zT Test the ftp command errbacks when a connection lost happens during the operation. z some pathc(>TRU5 gr7rC)rms r+_ebZFTPClientFailedRETRAndErrbacksUponDisconnectTests.test_errbacksUponDisconnect.._ebs HHW r2r)CONNECTION_LOST)rr^rr~rr rkr4rtwisted.internet.mainrrhrFailurer)r; ftpClienttrr_rrrs @r+test_errbacksUponDisconnectMFTPClientFailedRETRAndErrbacksUponDisconnectTests.test_errbacksUponDisconnects MMO  ; ; =  $ NN; 0   S9  !AB 1r2rON)rRrSrTrUrrrrWrOr2r+rrs"8Hr2rc\rSrSrSrSrSrSrSrSr Sr S r S r S r S rS rSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSr Sr!S r"S!r#S"r$S#r%S$r&S%r'S&r(S'r)S(r*S)r+S*r,S+r-S,r.g-).FTPClientTestsiz$ Test advanced FTP client commands. c[R"5Ul[R"5UlURR UR 5 URUR lg)z7 Create a FTP client and connect it to fake transport. N)rr^r)rr~rrr r:s r+rFTPClientTests.setUp!sGmmo &GGI ""4>>2"&++r2c`URR[R"55 g)zl Deliver disconnection notification to the client so that it can perform any cleanup which may be required. N)r)rhr ConnectionLostr:s r+rFTPClientTests.tearDown*s ""5#7#7#9:r2c URURR5S5 URR S5 URURR5S5 URR 5 URR S5 URURR5S5 URR 5 URR S5 g)z Test the login part. r2s8331 Guest login ok, type your email address as password.sUSER anonymous s2230 Anonymous login ok, access restrictions apply.sTYPE I s200 Type set to I.N)rrr<r)rFclearr:s r+ _testLoginFTPClientTests._testLogin1s --/5   G  --/1FG    !VW --/?    !67r2c*URURR5S5 URR S5 URURR5S5 URR S5 URURR5S5 URR 5 URR S5 URURR5S5 g)z% Test encoding behaviour of sendLine r2Nrés )rrr<r)rrr:s r+ test_sendLineFTPClientTests.test_sendLine@s --/5 T" --/5 R  --/9  V$ --/=r2cD^U4SjnTR5 TRR5RU5nTR TR R 5S5 TR R5 TRRS5 U$)z Test the CDUP command. L{ftp.FTPClient.cdup} should return a Deferred which fires with a sequence of one element which is the string the server sent indicating that the command was executed successfully. (XXX - This is a bad API) c0>TRUSS5 gNrrrrs r+cbCdup(FTPClientTests.test_CDUP..cbCdupX   SV%M Nr2CDUP &250 Requested File Action Completed OK) rr)cduprrrr<rrF)r;rr_s` r+ test_CDUPFTPClientTests.test_CDUPMsw O  KK    * *6 2 --/=    !JKr2cXUR5 URR5nURU[R 5 UR URR5S5 URR5 URRS5 U$)z Test L{ftp.FTPClient.cdup}'s handling of a failed CDUP command. When the CDUP command fails, the returned Deferred should errback with L{ftp.CommandFailed}. rs!550 ..: No such file or directory) rr)rrrrrrr<rrFrs r+test_failedCDUPFTPClientTests.test_failedCDUPbs{  KK    1c//0 --/=    !EFr2c^U4SjnTR5 TRR5RU5nTR TR R 5S5 TRRS5 U$)z Test the PWD command. L{ftp.FTPClient.pwd} should return a Deferred which fires with a sequence of one element which is a string representing the current working directory on the server. (XXX - This is a bad API) cX>TR[R"US5S5 g)Nr/bar/baz)rrparsePWDResponsers r+cbPwd&FTPClientTests.test_PWD..cbPwd|s"   S11#a&9: Fr2PWD 257 "/bar/baz")rr)pwdrrrr<rF)r;r(r_s` r+test_PWDFTPClientTests.test_PWDqse G  KKOO  ) )% 0 --/<   !23r2c$UR5 URR5nURU[R 5 UR URR5S5 URRS5 U$)z} Test a failure in PWD command. When the PWD command fails, the returned Deferred should errback with L{ftp.CommandFailed}. r*'550 /bar/baz: No such file or directory) rr)r,rrrrrr<rFrs r+test_failedPWDFTPClientTests.test_failedPWDsi  KKOO  1c//0 --/<   !KLr2c^U4SjnTR5 TRRS5RU5nTR TR R 5S5 TRRS5 U$)z Test the CWD command. L{ftp.FTPClient.cwd} should return a Deferred which fires with a sequence of one element which is the string the server sent indicating that the command was executed successfully. (XXX - This is a bad API) c0>TRUSS5 grrrs r+cbCwd&FTPClientTests.test_CWD..cbCwdrr2bar/foo CWD bar/foo r)rr)cwdrrrr<rF)r;r5r_s` r+test_CWDFTPClientTests.test_CWDsh O  KKOOI & 2 25 9 --/1CD   !JKr2c&UR5 URRS5nURU[R 5 UR URR5S5 URRS5 U$)z} Test a failure in CWD command. When the PWD command fails, the returned Deferred should errback with L{ftp.CommandFailed}. r7r8s&550 bar/foo: No such file or directory) rr)r9rrrrrr<rFrs r+test_failedCWDFTPClientTests.test_failedCWDsl  KKOOI & 1c//0 --/1CD   !JKr2cr^U4SjnU4SjnUTRlTR5 [5nTRR SU5nUR X5 TR TRR5S5 TRR5 TRR[TR55 TR TRR5S5 TRR5 TRRS5 U$)a Test the RETR command in passive mode: get a file and verify its content. L{ftp.FTPClient.retrieveFile} should return a Deferred which fires with the protocol instance passed to it after the download has completed. (XXX - This API should be based on producers and consumers) c>>TRURS5 gNxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxrrrr;s r+cbRetr/FTPClientTests.test_passiveRETR..cbRetr   U\\; 7r2c>TRUS5 TRUS5 URX45nUR[R"55 TR R S5 URS5 UR[R"[R"S555 g)Nr904150 File status okay; about to open data connection.rBr rrrrStringTransportr)rFrcrhrrr ConnectionDonernror?rr;s r+ cbConnect2FTPClientTests.test_passiveRETR..cbConnects   T; /   T5 )))4,7E  !>!>!@ A KK $ $G    { +  1E1Eb1I!J Kr2spamPASV RETR spam 226 Transfer Complete.) r)connectFactoryrrYr[rrrr<rrFrq)r;rDrNrr_s` r+test_passiveRETRFTPClientTests.test_passiveRETRs 8 L&/ " "$ KK $ $VU 3 f$ --/=    !=> --/1AB    !:;r2c ^STRlSnU4SjnUTRlTR5 [ 5nTRR SU5nUR X#5 TRTRR5SR[R"SS55RTRR55 TRR5 TRR!S5 TRTRR5S 5 TRR5 TRR!S 5 U$) z Test the RETR command in non-passive mode. Like L{test_passiveRETR} but in the configuration where the server establishes the data connection to the client, rather than the other way around. FcrSR[R"SS55UlURR [ R"55 URRS5 URR[R"[R"S555 g)NPORT {}r&rBr)formatrrktextr rrrKrcrhrrr rL)portCmds r+ generatePort.FTPClientTests.test_RETR..generatePorts{$++C,>,>{D,QRGL    + +M,I,I,K L    ) )+ 6    + +GOOE>TRURS5 grArrCs r+rD(FTPClientTests.test_RETR..cbRetrrFr2rP PORT {} rrZ 200 PORT OKrRrS)r)rgeneratePortCommandrrYr[rrrr<r[rrkrlrmrrF)r;r^rDrr_s` r+ test_RETRFTPClientTests.test_RETRs$  W  8+7 ' "$ KK $ $VU 3 f$  NN "  ! !#"4"4[$"G H P P %%     0 --/1AB    !:;r2c^U4SjnUTRlTR5 [5nTRR SU5nTR U[ R5 TRTRR5S5 TRR5 TRR[TR55 TRTRR5S5 TRR5 TRRS5 U$)z Try to RETR an unexisting file. L{ftp.FTPClient.retrieveFile} should return a Deferred which errbacks with L{ftp.CommandFailed} if the server indicates the file cannot be transferred for some reason. cb>TRUS5 TRUS5 URX45nUR[R"55 TR R S5 UR[R"[R"S555 gNrrHrIr rrrrrKr)rFrhrrr rLrMs r+rN1FTPClientTests.test_failedRETR..cbConnect   T; /   T5 )))4,7E  !>!>!@ A KK $ $G   1E1Eb1I!J Kr2rPrQrRs#550 spam: No such file or directory)r)rTrrYr[rrrrrr<rrFrq)r;rNrr_s` r+test_failedRETRFTPClientTests.test_failedRETR s L&/ " "$ KK $ $VU 3 1c//0 --/=    !=> --/1AB    !GHr2c "^SURl/mU4SjnXRlUR5 [ 5nURR SU5nUR URR5SR[R"SS55RURR55 URR5 URRS5 UR URR5S5 UR!T5 TS R#5 URR#5 UR%U[R&5 U$) z Try a RETR, but disconnect during the transfer. L{ftp.FTPClient.retrieveFile} should return a Deferred which errbacks with L{ftp.ConnectionLost) Fc6>SR[R"SS55Ul[R "5nUR RU5 UR UlUR RS5 TRU5 g)NrYrrZsxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx) r[rrkr\rr~r rrcrC)r]rrs r+r^2FTPClientTests.test_lostRETR..generatePort+ sp$++C,>,>{D,QRGL??AB    + +B /!**BK    ) )* 5 HHRLr2rPrbrrZrcrRr)r)rrdrrYr[rrr<r[rrkrlrmrrFrrrr )r;r^rr_rs @r+ test_lostRETRFTPClientTests.test_lostRETR! s) $   +7 ' "$ KK $ $VU 3  NN "  ! !#"4"4[$"G H P P %%     0 --/1AB  ! %%' 1c001r2c^^[R"5mU4SjnUU4SjnUU4SjnUTRlTR 5 TRR S5upEUR U5 UR U5 TRTRR5S5 TRR5 TRR[TR55 TRTRR5S5 TRR5 TRRS5 [R"XE/5$)aL Test the STOR command: send a file and verify its content. L{ftp.FTPClient.storeFile} should return a two-tuple of Deferreds. The first of which should fire with a protocol instance when the data connection has been established and is responsible for sending the contents of the file. The second of which should fire when the upload has completed, the data connection has been closed, and the server has acknowledged receipt of the file. (XXX - storeFile should take a producer as an argument, instead, and only return a Deferred which fires when the upload has succeeded or failed). c>TRRS5 URRS5 UR 5 UR [ R"[R"S555 gNrIrBr r)rFrrfinishrhrrr rLsenderr;s r+cbStore0FTPClientTests.test_passiveSTOR..cbStoreX Y KK $ $G     " "; / MMO  ! !'//%2F2Fr2J"K Lr2cF>TRTR5S5 grArr<ignr;rs r+cbFinish1FTPClientTests.test_passiveSTOR..cbFinish`    RXXZ 5r2c>TRUS5 TRUS5 URX45nURT5 gNrrHrrrrnror?rr;rs r+rN2FTPClientTests.test_passiveSTOR..cbConnectc C   T; /   T5 )))4,7E   $r2rPrQ STOR spam rS)rrKr)rTrrrrrr<rrFrqr r)r;r{rrNrrrs` @r+test_passiveSTORFTPClientTests.test_passiveSTORG s * * , M 6 % &/ " &&v. w x  --/=    !=> --/1AB    !:;""B8,,r2c^^[R"5mU4SjnUU4SjnUTRlTR 5 TRR S5up4UR U5 TRU[R5 TRTRR5S5 TRR5 TRR[TR55 TRTRR5S5 TRR5 TRRS5 [ R""X4/5$)z Test a failure in the STOR command. If the server does not acknowledge successful receipt of the uploaded file, the second Deferred returned by L{ftp.FTPClient.storeFile} should errback with L{ftp.CommandFailed}. c>TRRS5 URRS5 UR 5 UR [ R"[R"S555 grvrwrys r+r{/FTPClientTests.test_failedSTOR..cbStore r}r2c>TRUS5 TRUS5 URX45nURT5 grrrs r+rN1FTPClientTests.test_failedSTOR..cbConnect rr2rPrQrs.426 Transfer aborted. Data connection closed.)rrKr)rTrrrrrrrrr<rrFrqr r)r;r{rNrrrs` @r+test_failedSTORFTPClientTests.test_failedSTORv s  * * , M % &/ " &&v. w 2s001 --/=    !=> --/1AB    !RS""B8,,r2cf^^[R"5mSTRlU4SjnU4SjnUU4SjnUTRlTR 5 TRR S5upEURU5 URU5 [R"XE/5$)z Test the STOR command in non-passive mode. Like L{test_passiveSTOR} but in the configuration where the server establishes the data connection to the client, rather than the other way around. Fcz>S[R"SS5-UlURR T5 g)NrrrZ)rrkr\r r)r]rs r+r^.FTPClientTests.test_STOR..generatePort s0"S%7%7 T%JJGL    + +B /r2c >TRTRR5SR[R "SS55R TRR55 TRR5 TRRS5 TRTRR5S5 TRR5 TRRS5 URRS5 UR5 UR[R"[ R""S555 TRRS 5 g) NrbrrZrcrrIrBrrS)rrr<r[rrkrlr)rmrrFrrxrhrrr rLrys r+r{)FTPClientTests.test_STOR..cbStore s   $$&%%c&8&8d&KLTTKK))  NN " KK $ $^ 4   T^^1135E F NN " KK $ $G     " "; / MMO  ! !'//%2F2Fr2J"K L KK $ $%> ?r2cF>TRTR5S5 grArrs r+r*FTPClientTests.test_STOR..cbFinish rr2rP) rrKr)rrdrrrr r)r;r^r{rrrrs` @r+ test_STORFTPClientTests.test_STOR s * * ,#  0 @& 6+7 ' &&v. w x ""B8,,r2cP^U4SjnU4SjnUTRlTR5 [R"5nTRR SU5R X5nTRTRR5S5 TRR5 TRR[TR55 TRTRR5S5 TRRS5 U$)a Test the LIST command. L{ftp.FTPClient.list} should return a Deferred which fires with a protocol instance which was passed to list after the command has succeeded. (XXX - This is a very unfortunate API; if my understanding is correct, the results are always at least line-oriented, so allowing a per-line parser function to be specified would make this simpler, but a default implementation should really be provided which knows how to deal with all the formats used in real servers, so application developers never have to care about this insanity. It would also be nice to either get back a Deferred of a list of filenames or to be able to consume the files as they are received (which the current API does allow, but in a somewhat inconvenient fashion) -exarkun) c>URVs/sHo"SPM nn/SQnUR5 UR5 TRX45 gs snfNrrrbazrrrrrr0flsexpectedr;s r+cbList/FTPClientTests.test_passiveLIST..cbList G*2..9.QZ=.C9,H MMO HHJ   S + :Ac>TRUS5 TRUS5 URX45nUR[R"55 TR R S5 /SQnUHnURU5 M UR[R"[R"S555 g)NrrHrIs8-rw-r--r-- 0 spam egg 100 Oct 10 2006 foo s8-rw-r--r-- 3 spam egg 100 Oct 10 2006 bar s8-rw-r--r-- 4 spam egg 100 Oct 10 2006 baz rrJ)rnror?rsendingrrr;s r+rN2FTPClientTests.test_passiveLIST..cbConnect s   T; /   T5 )))4,7E  !>!>!@ A KK $ $G G ""1%  1E1Eb1I!J Kr2foo/barrQLIST foo/bar rS) r)rTrrrrkrrrr<rrFrq)r;rrNrr_s` r+test_passiveLISTFTPClientTests.test_passiveLIST s( , L"&/ " **, KK  Y 1 = =f O --/=    !=> --/1DE   !:;r2c ^STRlU4SjnU4SjnUTRlTR5 [R "5nTRR SU5RX#5nTRTRR5SR[R"SS55RTRR55 TRR5 TRR!S5 TRTRR5S 5 TRR5 TRR!S 5 U$) z Test the LIST command in non-passive mode. Like L{test_passiveLIST} but in the configuration where the server establishes the data connection to the client, rather than the other way around. Fc>SR[R"SS55UlURR [ R"55 TRRS5 /SQnUHnURRU5 M URR[R"[R"S555 g)NrYrrZrIrrr[rrkr\r rrrKr)rFrcrhrrr rL)r]rrrr;s r+r^.FTPClientTests.test_LIST..generatePort s$++C,>,>{D,QRGL    + +M,I,I,K L KK $ $G G   --a0    + +GOOEURVs/sHo"SPM nn/SQnUR5 UR5 TRX45 gs snfrrrs r+r(FTPClientTests.test_LIST..cbList rrrrbrrZrcrrS)r)rrdrrrrkrrrr<r[rkrlrmrrF)r;r^rrr_s` r+ test_LISTFTPClientTests.test_LIST s$  W ,+7 ' **, KK  Y 1 = =f O  NN "  ! !#"4"4[$"G H P P %%     0 --/1DE    !:;r2cf^U4SjnUTRlTR5 [R"5nTRR SU5nTR U[R5 TRTRR5S5 TRR5 TRR[TR55 TRTRR5S5 TRRS5 U$)z Test a failure in LIST command. L{ftp.FTPClient.list} should return a Deferred which fails with L{ftp.CommandFailed} if the server indicates the indicated path is invalid for some reason. cb>TRUS5 TRUS5 URX45nUR[R"55 TR R S5 UR[R"[R"S555 grirjrMs r+rN1FTPClientTests.test_failedLIST..cbConnect8 rlr2rrQr&550 foo/bar: No such file or directory)r)rTrrrrkrrrrr<rrFrq)r;rNrr_s` r+test_failedLISTFTPClientTests.test_failedLIST/ s L&/ " **, KK  Y 1 1c//0 --/=    !=> --/1DE   !JKr2c ^STRlU4SjnU4SjnUTRlTR5 [ 5nTRR SU5R X#5nTRTRR5SR[R"SS55RTRR55 TRR5 TRR!S5 TRTRR5S 5 TRR!S 5 U$) z Test the NLST command in non-passive mode. L{ftp.FTPClient.nlst} should return a Deferred which fires with a list of filenames when the list command has completed. Fc>SR[R"SS55UlURR [ R"55 TRRS5 URRS5 URRS5 URRS5 URR[R"[R"S555 g) NrYrrZrIfoo bar baz rr)r]r;s r+r^.FTPClientTests.test_NLST..generatePortW s$++C,>,>{D,QRGL    + +M,I,I,K L KK $ $G     ) )* 5    ) )* 5    ) )* 5    + +GOOEURRTRR5R 5n/SQnUR 5 UR 5 TR X#5 g)Nr)r]decoder)rmrrrrrrrr;s r+r(FTPClientTests.test_NLST..cbListb sO,,%%dkk&;&;<GGIC,H MMO HHJ   S +r2rrbrrZrcNLST foo/bar rS)r)rrdrrYnlstrrrr<r[rrkrlrmrrF)r;r^rlstprotor_s` r+ test_NLSTFTPClientTests.test_NLSTN s$  W ,+7 ' %' KK  Y 1 = =f O  NN "  ! !#"4"4[$"G H P P %%     0 --/1DE   !:;r2c:^U4SjnU4SjnUTRlTR5 [5nTRR SU5R X5nTR TRR5S5 TRR5 TRR[TR55 TR TRR5S5 TRRS5 U$)z Test the NLST command. Like L{test_passiveNLST} but in the configuration where the server establishes the data connection to the client, rather than the other way around. c>URR5n/SQnUR5 UR5 TRX#5 g)N)r}r~sbaz)r]rrrrs r+r/FTPClientTests.test_passiveNLST..cbList s:,,))+C/H MMO HHJ   S +r2c>TRUS5 TRUS5 URX45nUR[R"55 TR R S5 URS5 URS5 URS5 UR[R"[R"S555 g)NrrHrIrrrrrJrMs r+rN2FTPClientTests.test_passiveNLST..cbConnect s   T; /   T5 )))4,7E  !>!>!@ A KK $ $G    z *   z *   z *  1E1Eb1I!J Kr2rrQrrS) r)rTrrYrrrrr<rrFrq)r;rrNrr_s` r+test_passiveNLSTFTPClientTests.test_passiveNLSTy s , L&/ " %' KK  Y 1 = =f O --/=    !=> --/1DE   !:;r2c~^^[R"5mUU4SjnUTRlTR 5 [ 5nTRR SU5nTRU[R5 TRTRR5S5 TRR5 TRR[TR55 TRTRR5S5 TRRS5 U$)z Test a failure in NLST command. L{ftp.FTPClient.nlst} should return a Deferred which fails with L{ftp.CommandFailed} if the server indicates the indicated path is invalid for some reason. c<>TRUS5 TRUS5 URX45nURT5 TRR S5 UR [ R"[R"S555 gri) rrrr)rFrhrrr rLrs r+rN1FTPClientTests.test_failedNLST..cbConnect s|   T; /   T5 )))4,7E   $ KK $ $G   1E1Eb1I!J Kr2rrQrr)rrKr)rTrrYrrrrrrr<rrFrq)r;rNrr_rs` @r+test_failedNLSTFTPClientTests.test_failedNLST s * * , L&/ " %' KK  Y 1 1c//0 --/=    !=> --/1DE   !JKr2czUR5 URRSS5nURURR 5S5 URR 5 SnURRURURR55 URURR 5S5 SnURRURURR55 URURU/U/45 U$)z L{ftp.FTPClient.rename} issues I{RNTO} and I{RNFR} commands and returns a L{Deferred} which fires when a file has successfully been renamed. /spam/ham RNFR /spam z8350 Requested file action pending further information. RNTO /ham r) rr)renamerrr<rrFrlrmr)r;r_ fromResponse toResponses r+test_renameFromTo FTPClientTests.test_renameFromTo s  KK  w / --/1BC S    !4!4T[[5J5J!KL --/1AB=    !2!24;;3H3H!IJ d&&,*(FGr2c"UR5 SnSnURRX5 URRS5 URRS5 UR UR R 5S5 g)z L{ftp.FTPClient.rename} issues I{RNTO} and I{RNFR} commands with paths escaped according to U{http://cr.yp.to/ftp/filesystem.html}. z /foo/ba r/bazz/qu uxs350 s250 s!RNFR /foo/bar/baz RNTO /quux N)rr)rrFrrr<)r;fromFiletoFiles r+test_renameFromToEscapesPaths,FTPClientTests.test_renameFromToEscapesPaths so # 8,   )   )  NN "$V r2cUR5 URRSS5nURURR 5S5 URR 5 URRS5 URURR 5S5 URU[R5$)z The L{Deferred} returned by L{ftp.FTPClient.rename} is errbacked with L{CommandFailed} if the I{RNFR} command receives an error response code (for example, because the file does not exist). rrr!550 Requested file unavailable. r2 rr)rrrr<rrFrrrrs r+$test_renameFromToFailingOnFirstError3FTPClientTests.test_renameFromToFailingOnFirstError s  KK  w / --/1BC    !GH --/5!!!S%6%677r2cUR5 URRSS5nURURR 5S5 URR 5 URRS5 URURR 5S5 URRS5 URU[R5$)z The L{Deferred} returned by L{ftp.FTPClient.rename} is errbacked with L{CommandFailed} if the I{RNTO} command receives an error response code (for example, because the destination directory does not exist). rrrs8350 Requested file action pending further information. rrrrs r+"test_renameFromToFailingOnRenameTo1FTPClientTests.test_renameFromToFailingOnRenameTo s  KK  w / --/1BC    I  --/1AB   !GH!!!S%6%677r2cUR5 URRS5nURURR 5S5 URR S5 URURS/5$)z L{ftp.FTPClient.makeDirectory} issues a I{MKD} command and returns a L{Deferred} which is called back with the server's response if the directory is created. r MKD /spam s257 "/spam" created.z257 "/spam" created.)rr) makeDirectoryrrr<rFrrs r+test_makeDirectory!FTPClientTests.test_makeDirectory sn  KK % %g . --/1AB   !89}}T--0F/GHHr2cUR5 URRS5nURURR 5S5 URR S5 U$)zt L{ftp.FTPClient.makeDirectory} escapes the path name it sends according to U{http://cr.yp.to/ftp/filesystem.html}. z/sp ams MKD /spam s257 win)rr)rrrr<rFrs r+test_makeDirectoryPathEscape+FTPClientTests.test_makeDirectoryPathEscape sY  KK % %i 0 --/1EF   ,r2c"UR5 URRS5nURURR 5S5 URR S5 URU[R5$)z L{ftp.FTPClient.makeDirectory} returns a L{Deferred} which is errbacked with L{CommandFailed} if the server returns an error response code. rrs550 PERMISSION DENIED) rr)rrrr<rFrrrrs r+test_failedMakeDirectory'FTPClientTests.test_failedMakeDirectory% sl  KK % %g . --/1AB   !9:!!!S%6%677r2c^U4SjnTR5 TRR5RU5nTR TR R 5S5 TRRS5 U$)z Test the getDirectory method. L{ftp.FTPClient.getDirectory} should return a Deferred which fires with the current directory on the server. It wraps PWD command. c*>TRUS5 g)Nr&rrs r+cbGet/FTPClientTests.test_getDirectory..cbGet9 s   S* -r2r*r+)rr) getDirectoryrrrr<rF)r;rr_s` r+test_getDirectory FTPClientTests.test_getDirectory1 sf .  KK $ $ & 2 25 9 --/<   !23r2c$UR5 URR5nURU[R 5 UR URR5S5 URRS5 U$)zR Test a failure in getDirectory method. The behaviour should be the same as PWD. r*r0 rr)rrrrrrr<rFrs r+test_failedGetDirectory&FTPClientTests.test_failedGetDirectoryB sk  KK $ $ & 1c//0 --/<   !KLr2c$UR5 URR5nURU[R 5 UR URR5S5 URRS5 U$)z Test a different failure in getDirectory method. The response should be quoted to be parsed, so it returns an error otherwise. r*s 257 /bar/bazrrs r+test_anotherFailedGetDirectory-FTPClientTests.test_anotherFailedGetDirectoryO sj  KK $ $ & 1c//0 --/<   1r2cfUR5 URRS5nURURR 5S5 SnURR URURR55 URURU/5$)z L{ftp.FTPClient.removeFile} sends a I{DELE} command to the server for the indicated file and returns a Deferred which fires after the server sends a 250 response code. /tmp/testDELE /tmp/test *250 Requested file action okay, completed.) rr) removeFilerrr<rFrlrmrr;r_responses r+test_removeFileFTPClientTests.test_removeFile] s  KK " "; / --/1FG?   1F1F!GH}}T--z::r2c^^TR5 TRRS5nTRTRR 5S5 SmTRR TRTRR55 TRU[R5nURUU4Sj5 U$)z If the server returns a response code other than 250 in response to a I{DELE} sent by L{ftp.FTPClient.removeFile}, the L{Deferred} returned by C{removeFile} is errbacked with a L{Failure} wrapping a L{CommandFailed}. r r,501 Syntax error in parameters or arguments.c@>TRURT/45$r7rexcrr;s r+r{6FTPClientTests.test_failedRemoveFile..w $"2"2388xj]"Kr2) rr)rrrr<rFrlrmrrrrrs` @r+test_failedRemoveFile$FTPClientTests.test_failedRemoveFilej s  KK " "; / --/1FGA   1F1F!GH   q#"3"3 4 KLr2cL^^TR5 TRRS5nSmTRRTR TRR 55 TR U[R5nURUU4Sj5 U$)z If the server returns a response line which cannot be parsed, the L{Deferred} returned by L{ftp.FTPClient.removeFile} is errbacked with a L{BadResponse} containing the response. r 765 blah blah blahc@>TRURT/45$r7rrs r+r{BFTPClientTests.test_unparsableRemoveFileResponse.. rr2) rr)rrFrlrmrr BadResponserrs` @r+!test_unparsableRemoveFileResponse0FTPClientTests.test_unparsableRemoveFileResponsez su  KK " "; /'   1F1F!GH   q#// 2 KLr2cUR5 URRS5nURRS5 URRS5 UR UR 5$)z If the server returns multiple response lines, the L{Deferred} returned by L{ftp.FTPClient.removeFile} is still fired with a true value if the ultimate response code is 250. r 250-perhaps a progress report250 okay)rr)rrFrrrs r+ test_multilineRemoveFileResponse/FTPClientTests.test_multilineRemoveFileResponse sZ  KK " "; /   !AB   -}}T__--r2cfUR5 URRS5nURURR 5S5 SnURR URURR55 URURU/5$)z L{ftp.FTPClient.removeDirectory} sends a I{RMD} command to the server for the indicated directory and returns a Deferred which fires after the server sends a 250 response code. r RMD /tmp/test r) rr)removeDirectoryrrr<rFrlrmrrs r+test_removeDirectory#FTPClientTests.test_removeDirectory s  KK ' ' 4 --/1EF?   1F1F!GH}}T--z::r2c^^TR5 TRRS5nTRTRR 5S5 SmTRR TRTRR55 TRU[R5nURUU4Sj5 U$)z If the server returns a response code other than 250 in response to a I{RMD} sent by L{ftp.FTPClient.removeDirectory}, the L{Deferred} returned by C{removeDirectory} is errbacked with a L{Failure} wrapping a L{CommandFailed}. r r+rc@>TRURT/45$r7rrs r+r{;FTPClientTests.test_failedRemoveDirectory.. rr2) rr)r,rrr<rFrlrmrrrrrs` @r+test_failedRemoveDirectory)FTPClientTests.test_failedRemoveDirectory s  KK ' ' 4 --/1EFA   1F1F!GH   q#"3"3 4 KLr2cL^^TR5 TRRS5nSmTRRTR TRR 55 TR U[R5nURUU4Sj5 U$)z If the server returns a response line which cannot be parsed, the L{Deferred} returned by L{ftp.FTPClient.removeDirectory} is errbacked with a L{BadResponse} containing the response. r rc@>TRURT/45$r7rrs r+r{GFTPClientTests.test_unparsableRemoveDirectoryResponse.. rr2) rr)r,rFrlrmrrr"rrs` @r+&test_unparsableRemoveDirectoryResponse5FTPClientTests.test_unparsableRemoveDirectoryResponse su  KK ' ' 4'   1F1F!GH   q#// 2 KLr2cUR5 URRS5nURRS5 URRS5 UR UR 5$)z If the server returns multiple response lines, the L{Deferred} returned by L{ftp.FTPClient.removeDirectory} is still fired with a true value if the ultimate response code is 250. r r&r')rr)r,rFrrrs r+%test_multilineRemoveDirectoryResponse4FTPClientTests.test_multilineRemoveDirectoryResponse sZ  KK ' ' 4   !AB   -}}T__--r2)r)rN)/rRrSrTrUrrrrrrr"r-r1r:r=rUrermrrrrrrrrrrrrrrrrrrrrr rrr#r(r-r2r7r:rWrOr2r+rrs.; 8 >* ( ( %N#J@$L--^#-J*-X5n/b>)V&P@( 8$8& I  8"   ;  . ;  .r2rc6\rSrSrSrSrSrSrSrSr Sr g ) FTPClientBasicTestsi z FTP client c[R"5nURS5 URS/UR5 g)z/ The first response is captured as a greeting. 220 Imaginary FTP.z220 Imaginary FTP.NrrrFrgreetingr;rs r+ test_greeting!FTPClientBasicTests.test_greeting s;&&( 45 ./1C1CDr2c[R"5nURS5 URS/UR5 g)zh Responses with no message are still valid, i.e. three digits followed by a space is complete response. s220 z220 Nr@rBs r+test_responseWithNoMessage.FTPClientBasicTests.test_responseWithNoMessage s8 &&( w' &9#5#56r2c [R"5n[R"5UlUR S5 UR S5n/nURUR5 URUR5 UR S5 UR/U5 UR S5 UR/U5 UR S5 UR/U5 UR S5 UR/U5 UR S5 UR/U5 UR S5 UR/U5 UR S 5 UR/S QUS 5 g ) z Multiline response r?BLAHs210-First line.s123-Second line.sJust some text.sHir2s321s 210 Done.)z210-First line.z123-Second line.zJust some text.Hir321z 210 Done.rN) rrrrKrrFrrrCrr2r)r;rrrs r+test_MultilineResponse*FTPClientBasicTests.test_MultilineResponse s\&&( +;;= 45//7V]]+DII& 12 V$ 23 V$ 12 V$ u% V$ s# V$ v& V$ |,   1I r2c[R"5n[R"5UlUR S5 UR SS5 URSURR55 URR5 UR S5 URSURR55 g)z? Passing None as the password avoids sending the PASS command. 220 Welcome to Imaginary FTP.bobN USER bob s200 Hello bob.r2 rrrrKrrF queueLoginrr<rrBs r+test_noPasswordGiven(FTPClientBasicTests.test_noPasswordGiven s &&( +;;= ?@ UD) )*=*=*C*C*EF !!#01 i11779:r2c[R"5n[R"5UlUR S5 UR SS5 URSURR55 URR5 UR S5 URSURR55 g)zA Receiving a 230 response to USER prevents PASS from being sent. rOrPsecretrQs#230 Hello bob. No password needed.r2NrRrBs r+test_noPasswordNeeded)FTPClientBasicTests.test_noPasswordNeeded- s &&( +;;= ?@ UH- )*=*=*C*C*EF !!#EF i11779:r2rON) rRrSrTrUrrCrFrLrTrXrWrOr2r+r=r= s"E74 l;*;r2r=c\rSrSrSrSrSrg)PathHandlingTestsiD z Handling paths. c SS/4SS/4S/4S/SQ4S/SQ4SS/4SS/44H,upUR[R"/U5U5 M. S SS /4S SS /4S S /4S S /4S /SQ4S/SQ4SS S/4SS S/44H-upUR[R"S/U5U5 M/ S/4SS/4SS/4SSS /44H,upUR[R"/U5U5 M. S/4SS /4S/SQ44H-upUR[R"S/U5U5 M/ S/4S/4SS/4S/4SS/4SS/4SSS/4S SS/4S!S/4S"S/4S#/4S$/44 H-upUR[R"S/U5U5 M/ S%H3nUR[R[R/U5 M5 S&H4nUR[R[RS/U5 M6 g')(z Normalize paths. r0z/a/za/b/c)r0r1cz/a/b/cz/a/za/r1zb/z/bz/b/zb/czb/c/z/b/cr^z/b/c/z//z//aza//za//bz//bzb//c..../za/..xz/a/..z/a/b/..z/a/b/../z /a/b/../cz /a/b/../c/z /a/b/../../cz /a/b/../../c/z/a/b/../../c/..z/a/b/../../c/../) r_r`za/../..za/../../z/..z/../z/a/../..z /a/../../z /a/b/../../..)z../..z../../z ../a/../..N)rr toSegmentsro InvalidPath)r;inpoutps r+test_Normalizer!PathHandlingTests.test_NormalizerI sp 3%L C5M "I o &  ' SEN C5M IC   S^^B4d ; 3*  C:  C5M SEN O $ _ % c3Z sCj !  IC   S^^SE37 >  2J SEN SEN c3Z  IC   S^^B4d ;   *usenv6OPIC   S^^SE37 >Q2J BK cUO bM   #  3* % C: & cU # se $  #  $  IC   S^^SE37 >   C   coos~~r3 G  5C   coos~~uc J5r2rON)rRrSrTrUrrfrWrOr2r+r[r[D sDKr2r[c*\rSrSrSrSrSrSrSrg)IsGlobbingExpressionTestsi z3 Tests for _isGlobbingExpression utility function. cUR[R"55 UR[R"/55 UR[R"S55 g)zF _isGlobbingExpression will return False for None, or empty segments. Nrr_isGlobbingExpressionr:s r+&test_isGlobbingExpressionEmptySegments@IsGlobbingExpressionTests.test_isGlobbingExpressionEmptySegments sM 2245 22267 22489r2cUR[R"SS/55 UR[R"SS/55 g)z _isGlobbingExpression will return False for plain segments. Also, it only checks the last segment part (filename) and will not check the path name. rexpr*.txtNrkr:s r+test_isGlobbingExpressionNoGlob9IsGlobbingExpressionTests.test_isGlobbingExpressionNoGlob s@ 22Hf3EFG 22GV3DEFr2cUR[R"SS/55 UR[R"SS/55 UR[R"SS/55 g)z} _isGlobbingExpression will return True for segments which contains globbing characters in the last segment part (filename). rrqz [a-b].txtzfil?.txtN)rrrlr:s r+test_isGlobbingExpressionGlob7IsGlobbingExpressionTests.test_isGlobbingExpressionGlob sX 118W2EFG 118[2IJK 118Z2HIJr2rON) rRrSrTrUrrmrrrurWrOr2r+riri s:GKr2ric0\rSrSrSrSrSrSrSrSr g) BaseFTPRealmTestsi z} Tests for L{ftp.BaseFTPRealm}, a base class to help define L{IFTPShell} realms with different user home directory policies. c^UR[[[R55 g)z+ L{ftp.BaseFTPRealm} implements L{IRealm}. N)rrr r BaseFTPRealmr:s r+test_interface BaseFTPRealmTests.test_interface s  FC,<,<=>r2cz^^[R"UR55m/m"UU4SjS[R5nU"UR55nUR SS[R 5up4nURU[R5 URURT5 g)z L{ftp.BaseFTPRealm} calls its C{getHomeDirectory} method with the avatarId being requested to determine the home directory for that avatar. c$>\rSrSrUU4SjrSrg):BaseFTPRealmTests.test_getHomeDirectory..TestRealmi c*>TRU5 T$r7r)r;avatarIdavatarsrs r+getHomeDirectoryKBaseFTPRealmTests.test_getHomeDirectory..TestRealm.getHomeDirectory sx( r2rON)rRrSrTrUrrW)rrsr+ TestRealmr s   r2ralice@example.comN) rrrrrz requestAvatar IFTPShellr;FTPShellrfilesystemRoot)r;rrealmifaceavatarlogoutrrs @@r+test_getHomeDirectory'BaseFTPRealmTests.test_getHomeDirectory s ""4;;=1  ((  $++-( % 3 3 s}}! v fcll3 ..7r2cTUR5n[R"U5nUR[R S[R 5up4nURU[R5 URUR[R"U55 g)za L{ftp.BaseFTPRealm} returns an L{ftp.FTPAnonymousShell} instance for anonymous avatar requests. N) rrrzrr ANONYMOUSrr;r;rrrr)r;rurrrrs r+test_anonymous BaseFTPRealmTests.test_anonymous s~ KKM   + % 3 3   cmm! v fc&;&;< ..0A0A)0LMr2c[R"UR55nUR[UR [ 55 g)zy L{ftp.BaseFTPRealm.getHomeDirectory} should be overridden by a subclass and raises L{NotImplementedError} if it is not. N)rrzrroNotImplementedErrorrr)r;rs r+test_notImplemented%BaseFTPRealmTests.test_notImplemented s5   / -u/E/EvxPr2rON) rRrSrTrUrr{rrrrWrOr2r+rxrx s ? 8* NQr2rxc$\rSrSrSrSrSrSrg) FTPRealmTestsi z Tests for L{ftp.FTPRealm}. cSn[R"UR5U5nURS5nUR [ R "U5RS5U5 g)z L{ftp.FTPRealm} accepts an extra directory to its initializer and treats the avatarId passed to L{ftp.FTPRealm.getHomeDirectory} as a single path segment to construct a child of that directory. z /path/to/homerN)rrrrrrrr)r;baserhomes r+r#FTPRealmTests.test_getHomeDirectory sW  T[[]D1%%&9: **40667JKTRr2c[R"UR55nURS5nUR [ R "S5U5 g)z If no extra directory is passed to L{ftp.FTPRealm}, it uses C{"/home"} as the base directory containing all user home directories. rz/home/alice@example.comN)rrrrrrr)r;rrs r+test_defaultHomeDirectory'FTPRealmTests.test_defaultHomeDirectory sE  T[[]+%%&9: **+DEtLr2rON)rRrSrTrUrrrrWrOr2r+rr s SMr2rc(\rSrSrSr\rSrSrSr g)SystemFTPRealmTestsi z" Tests for L{ftp.SystemFTPRealm}. c"[R"5nSSKnURU5Rn[ R "UR55nURU5nURU[R"U55 g)z L{ftp.SystemFTPRealm.getHomeDirectory} treats the avatarId passed to it as a username in the underlying platform and returns that account's home directory. rN) getpassgetuserr,getpwnampw_dirrSystemFTPRealmrrrrr)r;rr,rrrs r+r)SystemFTPRealmTests.test_getHomeDirectory sj  <<%,,""4;;=1%%d+ x00:;r2c[R"[R5SR S[ S555-n[ R"UR55nUR[URU5 g)z L{ftp.SystemFTPRealm.getHomeDirectory} raises L{UnauthorizedLogin} when passed a username which has no corresponding home directory in the system's accounts database. rc3# UH:n[R"[R[R-5v M< g7fr7)randomchoicestring ascii_lettersdigits).0rzs r+ 6SystemFTPRealmTests.test_noSuchUser..% s.= IQAFMM&..> ? ?sAArN) rrrrrlrjrrrror r)r;rrs r+test_noSuchUser#SystemFTPRealmTests.test_noSuchUser sj}}V112RWW= INq= 6  ""4;;=1 +U-C-CTJr2rON) rRrSrTrUr nonPOSIXSkipr/rrrWrOr2r+rr s D<( Kr2rcB\rSrSrSrSrSrSrSrSr Sr S r S r g ) ErrnoToFailureTestsi, z1 Tests for L{ftp.errnoToFailure} errno checking. c[R"[RS5nUR U[R 5$)zC C{errno.ENOENT} should be translated to L{ftp.FileNotFoundError}. r)rerrnoToFailureerrnoENOENTrFileNotFoundErrorrs r+ test_notFound!ErrnoToFailureTests.test_notFound1 3   u||U 3!!!S%:%:;;r2c[R"[RS5nUR U[R 5$)zF C{errno.EPERM} should be translated to L{ftp.PermissionDeniedError}. r)rrrEPERMrPermissionDeniedErrorrs r+test_permissionDenied)ErrnoToFailureTests.test_permissionDenied8 s3   u{{E 2!!!S%>%>??r2c[R"[RS5nUR U[R 5$)zG C{errno.EACCES} should be translated to L{ftp.PermissionDeniedError}. r)rrrEACCESrrrs r+test_accessDenied%ErrnoToFailureTests.test_accessDenied? s3   u||U 3!!!S%>%>??r2c[R"[RS5nUR U[R 5$)zG C{errno.ENOTDIR} should be translated to L{ftp.IsNotADirectoryError}. r)rrrENOTDIRrIsNotADirectoryErrorrs r+test_notDirectory%ErrnoToFailureTests.test_notDirectoryF s3   u}}e 4!!!S%=%=>>r2c[R"[RS5nUR U[R 5$)zA C{errno.EEXIST} should be translated to L{ftp.FileExistsError}. r)rrrEEXISTrFileExistsErrorrs r+test_fileExists#ErrnoToFailureTests.test_fileExistsM s3   u||U 3!!!S%8%899r2c[R"[RS5nUR U[R 5$)zC C{errno.EISDIR} should be translated to L{ftp.IsADirectoryError}. r)rrrEISDIRrr(rs r+test_isDirectory$ErrnoToFailureTests.test_isDirectoryT rr2c[S5e![a0 [R"SS5nUR U[5s$f=f)zo If an unknown errno is passed to L{ftp.errnoToFailure}, it should let the originating exception pass through. rr r)r BaseExceptionrrrrs r+test_passThrough$ErrnoToFailureTests.test_passThrough[ sF  7u% % 7""2u-A%%a6 6 7s 7AArON) rRrSrTrUrrrrrrrrrWrOr2r+rr, s,<@@?:< 7r2rc\rSrSrSrSrSrg)AnonymousFTPShellTestsig z" Test anonymous shell properties. c[R"S5nURS5nURU[R5 U$)z\ Check that L{ftp.FTPAnonymousShell} returns an error when trying to open it in write mode. rr)rr;rrr)r;rr_s r+test_anonymousWrite*AnonymousFTPShellTests.test_anonymousWritel s? %%b)   * 1c778r2rON)rRrSrTrUrrrWrOr2r+rrg s r2rc\rSrSrSrSrSrSrS)SjrSr Sr S r S r S r S rS rSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSrSr Sr!S r"S!r#S"r$S#r%S$r&S%r'S&r(S'r)g()*IFTPShellTestsMixiniw z/ Generic tests for the C{IFTPShell} interface. c[5e)z Test if the directory exists at C{path}. @param path: the relative path to check. @type path: C{str}. @return: C{True} if C{path} exists and is a directory, C{False} if it's not the case @rtype: C{bool} rr;rs r+directoryExists#IFTPShellTestsMixin.directoryExists| "##r2c[5e)z Create a directory in C{path}. @param path: the relative path of the directory to create, with one segment. @type path: C{str} rrs r+r#IFTPShellTestsMixin.createDirectory s "##r2c[5e)z Test if the file exists at C{path}. @param path: the relative path to check. @type path: C{str}. @return: C{True} if C{path} exists and is a file, C{False} if it's not the case. @rtype: C{bool} rrs r+ fileExistsIFTPShellTestsMixin.fileExists rr2c[5e)z Create a file named C{path} with some content. @param path: the relative path of the file to create, without directory. @type path: C{str} @param fileContent: the content of the file. @type fileContent: C{str} rr;r fileContents r+ createFileIFTPShellTestsMixin.createFile rr2cURURS55 URS5 URURS55 g)z C{directoryExists} should report correctly about directory existence, and C{createDirectory} should create a directory detectable by C{directoryExists}. rN)rrrrr:s r+test_createDirectory(IFTPShellTestsMixin.test_createDirectory sB --e45 U# ,,U34r2cURURS55 URS5 URURS55 g)z C{fileExists} should report correctly about file existence, and C{createFile} should create a file detectable by C{fileExists}. file.txtN)rrrrr:s r+test_createFile#IFTPShellTestsMixin.test_createFile s< 45  #  34r2ch^TRRS5nU4SjnURU5$)z9 Create a directory and check it ends in the filesystem. rcF>TRTRS55 g)Nr)rrrs r+r2IFTPShellTestsMixin.test_makeDirectory..cb s OOD007 8r2)rrrrs` r+r&IFTPShellTestsMixin.test_makeDirectory s/ JJ $ $X . 9}}R  r2cURS5 URRS5nURU[R 5$)zU Creating a directory that already exists should fail with a C{ftp.FileExistsError}. rr)rrrrrrrs r+test_makeDirectoryError+IFTPShellTestsMixin.test_makeDirectoryError s? U# JJ $ $X .!!!S%8%899r2c^TRS5 TRRS5nU4SjnURU5$)zG Try to remove a directory and check it's removed from the filesystem. rrcF>TRTRS55 gr)rrrs r+r4IFTPShellTestsMixin.test_removeDirectory..cb s   T11%8 9r2)rrr,rrs` r+r-(IFTPShellTestsMixin.test_removeDirectory s= U# JJ & &x 0 :}}R  r2cURS5 URRS5nURU[R 5$)zV removeDirectory should not work in file and fail with a C{ftp.IsNotADirectoryError}. rr)rrr,rrrrs r+test_removeDirectoryOnFile.IFTPShellTestsMixin.test_removeDirectoryOnFile s=  # JJ & &} 5!!!S%=%=>>r2cxURRS5nURU[R5$)zT Removing directory that doesn't exist should fail with a C{ftp.FileNotFoundError}. r)rr,rrrrs r+test_removeNotExistingDirectory3IFTPShellTestsMixin.test_removeNotExistingDirectory s1 JJ & &x 0!!!S%:%:;;r2c^TRS5 TRRS5nU4SjnURU5 U$)zB Try to remove a file and check it's removed from the filesystem. rr cF>TRTRS55 gNr)rrrs r+r/IFTPShellTestsMixin.test_removeFile..cb s   T__Z8 9r2)rrrrrs` r+r#IFTPShellTestsMixin.test_removeFile s=  # JJ ! !- 0 : br2cURS5 URRS5nURU[R 5$)z* removeFile should not work on directory. nedr)rrrrrr(rs r+test_removeFileOnDirectory.IFTPShellTestsMixin.test_removeFileOnDirectory s? U# JJ ! !( +!!!S%:%:;;r2cxURRS5nURU[R5$)zT Try to remove a non existent file, and check it raises a L{ftp.FileNotFoundError}. r)rrrrrrs r+test_removeNotExistingFile.IFTPShellTestsMixin.test_removeNotExistingFiles1 JJ ! !( +!!!S%:%:;;r2c^TRS5 TRS5 TRRS5nU4SjnUR U5$)z& Check the output of the list method. rr.cV>UR5 TRUS/4S/4/5 g)Nrrrrrr;s r+r)IFTPShellTestsMixin.test_list..cbs* FFH   Q*b!1E2; ? @r2rrrrkrrs` r+ test_listIFTPShellTestsMixin.test_listsH U#  # JJOOF # A}}R  r2c^TRS5 TRS5 TRRSS5nU4SjnUR U5$)z, Check the output of list with asked stats. rrr)r permissionsc@>UR5 TR[U5S5 TRUSSS5 TRUSSS5 TR[USS5S5 TR[USS5S5 g)Nr|rrrr)rrr:r!s r+r1IFTPShellTestsMixin.test_listWithStat..cb*s FFH   SVQ '   QqT!Wj 1   QqT!We ,   S1a\1 -   S1a\1 -r2r#rs` r+test_listWithStat%IFTPShellTestsMixin.test_listWithStatsO U#  # JJOO    .}}R  r2cURS5 URRSS5nURU[5$)@ Querying an invalid stat should result to a C{AttributeError}. rrr whateverstat)rrrkrAttributeErrorrs r+test_listWithInvalidStat,IFTPShellTestsMixin.test_listWithInvalidStat6sA U# JJOO   !!!^44r2c^TRS5 TRRS5nU4SjnURU5$)z0 Check the output of the list method on a file. rr cP>UR5 TRUS/4/5 grr r!s r+r-IFTPShellTestsMixin.test_listFile..cbKs$ FFH   Q*b!1 2 3r2)rrrkrrs` r+ test_listFile!IFTPShellTestsMixin.test_listFileDs9  # JJOOM * 4}}R  r2cxURRS5nURU[R5$)zU list on a directory that doesn't exist should fail with a L{ftp.FileNotFoundError}. r)rrkrrrrs r+test_listNotExistingDirectory1IFTPShellTestsMixin.test_listNotExistingDirectoryQs/ JJOOH %!!!S%:%:;;r2c^URS5 URRS5nU$)z Try to access a resource. rr)rraccessrs r+ test_accessIFTPShellTestsMixin.test_accessYs+ U# JJ  h 'r2cxURRS5nURU[R5$)z6 access should fail on a resource that doesn't exist. r)rr<rrrrs r+test_accessNotFound'IFTPShellTestsMixin.test_accessNotFoundas1 JJ  h '!!!S%:%:;;r2c^TRS5 TRRS5nU4SjnURU5 U$)zI Check that openForReading returns an object providing C{ftp.IReadFile}. rr cb>TR[RRU55 gr7)rr IReadFile providedByrs r+r3IFTPShellTestsMixin.test_openForReading..cbos OOCMM44S9 :r2)rrrVrrs` r+test_openForReading'IFTPShellTestsMixin.test_openForReadinghs=  # JJ % %m 4 ; br2cxURRS5nURU[R5$)zZ openForReading should fail with a C{ftp.FileNotFoundError} on a file that doesn't exist. r)rrVrrrrs r+test_openForReadingNotFound/IFTPShellTestsMixin.test_openForReadingNotFoundus1 JJ % %h /!!!S%:%:;;r2cURS5 URRS5nURU[R 5$)z. openForReading should not work on directory. rr)rrrVrrr(rs r+test_openForReadingOnDirectory2IFTPShellTestsMixin.test_openForReadingOnDirectory}s? U# JJ % %h /!!!S%:%:;;r2c|^^TRRS5nUU4SjnU4SjmURU5 U$)zJ Check that openForWriting returns an object providing C{ftp.IWriteFile}. rc>TR[RRU55 UR 5R T5$r7)rr IWriteFilerEr)r)rcb2r;s r+cb14IFTPShellTestsMixin.test_openForWriting..cb1s5 OOCNN55c: ;;;=,,S1 1r2cP>TR[R"U55 gr7)rrrErs r+rR4IFTPShellTestsMixin.test_openForWriting..cb2s OOI005 6r2)rrr)r;r_rSrRs` @r+test_openForWriting'IFTPShellTestsMixin.test_openForWritings6 JJ % %h / 2 7 cr2cURS5 URRS5nURU[R 5$)zL openForWriting should not be able to open a directory that already exists. rr)rrrrrr(rs r+$test_openForWritingExistingDirectory8IFTPShellTestsMixin.test_openForWritingExistingDirectorys? U# JJ % %h /!!!S%:%:;;r2cURS5 URRS5nURU[R 5$)zs openForWring should fail with a L{ftp.FileNotFoundError} if you specify a file in a directory that doesn't exist. r)r idonotexistr)rrrrrrrs r+)test_openForWritingInNotExistingDirectory=IFTPShellTestsMixin.test_openForWritingInNotExistingDirectorys@ U# JJ % %&C D!!!S%:%:;;r2c^^SmTRST5 TRRSS5nUU4SjnURU5 U$)z0 Check the output of the stat method on a file. wobble rr rrcj>TRUS[T55 TRUS5 g)Nrr)rr:r)rrr;s r+r-IFTPShellTestsMixin.test_statFile..cbs.   SVS%5 6   SV $r2)rrstatr)r;r_rrs` @r+ test_statFile!IFTPShellTestsMixin.test_statFilesE"   K0 JJOOM+@ A % br2c^TRS5 TRRSS5nU4SjnURU5 U$)z5 Check the output of the stat method on a directory. rrrbc.>TRUS5 g)Nr)rrs r+r2IFTPShellTestsMixin.test_statDirectory..cbs OOCF #r2rrrerrs` r+test_statDirectory&IFTPShellTestsMixin.test_statDirectorys@ U# JJOOH&; < $ br2c^TRS5 TRRSS5nU4SjnURU5 U$)z# Check the owner and groups stats. rrrrc<>TR[U5S5 g)Nr|rrs r+r3IFTPShellTestsMixin.test_statOwnerGroup..cbs   SXq )r2rkrs` r+test_statOwnerGroup'IFTPShellTestsMixin.test_statOwnerGroups@ U# JJOOH&8 9 * br2c^^URRmSmUU4SjnXRlURS5 URRSS5nUR UR U5S/5 g)zj If L{twisted.python.filepath.FilePath.getNumberOfHardLinks} is not implemented, the number returned is 0 c[er7rrOr2r+raiseNotImplementedQIFTPShellTestsMixin.test_statHardlinksNotImplemented..raiseNotImplemented% %r2c&>T"U5nTUlU$r7)getNumberOfHardLinksrr0pathFuncrvs r+notImplementedFilePathTIFTPShellTestsMixin.test_statHardlinksNotImplemented..notImplementedFilePathsA%8A "Hr2rr) hardlinksrNr_pathrrersuccessResultOfr;r}r_r|rvs @@r+ test_statHardlinksNotImplemented4IFTPShellTestsMixin.test_statHardlinksNotImplementedsi ::## &  2  U# JJOOHn 5 --a01#6r2c^^URRmSmUU4SjnXRlURS5 URRSS5nUR UR U5SS/5 g)z If L{twisted.python.filepath.FilePath.getUserID} or L{twisted.python.filepath.FilePath.getGroupID} are not implemented, the owner returned is "0" and the group is returned as "0" c[er7rrOr2r+rvRIFTPShellTestsMixin.test_statOwnerGroupNotImplemented..raiseNotImplementedrxr2c4>T"U5nTUlTUlU$r7) getUserID getGroupIDr{s r+r}UIFTPShellTestsMixin.test_statOwnerGroupNotImplemented..notImplementedFilePathsA-AK.ALHr2rrro0Nrrs @@r+!test_statOwnerGroupNotImplemented5IFTPShellTestsMixin.test_statOwnerGroupNotImplementedsl ::## &  2  U# JJOOH&8 9 --a03*=r2czURRSS5nURU[R5$)zN stat should fail with L{ftp.FileNotFoundError} on a file that doesn't exist. rrb)rrerrrrs r+test_statNotExisting(IFTPShellTestsMixin.test_statNotExistings2 JJOOH&; <!!!S%:%:;;r2cURS5 URRSS5nURU[5$)r-rrr.)rrrerr0rs r+test_invalidStat$IFTPShellTestsMixin.test_invalidStats: U# JJOOH&> ?!!!^44r2c^TRS5 TRRSS5nU4SjnURU5$)z Try to rename a directory. rrrc>TRTRS55 TRTRS55 g)Nrr)rrrrs r+r+IFTPShellTestsMixin.test_rename..cbs3 OOD007 8   T11%8 9r2)rrrrrs` r+ test_renameIFTPShellTestsMixin.test_rename s? U# JJ  h 1 :}}R  r2czURRSS5nURU[R5$)zT Renaming a directory that doesn't exist should fail with L{ftp.FileNotFoundError}. rr)rrrrrrs r+test_renameNotExisting*IFTPShellTestsMixin.test_renameNotExistings3 JJ  h 1!!!S%:%:;;r2rONr2)*rRrSrTrUrrrrrrrrrr-r r rrrr$r*r1r6r9r=r@rGrJrMrWrZr^rfrlrrrrrrrrrWrOr2r+rrw s $$ $ $55 !: !?< << !!4 5 !<< << <<   7*>.<5 ! Unregister the producer, it should be done after a register. N)rr:s r+unregisterProducerTestConsumer.unregisterProducer`s}}((( r2cnURRU5 URR5 g)z6 Save the data received. @param data: data to append N)r]rCrrrJs r+rTestConsumer.writegs& 4  %%'r2)r]r) rRrSrTrUrrrrrrWrOr2r+rrHsH ((r2rc$\rSrSrSrSrSrSrg) TestProduceriqz A dumb producer. cXlX lg)z} @param toProduce: data to write @type toProduce: C{str} @param consumer: the consumer of data. @type consumer: C{IConsumer} N) toProducerO)r;rrOs r+r<TestProducer.__init__vs# r2cNURRUR5 g)z Send the data to consume. N)rOrrr:s r+startTestProducer.starts DNN+r2)rOrN)rRrSrTrUrr<rrWrOr2r+rrqs!,r2rc6\rSrSrSrSrSrSrSrSr Sr g ) IReadWriteTestsMixinizB Generic tests for the C{IReadFile} and C{IWriteFile} interfaces. c[5e)zg Return an object providing C{IReadFile}, ready to send data C{content}. @param content: data to send rr;contents r+ getFileReader"IReadWriteTestsMixin.getFileReaders "##r2c[5e)zB Return an object providing C{IWriteFile}, ready to receive data. rr:s r+ getFileWriter"IReadWriteTestsMixin.getFileWriter "##r2c[5e)z& Return the content of the file used. rr:s r+getFileContent#IReadWriteTestsMixin.getFileContentrr2c^^^^Sm[5mUU4SjnUUU4SjmTRT5RU5$)z Test L{ftp.IReadFile}: the implementation should have a send method returning a C{Deferred} which fires when all the data has been sent to the consumer, and the data should be correctly send to the consumer. racD>URT5RT5$r7)rPr)readercbSendrOs r+r-IReadWriteTestsMixin.test_read..cbGets;;x(44V< TRSRTR5T5 gr\)rrlr])rrOrr;s r+r.IReadWriteTestsMixin.test_read..cbSends   SXXhoo6 @r2)rrr)r;rrrOrs` @@@r+ test_readIReadWriteTestsMixin.test_reads: > = A!!'*66u==r2ct^^^^SmU4SjnUU4SjmUU4SjmTR5RU5$)z Test L{ftp.IWriteFile}: the implementation should have a receive method returning a C{Deferred} which fires with a consumer ready to receive data to be written. It should also have a close() method that returns a Deferred. selbbow cD>UR5RTU5$r7)r)r)writer cbReceives r+r.IReadWriteTestsMixin.test_write..cbGets>>#// 6B Br2c>[TU5nURSS5 UR5 UR5 UR 5R T5$)NT)rrrrr'r)rOrrcbClosers r+r2IReadWriteTestsMixin.test_write..cbReceivesL#GX6H  % %dD 1 NN   ' ' )<<>--g6 6r2cF>TRTR5T5 gr7)rr)rrr;s r+r0IReadWriteTestsMixin.test_write..cbCloses   T002G "7r2rc0\rSrSrSrSrSrSrSrSr g) FTPReadWriteTestsiz Tests for C{ftp._FileReader} and C{ftp._FileWriter}, the objects returned by the shell in C{openForReading}/C{openForWriting}. c[R"UR55UlURR 5 [ R "UR5UlSUlg)z% Create a temporary file used later. rN) rrrrrrrrrr:s r+rFTPReadWriteTests.setUpsG%%dkkm4  !!#\\$)), " r2cURRUR5RU5 URR UR45$)zF Return a C{ftp._FileReader} instance with a file opened for reading. )rrrrrrVrs r+rFTPReadWriteTests.getFileReaders?  &11':zz(($--)9::r2cNURRUR45$)zF Return a C{ftp._FileWriter} instance with a file opened for writing. )rrrr:s r+rFTPReadWriteTests.getFileWriters zz(($--)9::r2chURRUR5R5$)z+ Return the content of the temporary file. )rrr getContentr:s r+r FTPReadWriteTests.getFileContents$yyt}}-88::r2)rrrN) rRrSrTrUrrrrrrWrOr2r+rrs #;; ;r2rc(\rSrSrSrSrSrSrSrg)CloseTestWriteriz Close writing to a file. Fc[5Ul[R"UR5n[R "U5$)z& Receive bytes. @return: L{Deferred} )rr]r FileConsumerr r)r;fcs r+r)CloseTestWriter.receives0 i   dkk *}}R  r2c(SUlUR$)z$ Close bytes. @return: L{Deferred} T) closeStartedr_r:s r+r'CloseTestWriter.closes !vv r2)r]rN) rRrSrTrUrrr)r'rWrOr2r+rrsL!r2rc\rSrSrSrSrSrg)CloseTestShelli z Close writing shell. cB[R"UR5$r7)r rr)r;segss r+rCloseTestShell.openForWritings}}T[[))r2rON)rRrSrTrUrrrWrOr2r+rr s *r2rc\rSrSrSrSrSrg) FTPCloseTestsiz0 Tests that the server invokes IWriteFile.close cd[R"5nS/Ul[5Ul[ 5URl[R"5URR l [R"5Ul SURl UR[55 [R"5n[R "U5Ul X!lURS5 /nUR%S5nUR'UR(5 UR+URR R,S5 UR/S5 UR+URR R,S5 UR1S5 UR3URR R,S5 UR+U5 URR RR5S5 UR3U5 U$) zn Confirm that FTP uploads (i.e. ftp_STOR) correctly call and wait upon the IWriteFile object's close() method rNrzclose() called earlyssome data herezreason is ignoredzclose() not calledzallow close() to finish)rFTPworkingDirectoryrrrrr r^r_rr?timeOutrrrfrXrftp_STORrrCrrrcrhrrf)r;r0di stor_doner_s r+rFTPCloseTests.test_writesx GGI$X "(* >>+NN$    # WWY^^A&   $ JJv  i&&' 446LM )* 446LM -. 335IJ # !!";<  "r2rON)rRrSrTrUrrrWrOr2r+rrs !r2rc\rSrSrSrSrSrg)FTPResponseCodeTestsi;z, Tests relating directly to response codes. c [[R5n[5n[[5R 5Hup4[ U[ 5(dMUR5(dM3URUUSRX455 URUUSU<SU<35 URU5 M g)z All of the response code globals (for example C{RESTART_MARKER_REPLY} or C{USR_NAME_OK_NEED_PASS}) have unique values and are present in the C{RESPONSE} dictionary. z4Code {!r} with value {!r} missing from RESPONSE dictzDuplicate code z with value N) setrRESPONSEvarsitems isinstancernisupperrr[ assertNotInadd)r; allValues seenValueskeyr<s r+ test_unique FTPResponseCodeTests.test_unique@s  % U s)//+JC%%%#++-- JQQ  %cWL B u%,r2rON)rRrSrTrUrrrWrOr2r+r r ;s &r2r )rrH)\rrrrrrrriorzope.interfacerzope.interface.verifyr twisted.credrrrtwisted.cred.errorr twisted.cred.portalr twisted.internetr r r rrtwisted.internet.interfacesrtwisted.protocolsrrrtwisted.pythonrrr twisted.testrtwisted.test.testutilsrrtwisted.trial.unittestrplatform isWindowsrr,r.r1 LineReceiverr4rrYrqrsrrrr`rrrr/rOrzrrrrrrr=r[rirxrrrrrrrrrrrQrrrr rOr2r+r)s  &-660&BB12255&<+!!##L*L%245  E   ( **  *Y9Y9x ) 2W +W tp#4pfm,'8m,`  1Q &'G&&.X,'GX,vf 'Gf R~h~B":x":P ("" ( C33 J$(J$Z>>Bm.Xm.`u;(u;pIKIKXKKD4Q4QnMHM4&K(&KR87(87v X  h<h