U  W[n¤ã@sÖdZddlmZddlZddlZddlZddlmZddlm Z ddl m Z ddl m Z ddl mZdd l mZdd lmZdd lmZdd lmZdd lmZddlmZddlmZddlmZmZddlZ ddl Z ddl!Z ddl"Z ddl#Z ddl$Z Gdd„dej%ƒZ&Gdd„dej'j(ƒZ)Gdd„dƒZ*Gdd„dƒZ+Gdd„dej,ƒZ-Gdd„dej%ƒZ.Gdd„dej/ƒZ0Gdd „d ej1ƒZ2Gd!d"„d"ej%ƒZ3e ej4ƒGd#d$„d$ƒƒZ5Gd%d&„d&ƒZ6d'd(„Z7Gd)d*„d*ej%ƒZ8Gd+d,„d,ej%ƒZ9Gd-d.„d.ƒZ:Gd/d0„d0ej%ƒZ;Gd1d2„d2ƒZe=e?d4Z@d5ZAej>eAe?d4ZBGd6d7„d7ed?„d?eDƒZGGd@dA„dAe2ƒZHGdBdC„dCeCƒZIGdDdE„dEeDƒZJGdFdG„dGej%ƒZKdS)Hz, Test cases for Ltwisted.mail.pop3} module. é)Úprint_functionN)Ú OrderedDict)ÚBytesIO)Ú implementer)Úcred)Úinternet)Úmail)Údefer)Úpop3)Úloopback)Úfailure)Ú intToBytes)ÚLineSendingProtocol)ÚunittestÚutilc@s@eZdZdZdd„Zdd„Zdd„Zdd „Zd d „Zd d „Z dS)Ú UtilityTestszl Test the various helper functions and classes used by the POP3 server protocol implementation. c Csºg}tt ddddddg¡ƒ}t |j|d¡}t|ƒ}| |g¡t|ƒ| |g¡t|ƒ| |g¡t|ƒ| |dddg¡tdƒD] }t|ƒqŒ| |ddddddddg¡d S) zº Test creating a LineBuffer and feeding it some lines. The lines should build up in its internal buffer for a while and then get spat out to the writer. Z012Z345Ú6Ú7Ú8Ú9ééN) ÚiterÚ itertoolsÚcycler Ú_IteratorBufferÚextendÚ assertEqualÚnextÚrange)ÚselfÚoutputÚinputÚcÚiÚn©r&ú=/usr/lib/python3/dist-packages/twisted/mail/test/test_pop3.pyÚtest_LineBuffering+s      ÿzUtilityTests.test_LineBufferingcCsBg}tdddgƒ}t |j|d¡}|D]}q&| |dddg¡dS)z„ Test that a LineBuffer flushes everything when its iterator is exhausted, and itself raises StopIteration. ÚaÚbr#rN)rr rrr)r r!r"r#r$r&r&r'Útest_FinishLineBufferingBs z%UtilityTests.test_FinishLineBufferingcCs| t d¡d¡dS)zb Test that the thing that spits out POP3 'success responses' works right. sGreat.s +OK Great. N)rr ZsuccessResponse©r r&r&r'Útest_SuccessResponseFormatterOsþz*UtilityTests.test_SuccessResponseFormattercCsHtt g¡ƒd}| |d¡tt ddddg¡ƒd}| |d¡dS) zX Test that the function which formats stat lines does so appropriately. éÿÿÿÿs +OK 0 0 é ériu's +OK 4 10142 N)Úlistr ZformatStatResponser)r ZstatLiner&r&r'Útest_StatLineFormatterYs z#UtilityTests.test_StatLineFormatterc CsPtt g¡ƒ}| |ddg¡tt ddddg¡ƒ}| |ddd d d dg¡d S) z} Test that the function which formats the lines in response to a LIST command does so appropriately. ó+OK 0 ó. ééééds+OK 4 s1 1 s2 2 s3 3 s4 100 N)r1r ZformatListResponser)r Ú listLinesr&r&r'Útest_ListLineFormatterdsþ ÿþz#UtilityTests.test_ListLineFormattercCsŠdddg}tt g|j¡ƒ}| |ddg¡tt dddg|j¡ƒ}| |dd d d dg¡tt d d dg|j¡ƒ}| |dd d dg¡d S)zy Test that the function which formats lines in response to a UIDL command does so appropriately. ÚabcÚdefZghis+OK r4é{i¯iOs1 abc s2 def s3 ghi rN)r1r ZformatUIDListResponseÚ __getitem__r)r Zuidsr9r&r&r'Útest_UIDListLineFormatterus( þÿ þÿ þz&UtilityTests.test_UIDListLineFormatterN) Ú__name__Ú __module__Ú __qualname__Ú__doc__r(r+r-r2r:r?r&r&r&r'r%s   rc@seZdZdZdZdd„ZdS)Ú MyVirtualPOP3z2 A virtual-domain-supporting POP3 server. ócCs(| |¡\}}|jjd |||j|¡S)a7 Authenticate against a user against a virtual domain. @param user: The username. @param digest: The digested password. @return: A three-tuple like the one returned by L{IRealm.requestAvatar}. The mailbox will be for the user given by C{user}. óbaz.com)Z lookupDomainÚserviceÚdomainsÚauthenticateUserAPOPÚmagic)r ÚuserÚdigestÚdomainr&r&r'rI”s  ÿz"MyVirtualPOP3.authenticateUserAPOPN©r@rArBrCrJrIr&r&r&r'rDŽsrDc@s0eZdZdZdd„Zdd„Zdd„Zdd „Zd S) Ú DummyDomainz- A virtual domain for a POP3 server. cCs i|_dS©N©Úusersr,r&r&r'Ú__init__ªszDummyDomain.__init__cCsg|j|<dS)zV Create a mailbox for a new user. @param name: The username. NrQ)r Únamer&r&r'ÚaddUser®szDummyDomain.addUsercCs|j| |¡dS)zš Add a message to the mailbox of the named user. @param name: The username. @param message: The contents of the message. N)rRÚappend)r rTÚmessager&r&r'Ú addMessage·szDummyDomain.addMessagecCstjt|j|ƒdd„fS)ae Succeed with a L{ListMailbox}. @param name: The name of the user authenticating. @param digest: ignored @param magic: ignored @param domain: ignored @return: A three-tuple like the one returned by L{IRealm.requestAvatar}. The mailbox will be for the user given by C{name}. cSsdSrPr&r&r&r&r'ÚÎóz2DummyDomain.authenticateUserAPOP..)r ÚIMailboxÚ ListMailboxrR)r rTrLrJrMr&r&r'rIÁs z DummyDomain.authenticateUserAPOPN)r@rArBrCrSrUrXrIr&r&r&r'rO¥s   rOc@sBeZdZdZdd„Zddd„Zdd„Zd d „Zd d „Zd d„Z dS)r\z@ A simple in-memory list implementation of L{IMailbox}. cCs ||_dS)z, @param list: The messages. N©r1)r r1r&r&r'rSÖszListMailbox.__init__NcCs&|dkrdd„|jDƒSt|j|ƒS)ú™ Get some message information. @param i: See L{pop3.IMailbox.listMessages}. @return: See L{pop3.IMailbox.listMessages}. NcSsg|] }t|ƒ‘qSr&©Úlen)Ú.0Úlr&r&r'Ú åsz,ListMailbox.listMessages..)r1r`©r r$r&r&r'Ú listMessagesÝszListMailbox.listMessagescCst|j|ƒS©z Get the message content. @param i: See L{pop3.IMailbox.getMessage}. @return: See L{pop3.IMailbox.getMessage}. )rr1rdr&r&r'Ú getMessageészListMailbox.getMessagecCs|S)z¡ Construct a UID by using the given index value. @param i: See L{pop3.IMailbox.getUidl}. @return: See L{pop3.IMailbox.getUidl}. r&rdr&r&r'ÚgetUidlószListMailbox.getUidlcCsd|j|<dS©zm Wipe the message at the given index. @param i: See L{pop3.IMailbox.deleteMessage}. rZNr]rdr&r&r'Ú deleteMessageýszListMailbox.deleteMessagecCsdS)z= No-op. @see: L{pop3.IMailbox.sync} Nr&r,r&r&r'ÚsyncszListMailbox.sync)N) r@rArBrCrSrergrhrjrkr&r&r&r'r\Òs    r\c@s8eZdZdZdd„Zdd„Zdd„Zdd „Zd d „Zd S) ÚMyPOP3DownloaderzE A POP3 client which downloads all messages from the server. cCstj ||¡| dd¡dS)zK Authenticate. @param line: The welcome response. s hello@baz.comsworldN)r Ú POP3ClientÚhandle_WELCOMEZapop©r Úliner&r&r'rnszMyPOP3Downloader.handle_WELCOMEcCs<| ¡}|d}|dkr(td||fƒ‚g|_| d¡dS)zc Require an I{OK} response to I{APOP}. @param line: The I{APOP} response. ró+OKzcode is: %s , parts is: %s r5N)ÚsplitÚAssertionErrorÚlinesZretr)r rpÚpartsÚcoder&r&r'Ú handle_APOPs zMyPOP3Downloader.handle_APOPcCs|j |¡dS)zh Record one line of message information. @param line: A I{RETR} response line. N)rtrVror&r&r'Úhandle_RETR_continue+sz%MyPOP3Downloader.handle_RETR_continuecCsd |j¡d|_| ¡dS)z: Record the received message information. ó N)ÚjoinrtrWÚquitr,r&r&r'Úhandle_RETR_end4sz MyPOP3Downloader.handle_RETR_endcCs |dd…dkrtd|ƒ‚dS)zc Require an I{OK} response to I{QUIT}. @param line: The I{QUIT} response. Nr7rqscode is )rsror&r&r'Ú handle_QUIT<szMyPOP3Downloader.handle_QUITN) r@rArBrCrnrwrxr|r}r&r&r&r'rls   rlc@sXeZdZdZdZdeeeƒƒdZdd„Zdd„Z d d „Z e j d d ge _ d d„Z dS)Ú POP3Testsz! Tests for L{pop3.POP3}. s-Subject: urgent Someone set up us the bomb! s>+OK +OK Authentication succeeded +OK 1 0 . +OK s; Subject: urgent Someone set up us the bomb! . +OK cCsNtj ¡|_i|j_tƒ|jjd<|jjd d¡|jjd d|j¡dS)zC Set up a POP3 server with virtual domain support. rFshelloN) rÚprotocolÚFactoryÚfactoryrHrOrUrXrWr,r&r&r'ÚsetUp`s  zPOP3Tests.setUpcs>tddddgƒ‰tƒ}ˆj|_‡‡fdd„}t |ˆ¡ |¡S)zL Messages can be downloaded over a loopback TCP connection. sAPOP hello@baz.com worldóUIDLóRETR 1óQUITcs"d ˆj¡d}ˆ |ˆj¡dS)Nó )rzÚresponserÚexpectedOutput)Úignoredr!©Úclientr r&r'Úcheckwsz&POP3Tests.test_messages..check)rrDrrGr Z loopbackTCPÚ addCallback)r ÚserverrŒr&rŠr'Ú test_messagesksüzPOP3Tests.test_messagescs:tƒ‰ˆjˆ_tƒ‰‡‡‡fdd„}t ˆˆ¡}| |¡S)zH Messages can be downloaded over a loopback connection. cs(ˆ ˆjˆj¡ˆ t tdƒ¡¡dS)NúTest harness disconnect)rrWÚconnectionLostr ÚFailureÚ Exception)r‰©ZclientProtocolrr r&r'rŒ„s ÿz&POP3Tests.test_loopback..check)rDrrGrlr Ú loopbackAsyncr)r rŒÚdr&r”r'Ú test_loopback}s  zPOP3Tests.test_loopbackz*twisted.mail.pop3.POP3Client is deprecated)rWcCsRtj ¡}i|_tƒ|jd<tƒ}||_| tj |j dd¡}|  |j dd¡dS)zP Look up a user in a domain which this server does not support. stwistedmatrix.comsnobody@baz.comspasswordrzno such domain baz.comN) rrr€rHrOrDrGZ assertRaisesr Ú POP3ErrorrIrÚargs)r rrŽÚexcr&r&r'Útest_incorrectDomainŽs  ÿzPOP3Tests.test_incorrectDomainN)r@rArBrCrWr r`rˆr‚rr—rÚsuppressr›r&r&r&r'r~Gs úú  ÿ r~c@seZdZdZdZdd„ZdS)Ú DummyPOP3zF A simple POP3 server with a hard-coded mailbox for any user. rEcCstjttƒdd„fS)zÎ Succeed with a L{DummyMailbox}. @param user: ignored @param password: ignored @return: A three-tuple like the one returned by L{IRealm.requestAvatar}. cSsdSrPr&r&r&r&r'rY®rZz0DummyPOP3.authenticateUserAPOP..)r r[Ú DummyMailboxÚ ValueError)r rKZpasswordr&r&r'rI¤s zDummyPOP3.authenticateUserAPOPNrNr&r&r&r'ržsrc@s@eZdZdZdgZdd„Zddd„Zdd „Zd d „Zd d „Z dS)ržzý An in-memory L{pop3.IMailbox} implementation. @ivar messages: A sequence of L{bytes} defining the messages in this mailbox. @ivar exceptionType: The type of exception to raise when an out-of-bounds index is addressed. s,From: moshe To: moshe How are you, friend? cCstjdd…|_||_dSrP)ržÚmessagesÚ exceptionType)r r¡r&r&r'rS¾szDummyMailbox.__init__NcCs<|dkrdd„|jDƒS|t|jƒkr.| ¡‚t|j|ƒS)r^NcSsg|] }t|ƒ‘qSr&r_)raÚmr&r&r'rcËsz-DummyMailbox.listMessages..)r r`r¡rdr&r&r'reÃs zDummyMailbox.listMessagescCst|j|ƒSrf)rr rdr&r&r'rgÑszDummyMailbox.getMessagecCs|t|jƒkr| ¡‚t|ƒS)zÇ Construct a UID which is simply the string representation of the given index. @param i: See L{pop3.IMailbox.getUidl}. @return: See L{pop3.IMailbox.getUidl}. )r`r r¡r rdr&r&r'rhÛszDummyMailbox.getUidlcCsd|j|<dSri)r rdr&r&r'rjèszDummyMailbox.deleteMessage)N) r@rArBrCr rSrergrhrjr&r&r&r'rž²s    ržc@sheZdZdZdd„Zdd„Zdd„Zdd „Zd d „Zd d „Z dd„Z dd„Z dd„Z dd„Z dd„ZdS)ÚAnotherPOP3Testsz( Additional L{pop3.POP3} tests. cCs,tƒ}t|ƒ}t ||¡}| |j|||¡S)aÅ Assert that when C{lines} are delivered to L{pop3.POP3} it responds with C{expectedOutput}. @param lines: A sequence of L{bytes} representing lines to deliver to the server. @param expectedOutput: A sequence of L{bytes} representing the expected response from the server. @return: A L{Deferred} that fires when the lines have been delivered and the output checked. )rrr r•rÚ _cbRunTest)r rtrˆÚdummyr‹r–r&r&r'ÚrunTestös zAnotherPOP3Tests.runTestcCs2| d |¡d |j¡¡| t tdƒ¡¡|S)Nr†r©rrzr‡r‘r r’r“©r r‰r‹r¥rˆr&r&r'r¤ s  ÿÿzAnotherPOP3Tests._cbRunTestcCs@| ddddddddgdd d d d d dd dddddd dd dd g¡S)a4 Test a lot of different POP3 commands in an extremely pipelined scenario. This test may cover legitimate behavior, but the intent and granularity are not very good. It would likely be an improvement to split it into a number of smaller, more focused tests. sAPOP moshez dummyóLISTrƒr„óRETR 2sDELE 1r…ó +OK ó+OK Authentication succeededs+OK 1s1 44ó.ó+OK s1 0s+OK 44s From: moshes To: mosherZsHow are you, friend?s -ERR Bad message number arguments-ERR message deleted©r¦r,r&r&r'Ú test_buffers< ùï÷zAnotherPOP3Tests.test_buffercCs| dddgddddg¡S)z) Test the no-op command. sAPOP spiv dummysNOOPr…r«r¬r®r¯r,r&r&r'Ú test_noop8sþýüzAnotherPOP3Tests.test_noopcCsHtƒ}tj ¡|_ddddœ|j_tddgƒ}t ||¡}|  |j |¡S)zš L{pop3.POP3} responds to an I{AUTH} command with a list of supported authentication types based on its factory's C{challengers}. N)sAuth1s secondAuthsauthLastsAUTHr…) rrrr€rÚ challengersrr r•rÚ_cbTestAuthListing)r Úpr‹r–r&r&r'Útest_authListingFs ÿ þ z!AnotherPOP3Tests.test_authListingcCsL| |jd d¡¡| t|jdd…ƒdddg¡| |jdd¡dS) Nr5rqr6rsAUTH1sAUTHLASTs SECONDAUTHr­)Ú assertTruer‡Ú startswithrÚsorted)r r‰r‹r&r&r'r³Xs ÿz#AnotherPOP3Tests._cbTestAuthListingcCs.tƒ}tddgƒ}t ||¡}| |j||¡S)z‘ L{pop3.POP3} handles a I{PASS} command before a I{USER} command with an error indicating the out-of-sequence operation. s PASS foozr…)rrr r•rÚ_cbTestIllegalPASS©r r¥r‹r–r&r&r'Útest_illegalPASS_sþ z!AnotherPOP3Tests.test_illegalPASScCs4d}| |d |j¡d¡| t tdƒ¡¡dS©Ns4+OK -ERR USER required before PASS +OK r†rr§r¨r&r&r'r¹msÿÿÿz#AnotherPOP3Tests._cbTestIllegalPASScCs.tƒ}tddgƒ}t ||¡}| |j||¡S)z| L{pop3.POP3} handles a I{PASS} command with a password equal to C{""} as it would any other value. sPASS r…)rrr r•rÚ_cbTestEmptyPASSrºr&r&r'Útest_emptyPASSvsþ zAnotherPOP3Tests.test_emptyPASScCs4d}| |d |j¡d¡| t tdƒ¡¡dSr¼r§r¨r&r&r'r½„sÿÿÿz!AnotherPOP3Tests._cbTestEmptyPASScCsVtdƒ}t|tƒs| d¡}| ddgdd|dg¡}| tj¡}| t |ƒd¡|S) zi Sending a command with invalid UTF-8 characters will raise a L{pop3.POP3Error}. s&not authenticated yet: cannot do PASSzutf-8sPASSr…r«s(-ERR bad protocol or server: POP3Error: r®r5) ÚstrÚ isinstanceÚbytesÚencoder¦ZflushLoggedErrorsr r˜rr`)r Úerrorr–Úerrorsr&r&r'Útest_badUTF8CharactersInCommands"  ÿÿýý z0AnotherPOP3Tests.test_badUTF8CharactersInCommandN)r@rArBrCr¦r¤r°r±rµr³r»r¹r¾r½rÅr&r&r&r'r£òs&  r£c@sLeZdZdZdd„Zdd„ZeddgƒZdd „Zd Z d d „Z d Z d d„Z dS)ÚTestServerFactoryz÷ A L{pop3.IServerFactory} implementation, for use by the test suite, with some behavior controlled by the values of (settable) public attributes and other behavior based on values hard-coded both here and in some test methods. cCsdS)úW Return the hard-coded value. @return: L{pop3.IServerFactory} zTest Implementation Stringr&r,r&r&r'Úcap_IMPLEMENTATIONªsz$TestServerFactory.cap_IMPLEMENTATIONcCsdS)rÇé<r&r,r&r&r'Ú cap_EXPIRE³szTestServerFactory.cap_EXPIRE)sSCHEME_1N)sSCHEME_2NcCsdS)rÇéxr&r,r&r&r'Úcap_LOGIN_DELAY½sz!TestServerFactory.cap_LOGIN_DELAYTcCs|jS©rÇ)Úpuer,r&r&r'ÚperUserExpirationÆsz#TestServerFactory.perUserExpirationcCs|jSrÍ)Úpuldr,r&r&r'ÚperUserLoginDelayÏsz#TestServerFactory.perUserLoginDelayN) r@rArBrCrÈrÊrr²rÌrÎrÏrÐrÑr&r&r&r'rÆ¢s  rÆc@seZdZdZdZdZdS)Ú TestMailboxz× An incomplete L{IMailbox} implementation with certain per-user values hard-coded and known by tests in this module. This is useful for testing the server's per-user capability implementation. r8éN)r@rArBrCZ loginDelayZmessageExpirationr&r&r&r'rÒÙsrÒcGs|D]}| ||¡qdS)aG Assert that the given capability is included in all of the capability sets. @param testcase: A L{unittest.TestCase} to use to make assertions. @param s: The capability for which to check. @type s: L{bytes} @param caps: The capability sets in which to check. @type caps: L{tuple} of iterable N)ÚassertIn)ZtestcaseÚsÚcapsr#r&r&r'Ú containedçs r×c@sPeZdZdZdd„Zdd„Zdd„Zdd „Zd d „Zd d „Z dd„Z dd„Z dS)ÚCapabilityTestsz@ Tests for L{pop3.POP3}'s per-user capability handling. cCs–tƒ}t ¡}tƒ|_tj |¡|_|  ¡|  ¡|  ¡|_ |  ¡ ¡|_tƒ}tƒ|_tj |¡|_|  ¡|  ¡ ¡|_| t tdƒ¡¡dS)ú> Create a POP3 server with some capabilities. rN)rr ÚPOP3rÆrrrÚ FileWrapperÚ transportÚconnectionMadeÚdo_CAPAÚlistCapabilitiesrÖÚgetvalueÚ splitlinesÚpcapsrÒÚmboxÚlpcapsr‘r r’r“©r rÕr´r&r&r'r‚ýs zCapabilityTests.setUpcCst|d|j|j|jƒdS)zB The server can advertise the I{UIDL} capability. rƒN©r×rÖrârär,r&r&r'Ú test_UIDLszCapabilityTests.test_UIDLcCst|d|j|j|jƒdS)zA The server can advertise the I{TOP} capability. sTOPNrær,r&r&r'Útest_TOPszCapabilityTests.test_TOPcCst|d|j|j|jƒdS)zB The server can advertise the I{USER} capability. sUSERNrær,r&r&r'Ú test_USER"szCapabilityTests.test_USERcCs$t|d|j|jƒt|d|jƒdS)zj The server can advertise its per-user expiration as well as a global expiration. sEXPIRE 60 USERs EXPIRE 25Nrær,r&r&r'Ú test_EXPIRE)szCapabilityTests.test_EXPIREcCst|d|j|j|jƒdS)zE The server can advertise its implementation string. s)IMPLEMENTATION Test Implementation StringNrær,r&r&r'Útest_IMPLEMENTATION2sýz#CapabilityTests.test_IMPLEMENTATIONcCst|d|j|j|jƒdS)zH The server can advertise the SASL schemes it supports. sSASL SCHEME_1 SCHEME_2Nrær,r&r&r'Ú test_SASL=sýzCapabilityTests.test_SASLcCs$t|d|j|jƒ| d|j¡dS)zc The can advertise a per-user login delay as well as a global login delay. sLOGIN-DELAY 120 USERsLOGIN-DELAY 100N)r×rÖrârÔrär,r&r&r'Útest_LOGIN_DELAYHsz CapabilityTests.test_LOGIN_DELAYN) r@rArBrCr‚rçrèrérêrërìrír&r&r&r'rØùs   rØc@s(eZdZdZdd„Zdd„Zdd„ZdS) ÚGlobalCapabilitiesTestsz> Tests for L{pop3.POP3}'s global capability handling. cCs¦tƒ}t ¡}tƒ|_d|j_|j_tj  |¡|_ |  ¡|  ¡|  ¡|_| ¡ ¡|_tƒ}tƒ|_tj  |¡|_ |  ¡| ¡ ¡|_| t tdƒ¡¡dS)rÙFrN)rr rÚrÆrrÎrÐrrrÛrÜrÝrÞrßrÖràrárârÒrãrär‘r r’r“rår&r&r'r‚Vs zGlobalCapabilitiesTests.setUpcCst|d|j|j|jƒdS)zG I{EXPIRE} is in the server's advertised capabilities. s EXPIRE 60Nrær,r&r&r'rênsz#GlobalCapabilitiesTests.test_EXPIREcCst|d|j|j|jƒdS)zL I{LOGIN-DELAY} is in the server's advertised capabilities. sLOGIN-DELAY 120Nrær,r&r&r'ríusz(GlobalCapabilitiesTests.test_LOGIN_DELAYN)r@rArBrCr‚rêrír&r&r&r'rîRsrîc@seZdZdZdd„ZdS)Ú TestRealmzI An L{IRealm} which knows about a single test account's mailbox. cGs(|dkrtjttƒdd„fSds$t‚dS)aE Retrieve a mailbox for I{testuser} or fail. @param avatarId: See L{IRealm.requestAvatar}. @param mind: See L{IRealm.requestAvatar}. @param interfaces: See L{IRealm.requestAvatar}. @raises: L{AssertionError} when requesting an C{avatarId} other than I{testuser}. ótestusercSsdSrPr&r&r&r&r'rYrZz)TestRealm.requestAvatar..FN)r r[ržrŸrs)r ZavatarIdZmindZ interfacesr&r&r'Ú requestAvatars zTestRealm.requestAvatarN)r@rArBrCrñr&r&r&r'rï}srïc@seZdZdZdd„ZdS)Ú SASLTestsz7 Tests for L{pop3.POP3}'s SASL implementation. cCs0t ¡}tƒ|_dtjji|j_tj  t ƒ¡|_tj   ¡}|  dd¡|j |¡tƒ}tj |¡|_| ¡| d¡| | ¡ d¡dk¡| d¡| ¡ ¡dd d …}t |¡}t d|¡ ¡ d ¡}| t  d |¡ !d ¡¡| |j"¡| | ¡ ¡d d¡dk¡| #t$ %t&dƒ¡¡d S)z A CRAM-MD5-based SASL login attempt succeeds if it uses a username and a hashed password known to the server's credentials checker. sCRAM-MD5rðs testpasswordsCAPAs SASL CRAM-MD5rs AUTH CRAM-MD5r.r6NÚasciis testuser ryrqr)'r rÚrÆrrZ credentialsZCramMD5Credentialsr²ZportalZPortalrïZcheckersZ'InMemoryUsernamePasswordDatabaseDontUserUZregisterCheckerrrrrÛrÜrÝÚ lineReceivedr¶ràÚfindráÚbase64Z decodestringÚhmacZHMACZ hexdigestrÂZ encodestringÚrstriprãr‘r r’r“)r r´ZchrÕZchalr‡r&r&r'Útest_ValidLogin–s0ÿ      ÿ  zSASLTests.test_ValidLoginN)r@rArBrCrùr&r&r&r'rò’sròc@sœeZdZdZdZdd„Zdd„Zdd„Zd d „Zd d „Z d d„Z dd„Z dd„Z dd„Z dd„Zdd„Zdd„Zdd„Zdd„Zdd „Zd!d"„Zd#d$„Zd%S)&Ú CommandMixinzI Tests for all the commands a POP3 server is allowed to receive. s1From: guy To: fellow More message text for you. cCs\t ¡}| |j¡|_t|_||_tƒ}t j   |¡|_ |  ¡| d¡| d¡||_dS)zŽ Make a POP3 server protocol instance hooked up to a simple mailbox and a transport that buffers output to a BytesIO. rN)r rÚÚ mailboxTyper¡rãr1ZscheduleÚ pop3ServerrrrrÛrÜrÝÚseekÚtruncateÚ pop3Transport©r r´rÕr&r&r'r‚Ås  zCommandMixin.setUpcCs|j t tdƒ¡¡dS)zo Disconnect the server protocol so it can clean up anything it might need to clean up. rN)rür‘r r’r“r,r&r&r'ÚtearDown×s ÿzCommandMixin.tearDowncCs|jj ¡dS)zz Do some of the things that the reactor would take care of, if the reactor were actually running. N)rürÜZ_checkProducerr,r&r&r'Ú_flushàszCommandMixin._flushcCsh|j}|j}| d¡| ¡| | ¡d¡| d¡| d¡| d¡| ¡| | ¡d¡dS)zé Test the two forms of list: with a message index number, which should return a short-form response, and without a message index number, which should return a long-form response, one line per message. sLIST 1ó +OK 1 44 rr©s+OK 1 1 44 . N©rürÿrôrrràrýrþrr&r&r'Ú test_LISTés    zCommandMixin.test_LISTcCsš|j}|j}| d¡| | ¡d¡| d¡| d¡| d¡| | ¡d¡| d¡| d¡| d¡| | ¡d¡| d¡| d¡dS) zo Test that non-integers and out-of-bound integers produce appropriate error responses. sLIST as -ERR Invalid message-number: a rsLIST 0s -ERR Invalid message-number: 0 sLIST 2s -ERR Invalid message-number: 2 N©rürÿrôrràrýrþrr&r&r'Útest_LISTWithBadArgumentýs. þ   þ   þ z%CommandMixin.test_LISTWithBadArgumentcCs`|j}|j}| d¡| | ¡d¡| d¡| d¡| d¡| ¡| | ¡d¡dS)zy Test the two forms of the UIDL command. These are just like the two forms of the LIST command. sUIDL 1r3rrƒs+OK 1 0 . N)rürÿrôrràrýrþrrr&r&r'rçs    zCommandMixin.test_UIDLcCsš|j}|j}| d¡| | ¡d¡| d¡| d¡| d¡| | ¡d¡| d¡| d¡| d¡| | ¡d¡| d¡| d¡dS)z€ Test that UIDL with a non-integer or an out-of-bounds integer produces the appropriate error response. sUIDL aó"-ERR Bad message number argument rsUIDL 0sUIDL 2Nrrr&r&r'Útest_UIDLWithBadArgument-s. þ   þ   þ z%CommandMixin.test_UIDLWithBadArgumentcCs2|j}|j}| d¡| ¡| | ¡d¡dS)z¦ Test the single form of the STAT command, which returns a short-form response of the number of messages in the mailbox and their total size. sSTATrN)rürÿrôrrràrr&r&r'Ú test_STATKs  zCommandMixin.test_STATcCsF|j}|j}| d¡| ¡| | ¡d¡| d¡| d¡dS)z- Test downloading a message. r„s;+OK 44 From: moshe To: moshe How are you, friend? . rNrrr&r&r'Ú test_RETRXs þ zCommandMixin.test_RETRcCsš|j}|j}| d¡| | ¡d¡| d¡| d¡| d¡| | ¡d¡| d¡| d¡| d¡| | ¡d¡| d¡| d¡dS)z» Test that trying to download a message with a bad argument, either not an integer or an out-of-bounds integer, fails with the appropriate error response. sRETR arrsRETR 0rªNrrr&r&r'Útest_RETRWithBadArgumentms. þ   þ   þ z%CommandMixin.test_RETRWithBadArgumentcCsB|j}|j}|jj |j¡| d¡| ¡| |  ¡d¡dS)zQ Test downloading the headers and part of the body of a message. sTOP 1 0s9+OK Top of message follows From: moshe To: moshe . N) rürÿrãr rVÚ extraMessagerôrrràrr&r&r'rèŒs þzCommandMixin.test_TOPcCs|j}|j}|jj |j¡| d¡| | ¡d¡|  d¡|  d¡| d¡| | ¡d¡|  d¡|  d¡| d¡| | ¡d¡|  d¡|  d¡| d¡| | ¡d¡|  d¡|  d¡| d¡| | ¡d¡|  d¡|  d¡d S) a$ Test that trying to download a message with a bad argument, either a message number which isn't an integer or is an out-of-bounds integer or a number of lines which isn't an integer or is a negative integer, fails with the appropriate error response. sTOP 1 as-ERR Bad line count argument rsTOP 1 -1sTOP a 1rsTOP 0 1sTOP 3 1N© rürÿrãr rVr rôrràrýrþrr&r&r'Útest_TOPWithBadArgumentŸsL þ   þ   þ   þ   þ z$CommandMixin.test_TOPWithBadArgumentcCsN|j}|j}|jj |j¡| d¡| | ¡d¡|  d¡|  d¡dS)z“ Test the exceedingly pointless LAST command, which tells you the highest message index which you have already downloaded. óLASTr3rNrrr&r&r'Ú test_LASTÎs þ zCommandMixin.test_LASTcCst|j}|j}|jj |j¡| d¡| ¡| d¡|  d¡| d¡|  |  ¡d¡| d¡|  d¡dS)zM Test that issuing a RETR command updates the LAST response. rªrró+OK 2 N© rürÿrãr rVr rôrrýrþrràrr&r&r'Útest_RetrieveUpdatesHighestßs    þ z(CommandMixin.test_RetrieveUpdatesHighestcCs`|j}|j}|jj |j¡| d¡| ¡| d¡|  d¡| d¡|  |  ¡d¡dS)zL Test that issuing a TOP command updates the LAST response. sTOP 2 10rrrNrrr&r&r'Útest_TopUpdatesHighestós    þz#CommandMixin.test_TopUpdatesHighestcCsr|j}|j}|jj |j¡| d¡| ¡| d¡| ¡| d¡|  d¡| d¡|  |  ¡d¡dS)z Test that downloading a message with a smaller index than the current LAST response doesn't change the LAST response. rªsTOP 1 10rrrNrrr&r&r'Útest_HighestOnlyProgressess     þz'CommandMixin.test_HighestOnlyProgressescCsj|j}|j}|jj |j¡| d¡| ¡| d¡| d¡|  d¡| d¡|  |  ¡d¡dS)zH Test that issuing RSET changes the LAST response to 0. rªsRSETrrr3Nrrr&r&r'Útest_ResetClearsHighests     þz$CommandMixin.test_ResetClearsHighestN)r@rArBrCr r‚rrrrrçr r r r rèrrrrrrr&r&r&r'rú¸s&   /rúz}twisted.mail.pop3.IMailbox.listMessages may not raise IndexError for out-of-bounds message numbers: raise ValueError instead.)rWÚcategoryzxtwisted.mail.pop3.IMailbox.getUidl may not raise IndexError for out-of-bounds message numbers: raise ValueError instead.c@sXeZdZdZeZeZdd„Ze ge_ dd„Z e ge _ dd„Z e ge _ dd „Ze ge_ d S) ÚIndexErrorCommandTestsz» Run all of the command tests against a mailbox which raises IndexError when an out of bounds request is made. This behavior will be deprecated shortly and then removed. cCs t |¡S)z· An attempt to get metadata about a message with a bad argument fails with an I{ERR} response even if the mailbox implementation raises L{IndexError}. )rúrr,r&r&r'rGsz/IndexErrorCommandTests.test_LISTWithBadArgumentcCs t |¡S)z· An attempt to look up the UID of a message with a bad argument fails with an I{ERR} response even if the mailbox implementation raises L{IndexError}. )rúr r,r&r&r'r Qsz/IndexErrorCommandTests.test_UIDLWithBadArgumentcCs t |¡S)zµ An attempt to download some of a message with a bad argument fails with an I{ERR} response even if the mailbox implementation raises L{IndexError}. )rúrr,r&r&r'r[sz.IndexErrorCommandTests.test_TOPWithBadArgumentcCs t |¡S)z­ An attempt to download a message with a bad argument fails with an I{ERR} response even if the mailbox implementation raises L{IndexError}. )rúr r,r&r&r'r esz/IndexErrorCommandTests.test_RETRWithBadArgumentN)r@rArBrCÚ IndexErrorr¡ržrûrÚ_listMessageSuppressionrœr Ú_getUidlSuppressionrr r&r&r&r'r>src@seZdZdZeZeZdS)ÚValueErrorCommandTestsa Run all of the command tests against a mailbox which raises ValueError when an out of bounds request is made. This is the correct behavior and after support for mailboxes which raise IndexError is removed, this will become just C{CommandTestCase}. N)r@rArBrCrŸr¡ržrûr&r&r&r'rpsrc@seZdZdZddd„ZdS)ÚSyncDeferredMailboxzo Mailbox which has a listMessages implementation which returns a Deferred which has already fired. NcCst t ||¡¡S)zÏ Synchronously list messages. @type n: L{int} or L{None} @param n: The 0-based index of the message. @return: A L{Deferred} which already has a message list result. )r Zsucceedržre)r r%r&r&r'res z SyncDeferredMailbox.listMessages)N)r@rArBrCrer&r&r&r'r|src@seZdZdZeZdS)Ú"IndexErrorSyncDeferredCommandTestsz{ Run all of the L{IndexErrorCommandTests} tests with a synchronous-Deferred returning IMailbox implementation. N©r@rArBrCrrûr&r&r&r'rŽsrc@seZdZdZeZdS)Ú"ValueErrorSyncDeferredCommandTestsz{ Run all of the L{ValueErrorCommandTests} tests with a synchronous-Deferred returning IMailbox implementation. Nr r&r&r&r'r!—sr!c@s"eZdZdZdd„Zddd„ZdS)ÚAsyncDeferredMailboxzo Mailbox which has a listMessages implementation which returns a Deferred which has not yet fired. cOsg|_tj|f|ž|ŽdSrP)ÚwaitingržrS)r r)Úkwr&r&r'rS¥szAsyncDeferredMailbox.__init__NcCs$t ¡}|j |t ||¡f¡|S)zÎ Record a new unfired L{Deferred} in C{self.waiting} and return it. @type n: L{int} or L{None} @param n: The 0-based index of the message. @return: The L{Deferred} )r ZDeferredr#rVržre)r r%r–r&r&r'reªs z!AsyncDeferredMailbox.listMessages)N)r@rArBrCrSrer&r&r&r'r" sr"c@seZdZdZeZdd„ZdS)Ú#IndexErrorAsyncDeferredCommandTestsú} Run all of the L{IndexErrorCommandTests} tests with an asynchronous-Deferred returning IMailbox implementation. cCs6|jjjr(|jjj ¡\}}| |¡qt |¡dS©zH Fire whatever Deferreds we've built up in our mailbox. N)rürãr#ÚpopÚcallbackrr©r r–r)r&r&r'rÁs  z*IndexErrorAsyncDeferredCommandTests._flushN©r@rArBrCr"rûrr&r&r&r'r%ºsr%c@seZdZdZeZdd„ZdS)Ú#ValueErrorAsyncDeferredCommandTestsr&cCs6|jjjr(|jjj ¡\}}| |¡qt |¡dSr')rürãr#r(r)rrr*r&r&r'rÓs  z*ValueErrorAsyncDeferredCommandTests._flushNr+r&r&r&r'r,Ìsr,c@seZdZdZdd„ZdS)Ú POP3MiscTestsz} Miscellaneous tests more to do with module/package structure than anything to do with the Post Office Protocol. cCs(tjj}|jD]}| t||ƒ¡qdS)z This test checks that all names listed in twisted.mail.pop3.__all__ are actually present in the module. N)Útwistedrr Ú__all__r¶Úhasattr)r ÚmodÚattrr&r&r'Útest_allãs zPOP3MiscTests.test_allN)r@rArBrCr3r&r&r&r'r-Þsr-)LrCZ __future__rr÷rörÚ collectionsrÚiorZzope.interfacerr.rrrZtwisted.internetr Z twisted.mailr Ztwisted.protocolsr Ztwisted.pythonr Ztwisted.python.compatr Ztwisted.test.proto_helpersrZ twisted.trialrrZtwisted.cred.checkersZtwisted.cred.credentialsZtwisted.cred.portalZtwisted.internet.protocolZtwisted.mail.pop3Ztwisted.mail.protocolsZTestCaserZ protocolsZ VirtualPOP3rDrOr\rmrlr~rÚrZMailboxržr£ZIServerFactoryrÆrÒr×rØrîrïròrúZ_listMessageDeprecationrœÚPendingDeprecationWarningrZ_getUidlDeprecationrrrrrr!r"r%r,r-r&r&r&r'Ús‚             i-=8W@16Y+&yÿþÿþ2