blob: a6494dcbeabf55b14cf6af8006fd598c74c8916b [file] [log] [blame]
Fred Drake0aaed272000-10-23 13:39:15 +00001import os
Neal Norwitz003c9e22006-08-11 06:09:41 +00002import sys
Fred Drakec02bc3e2001-05-21 20:23:21 +00003import time
Andrew M. Kuchling1da4a942006-04-22 02:32:43 +00004import stat
5import socket
6import email
Georg Brandl5a096e12007-01-22 19:40:21 +00007import email.message
Andrew M. Kuchling1da4a942006-04-22 02:32:43 +00008import rfc822
9import re
10import StringIO
Barry Warsaw04f357c2002-07-23 19:04:11 +000011from test import test_support
Andrew M. Kuchling1da4a942006-04-22 02:32:43 +000012import unittest
13import mailbox
14import glob
Guido van Rossum75ebb292001-04-10 15:01:20 +000015try:
Andrew M. Kuchling1da4a942006-04-22 02:32:43 +000016 import fcntl
17except ImportError:
Guido van Rossum75ebb292001-04-10 15:01:20 +000018 pass
19
Andrew M. Kuchling1da4a942006-04-22 02:32:43 +000020
21class TestBase(unittest.TestCase):
22
23 def _check_sample(self, msg):
24 # Inspect a mailbox.Message representation of the sample message
Georg Brandl5a096e12007-01-22 19:40:21 +000025 self.assert_(isinstance(msg, email.message.Message))
Andrew M. Kuchling1da4a942006-04-22 02:32:43 +000026 self.assert_(isinstance(msg, mailbox.Message))
27 for key, value in _sample_headers.iteritems():
28 self.assert_(value in msg.get_all(key))
29 self.assert_(msg.is_multipart())
30 self.assert_(len(msg.get_payload()) == len(_sample_payloads))
31 for i, payload in enumerate(_sample_payloads):
32 part = msg.get_payload(i)
Georg Brandl5a096e12007-01-22 19:40:21 +000033 self.assert_(isinstance(part, email.message.Message))
Andrew M. Kuchling1da4a942006-04-22 02:32:43 +000034 self.assert_(not isinstance(part, mailbox.Message))
35 self.assert_(part.get_payload() == payload)
36
37 def _delete_recursively(self, target):
38 # Delete a file or delete a directory recursively
39 if os.path.isdir(target):
40 for path, dirs, files in os.walk(target, topdown=False):
41 for name in files:
42 os.remove(os.path.join(path, name))
43 for name in dirs:
44 os.rmdir(os.path.join(path, name))
45 os.rmdir(target)
46 elif os.path.exists(target):
47 os.remove(target)
48
49
50class TestMailbox(TestBase):
51
52 _factory = None # Overridden by subclasses to reuse tests
53 _template = 'From: foo\n\n%s'
54
55 def setUp(self):
56 self._path = test_support.TESTFN
Neal Norwitzb0a7d4e2007-03-20 06:16:26 +000057 self._delete_recursively(self._path)
Andrew M. Kuchling1da4a942006-04-22 02:32:43 +000058 self._box = self._factory(self._path)
59
60 def tearDown(self):
61 self._box.close()
62 self._delete_recursively(self._path)
63
64 def test_add(self):
65 # Add copies of a sample message
66 keys = []
67 keys.append(self._box.add(self._template % 0))
68 self.assert_(len(self._box) == 1)
69 keys.append(self._box.add(mailbox.Message(_sample_message)))
70 self.assert_(len(self._box) == 2)
71 keys.append(self._box.add(email.message_from_string(_sample_message)))
72 self.assert_(len(self._box) == 3)
73 keys.append(self._box.add(StringIO.StringIO(_sample_message)))
74 self.assert_(len(self._box) == 4)
75 keys.append(self._box.add(_sample_message))
76 self.assert_(len(self._box) == 5)
77 self.assert_(self._box.get_string(keys[0]) == self._template % 0)
78 for i in (1, 2, 3, 4):
79 self._check_sample(self._box[keys[i]])
80
81 def test_remove(self):
82 # Remove messages using remove()
83 self._test_remove_or_delitem(self._box.remove)
84
85 def test_delitem(self):
86 # Remove messages using __delitem__()
87 self._test_remove_or_delitem(self._box.__delitem__)
88
89 def _test_remove_or_delitem(self, method):
90 # (Used by test_remove() and test_delitem().)
91 key0 = self._box.add(self._template % 0)
92 key1 = self._box.add(self._template % 1)
93 self.assert_(len(self._box) == 2)
94 method(key0)
95 l = len(self._box)
96 self.assert_(l == 1, "actual l: %s" % l)
97 self.assertRaises(KeyError, lambda: self._box[key0])
98 self.assertRaises(KeyError, lambda: method(key0))
99 self.assert_(self._box.get_string(key1) == self._template % 1)
100 key2 = self._box.add(self._template % 2)
101 self.assert_(len(self._box) == 2)
102 method(key2)
103 l = len(self._box)
104 self.assert_(l == 1, "actual l: %s" % l)
105 self.assertRaises(KeyError, lambda: self._box[key2])
106 self.assertRaises(KeyError, lambda: method(key2))
107 self.assert_(self._box.get_string(key1) == self._template % 1)
108 method(key1)
109 self.assert_(len(self._box) == 0)
110 self.assertRaises(KeyError, lambda: self._box[key1])
111 self.assertRaises(KeyError, lambda: method(key1))
112
113 def test_discard(self, repetitions=10):
114 # Discard messages
115 key0 = self._box.add(self._template % 0)
116 key1 = self._box.add(self._template % 1)
117 self.assert_(len(self._box) == 2)
118 self._box.discard(key0)
119 self.assert_(len(self._box) == 1)
120 self.assertRaises(KeyError, lambda: self._box[key0])
121 self._box.discard(key0)
122 self.assert_(len(self._box) == 1)
123 self.assertRaises(KeyError, lambda: self._box[key0])
124
125 def test_get(self):
126 # Retrieve messages using get()
127 key0 = self._box.add(self._template % 0)
128 msg = self._box.get(key0)
129 self.assert_(msg['from'] == 'foo')
130 self.assert_(msg.get_payload() == '0')
131 self.assert_(self._box.get('foo') is None)
132 self.assert_(self._box.get('foo', False) is False)
133 self._box.close()
134 self._box = self._factory(self._path, factory=rfc822.Message)
135 key1 = self._box.add(self._template % 1)
136 msg = self._box.get(key1)
137 self.assert_(msg['from'] == 'foo')
138 self.assert_(msg.fp.read() == '1')
139
140 def test_getitem(self):
141 # Retrieve message using __getitem__()
142 key0 = self._box.add(self._template % 0)
143 msg = self._box[key0]
144 self.assert_(msg['from'] == 'foo')
145 self.assert_(msg.get_payload() == '0')
146 self.assertRaises(KeyError, lambda: self._box['foo'])
147 self._box.discard(key0)
148 self.assertRaises(KeyError, lambda: self._box[key0])
149
150 def test_get_message(self):
151 # Get Message representations of messages
152 key0 = self._box.add(self._template % 0)
153 key1 = self._box.add(_sample_message)
154 msg0 = self._box.get_message(key0)
155 self.assert_(isinstance(msg0, mailbox.Message))
156 self.assert_(msg0['from'] == 'foo')
157 self.assert_(msg0.get_payload() == '0')
158 self._check_sample(self._box.get_message(key1))
159
160 def test_get_string(self):
161 # Get string representations of messages
162 key0 = self._box.add(self._template % 0)
163 key1 = self._box.add(_sample_message)
164 self.assert_(self._box.get_string(key0) == self._template % 0)
165 self.assert_(self._box.get_string(key1) == _sample_message)
166
167 def test_get_file(self):
168 # Get file representations of messages
169 key0 = self._box.add(self._template % 0)
170 key1 = self._box.add(_sample_message)
171 self.assert_(self._box.get_file(key0).read().replace(os.linesep, '\n')
172 == self._template % 0)
173 self.assert_(self._box.get_file(key1).read().replace(os.linesep, '\n')
174 == _sample_message)
175
176 def test_iterkeys(self):
177 # Get keys using iterkeys()
178 self._check_iteration(self._box.iterkeys, do_keys=True, do_values=False)
179
180 def test_keys(self):
181 # Get keys using keys()
182 self._check_iteration(self._box.keys, do_keys=True, do_values=False)
183
184 def test_itervalues(self):
185 # Get values using itervalues()
186 self._check_iteration(self._box.itervalues, do_keys=False,
187 do_values=True)
188
189 def test_iter(self):
190 # Get values using __iter__()
191 self._check_iteration(self._box.__iter__, do_keys=False,
192 do_values=True)
193
194 def test_values(self):
195 # Get values using values()
196 self._check_iteration(self._box.values, do_keys=False, do_values=True)
197
198 def test_iteritems(self):
199 # Get keys and values using iteritems()
200 self._check_iteration(self._box.iteritems, do_keys=True,
201 do_values=True)
202
203 def test_items(self):
204 # Get keys and values using items()
205 self._check_iteration(self._box.items, do_keys=True, do_values=True)
206
207 def _check_iteration(self, method, do_keys, do_values, repetitions=10):
208 for value in method():
209 self.fail("Not empty")
210 keys, values = [], []
211 for i in xrange(repetitions):
212 keys.append(self._box.add(self._template % i))
213 values.append(self._template % i)
214 if do_keys and not do_values:
215 returned_keys = list(method())
216 elif do_values and not do_keys:
217 returned_values = list(method())
218 else:
219 returned_keys, returned_values = [], []
220 for key, value in method():
221 returned_keys.append(key)
222 returned_values.append(value)
223 if do_keys:
224 self.assert_(len(keys) == len(returned_keys))
225 self.assert_(set(keys) == set(returned_keys))
226 if do_values:
227 count = 0
228 for value in returned_values:
229 self.assert_(value['from'] == 'foo')
230 self.assert_(int(value.get_payload()) < repetitions)
231 count += 1
232 self.assert_(len(values) == count)
233
234 def test_has_key(self):
235 # Check existence of keys using has_key()
236 self._test_has_key_or_contains(self._box.has_key)
237
238 def test_contains(self):
239 # Check existence of keys using __contains__()
240 self._test_has_key_or_contains(self._box.__contains__)
241
242 def _test_has_key_or_contains(self, method):
243 # (Used by test_has_key() and test_contains().)
244 self.assert_(not method('foo'))
245 key0 = self._box.add(self._template % 0)
246 self.assert_(method(key0))
247 self.assert_(not method('foo'))
248 key1 = self._box.add(self._template % 1)
249 self.assert_(method(key1))
250 self.assert_(method(key0))
251 self.assert_(not method('foo'))
252 self._box.remove(key0)
253 self.assert_(not method(key0))
254 self.assert_(method(key1))
255 self.assert_(not method('foo'))
256 self._box.remove(key1)
257 self.assert_(not method(key1))
258 self.assert_(not method(key0))
259 self.assert_(not method('foo'))
260
261 def test_len(self, repetitions=10):
262 # Get message count
263 keys = []
264 for i in xrange(repetitions):
265 self.assert_(len(self._box) == i)
266 keys.append(self._box.add(self._template % i))
267 self.assert_(len(self._box) == i + 1)
268 for i in xrange(repetitions):
269 self.assert_(len(self._box) == repetitions - i)
270 self._box.remove(keys[i])
271 self.assert_(len(self._box) == repetitions - i - 1)
272
273 def test_set_item(self):
274 # Modify messages using __setitem__()
275 key0 = self._box.add(self._template % 'original 0')
276 self.assert_(self._box.get_string(key0) == \
277 self._template % 'original 0')
278 key1 = self._box.add(self._template % 'original 1')
279 self.assert_(self._box.get_string(key1) == \
280 self._template % 'original 1')
281 self._box[key0] = self._template % 'changed 0'
282 self.assert_(self._box.get_string(key0) == \
283 self._template % 'changed 0')
284 self._box[key1] = self._template % 'changed 1'
285 self.assert_(self._box.get_string(key1) == \
286 self._template % 'changed 1')
287 self._box[key0] = _sample_message
288 self._check_sample(self._box[key0])
289 self._box[key1] = self._box[key0]
290 self._check_sample(self._box[key1])
291 self._box[key0] = self._template % 'original 0'
292 self.assert_(self._box.get_string(key0) ==
293 self._template % 'original 0')
294 self._check_sample(self._box[key1])
295 self.assertRaises(KeyError,
296 lambda: self._box.__setitem__('foo', 'bar'))
297 self.assertRaises(KeyError, lambda: self._box['foo'])
298 self.assert_(len(self._box) == 2)
299
300 def test_clear(self, iterations=10):
301 # Remove all messages using clear()
302 keys = []
303 for i in xrange(iterations):
304 self._box.add(self._template % i)
305 for i, key in enumerate(keys):
306 self.assert_(self._box.get_string(key) == self._template % i)
307 self._box.clear()
308 self.assert_(len(self._box) == 0)
309 for i, key in enumerate(keys):
310 self.assertRaises(KeyError, lambda: self._box.get_string(key))
311
312 def test_pop(self):
313 # Get and remove a message using pop()
314 key0 = self._box.add(self._template % 0)
315 self.assert_(key0 in self._box)
316 key1 = self._box.add(self._template % 1)
317 self.assert_(key1 in self._box)
318 self.assert_(self._box.pop(key0).get_payload() == '0')
319 self.assert_(key0 not in self._box)
320 self.assert_(key1 in self._box)
321 key2 = self._box.add(self._template % 2)
322 self.assert_(key2 in self._box)
323 self.assert_(self._box.pop(key2).get_payload() == '2')
324 self.assert_(key2 not in self._box)
325 self.assert_(key1 in self._box)
326 self.assert_(self._box.pop(key1).get_payload() == '1')
327 self.assert_(key1 not in self._box)
328 self.assert_(len(self._box) == 0)
329
330 def test_popitem(self, iterations=10):
331 # Get and remove an arbitrary (key, message) using popitem()
332 keys = []
333 for i in xrange(10):
334 keys.append(self._box.add(self._template % i))
335 seen = []
336 for i in xrange(10):
337 key, msg = self._box.popitem()
338 self.assert_(key in keys)
339 self.assert_(key not in seen)
340 seen.append(key)
341 self.assert_(int(msg.get_payload()) == keys.index(key))
342 self.assert_(len(self._box) == 0)
343 for key in keys:
344 self.assertRaises(KeyError, lambda: self._box[key])
345
346 def test_update(self):
347 # Modify multiple messages using update()
348 key0 = self._box.add(self._template % 'original 0')
349 key1 = self._box.add(self._template % 'original 1')
350 key2 = self._box.add(self._template % 'original 2')
351 self._box.update({key0: self._template % 'changed 0',
352 key2: _sample_message})
353 self.assert_(len(self._box) == 3)
354 self.assert_(self._box.get_string(key0) ==
355 self._template % 'changed 0')
356 self.assert_(self._box.get_string(key1) ==
357 self._template % 'original 1')
358 self._check_sample(self._box[key2])
359 self._box.update([(key2, self._template % 'changed 2'),
360 (key1, self._template % 'changed 1'),
361 (key0, self._template % 'original 0')])
362 self.assert_(len(self._box) == 3)
363 self.assert_(self._box.get_string(key0) ==
364 self._template % 'original 0')
365 self.assert_(self._box.get_string(key1) ==
366 self._template % 'changed 1')
367 self.assert_(self._box.get_string(key2) ==
368 self._template % 'changed 2')
369 self.assertRaises(KeyError,
370 lambda: self._box.update({'foo': 'bar',
371 key0: self._template % "changed 0"}))
372 self.assert_(len(self._box) == 3)
373 self.assert_(self._box.get_string(key0) ==
374 self._template % "changed 0")
375 self.assert_(self._box.get_string(key1) ==
376 self._template % "changed 1")
377 self.assert_(self._box.get_string(key2) ==
378 self._template % "changed 2")
379
380 def test_flush(self):
381 # Write changes to disk
Neal Norwitz22b3e3a2008-03-26 05:19:41 +0000382 self._test_flush_or_close(self._box.flush, True)
Andrew M. Kuchling1da4a942006-04-22 02:32:43 +0000383
384 def test_lock_unlock(self):
385 # Lock and unlock the mailbox
386 self.assert_(not os.path.exists(self._get_lock_path()))
387 self._box.lock()
388 self.assert_(os.path.exists(self._get_lock_path()))
389 self._box.unlock()
390 self.assert_(not os.path.exists(self._get_lock_path()))
391
392 def test_close(self):
393 # Close mailbox and flush changes to disk
Neal Norwitz22b3e3a2008-03-26 05:19:41 +0000394 self._test_flush_or_close(self._box.close, False)
Andrew M. Kuchling1da4a942006-04-22 02:32:43 +0000395
Neal Norwitz22b3e3a2008-03-26 05:19:41 +0000396 def _test_flush_or_close(self, method, should_call_close):
Andrew M. Kuchling1da4a942006-04-22 02:32:43 +0000397 contents = [self._template % i for i in xrange(3)]
398 self._box.add(contents[0])
399 self._box.add(contents[1])
400 self._box.add(contents[2])
401 method()
Neal Norwitz22b3e3a2008-03-26 05:19:41 +0000402 if should_call_close:
403 self._box.close()
Andrew M. Kuchling1da4a942006-04-22 02:32:43 +0000404 self._box = self._factory(self._path)
405 keys = self._box.keys()
406 self.assert_(len(keys) == 3)
407 for key in keys:
408 self.assert_(self._box.get_string(key) in contents)
409
410 def test_dump_message(self):
411 # Write message representations to disk
412 for input in (email.message_from_string(_sample_message),
413 _sample_message, StringIO.StringIO(_sample_message)):
414 output = StringIO.StringIO()
415 self._box._dump_message(input, output)
416 self.assert_(output.getvalue() ==
417 _sample_message.replace('\n', os.linesep))
418 output = StringIO.StringIO()
419 self.assertRaises(TypeError,
420 lambda: self._box._dump_message(None, output))
421
422 def _get_lock_path(self):
423 # Return the path of the dot lock file. May be overridden.
424 return self._path + '.lock'
425
426
427class TestMailboxSuperclass(TestBase):
428
429 def test_notimplemented(self):
430 # Test that all Mailbox methods raise NotImplementedException.
431 box = mailbox.Mailbox('path')
432 self.assertRaises(NotImplementedError, lambda: box.add(''))
433 self.assertRaises(NotImplementedError, lambda: box.remove(''))
434 self.assertRaises(NotImplementedError, lambda: box.__delitem__(''))
435 self.assertRaises(NotImplementedError, lambda: box.discard(''))
436 self.assertRaises(NotImplementedError, lambda: box.__setitem__('', ''))
437 self.assertRaises(NotImplementedError, lambda: box.iterkeys())
438 self.assertRaises(NotImplementedError, lambda: box.keys())
439 self.assertRaises(NotImplementedError, lambda: box.itervalues().next())
440 self.assertRaises(NotImplementedError, lambda: box.__iter__().next())
441 self.assertRaises(NotImplementedError, lambda: box.values())
442 self.assertRaises(NotImplementedError, lambda: box.iteritems().next())
443 self.assertRaises(NotImplementedError, lambda: box.items())
444 self.assertRaises(NotImplementedError, lambda: box.get(''))
445 self.assertRaises(NotImplementedError, lambda: box.__getitem__(''))
446 self.assertRaises(NotImplementedError, lambda: box.get_message(''))
447 self.assertRaises(NotImplementedError, lambda: box.get_string(''))
448 self.assertRaises(NotImplementedError, lambda: box.get_file(''))
449 self.assertRaises(NotImplementedError, lambda: box.has_key(''))
450 self.assertRaises(NotImplementedError, lambda: box.__contains__(''))
451 self.assertRaises(NotImplementedError, lambda: box.__len__())
452 self.assertRaises(NotImplementedError, lambda: box.clear())
453 self.assertRaises(NotImplementedError, lambda: box.pop(''))
454 self.assertRaises(NotImplementedError, lambda: box.popitem())
455 self.assertRaises(NotImplementedError, lambda: box.update((('', ''),)))
456 self.assertRaises(NotImplementedError, lambda: box.flush())
457 self.assertRaises(NotImplementedError, lambda: box.lock())
458 self.assertRaises(NotImplementedError, lambda: box.unlock())
459 self.assertRaises(NotImplementedError, lambda: box.close())
460
461
462class TestMaildir(TestMailbox):
463
464 _factory = lambda self, path, factory=None: mailbox.Maildir(path, factory)
465
466 def setUp(self):
467 TestMailbox.setUp(self)
Neal Norwitz003c9e22006-08-11 06:09:41 +0000468 if os.name in ('nt', 'os2') or sys.platform == 'cygwin':
Andrew M. Kuchling1da4a942006-04-22 02:32:43 +0000469 self._box.colon = '!'
470
471 def test_add_MM(self):
472 # Add a MaildirMessage instance
473 msg = mailbox.MaildirMessage(self._template % 0)
474 msg.set_subdir('cur')
475 msg.set_info('foo')
476 key = self._box.add(msg)
477 self.assert_(os.path.exists(os.path.join(self._path, 'cur', '%s%sfoo' %
478 (key, self._box.colon))))
479
480 def test_get_MM(self):
481 # Get a MaildirMessage instance
482 msg = mailbox.MaildirMessage(self._template % 0)
483 msg.set_subdir('cur')
484 msg.set_flags('RF')
485 key = self._box.add(msg)
486 msg_returned = self._box.get_message(key)
487 self.assert_(isinstance(msg_returned, mailbox.MaildirMessage))
488 self.assert_(msg_returned.get_subdir() == 'cur')
489 self.assert_(msg_returned.get_flags() == 'FR')
490
491 def test_set_MM(self):
492 # Set with a MaildirMessage instance
493 msg0 = mailbox.MaildirMessage(self._template % 0)
494 msg0.set_flags('TP')
495 key = self._box.add(msg0)
496 msg_returned = self._box.get_message(key)
497 self.assert_(msg_returned.get_subdir() == 'new')
498 self.assert_(msg_returned.get_flags() == 'PT')
499 msg1 = mailbox.MaildirMessage(self._template % 1)
500 self._box[key] = msg1
501 msg_returned = self._box.get_message(key)
502 self.assert_(msg_returned.get_subdir() == 'new')
503 self.assert_(msg_returned.get_flags() == '')
504 self.assert_(msg_returned.get_payload() == '1')
505 msg2 = mailbox.MaildirMessage(self._template % 2)
506 msg2.set_info('2,S')
507 self._box[key] = msg2
508 self._box[key] = self._template % 3
509 msg_returned = self._box.get_message(key)
510 self.assert_(msg_returned.get_subdir() == 'new')
511 self.assert_(msg_returned.get_flags() == 'S')
512 self.assert_(msg_returned.get_payload() == '3')
513
Andrew M. Kuchling15ce8802008-01-19 20:12:04 +0000514 def test_consistent_factory(self):
515 # Add a message.
516 msg = mailbox.MaildirMessage(self._template % 0)
517 msg.set_subdir('cur')
518 msg.set_flags('RF')
519 key = self._box.add(msg)
520
521 # Create new mailbox with
522 class FakeMessage(mailbox.MaildirMessage):
523 pass
524 box = mailbox.Maildir(self._path, factory=FakeMessage)
Amaury Forgeot d'Arc07974d72008-02-03 23:15:32 +0000525 box.colon = self._box.colon
Andrew M. Kuchling15ce8802008-01-19 20:12:04 +0000526 msg2 = box.get_message(key)
527 self.assert_(isinstance(msg2, FakeMessage))
528
Andrew M. Kuchling1da4a942006-04-22 02:32:43 +0000529 def test_initialize_new(self):
530 # Initialize a non-existent mailbox
531 self.tearDown()
532 self._box = mailbox.Maildir(self._path)
533 self._check_basics(factory=rfc822.Message)
534 self._delete_recursively(self._path)
535 self._box = self._factory(self._path, factory=None)
536 self._check_basics()
537
538 def test_initialize_existing(self):
539 # Initialize an existing mailbox
540 self.tearDown()
541 for subdir in '', 'tmp', 'new', 'cur':
Andrew MacIntyreafa358f2006-07-23 13:04:00 +0000542 os.mkdir(os.path.normpath(os.path.join(self._path, subdir)))
Andrew M. Kuchling1da4a942006-04-22 02:32:43 +0000543 self._box = mailbox.Maildir(self._path)
544 self._check_basics(factory=rfc822.Message)
545 self._box = mailbox.Maildir(self._path, factory=None)
546 self._check_basics()
547
548 def _check_basics(self, factory=None):
549 # (Used by test_open_new() and test_open_existing().)
550 self.assertEqual(self._box._path, os.path.abspath(self._path))
551 self.assertEqual(self._box._factory, factory)
552 for subdir in '', 'tmp', 'new', 'cur':
553 path = os.path.join(self._path, subdir)
554 mode = os.stat(path)[stat.ST_MODE]
555 self.assert_(stat.S_ISDIR(mode), "Not a directory: '%s'" % path)
556
557 def test_list_folders(self):
558 # List folders
559 self._box.add_folder('one')
560 self._box.add_folder('two')
561 self._box.add_folder('three')
562 self.assert_(len(self._box.list_folders()) == 3)
563 self.assert_(set(self._box.list_folders()) ==
564 set(('one', 'two', 'three')))
565
566 def test_get_folder(self):
567 # Open folders
568 self._box.add_folder('foo.bar')
569 folder0 = self._box.get_folder('foo.bar')
570 folder0.add(self._template % 'bar')
571 self.assert_(os.path.isdir(os.path.join(self._path, '.foo.bar')))
572 folder1 = self._box.get_folder('foo.bar')
573 self.assert_(folder1.get_string(folder1.keys()[0]) == \
574 self._template % 'bar')
575
576 def test_add_and_remove_folders(self):
577 # Delete folders
578 self._box.add_folder('one')
579 self._box.add_folder('two')
580 self.assert_(len(self._box.list_folders()) == 2)
581 self.assert_(set(self._box.list_folders()) == set(('one', 'two')))
582 self._box.remove_folder('one')
583 self.assert_(len(self._box.list_folders()) == 1)
584 self.assert_(set(self._box.list_folders()) == set(('two',)))
585 self._box.add_folder('three')
586 self.assert_(len(self._box.list_folders()) == 2)
587 self.assert_(set(self._box.list_folders()) == set(('two', 'three')))
588 self._box.remove_folder('three')
589 self.assert_(len(self._box.list_folders()) == 1)
590 self.assert_(set(self._box.list_folders()) == set(('two',)))
591 self._box.remove_folder('two')
592 self.assert_(len(self._box.list_folders()) == 0)
593 self.assert_(self._box.list_folders() == [])
594
595 def test_clean(self):
596 # Remove old files from 'tmp'
597 foo_path = os.path.join(self._path, 'tmp', 'foo')
598 bar_path = os.path.join(self._path, 'tmp', 'bar')
Guido van Rossumb2045832006-05-02 20:47:36 +0000599 f = open(foo_path, 'w')
600 f.write("@")
601 f.close()
602 f = open(bar_path, 'w')
603 f.write("@")
604 f.close()
Andrew M. Kuchling1da4a942006-04-22 02:32:43 +0000605 self._box.clean()
606 self.assert_(os.path.exists(foo_path))
607 self.assert_(os.path.exists(bar_path))
608 foo_stat = os.stat(foo_path)
Guido van Rossumb2045832006-05-02 20:47:36 +0000609 os.utime(foo_path, (time.time() - 129600 - 2,
610 foo_stat.st_mtime))
Andrew M. Kuchling1da4a942006-04-22 02:32:43 +0000611 self._box.clean()
612 self.assert_(not os.path.exists(foo_path))
613 self.assert_(os.path.exists(bar_path))
614
615 def test_create_tmp(self, repetitions=10):
616 # Create files in tmp directory
617 hostname = socket.gethostname()
618 if '/' in hostname:
619 hostname = hostname.replace('/', r'\057')
620 if ':' in hostname:
621 hostname = hostname.replace(':', r'\072')
622 pid = os.getpid()
623 pattern = re.compile(r"(?P<time>\d+)\.M(?P<M>\d{1,6})P(?P<P>\d+)"
624 r"Q(?P<Q>\d+)\.(?P<host>[^:/]+)")
625 previous_groups = None
626 for x in xrange(repetitions):
627 tmp_file = self._box._create_tmp()
628 head, tail = os.path.split(tmp_file.name)
629 self.assertEqual(head, os.path.abspath(os.path.join(self._path,
630 "tmp")),
631 "File in wrong location: '%s'" % head)
632 match = pattern.match(tail)
Benjamin Peterson5b63acd2008-03-29 15:24:25 +0000633 self.assert_(match is not None, "Invalid file name: '%s'" % tail)
Andrew M. Kuchling1da4a942006-04-22 02:32:43 +0000634 groups = match.groups()
Benjamin Peterson5b63acd2008-03-29 15:24:25 +0000635 if previous_groups is not None:
Andrew M. Kuchling1da4a942006-04-22 02:32:43 +0000636 self.assert_(int(groups[0] >= previous_groups[0]),
637 "Non-monotonic seconds: '%s' before '%s'" %
638 (previous_groups[0], groups[0]))
639 self.assert_(int(groups[1] >= previous_groups[1]) or
640 groups[0] != groups[1],
641 "Non-monotonic milliseconds: '%s' before '%s'" %
642 (previous_groups[1], groups[1]))
643 self.assert_(int(groups[2]) == pid,
644 "Process ID mismatch: '%s' should be '%s'" %
645 (groups[2], pid))
646 self.assert_(int(groups[3]) == int(previous_groups[3]) + 1,
647 "Non-sequential counter: '%s' before '%s'" %
648 (previous_groups[3], groups[3]))
649 self.assert_(groups[4] == hostname,
650 "Host name mismatch: '%s' should be '%s'" %
651 (groups[4], hostname))
652 previous_groups = groups
653 tmp_file.write(_sample_message)
654 tmp_file.seek(0)
655 self.assert_(tmp_file.read() == _sample_message)
656 tmp_file.close()
657 file_count = len(os.listdir(os.path.join(self._path, "tmp")))
658 self.assert_(file_count == repetitions,
659 "Wrong file count: '%s' should be '%s'" %
660 (file_count, repetitions))
661
662 def test_refresh(self):
663 # Update the table of contents
664 self.assert_(self._box._toc == {})
665 key0 = self._box.add(self._template % 0)
666 key1 = self._box.add(self._template % 1)
667 self.assert_(self._box._toc == {})
668 self._box._refresh()
669 self.assert_(self._box._toc == {key0: os.path.join('new', key0),
670 key1: os.path.join('new', key1)})
671 key2 = self._box.add(self._template % 2)
672 self.assert_(self._box._toc == {key0: os.path.join('new', key0),
673 key1: os.path.join('new', key1)})
674 self._box._refresh()
675 self.assert_(self._box._toc == {key0: os.path.join('new', key0),
676 key1: os.path.join('new', key1),
677 key2: os.path.join('new', key2)})
678
679 def test_lookup(self):
680 # Look up message subpaths in the TOC
681 self.assertRaises(KeyError, lambda: self._box._lookup('foo'))
682 key0 = self._box.add(self._template % 0)
683 self.assert_(self._box._lookup(key0) == os.path.join('new', key0))
684 os.remove(os.path.join(self._path, 'new', key0))
685 self.assert_(self._box._toc == {key0: os.path.join('new', key0)})
686 self.assertRaises(KeyError, lambda: self._box._lookup(key0))
687 self.assert_(self._box._toc == {})
688
689 def test_lock_unlock(self):
690 # Lock and unlock the mailbox. For Maildir, this does nothing.
691 self._box.lock()
692 self._box.unlock()
693
Andrew M. Kuchlinga3e5d372006-11-09 13:27:07 +0000694 def test_folder (self):
695 # Test for bug #1569790: verify that folders returned by .get_folder()
696 # use the same factory function.
697 def dummy_factory (s):
698 return None
699 box = self._factory(self._path, factory=dummy_factory)
700 folder = box.add_folder('folder1')
701 self.assert_(folder._factory is dummy_factory)
Tim Petersf733abb2007-01-30 03:03:46 +0000702
Andrew M. Kuchlinga3e5d372006-11-09 13:27:07 +0000703 folder1_alias = box.get_folder('folder1')
704 self.assert_(folder1_alias._factory is dummy_factory)
705
Andrew M. Kuchling2b09ef02007-07-14 21:56:19 +0000706 def test_directory_in_folder (self):
707 # Test that mailboxes still work if there's a stray extra directory
708 # in a folder.
709 for i in range(10):
710 self._box.add(mailbox.Message(_sample_message))
Tim Petersf733abb2007-01-30 03:03:46 +0000711
Andrew M. Kuchling2b09ef02007-07-14 21:56:19 +0000712 # Create a stray directory
713 os.mkdir(os.path.join(self._path, 'cur', 'stray-dir'))
714
715 # Check that looping still works with the directory present.
716 for msg in self._box:
717 pass
Andrew M. Kuchling1da4a942006-04-22 02:32:43 +0000718
Andrew M. Kuchling70a6dbd2008-08-04 01:43:43 +0000719 def test_file_perms(self):
720 # From bug #3228, we want to verify that the file created inside a Maildir
721 # subfolder isn't marked as executable.
722 subfolder = self._box.add_folder('subfolder')
723 path = os.path.join(subfolder._path, 'maildirfolder')
724 st = os.stat(path)
725 perms = st.st_mode
726 self.assertFalse((perms & 0111)) # Execute bits should all be off.
727
728
Andrew M. Kuchling1da4a942006-04-22 02:32:43 +0000729class _TestMboxMMDF(TestMailbox):
730
731 def tearDown(self):
732 self._box.close()
733 self._delete_recursively(self._path)
734 for lock_remnant in glob.glob(self._path + '.*'):
Neal Norwitz6cbd8de2007-03-20 06:53:17 +0000735 test_support.unlink(lock_remnant)
Andrew M. Kuchling1da4a942006-04-22 02:32:43 +0000736
737 def test_add_from_string(self):
738 # Add a string starting with 'From ' to the mailbox
739 key = self._box.add('From foo@bar blah\nFrom: foo\n\n0')
740 self.assert_(self._box[key].get_from() == 'foo@bar blah')
741 self.assert_(self._box[key].get_payload() == '0')
742
743 def test_add_mbox_or_mmdf_message(self):
744 # Add an mboxMessage or MMDFMessage
745 for class_ in (mailbox.mboxMessage, mailbox.MMDFMessage):
746 msg = class_('From foo@bar blah\nFrom: foo\n\n0')
747 key = self._box.add(msg)
748
749 def test_open_close_open(self):
750 # Open and inspect previously-created mailbox
751 values = [self._template % i for i in xrange(3)]
752 for value in values:
753 self._box.add(value)
754 self._box.close()
755 mtime = os.path.getmtime(self._path)
756 self._box = self._factory(self._path)
757 self.assert_(len(self._box) == 3)
758 for key in self._box.iterkeys():
759 self.assert_(self._box.get_string(key) in values)
760 self._box.close()
761 self.assert_(mtime == os.path.getmtime(self._path))
762
763 def test_add_and_close(self):
764 # Verifying that closing a mailbox doesn't change added items
765 self._box.add(_sample_message)
766 for i in xrange(3):
767 self._box.add(self._template % i)
768 self._box.add(_sample_message)
769 self._box._file.flush()
770 self._box._file.seek(0)
771 contents = self._box._file.read()
772 self._box.close()
Andrew M. Kuchling214db632006-05-02 21:44:33 +0000773 self.assert_(contents == open(self._path, 'rb').read())
Andrew M. Kuchling1da4a942006-04-22 02:32:43 +0000774 self._box = self._factory(self._path)
775
Andrew M. Kuchling9afbace2006-06-26 13:23:10 +0000776 def test_lock_conflict(self):
777 # Fork off a subprocess that will lock the file for 2 seconds,
778 # unlock it, and then exit.
Andrew M. Kuchlingec3c3682006-06-26 14:33:24 +0000779 if not hasattr(os, 'fork'):
780 return
Andrew M. Kuchling9afbace2006-06-26 13:23:10 +0000781 pid = os.fork()
782 if pid == 0:
783 # In the child, lock the mailbox.
784 self._box.lock()
785 time.sleep(2)
786 self._box.unlock()
787 os._exit(0)
788
789 # In the parent, sleep a bit to give the child time to acquire
790 # the lock.
791 time.sleep(0.5)
Neal Norwitz003c9e22006-08-11 06:09:41 +0000792 try:
793 self.assertRaises(mailbox.ExternalClashError,
794 self._box.lock)
795 finally:
796 # Wait for child to exit. Locking should now succeed.
797 exited_pid, status = os.waitpid(pid, 0)
Tim Peters3249d002006-06-27 11:52:49 +0000798
Andrew M. Kuchling9afbace2006-06-26 13:23:10 +0000799 self._box.lock()
800 self._box.unlock()
Tim Peters3249d002006-06-27 11:52:49 +0000801
Andrew M. Kuchling0f871832006-10-27 16:55:34 +0000802 def test_relock(self):
803 # Test case for bug #1575506: the mailbox class was locking the
804 # wrong file object in its flush() method.
805 msg = "Subject: sub\n\nbody\n"
806 key1 = self._box.add(msg)
807 self._box.flush()
808 self._box.close()
Tim Petersabd8a332006-11-03 02:32:46 +0000809
Andrew M. Kuchling0f871832006-10-27 16:55:34 +0000810 self._box = self._factory(self._path)
811 self._box.lock()
812 key2 = self._box.add(msg)
813 self._box.flush()
814 self.assert_(self._box._locked)
815 self._box.close()
Tim Petersabd8a332006-11-03 02:32:46 +0000816
817
Andrew M. Kuchling1da4a942006-04-22 02:32:43 +0000818class TestMbox(_TestMboxMMDF):
819
820 _factory = lambda self, path, factory=None: mailbox.mbox(path, factory)
821
Andrew M. Kuchling70a6dbd2008-08-04 01:43:43 +0000822 def test_file_perms(self):
823 # From bug #3228, we want to verify that the mailbox file isn't executable,
824 # even if the umask is set to something that would leave executable bits set.
825 # We only run this test on platforms that support umask.
826 if hasattr(os, 'umask'):
827 try:
828 old_umask = os.umask(0077)
829 self._box.close()
830 os.unlink(self._path)
831 self._box = mailbox.mbox(self._path, create=True)
832 self._box.add('')
833 self._box.close()
834 st = os.stat(self._path)
835 perms = st.st_mode
836 self.assertFalse((perms & 0111)) # Execute bits should all be off.
837 finally:
838 os.umask(old_umask)
Andrew M. Kuchling1da4a942006-04-22 02:32:43 +0000839
840class TestMMDF(_TestMboxMMDF):
841
842 _factory = lambda self, path, factory=None: mailbox.MMDF(path, factory)
843
844
845class TestMH(TestMailbox):
846
847 _factory = lambda self, path, factory=None: mailbox.MH(path, factory)
848
849 def test_list_folders(self):
850 # List folders
851 self._box.add_folder('one')
852 self._box.add_folder('two')
853 self._box.add_folder('three')
854 self.assert_(len(self._box.list_folders()) == 3)
855 self.assert_(set(self._box.list_folders()) ==
856 set(('one', 'two', 'three')))
857
858 def test_get_folder(self):
859 # Open folders
Andrew M. Kuchlinga3e5d372006-11-09 13:27:07 +0000860 def dummy_factory (s):
861 return None
862 self._box = self._factory(self._path, dummy_factory)
Tim Petersf733abb2007-01-30 03:03:46 +0000863
Andrew M. Kuchlinga3e5d372006-11-09 13:27:07 +0000864 new_folder = self._box.add_folder('foo.bar')
Andrew M. Kuchling1da4a942006-04-22 02:32:43 +0000865 folder0 = self._box.get_folder('foo.bar')
866 folder0.add(self._template % 'bar')
867 self.assert_(os.path.isdir(os.path.join(self._path, 'foo.bar')))
868 folder1 = self._box.get_folder('foo.bar')
869 self.assert_(folder1.get_string(folder1.keys()[0]) == \
870 self._template % 'bar')
871
Andrew M. Kuchlinga3e5d372006-11-09 13:27:07 +0000872 # Test for bug #1569790: verify that folders returned by .get_folder()
873 # use the same factory function.
874 self.assert_(new_folder._factory is self._box._factory)
875 self.assert_(folder0._factory is self._box._factory)
876
Andrew M. Kuchling1da4a942006-04-22 02:32:43 +0000877 def test_add_and_remove_folders(self):
878 # Delete folders
879 self._box.add_folder('one')
880 self._box.add_folder('two')
881 self.assert_(len(self._box.list_folders()) == 2)
882 self.assert_(set(self._box.list_folders()) == set(('one', 'two')))
883 self._box.remove_folder('one')
884 self.assert_(len(self._box.list_folders()) == 1)
885 self.assert_(set(self._box.list_folders()) == set(('two',)))
886 self._box.add_folder('three')
887 self.assert_(len(self._box.list_folders()) == 2)
888 self.assert_(set(self._box.list_folders()) == set(('two', 'three')))
889 self._box.remove_folder('three')
890 self.assert_(len(self._box.list_folders()) == 1)
891 self.assert_(set(self._box.list_folders()) == set(('two',)))
892 self._box.remove_folder('two')
893 self.assert_(len(self._box.list_folders()) == 0)
894 self.assert_(self._box.list_folders() == [])
895
896 def test_sequences(self):
897 # Get and set sequences
898 self.assert_(self._box.get_sequences() == {})
899 msg0 = mailbox.MHMessage(self._template % 0)
900 msg0.add_sequence('foo')
901 key0 = self._box.add(msg0)
902 self.assert_(self._box.get_sequences() == {'foo':[key0]})
903 msg1 = mailbox.MHMessage(self._template % 1)
904 msg1.set_sequences(['bar', 'replied', 'foo'])
905 key1 = self._box.add(msg1)
906 self.assert_(self._box.get_sequences() ==
907 {'foo':[key0, key1], 'bar':[key1], 'replied':[key1]})
908 msg0.set_sequences(['flagged'])
909 self._box[key0] = msg0
910 self.assert_(self._box.get_sequences() ==
911 {'foo':[key1], 'bar':[key1], 'replied':[key1],
912 'flagged':[key0]})
913 self._box.remove(key1)
914 self.assert_(self._box.get_sequences() == {'flagged':[key0]})
915
916 def test_pack(self):
917 # Pack the contents of the mailbox
918 msg0 = mailbox.MHMessage(self._template % 0)
919 msg1 = mailbox.MHMessage(self._template % 1)
920 msg2 = mailbox.MHMessage(self._template % 2)
921 msg3 = mailbox.MHMessage(self._template % 3)
922 msg0.set_sequences(['foo', 'unseen'])
923 msg1.set_sequences(['foo'])
924 msg2.set_sequences(['foo', 'flagged'])
925 msg3.set_sequences(['foo', 'bar', 'replied'])
926 key0 = self._box.add(msg0)
927 key1 = self._box.add(msg1)
928 key2 = self._box.add(msg2)
929 key3 = self._box.add(msg3)
930 self.assert_(self._box.get_sequences() ==
931 {'foo':[key0,key1,key2,key3], 'unseen':[key0],
932 'flagged':[key2], 'bar':[key3], 'replied':[key3]})
933 self._box.remove(key2)
934 self.assert_(self._box.get_sequences() ==
935 {'foo':[key0,key1,key3], 'unseen':[key0], 'bar':[key3],
936 'replied':[key3]})
937 self._box.pack()
938 self.assert_(self._box.keys() == [1, 2, 3])
939 key0 = key0
940 key1 = key0 + 1
941 key2 = key1 + 1
942 self.assert_(self._box.get_sequences() ==
943 {'foo':[1, 2, 3], 'unseen':[1], 'bar':[3], 'replied':[3]})
944
Andrew M. Kuchling8c456f32006-11-17 13:30:25 +0000945 # Test case for packing while holding the mailbox locked.
946 key0 = self._box.add(msg1)
947 key1 = self._box.add(msg1)
948 key2 = self._box.add(msg1)
949 key3 = self._box.add(msg1)
950
951 self._box.remove(key0)
952 self._box.remove(key2)
953 self._box.lock()
954 self._box.pack()
955 self._box.unlock()
956 self.assert_(self._box.get_sequences() ==
957 {'foo':[1, 2, 3, 4, 5],
958 'unseen':[1], 'bar':[3], 'replied':[3]})
Tim Petersf733abb2007-01-30 03:03:46 +0000959
Andrew M. Kuchling1da4a942006-04-22 02:32:43 +0000960 def _get_lock_path(self):
961 return os.path.join(self._path, '.mh_sequences.lock')
962
963
964class TestBabyl(TestMailbox):
965
966 _factory = lambda self, path, factory=None: mailbox.Babyl(path, factory)
967
968 def tearDown(self):
969 self._box.close()
970 self._delete_recursively(self._path)
971 for lock_remnant in glob.glob(self._path + '.*'):
Neal Norwitz6cbd8de2007-03-20 06:53:17 +0000972 test_support.unlink(lock_remnant)
Andrew M. Kuchling1da4a942006-04-22 02:32:43 +0000973
974 def test_labels(self):
975 # Get labels from the mailbox
976 self.assert_(self._box.get_labels() == [])
977 msg0 = mailbox.BabylMessage(self._template % 0)
978 msg0.add_label('foo')
979 key0 = self._box.add(msg0)
980 self.assert_(self._box.get_labels() == ['foo'])
981 msg1 = mailbox.BabylMessage(self._template % 1)
982 msg1.set_labels(['bar', 'answered', 'foo'])
983 key1 = self._box.add(msg1)
984 self.assert_(set(self._box.get_labels()) == set(['foo', 'bar']))
985 msg0.set_labels(['blah', 'filed'])
986 self._box[key0] = msg0
987 self.assert_(set(self._box.get_labels()) ==
988 set(['foo', 'bar', 'blah']))
989 self._box.remove(key1)
990 self.assert_(set(self._box.get_labels()) == set(['blah']))
991
992
993class TestMessage(TestBase):
994
995 _factory = mailbox.Message # Overridden by subclasses to reuse tests
996
997 def setUp(self):
998 self._path = test_support.TESTFN
999
1000 def tearDown(self):
1001 self._delete_recursively(self._path)
1002
1003 def test_initialize_with_eMM(self):
Georg Brandl5a096e12007-01-22 19:40:21 +00001004 # Initialize based on email.message.Message instance
Andrew M. Kuchling1da4a942006-04-22 02:32:43 +00001005 eMM = email.message_from_string(_sample_message)
1006 msg = self._factory(eMM)
1007 self._post_initialize_hook(msg)
1008 self._check_sample(msg)
1009
1010 def test_initialize_with_string(self):
1011 # Initialize based on string
1012 msg = self._factory(_sample_message)
1013 self._post_initialize_hook(msg)
1014 self._check_sample(msg)
1015
1016 def test_initialize_with_file(self):
1017 # Initialize based on contents of file
1018 f = open(self._path, 'w+')
1019 f.write(_sample_message)
1020 f.seek(0)
1021 msg = self._factory(f)
1022 self._post_initialize_hook(msg)
1023 self._check_sample(msg)
1024 f.close()
1025
1026 def test_initialize_with_nothing(self):
1027 # Initialize without arguments
1028 msg = self._factory()
1029 self._post_initialize_hook(msg)
Georg Brandl5a096e12007-01-22 19:40:21 +00001030 self.assert_(isinstance(msg, email.message.Message))
Andrew M. Kuchling1da4a942006-04-22 02:32:43 +00001031 self.assert_(isinstance(msg, mailbox.Message))
1032 self.assert_(isinstance(msg, self._factory))
1033 self.assert_(msg.keys() == [])
1034 self.assert_(not msg.is_multipart())
1035 self.assert_(msg.get_payload() == None)
1036
1037 def test_initialize_incorrectly(self):
1038 # Initialize with invalid argument
1039 self.assertRaises(TypeError, lambda: self._factory(object()))
1040
1041 def test_become_message(self):
1042 # Take on the state of another message
1043 eMM = email.message_from_string(_sample_message)
1044 msg = self._factory()
1045 msg._become_message(eMM)
1046 self._check_sample(msg)
1047
1048 def test_explain_to(self):
1049 # Copy self's format-specific data to other message formats.
1050 # This test is superficial; better ones are in TestMessageConversion.
1051 msg = self._factory()
1052 for class_ in (mailbox.Message, mailbox.MaildirMessage,
1053 mailbox.mboxMessage, mailbox.MHMessage,
1054 mailbox.BabylMessage, mailbox.MMDFMessage):
1055 other_msg = class_()
1056 msg._explain_to(other_msg)
Georg Brandl5a096e12007-01-22 19:40:21 +00001057 other_msg = email.message.Message()
Andrew M. Kuchling1da4a942006-04-22 02:32:43 +00001058 self.assertRaises(TypeError, lambda: msg._explain_to(other_msg))
1059
1060 def _post_initialize_hook(self, msg):
1061 # Overridden by subclasses to check extra things after initialization
1062 pass
1063
1064
1065class TestMaildirMessage(TestMessage):
1066
1067 _factory = mailbox.MaildirMessage
1068
1069 def _post_initialize_hook(self, msg):
1070 self.assert_(msg._subdir == 'new')
1071 self.assert_(msg._info == '')
1072
1073 def test_subdir(self):
1074 # Use get_subdir() and set_subdir()
1075 msg = mailbox.MaildirMessage(_sample_message)
1076 self.assert_(msg.get_subdir() == 'new')
1077 msg.set_subdir('cur')
1078 self.assert_(msg.get_subdir() == 'cur')
1079 msg.set_subdir('new')
1080 self.assert_(msg.get_subdir() == 'new')
1081 self.assertRaises(ValueError, lambda: msg.set_subdir('tmp'))
1082 self.assert_(msg.get_subdir() == 'new')
1083 msg.set_subdir('new')
1084 self.assert_(msg.get_subdir() == 'new')
1085 self._check_sample(msg)
1086
1087 def test_flags(self):
1088 # Use get_flags(), set_flags(), add_flag(), remove_flag()
1089 msg = mailbox.MaildirMessage(_sample_message)
1090 self.assert_(msg.get_flags() == '')
1091 self.assert_(msg.get_subdir() == 'new')
1092 msg.set_flags('F')
1093 self.assert_(msg.get_subdir() == 'new')
1094 self.assert_(msg.get_flags() == 'F')
1095 msg.set_flags('SDTP')
1096 self.assert_(msg.get_flags() == 'DPST')
1097 msg.add_flag('FT')
1098 self.assert_(msg.get_flags() == 'DFPST')
1099 msg.remove_flag('TDRP')
1100 self.assert_(msg.get_flags() == 'FS')
1101 self.assert_(msg.get_subdir() == 'new')
1102 self._check_sample(msg)
1103
1104 def test_date(self):
1105 # Use get_date() and set_date()
1106 msg = mailbox.MaildirMessage(_sample_message)
1107 self.assert_(abs(msg.get_date() - time.time()) < 60)
1108 msg.set_date(0.0)
1109 self.assert_(msg.get_date() == 0.0)
1110
1111 def test_info(self):
1112 # Use get_info() and set_info()
1113 msg = mailbox.MaildirMessage(_sample_message)
1114 self.assert_(msg.get_info() == '')
1115 msg.set_info('1,foo=bar')
1116 self.assert_(msg.get_info() == '1,foo=bar')
1117 self.assertRaises(TypeError, lambda: msg.set_info(None))
1118 self._check_sample(msg)
1119
1120 def test_info_and_flags(self):
1121 # Test interaction of info and flag methods
1122 msg = mailbox.MaildirMessage(_sample_message)
1123 self.assert_(msg.get_info() == '')
1124 msg.set_flags('SF')
1125 self.assert_(msg.get_flags() == 'FS')
1126 self.assert_(msg.get_info() == '2,FS')
1127 msg.set_info('1,')
1128 self.assert_(msg.get_flags() == '')
1129 self.assert_(msg.get_info() == '1,')
1130 msg.remove_flag('RPT')
1131 self.assert_(msg.get_flags() == '')
1132 self.assert_(msg.get_info() == '1,')
1133 msg.add_flag('D')
1134 self.assert_(msg.get_flags() == 'D')
1135 self.assert_(msg.get_info() == '2,D')
1136 self._check_sample(msg)
1137
1138
1139class _TestMboxMMDFMessage(TestMessage):
1140
1141 _factory = mailbox._mboxMMDFMessage
1142
1143 def _post_initialize_hook(self, msg):
1144 self._check_from(msg)
1145
1146 def test_initialize_with_unixfrom(self):
1147 # Initialize with a message that already has a _unixfrom attribute
1148 msg = mailbox.Message(_sample_message)
1149 msg.set_unixfrom('From foo@bar blah')
1150 msg = mailbox.mboxMessage(msg)
1151 self.assert_(msg.get_from() == 'foo@bar blah', msg.get_from())
1152
1153 def test_from(self):
1154 # Get and set "From " line
1155 msg = mailbox.mboxMessage(_sample_message)
1156 self._check_from(msg)
1157 msg.set_from('foo bar')
1158 self.assert_(msg.get_from() == 'foo bar')
1159 msg.set_from('foo@bar', True)
1160 self._check_from(msg, 'foo@bar')
1161 msg.set_from('blah@temp', time.localtime())
1162 self._check_from(msg, 'blah@temp')
1163
1164 def test_flags(self):
1165 # Use get_flags(), set_flags(), add_flag(), remove_flag()
1166 msg = mailbox.mboxMessage(_sample_message)
1167 self.assert_(msg.get_flags() == '')
1168 msg.set_flags('F')
1169 self.assert_(msg.get_flags() == 'F')
1170 msg.set_flags('XODR')
1171 self.assert_(msg.get_flags() == 'RODX')
1172 msg.add_flag('FA')
1173 self.assert_(msg.get_flags() == 'RODFAX')
1174 msg.remove_flag('FDXA')
1175 self.assert_(msg.get_flags() == 'RO')
1176 self._check_sample(msg)
1177
1178 def _check_from(self, msg, sender=None):
1179 # Check contents of "From " line
1180 if sender is None:
1181 sender = "MAILER-DAEMON"
1182 self.assert_(re.match(sender + r" \w{3} \w{3} [\d ]\d [\d ]\d:\d{2}:"
1183 r"\d{2} \d{4}", msg.get_from()) is not None)
1184
1185
1186class TestMboxMessage(_TestMboxMMDFMessage):
1187
1188 _factory = mailbox.mboxMessage
1189
1190
1191class TestMHMessage(TestMessage):
1192
1193 _factory = mailbox.MHMessage
1194
1195 def _post_initialize_hook(self, msg):
1196 self.assert_(msg._sequences == [])
1197
1198 def test_sequences(self):
1199 # Get, set, join, and leave sequences
1200 msg = mailbox.MHMessage(_sample_message)
1201 self.assert_(msg.get_sequences() == [])
1202 msg.set_sequences(['foobar'])
1203 self.assert_(msg.get_sequences() == ['foobar'])
1204 msg.set_sequences([])
1205 self.assert_(msg.get_sequences() == [])
1206 msg.add_sequence('unseen')
1207 self.assert_(msg.get_sequences() == ['unseen'])
1208 msg.add_sequence('flagged')
1209 self.assert_(msg.get_sequences() == ['unseen', 'flagged'])
1210 msg.add_sequence('flagged')
1211 self.assert_(msg.get_sequences() == ['unseen', 'flagged'])
1212 msg.remove_sequence('unseen')
1213 self.assert_(msg.get_sequences() == ['flagged'])
1214 msg.add_sequence('foobar')
1215 self.assert_(msg.get_sequences() == ['flagged', 'foobar'])
1216 msg.remove_sequence('replied')
1217 self.assert_(msg.get_sequences() == ['flagged', 'foobar'])
1218 msg.set_sequences(['foobar', 'replied'])
1219 self.assert_(msg.get_sequences() == ['foobar', 'replied'])
1220
1221
1222class TestBabylMessage(TestMessage):
1223
1224 _factory = mailbox.BabylMessage
1225
1226 def _post_initialize_hook(self, msg):
1227 self.assert_(msg._labels == [])
1228
1229 def test_labels(self):
1230 # Get, set, join, and leave labels
1231 msg = mailbox.BabylMessage(_sample_message)
1232 self.assert_(msg.get_labels() == [])
1233 msg.set_labels(['foobar'])
1234 self.assert_(msg.get_labels() == ['foobar'])
1235 msg.set_labels([])
1236 self.assert_(msg.get_labels() == [])
1237 msg.add_label('filed')
1238 self.assert_(msg.get_labels() == ['filed'])
1239 msg.add_label('resent')
1240 self.assert_(msg.get_labels() == ['filed', 'resent'])
1241 msg.add_label('resent')
1242 self.assert_(msg.get_labels() == ['filed', 'resent'])
1243 msg.remove_label('filed')
1244 self.assert_(msg.get_labels() == ['resent'])
1245 msg.add_label('foobar')
1246 self.assert_(msg.get_labels() == ['resent', 'foobar'])
1247 msg.remove_label('unseen')
1248 self.assert_(msg.get_labels() == ['resent', 'foobar'])
1249 msg.set_labels(['foobar', 'answered'])
1250 self.assert_(msg.get_labels() == ['foobar', 'answered'])
1251
1252 def test_visible(self):
1253 # Get, set, and update visible headers
1254 msg = mailbox.BabylMessage(_sample_message)
1255 visible = msg.get_visible()
1256 self.assert_(visible.keys() == [])
1257 self.assert_(visible.get_payload() is None)
1258 visible['User-Agent'] = 'FooBar 1.0'
1259 visible['X-Whatever'] = 'Blah'
1260 self.assert_(msg.get_visible().keys() == [])
1261 msg.set_visible(visible)
1262 visible = msg.get_visible()
1263 self.assert_(visible.keys() == ['User-Agent', 'X-Whatever'])
1264 self.assert_(visible['User-Agent'] == 'FooBar 1.0')
1265 self.assert_(visible['X-Whatever'] == 'Blah')
1266 self.assert_(visible.get_payload() is None)
1267 msg.update_visible()
1268 self.assert_(visible.keys() == ['User-Agent', 'X-Whatever'])
1269 self.assert_(visible.get_payload() is None)
1270 visible = msg.get_visible()
1271 self.assert_(visible.keys() == ['User-Agent', 'Date', 'From', 'To',
1272 'Subject'])
1273 for header in ('User-Agent', 'Date', 'From', 'To', 'Subject'):
1274 self.assert_(visible[header] == msg[header])
1275
1276
1277class TestMMDFMessage(_TestMboxMMDFMessage):
1278
1279 _factory = mailbox.MMDFMessage
1280
1281
1282class TestMessageConversion(TestBase):
1283
1284 def test_plain_to_x(self):
1285 # Convert Message to all formats
1286 for class_ in (mailbox.Message, mailbox.MaildirMessage,
1287 mailbox.mboxMessage, mailbox.MHMessage,
1288 mailbox.BabylMessage, mailbox.MMDFMessage):
1289 msg_plain = mailbox.Message(_sample_message)
1290 msg = class_(msg_plain)
1291 self._check_sample(msg)
1292
1293 def test_x_to_plain(self):
1294 # Convert all formats to Message
1295 for class_ in (mailbox.Message, mailbox.MaildirMessage,
1296 mailbox.mboxMessage, mailbox.MHMessage,
1297 mailbox.BabylMessage, mailbox.MMDFMessage):
1298 msg = class_(_sample_message)
1299 msg_plain = mailbox.Message(msg)
1300 self._check_sample(msg_plain)
1301
1302 def test_x_to_invalid(self):
1303 # Convert all formats to an invalid format
1304 for class_ in (mailbox.Message, mailbox.MaildirMessage,
1305 mailbox.mboxMessage, mailbox.MHMessage,
1306 mailbox.BabylMessage, mailbox.MMDFMessage):
1307 self.assertRaises(TypeError, lambda: class_(False))
1308
1309 def test_maildir_to_maildir(self):
1310 # Convert MaildirMessage to MaildirMessage
1311 msg_maildir = mailbox.MaildirMessage(_sample_message)
1312 msg_maildir.set_flags('DFPRST')
1313 msg_maildir.set_subdir('cur')
1314 date = msg_maildir.get_date()
1315 msg = mailbox.MaildirMessage(msg_maildir)
1316 self._check_sample(msg)
1317 self.assert_(msg.get_flags() == 'DFPRST')
1318 self.assert_(msg.get_subdir() == 'cur')
1319 self.assert_(msg.get_date() == date)
1320
1321 def test_maildir_to_mboxmmdf(self):
1322 # Convert MaildirMessage to mboxmessage and MMDFMessage
1323 pairs = (('D', ''), ('F', 'F'), ('P', ''), ('R', 'A'), ('S', 'R'),
1324 ('T', 'D'), ('DFPRST', 'RDFA'))
1325 for class_ in (mailbox.mboxMessage, mailbox.MMDFMessage):
1326 msg_maildir = mailbox.MaildirMessage(_sample_message)
1327 msg_maildir.set_date(0.0)
1328 for setting, result in pairs:
1329 msg_maildir.set_flags(setting)
1330 msg = class_(msg_maildir)
1331 self.assert_(msg.get_flags() == result)
1332 self.assert_(msg.get_from() == 'MAILER-DAEMON %s' %
1333 time.asctime(time.gmtime(0.0)))
1334 msg_maildir.set_subdir('cur')
1335 self.assert_(class_(msg_maildir).get_flags() == 'RODFA')
1336
1337 def test_maildir_to_mh(self):
1338 # Convert MaildirMessage to MHMessage
1339 msg_maildir = mailbox.MaildirMessage(_sample_message)
1340 pairs = (('D', ['unseen']), ('F', ['unseen', 'flagged']),
1341 ('P', ['unseen']), ('R', ['unseen', 'replied']), ('S', []),
1342 ('T', ['unseen']), ('DFPRST', ['replied', 'flagged']))
1343 for setting, result in pairs:
1344 msg_maildir.set_flags(setting)
1345 self.assert_(mailbox.MHMessage(msg_maildir).get_sequences() == \
1346 result)
1347
1348 def test_maildir_to_babyl(self):
1349 # Convert MaildirMessage to Babyl
1350 msg_maildir = mailbox.MaildirMessage(_sample_message)
1351 pairs = (('D', ['unseen']), ('F', ['unseen']),
1352 ('P', ['unseen', 'forwarded']), ('R', ['unseen', 'answered']),
1353 ('S', []), ('T', ['unseen', 'deleted']),
1354 ('DFPRST', ['deleted', 'answered', 'forwarded']))
1355 for setting, result in pairs:
1356 msg_maildir.set_flags(setting)
1357 self.assert_(mailbox.BabylMessage(msg_maildir).get_labels() == \
1358 result)
1359
1360 def test_mboxmmdf_to_maildir(self):
1361 # Convert mboxMessage and MMDFMessage to MaildirMessage
1362 for class_ in (mailbox.mboxMessage, mailbox.MMDFMessage):
1363 msg_mboxMMDF = class_(_sample_message)
1364 msg_mboxMMDF.set_from('foo@bar', time.gmtime(0.0))
1365 pairs = (('R', 'S'), ('O', ''), ('D', 'T'), ('F', 'F'), ('A', 'R'),
1366 ('RODFA', 'FRST'))
1367 for setting, result in pairs:
1368 msg_mboxMMDF.set_flags(setting)
1369 msg = mailbox.MaildirMessage(msg_mboxMMDF)
1370 self.assert_(msg.get_flags() == result)
1371 self.assert_(msg.get_date() == 0.0, msg.get_date())
1372 msg_mboxMMDF.set_flags('O')
1373 self.assert_(mailbox.MaildirMessage(msg_mboxMMDF).get_subdir() == \
1374 'cur')
1375
1376 def test_mboxmmdf_to_mboxmmdf(self):
1377 # Convert mboxMessage and MMDFMessage to mboxMessage and MMDFMessage
1378 for class_ in (mailbox.mboxMessage, mailbox.MMDFMessage):
1379 msg_mboxMMDF = class_(_sample_message)
1380 msg_mboxMMDF.set_flags('RODFA')
1381 msg_mboxMMDF.set_from('foo@bar')
1382 for class2_ in (mailbox.mboxMessage, mailbox.MMDFMessage):
1383 msg2 = class2_(msg_mboxMMDF)
1384 self.assert_(msg2.get_flags() == 'RODFA')
1385 self.assert_(msg2.get_from() == 'foo@bar')
1386
1387 def test_mboxmmdf_to_mh(self):
1388 # Convert mboxMessage and MMDFMessage to MHMessage
1389 for class_ in (mailbox.mboxMessage, mailbox.MMDFMessage):
1390 msg_mboxMMDF = class_(_sample_message)
1391 pairs = (('R', []), ('O', ['unseen']), ('D', ['unseen']),
1392 ('F', ['unseen', 'flagged']),
1393 ('A', ['unseen', 'replied']),
1394 ('RODFA', ['replied', 'flagged']))
1395 for setting, result in pairs:
1396 msg_mboxMMDF.set_flags(setting)
1397 self.assert_(mailbox.MHMessage(msg_mboxMMDF).get_sequences() \
1398 == result)
1399
1400 def test_mboxmmdf_to_babyl(self):
1401 # Convert mboxMessage and MMDFMessage to BabylMessage
1402 for class_ in (mailbox.mboxMessage, mailbox.MMDFMessage):
1403 msg = class_(_sample_message)
1404 pairs = (('R', []), ('O', ['unseen']),
1405 ('D', ['unseen', 'deleted']), ('F', ['unseen']),
1406 ('A', ['unseen', 'answered']),
1407 ('RODFA', ['deleted', 'answered']))
1408 for setting, result in pairs:
1409 msg.set_flags(setting)
1410 self.assert_(mailbox.BabylMessage(msg).get_labels() == result)
1411
1412 def test_mh_to_maildir(self):
1413 # Convert MHMessage to MaildirMessage
1414 pairs = (('unseen', ''), ('replied', 'RS'), ('flagged', 'FS'))
1415 for setting, result in pairs:
1416 msg = mailbox.MHMessage(_sample_message)
1417 msg.add_sequence(setting)
1418 self.assert_(mailbox.MaildirMessage(msg).get_flags() == result)
1419 self.assert_(mailbox.MaildirMessage(msg).get_subdir() == 'cur')
1420 msg = mailbox.MHMessage(_sample_message)
1421 msg.add_sequence('unseen')
1422 msg.add_sequence('replied')
1423 msg.add_sequence('flagged')
1424 self.assert_(mailbox.MaildirMessage(msg).get_flags() == 'FR')
1425 self.assert_(mailbox.MaildirMessage(msg).get_subdir() == 'cur')
1426
1427 def test_mh_to_mboxmmdf(self):
1428 # Convert MHMessage to mboxMessage and MMDFMessage
1429 pairs = (('unseen', 'O'), ('replied', 'ROA'), ('flagged', 'ROF'))
1430 for setting, result in pairs:
1431 msg = mailbox.MHMessage(_sample_message)
1432 msg.add_sequence(setting)
1433 for class_ in (mailbox.mboxMessage, mailbox.MMDFMessage):
1434 self.assert_(class_(msg).get_flags() == result)
1435 msg = mailbox.MHMessage(_sample_message)
1436 msg.add_sequence('unseen')
1437 msg.add_sequence('replied')
1438 msg.add_sequence('flagged')
1439 for class_ in (mailbox.mboxMessage, mailbox.MMDFMessage):
1440 self.assert_(class_(msg).get_flags() == 'OFA')
1441
1442 def test_mh_to_mh(self):
1443 # Convert MHMessage to MHMessage
1444 msg = mailbox.MHMessage(_sample_message)
1445 msg.add_sequence('unseen')
1446 msg.add_sequence('replied')
1447 msg.add_sequence('flagged')
1448 self.assert_(mailbox.MHMessage(msg).get_sequences() == \
1449 ['unseen', 'replied', 'flagged'])
1450
1451 def test_mh_to_babyl(self):
1452 # Convert MHMessage to BabylMessage
1453 pairs = (('unseen', ['unseen']), ('replied', ['answered']),
1454 ('flagged', []))
1455 for setting, result in pairs:
1456 msg = mailbox.MHMessage(_sample_message)
1457 msg.add_sequence(setting)
1458 self.assert_(mailbox.BabylMessage(msg).get_labels() == result)
1459 msg = mailbox.MHMessage(_sample_message)
1460 msg.add_sequence('unseen')
1461 msg.add_sequence('replied')
1462 msg.add_sequence('flagged')
1463 self.assert_(mailbox.BabylMessage(msg).get_labels() == \
1464 ['unseen', 'answered'])
1465
1466 def test_babyl_to_maildir(self):
1467 # Convert BabylMessage to MaildirMessage
1468 pairs = (('unseen', ''), ('deleted', 'ST'), ('filed', 'S'),
1469 ('answered', 'RS'), ('forwarded', 'PS'), ('edited', 'S'),
1470 ('resent', 'PS'))
1471 for setting, result in pairs:
1472 msg = mailbox.BabylMessage(_sample_message)
1473 msg.add_label(setting)
1474 self.assert_(mailbox.MaildirMessage(msg).get_flags() == result)
1475 self.assert_(mailbox.MaildirMessage(msg).get_subdir() == 'cur')
1476 msg = mailbox.BabylMessage(_sample_message)
1477 for label in ('unseen', 'deleted', 'filed', 'answered', 'forwarded',
1478 'edited', 'resent'):
1479 msg.add_label(label)
1480 self.assert_(mailbox.MaildirMessage(msg).get_flags() == 'PRT')
1481 self.assert_(mailbox.MaildirMessage(msg).get_subdir() == 'cur')
1482
1483 def test_babyl_to_mboxmmdf(self):
1484 # Convert BabylMessage to mboxMessage and MMDFMessage
1485 pairs = (('unseen', 'O'), ('deleted', 'ROD'), ('filed', 'RO'),
1486 ('answered', 'ROA'), ('forwarded', 'RO'), ('edited', 'RO'),
1487 ('resent', 'RO'))
1488 for setting, result in pairs:
1489 for class_ in (mailbox.mboxMessage, mailbox.MMDFMessage):
1490 msg = mailbox.BabylMessage(_sample_message)
1491 msg.add_label(setting)
1492 self.assert_(class_(msg).get_flags() == result)
1493 msg = mailbox.BabylMessage(_sample_message)
1494 for label in ('unseen', 'deleted', 'filed', 'answered', 'forwarded',
1495 'edited', 'resent'):
1496 msg.add_label(label)
1497 for class_ in (mailbox.mboxMessage, mailbox.MMDFMessage):
1498 self.assert_(class_(msg).get_flags() == 'ODA')
1499
1500 def test_babyl_to_mh(self):
1501 # Convert BabylMessage to MHMessage
1502 pairs = (('unseen', ['unseen']), ('deleted', []), ('filed', []),
1503 ('answered', ['replied']), ('forwarded', []), ('edited', []),
1504 ('resent', []))
1505 for setting, result in pairs:
1506 msg = mailbox.BabylMessage(_sample_message)
1507 msg.add_label(setting)
1508 self.assert_(mailbox.MHMessage(msg).get_sequences() == result)
1509 msg = mailbox.BabylMessage(_sample_message)
1510 for label in ('unseen', 'deleted', 'filed', 'answered', 'forwarded',
1511 'edited', 'resent'):
1512 msg.add_label(label)
1513 self.assert_(mailbox.MHMessage(msg).get_sequences() == \
1514 ['unseen', 'replied'])
1515
1516 def test_babyl_to_babyl(self):
1517 # Convert BabylMessage to BabylMessage
1518 msg = mailbox.BabylMessage(_sample_message)
1519 msg.update_visible()
1520 for label in ('unseen', 'deleted', 'filed', 'answered', 'forwarded',
1521 'edited', 'resent'):
Tim Peters6d7cd7d2006-04-22 05:52:59 +00001522 msg.add_label(label)
Andrew M. Kuchling1da4a942006-04-22 02:32:43 +00001523 msg2 = mailbox.BabylMessage(msg)
1524 self.assert_(msg2.get_labels() == ['unseen', 'deleted', 'filed',
1525 'answered', 'forwarded', 'edited',
1526 'resent'])
1527 self.assert_(msg.get_visible().keys() == msg2.get_visible().keys())
1528 for key in msg.get_visible().keys():
1529 self.assert_(msg.get_visible()[key] == msg2.get_visible()[key])
1530
1531
1532class TestProxyFileBase(TestBase):
1533
1534 def _test_read(self, proxy):
1535 # Read by byte
1536 proxy.seek(0)
1537 self.assert_(proxy.read() == 'bar')
1538 proxy.seek(1)
1539 self.assert_(proxy.read() == 'ar')
1540 proxy.seek(0)
1541 self.assert_(proxy.read(2) == 'ba')
1542 proxy.seek(1)
1543 self.assert_(proxy.read(-1) == 'ar')
1544 proxy.seek(2)
1545 self.assert_(proxy.read(1000) == 'r')
1546
1547 def _test_readline(self, proxy):
1548 # Read by line
1549 proxy.seek(0)
1550 self.assert_(proxy.readline() == 'foo' + os.linesep)
1551 self.assert_(proxy.readline() == 'bar' + os.linesep)
1552 self.assert_(proxy.readline() == 'fred' + os.linesep)
1553 self.assert_(proxy.readline() == 'bob')
1554 proxy.seek(2)
1555 self.assert_(proxy.readline() == 'o' + os.linesep)
1556 proxy.seek(6 + 2 * len(os.linesep))
1557 self.assert_(proxy.readline() == 'fred' + os.linesep)
1558 proxy.seek(6 + 2 * len(os.linesep))
1559 self.assert_(proxy.readline(2) == 'fr')
1560 self.assert_(proxy.readline(-10) == 'ed' + os.linesep)
1561
1562 def _test_readlines(self, proxy):
1563 # Read multiple lines
1564 proxy.seek(0)
1565 self.assert_(proxy.readlines() == ['foo' + os.linesep,
1566 'bar' + os.linesep,
1567 'fred' + os.linesep, 'bob'])
1568 proxy.seek(0)
1569 self.assert_(proxy.readlines(2) == ['foo' + os.linesep])
1570 proxy.seek(3 + len(os.linesep))
1571 self.assert_(proxy.readlines(4 + len(os.linesep)) ==
1572 ['bar' + os.linesep, 'fred' + os.linesep])
1573 proxy.seek(3)
1574 self.assert_(proxy.readlines(1000) == [os.linesep, 'bar' + os.linesep,
1575 'fred' + os.linesep, 'bob'])
1576
1577 def _test_iteration(self, proxy):
1578 # Iterate by line
1579 proxy.seek(0)
1580 iterator = iter(proxy)
1581 self.assert_(iterator.next() == 'foo' + os.linesep)
1582 self.assert_(iterator.next() == 'bar' + os.linesep)
1583 self.assert_(iterator.next() == 'fred' + os.linesep)
1584 self.assert_(iterator.next() == 'bob')
1585 self.assertRaises(StopIteration, lambda: iterator.next())
1586
1587 def _test_seek_and_tell(self, proxy):
1588 # Seek and use tell to check position
1589 proxy.seek(3)
1590 self.assert_(proxy.tell() == 3)
1591 self.assert_(proxy.read(len(os.linesep)) == os.linesep)
1592 proxy.seek(2, 1)
1593 self.assert_(proxy.read(1 + len(os.linesep)) == 'r' + os.linesep)
1594 proxy.seek(-3 - len(os.linesep), 2)
1595 self.assert_(proxy.read(3) == 'bar')
1596 proxy.seek(2, 0)
1597 self.assert_(proxy.read() == 'o' + os.linesep + 'bar' + os.linesep)
1598 proxy.seek(100)
1599 self.assert_(proxy.read() == '')
1600
1601 def _test_close(self, proxy):
1602 # Close a file
1603 proxy.close()
1604 self.assertRaises(AttributeError, lambda: proxy.close())
1605
1606
1607class TestProxyFile(TestProxyFileBase):
1608
1609 def setUp(self):
1610 self._path = test_support.TESTFN
Andrew M. Kuchling214db632006-05-02 21:44:33 +00001611 self._file = open(self._path, 'wb+')
Andrew M. Kuchling1da4a942006-04-22 02:32:43 +00001612
1613 def tearDown(self):
1614 self._file.close()
1615 self._delete_recursively(self._path)
1616
1617 def test_initialize(self):
1618 # Initialize and check position
1619 self._file.write('foo')
1620 pos = self._file.tell()
1621 proxy0 = mailbox._ProxyFile(self._file)
1622 self.assert_(proxy0.tell() == pos)
1623 self.assert_(self._file.tell() == pos)
1624 proxy1 = mailbox._ProxyFile(self._file, 0)
1625 self.assert_(proxy1.tell() == 0)
1626 self.assert_(self._file.tell() == pos)
1627
1628 def test_read(self):
1629 self._file.write('bar')
1630 self._test_read(mailbox._ProxyFile(self._file))
1631
1632 def test_readline(self):
1633 self._file.write('foo%sbar%sfred%sbob' % (os.linesep, os.linesep,
1634 os.linesep))
1635 self._test_readline(mailbox._ProxyFile(self._file))
1636
1637 def test_readlines(self):
1638 self._file.write('foo%sbar%sfred%sbob' % (os.linesep, os.linesep,
1639 os.linesep))
1640 self._test_readlines(mailbox._ProxyFile(self._file))
1641
1642 def test_iteration(self):
1643 self._file.write('foo%sbar%sfred%sbob' % (os.linesep, os.linesep,
1644 os.linesep))
1645 self._test_iteration(mailbox._ProxyFile(self._file))
1646
1647 def test_seek_and_tell(self):
1648 self._file.write('foo%sbar%s' % (os.linesep, os.linesep))
1649 self._test_seek_and_tell(mailbox._ProxyFile(self._file))
1650
1651 def test_close(self):
1652 self._file.write('foo%sbar%s' % (os.linesep, os.linesep))
1653 self._test_close(mailbox._ProxyFile(self._file))
1654
1655
1656class TestPartialFile(TestProxyFileBase):
1657
1658 def setUp(self):
1659 self._path = test_support.TESTFN
Andrew M. Kuchling214db632006-05-02 21:44:33 +00001660 self._file = open(self._path, 'wb+')
Andrew M. Kuchling1da4a942006-04-22 02:32:43 +00001661
1662 def tearDown(self):
1663 self._file.close()
1664 self._delete_recursively(self._path)
1665
1666 def test_initialize(self):
1667 # Initialize and check position
1668 self._file.write('foo' + os.linesep + 'bar')
1669 pos = self._file.tell()
1670 proxy = mailbox._PartialFile(self._file, 2, 5)
1671 self.assert_(proxy.tell() == 0)
1672 self.assert_(self._file.tell() == pos)
1673
1674 def test_read(self):
1675 self._file.write('***bar***')
1676 self._test_read(mailbox._PartialFile(self._file, 3, 6))
1677
1678 def test_readline(self):
1679 self._file.write('!!!!!foo%sbar%sfred%sbob!!!!!' %
1680 (os.linesep, os.linesep, os.linesep))
1681 self._test_readline(mailbox._PartialFile(self._file, 5,
1682 18 + 3 * len(os.linesep)))
1683
1684 def test_readlines(self):
1685 self._file.write('foo%sbar%sfred%sbob?????' %
1686 (os.linesep, os.linesep, os.linesep))
1687 self._test_readlines(mailbox._PartialFile(self._file, 0,
1688 13 + 3 * len(os.linesep)))
1689
1690 def test_iteration(self):
1691 self._file.write('____foo%sbar%sfred%sbob####' %
1692 (os.linesep, os.linesep, os.linesep))
1693 self._test_iteration(mailbox._PartialFile(self._file, 4,
1694 17 + 3 * len(os.linesep)))
1695
1696 def test_seek_and_tell(self):
1697 self._file.write('(((foo%sbar%s$$$' % (os.linesep, os.linesep))
1698 self._test_seek_and_tell(mailbox._PartialFile(self._file, 3,
1699 9 + 2 * len(os.linesep)))
1700
1701 def test_close(self):
1702 self._file.write('&foo%sbar%s^' % (os.linesep, os.linesep))
1703 self._test_close(mailbox._PartialFile(self._file, 1,
1704 6 + 3 * len(os.linesep)))
1705
1706
1707## Start: tests from the original module (for backward compatibility).
1708
Skip Montanaro5253da12004-07-24 19:56:03 +00001709FROM_ = "From some.body@dummy.domain Sat Jul 24 13:43:35 2004\n"
Fred Drakec02bc3e2001-05-21 20:23:21 +00001710DUMMY_MESSAGE = """\
1711From: some.body@dummy.domain
1712To: me@my.domain
Skip Montanaro5253da12004-07-24 19:56:03 +00001713Subject: Simple Test
Fred Drakec02bc3e2001-05-21 20:23:21 +00001714
1715This is a dummy message.
1716"""
1717
Fred Drakec02bc3e2001-05-21 20:23:21 +00001718class MaildirTestCase(unittest.TestCase):
1719
1720 def setUp(self):
1721 # create a new maildir mailbox to work with:
1722 self._dir = test_support.TESTFN
1723 os.mkdir(self._dir)
1724 os.mkdir(os.path.join(self._dir, "cur"))
1725 os.mkdir(os.path.join(self._dir, "tmp"))
1726 os.mkdir(os.path.join(self._dir, "new"))
1727 self._counter = 1
1728 self._msgfiles = []
1729
1730 def tearDown(self):
1731 map(os.unlink, self._msgfiles)
1732 os.rmdir(os.path.join(self._dir, "cur"))
1733 os.rmdir(os.path.join(self._dir, "tmp"))
1734 os.rmdir(os.path.join(self._dir, "new"))
1735 os.rmdir(self._dir)
1736
Skip Montanaro5253da12004-07-24 19:56:03 +00001737 def createMessage(self, dir, mbox=False):
Jack Jansen97df7b62001-06-19 20:20:05 +00001738 t = int(time.time() % 1000000)
Fred Drakec02bc3e2001-05-21 20:23:21 +00001739 pid = self._counter
1740 self._counter += 1
Guido van Rossume2ae77b2001-10-24 20:42:55 +00001741 filename = os.extsep.join((str(t), str(pid), "myhostname", "mydomain"))
Fred Drakec02bc3e2001-05-21 20:23:21 +00001742 tmpname = os.path.join(self._dir, "tmp", filename)
1743 newname = os.path.join(self._dir, dir, filename)
1744 fp = open(tmpname, "w")
1745 self._msgfiles.append(tmpname)
Skip Montanaro5253da12004-07-24 19:56:03 +00001746 if mbox:
1747 fp.write(FROM_)
Fred Drakec02bc3e2001-05-21 20:23:21 +00001748 fp.write(DUMMY_MESSAGE)
1749 fp.close()
Tim Peters6626c1f2001-05-22 16:29:01 +00001750 if hasattr(os, "link"):
1751 os.link(tmpname, newname)
1752 else:
1753 fp = open(newname, "w")
1754 fp.write(DUMMY_MESSAGE)
1755 fp.close()
Fred Drakec02bc3e2001-05-21 20:23:21 +00001756 self._msgfiles.append(newname)
Skip Montanaro5253da12004-07-24 19:56:03 +00001757 return tmpname
Fred Drakec02bc3e2001-05-21 20:23:21 +00001758
1759 def test_empty_maildir(self):
1760 """Test an empty maildir mailbox"""
1761 # Test for regression on bug #117490:
1762 # Make sure the boxes attribute actually gets set.
1763 self.mbox = mailbox.Maildir(test_support.TESTFN)
Andrew M. Kuchling1da4a942006-04-22 02:32:43 +00001764 #self.assert_(hasattr(self.mbox, "boxes"))
1765 #self.assert_(len(self.mbox.boxes) == 0)
Fred Drakec02bc3e2001-05-21 20:23:21 +00001766 self.assert_(self.mbox.next() is None)
1767 self.assert_(self.mbox.next() is None)
1768
1769 def test_nonempty_maildir_cur(self):
1770 self.createMessage("cur")
1771 self.mbox = mailbox.Maildir(test_support.TESTFN)
Andrew M. Kuchling1da4a942006-04-22 02:32:43 +00001772 #self.assert_(len(self.mbox.boxes) == 1)
Fred Drakec02bc3e2001-05-21 20:23:21 +00001773 self.assert_(self.mbox.next() is not None)
1774 self.assert_(self.mbox.next() is None)
1775 self.assert_(self.mbox.next() is None)
1776
1777 def test_nonempty_maildir_new(self):
1778 self.createMessage("new")
1779 self.mbox = mailbox.Maildir(test_support.TESTFN)
Andrew M. Kuchling1da4a942006-04-22 02:32:43 +00001780 #self.assert_(len(self.mbox.boxes) == 1)
Fred Drakec02bc3e2001-05-21 20:23:21 +00001781 self.assert_(self.mbox.next() is not None)
1782 self.assert_(self.mbox.next() is None)
1783 self.assert_(self.mbox.next() is None)
1784
1785 def test_nonempty_maildir_both(self):
1786 self.createMessage("cur")
1787 self.createMessage("new")
1788 self.mbox = mailbox.Maildir(test_support.TESTFN)
Andrew M. Kuchling1da4a942006-04-22 02:32:43 +00001789 #self.assert_(len(self.mbox.boxes) == 2)
Fred Drakec02bc3e2001-05-21 20:23:21 +00001790 self.assert_(self.mbox.next() is not None)
1791 self.assert_(self.mbox.next() is not None)
1792 self.assert_(self.mbox.next() is None)
1793 self.assert_(self.mbox.next() is None)
Fred Drake0aaed272000-10-23 13:39:15 +00001794
Skip Montanaro5253da12004-07-24 19:56:03 +00001795 def test_unix_mbox(self):
1796 ### should be better!
Georg Brandl5a096e12007-01-22 19:40:21 +00001797 import email.parser
Skip Montanaro5253da12004-07-24 19:56:03 +00001798 fname = self.createMessage("cur", True)
1799 n = 0
1800 for msg in mailbox.PortableUnixMailbox(open(fname),
Georg Brandl5a096e12007-01-22 19:40:21 +00001801 email.parser.Parser().parse):
Skip Montanaro5253da12004-07-24 19:56:03 +00001802 n += 1
1803 self.assertEqual(msg["subject"], "Simple Test")
1804 self.assertEqual(len(str(msg)), len(FROM_)+len(DUMMY_MESSAGE))
1805 self.assertEqual(n, 1)
1806
Andrew M. Kuchling1da4a942006-04-22 02:32:43 +00001807## End: classes from the original module (for backward compatibility).
1808
1809
1810_sample_message = """\
1811Return-Path: <gkj@gregorykjohnson.com>
1812X-Original-To: gkj+person@localhost
1813Delivered-To: gkj+person@localhost
1814Received: from localhost (localhost [127.0.0.1])
Tim Peters6d7cd7d2006-04-22 05:52:59 +00001815 by andy.gregorykjohnson.com (Postfix) with ESMTP id 356ED9DD17
1816 for <gkj+person@localhost>; Wed, 13 Jul 2005 17:23:16 -0400 (EDT)
Andrew M. Kuchling1da4a942006-04-22 02:32:43 +00001817Delivered-To: gkj@sundance.gregorykjohnson.com
1818Received: from localhost [127.0.0.1]
Tim Peters6d7cd7d2006-04-22 05:52:59 +00001819 by localhost with POP3 (fetchmail-6.2.5)
1820 for gkj+person@localhost (single-drop); Wed, 13 Jul 2005 17:23:16 -0400 (EDT)
Andrew M. Kuchling1da4a942006-04-22 02:32:43 +00001821Received: from andy.gregorykjohnson.com (andy.gregorykjohnson.com [64.32.235.228])
Tim Peters6d7cd7d2006-04-22 05:52:59 +00001822 by sundance.gregorykjohnson.com (Postfix) with ESMTP id 5B056316746
1823 for <gkj@gregorykjohnson.com>; Wed, 13 Jul 2005 17:23:11 -0400 (EDT)
Andrew M. Kuchling1da4a942006-04-22 02:32:43 +00001824Received: by andy.gregorykjohnson.com (Postfix, from userid 1000)
Tim Peters6d7cd7d2006-04-22 05:52:59 +00001825 id 490CD9DD17; Wed, 13 Jul 2005 17:23:11 -0400 (EDT)
Andrew M. Kuchling1da4a942006-04-22 02:32:43 +00001826Date: Wed, 13 Jul 2005 17:23:11 -0400
1827From: "Gregory K. Johnson" <gkj@gregorykjohnson.com>
1828To: gkj@gregorykjohnson.com
1829Subject: Sample message
1830Message-ID: <20050713212311.GC4701@andy.gregorykjohnson.com>
1831Mime-Version: 1.0
1832Content-Type: multipart/mixed; boundary="NMuMz9nt05w80d4+"
1833Content-Disposition: inline
1834User-Agent: Mutt/1.5.9i
1835
1836
1837--NMuMz9nt05w80d4+
1838Content-Type: text/plain; charset=us-ascii
1839Content-Disposition: inline
1840
1841This is a sample message.
1842
Tim Peters6d7cd7d2006-04-22 05:52:59 +00001843--
Andrew M. Kuchling1da4a942006-04-22 02:32:43 +00001844Gregory K. Johnson
1845
1846--NMuMz9nt05w80d4+
1847Content-Type: application/octet-stream
1848Content-Disposition: attachment; filename="text.gz"
1849Content-Transfer-Encoding: base64
1850
1851H4sICM2D1UIAA3RleHQAC8nILFYAokSFktSKEoW0zJxUPa7wzJIMhZLyfIWczLzUYj0uAHTs
18523FYlAAAA
1853
1854--NMuMz9nt05w80d4+--
1855"""
1856
1857_sample_headers = {
1858 "Return-Path":"<gkj@gregorykjohnson.com>",
1859 "X-Original-To":"gkj+person@localhost",
1860 "Delivered-To":"gkj+person@localhost",
1861 "Received":"""from localhost (localhost [127.0.0.1])
Tim Peters6d7cd7d2006-04-22 05:52:59 +00001862 by andy.gregorykjohnson.com (Postfix) with ESMTP id 356ED9DD17
1863 for <gkj+person@localhost>; Wed, 13 Jul 2005 17:23:16 -0400 (EDT)""",
Andrew M. Kuchling1da4a942006-04-22 02:32:43 +00001864 "Delivered-To":"gkj@sundance.gregorykjohnson.com",
1865 "Received":"""from localhost [127.0.0.1]
Tim Peters6d7cd7d2006-04-22 05:52:59 +00001866 by localhost with POP3 (fetchmail-6.2.5)
1867 for gkj+person@localhost (single-drop); Wed, 13 Jul 2005 17:23:16 -0400 (EDT)""",
Andrew M. Kuchling1da4a942006-04-22 02:32:43 +00001868 "Received":"""from andy.gregorykjohnson.com (andy.gregorykjohnson.com [64.32.235.228])
Tim Peters6d7cd7d2006-04-22 05:52:59 +00001869 by sundance.gregorykjohnson.com (Postfix) with ESMTP id 5B056316746
1870 for <gkj@gregorykjohnson.com>; Wed, 13 Jul 2005 17:23:11 -0400 (EDT)""",
Andrew M. Kuchling1da4a942006-04-22 02:32:43 +00001871 "Received":"""by andy.gregorykjohnson.com (Postfix, from userid 1000)
Tim Peters6d7cd7d2006-04-22 05:52:59 +00001872 id 490CD9DD17; Wed, 13 Jul 2005 17:23:11 -0400 (EDT)""",
Andrew M. Kuchling1da4a942006-04-22 02:32:43 +00001873 "Date":"Wed, 13 Jul 2005 17:23:11 -0400",
1874 "From":""""Gregory K. Johnson" <gkj@gregorykjohnson.com>""",
1875 "To":"gkj@gregorykjohnson.com",
1876 "Subject":"Sample message",
1877 "Mime-Version":"1.0",
1878 "Content-Type":"""multipart/mixed; boundary="NMuMz9nt05w80d4+\"""",
1879 "Content-Disposition":"inline",
1880 "User-Agent": "Mutt/1.5.9i" }
1881
1882_sample_payloads = ("""This is a sample message.
1883
Tim Peters6d7cd7d2006-04-22 05:52:59 +00001884--
Andrew M. Kuchling1da4a942006-04-22 02:32:43 +00001885Gregory K. Johnson
1886""",
1887"""H4sICM2D1UIAA3RleHQAC8nILFYAokSFktSKEoW0zJxUPa7wzJIMhZLyfIWczLzUYj0uAHTs
18883FYlAAAA
1889""")
Fred Drake0aaed272000-10-23 13:39:15 +00001890
Fred Drakec02bc3e2001-05-21 20:23:21 +00001891
Fred Drake2e2be372001-09-20 21:33:42 +00001892def test_main():
Andrew M. Kuchling1da4a942006-04-22 02:32:43 +00001893 tests = (TestMailboxSuperclass, TestMaildir, TestMbox, TestMMDF, TestMH,
1894 TestBabyl, TestMessage, TestMaildirMessage, TestMboxMessage,
1895 TestMHMessage, TestBabylMessage, TestMMDFMessage,
1896 TestMessageConversion, TestProxyFile, TestPartialFile,
1897 MaildirTestCase)
1898 test_support.run_unittest(*tests)
Neal Norwitzb15ac312006-06-29 04:10:08 +00001899 test_support.reap_children()
Fred Drake2e2be372001-09-20 21:33:42 +00001900
1901
Andrew M. Kuchling1da4a942006-04-22 02:32:43 +00001902if __name__ == '__main__':
Fred Drake2e2be372001-09-20 21:33:42 +00001903 test_main()