Na}{

File Content: `iterators.py`

# Copyright (C) 2001-2006 Python Software Foundation
# Author: Barry Warsaw
# Contact: email-sig@python.org

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

__all__ = [
    'body_line_iterator',
    'typed_subpart_iterator',
    'walk',
    # Do not include _structure() since it's part of the debugging API.
    ]

import sys
from cStringIO import StringIO



# 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



# These two functions are imported into the Iterators.py interface module.
def body_line_iterator(msg, decode=False):
    """Iterate over the parts, returning string payloads line-by-line.

    Optional decode (default False) is passed through to .get_payload().
    """
    for subpart in msg.walk():
        payload = subpart.get_payload(decode=decode)
        if isinstance(payload, basestring):
            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_content_maintype() == maintype:
            if subtype is None or subpart.get_content_subtype() == subtype:
                yield subpart



def _structure(msg, fp=None, level=0, include_default=False):
    """A handy debugging aid"""
    if fp is None:
        fp = sys.stdout
    tab = ' ' * (level * 4)
    print >> fp, tab + msg.get_content_type(),
    if include_default:
        print >> fp, '[%s]' % msg.get_default_type()
    else:
        print >> fp
    if msg.is_multipart():
        for subpart in msg.get_payload():
            _structure(subpart, fp, level+1, include_default)

Name	Size	Permission
mime	---	0755
__init__.py	2856 bytes	0644
__init__.pyc	2872 bytes	0644
__init__.pyo	2872 bytes	0644
_parseaddr.py	16138 bytes	0644
_parseaddr.pyc	13893 bytes	0644
_parseaddr.pyo	13893 bytes	0644
base64mime.py	5794 bytes	0644
base64mime.pyc	5323 bytes	0644
base64mime.pyo	5323 bytes	0644
charset.py	16043 bytes	0644
charset.pyc	13540 bytes	0644
charset.pyo	13493 bytes	0644
encoders.py	2015 bytes	0644
encoders.pyc	2232 bytes	0644
encoders.pyo	2232 bytes	0644
errors.py	1628 bytes	0644
errors.pyc	3529 bytes	0644
errors.pyo	3529 bytes	0644
feedparser.py	20606 bytes	0644
feedparser.pyc	11142 bytes	0644
feedparser.pyo	11051 bytes	0644
generator.py	14228 bytes	0644
generator.pyc	10385 bytes	0644
generator.pyo	10385 bytes	0644
header.py	22243 bytes	0644
header.pyc	13662 bytes	0644
header.pyo	13592 bytes	0644
iterators.py	2202 bytes	0644
iterators.pyc	2366 bytes	0644
iterators.pyo	2366 bytes	0644
message.py	30720 bytes	0644
message.pyc	28673 bytes	0644
message.pyo	28673 bytes	0644
parser.py	3300 bytes	0644
parser.pyc	3829 bytes	0644
parser.pyo	3829 bytes	0644
quoprimime.py	10848 bytes	0644
quoprimime.pyc	8850 bytes	0644
quoprimime.pyo	8850 bytes	0644
utils.py	9863 bytes	0644
utils.pyc	9163 bytes	0644
utils.pyo	9163 bytes	0644

File Content: iterators.py

File Content: `iterators.py`