2002-06-19 07:22:21 +02:00
|
|
|
# IMAP folder support
|
|
|
|
# Copyright (C) 2002 John Goerzen
|
|
|
|
# <jgoerzen@complete.org>
|
|
|
|
#
|
|
|
|
# This program is free software; you can redistribute it and/or modify
|
|
|
|
# it under the terms of the GNU General Public License as published by
|
|
|
|
# the Free Software Foundation; either version 2 of the License, or
|
|
|
|
# (at your option) any later version.
|
|
|
|
#
|
|
|
|
# This program is distributed in the hope that it will be useful,
|
|
|
|
# but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
|
|
# GNU General Public License for more details.
|
|
|
|
#
|
|
|
|
# You should have received a copy of the GNU General Public License
|
|
|
|
# along with this program; if not, write to the Free Software
|
|
|
|
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
|
|
|
|
|
|
|
|
from Base import BaseFolder
|
2002-06-21 12:01:10 +02:00
|
|
|
from offlineimap import imaputil, imaplib
|
2002-06-21 03:22:40 +02:00
|
|
|
import rfc822
|
|
|
|
from StringIO import StringIO
|
2002-07-12 01:35:51 +02:00
|
|
|
from copy import copy
|
2002-06-19 07:22:21 +02:00
|
|
|
|
|
|
|
class IMAPFolder(BaseFolder):
|
2002-07-04 05:59:19 +02:00
|
|
|
def __init__(self, imapserver, name, visiblename, accountname):
|
2002-06-19 07:22:21 +02:00
|
|
|
self.name = imaputil.dequote(name)
|
|
|
|
self.root = imapserver.root
|
|
|
|
self.sep = imapserver.delim
|
|
|
|
self.imapserver = imapserver
|
2002-06-20 08:26:28 +02:00
|
|
|
self.messagelist = None
|
2002-06-21 08:51:21 +02:00
|
|
|
self.visiblename = visiblename
|
2002-07-04 05:59:19 +02:00
|
|
|
self.accountname = accountname
|
2002-06-21 08:51:21 +02:00
|
|
|
|
2002-07-04 03:35:05 +02:00
|
|
|
def suggeststhreads(self):
|
|
|
|
return 1
|
|
|
|
|
|
|
|
def waitforthread(self):
|
|
|
|
self.imapserver.connectionwait()
|
|
|
|
|
2002-07-04 05:59:19 +02:00
|
|
|
def getcopyinstancelimit(self):
|
|
|
|
return 'MSGCOPY_' + self.accountname
|
|
|
|
|
2002-06-21 08:51:21 +02:00
|
|
|
def getvisiblename(self):
|
|
|
|
return self.visiblename
|
2002-06-20 08:26:28 +02:00
|
|
|
|
|
|
|
def getuidvalidity(self):
|
2002-07-04 03:35:05 +02:00
|
|
|
imapobj = self.imapserver.acquireconnection()
|
|
|
|
try:
|
2002-07-11 05:31:39 +02:00
|
|
|
# Primes untagged_responses
|
|
|
|
imapobj.select(self.getfullname(), readonly = 1)
|
|
|
|
return long(imapobj.untagged_responses['UIDVALIDITY'][0])
|
2002-07-04 03:35:05 +02:00
|
|
|
finally:
|
|
|
|
self.imapserver.releaseconnection(imapobj)
|
2002-06-20 08:26:28 +02:00
|
|
|
|
|
|
|
def cachemessagelist(self):
|
2002-07-04 03:35:05 +02:00
|
|
|
imapobj = self.imapserver.acquireconnection()
|
2002-07-11 05:31:39 +02:00
|
|
|
self.messagelist = {}
|
|
|
|
|
2002-07-04 03:35:05 +02:00
|
|
|
try:
|
2002-07-11 05:31:39 +02:00
|
|
|
# Primes untagged_responses
|
|
|
|
imapobj.select(self.getfullname(), readonly = 1)
|
|
|
|
maxmsgid = long(imapobj.untagged_responses['EXISTS'][0])
|
|
|
|
if maxmsgid < 1:
|
|
|
|
# No messages; return
|
2002-07-04 03:35:05 +02:00
|
|
|
return
|
|
|
|
|
|
|
|
# Now, get the flags and UIDs for these.
|
|
|
|
response = imapobj.fetch('1:%d' % maxmsgid, '(FLAGS UID)')[1]
|
|
|
|
finally:
|
|
|
|
self.imapserver.releaseconnection(imapobj)
|
2002-06-20 08:26:28 +02:00
|
|
|
for messagestr in response:
|
|
|
|
# Discard the message number.
|
|
|
|
messagestr = imaputil.imapsplit(messagestr)[1]
|
|
|
|
options = imaputil.flags2hash(messagestr)
|
2002-06-20 09:40:29 +02:00
|
|
|
uid = long(options['UID'])
|
|
|
|
flags = imaputil.flagsimap2maildir(options['FLAGS'])
|
|
|
|
self.messagelist[uid] = {'uid': uid, 'flags': flags}
|
|
|
|
|
|
|
|
def getmessagelist(self):
|
|
|
|
return self.messagelist
|
|
|
|
|
2002-06-20 13:39:27 +02:00
|
|
|
def getmessage(self, uid):
|
2002-07-04 03:35:05 +02:00
|
|
|
imapobj = self.imapserver.acquireconnection()
|
|
|
|
try:
|
2002-07-10 06:13:33 +02:00
|
|
|
imapobj.select(self.getfullname(), readonly = 1)
|
2002-07-04 03:35:05 +02:00
|
|
|
return imapobj.uid('fetch', '%d' % uid, '(BODY.PEEK[])')[1][0][1].replace("\r\n", "\n")
|
|
|
|
finally:
|
|
|
|
self.imapserver.releaseconnection(imapobj)
|
2002-06-20 13:39:27 +02:00
|
|
|
|
|
|
|
def getmessageflags(self, uid):
|
2002-07-04 03:35:05 +02:00
|
|
|
return self.messagelist[uid]['flags']
|
2002-06-20 09:40:29 +02:00
|
|
|
|
2002-06-21 03:22:40 +02:00
|
|
|
def savemessage(self, uid, content, flags):
|
2002-07-04 03:35:05 +02:00
|
|
|
imapobj = self.imapserver.acquireconnection()
|
|
|
|
try:
|
2002-07-11 05:31:39 +02:00
|
|
|
imapobj.select(self.getfullname()) # Needed for search
|
|
|
|
|
2002-07-04 03:35:05 +02:00
|
|
|
# This backend always assigns a new uid, so the uid arg is ignored.
|
|
|
|
# In order to get the new uid, we need to save off the message ID.
|
|
|
|
|
|
|
|
message = rfc822.Message(StringIO(content))
|
|
|
|
mid = imapobj._quote(message.getheader('Message-Id'))
|
|
|
|
date = imaplib.Time2Internaldate(rfc822.parsedate(message.getheader('Date')))
|
|
|
|
|
|
|
|
if content.find("\r\n") == -1: # Convert line endings if not already
|
|
|
|
content = content.replace("\n", "\r\n")
|
|
|
|
|
|
|
|
assert(imapobj.append(self.getfullname(),
|
|
|
|
imaputil.flagsmaildir2imap(flags),
|
|
|
|
date, content)[0] == 'OK')
|
|
|
|
# Checkpoint. Let it write out the messages, etc.
|
|
|
|
assert(imapobj.check()[0] == 'OK')
|
|
|
|
# Now find the UID it got.
|
|
|
|
matchinguids = imapobj.uid('search', None,
|
|
|
|
'(HEADER Message-Id %s)' % mid)[1][0]
|
|
|
|
matchinguids = matchinguids.split(' ')
|
|
|
|
matchinguids.sort()
|
|
|
|
uid = long(matchinguids[-1])
|
|
|
|
self.messagelist[uid] = {'uid': uid, 'flags': flags}
|
|
|
|
return uid
|
|
|
|
finally:
|
|
|
|
self.imapserver.releaseconnection(imapobj)
|
2002-06-21 03:22:40 +02:00
|
|
|
|
2002-06-21 03:55:06 +02:00
|
|
|
def savemessageflags(self, uid, flags):
|
2002-07-04 05:59:19 +02:00
|
|
|
imapobj = self.imapserver.acquireconnection()
|
2002-07-04 03:35:05 +02:00
|
|
|
try:
|
|
|
|
imapobj.select(self.getfullname())
|
|
|
|
result = imapobj.uid('store', '%d' % uid, 'FLAGS',
|
2002-07-12 15:20:09 +02:00
|
|
|
imaputil.flagsmaildir2imap(flags))
|
|
|
|
assert result[0] == 'OK', 'Error with store: ' + r[1]
|
2002-07-04 03:35:05 +02:00
|
|
|
finally:
|
|
|
|
self.imapserver.releaseconnection(imapobj)
|
2002-07-12 15:20:09 +02:00
|
|
|
result = result[1][0]
|
|
|
|
if not result:
|
|
|
|
self.messagelist[uid]['flags'] = flags
|
|
|
|
else:
|
|
|
|
flags = imaputil.flags2hash(imaputil.imapsplit(result)[1])['FLAGS']
|
|
|
|
self.messagelist[uid]['flags'] = imaputil.flagsimap2maildir(flags)
|
|
|
|
|
|
|
|
def addmessageflags(self, uid, flags):
|
|
|
|
self.addmessagesflags([uid], flags)
|
2002-06-21 03:55:06 +02:00
|
|
|
|
2002-07-03 07:05:49 +02:00
|
|
|
def addmessagesflags(self, uidlist, flags):
|
2002-07-04 04:14:07 +02:00
|
|
|
imapobj = self.imapserver.acquireconnection()
|
2002-07-04 03:35:05 +02:00
|
|
|
try:
|
|
|
|
imapobj.select(self.getfullname())
|
|
|
|
r = imapobj.uid('store',
|
|
|
|
','.join([str(uid) for uid in uidlist]),
|
|
|
|
'+FLAGS',
|
2002-07-12 01:35:51 +02:00
|
|
|
imaputil.flagsmaildir2imap(flags))
|
|
|
|
assert r[0] == 'OK', 'Error with store: ' + r[1]
|
|
|
|
r = r[1]
|
2002-07-04 03:35:05 +02:00
|
|
|
finally:
|
|
|
|
self.imapserver.releaseconnection(imapobj)
|
2002-07-12 01:35:51 +02:00
|
|
|
# Some IMAP servers do not always return a result. Therefore,
|
|
|
|
# only update the ones that it talks about, and manually fix
|
|
|
|
# the others.
|
|
|
|
needupdate = copy(uidlist)
|
2002-07-03 07:05:49 +02:00
|
|
|
for result in r:
|
2002-07-12 01:35:51 +02:00
|
|
|
if result == None:
|
2002-07-12 04:04:04 +02:00
|
|
|
# Compensate for servers that don't return anything from
|
|
|
|
# STORE.
|
2002-07-12 01:35:51 +02:00
|
|
|
continue
|
2002-07-12 04:04:04 +02:00
|
|
|
attributehash = imaputil.flags2hash(imaputil.imapsplit(result)[1])
|
|
|
|
if not ('UID' in attributehash and 'FLAGS' in attributehash):
|
|
|
|
# Compensate for servers that don't return a UID attribute.
|
|
|
|
continue
|
|
|
|
flags = attributehash['FLAGS']
|
|
|
|
uid = long(attributehash['UID'])
|
2002-07-03 07:05:49 +02:00
|
|
|
self.messagelist[uid]['flags'] = imaputil.flagsimap2maildir(flags)
|
2002-07-12 01:35:51 +02:00
|
|
|
try:
|
|
|
|
needupdate.remove(uid)
|
|
|
|
except ValueError: # Let it slide if it's not in the list
|
|
|
|
pass
|
|
|
|
for uid in needupdate:
|
|
|
|
for flag in flags:
|
|
|
|
if not flag in self.messagelist[uid]['flags']:
|
|
|
|
self.messagelist[uid]['flags'].append(flag)
|
|
|
|
self.messagelist[uid]['flags'].sort()
|
2002-07-03 07:05:49 +02:00
|
|
|
|
2002-06-21 03:55:06 +02:00
|
|
|
def deletemessage(self, uid):
|
2002-07-03 07:05:49 +02:00
|
|
|
self.deletemessages([uid])
|
|
|
|
|
2002-07-03 07:16:56 +02:00
|
|
|
def deletemessages(self, uidlist):
|
2002-07-03 07:05:49 +02:00
|
|
|
# Weed out ones not in self.messagelist
|
|
|
|
uidlist = [uid for uid in uidlist if uid in self.messagelist]
|
|
|
|
if not len(uidlist):
|
|
|
|
return
|
2002-07-04 03:35:05 +02:00
|
|
|
|
2002-07-03 07:05:49 +02:00
|
|
|
self.addmessagesflags(uidlist, ['T'])
|
2002-07-04 03:35:05 +02:00
|
|
|
imapobj = self.imapserver.acquireconnection()
|
|
|
|
try:
|
|
|
|
imapobj.select(self.getfullname())
|
|
|
|
assert(imapobj.expunge()[0] == 'OK')
|
|
|
|
finally:
|
|
|
|
self.imapserver.releaseconnection(imapobj)
|
2002-07-03 07:05:49 +02:00
|
|
|
for uid in uidlist:
|
2002-07-12 01:35:51 +02:00
|
|
|
del self.messagelist[uid]
|
2002-06-21 03:55:06 +02:00
|
|
|
|
2002-06-21 03:22:40 +02:00
|
|
|
|