?HAMA

Navigation

Breadcrumbs

/ / opt / alt / python37 / lib / python3.7 / site-packages / future / backports / email

Create

Create File | Create Folder | Upload Files | Run Command

Edit File Size: 5.19 KB

//opt/alt/python37/lib/python3.7/site-packages/future/backports/email/parser.py

Text Base64

# Copyright (C) 2001-2007 Python Software Foundation
# Author: Barry Warsaw, Thomas Wouters, Anthony Baxter
# Contact: email-sig@python.org

"""A parser of RFC 2822 and MIME email messages."""
from __future__ import unicode_literals
from __future__ import division
from __future__ import absolute_import

__all__ = ['Parser', 'HeaderParser', 'BytesParser', 'BytesHeaderParser']

import warnings
from io import StringIO, TextIOWrapper

from future.backports.email.feedparser import FeedParser, BytesFeedParser
from future.backports.email.message import Message
from future.backports.email._policybase import compat32

class Parser(object):
    def __init__(self, _class=Message, **_3to2kwargs):
        """Parser of RFC 2822 and MIME email messages.

Creates an in-memory object tree representing the email message, which
        can then be manipulated and turned over to a Generator to return the
        textual representation of the message.

The string must be formatted as a block of RFC 2822 headers and header
        continuation lines, optionally preceeded by a `Unix-from' header.  The
        header block is terminated either by the end of the string or by a
        blank line.

_class is the class to instantiate for new message objects when they
        must be created.  This class must have a constructor that can take
        zero arguments.  Default is Message.Message.

The policy keyword specifies a policy object that controls a number of
        aspects of the parser's operation.  The default policy maintains
        backward compatibility.

"""
        if 'policy' in _3to2kwargs: policy = _3to2kwargs['policy']; del _3to2kwargs['policy']
        else: policy = compat32
        self._class = _class
        self.policy = policy

def parse(self, fp, headersonly=False):
        """Create a message structure from the data in a file.

Reads all the data from the file and returns the root of the message
        structure.  Optional headersonly is a flag specifying whether to stop
        parsing after reading the headers or not.  The default is False,
        meaning it parses the entire contents of the file.
        """
        feedparser = FeedParser(self._class, policy=self.policy)
        if headersonly:
            feedparser._set_headersonly()
        while True:
            data = fp.read(8192)
            if not data:
                break
            feedparser.feed(data)
        return feedparser.close()

def parsestr(self, text, headersonly=False):
        """Create a message structure from a string.

Returns the root of the message structure.  Optional headersonly is a
        flag specifying whether to stop parsing after reading the headers or
        not.  The default is False, meaning it parses the entire contents of
        the file.
        """
        return self.parse(StringIO(text), headersonly=headersonly)

class HeaderParser(Parser):
    def parse(self, fp, headersonly=True):
        return Parser.parse(self, fp, True)

def parsestr(self, text, headersonly=True):
        return Parser.parsestr(self, text, True)

class BytesParser(object):

def __init__(self, *args, **kw):
        """Parser of binary RFC 2822 and MIME email messages.

Creates an in-memory object tree representing the email message, which
        can then be manipulated and turned over to a Generator to return the
        textual representation of the message.

The input must be formatted as a block of RFC 2822 headers and header
        continuation lines, optionally preceeded by a `Unix-from' header.  The
        header block is terminated either by the end of the input or by a
        blank line.

_class is the class to instantiate for new message objects when they
        must be created.  This class must have a constructor that can take
        zero arguments.  Default is Message.Message.
        """
        self.parser = Parser(*args, **kw)

def parse(self, fp, headersonly=False):
        """Create a message structure from the data in a binary file.

Reads all the data from the file and returns the root of the message
        structure.  Optional headersonly is a flag specifying whether to stop
        parsing after reading the headers or not.  The default is False,
        meaning it parses the entire contents of the file.
        """
        fp = TextIOWrapper(fp, encoding='ascii', errors='surrogateescape')
        with fp:
            return self.parser.parse(fp, headersonly)

def parsebytes(self, text, headersonly=False):
        """Create a message structure from a byte string.

Returns the root of the message structure.  Optional headersonly is a
        flag specifying whether to stop parsing after reading the headers or
        not.  The default is False, meaning it parses the entire contents of
        the file.
        """
        text = text.decode('ASCII', errors='surrogateescape')
        return self.parser.parsestr(text, headersonly)

class BytesHeaderParser(BytesParser):
    def parse(self, fp, headersonly=True):
        return BytesParser.parse(self, fp, headersonly=True)

def parsebytes(self, text, headersonly=True):
        return BytesParser.parsebytes(self, text, headersonly=True)

Exit & Reset Text mode: syntax highlighting auto-detects file type.

Directory Contents

Dirs: 2 × Files: 19

Sort:

Enable drag-to-move

Name	Size	Perms	Modified	Actions
mime DIR	-	drwxr-xr-x	2024-03-03 23:10:26	Edit Download recursive recursive
__pycache__ DIR	-	drwxr-xr-x	2024-03-03 23:10:26	Edit Download recursive recursive
base64mime.py	3.64 KB	lrw-r--r--	2018-10-25 22:21:01	Edit Download recursive recursive
charset.py	17.03 KB	lrw-r--r--	2018-10-25 22:21:01	Edit Download recursive recursive
encoders.py	2.73 KB	lrw-r--r--	2018-10-25 22:21:01	Edit Download recursive recursive
errors.py	3.59 KB	lrw-r--r--	2018-10-25 22:21:01	Edit Download recursive recursive
feedparser.py	22.20 KB	lrw-r--r--	2018-10-25 22:21:01	Edit Download recursive recursive
generator.py	19.06 KB	lrw-r--r--	2018-10-25 22:21:01	Edit Download recursive recursive
header.py	23.88 KB	lrw-r--r--	2018-10-25 22:21:01	Edit Download recursive recursive
headerregistry.py	20.15 KB	lrw-r--r--	2018-10-25 22:21:01	Edit Download recursive recursive
iterators.py	2.29 KB	lrw-r--r--	2018-10-25 22:21:01	Edit Download recursive recursive
message.py	34.40 KB	lrw-r--r--	2018-10-25 22:21:01	Edit Download recursive recursive
parser.py	5.19 KB	lrw-r--r--	2018-10-25 22:21:01	Edit Download recursive recursive
policy.py	8.62 KB	lrw-r--r--	2018-10-25 22:21:01	Edit Download recursive recursive
quoprimime.py	10.67 KB	lrw-r--r--	2018-10-25 22:21:01	Edit Download recursive recursive
utils.py	13.94 KB	lrw-r--r--	2018-10-25 22:21:01	Edit Download recursive recursive
_encoded_words.py	8.25 KB	lrw-r--r--	2018-10-25 22:21:01	Edit Download recursive recursive
_header_value_parser.py	102.24 KB	lrw-r--r--	2018-10-25 22:21:01	Edit Download recursive recursive
_parseaddr.py	16.98 KB	lrw-r--r--	2018-10-25 22:21:01	Edit Download recursive recursive
_policybase.py	14.30 KB	lrw-r--r--	2018-10-25 22:21:01	Edit Download recursive recursive
__init__.py	2.22 KB	lrw-r--r--	2018-10-25 22:21:01	Edit Download recursive recursive