1 | """MH interface -- purely object-oriented (well, almost)
|
---|
2 |
|
---|
3 | Executive summary:
|
---|
4 |
|
---|
5 | import mhlib
|
---|
6 |
|
---|
7 | mh = mhlib.MH() # use default mailbox directory and profile
|
---|
8 | mh = mhlib.MH(mailbox) # override mailbox location (default from profile)
|
---|
9 | mh = mhlib.MH(mailbox, profile) # override mailbox and profile
|
---|
10 |
|
---|
11 | mh.error(format, ...) # print error message -- can be overridden
|
---|
12 | s = mh.getprofile(key) # profile entry (None if not set)
|
---|
13 | path = mh.getpath() # mailbox pathname
|
---|
14 | name = mh.getcontext() # name of current folder
|
---|
15 | mh.setcontext(name) # set name of current folder
|
---|
16 |
|
---|
17 | list = mh.listfolders() # names of top-level folders
|
---|
18 | list = mh.listallfolders() # names of all folders, including subfolders
|
---|
19 | list = mh.listsubfolders(name) # direct subfolders of given folder
|
---|
20 | list = mh.listallsubfolders(name) # all subfolders of given folder
|
---|
21 |
|
---|
22 | mh.makefolder(name) # create new folder
|
---|
23 | mh.deletefolder(name) # delete folder -- must have no subfolders
|
---|
24 |
|
---|
25 | f = mh.openfolder(name) # new open folder object
|
---|
26 |
|
---|
27 | f.error(format, ...) # same as mh.error(format, ...)
|
---|
28 | path = f.getfullname() # folder's full pathname
|
---|
29 | path = f.getsequencesfilename() # full pathname of folder's sequences file
|
---|
30 | path = f.getmessagefilename(n) # full pathname of message n in folder
|
---|
31 |
|
---|
32 | list = f.listmessages() # list of messages in folder (as numbers)
|
---|
33 | n = f.getcurrent() # get current message
|
---|
34 | f.setcurrent(n) # set current message
|
---|
35 | list = f.parsesequence(seq) # parse msgs syntax into list of messages
|
---|
36 | n = f.getlast() # get last message (0 if no messagse)
|
---|
37 | f.setlast(n) # set last message (internal use only)
|
---|
38 |
|
---|
39 | dict = f.getsequences() # dictionary of sequences in folder {name: list}
|
---|
40 | f.putsequences(dict) # write sequences back to folder
|
---|
41 |
|
---|
42 | f.createmessage(n, fp) # add message from file f as number n
|
---|
43 | f.removemessages(list) # remove messages in list from folder
|
---|
44 | f.refilemessages(list, tofolder) # move messages in list to other folder
|
---|
45 | f.movemessage(n, tofolder, ton) # move one message to a given destination
|
---|
46 | f.copymessage(n, tofolder, ton) # copy one message to a given destination
|
---|
47 |
|
---|
48 | m = f.openmessage(n) # new open message object (costs a file descriptor)
|
---|
49 | m is a derived class of mimetools.Message(rfc822.Message), with:
|
---|
50 | s = m.getheadertext() # text of message's headers
|
---|
51 | s = m.getheadertext(pred) # text of message's headers, filtered by pred
|
---|
52 | s = m.getbodytext() # text of message's body, decoded
|
---|
53 | s = m.getbodytext(0) # text of message's body, not decoded
|
---|
54 | """
|
---|
55 |
|
---|
56 | # XXX To do, functionality:
|
---|
57 | # - annotate messages
|
---|
58 | # - send messages
|
---|
59 | #
|
---|
60 | # XXX To do, organization:
|
---|
61 | # - move IntSet to separate file
|
---|
62 | # - move most Message functionality to module mimetools
|
---|
63 |
|
---|
64 |
|
---|
65 | # Customizable defaults
|
---|
66 |
|
---|
67 | MH_PROFILE = '~/.mh_profile'
|
---|
68 | PATH = '~/Mail'
|
---|
69 | MH_SEQUENCES = '.mh_sequences'
|
---|
70 | FOLDER_PROTECT = 0700
|
---|
71 |
|
---|
72 |
|
---|
73 | # Imported modules
|
---|
74 |
|
---|
75 | import os
|
---|
76 | import sys
|
---|
77 | import re
|
---|
78 | import mimetools
|
---|
79 | import multifile
|
---|
80 | import shutil
|
---|
81 | from bisect import bisect
|
---|
82 |
|
---|
83 | __all__ = ["MH","Error","Folder","Message"]
|
---|
84 |
|
---|
85 | # Exported constants
|
---|
86 |
|
---|
87 | class Error(Exception):
|
---|
88 | pass
|
---|
89 |
|
---|
90 |
|
---|
91 | class MH:
|
---|
92 | """Class representing a particular collection of folders.
|
---|
93 | Optional constructor arguments are the pathname for the directory
|
---|
94 | containing the collection, and the MH profile to use.
|
---|
95 | If either is omitted or empty a default is used; the default
|
---|
96 | directory is taken from the MH profile if it is specified there."""
|
---|
97 |
|
---|
98 | def __init__(self, path = None, profile = None):
|
---|
99 | """Constructor."""
|
---|
100 | if profile is None: profile = MH_PROFILE
|
---|
101 | self.profile = os.path.expanduser(profile)
|
---|
102 | if path is None: path = self.getprofile('Path')
|
---|
103 | if not path: path = PATH
|
---|
104 | if not os.path.isabs(path) and path[0] != '~':
|
---|
105 | path = os.path.join('~', path)
|
---|
106 | path = os.path.expanduser(path)
|
---|
107 | if not os.path.isdir(path): raise Error, 'MH() path not found'
|
---|
108 | self.path = path
|
---|
109 |
|
---|
110 | def __repr__(self):
|
---|
111 | """String representation."""
|
---|
112 | return 'MH(%r, %r)' % (self.path, self.profile)
|
---|
113 |
|
---|
114 | def error(self, msg, *args):
|
---|
115 | """Routine to print an error. May be overridden by a derived class."""
|
---|
116 | sys.stderr.write('MH error: %s\n' % (msg % args))
|
---|
117 |
|
---|
118 | def getprofile(self, key):
|
---|
119 | """Return a profile entry, None if not found."""
|
---|
120 | return pickline(self.profile, key)
|
---|
121 |
|
---|
122 | def getpath(self):
|
---|
123 | """Return the path (the name of the collection's directory)."""
|
---|
124 | return self.path
|
---|
125 |
|
---|
126 | def getcontext(self):
|
---|
127 | """Return the name of the current folder."""
|
---|
128 | context = pickline(os.path.join(self.getpath(), 'context'),
|
---|
129 | 'Current-Folder')
|
---|
130 | if not context: context = 'inbox'
|
---|
131 | return context
|
---|
132 |
|
---|
133 | def setcontext(self, context):
|
---|
134 | """Set the name of the current folder."""
|
---|
135 | fn = os.path.join(self.getpath(), 'context')
|
---|
136 | f = open(fn, "w")
|
---|
137 | f.write("Current-Folder: %s\n" % context)
|
---|
138 | f.close()
|
---|
139 |
|
---|
140 | def listfolders(self):
|
---|
141 | """Return the names of the top-level folders."""
|
---|
142 | folders = []
|
---|
143 | path = self.getpath()
|
---|
144 | for name in os.listdir(path):
|
---|
145 | fullname = os.path.join(path, name)
|
---|
146 | if os.path.isdir(fullname):
|
---|
147 | folders.append(name)
|
---|
148 | folders.sort()
|
---|
149 | return folders
|
---|
150 |
|
---|
151 | def listsubfolders(self, name):
|
---|
152 | """Return the names of the subfolders in a given folder
|
---|
153 | (prefixed with the given folder name)."""
|
---|
154 | fullname = os.path.join(self.path, name)
|
---|
155 | # Get the link count so we can avoid listing folders
|
---|
156 | # that have no subfolders.
|
---|
157 | nlinks = os.stat(fullname).st_nlink
|
---|
158 | if nlinks <= 2:
|
---|
159 | return []
|
---|
160 | subfolders = []
|
---|
161 | subnames = os.listdir(fullname)
|
---|
162 | for subname in subnames:
|
---|
163 | fullsubname = os.path.join(fullname, subname)
|
---|
164 | if os.path.isdir(fullsubname):
|
---|
165 | name_subname = os.path.join(name, subname)
|
---|
166 | subfolders.append(name_subname)
|
---|
167 | # Stop looking for subfolders when
|
---|
168 | # we've seen them all
|
---|
169 | nlinks = nlinks - 1
|
---|
170 | if nlinks <= 2:
|
---|
171 | break
|
---|
172 | subfolders.sort()
|
---|
173 | return subfolders
|
---|
174 |
|
---|
175 | def listallfolders(self):
|
---|
176 | """Return the names of all folders and subfolders, recursively."""
|
---|
177 | return self.listallsubfolders('')
|
---|
178 |
|
---|
179 | def listallsubfolders(self, name):
|
---|
180 | """Return the names of subfolders in a given folder, recursively."""
|
---|
181 | fullname = os.path.join(self.path, name)
|
---|
182 | # Get the link count so we can avoid listing folders
|
---|
183 | # that have no subfolders.
|
---|
184 | nlinks = os.stat(fullname).st_nlink
|
---|
185 | if nlinks <= 2:
|
---|
186 | return []
|
---|
187 | subfolders = []
|
---|
188 | subnames = os.listdir(fullname)
|
---|
189 | for subname in subnames:
|
---|
190 | if subname[0] == ',' or isnumeric(subname): continue
|
---|
191 | fullsubname = os.path.join(fullname, subname)
|
---|
192 | if os.path.isdir(fullsubname):
|
---|
193 | name_subname = os.path.join(name, subname)
|
---|
194 | subfolders.append(name_subname)
|
---|
195 | if not os.path.islink(fullsubname):
|
---|
196 | subsubfolders = self.listallsubfolders(
|
---|
197 | name_subname)
|
---|
198 | subfolders = subfolders + subsubfolders
|
---|
199 | # Stop looking for subfolders when
|
---|
200 | # we've seen them all
|
---|
201 | nlinks = nlinks - 1
|
---|
202 | if nlinks <= 2:
|
---|
203 | break
|
---|
204 | subfolders.sort()
|
---|
205 | return subfolders
|
---|
206 |
|
---|
207 | def openfolder(self, name):
|
---|
208 | """Return a new Folder object for the named folder."""
|
---|
209 | return Folder(self, name)
|
---|
210 |
|
---|
211 | def makefolder(self, name):
|
---|
212 | """Create a new folder (or raise os.error if it cannot be created)."""
|
---|
213 | protect = pickline(self.profile, 'Folder-Protect')
|
---|
214 | if protect and isnumeric(protect):
|
---|
215 | mode = int(protect, 8)
|
---|
216 | else:
|
---|
217 | mode = FOLDER_PROTECT
|
---|
218 | os.mkdir(os.path.join(self.getpath(), name), mode)
|
---|
219 |
|
---|
220 | def deletefolder(self, name):
|
---|
221 | """Delete a folder. This removes files in the folder but not
|
---|
222 | subdirectories. Raise os.error if deleting the folder itself fails."""
|
---|
223 | fullname = os.path.join(self.getpath(), name)
|
---|
224 | for subname in os.listdir(fullname):
|
---|
225 | fullsubname = os.path.join(fullname, subname)
|
---|
226 | try:
|
---|
227 | os.unlink(fullsubname)
|
---|
228 | except os.error:
|
---|
229 | self.error('%s not deleted, continuing...' %
|
---|
230 | fullsubname)
|
---|
231 | os.rmdir(fullname)
|
---|
232 |
|
---|
233 |
|
---|
234 | numericprog = re.compile('^[1-9][0-9]*$')
|
---|
235 | def isnumeric(str):
|
---|
236 | return numericprog.match(str) is not None
|
---|
237 |
|
---|
238 | class Folder:
|
---|
239 | """Class representing a particular folder."""
|
---|
240 |
|
---|
241 | def __init__(self, mh, name):
|
---|
242 | """Constructor."""
|
---|
243 | self.mh = mh
|
---|
244 | self.name = name
|
---|
245 | if not os.path.isdir(self.getfullname()):
|
---|
246 | raise Error, 'no folder %s' % name
|
---|
247 |
|
---|
248 | def __repr__(self):
|
---|
249 | """String representation."""
|
---|
250 | return 'Folder(%r, %r)' % (self.mh, self.name)
|
---|
251 |
|
---|
252 | def error(self, *args):
|
---|
253 | """Error message handler."""
|
---|
254 | self.mh.error(*args)
|
---|
255 |
|
---|
256 | def getfullname(self):
|
---|
257 | """Return the full pathname of the folder."""
|
---|
258 | return os.path.join(self.mh.path, self.name)
|
---|
259 |
|
---|
260 | def getsequencesfilename(self):
|
---|
261 | """Return the full pathname of the folder's sequences file."""
|
---|
262 | return os.path.join(self.getfullname(), MH_SEQUENCES)
|
---|
263 |
|
---|
264 | def getmessagefilename(self, n):
|
---|
265 | """Return the full pathname of a message in the folder."""
|
---|
266 | return os.path.join(self.getfullname(), str(n))
|
---|
267 |
|
---|
268 | def listsubfolders(self):
|
---|
269 | """Return list of direct subfolders."""
|
---|
270 | return self.mh.listsubfolders(self.name)
|
---|
271 |
|
---|
272 | def listallsubfolders(self):
|
---|
273 | """Return list of all subfolders."""
|
---|
274 | return self.mh.listallsubfolders(self.name)
|
---|
275 |
|
---|
276 | def listmessages(self):
|
---|
277 | """Return the list of messages currently present in the folder.
|
---|
278 | As a side effect, set self.last to the last message (or 0)."""
|
---|
279 | messages = []
|
---|
280 | match = numericprog.match
|
---|
281 | append = messages.append
|
---|
282 | for name in os.listdir(self.getfullname()):
|
---|
283 | if match(name):
|
---|
284 | append(name)
|
---|
285 | messages = map(int, messages)
|
---|
286 | messages.sort()
|
---|
287 | if messages:
|
---|
288 | self.last = messages[-1]
|
---|
289 | else:
|
---|
290 | self.last = 0
|
---|
291 | return messages
|
---|
292 |
|
---|
293 | def getsequences(self):
|
---|
294 | """Return the set of sequences for the folder."""
|
---|
295 | sequences = {}
|
---|
296 | fullname = self.getsequencesfilename()
|
---|
297 | try:
|
---|
298 | f = open(fullname, 'r')
|
---|
299 | except IOError:
|
---|
300 | return sequences
|
---|
301 | while 1:
|
---|
302 | line = f.readline()
|
---|
303 | if not line: break
|
---|
304 | fields = line.split(':')
|
---|
305 | if len(fields) != 2:
|
---|
306 | self.error('bad sequence in %s: %s' %
|
---|
307 | (fullname, line.strip()))
|
---|
308 | key = fields[0].strip()
|
---|
309 | value = IntSet(fields[1].strip(), ' ').tolist()
|
---|
310 | sequences[key] = value
|
---|
311 | return sequences
|
---|
312 |
|
---|
313 | def putsequences(self, sequences):
|
---|
314 | """Write the set of sequences back to the folder."""
|
---|
315 | fullname = self.getsequencesfilename()
|
---|
316 | f = None
|
---|
317 | for key, seq in sequences.iteritems():
|
---|
318 | s = IntSet('', ' ')
|
---|
319 | s.fromlist(seq)
|
---|
320 | if not f: f = open(fullname, 'w')
|
---|
321 | f.write('%s: %s\n' % (key, s.tostring()))
|
---|
322 | if not f:
|
---|
323 | try:
|
---|
324 | os.unlink(fullname)
|
---|
325 | except os.error:
|
---|
326 | pass
|
---|
327 | else:
|
---|
328 | f.close()
|
---|
329 |
|
---|
330 | def getcurrent(self):
|
---|
331 | """Return the current message. Raise Error when there is none."""
|
---|
332 | seqs = self.getsequences()
|
---|
333 | try:
|
---|
334 | return max(seqs['cur'])
|
---|
335 | except (ValueError, KeyError):
|
---|
336 | raise Error, "no cur message"
|
---|
337 |
|
---|
338 | def setcurrent(self, n):
|
---|
339 | """Set the current message."""
|
---|
340 | updateline(self.getsequencesfilename(), 'cur', str(n), 0)
|
---|
341 |
|
---|
342 | def parsesequence(self, seq):
|
---|
343 | """Parse an MH sequence specification into a message list.
|
---|
344 | Attempt to mimic mh-sequence(5) as close as possible.
|
---|
345 | Also attempt to mimic observed behavior regarding which
|
---|
346 | conditions cause which error messages."""
|
---|
347 | # XXX Still not complete (see mh-format(5)).
|
---|
348 | # Missing are:
|
---|
349 | # - 'prev', 'next' as count
|
---|
350 | # - Sequence-Negation option
|
---|
351 | all = self.listmessages()
|
---|
352 | # Observed behavior: test for empty folder is done first
|
---|
353 | if not all:
|
---|
354 | raise Error, "no messages in %s" % self.name
|
---|
355 | # Common case first: all is frequently the default
|
---|
356 | if seq == 'all':
|
---|
357 | return all
|
---|
358 | # Test for X:Y before X-Y because 'seq:-n' matches both
|
---|
359 | i = seq.find(':')
|
---|
360 | if i >= 0:
|
---|
361 | head, dir, tail = seq[:i], '', seq[i+1:]
|
---|
362 | if tail[:1] in '-+':
|
---|
363 | dir, tail = tail[:1], tail[1:]
|
---|
364 | if not isnumeric(tail):
|
---|
365 | raise Error, "bad message list %s" % seq
|
---|
366 | try:
|
---|
367 | count = int(tail)
|
---|
368 | except (ValueError, OverflowError):
|
---|
369 | # Can't use sys.maxint because of i+count below
|
---|
370 | count = len(all)
|
---|
371 | try:
|
---|
372 | anchor = self._parseindex(head, all)
|
---|
373 | except Error, msg:
|
---|
374 | seqs = self.getsequences()
|
---|
375 | if not head in seqs:
|
---|
376 | if not msg:
|
---|
377 | msg = "bad message list %s" % seq
|
---|
378 | raise Error, msg, sys.exc_info()[2]
|
---|
379 | msgs = seqs[head]
|
---|
380 | if not msgs:
|
---|
381 | raise Error, "sequence %s empty" % head
|
---|
382 | if dir == '-':
|
---|
383 | return msgs[-count:]
|
---|
384 | else:
|
---|
385 | return msgs[:count]
|
---|
386 | else:
|
---|
387 | if not dir:
|
---|
388 | if head in ('prev', 'last'):
|
---|
389 | dir = '-'
|
---|
390 | if dir == '-':
|
---|
391 | i = bisect(all, anchor)
|
---|
392 | return all[max(0, i-count):i]
|
---|
393 | else:
|
---|
394 | i = bisect(all, anchor-1)
|
---|
395 | return all[i:i+count]
|
---|
396 | # Test for X-Y next
|
---|
397 | i = seq.find('-')
|
---|
398 | if i >= 0:
|
---|
399 | begin = self._parseindex(seq[:i], all)
|
---|
400 | end = self._parseindex(seq[i+1:], all)
|
---|
401 | i = bisect(all, begin-1)
|
---|
402 | j = bisect(all, end)
|
---|
403 | r = all[i:j]
|
---|
404 | if not r:
|
---|
405 | raise Error, "bad message list %s" % seq
|
---|
406 | return r
|
---|
407 | # Neither X:Y nor X-Y; must be a number or a (pseudo-)sequence
|
---|
408 | try:
|
---|
409 | n = self._parseindex(seq, all)
|
---|
410 | except Error, msg:
|
---|
411 | seqs = self.getsequences()
|
---|
412 | if not seq in seqs:
|
---|
413 | if not msg:
|
---|
414 | msg = "bad message list %s" % seq
|
---|
415 | raise Error, msg
|
---|
416 | return seqs[seq]
|
---|
417 | else:
|
---|
418 | if n not in all:
|
---|
419 | if isnumeric(seq):
|
---|
420 | raise Error, "message %d doesn't exist" % n
|
---|
421 | else:
|
---|
422 | raise Error, "no %s message" % seq
|
---|
423 | else:
|
---|
424 | return [n]
|
---|
425 |
|
---|
426 | def _parseindex(self, seq, all):
|
---|
427 | """Internal: parse a message number (or cur, first, etc.)."""
|
---|
428 | if isnumeric(seq):
|
---|
429 | try:
|
---|
430 | return int(seq)
|
---|
431 | except (OverflowError, ValueError):
|
---|
432 | return sys.maxint
|
---|
433 | if seq in ('cur', '.'):
|
---|
434 | return self.getcurrent()
|
---|
435 | if seq == 'first':
|
---|
436 | return all[0]
|
---|
437 | if seq == 'last':
|
---|
438 | return all[-1]
|
---|
439 | if seq == 'next':
|
---|
440 | n = self.getcurrent()
|
---|
441 | i = bisect(all, n)
|
---|
442 | try:
|
---|
443 | return all[i]
|
---|
444 | except IndexError:
|
---|
445 | raise Error, "no next message"
|
---|
446 | if seq == 'prev':
|
---|
447 | n = self.getcurrent()
|
---|
448 | i = bisect(all, n-1)
|
---|
449 | if i == 0:
|
---|
450 | raise Error, "no prev message"
|
---|
451 | try:
|
---|
452 | return all[i-1]
|
---|
453 | except IndexError:
|
---|
454 | raise Error, "no prev message"
|
---|
455 | raise Error, None
|
---|
456 |
|
---|
457 | def openmessage(self, n):
|
---|
458 | """Open a message -- returns a Message object."""
|
---|
459 | return Message(self, n)
|
---|
460 |
|
---|
461 | def removemessages(self, list):
|
---|
462 | """Remove one or more messages -- may raise os.error."""
|
---|
463 | errors = []
|
---|
464 | deleted = []
|
---|
465 | for n in list:
|
---|
466 | path = self.getmessagefilename(n)
|
---|
467 | commapath = self.getmessagefilename(',' + str(n))
|
---|
468 | try:
|
---|
469 | os.unlink(commapath)
|
---|
470 | except os.error:
|
---|
471 | pass
|
---|
472 | try:
|
---|
473 | os.rename(path, commapath)
|
---|
474 | except os.error, msg:
|
---|
475 | errors.append(msg)
|
---|
476 | else:
|
---|
477 | deleted.append(n)
|
---|
478 | if deleted:
|
---|
479 | self.removefromallsequences(deleted)
|
---|
480 | if errors:
|
---|
481 | if len(errors) == 1:
|
---|
482 | raise os.error, errors[0]
|
---|
483 | else:
|
---|
484 | raise os.error, ('multiple errors:', errors)
|
---|
485 |
|
---|
486 | def refilemessages(self, list, tofolder, keepsequences=0):
|
---|
487 | """Refile one or more messages -- may raise os.error.
|
---|
488 | 'tofolder' is an open folder object."""
|
---|
489 | errors = []
|
---|
490 | refiled = {}
|
---|
491 | for n in list:
|
---|
492 | ton = tofolder.getlast() + 1
|
---|
493 | path = self.getmessagefilename(n)
|
---|
494 | topath = tofolder.getmessagefilename(ton)
|
---|
495 | try:
|
---|
496 | os.rename(path, topath)
|
---|
497 | except os.error:
|
---|
498 | # Try copying
|
---|
499 | try:
|
---|
500 | shutil.copy2(path, topath)
|
---|
501 | os.unlink(path)
|
---|
502 | except (IOError, os.error), msg:
|
---|
503 | errors.append(msg)
|
---|
504 | try:
|
---|
505 | os.unlink(topath)
|
---|
506 | except os.error:
|
---|
507 | pass
|
---|
508 | continue
|
---|
509 | tofolder.setlast(ton)
|
---|
510 | refiled[n] = ton
|
---|
511 | if refiled:
|
---|
512 | if keepsequences:
|
---|
513 | tofolder._copysequences(self, refiled.items())
|
---|
514 | self.removefromallsequences(refiled.keys())
|
---|
515 | if errors:
|
---|
516 | if len(errors) == 1:
|
---|
517 | raise os.error, errors[0]
|
---|
518 | else:
|
---|
519 | raise os.error, ('multiple errors:', errors)
|
---|
520 |
|
---|
521 | def _copysequences(self, fromfolder, refileditems):
|
---|
522 | """Helper for refilemessages() to copy sequences."""
|
---|
523 | fromsequences = fromfolder.getsequences()
|
---|
524 | tosequences = self.getsequences()
|
---|
525 | changed = 0
|
---|
526 | for name, seq in fromsequences.items():
|
---|
527 | try:
|
---|
528 | toseq = tosequences[name]
|
---|
529 | new = 0
|
---|
530 | except KeyError:
|
---|
531 | toseq = []
|
---|
532 | new = 1
|
---|
533 | for fromn, ton in refileditems:
|
---|
534 | if fromn in seq:
|
---|
535 | toseq.append(ton)
|
---|
536 | changed = 1
|
---|
537 | if new and toseq:
|
---|
538 | tosequences[name] = toseq
|
---|
539 | if changed:
|
---|
540 | self.putsequences(tosequences)
|
---|
541 |
|
---|
542 | def movemessage(self, n, tofolder, ton):
|
---|
543 | """Move one message over a specific destination message,
|
---|
544 | which may or may not already exist."""
|
---|
545 | path = self.getmessagefilename(n)
|
---|
546 | # Open it to check that it exists
|
---|
547 | f = open(path)
|
---|
548 | f.close()
|
---|
549 | del f
|
---|
550 | topath = tofolder.getmessagefilename(ton)
|
---|
551 | backuptopath = tofolder.getmessagefilename(',%d' % ton)
|
---|
552 | try:
|
---|
553 | os.rename(topath, backuptopath)
|
---|
554 | except os.error:
|
---|
555 | pass
|
---|
556 | try:
|
---|
557 | os.rename(path, topath)
|
---|
558 | except os.error:
|
---|
559 | # Try copying
|
---|
560 | ok = 0
|
---|
561 | try:
|
---|
562 | tofolder.setlast(None)
|
---|
563 | shutil.copy2(path, topath)
|
---|
564 | ok = 1
|
---|
565 | finally:
|
---|
566 | if not ok:
|
---|
567 | try:
|
---|
568 | os.unlink(topath)
|
---|
569 | except os.error:
|
---|
570 | pass
|
---|
571 | os.unlink(path)
|
---|
572 | self.removefromallsequences([n])
|
---|
573 |
|
---|
574 | def copymessage(self, n, tofolder, ton):
|
---|
575 | """Copy one message over a specific destination message,
|
---|
576 | which may or may not already exist."""
|
---|
577 | path = self.getmessagefilename(n)
|
---|
578 | # Open it to check that it exists
|
---|
579 | f = open(path)
|
---|
580 | f.close()
|
---|
581 | del f
|
---|
582 | topath = tofolder.getmessagefilename(ton)
|
---|
583 | backuptopath = tofolder.getmessagefilename(',%d' % ton)
|
---|
584 | try:
|
---|
585 | os.rename(topath, backuptopath)
|
---|
586 | except os.error:
|
---|
587 | pass
|
---|
588 | ok = 0
|
---|
589 | try:
|
---|
590 | tofolder.setlast(None)
|
---|
591 | shutil.copy2(path, topath)
|
---|
592 | ok = 1
|
---|
593 | finally:
|
---|
594 | if not ok:
|
---|
595 | try:
|
---|
596 | os.unlink(topath)
|
---|
597 | except os.error:
|
---|
598 | pass
|
---|
599 |
|
---|
600 | def createmessage(self, n, txt):
|
---|
601 | """Create a message, with text from the open file txt."""
|
---|
602 | path = self.getmessagefilename(n)
|
---|
603 | backuppath = self.getmessagefilename(',%d' % n)
|
---|
604 | try:
|
---|
605 | os.rename(path, backuppath)
|
---|
606 | except os.error:
|
---|
607 | pass
|
---|
608 | ok = 0
|
---|
609 | BUFSIZE = 16*1024
|
---|
610 | try:
|
---|
611 | f = open(path, "w")
|
---|
612 | while 1:
|
---|
613 | buf = txt.read(BUFSIZE)
|
---|
614 | if not buf:
|
---|
615 | break
|
---|
616 | f.write(buf)
|
---|
617 | f.close()
|
---|
618 | ok = 1
|
---|
619 | finally:
|
---|
620 | if not ok:
|
---|
621 | try:
|
---|
622 | os.unlink(path)
|
---|
623 | except os.error:
|
---|
624 | pass
|
---|
625 |
|
---|
626 | def removefromallsequences(self, list):
|
---|
627 | """Remove one or more messages from all sequences (including last)
|
---|
628 | -- but not from 'cur'!!!"""
|
---|
629 | if hasattr(self, 'last') and self.last in list:
|
---|
630 | del self.last
|
---|
631 | sequences = self.getsequences()
|
---|
632 | changed = 0
|
---|
633 | for name, seq in sequences.items():
|
---|
634 | if name == 'cur':
|
---|
635 | continue
|
---|
636 | for n in list:
|
---|
637 | if n in seq:
|
---|
638 | seq.remove(n)
|
---|
639 | changed = 1
|
---|
640 | if not seq:
|
---|
641 | del sequences[name]
|
---|
642 | if changed:
|
---|
643 | self.putsequences(sequences)
|
---|
644 |
|
---|
645 | def getlast(self):
|
---|
646 | """Return the last message number."""
|
---|
647 | if not hasattr(self, 'last'):
|
---|
648 | self.listmessages() # Set self.last
|
---|
649 | return self.last
|
---|
650 |
|
---|
651 | def setlast(self, last):
|
---|
652 | """Set the last message number."""
|
---|
653 | if last is None:
|
---|
654 | if hasattr(self, 'last'):
|
---|
655 | del self.last
|
---|
656 | else:
|
---|
657 | self.last = last
|
---|
658 |
|
---|
659 | class Message(mimetools.Message):
|
---|
660 |
|
---|
661 | def __init__(self, f, n, fp = None):
|
---|
662 | """Constructor."""
|
---|
663 | self.folder = f
|
---|
664 | self.number = n
|
---|
665 | if fp is None:
|
---|
666 | path = f.getmessagefilename(n)
|
---|
667 | fp = open(path, 'r')
|
---|
668 | mimetools.Message.__init__(self, fp)
|
---|
669 |
|
---|
670 | def __repr__(self):
|
---|
671 | """String representation."""
|
---|
672 | return 'Message(%s, %s)' % (repr(self.folder), self.number)
|
---|
673 |
|
---|
674 | def getheadertext(self, pred = None):
|
---|
675 | """Return the message's header text as a string. If an
|
---|
676 | argument is specified, it is used as a filter predicate to
|
---|
677 | decide which headers to return (its argument is the header
|
---|
678 | name converted to lower case)."""
|
---|
679 | if pred is None:
|
---|
680 | return ''.join(self.headers)
|
---|
681 | headers = []
|
---|
682 | hit = 0
|
---|
683 | for line in self.headers:
|
---|
684 | if not line[0].isspace():
|
---|
685 | i = line.find(':')
|
---|
686 | if i > 0:
|
---|
687 | hit = pred(line[:i].lower())
|
---|
688 | if hit: headers.append(line)
|
---|
689 | return ''.join(headers)
|
---|
690 |
|
---|
691 | def getbodytext(self, decode = 1):
|
---|
692 | """Return the message's body text as string. This undoes a
|
---|
693 | Content-Transfer-Encoding, but does not interpret other MIME
|
---|
694 | features (e.g. multipart messages). To suppress decoding,
|
---|
695 | pass 0 as an argument."""
|
---|
696 | self.fp.seek(self.startofbody)
|
---|
697 | encoding = self.getencoding()
|
---|
698 | if not decode or encoding in ('', '7bit', '8bit', 'binary'):
|
---|
699 | return self.fp.read()
|
---|
700 | try:
|
---|
701 | from cStringIO import StringIO
|
---|
702 | except ImportError:
|
---|
703 | from StringIO import StringIO
|
---|
704 | output = StringIO()
|
---|
705 | mimetools.decode(self.fp, output, encoding)
|
---|
706 | return output.getvalue()
|
---|
707 |
|
---|
708 | def getbodyparts(self):
|
---|
709 | """Only for multipart messages: return the message's body as a
|
---|
710 | list of SubMessage objects. Each submessage object behaves
|
---|
711 | (almost) as a Message object."""
|
---|
712 | if self.getmaintype() != 'multipart':
|
---|
713 | raise Error, 'Content-Type is not multipart/*'
|
---|
714 | bdry = self.getparam('boundary')
|
---|
715 | if not bdry:
|
---|
716 | raise Error, 'multipart/* without boundary param'
|
---|
717 | self.fp.seek(self.startofbody)
|
---|
718 | mf = multifile.MultiFile(self.fp)
|
---|
719 | mf.push(bdry)
|
---|
720 | parts = []
|
---|
721 | while mf.next():
|
---|
722 | n = "%s.%r" % (self.number, 1 + len(parts))
|
---|
723 | part = SubMessage(self.folder, n, mf)
|
---|
724 | parts.append(part)
|
---|
725 | mf.pop()
|
---|
726 | return parts
|
---|
727 |
|
---|
728 | def getbody(self):
|
---|
729 | """Return body, either a string or a list of messages."""
|
---|
730 | if self.getmaintype() == 'multipart':
|
---|
731 | return self.getbodyparts()
|
---|
732 | else:
|
---|
733 | return self.getbodytext()
|
---|
734 |
|
---|
735 |
|
---|
736 | class SubMessage(Message):
|
---|
737 |
|
---|
738 | def __init__(self, f, n, fp):
|
---|
739 | """Constructor."""
|
---|
740 | Message.__init__(self, f, n, fp)
|
---|
741 | if self.getmaintype() == 'multipart':
|
---|
742 | self.body = Message.getbodyparts(self)
|
---|
743 | else:
|
---|
744 | self.body = Message.getbodytext(self)
|
---|
745 | self.bodyencoded = Message.getbodytext(self, decode=0)
|
---|
746 | # XXX If this is big, should remember file pointers
|
---|
747 |
|
---|
748 | def __repr__(self):
|
---|
749 | """String representation."""
|
---|
750 | f, n, fp = self.folder, self.number, self.fp
|
---|
751 | return 'SubMessage(%s, %s, %s)' % (f, n, fp)
|
---|
752 |
|
---|
753 | def getbodytext(self, decode = 1):
|
---|
754 | if not decode:
|
---|
755 | return self.bodyencoded
|
---|
756 | if type(self.body) == type(''):
|
---|
757 | return self.body
|
---|
758 |
|
---|
759 | def getbodyparts(self):
|
---|
760 | if type(self.body) == type([]):
|
---|
761 | return self.body
|
---|
762 |
|
---|
763 | def getbody(self):
|
---|
764 | return self.body
|
---|
765 |
|
---|
766 |
|
---|
767 | class IntSet:
|
---|
768 | """Class implementing sets of integers.
|
---|
769 |
|
---|
770 | This is an efficient representation for sets consisting of several
|
---|
771 | continuous ranges, e.g. 1-100,200-400,402-1000 is represented
|
---|
772 | internally as a list of three pairs: [(1,100), (200,400),
|
---|
773 | (402,1000)]. The internal representation is always kept normalized.
|
---|
774 |
|
---|
775 | The constructor has up to three arguments:
|
---|
776 | - the string used to initialize the set (default ''),
|
---|
777 | - the separator between ranges (default ',')
|
---|
778 | - the separator between begin and end of a range (default '-')
|
---|
779 | The separators must be strings (not regexprs) and should be different.
|
---|
780 |
|
---|
781 | The tostring() function yields a string that can be passed to another
|
---|
782 | IntSet constructor; __repr__() is a valid IntSet constructor itself.
|
---|
783 | """
|
---|
784 |
|
---|
785 | # XXX The default begin/end separator means that negative numbers are
|
---|
786 | # not supported very well.
|
---|
787 | #
|
---|
788 | # XXX There are currently no operations to remove set elements.
|
---|
789 |
|
---|
790 | def __init__(self, data = None, sep = ',', rng = '-'):
|
---|
791 | self.pairs = []
|
---|
792 | self.sep = sep
|
---|
793 | self.rng = rng
|
---|
794 | if data: self.fromstring(data)
|
---|
795 |
|
---|
796 | def reset(self):
|
---|
797 | self.pairs = []
|
---|
798 |
|
---|
799 | def __cmp__(self, other):
|
---|
800 | return cmp(self.pairs, other.pairs)
|
---|
801 |
|
---|
802 | def __hash__(self):
|
---|
803 | return hash(self.pairs)
|
---|
804 |
|
---|
805 | def __repr__(self):
|
---|
806 | return 'IntSet(%r, %r, %r)' % (self.tostring(), self.sep, self.rng)
|
---|
807 |
|
---|
808 | def normalize(self):
|
---|
809 | self.pairs.sort()
|
---|
810 | i = 1
|
---|
811 | while i < len(self.pairs):
|
---|
812 | alo, ahi = self.pairs[i-1]
|
---|
813 | blo, bhi = self.pairs[i]
|
---|
814 | if ahi >= blo-1:
|
---|
815 | self.pairs[i-1:i+1] = [(alo, max(ahi, bhi))]
|
---|
816 | else:
|
---|
817 | i = i+1
|
---|
818 |
|
---|
819 | def tostring(self):
|
---|
820 | s = ''
|
---|
821 | for lo, hi in self.pairs:
|
---|
822 | if lo == hi: t = repr(lo)
|
---|
823 | else: t = repr(lo) + self.rng + repr(hi)
|
---|
824 | if s: s = s + (self.sep + t)
|
---|
825 | else: s = t
|
---|
826 | return s
|
---|
827 |
|
---|
828 | def tolist(self):
|
---|
829 | l = []
|
---|
830 | for lo, hi in self.pairs:
|
---|
831 | m = range(lo, hi+1)
|
---|
832 | l = l + m
|
---|
833 | return l
|
---|
834 |
|
---|
835 | def fromlist(self, list):
|
---|
836 | for i in list:
|
---|
837 | self.append(i)
|
---|
838 |
|
---|
839 | def clone(self):
|
---|
840 | new = IntSet()
|
---|
841 | new.pairs = self.pairs[:]
|
---|
842 | return new
|
---|
843 |
|
---|
844 | def min(self):
|
---|
845 | return self.pairs[0][0]
|
---|
846 |
|
---|
847 | def max(self):
|
---|
848 | return self.pairs[-1][-1]
|
---|
849 |
|
---|
850 | def contains(self, x):
|
---|
851 | for lo, hi in self.pairs:
|
---|
852 | if lo <= x <= hi: return True
|
---|
853 | return False
|
---|
854 |
|
---|
855 | def append(self, x):
|
---|
856 | for i in range(len(self.pairs)):
|
---|
857 | lo, hi = self.pairs[i]
|
---|
858 | if x < lo: # Need to insert before
|
---|
859 | if x+1 == lo:
|
---|
860 | self.pairs[i] = (x, hi)
|
---|
861 | else:
|
---|
862 | self.pairs.insert(i, (x, x))
|
---|
863 | if i > 0 and x-1 == self.pairs[i-1][1]:
|
---|
864 | # Merge with previous
|
---|
865 | self.pairs[i-1:i+1] = [
|
---|
866 | (self.pairs[i-1][0],
|
---|
867 | self.pairs[i][1])
|
---|
868 | ]
|
---|
869 | return
|
---|
870 | if x <= hi: # Already in set
|
---|
871 | return
|
---|
872 | i = len(self.pairs) - 1
|
---|
873 | if i >= 0:
|
---|
874 | lo, hi = self.pairs[i]
|
---|
875 | if x-1 == hi:
|
---|
876 | self.pairs[i] = lo, x
|
---|
877 | return
|
---|
878 | self.pairs.append((x, x))
|
---|
879 |
|
---|
880 | def addpair(self, xlo, xhi):
|
---|
881 | if xlo > xhi: return
|
---|
882 | self.pairs.append((xlo, xhi))
|
---|
883 | self.normalize()
|
---|
884 |
|
---|
885 | def fromstring(self, data):
|
---|
886 | new = []
|
---|
887 | for part in data.split(self.sep):
|
---|
888 | list = []
|
---|
889 | for subp in part.split(self.rng):
|
---|
890 | s = subp.strip()
|
---|
891 | list.append(int(s))
|
---|
892 | if len(list) == 1:
|
---|
893 | new.append((list[0], list[0]))
|
---|
894 | elif len(list) == 2 and list[0] <= list[1]:
|
---|
895 | new.append((list[0], list[1]))
|
---|
896 | else:
|
---|
897 | raise ValueError, 'bad data passed to IntSet'
|
---|
898 | self.pairs = self.pairs + new
|
---|
899 | self.normalize()
|
---|
900 |
|
---|
901 |
|
---|
902 | # Subroutines to read/write entries in .mh_profile and .mh_sequences
|
---|
903 |
|
---|
904 | def pickline(file, key, casefold = 1):
|
---|
905 | try:
|
---|
906 | f = open(file, 'r')
|
---|
907 | except IOError:
|
---|
908 | return None
|
---|
909 | pat = re.escape(key) + ':'
|
---|
910 | prog = re.compile(pat, casefold and re.IGNORECASE)
|
---|
911 | while 1:
|
---|
912 | line = f.readline()
|
---|
913 | if not line: break
|
---|
914 | if prog.match(line):
|
---|
915 | text = line[len(key)+1:]
|
---|
916 | while 1:
|
---|
917 | line = f.readline()
|
---|
918 | if not line or not line[0].isspace():
|
---|
919 | break
|
---|
920 | text = text + line
|
---|
921 | return text.strip()
|
---|
922 | return None
|
---|
923 |
|
---|
924 | def updateline(file, key, value, casefold = 1):
|
---|
925 | try:
|
---|
926 | f = open(file, 'r')
|
---|
927 | lines = f.readlines()
|
---|
928 | f.close()
|
---|
929 | except IOError:
|
---|
930 | lines = []
|
---|
931 | pat = re.escape(key) + ':(.*)\n'
|
---|
932 | prog = re.compile(pat, casefold and re.IGNORECASE)
|
---|
933 | if value is None:
|
---|
934 | newline = None
|
---|
935 | else:
|
---|
936 | newline = '%s: %s\n' % (key, value)
|
---|
937 | for i in range(len(lines)):
|
---|
938 | line = lines[i]
|
---|
939 | if prog.match(line):
|
---|
940 | if newline is None:
|
---|
941 | del lines[i]
|
---|
942 | else:
|
---|
943 | lines[i] = newline
|
---|
944 | break
|
---|
945 | else:
|
---|
946 | if newline is not None:
|
---|
947 | lines.append(newline)
|
---|
948 | tempfile = file + "~"
|
---|
949 | f = open(tempfile, 'w')
|
---|
950 | for line in lines:
|
---|
951 | f.write(line)
|
---|
952 | f.close()
|
---|
953 | os.rename(tempfile, file)
|
---|
954 |
|
---|
955 |
|
---|
956 | # Test program
|
---|
957 |
|
---|
958 | def test():
|
---|
959 | global mh, f
|
---|
960 | os.system('rm -rf $HOME/Mail/@test')
|
---|
961 | mh = MH()
|
---|
962 | def do(s): print s; print eval(s)
|
---|
963 | do('mh.listfolders()')
|
---|
964 | do('mh.listallfolders()')
|
---|
965 | testfolders = ['@test', '@test/test1', '@test/test2',
|
---|
966 | '@test/test1/test11', '@test/test1/test12',
|
---|
967 | '@test/test1/test11/test111']
|
---|
968 | for t in testfolders: do('mh.makefolder(%r)' % (t,))
|
---|
969 | do('mh.listsubfolders(\'@test\')')
|
---|
970 | do('mh.listallsubfolders(\'@test\')')
|
---|
971 | f = mh.openfolder('@test')
|
---|
972 | do('f.listsubfolders()')
|
---|
973 | do('f.listallsubfolders()')
|
---|
974 | do('f.getsequences()')
|
---|
975 | seqs = f.getsequences()
|
---|
976 | seqs['foo'] = IntSet('1-10 12-20', ' ').tolist()
|
---|
977 | print seqs
|
---|
978 | f.putsequences(seqs)
|
---|
979 | do('f.getsequences()')
|
---|
980 | for t in reversed(testfolders): do('mh.deletefolder(%r)' % (t,))
|
---|
981 | do('mh.getcontext()')
|
---|
982 | context = mh.getcontext()
|
---|
983 | f = mh.openfolder(context)
|
---|
984 | do('f.getcurrent()')
|
---|
985 | for seq in ('first', 'last', 'cur', '.', 'prev', 'next',
|
---|
986 | 'first:3', 'last:3', 'cur:3', 'cur:-3',
|
---|
987 | 'prev:3', 'next:3',
|
---|
988 | '1:3', '1:-3', '100:3', '100:-3', '10000:3', '10000:-3',
|
---|
989 | 'all'):
|
---|
990 | try:
|
---|
991 | do('f.parsesequence(%r)' % (seq,))
|
---|
992 | except Error, msg:
|
---|
993 | print "Error:", msg
|
---|
994 | stuff = os.popen("pick %r 2>/dev/null" % (seq,)).read()
|
---|
995 | list = map(int, stuff.split())
|
---|
996 | print list, "<-- pick"
|
---|
997 | do('f.listmessages()')
|
---|
998 |
|
---|
999 |
|
---|
1000 | if __name__ == '__main__':
|
---|
1001 | test()
|
---|