cpython/Lib/email/Iterators.py

# Copyright (C) 2001,2002 Python Software Foundation
# Author: barry@zope.com (Barry Warsaw)

"""Various types of useful iterators and generators.
"""

import sys

try:
    from email._compat22 import body_line_iterator, typed_subpart_iterator
except SyntaxError:
    # Python 2.1 doesn't have generators
    from email._compat21 import body_line_iterator, typed_subpart_iterator


def _structure(msg, level=0, fp=None):
    """A handy debugging aid"""
    if fp is None:
        fp = sys.stdout
    tab = ' ' * (level * 4)
    print >> fp, tab + msg.get_content_type()
    if msg.is_multipart():
        for subpart in msg.get_payload():
            _structure(subpart, level+1, fp)
-												Sync'ing with standalone email package 2.0.1.  This adds support for
non-us-ascii character sets in headers and bodies.  Some API changes
(with DeprecationWarnings for the old APIs).  Better RFC-compliant
implementations of base64 and quoted-printable.

Updated test cases.  Documentation updates to follow (after I finish
writing them ;).

											
										
										
											2002-04-10 21:01:31 +00:00
+								# Copyright (C) 2001,2002 Python Software Foundation
-												The email package version 1.0, prototyped as mimelib
<http://sf.net/projects/mimelib>.  There /are/ API differences between
mimelib and email, but most of the implementations are shared (except
where cool Py2.2 stuff like generators are used).

											
										
										
											2001-09-23 03:17:28 +00:00
+								# Author: barry@zope.com (Barry Warsaw)
 								"""Various types of useful iterators and generators.
 								"""
-												_structure(): Take an optional `fp' argument which would be the object
to print>> the structure to.  Defaults to sys.stdout.

											
										
										
											2002-07-19 22:21:47 +00:00
+								import sys
-												Complete a merge of the mimelib project and the Python cvs codebases
for the email package.  The former is now just a shell project that
has some extra files for packaging for independent use (e.g. setup.py
and README).

Added a compatibility layer so that the same API can be used in Python
2.1 and 2.2/2.3 with the major differences shuffled off into helper
modules (_compat21.py and _compat22.py).

Also bumped the package version number to 2.0.3 for some fixes to be
checked in momentarily.

											
										
										
											2002-05-19 23:44:19 +00:00
+								try:
 								    from email._compat22 import body_line_iterator, typed_subpart_iterator
 								except SyntaxError:
 								    # Python 2.1 doesn't have generators
 								    from email._compat21 import body_line_iterator, typed_subpart_iterator
-												_structure(): A handy little debugging aid that I don't (yet) intend
to make public, but that others might still find useful.

											
										
										
											2002-07-09 02:39:07 +00:00
-												_structure(): Take an optional `fp' argument which would be the object
to print>> the structure to.  Defaults to sys.stdout.

											
										
										
											2002-07-19 22:21:47 +00:00
+								def _structure(msg, level=0, fp=None):
-												_structure(): A handy little debugging aid that I don't (yet) intend
to make public, but that others might still find useful.

											
										
										
											2002-07-09 02:39:07 +00:00
+								    """A handy debugging aid"""
-												_structure(): Take an optional `fp' argument which would be the object
to print>> the structure to.  Defaults to sys.stdout.

											
										
										
											2002-07-19 22:21:47 +00:00
+								    if fp is None:
 								        fp = sys.stdout
-												_structure(): A handy little debugging aid that I don't (yet) intend
to make public, but that others might still find useful.

											
										
										
											2002-07-09 02:39:07 +00:00
+								    tab = ' ' * (level * 4)
-												_structure(): Use .get_content_type()

											
										
										
											2002-09-01 21:04:43 +00:00
+								    print >> fp, tab + msg.get_content_type()
-												_structure(): A handy little debugging aid that I don't (yet) intend
to make public, but that others might still find useful.

											
										
										
											2002-07-09 02:39:07 +00:00
+								    if msg.is_multipart():
 								        for subpart in msg.get_payload():
-												_structure(): Take an optional `fp' argument which would be the object
to print>> the structure to.  Defaults to sys.stdout.

											
										
										
											2002-07-19 22:21:47 +00:00
+								            _structure(subpart, level+1, fp)