]> code.delx.au - offlineimap/blobdiff - offlineimap/folder/Maildir.py
Step 2 of SVN to arch tree conversion
[offlineimap] / offlineimap / folder / Maildir.py
diff --git a/offlineimap/folder/Maildir.py b/offlineimap/folder/Maildir.py
new file mode 100644 (file)
index 0000000..3b7b055
--- /dev/null
@@ -0,0 +1,220 @@
+# Maildir 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
+from offlineimap import imaputil
+from offlineimap.ui import UIBase
+from threading import Lock
+import os.path, os, re, time, socket, md5
+
+foldermatchre = re.compile(',FMD5=([0-9a-f]{32})')
+uidmatchre = re.compile(',U=(\d+)')
+flagmatchre = re.compile(':.*2,([A-Z]+)')
+
+timeseq = 0
+lasttime = long(0)
+timelock = Lock()
+
+def gettimeseq():
+    global lasttime, timeseq, timelock
+    timelock.acquire()
+    try:
+        thistime = long(time.time())
+        if thistime == lasttime:
+            timeseq += 1
+            return (thistime, timeseq)
+        else:
+            lasttime = thistime
+            timeseq = 0
+            return (thistime, timeseq)
+    finally:
+        timelock.release()
+
+class MaildirFolder(BaseFolder):
+    def __init__(self, root, name, sep, repository, accountname):
+        self.name = name
+        self.root = root
+        self.sep = sep
+        self.messagelist = None
+        self.repository = repository
+        self.accountname = accountname
+        BaseFolder.__init__(self)
+
+    def getaccountname(self):
+        return self.accountname
+
+    def getfullname(self):
+        return os.path.join(self.getroot(), self.getname())
+
+    def getuidvalidity(self):
+        """Maildirs have no notion of uidvalidity, so we just return a magic
+        token."""
+        return 42
+
+    def _scanfolder(self):
+        """Cache the message list.  Maildir flags are:
+        R (replied)
+        S (seen)
+        T (trashed)
+        D (draft)
+        F (flagged)
+        and must occur in ASCII order."""
+        retval = {}
+        files = []
+        nouidcounter = -1               # Messages without UIDs get
+                                        # negative UID numbers.
+        for dirannex in ['new', 'cur']:
+            fulldirname = os.path.join(self.getfullname(), dirannex)
+            files.extend([os.path.join(fulldirname, filename) for
+                          filename in os.listdir(fulldirname)])
+        for file in files:
+            messagename = os.path.basename(file)
+            foldermatch = foldermatchre.search(messagename)
+            if (not foldermatch) or \
+               md5.new(self.getvisiblename()).hexdigest() \
+               != foldermatch.group(1):
+                # If there is no folder MD5 specified, or if it mismatches,
+                # assume it is a foreign (new) message and generate a
+                # negative uid for it
+                uid = nouidcounter
+                nouidcounter -= 1
+            else:                       # It comes from our folder.
+                uidmatch = uidmatchre.search(messagename)
+                uid = None
+                if not uidmatch:
+                    uid = nouidcounter
+                    nouidcounter -= 1
+                else:
+                    uid = long(uidmatch.group(1))
+            flagmatch = flagmatchre.search(messagename)
+            flags = []
+            if flagmatch:
+                flags = [x for x in flagmatch.group(1)]
+            flags.sort()
+            retval[uid] = {'uid': uid,
+                           'flags': flags,
+                           'filename': file}
+        return retval
+
+    def cachemessagelist(self):
+        self.messagelist = self._scanfolder()
+            
+    def getmessagelist(self):
+        return self.messagelist
+
+    def getmessage(self, uid):
+        filename = self.messagelist[uid]['filename']
+        file = open(filename, 'rt')
+        retval = file.read()
+        file.close()
+        return retval.replace("\r\n", "\n")
+
+    def savemessage(self, uid, content, flags):
+        ui = UIBase.getglobalui()
+        ui.debug('maildir', 'savemessage: called to write with flags %s and content %s' % \
+                 (repr(flags), repr(content)))
+        if uid < 0:
+            # We cannot assign a new uid.
+            return uid
+        if uid in self.messagelist:
+            # We already have it.
+            self.savemessageflags(uid, flags)
+            return uid
+        if 'S' in flags:
+            # If a message has been seen, it goes into the cur
+            # directory.  CR debian#152482, [complete.org #4]
+            newdir = os.path.join(self.getfullname(), 'cur')
+        else:
+            newdir = os.path.join(self.getfullname(), 'new')
+        tmpdir = os.path.join(self.getfullname(), 'tmp')
+        messagename = None
+        attempts = 0
+        while 1:
+            if attempts > 15:
+                raise IOError, "Couldn't write to file %s" % messagename
+            timeval, timeseq = gettimeseq()
+            messagename = '%d_%d.%d.%s,U=%d,FMD5=%s' % \
+                          (timeval,
+                           timeseq,
+                           os.getpid(),
+                           socket.gethostname(),
+                           uid,
+                           md5.new(self.getvisiblename()).hexdigest())
+            if os.path.exists(os.path.join(tmpdir, messagename)):
+                time.sleep(2)
+                attempts += 1
+            else:
+                break
+        tmpmessagename = messagename.split(',')[0]
+        ui.debug('maildir', 'savemessage: using temporary name %s' % tmpmessagename)
+        file = open(os.path.join(tmpdir, tmpmessagename), "wt")
+        file.write(content)
+        file.close()
+        ui.debug('maildir', 'savemessage: moving from %s to %s' % \
+                 (tmpmessagename, messagename))
+        os.link(os.path.join(tmpdir, tmpmessagename),
+                os.path.join(newdir, messagename))
+        os.unlink(os.path.join(tmpdir, tmpmessagename))
+        self.messagelist[uid] = {'uid': uid, 'flags': [],
+                                 'filename': os.path.join(newdir, messagename)}
+        self.savemessageflags(uid, flags)
+        ui.debug('maildir', 'savemessage: returning uid %d' % uid)
+        return uid
+        
+    def getmessageflags(self, uid):
+        return self.messagelist[uid]['flags']
+
+    def savemessageflags(self, uid, flags):
+        oldfilename = self.messagelist[uid]['filename']
+        newpath, newname = os.path.split(oldfilename)
+        if 'S' in flags:
+            # If a message has been seen, it goes into the cur
+            # directory.  CR debian#152482, [complete.org #4]
+            newpath = os.path.join(self.getfullname(), 'cur')
+        else:
+            newpath = os.path.join(self.getfullname(), 'new')
+        infostr = ':'
+        infomatch = re.search('(:.*)$', newname)
+        if infomatch:                   # If the info string is present..
+            infostr = infomatch.group(1)
+            newname = newname.split(':')[0] # Strip off the info string.
+        infostr = re.sub('2,[A-Z]*', '', infostr)
+        flags.sort()
+        infostr += '2,' + ''.join(flags)
+        newname += infostr
+        
+        newfilename = os.path.join(newpath, newname)
+        if (newfilename != oldfilename):
+            os.rename(oldfilename, newfilename)
+            self.messagelist[uid]['flags'] = flags
+            self.messagelist[uid]['filename'] = newfilename
+
+    def deletemessage(self, uid):
+        if not uid in self.messagelist:
+            return
+        filename = self.messagelist[uid]['filename']
+        try:
+            os.unlink(filename)
+        except OSError:
+            # Can't find the file -- maybe already deleted?
+            newmsglist = self._scanfolder()
+            if uid in newmsglist:       # Nope, try new filename.
+                os.unlink(newmsglist[uid]['filename'])
+            # Yep -- return.
+        del(self.messagelist[uid])
+