summaryrefslogtreecommitdiffstats
path: root/Lib/email/_compat22.py
diff options
context:
space:
mode:
Diffstat (limited to 'Lib/email/_compat22.py')
-rw-r--r--Lib/email/_compat22.py56
1 files changed, 56 insertions, 0 deletions
diff --git a/Lib/email/_compat22.py b/Lib/email/_compat22.py
new file mode 100644
index 0000000..d505c96
--- /dev/null
+++ b/Lib/email/_compat22.py
@@ -0,0 +1,56 @@
+# Copyright (C) 2002 Python Software Foundation
+# Author: barry@zope.com
+
+"""Module containing compatibility functions for Python 2.1.
+"""
+
+from __future__ import generators
+from __future__ import division
+from cStringIO import StringIO
+from types import StringTypes
+
+
+
+# This function will become a method of the Message class
+def walk(self):
+ """Walk over the message tree, yielding each subpart.
+
+ The walk is performed in depth-first order. This method is a
+ generator.
+ """
+ yield self
+ if self.is_multipart():
+ for subpart in self.get_payload():
+ for subsubpart in subpart.walk():
+ yield subsubpart
+
+
+# Used internally by the Header class
+def _intdiv2(i):
+ """Do an integer divide by 2."""
+ return i // 2
+
+
+
+# These two functions are imported into the Iterators.py interface module.
+# The Python 2.2 version uses generators for efficiency.
+def body_line_iterator(msg):
+ """Iterate over the parts, returning string payloads line-by-line."""
+ for subpart in msg.walk():
+ payload = subpart.get_payload()
+ if isinstance(payload, StringTypes):
+ for line in StringIO(payload):
+ yield line
+
+
+def typed_subpart_iterator(msg, maintype='text', subtype=None):
+ """Iterate over the subparts with a given MIME type.
+
+ Use `maintype' as the main MIME type to match against; this defaults to
+ "text". Optional `subtype' is the MIME subtype to match against; if
+ omitted, only the main type is matched.
+ """
+ for subpart in msg.walk():
+ if subpart.get_main_type('text') == maintype:
+ if subtype is None or subpart.get_subtype('plain') == subtype:
+ yield subpart