- d?<d@dA<dBdC<dDdE<dFdG<dHdI<dJdK<dLdM.*))?s.*FLAGS \((?P[^\)]*)\)s.*INTERNALDATE "(?P[ 123][0-9])-(?P[A-Z][a-z][a-z])-(?P[0-9][0-9][0-9][0-9]) (?P[0-9][0-9]):(?P[0-9][0-9]):(?P[0-9][0-9]) (?P[-+])(?P[0-9][0-9])(?P[0-9][0-9])"s.*{(?P\d+)}$s)\[(?P[A-Z-]+)( (?P[^\]]*))?\]s$\* (?P[A-Z-]+)( (?P.*))?s3\* (?P\d+) (?P[A-Z-]+)( (?P.*))?csBtZdZdefdYZdefdYZdefdYZeidZ de d Z d Z d Z d Zd ZdZdZdZdZdZdZdZdZdZdZdZdZdZdZdZdddZd Z d!Z!ddd"Z"d#Z#d$Z$d%Z%d&Z&d'Z'd(e(d)Z)d*Z*d+Z+d,Z,d-Z-d.Z.d/Z/d0Z0d1Z1d2Z2d3Z3d4Z4d5Z5d6Z6d7Z7d8Z8d9Z9d:Z:d;Z;d<Z<d=Z=d>Z>RS(?sIMAP4 client class. Instantiate with: IMAP4([host[, port]]) host - host's name (default: localhost); port - port number (default: standard IMAP4 port). All IMAP4rev1 commands are supported by methods of the same name (in lower-case). All arguments to commands are converted to strings, except for AUTHENTICATE, and the last argument to APPEND which is passed as an IMAP4 literal. If necessary (the string contains any non-printing characters or white-space and isn't enclosed with either parentheses or double quotes) each string is quoted. However, the 'password' argument to the LOGIN command is always quoted. If you want to avoid having an argument string quoted (eg: the 'flags' argument to STORE) then enclose the string in parentheses (eg: "(\Deleted)"). Each command returns a tuple: (type, [data, ...]) where 'type' is usually 'OK' or 'NO', and 'data' is either the text from the tagged response, or untagged results from command. Errors raise the exception class .error(""). IMAP4 server errors raise .abort(""), which is a sub-class of 'error'. Mailbox status changes from READ-WRITE to READ-ONLY raise the exception class .readonly(""), which is a sub-class of 'abort'. "error" exceptions imply a program error. "abort" exceptions imply the connection should be reset, and the command re-tried. "readonly" exceptions imply the command should be re-tried. Note: to use this module, you must read the RFCs pertaining to the IMAP4 protocol, as the semantics of the arguments to each IMAP4 command are left to the invoker, not to mention the results. serrorcstZRS(N(s__name__s __module__(((s/usr/lib/python2.2/imaplib.pyserrorssabortcstZRS(N(s__name__s __module__(((s/usr/lib/python2.2/imaplib.pysabortssreadonlycstZRS(N(s__name__s __module__(((s/usr/lib/python2.2/imaplib.pysreadonlyss[^\w!#$%&'*+,.:;<=>?^`|~-]scs||_||_t|_d|_t|_h|_h|_ d|_ t|_ d|_ |i ||ttidd|_tid|id|_|i|_|i ido d|_n3|i id o d |_n|i|id }|i||i i| o|id nt|i |d ii|_x3tD]+}||ij oqjn||_!dSqjW|iddS(NsLOGOUTsii|s(?Ps"\d+) (?P[A-Z]+) (?P.*)sPREAUTHsAUTHsOKsNONAUTHs CAPABILITYs"no CAPABILITY response from serverisserver not IMAP4 compliant("shostsselfsportsDebugsdebugsstatesNonesliteralstagged_commandssuntagged_responsesscontinuation_responses is_readonlystagnumsopensInt2APsrandomsrandintstagpresrescompilestagres _get_responseswelcomeshas_keyserrorscaps_simple_commandstuplesupperssplits capabilitiessAllowedVersionssversionsPROTOCOL_VERSION(sselfshostsportscapsversion((s/usr/lib/python2.2/imaplib.pys__init__sB             & cs;ti|ot||iSntd|dS(NsUnknown IMAP4 command: '%s'(sCommandsshas_keysattrsgetattrsselfslowersAttributeError(sselfsattr((s/usr/lib/python2.2/imaplib.pys __getattr__scsPtititi|_|ii|i|if|iid|_ dS(sSetup connection to remote server on "host:port". This connection will be used by the routines: read, readline, send, shutdown. srbN( ssocketsAF_INETs SOCK_STREAMsselfssocksconnectshostsportsmakefilesfile(sselfshostsport((s/usr/lib/python2.2/imaplib.pysopenscs|ii|SdS(sRead 'size' bytes from remote.N(sselfsfilesreadssize(sselfssize((s/usr/lib/python2.2/imaplib.pysreadscs|iiSdS(sRead line from remote.N(sselfsfilesreadline(sself((s/usr/lib/python2.2/imaplib.pysreadlinescs|ii|dS(sSend data to remote.N(sselfssockssendallsdata(sselfsdata((s/usr/lib/python2.2/imaplib.pyssendscs|ii|iidS(s Close I/O established in "open".N(sselfsfilesclosessock(sself((s/usr/lib/python2.2/imaplib.pysshutdowns cs |iSdS(sfReturn socket instance used to connect to IMAP4 server. socket = .socket() N(sselfssock(sself((s/usr/lib/python2.2/imaplib.pyssocketscsfd}|idtg|\}}|do||fSn|i\}}|i|||SdS(sReturn most recent 'RECENT' responses if any exist, else prompt server for an update using the 'NOOP' command. (typ, [data]) = .recent() 'data' is None if no new messages, else list of RECENT responses, most recent last. sRECENTsOKiN(snamesselfs_untagged_responsesNonestypsdatsnoop(sselfsdatstypsname((s/usr/lib/python2.2/imaplib.pysrecents cs |i|tg|iSdS(sReturn data for response 'code' if received, or None. Old value for response 'code' is cleared. (code, [data]) = .response(code) N(sselfs_untagged_responsescodesNonesupper(sselfscode((s/usr/lib/python2.2/imaplib.pysresponsescsd}| o d}n|o3|d|dfddfjod|}nnt}|ot|}nt}||_|i ||||SdS( sAppend message to named mailbox. (typ, [data]) = .append(mailbox, flags, date_time, message) All args except `message' can be None. sAPPENDsINBOXiis(s)s(%s)N( snamesmailboxsflagssNones date_timesTime2Internaldatesmessagesselfsliterals_simple_command(sselfsmailboxsflagss date_timesmessagesname((s/usr/lib/python2.2/imaplib.pysappends ! cs|i}d|}||ij o|id|nt|i |_ |i d|\}}|djo|i|dnd|_||fSdS(s,Authenticate command - requires response processing. 'mechanism' specifies which authentication mechanism is to be used - it must appear in .capabilities in the form AUTH=. 'authobject' must be a callable object: data = authobject(response) It will be called to process server continuation responses. It should return data that will be encoded and sent to server. It should return None if the client abort response '*' should be sent instead. sAUTH=%ss'Server doesn't allow %s authentication.s AUTHENTICATEsOKisAUTHN(s mechanismsuppersmechscapsselfs capabilitiesserrors_Authenticators authobjectsprocesssliterals_simple_commandstypsdatsstate(sselfs mechanisms authobjectsdatsmechscapstyp((s/usr/lib/python2.2/imaplib.pys authenticate+s    cs|idSdS(sRCheckpoint mailbox on server. (typ, [data]) = .check() sCHECKN(sselfs_simple_command(sself((s/usr/lib/python2.2/imaplib.pyscheckGscs4z|id\}}Wdd|_X||fSdS(sClose currently selected mailbox. Deleted messages are removed from writable mailbox. This is the recommended command before 'LOGOUT'. (typ, [data]) = .close() sCLOSENsAUTH(sselfs_simple_commandstypsdatsstate(sselfsdatstyp((s/usr/lib/python2.2/imaplib.pyscloseOs  cs|id||SdS(sCopy 'message_set' messages onto end of 'new_mailbox'. (typ, [data]) = .copy(message_set, new_mailbox) sCOPYN(sselfs_simple_commands message_sets new_mailbox(sselfs message_sets new_mailbox((s/usr/lib/python2.2/imaplib.pyscopy^scs|id|SdS(sPCreate new mailbox. (typ, [data]) = .create(mailbox) sCREATEN(sselfs_simple_commandsmailbox(sselfsmailbox((s/usr/lib/python2.2/imaplib.pyscreatefscs|id|SdS(sPDelete old mailbox. (typ, [data]) = .delete(mailbox) sDELETEN(sselfs_simple_commandsmailbox(sselfsmailbox((s/usr/lib/python2.2/imaplib.pysdeletenscs2d}|i|\}}|i|||SdS(sPermanently remove deleted items from selected mailbox. Generates 'EXPUNGE' response for each deleted message. (typ, [data]) = .expunge() 'data' is list of 'EXPUNGE'd message numbers in order received. sEXPUNGEN(snamesselfs_simple_commandstypsdats_untagged_response(sselfsdatstypsname((s/usr/lib/python2.2/imaplib.pysexpungevscs8d}|i|||\}}|i|||SdS(s#Fetch (parts of) messages. (typ, [data, ...]) = .fetch(message_set, message_parts) 'message_parts' should be a string of selected parts enclosed in parentheses, eg: "(UID BODY[TEXT])". 'data' are tuples of message part envelope and data. sFETCHN(snamesselfs_simple_commands message_sets message_partsstypsdats_untagged_response(sselfs message_sets message_partssdatsnamestyp((s/usr/lib/python2.2/imaplib.pysfetchs cs/|id|\}}|i||dSdS(sXGet the ACLs for a mailbox. (typ, [data]) = .getacl(mailbox) sGETACLsACLN(sselfs_simple_commandsmailboxstypsdats_untagged_response(sselfsmailboxsdatstyp((s/usr/lib/python2.2/imaplib.pysgetaclss""s*cs8d}|i|||\}}|i|||SdS(sList mailbox names in directory matching pattern. (typ, [data]) = .list(directory='""', pattern='*') 'data' is list of LIST responses. sLISTN(snamesselfs_simple_commands directoryspatternstypsdats_untagged_response(sselfs directoryspatternsdatsnamestyp((s/usr/lib/python2.2/imaplib.pyslistscs_|id||i|\}}|djo|i|dnd|_||fSdS(sIdentify client using plaintext password. (typ, [data]) = .login(user, password) NB: 'password' will be quoted. sLOGINsOKisAUTHN( sselfs_simple_commandsusers_quotespasswordstypsdatserrorsstate(sselfsuserspasswordsdatstyp((s/usr/lib/python2.2/imaplib.pyslogins $  csd|_y|id\}}Wn*ddtid gf\}}nX|i|ii dod|idfSn||fSdS(s|Shutdown connection to server. (typ, [data]) = .logout() Returns server 'BYE' response. sLOGOUTsNOs%s: %sisBYEN( sselfsstates_simple_commandstypsdatssyssexc_infosshutdownsuntagged_responsesshas_key(sselfsdatstyp((s/usr/lib/python2.2/imaplib.pyslogouts ' cs8d}|i|||\}}|i|||SdS(sList 'subscribed' mailbox names in directory matching pattern. (typ, [data, ...]) = .lsub(directory='""', pattern='*') 'data' are tuples of message part envelope and data. sLSUBN(snamesselfs_simple_commands directoryspatternstypsdats_untagged_response(sselfs directoryspatternsdatsnamestyp((s/usr/lib/python2.2/imaplib.pyslsubscs2d}|i|\}}|i|||SdS(sb Returns IMAP namespaces ala rfc2342 (typ, [data, ...]) = .namespace() s NAMESPACEN(snamesselfs_simple_commandstypsdats_untagged_response(sselfsdatstypsname((s/usr/lib/python2.2/imaplib.pys namespacescs|idSdS(sDSend NOOP command. (typ, data) = .noop() sNOOPN(sselfs_simple_command(sself((s/usr/lib/python2.2/imaplib.pysnoopscs>d}|i|||||\}}|i ||dSdS(sFetch truncated part of a message. (typ, [data, ...]) = .partial(message_num, message_part, start, length) 'data' is tuple of message part envelope and data. sPARTIALsFETCHN( snamesselfs_simple_commands message_nums message_partsstartslengthstypsdats_untagged_response(sselfs message_nums message_partsstartslengthsdatsnamestyp((s/usr/lib/python2.2/imaplib.pyspartials!cs|id||SdS(siRename old mailbox name to new. (typ, data) = .rename(oldmailbox, newmailbox) sRENAMEN(sselfs_simple_commands oldmailboxs newmailbox(sselfs oldmailboxs newmailbox((s/usr/lib/python2.2/imaplib.pysrenamescsld}|o)t|i|d|f|\}}n t|i|f|\}}|i|||SdS(sSearch mailbox for matching messages. (typ, [data]) = .search(charset, criterium, ...) 'data' is space separated list of matching message numbers. sSEARCHsCHARSETN( snamescharsetsapplysselfs_simple_commandscriteriastypsdats_untagged_response(sselfscharsetscriteriasdatsnamestyp((s/usr/lib/python2.2/imaplib.pyssearchs )sINBOXcsh|_||_|o d}nd}|i||\}}|djod|_ ||fSnd|_ |ii do| o|id|n||ii dt gfSd S( sSelect a mailbox. Flush all untagged responses. (typ, [data]) = .select(mailbox='INBOX', readonly=None) 'data' is count of messages in mailbox ('EXISTS' response). sEXAMINEsSELECTsOKsAUTHsSELECTEDs READ-ONLYs%s is not writablesEXISTSN( sselfsuntagged_responsessreadonlys is_readonlysnames_simple_commandsmailboxstypsdatsstateshas_keysgetsNone(sselfsmailboxsreadonlysdatsnamestyp((s/usr/lib/python2.2/imaplib.pysselect s      cs|id|||SdS(sZSet a mailbox acl. (typ, [data]) = .create(mailbox, who, what) sSETACLN(sselfs_simple_commandsmailboxswhoswhat(sselfsmailboxswhoswhat((s/usr/lib/python2.2/imaplib.pyssetacl*scsqd}|d|dfddfjod|}nt|i|||f|\}}|i |||SdS(sIMAP4rev1 extension SORT command. (typ, [data]) = .sort(sort_criteria, charset, search_criteria, ...) sSORTiis(s)s(%s)N( snames sort_criteriasapplysselfs_simple_commandscharsetssearch_criteriastypsdats_untagged_response(sselfs sort_criteriascharsetssearch_criteriasdatsnamestyp((s/usr/lib/python2.2/imaplib.pyssort2s !%cs8d}|i|||\}}|i|||SdS(spRequest named status conditions for mailbox. (typ, [data]) = .status(mailbox, names) sSTATUSN(snamesselfs_simple_commandsmailboxsnamesstypsdats_untagged_response(sselfsmailboxsnamessdatstypsname((s/usr/lib/python2.2/imaplib.pysstatus@scsd|d|dfddfjod|}n|id|||\}}|i||dSdS( sAlters flag dispositions for messages in mailbox. (typ, [data]) = .store(message_set, command, flags) iis(s)s(%s)sSTOREsFETCHN(sflagssselfs_simple_commands message_setscommandstypsdats_untagged_response(sselfs message_setscommandsflagssdatstyp((s/usr/lib/python2.2/imaplib.pysstoreLs !cs|id|SdS(sYSubscribe to new mailbox. (typ, [data]) = .subscribe(mailbox) s SUBSCRIBEN(sselfs_simple_commandsmailbox(sselfsmailbox((s/usr/lib/python2.2/imaplib.pys subscribeWscs|i}ti| o|id|n|it|jo |id||ifnd}t|i ||f|\}}|ddfjo |}nd}|i |||SdS(sExecute "command arg ..." with messages identified by UID, rather than message number. (typ, [data]) = .uid(command, arg1, arg2, ...) Returns response appropriate to 'command'. sUnknown IMAP4 UID command: %sscommand %s illegal in state %ssUIDsSEARCHsSORTsFETCHN(scommandsuppersCommandsshas_keysselfserrorsstatesnamesapplys_simple_commandsargsstypsdats_untagged_response(sselfscommandsargssdatsnamestyp((s/usr/lib/python2.2/imaplib.pysuid_s  " cs|id|SdS(s_Unsubscribe from old mailbox. (typ, [data]) = .unsubscribe(mailbox) s UNSUBSCRIBEN(sselfs_simple_commandsmailbox(sselfsmailbox((s/usr/lib/python2.2/imaplib.pys unsubscribevscsL|i}ti| o|ift|.xatom(name, arg, ...) Returns response appropriate to extension command `name'. N( snamesuppersCommandsshas_keysselfsstatesapplys_simple_commandsargs(sselfsnamesargs((s/usr/lib/python2.2/imaplib.pysxatom~s  csV|tjo d}n|i}|i|o||i|n|g|| %ssBADs%s command error: %s %s( sselfs _check_byes_get_tagged_responsestagstypsdatasabortsvalsnameserror(sselfsnamestagsvalstypsdata((s/usr/lib/python2.2/imaplib.pys_command_completes    cs`|i}|i|i|o{|iid}|ii | o|i d|n|iid}|iid}||gf|i||i|i|}|tjodSn|i|SdS(Ns*(sselfsmechsdecodesdatasretsNonesencode(sselfsdatasret((s/usr/lib/python2.2/imaplib.pysprocesss cs|d}xk|oct|djo|d }|d}n |}d}ti|}|o||d }nq W|SdS(Nsi0i(soupsinpslenstsbinasciis b2a_base64se(sselfsinpsestsoup((s/usr/lib/python2.2/imaplib.pysencodes  cs!| odSnti|SdS(Ns(sinpsbinasciis a2b_base64(sselfsinp((s/usr/lib/python2.2/imaplib.pysdecodes(s__name__s __module__s__doc__s__init__sprocesssencodesdecode(((s/usr/lib/python2.2/imaplib.pys_Authenticators    isJanisFebisMarisAprisMayisJunisJulisAugi sSepi sOcti sNovi sDecc sti|}| otSnt|id} |id}t |id}t |id} t |id}t |id}t |id} t |id} t |id }| d |d }|d jo | }n| | |||| d d d f } ti| }ti|}tio|d o|ti}n|ti}ti||Sd S(sMConvert IMAP4 INTERNALDATE to UT. Returns Python time module tuple. smonszonensdaysyearshoursminssecszonehszonemi<s-iN(s InternalDatesmatchsrespsmosNonesMon2numsgroupsmonszonensintsdaysyearshoursminssecszonehszonemszonesttstimesmktimesutcs localtimesltsdaylightsaltzonestimezone(srespsutcszoneshoursminszonenszonemsdaysltsttssecsmonszonehsyearsmo((s/usr/lib/python2.2/imaplib.pysInternaldate2tuples.  ! csXd}d}tt|}x/|o't|d\}}|||}q!W|SdS(s-Convert integer to A-P string representation.ssABCDEFGHIJKLMNOPiN(svalsAPsintsabssnumsdivmodsmod(snumsAPsvalsmod((s/usr/lib/python2.2/imaplib.pysInt2AP s cs<ti|}| ofSnt|idiSdS(s-Convert IMAP4 flags response to python tuple.sflagsN(sFlagssmatchsrespsmostuplesgroupssplit(srespsmo((s/usr/lib/python2.2/imaplib.pys ParseFlagss cst|ttfoti|}nHt|ttifo |}n%t|t o|Sn t dti d|}|ddjod|d}nti o|doti }n ti }d|d t|d d dSd S( syConvert 'date_time' to IMAP4 INTERNALDATE representation. Return string in form: '"DD-Mmm-YYYY HH:MM:SS +HHMM"' sdate_time not of a known types%d-%b-%Y %H:%M:%Sis0s iis"s %+03d%02di<N(s isinstances date_timesintsfloatstimes localtimesttstuples struct_timesstrs ValueErrorsstrftimesdtsdaylightsaltzoneszonestimezonesdivmod(s date_timeszonesttsdt((s/usr/lib/python2.2/imaplib.pysTime2Internaldate"s   s__main__sd:s-dssIMAP password for %s on %s: s localhostsJFrom: %(user)s@localhost%(lf)sSubject: IMAP4 test%(lf)s%(lf)sdata...%(lf)ssuserslfsloginscreates /tmp/xxx 1srenames/tmp/yyys /tmp/yyz 2sappendslists/tmpsyy*sselectssearchsSUBJECTstestspartials1sRFC822isstoresFLAGSs (\Deleted)s namespacesexpungesrecentsclosesresponses UIDVALIDITYsuidsALLsEXISTSslogoutcsQtd||fttt||\}}td|||f|SdS(Ns%s %ss %s => %s %s(s_mesgscmdsargssapplysgetattrsMstypsdat(scmdsargssdatstyp((s/usr/lib/python2.2/imaplib.pysrunssPROTOCOL_VERSION = %ssCAPABILITIES = %ss/tmp/syy%s .*"([^"]+)"$isdeletes%ss:(FLAGS INTERNALDATE RFC822.SIZE RFC822.HEADER RFC822.TEXT)s All tests OK.s Tests failed.s8 If you would like to see debugging output, try: %s -d5 (=s__doc__s __version__sbinasciisressocketstimesrandomssyss__all__sCRLFsDebugs IMAP4_PORTsAllowedVersionssCommandsscompiles ContinuationsFlagss InternalDatesLiterals Response_codesUntagged_responsesUntagged_statussIMAP4s_AuthenticatorsMon2numsInternaldate2tuplesInt2APs ParseFlagssTime2Internaldates__name__sgetoptsgetpasssargvsoptlistsargsserrorsvalsoptsintshostsgetusersUSERsPASSWDs test_mesgsNones test_seq1s test_seq2srunsMs_mesgsPROTOCOL_VERSIONs capabilitiesscmdsmlsmatchsmosgroupspathssplitsdatsuid(/s test_seq1suids Response_codesrandomsgetpasssLiteralsmlsUSERspathsInt2APsTime2Internaldates InternalDatesUntagged_statuss__all__sresbinasciisPASSWDs test_mesgsdatsgetopts __version__s_AuthenticatorsoptsCommandss test_seq2sruns IMAP4_PORTsargssMssyssInternaldate2tupleshostsFlagssCRLFsDebugsUntagged_responsesoptlistssocketsMon2nums ParseFlagss ContinuationsmoscmdsAllowedVersionssvalstimesIMAP4((s/usr/lib/python2.2/imaplib.pys? s6 #^,r , ! #      ]    "