���ѧۧݧ�ӧ�� �ާ֧ߧ֧էا֧� - ���֧էѧܧ�ڧ��ӧѧ�� - /home/ukubnwwtacc0unt/chapelbellstudios.com/uploads/cover/email.tar
���ѧ٧ѧ�
message.py 0000644 00000074003 15204103444 0006543 0 ustar 00 # Copyright (C) 2001-2006 Python Software Foundation # Author: Barry Warsaw # Contact: email-sig@python.org """Basic message object for the email package object model.""" __all__ = ['Message'] import re import uu import binascii import warnings from cStringIO import StringIO # Intrapackage imports import email.charset from email import utils from email import errors SEMISPACE = '; ' # Regular expression that matches `special' characters in parameters, the # existence of which force quoting of the parameter value. tspecials = re.compile(r'[ \(\)<>@,;:\\"/\[\]\?=]') # Helper functions def _splitparam(param): # Split header parameters. BAW: this may be too simple. It isn't # strictly RFC 2045 (section 5.1) compliant, but it catches most headers # found in the wild. We may eventually need a full fledged parser # eventually. a, sep, b = param.partition(';') if not sep: return a.strip(), None return a.strip(), b.strip() def _formatparam(param, value=None, quote=True): """Convenience function to format and return a key=value pair. This will quote the value if needed or if quote is true. If value is a three tuple (charset, language, value), it will be encoded according to RFC2231 rules. """ if value is not None and len(value) > 0: # A tuple is used for RFC 2231 encoded parameter values where items # are (charset, language, value). charset is a string, not a Charset # instance. if isinstance(value, tuple): # Encode as per RFC 2231 param += '*' value = utils.encode_rfc2231(value[2], value[0], value[1]) # BAW: Please check this. I think that if quote is set it should # force quoting even if not necessary. if quote or tspecials.search(value): return '%s="%s"' % (param, utils.quote(value)) else: return '%s=%s' % (param, value) else: return param def _parseparam(s): plist = [] while s[:1] == ';': s = s[1:] end = s.find(';') while end > 0 and (s.count('"', 0, end) - s.count('\\"', 0, end)) % 2: end = s.find(';', end + 1) if end < 0: end = len(s) f = s[:end] if '=' in f: i = f.index('=') f = f[:i].strip().lower() + '=' + f[i+1:].strip() plist.append(f.strip()) s = s[end:] return plist def _unquotevalue(value): # This is different than utils.collapse_rfc2231_value() because it doesn't # try to convert the value to a unicode. Message.get_param() and # Message.get_params() are both currently defined to return the tuple in # the face of RFC 2231 parameters. if isinstance(value, tuple): return value[0], value[1], utils.unquote(value[2]) else: return utils.unquote(value) class Message: """Basic message object. A message object is defined as something that has a bunch of RFC 2822 headers and a payload. It may optionally have an envelope header (a.k.a. Unix-From or From_ header). If the message is a container (i.e. a multipart or a message/rfc822), then the payload is a list of Message objects, otherwise it is a string. Message objects implement part of the `mapping' interface, which assumes there is exactly one occurrence of the header per message. Some headers do in fact appear multiple times (e.g. Received) and for those headers, you must use the explicit API to set or get all the headers. Not all of the mapping methods are implemented. """ def __init__(self): self._headers = [] self._unixfrom = None self._payload = None self._charset = None # Defaults for multipart messages self.preamble = self.epilogue = None self.defects = [] # Default content type self._default_type = 'text/plain' def __str__(self): """Return the entire formatted message as a string. This includes the headers, body, and envelope header. """ return self.as_string(unixfrom=True) def as_string(self, unixfrom=False): """Return the entire formatted message as a string. Optional `unixfrom' when True, means include the Unix From_ envelope header. This is a convenience method and may not generate the message exactly as you intend because by default it mangles lines that begin with "From ". For more flexibility, use the flatten() method of a Generator instance. """ from email.generator import Generator fp = StringIO() g = Generator(fp) g.flatten(self, unixfrom=unixfrom) return fp.getvalue() def is_multipart(self): """Return True if the message consists of multiple parts.""" return isinstance(self._payload, list) # # Unix From_ line # def set_unixfrom(self, unixfrom): self._unixfrom = unixfrom def get_unixfrom(self): return self._unixfrom # # Payload manipulation. # def attach(self, payload): """Add the given payload to the current payload. The current payload will always be a list of objects after this method is called. If you want to set the payload to a scalar object, use set_payload() instead. """ if self._payload is None: self._payload = [payload] else: self._payload.append(payload) def get_payload(self, i=None, decode=False): """Return a reference to the payload. The payload will either be a list object or a string. If you mutate the list object, you modify the message's payload in place. Optional i returns that index into the payload. Optional decode is a flag indicating whether the payload should be decoded or not, according to the Content-Transfer-Encoding header (default is False). When True and the message is not a multipart, the payload will be decoded if this header's value is `quoted-printable' or `base64'. If some other encoding is used, or the header is missing, or if the payload has bogus data (i.e. bogus base64 or uuencoded data), the payload is returned as-is. If the message is a multipart and the decode flag is True, then None is returned. """ if i is None: payload = self._payload elif not isinstance(self._payload, list): raise TypeError('Expected list, got %s' % type(self._payload)) else: payload = self._payload[i] if decode: if self.is_multipart(): return None cte = self.get('content-transfer-encoding', '').lower() if cte == 'quoted-printable': return utils._qdecode(payload) elif cte == 'base64': try: return utils._bdecode(payload) except binascii.Error: # Incorrect padding return payload elif cte in ('x-uuencode', 'uuencode', 'uue', 'x-uue'): sfp = StringIO() try: uu.decode(StringIO(payload+'\n'), sfp, quiet=True) payload = sfp.getvalue() except uu.Error: # Some decoding problem return payload # Everything else, including encodings with 8bit or 7bit are returned # unchanged. return payload def set_payload(self, payload, charset=None): """Set the payload to the given value. Optional charset sets the message's default character set. See set_charset() for details. """ self._payload = payload if charset is not None: self.set_charset(charset) def set_charset(self, charset): """Set the charset of the payload to a given character set. charset can be a Charset instance, a string naming a character set, or None. If it is a string it will be converted to a Charset instance. If charset is None, the charset parameter will be removed from the Content-Type field. Anything else will generate a TypeError. The message will be assumed to be of type text/* encoded with charset.input_charset. It will be converted to charset.output_charset and encoded properly, if needed, when generating the plain text representation of the message. MIME headers (MIME-Version, Content-Type, Content-Transfer-Encoding) will be added as needed. """ if charset is None: self.del_param('charset') self._charset = None return if isinstance(charset, basestring): charset = email.charset.Charset(charset) if not isinstance(charset, email.charset.Charset): raise TypeError(charset) # BAW: should we accept strings that can serve as arguments to the # Charset constructor? self._charset = charset if 'MIME-Version' not in self: self.add_header('MIME-Version', '1.0') if 'Content-Type' not in self: self.add_header('Content-Type', 'text/plain', charset=charset.get_output_charset()) else: self.set_param('charset', charset.get_output_charset()) if isinstance(self._payload, unicode): self._payload = self._payload.encode(charset.output_charset) if str(charset) != charset.get_output_charset(): self._payload = charset.body_encode(self._payload) if 'Content-Transfer-Encoding' not in self: cte = charset.get_body_encoding() try: cte(self) except TypeError: self._payload = charset.body_encode(self._payload) self.add_header('Content-Transfer-Encoding', cte) def get_charset(self): """Return the Charset instance associated with the message's payload. """ return self._charset # # MAPPING INTERFACE (partial) # def __len__(self): """Return the total number of headers, including duplicates.""" return len(self._headers) def __getitem__(self, name): """Get a header value. Return None if the header is missing instead of raising an exception. Note that if the header appeared multiple times, exactly which occurrence gets returned is undefined. Use get_all() to get all the values matching a header field name. """ return self.get(name) def __setitem__(self, name, val): """Set the value of a header. Note: this does not overwrite an existing header with the same field name. Use __delitem__() first to delete any existing headers. """ self._headers.append((name, val)) def __delitem__(self, name): """Delete all occurrences of a header, if present. Does not raise an exception if the header is missing. """ name = name.lower() newheaders = [] for k, v in self._headers: if k.lower() != name: newheaders.append((k, v)) self._headers = newheaders def __contains__(self, name): return name.lower() in [k.lower() for k, v in self._headers] def has_key(self, name): """Return true if the message contains the header.""" missing = object() return self.get(name, missing) is not missing def keys(self): """Return a list of all the message's header field names. These will be sorted in the order they appeared in the original message, or were added to the message, and may contain duplicates. Any fields deleted and re-inserted are always appended to the header list. """ return [k for k, v in self._headers] def values(self): """Return a list of all the message's header values. These will be sorted in the order they appeared in the original message, or were added to the message, and may contain duplicates. Any fields deleted and re-inserted are always appended to the header list. """ return [v for k, v in self._headers] def items(self): """Get all the message's header fields and values. These will be sorted in the order they appeared in the original message, or were added to the message, and may contain duplicates. Any fields deleted and re-inserted are always appended to the header list. """ return self._headers[:] def get(self, name, failobj=None): """Get a header value. Like __getitem__() but return failobj instead of None when the field is missing. """ name = name.lower() for k, v in self._headers: if k.lower() == name: return v return failobj # # Additional useful stuff # def get_all(self, name, failobj=None): """Return a list of all the values for the named field. These will be sorted in the order they appeared in the original message, and may contain duplicates. Any fields deleted and re-inserted are always appended to the header list. If no such fields exist, failobj is returned (defaults to None). """ values = [] name = name.lower() for k, v in self._headers: if k.lower() == name: values.append(v) if not values: return failobj return values def add_header(self, _name, _value, **_params): """Extended header setting. name is the header field to add. keyword arguments can be used to set additional parameters for the header field, with underscores converted to dashes. Normally the parameter will be added as key="value" unless value is None, in which case only the key will be added. If a parameter value contains non-ASCII characters it must be specified as a three-tuple of (charset, language, value), in which case it will be encoded according to RFC2231 rules. Example: msg.add_header('content-disposition', 'attachment', filename='bud.gif') """ parts = [] for k, v in _params.items(): if v is None: parts.append(k.replace('_', '-')) else: parts.append(_formatparam(k.replace('_', '-'), v)) if _value is not None: parts.insert(0, _value) self._headers.append((_name, SEMISPACE.join(parts))) def replace_header(self, _name, _value): """Replace a header. Replace the first matching header found in the message, retaining header order and case. If no matching header was found, a KeyError is raised. """ _name = _name.lower() for i, (k, v) in zip(range(len(self._headers)), self._headers): if k.lower() == _name: self._headers[i] = (k, _value) break else: raise KeyError(_name) # # Use these three methods instead of the three above. # def get_content_type(self): """Return the message's content type. The returned string is coerced to lower case of the form `maintype/subtype'. If there was no Content-Type header in the message, the default type as given by get_default_type() will be returned. Since according to RFC 2045, messages always have a default type this will always return a value. RFC 2045 defines a message's default type to be text/plain unless it appears inside a multipart/digest container, in which case it would be message/rfc822. """ missing = object() value = self.get('content-type', missing) if value is missing: # This should have no parameters return self.get_default_type() ctype = _splitparam(value)[0].lower() # RFC 2045, section 5.2 says if its invalid, use text/plain if ctype.count('/') != 1: return 'text/plain' return ctype def get_content_maintype(self): """Return the message's main content type. This is the `maintype' part of the string returned by get_content_type(). """ ctype = self.get_content_type() return ctype.split('/')[0] def get_content_subtype(self): """Returns the message's sub-content type. This is the `subtype' part of the string returned by get_content_type(). """ ctype = self.get_content_type() return ctype.split('/')[1] def get_default_type(self): """Return the `default' content type. Most messages have a default content type of text/plain, except for messages that are subparts of multipart/digest containers. Such subparts have a default content type of message/rfc822. """ return self._default_type def set_default_type(self, ctype): """Set the `default' content type. ctype should be either "text/plain" or "message/rfc822", although this is not enforced. The default content type is not stored in the Content-Type header. """ self._default_type = ctype def _get_params_preserve(self, failobj, header): # Like get_params() but preserves the quoting of values. BAW: # should this be part of the public interface? missing = object() value = self.get(header, missing) if value is missing: return failobj params = [] for p in _parseparam(';' + value): try: name, val = p.split('=', 1) name = name.strip() val = val.strip() except ValueError: # Must have been a bare attribute name = p.strip() val = '' params.append((name, val)) params = utils.decode_params(params) return params def get_params(self, failobj=None, header='content-type', unquote=True): """Return the message's Content-Type parameters, as a list. The elements of the returned list are 2-tuples of key/value pairs, as split on the `=' sign. The left hand side of the `=' is the key, while the right hand side is the value. If there is no `=' sign in the parameter the value is the empty string. The value is as described in the get_param() method. Optional failobj is the object to return if there is no Content-Type header. Optional header is the header to search instead of Content-Type. If unquote is True, the value is unquoted. """ missing = object() params = self._get_params_preserve(missing, header) if params is missing: return failobj if unquote: return [(k, _unquotevalue(v)) for k, v in params] else: return params def get_param(self, param, failobj=None, header='content-type', unquote=True): """Return the parameter value if found in the Content-Type header. Optional failobj is the object to return if there is no Content-Type header, or the Content-Type header has no such parameter. Optional header is the header to search instead of Content-Type. Parameter keys are always compared case insensitively. The return value can either be a string, or a 3-tuple if the parameter was RFC 2231 encoded. When it's a 3-tuple, the elements of the value are of the form (CHARSET, LANGUAGE, VALUE). Note that both CHARSET and LANGUAGE can be None, in which case you should consider VALUE to be encoded in the us-ascii charset. You can usually ignore LANGUAGE. Your application should be prepared to deal with 3-tuple return values, and can convert the parameter to a Unicode string like so: param = msg.get_param('foo') if isinstance(param, tuple): param = unicode(param[2], param[0] or 'us-ascii') In any case, the parameter value (either the returned string, or the VALUE item in the 3-tuple) is always unquoted, unless unquote is set to False. """ if header not in self: return failobj for k, v in self._get_params_preserve(failobj, header): if k.lower() == param.lower(): if unquote: return _unquotevalue(v) else: return v return failobj def set_param(self, param, value, header='Content-Type', requote=True, charset=None, language=''): """Set a parameter in the Content-Type header. If the parameter already exists in the header, its value will be replaced with the new value. If header is Content-Type and has not yet been defined for this message, it will be set to "text/plain" and the new parameter and value will be appended as per RFC 2045. An alternate header can be specified in the header argument, and all parameters will be quoted as necessary unless requote is False. If charset is specified, the parameter will be encoded according to RFC 2231. Optional language specifies the RFC 2231 language, defaulting to the empty string. Both charset and language should be strings. """ if not isinstance(value, tuple) and charset: value = (charset, language, value) if header not in self and header.lower() == 'content-type': ctype = 'text/plain' else: ctype = self.get(header) if not self.get_param(param, header=header): if not ctype: ctype = _formatparam(param, value, requote) else: ctype = SEMISPACE.join( [ctype, _formatparam(param, value, requote)]) else: ctype = '' for old_param, old_value in self.get_params(header=header, unquote=requote): append_param = '' if old_param.lower() == param.lower(): append_param = _formatparam(param, value, requote) else: append_param = _formatparam(old_param, old_value, requote) if not ctype: ctype = append_param else: ctype = SEMISPACE.join([ctype, append_param]) if ctype != self.get(header): del self[header] self[header] = ctype def del_param(self, param, header='content-type', requote=True): """Remove the given parameter completely from the Content-Type header. The header will be re-written in place without the parameter or its value. All values will be quoted as necessary unless requote is False. Optional header specifies an alternative to the Content-Type header. """ if header not in self: return new_ctype = '' for p, v in self.get_params(header=header, unquote=requote): if p.lower() != param.lower(): if not new_ctype: new_ctype = _formatparam(p, v, requote) else: new_ctype = SEMISPACE.join([new_ctype, _formatparam(p, v, requote)]) if new_ctype != self.get(header): del self[header] self[header] = new_ctype def set_type(self, type, header='Content-Type', requote=True): """Set the main type and subtype for the Content-Type header. type must be a string in the form "maintype/subtype", otherwise a ValueError is raised. This method replaces the Content-Type header, keeping all the parameters in place. If requote is False, this leaves the existing header's quoting as is. Otherwise, the parameters will be quoted (the default). An alternative header can be specified in the header argument. When the Content-Type header is set, we'll always also add a MIME-Version header. """ # BAW: should we be strict? if not type.count('/') == 1: raise ValueError # Set the Content-Type, you get a MIME-Version if header.lower() == 'content-type': del self['mime-version'] self['MIME-Version'] = '1.0' if header not in self: self[header] = type return params = self.get_params(header=header, unquote=requote) del self[header] self[header] = type # Skip the first param; it's the old type. for p, v in params[1:]: self.set_param(p, v, header, requote) def get_filename(self, failobj=None): """Return the filename associated with the payload if present. The filename is extracted from the Content-Disposition header's `filename' parameter, and it is unquoted. If that header is missing the `filename' parameter, this method falls back to looking for the `name' parameter. """ missing = object() filename = self.get_param('filename', missing, 'content-disposition') if filename is missing: filename = self.get_param('name', missing, 'content-type') if filename is missing: return failobj return utils.collapse_rfc2231_value(filename).strip() def get_boundary(self, failobj=None): """Return the boundary associated with the payload if present. The boundary is extracted from the Content-Type header's `boundary' parameter, and it is unquoted. """ missing = object() boundary = self.get_param('boundary', missing) if boundary is missing: return failobj # RFC 2046 says that boundaries may begin but not end in w/s return utils.collapse_rfc2231_value(boundary).rstrip() def set_boundary(self, boundary): """Set the boundary parameter in Content-Type to 'boundary'. This is subtly different than deleting the Content-Type header and adding a new one with a new boundary parameter via add_header(). The main difference is that using the set_boundary() method preserves the order of the Content-Type header in the original message. HeaderParseError is raised if the message has no Content-Type header. """ missing = object() params = self._get_params_preserve(missing, 'content-type') if params is missing: # There was no Content-Type header, and we don't know what type # to set it to, so raise an exception. raise errors.HeaderParseError('No Content-Type header found') newparams = [] foundp = False for pk, pv in params: if pk.lower() == 'boundary': newparams.append(('boundary', '"%s"' % boundary)) foundp = True else: newparams.append((pk, pv)) if not foundp: # The original Content-Type header had no boundary attribute. # Tack one on the end. BAW: should we raise an exception # instead??? newparams.append(('boundary', '"%s"' % boundary)) # Replace the existing Content-Type header with the new value newheaders = [] for h, v in self._headers: if h.lower() == 'content-type': parts = [] for k, v in newparams: if v == '': parts.append(k) else: parts.append('%s=%s' % (k, v)) newheaders.append((h, SEMISPACE.join(parts))) else: newheaders.append((h, v)) self._headers = newheaders def get_content_charset(self, failobj=None): """Return the charset parameter of the Content-Type header. The returned string is always coerced to lower case. If there is no Content-Type header, or if that header has no charset parameter, failobj is returned. """ missing = object() charset = self.get_param('charset', missing) if charset is missing: return failobj if isinstance(charset, tuple): # RFC 2231 encoded, so decode it, and it better end up as ascii. pcharset = charset[0] or 'us-ascii' try: # LookupError will be raised if the charset isn't known to # Python. UnicodeError will be raised if the encoded text # contains a character not in the charset. charset = unicode(charset[2], pcharset).encode('us-ascii') except (LookupError, UnicodeError): charset = charset[2] # charset character must be in us-ascii range try: if isinstance(charset, str): charset = unicode(charset, 'us-ascii') charset = charset.encode('us-ascii') except UnicodeError: return failobj # RFC 2046, $4.1.2 says charsets are not case sensitive return charset.lower() def get_charsets(self, failobj=None): """Return a list containing the charset(s) used in this message. The returned list of items describes the Content-Type headers' charset parameter for this message and all the subparts in its payload. Each item will either be a string (the value of the charset parameter in the Content-Type header of that part) or the value of the 'failobj' parameter (defaults to None), if the part does not have a main MIME type of "text", or the charset is not defined. The list will contain one string for each part of the message, plus one for the container message (i.e. self), so that a non-multipart message will still return a list of length 1. """ return [part.get_content_charset(failobj) for part in self.walk()] # I.e. def walk(self): ... from email.iterators import walk __init__.py 0000644 00000005450 15204103444 0006656 0 ustar 00 # Copyright (C) 2001-2006 Python Software Foundation # Author: Barry Warsaw # Contact: email-sig@python.org """A package for parsing, handling, and generating email messages.""" __version__ = '4.0.3' __all__ = [ # Old names 'base64MIME', 'Charset', 'Encoders', 'Errors', 'Generator', 'Header', 'Iterators', 'Message', 'MIMEAudio', 'MIMEBase', 'MIMEImage', 'MIMEMessage', 'MIMEMultipart', 'MIMENonMultipart', 'MIMEText', 'Parser', 'quopriMIME', 'Utils', 'message_from_string', 'message_from_file', # new names 'base64mime', 'charset', 'encoders', 'errors', 'generator', 'header', 'iterators', 'message', 'mime', 'parser', 'quoprimime', 'utils', ] # Some convenience routines. Don't import Parser and Message as side-effects # of importing email since those cascadingly import most of the rest of the # email package. def message_from_string(s, *args, **kws): """Parse a string into a Message object model. Optional _class and strict are passed to the Parser constructor. """ from email.parser import Parser return Parser(*args, **kws).parsestr(s) def message_from_file(fp, *args, **kws): """Read a file and parse its contents into a Message object model. Optional _class and strict are passed to the Parser constructor. """ from email.parser import Parser return Parser(*args, **kws).parse(fp) # Lazy loading to provide name mapping from new-style names (PEP 8 compatible # email 4.0 module names), to old-style names (email 3.0 module names). import sys class LazyImporter(object): def __init__(self, module_name): self.__name__ = 'email.' + module_name def __getattr__(self, name): __import__(self.__name__) mod = sys.modules[self.__name__] self.__dict__.update(mod.__dict__) return getattr(mod, name) _LOWERNAMES = [ # email.<old name> -> email.<new name is lowercased old name> 'Charset', 'Encoders', 'Errors', 'FeedParser', 'Generator', 'Header', 'Iterators', 'Message', 'Parser', 'Utils', 'base64MIME', 'quopriMIME', ] _MIMENAMES = [ # email.MIME<old name> -> email.mime.<new name is lowercased old name> 'Audio', 'Base', 'Image', 'Message', 'Multipart', 'NonMultipart', 'Text', ] for _name in _LOWERNAMES: importer = LazyImporter(_name.lower()) sys.modules['email.' + _name] = importer setattr(sys.modules['email'], _name, importer) import email.mime for _name in _MIMENAMES: importer = LazyImporter('mime.' + _name.lower()) sys.modules['email.MIME' + _name] = importer setattr(sys.modules['email'], 'MIME' + _name, importer) setattr(sys.modules['email.mime'], _name, importer) headerregistry.py 0000644 00000050513 15204103444 0010140 0 ustar 00 """Representing and manipulating email headers via custom objects. This module provides an implementation of the HeaderRegistry API. The implementation is designed to flexibly follow RFC5322 rules. Eventually HeaderRegistry will be a public API, but it isn't yet, and will probably change some before that happens. """ from types import MappingProxyType from email import utils from email import errors from email import _header_value_parser as parser class Address: def __init__(self, display_name='', username='', domain='', addr_spec=None): """Create an object representing a full email address. An address can have a 'display_name', a 'username', and a 'domain'. In addition to specifying the username and domain separately, they may be specified together by using the addr_spec keyword *instead of* the username and domain keywords. If an addr_spec string is specified it must be properly quoted according to RFC 5322 rules; an error will be raised if it is not. An Address object has display_name, username, domain, and addr_spec attributes, all of which are read-only. The addr_spec and the string value of the object are both quoted according to RFC5322 rules, but without any Content Transfer Encoding. """ inputs = ''.join(filter(None, (display_name, username, domain, addr_spec))) if '\r' in inputs or '\n' in inputs: raise ValueError("invalid arguments; address parts cannot contain CR or LF") # This clause with its potential 'raise' may only happen when an # application program creates an Address object using an addr_spec # keyword. The email library code itself must always supply username # and domain. if addr_spec is not None: if username or domain: raise TypeError("addrspec specified when username and/or " "domain also specified") a_s, rest = parser.get_addr_spec(addr_spec) if rest: raise ValueError("Invalid addr_spec; only '{}' " "could be parsed from '{}'".format( a_s, addr_spec)) if a_s.all_defects: raise a_s.all_defects[0] username = a_s.local_part domain = a_s.domain self._display_name = display_name self._username = username self._domain = domain @property def display_name(self): return self._display_name @property def username(self): return self._username @property def domain(self): return self._domain @property def addr_spec(self): """The addr_spec (username@domain) portion of the address, quoted according to RFC 5322 rules, but with no Content Transfer Encoding. """ nameset = set(self.username) if len(nameset) > len(nameset-parser.DOT_ATOM_ENDS): lp = parser.quote_string(self.username) else: lp = self.username if self.domain: return lp + '@' + self.domain if not lp: return '<>' return lp def __repr__(self): return "{}(display_name={!r}, username={!r}, domain={!r})".format( self.__class__.__name__, self.display_name, self.username, self.domain) def __str__(self): nameset = set(self.display_name) if len(nameset) > len(nameset-parser.SPECIALS): disp = parser.quote_string(self.display_name) else: disp = self.display_name if disp: addr_spec = '' if self.addr_spec=='<>' else self.addr_spec return "{} <{}>".format(disp, addr_spec) return self.addr_spec def __eq__(self, other): if type(other) != type(self): return False return (self.display_name == other.display_name and self.username == other.username and self.domain == other.domain) class Group: def __init__(self, display_name=None, addresses=None): """Create an object representing an address group. An address group consists of a display_name followed by colon and a list of addresses (see Address) terminated by a semi-colon. The Group is created by specifying a display_name and a possibly empty list of Address objects. A Group can also be used to represent a single address that is not in a group, which is convenient when manipulating lists that are a combination of Groups and individual Addresses. In this case the display_name should be set to None. In particular, the string representation of a Group whose display_name is None is the same as the Address object, if there is one and only one Address object in the addresses list. """ self._display_name = display_name self._addresses = tuple(addresses) if addresses else tuple() @property def display_name(self): return self._display_name @property def addresses(self): return self._addresses def __repr__(self): return "{}(display_name={!r}, addresses={!r}".format( self.__class__.__name__, self.display_name, self.addresses) def __str__(self): if self.display_name is None and len(self.addresses)==1: return str(self.addresses[0]) disp = self.display_name if disp is not None: nameset = set(disp) if len(nameset) > len(nameset-parser.SPECIALS): disp = parser.quote_string(disp) adrstr = ", ".join(str(x) for x in self.addresses) adrstr = ' ' + adrstr if adrstr else adrstr return "{}:{};".format(disp, adrstr) def __eq__(self, other): if type(other) != type(self): return False return (self.display_name == other.display_name and self.addresses == other.addresses) # Header Classes # class BaseHeader(str): """Base class for message headers. Implements generic behavior and provides tools for subclasses. A subclass must define a classmethod named 'parse' that takes an unfolded value string and a dictionary as its arguments. The dictionary will contain one key, 'defects', initialized to an empty list. After the call the dictionary must contain two additional keys: parse_tree, set to the parse tree obtained from parsing the header, and 'decoded', set to the string value of the idealized representation of the data from the value. (That is, encoded words are decoded, and values that have canonical representations are so represented.) The defects key is intended to collect parsing defects, which the message parser will subsequently dispose of as appropriate. The parser should not, insofar as practical, raise any errors. Defects should be added to the list instead. The standard header parsers register defects for RFC compliance issues, for obsolete RFC syntax, and for unrecoverable parsing errors. The parse method may add additional keys to the dictionary. In this case the subclass must define an 'init' method, which will be passed the dictionary as its keyword arguments. The method should use (usually by setting them as the value of similarly named attributes) and remove all the extra keys added by its parse method, and then use super to call its parent class with the remaining arguments and keywords. The subclass should also make sure that a 'max_count' attribute is defined that is either None or 1. XXX: need to better define this API. """ def __new__(cls, name, value): kwds = {'defects': []} cls.parse(value, kwds) if utils._has_surrogates(kwds['decoded']): kwds['decoded'] = utils._sanitize(kwds['decoded']) self = str.__new__(cls, kwds['decoded']) del kwds['decoded'] self.init(name, **kwds) return self def init(self, name, *, parse_tree, defects): self._name = name self._parse_tree = parse_tree self._defects = defects @property def name(self): return self._name @property def defects(self): return tuple(self._defects) def __reduce__(self): return ( _reconstruct_header, ( self.__class__.__name__, self.__class__.__bases__, str(self), ), self.__dict__) @classmethod def _reconstruct(cls, value): return str.__new__(cls, value) def fold(self, *, policy): """Fold header according to policy. The parsed representation of the header is folded according to RFC5322 rules, as modified by the policy. If the parse tree contains surrogateescaped bytes, the bytes are CTE encoded using the charset 'unknown-8bit". Any non-ASCII characters in the parse tree are CTE encoded using charset utf-8. XXX: make this a policy setting. The returned value is an ASCII-only string possibly containing linesep characters, and ending with a linesep character. The string includes the header name and the ': ' separator. """ # At some point we need to put fws here if it was in the source. header = parser.Header([ parser.HeaderLabel([ parser.ValueTerminal(self.name, 'header-name'), parser.ValueTerminal(':', 'header-sep')]), ]) if self._parse_tree: header.append( parser.CFWSList([parser.WhiteSpaceTerminal(' ', 'fws')])) header.append(self._parse_tree) return header.fold(policy=policy) def _reconstruct_header(cls_name, bases, value): return type(cls_name, bases, {})._reconstruct(value) class UnstructuredHeader: max_count = None value_parser = staticmethod(parser.get_unstructured) @classmethod def parse(cls, value, kwds): kwds['parse_tree'] = cls.value_parser(value) kwds['decoded'] = str(kwds['parse_tree']) class UniqueUnstructuredHeader(UnstructuredHeader): max_count = 1 class DateHeader: """Header whose value consists of a single timestamp. Provides an additional attribute, datetime, which is either an aware datetime using a timezone, or a naive datetime if the timezone in the input string is -0000. Also accepts a datetime as input. The 'value' attribute is the normalized form of the timestamp, which means it is the output of format_datetime on the datetime. """ max_count = None # This is used only for folding, not for creating 'decoded'. value_parser = staticmethod(parser.get_unstructured) @classmethod def parse(cls, value, kwds): if not value: kwds['defects'].append(errors.HeaderMissingRequiredValue()) kwds['datetime'] = None kwds['decoded'] = '' kwds['parse_tree'] = parser.TokenList() return if isinstance(value, str): value = utils.parsedate_to_datetime(value) kwds['datetime'] = value kwds['decoded'] = utils.format_datetime(kwds['datetime']) kwds['parse_tree'] = cls.value_parser(kwds['decoded']) def init(self, *args, **kw): self._datetime = kw.pop('datetime') super().init(*args, **kw) @property def datetime(self): return self._datetime class UniqueDateHeader(DateHeader): max_count = 1 class AddressHeader: max_count = None @staticmethod def value_parser(value): address_list, value = parser.get_address_list(value) assert not value, 'this should not happen' return address_list @classmethod def parse(cls, value, kwds): if isinstance(value, str): # We are translating here from the RFC language (address/mailbox) # to our API language (group/address). kwds['parse_tree'] = address_list = cls.value_parser(value) groups = [] for addr in address_list.addresses: groups.append(Group(addr.display_name, [Address(mb.display_name or '', mb.local_part or '', mb.domain or '') for mb in addr.all_mailboxes])) defects = list(address_list.all_defects) else: # Assume it is Address/Group stuff if not hasattr(value, '__iter__'): value = [value] groups = [Group(None, [item]) if not hasattr(item, 'addresses') else item for item in value] defects = [] kwds['groups'] = groups kwds['defects'] = defects kwds['decoded'] = ', '.join([str(item) for item in groups]) if 'parse_tree' not in kwds: kwds['parse_tree'] = cls.value_parser(kwds['decoded']) def init(self, *args, **kw): self._groups = tuple(kw.pop('groups')) self._addresses = None super().init(*args, **kw) @property def groups(self): return self._groups @property def addresses(self): if self._addresses is None: self._addresses = tuple(address for group in self._groups for address in group.addresses) return self._addresses class UniqueAddressHeader(AddressHeader): max_count = 1 class SingleAddressHeader(AddressHeader): @property def address(self): if len(self.addresses)!=1: raise ValueError(("value of single address header {} is not " "a single address").format(self.name)) return self.addresses[0] class UniqueSingleAddressHeader(SingleAddressHeader): max_count = 1 class MIMEVersionHeader: max_count = 1 value_parser = staticmethod(parser.parse_mime_version) @classmethod def parse(cls, value, kwds): kwds['parse_tree'] = parse_tree = cls.value_parser(value) kwds['decoded'] = str(parse_tree) kwds['defects'].extend(parse_tree.all_defects) kwds['major'] = None if parse_tree.minor is None else parse_tree.major kwds['minor'] = parse_tree.minor if parse_tree.minor is not None: kwds['version'] = '{}.{}'.format(kwds['major'], kwds['minor']) else: kwds['version'] = None def init(self, *args, **kw): self._version = kw.pop('version') self._major = kw.pop('major') self._minor = kw.pop('minor') super().init(*args, **kw) @property def major(self): return self._major @property def minor(self): return self._minor @property def version(self): return self._version class ParameterizedMIMEHeader: # Mixin that handles the params dict. Must be subclassed and # a property value_parser for the specific header provided. max_count = 1 @classmethod def parse(cls, value, kwds): kwds['parse_tree'] = parse_tree = cls.value_parser(value) kwds['decoded'] = str(parse_tree) kwds['defects'].extend(parse_tree.all_defects) if parse_tree.params is None: kwds['params'] = {} else: # The MIME RFCs specify that parameter ordering is arbitrary. kwds['params'] = {utils._sanitize(name).lower(): utils._sanitize(value) for name, value in parse_tree.params} def init(self, *args, **kw): self._params = kw.pop('params') super().init(*args, **kw) @property def params(self): return MappingProxyType(self._params) class ContentTypeHeader(ParameterizedMIMEHeader): value_parser = staticmethod(parser.parse_content_type_header) def init(self, *args, **kw): super().init(*args, **kw) self._maintype = utils._sanitize(self._parse_tree.maintype) self._subtype = utils._sanitize(self._parse_tree.subtype) @property def maintype(self): return self._maintype @property def subtype(self): return self._subtype @property def content_type(self): return self.maintype + '/' + self.subtype class ContentDispositionHeader(ParameterizedMIMEHeader): value_parser = staticmethod(parser.parse_content_disposition_header) def init(self, *args, **kw): super().init(*args, **kw) cd = self._parse_tree.content_disposition self._content_disposition = cd if cd is None else utils._sanitize(cd) @property def content_disposition(self): return self._content_disposition class ContentTransferEncodingHeader: max_count = 1 value_parser = staticmethod(parser.parse_content_transfer_encoding_header) @classmethod def parse(cls, value, kwds): kwds['parse_tree'] = parse_tree = cls.value_parser(value) kwds['decoded'] = str(parse_tree) kwds['defects'].extend(parse_tree.all_defects) def init(self, *args, **kw): super().init(*args, **kw) self._cte = utils._sanitize(self._parse_tree.cte) @property def cte(self): return self._cte class MessageIDHeader: max_count = 1 value_parser = staticmethod(parser.parse_message_id) @classmethod def parse(cls, value, kwds): kwds['parse_tree'] = parse_tree = cls.value_parser(value) kwds['decoded'] = str(parse_tree) kwds['defects'].extend(parse_tree.all_defects) # The header factory # _default_header_map = { 'subject': UniqueUnstructuredHeader, 'date': UniqueDateHeader, 'resent-date': DateHeader, 'orig-date': UniqueDateHeader, 'sender': UniqueSingleAddressHeader, 'resent-sender': SingleAddressHeader, 'to': UniqueAddressHeader, 'resent-to': AddressHeader, 'cc': UniqueAddressHeader, 'resent-cc': AddressHeader, 'bcc': UniqueAddressHeader, 'resent-bcc': AddressHeader, 'from': UniqueAddressHeader, 'resent-from': AddressHeader, 'reply-to': UniqueAddressHeader, 'mime-version': MIMEVersionHeader, 'content-type': ContentTypeHeader, 'content-disposition': ContentDispositionHeader, 'content-transfer-encoding': ContentTransferEncodingHeader, 'message-id': MessageIDHeader, } class HeaderRegistry: """A header_factory and header registry.""" def __init__(self, base_class=BaseHeader, default_class=UnstructuredHeader, use_default_map=True): """Create a header_factory that works with the Policy API. base_class is the class that will be the last class in the created header class's __bases__ list. default_class is the class that will be used if "name" (see __call__) does not appear in the registry. use_default_map controls whether or not the default mapping of names to specialized classes is copied in to the registry when the factory is created. The default is True. """ self.registry = {} self.base_class = base_class self.default_class = default_class if use_default_map: self.registry.update(_default_header_map) def map_to_type(self, name, cls): """Register cls as the specialized class for handling "name" headers. """ self.registry[name.lower()] = cls def __getitem__(self, name): cls = self.registry.get(name.lower(), self.default_class) return type('_'+cls.__name__, (cls, self.base_class), {}) def __call__(self, name, value): """Create a header instance for header 'name' from 'value'. Creates a header instance by creating a specialized class for parsing and representing the specified header by combining the factory base_class with a specialized class from the registry or the default_class, and passing the name and value to the constructed class's constructor. """ return self[name](name, value) charset.py 0000644 00000037254 15204103444 0006557 0 ustar 00 # Copyright (C) 2001-2006 Python Software Foundation # Author: Ben Gertzfield, Barry Warsaw # Contact: email-sig@python.org __all__ = [ 'Charset', 'add_alias', 'add_charset', 'add_codec', ] import codecs import email.base64mime import email.quoprimime from email import errors from email.encoders import encode_7or8bit # Flags for types of header encodings QP = 1 # Quoted-Printable BASE64 = 2 # Base64 SHORTEST = 3 # the shorter of QP and base64, but only for headers # In "=?charset?q?hello_world?=", the =?, ?q?, and ?= add up to 7 MISC_LEN = 7 DEFAULT_CHARSET = 'us-ascii' # Defaults CHARSETS = { # input header enc body enc output conv 'iso-8859-1': (QP, QP, None), 'iso-8859-2': (QP, QP, None), 'iso-8859-3': (QP, QP, None), 'iso-8859-4': (QP, QP, None), # iso-8859-5 is Cyrillic, and not especially used # iso-8859-6 is Arabic, also not particularly used # iso-8859-7 is Greek, QP will not make it readable # iso-8859-8 is Hebrew, QP will not make it readable 'iso-8859-9': (QP, QP, None), 'iso-8859-10': (QP, QP, None), # iso-8859-11 is Thai, QP will not make it readable 'iso-8859-13': (QP, QP, None), 'iso-8859-14': (QP, QP, None), 'iso-8859-15': (QP, QP, None), 'iso-8859-16': (QP, QP, None), 'windows-1252':(QP, QP, None), 'viscii': (QP, QP, None), 'us-ascii': (None, None, None), 'big5': (BASE64, BASE64, None), 'gb2312': (BASE64, BASE64, None), 'euc-jp': (BASE64, None, 'iso-2022-jp'), 'shift_jis': (BASE64, None, 'iso-2022-jp'), 'iso-2022-jp': (BASE64, None, None), 'koi8-r': (BASE64, BASE64, None), 'utf-8': (SHORTEST, BASE64, 'utf-8'), # We're making this one up to represent raw unencoded 8-bit '8bit': (None, BASE64, 'utf-8'), } # Aliases for other commonly-used names for character sets. Map # them to the real ones used in email. ALIASES = { 'latin_1': 'iso-8859-1', 'latin-1': 'iso-8859-1', 'latin_2': 'iso-8859-2', 'latin-2': 'iso-8859-2', 'latin_3': 'iso-8859-3', 'latin-3': 'iso-8859-3', 'latin_4': 'iso-8859-4', 'latin-4': 'iso-8859-4', 'latin_5': 'iso-8859-9', 'latin-5': 'iso-8859-9', 'latin_6': 'iso-8859-10', 'latin-6': 'iso-8859-10', 'latin_7': 'iso-8859-13', 'latin-7': 'iso-8859-13', 'latin_8': 'iso-8859-14', 'latin-8': 'iso-8859-14', 'latin_9': 'iso-8859-15', 'latin-9': 'iso-8859-15', 'latin_10':'iso-8859-16', 'latin-10':'iso-8859-16', 'cp949': 'ks_c_5601-1987', 'euc_jp': 'euc-jp', 'euc_kr': 'euc-kr', 'ascii': 'us-ascii', } # Map charsets to their Unicode codec strings. CODEC_MAP = { 'gb2312': 'eucgb2312_cn', 'big5': 'big5_tw', # Hack: We don't want *any* conversion for stuff marked us-ascii, as all # sorts of garbage might be sent to us in the guise of 7-bit us-ascii. # Let that stuff pass through without conversion to/from Unicode. 'us-ascii': None, } # Convenience functions for extending the above mappings def add_charset(charset, header_enc=None, body_enc=None, output_charset=None): """Add character set properties to the global registry. charset is the input character set, and must be the canonical name of a character set. Optional header_enc and body_enc is either Charset.QP for quoted-printable, Charset.BASE64 for base64 encoding, Charset.SHORTEST for the shortest of qp or base64 encoding, or None for no encoding. SHORTEST is only valid for header_enc. It describes how message headers and message bodies in the input charset are to be encoded. Default is no encoding. Optional output_charset is the character set that the output should be in. Conversions will proceed from input charset, to Unicode, to the output charset when the method Charset.convert() is called. The default is to output in the same character set as the input. Both input_charset and output_charset must have Unicode codec entries in the module's charset-to-codec mapping; use add_codec(charset, codecname) to add codecs the module does not know about. See the codecs module's documentation for more information. """ if body_enc == SHORTEST: raise ValueError('SHORTEST not allowed for body_enc') CHARSETS[charset] = (header_enc, body_enc, output_charset) def add_alias(alias, canonical): """Add a character set alias. alias is the alias name, e.g. latin-1 canonical is the character set's canonical name, e.g. iso-8859-1 """ ALIASES[alias] = canonical def add_codec(charset, codecname): """Add a codec that map characters in the given charset to/from Unicode. charset is the canonical name of a character set. codecname is the name of a Python codec, as appropriate for the second argument to the unicode() built-in, or to the encode() method of a Unicode string. """ CODEC_MAP[charset] = codecname class Charset: """Map character sets to their email properties. This class provides information about the requirements imposed on email for a specific character set. It also provides convenience routines for converting between character sets, given the availability of the applicable codecs. Given a character set, it will do its best to provide information on how to use that character set in an email in an RFC-compliant way. Certain character sets must be encoded with quoted-printable or base64 when used in email headers or bodies. Certain character sets must be converted outright, and are not allowed in email. Instances of this module expose the following information about a character set: input_charset: The initial character set specified. Common aliases are converted to their `official' email names (e.g. latin_1 is converted to iso-8859-1). Defaults to 7-bit us-ascii. header_encoding: If the character set must be encoded before it can be used in an email header, this attribute will be set to Charset.QP (for quoted-printable), Charset.BASE64 (for base64 encoding), or Charset.SHORTEST for the shortest of QP or BASE64 encoding. Otherwise, it will be None. body_encoding: Same as header_encoding, but describes the encoding for the mail message's body, which indeed may be different than the header encoding. Charset.SHORTEST is not allowed for body_encoding. output_charset: Some character sets must be converted before they can be used in email headers or bodies. If the input_charset is one of them, this attribute will contain the name of the charset output will be converted to. Otherwise, it will be None. input_codec: The name of the Python codec used to convert the input_charset to Unicode. If no conversion codec is necessary, this attribute will be None. output_codec: The name of the Python codec used to convert Unicode to the output_charset. If no conversion codec is necessary, this attribute will have the same value as the input_codec. """ def __init__(self, input_charset=DEFAULT_CHARSET): # RFC 2046, $4.1.2 says charsets are not case sensitive. We coerce to # unicode because its .lower() is locale insensitive. If the argument # is already a unicode, we leave it at that, but ensure that the # charset is ASCII, as the standard (RFC XXX) requires. try: if isinstance(input_charset, unicode): input_charset.encode('ascii') else: input_charset = unicode(input_charset, 'ascii') except UnicodeError: raise errors.CharsetError(input_charset) input_charset = input_charset.lower().encode('ascii') # Set the input charset after filtering through the aliases and/or codecs if not (input_charset in ALIASES or input_charset in CHARSETS): try: input_charset = codecs.lookup(input_charset).name except LookupError: pass self.input_charset = ALIASES.get(input_charset, input_charset) # We can try to guess which encoding and conversion to use by the # charset_map dictionary. Try that first, but let the user override # it. henc, benc, conv = CHARSETS.get(self.input_charset, (SHORTEST, BASE64, None)) if not conv: conv = self.input_charset # Set the attributes, allowing the arguments to override the default. self.header_encoding = henc self.body_encoding = benc self.output_charset = ALIASES.get(conv, conv) # Now set the codecs. If one isn't defined for input_charset, # guess and try a Unicode codec with the same name as input_codec. self.input_codec = CODEC_MAP.get(self.input_charset, self.input_charset) self.output_codec = CODEC_MAP.get(self.output_charset, self.output_charset) def __str__(self): return self.input_charset.lower() __repr__ = __str__ def __eq__(self, other): return str(self) == str(other).lower() def __ne__(self, other): return not self.__eq__(other) def get_body_encoding(self): """Return the content-transfer-encoding used for body encoding. This is either the string `quoted-printable' or `base64' depending on the encoding used, or it is a function in which case you should call the function with a single argument, the Message object being encoded. The function should then set the Content-Transfer-Encoding header itself to whatever is appropriate. Returns "quoted-printable" if self.body_encoding is QP. Returns "base64" if self.body_encoding is BASE64. Returns "7bit" otherwise. """ assert self.body_encoding != SHORTEST if self.body_encoding == QP: return 'quoted-printable' elif self.body_encoding == BASE64: return 'base64' else: return encode_7or8bit def convert(self, s): """Convert a string from the input_codec to the output_codec.""" if self.input_codec != self.output_codec: return unicode(s, self.input_codec).encode(self.output_codec) else: return s def to_splittable(self, s): """Convert a possibly multibyte string to a safely splittable format. Uses the input_codec to try and convert the string to Unicode, so it can be safely split on character boundaries (even for multibyte characters). Returns the string as-is if it isn't known how to convert it to Unicode with the input_charset. Characters that could not be converted to Unicode will be replaced with the Unicode replacement character U+FFFD. """ if isinstance(s, unicode) or self.input_codec is None: return s try: return unicode(s, self.input_codec, 'replace') except LookupError: # Input codec not installed on system, so return the original # string unchanged. return s def from_splittable(self, ustr, to_output=True): """Convert a splittable string back into an encoded string. Uses the proper codec to try and convert the string from Unicode back into an encoded format. Return the string as-is if it is not Unicode, or if it could not be converted from Unicode. Characters that could not be converted from Unicode will be replaced with an appropriate character (usually '?'). If to_output is True (the default), uses output_codec to convert to an encoded format. If to_output is False, uses input_codec. """ if to_output: codec = self.output_codec else: codec = self.input_codec if not isinstance(ustr, unicode) or codec is None: return ustr try: return ustr.encode(codec, 'replace') except LookupError: # Output codec not installed return ustr def get_output_charset(self): """Return the output character set. This is self.output_charset if that is not None, otherwise it is self.input_charset. """ return self.output_charset or self.input_charset def encoded_header_len(self, s): """Return the length of the encoded header string.""" cset = self.get_output_charset() # The len(s) of a 7bit encoding is len(s) if self.header_encoding == BASE64: return email.base64mime.base64_len(s) + len(cset) + MISC_LEN elif self.header_encoding == QP: return email.quoprimime.header_quopri_len(s) + len(cset) + MISC_LEN elif self.header_encoding == SHORTEST: lenb64 = email.base64mime.base64_len(s) lenqp = email.quoprimime.header_quopri_len(s) return min(lenb64, lenqp) + len(cset) + MISC_LEN else: return len(s) def header_encode(self, s, convert=False): """Header-encode a string, optionally converting it to output_charset. If convert is True, the string will be converted from the input charset to the output charset automatically. This is not useful for multibyte character sets, which have line length issues (multibyte characters must be split on a character, not a byte boundary); use the high-level Header class to deal with these issues. convert defaults to False. The type of encoding (base64 or quoted-printable) will be based on self.header_encoding. """ cset = self.get_output_charset() if convert: s = self.convert(s) # 7bit/8bit encodings return the string unchanged (modulo conversions) if self.header_encoding == BASE64: return email.base64mime.header_encode(s, cset) elif self.header_encoding == QP: return email.quoprimime.header_encode(s, cset, maxlinelen=None) elif self.header_encoding == SHORTEST: lenb64 = email.base64mime.base64_len(s) lenqp = email.quoprimime.header_quopri_len(s) if lenb64 < lenqp: return email.base64mime.header_encode(s, cset) else: return email.quoprimime.header_encode(s, cset, maxlinelen=None) else: return s def body_encode(self, s, convert=True): """Body-encode a string and convert it to output_charset. If convert is True (the default), the string will be converted from the input charset to output charset automatically. Unlike header_encode(), there are no issues with byte boundaries and multibyte charsets in email bodies, so this is usually pretty safe. The type of encoding (base64 or quoted-printable) will be based on self.body_encoding. """ if convert: s = self.convert(s) # 7bit/8bit encodings return the string unchanged (module conversions) if self.body_encoding is BASE64: return email.base64mime.body_encode(s) elif self.body_encoding is QP: return email.quoprimime.body_encode(s) else: return s iterators.py 0000644 00000004232 15204103444 0007130 0 ustar 00 # 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) _parseaddr.py 0000644 00000037412 15204103444 0007226 0 ustar 00 # Copyright (C) 2002-2007 Python Software Foundation # Contact: email-sig@python.org """Email address parsing code. Lifted directly from rfc822.py. This should eventually be rewritten. """ __all__ = [ 'mktime_tz', 'parsedate', 'parsedate_tz', 'quote', ] import time, calendar SPACE = ' ' EMPTYSTRING = '' COMMASPACE = ', ' # Parse a date field _monthnames = ['jan', 'feb', 'mar', 'apr', 'may', 'jun', 'jul', 'aug', 'sep', 'oct', 'nov', 'dec', 'january', 'february', 'march', 'april', 'may', 'june', 'july', 'august', 'september', 'october', 'november', 'december'] _daynames = ['mon', 'tue', 'wed', 'thu', 'fri', 'sat', 'sun'] # The timezone table does not include the military time zones defined # in RFC822, other than Z. According to RFC1123, the description in # RFC822 gets the signs wrong, so we can't rely on any such time # zones. RFC1123 recommends that numeric timezone indicators be used # instead of timezone names. _timezones = {'UT':0, 'UTC':0, 'GMT':0, 'Z':0, 'AST': -400, 'ADT': -300, # Atlantic (used in Canada) 'EST': -500, 'EDT': -400, # Eastern 'CST': -600, 'CDT': -500, # Central 'MST': -700, 'MDT': -600, # Mountain 'PST': -800, 'PDT': -700 # Pacific } def parsedate_tz(data): """Convert a date string to a time tuple. Accounts for military timezones. """ data = data.split() # The FWS after the comma after the day-of-week is optional, so search and # adjust for this. if data[0].endswith(',') or data[0].lower() in _daynames: # There's a dayname here. Skip it del data[0] else: i = data[0].rfind(',') if i >= 0: data[0] = data[0][i+1:] if len(data) == 3: # RFC 850 date, deprecated stuff = data[0].split('-') if len(stuff) == 3: data = stuff + data[1:] if len(data) == 4: s = data[3] i = s.find('+') if i > 0: data[3:] = [s[:i], s[i+1:]] else: data.append('') # Dummy tz if len(data) < 5: return None data = data[:5] [dd, mm, yy, tm, tz] = data mm = mm.lower() if mm not in _monthnames: dd, mm = mm, dd.lower() if mm not in _monthnames: return None mm = _monthnames.index(mm) + 1 if mm > 12: mm -= 12 if dd[-1] == ',': dd = dd[:-1] i = yy.find(':') if i > 0: yy, tm = tm, yy if yy[-1] == ',': yy = yy[:-1] if not yy[0].isdigit(): yy, tz = tz, yy if tm[-1] == ',': tm = tm[:-1] tm = tm.split(':') if len(tm) == 2: [thh, tmm] = tm tss = '0' elif len(tm) == 3: [thh, tmm, tss] = tm else: return None try: yy = int(yy) dd = int(dd) thh = int(thh) tmm = int(tmm) tss = int(tss) except ValueError: return None # Check for a yy specified in two-digit format, then convert it to the # appropriate four-digit format, according to the POSIX standard. RFC 822 # calls for a two-digit yy, but RFC 2822 (which obsoletes RFC 822) # mandates a 4-digit yy. For more information, see the documentation for # the time module. if yy < 100: # The year is between 1969 and 1999 (inclusive). if yy > 68: yy += 1900 # The year is between 2000 and 2068 (inclusive). else: yy += 2000 tzoffset = None tz = tz.upper() if tz in _timezones: tzoffset = _timezones[tz] else: try: tzoffset = int(tz) except ValueError: pass # Convert a timezone offset into seconds ; -0500 -> -18000 if tzoffset: if tzoffset < 0: tzsign = -1 tzoffset = -tzoffset else: tzsign = 1 tzoffset = tzsign * ( (tzoffset//100)*3600 + (tzoffset % 100)*60) # Daylight Saving Time flag is set to -1, since DST is unknown. return yy, mm, dd, thh, tmm, tss, 0, 1, -1, tzoffset def parsedate(data): """Convert a time string to a time tuple.""" t = parsedate_tz(data) if isinstance(t, tuple): return t[:9] else: return t def mktime_tz(data): """Turn a 10-tuple as returned by parsedate_tz() into a POSIX timestamp.""" if data[9] is None: # No zone info, so localtime is better assumption than GMT return time.mktime(data[:8] + (-1,)) else: t = calendar.timegm(data) return t - data[9] def quote(str): """Prepare string to be used in a quoted string. Turns backslash and double quote characters into quoted pairs. These are the only characters that need to be quoted inside a quoted string. Does not add the surrounding double quotes. """ return str.replace('\\', '\\\\').replace('"', '\\"') class AddrlistClass: """Address parser class by Ben Escoto. To understand what this class does, it helps to have a copy of RFC 2822 in front of you. Note: this class interface is deprecated and may be removed in the future. Use rfc822.AddressList instead. """ def __init__(self, field): """Initialize a new instance. `field' is an unparsed address header field, containing one or more addresses. """ self.specials = '()<>@,:;.\"[]' self.pos = 0 self.LWS = ' \t' self.CR = '\r\n' self.FWS = self.LWS + self.CR self.atomends = self.specials + self.LWS + self.CR # Note that RFC 2822 now specifies `.' as obs-phrase, meaning that it # is obsolete syntax. RFC 2822 requires that we recognize obsolete # syntax, so allow dots in phrases. self.phraseends = self.atomends.replace('.', '') self.field = field self.commentlist = [] def gotonext(self): """Parse up to the start of the next address.""" while self.pos < len(self.field): if self.field[self.pos] in self.LWS + '\n\r': self.pos += 1 elif self.field[self.pos] == '(': self.commentlist.append(self.getcomment()) else: break def getaddrlist(self): """Parse all addresses. Returns a list containing all of the addresses. """ result = [] while self.pos < len(self.field): ad = self.getaddress() if ad: result += ad else: result.append(('', '')) return result def getaddress(self): """Parse the next address.""" self.commentlist = [] self.gotonext() oldpos = self.pos oldcl = self.commentlist plist = self.getphraselist() self.gotonext() returnlist = [] if self.pos >= len(self.field): # Bad email address technically, no domain. if plist: returnlist = [(SPACE.join(self.commentlist), plist[0])] elif self.field[self.pos] in '.@': # email address is just an addrspec # this isn't very efficient since we start over self.pos = oldpos self.commentlist = oldcl addrspec = self.getaddrspec() returnlist = [(SPACE.join(self.commentlist), addrspec)] elif self.field[self.pos] == ':': # address is a group returnlist = [] fieldlen = len(self.field) self.pos += 1 while self.pos < len(self.field): self.gotonext() if self.pos < fieldlen and self.field[self.pos] == ';': self.pos += 1 break returnlist = returnlist + self.getaddress() elif self.field[self.pos] == '<': # Address is a phrase then a route addr routeaddr = self.getrouteaddr() if self.commentlist: returnlist = [(SPACE.join(plist) + ' (' + ' '.join(self.commentlist) + ')', routeaddr)] else: returnlist = [(SPACE.join(plist), routeaddr)] else: if plist: returnlist = [(SPACE.join(self.commentlist), plist[0])] elif self.field[self.pos] in self.specials: self.pos += 1 self.gotonext() if self.pos < len(self.field) and self.field[self.pos] == ',': self.pos += 1 return returnlist def getrouteaddr(self): """Parse a route address (Return-path value). This method just skips all the route stuff and returns the addrspec. """ if self.field[self.pos] != '<': return expectroute = False self.pos += 1 self.gotonext() adlist = '' while self.pos < len(self.field): if expectroute: self.getdomain() expectroute = False elif self.field[self.pos] == '>': self.pos += 1 break elif self.field[self.pos] == '@': self.pos += 1 expectroute = True elif self.field[self.pos] == ':': self.pos += 1 else: adlist = self.getaddrspec() self.pos += 1 break self.gotonext() return adlist def getaddrspec(self): """Parse an RFC 2822 addr-spec.""" aslist = [] self.gotonext() while self.pos < len(self.field): if self.field[self.pos] == '.': aslist.append('.') self.pos += 1 elif self.field[self.pos] == '"': aslist.append('"%s"' % quote(self.getquote())) elif self.field[self.pos] in self.atomends: break else: aslist.append(self.getatom()) self.gotonext() if self.pos >= len(self.field) or self.field[self.pos] != '@': return EMPTYSTRING.join(aslist) aslist.append('@') self.pos += 1 self.gotonext() domain = self.getdomain() if not domain: # Invalid domain, return an empty address instead of returning a # local part to denote failed parsing. return EMPTYSTRING return EMPTYSTRING.join(aslist) + domain def getdomain(self): """Get the complete domain name from an address.""" sdlist = [] while self.pos < len(self.field): if self.field[self.pos] in self.LWS: self.pos += 1 elif self.field[self.pos] == '(': self.commentlist.append(self.getcomment()) elif self.field[self.pos] == '[': sdlist.append(self.getdomainliteral()) elif self.field[self.pos] == '.': self.pos += 1 sdlist.append('.') elif self.field[self.pos] == '@': # bpo-34155: Don't parse domains with two `@` like # `a@malicious.org@important.com`. return EMPTYSTRING elif self.field[self.pos] in self.atomends: break else: sdlist.append(self.getatom()) return EMPTYSTRING.join(sdlist) def getdelimited(self, beginchar, endchars, allowcomments=True): """Parse a header fragment delimited by special characters. `beginchar' is the start character for the fragment. If self is not looking at an instance of `beginchar' then getdelimited returns the empty string. `endchars' is a sequence of allowable end-delimiting characters. Parsing stops when one of these is encountered. If `allowcomments' is non-zero, embedded RFC 2822 comments are allowed within the parsed fragment. """ if self.field[self.pos] != beginchar: return '' slist = [''] quote = False self.pos += 1 while self.pos < len(self.field): if quote: slist.append(self.field[self.pos]) quote = False elif self.field[self.pos] in endchars: self.pos += 1 break elif allowcomments and self.field[self.pos] == '(': slist.append(self.getcomment()) continue # have already advanced pos from getcomment elif self.field[self.pos] == '\\': quote = True else: slist.append(self.field[self.pos]) self.pos += 1 return EMPTYSTRING.join(slist) def getquote(self): """Get a quote-delimited fragment from self's field.""" return self.getdelimited('"', '"\r', False) def getcomment(self): """Get a parenthesis-delimited fragment from self's field.""" return self.getdelimited('(', ')\r', True) def getdomainliteral(self): """Parse an RFC 2822 domain-literal.""" return '[%s]' % self.getdelimited('[', ']\r', False) def getatom(self, atomends=None): """Parse an RFC 2822 atom. Optional atomends specifies a different set of end token delimiters (the default is to use self.atomends). This is used e.g. in getphraselist() since phrase endings must not include the `.' (which is legal in phrases).""" atomlist = [''] if atomends is None: atomends = self.atomends while self.pos < len(self.field): if self.field[self.pos] in atomends: break else: atomlist.append(self.field[self.pos]) self.pos += 1 return EMPTYSTRING.join(atomlist) def getphraselist(self): """Parse a sequence of RFC 2822 phrases. A phrase is a sequence of words, which are in turn either RFC 2822 atoms or quoted-strings. Phrases are canonicalized by squeezing all runs of continuous whitespace into one space. """ plist = [] while self.pos < len(self.field): if self.field[self.pos] in self.FWS: self.pos += 1 elif self.field[self.pos] == '"': plist.append(self.getquote()) elif self.field[self.pos] == '(': self.commentlist.append(self.getcomment()) elif self.field[self.pos] in self.phraseends: break else: plist.append(self.getatom(self.phraseends)) return plist class AddressList(AddrlistClass): """An AddressList encapsulates a list of parsed RFC 2822 addresses.""" def __init__(self, field): AddrlistClass.__init__(self, field) if field: self.addresslist = self.getaddrlist() else: self.addresslist = [] def __len__(self): return len(self.addresslist) def __add__(self, other): # Set union newaddr = AddressList(None) newaddr.addresslist = self.addresslist[:] for x in other.addresslist: if not x in self.addresslist: newaddr.addresslist.append(x) return newaddr def __iadd__(self, other): # Set union, in-place for x in other.addresslist: if not x in self.addresslist: self.addresslist.append(x) return self def __sub__(self, other): # Set difference newaddr = AddressList(None) for x in self.addresslist: if not x in other.addresslist: newaddr.addresslist.append(x) return newaddr def __isub__(self, other): # Set difference, in-place for x in other.addresslist: if x in self.addresslist: self.addresslist.remove(x) return self def __getitem__(self, index): # Make indexing, slices, and 'in' work return self.addresslist[index] _encoded_words.py 0000644 00000020514 15204103444 0010073 0 ustar 00 """ Routines for manipulating RFC2047 encoded words. This is currently a package-private API, but will be considered for promotion to a public API if there is demand. """ # An ecoded word looks like this: # # =?charset[*lang]?cte?encoded_string?= # # for more information about charset see the charset module. Here it is one # of the preferred MIME charset names (hopefully; you never know when parsing). # cte (Content Transfer Encoding) is either 'q' or 'b' (ignoring case). In # theory other letters could be used for other encodings, but in practice this # (almost?) never happens. There could be a public API for adding entries # to the CTE tables, but YAGNI for now. 'q' is Quoted Printable, 'b' is # Base64. The meaning of encoded_string should be obvious. 'lang' is optional # as indicated by the brackets (they are not part of the syntax) but is almost # never encountered in practice. # # The general interface for a CTE decoder is that it takes the encoded_string # as its argument, and returns a tuple (cte_decoded_string, defects). The # cte_decoded_string is the original binary that was encoded using the # specified cte. 'defects' is a list of MessageDefect instances indicating any # problems encountered during conversion. 'charset' and 'lang' are the # corresponding strings extracted from the EW, case preserved. # # The general interface for a CTE encoder is that it takes a binary sequence # as input and returns the cte_encoded_string, which is an ascii-only string. # # Each decoder must also supply a length function that takes the binary # sequence as its argument and returns the length of the resulting encoded # string. # # The main API functions for the module are decode, which calls the decoder # referenced by the cte specifier, and encode, which adds the appropriate # RFC 2047 "chrome" to the encoded string, and can optionally automatically # select the shortest possible encoding. See their docstrings below for # details. import re import base64 import binascii import functools from string import ascii_letters, digits from email import errors __all__ = ['decode_q', 'encode_q', 'decode_b', 'encode_b', 'len_q', 'len_b', 'decode', 'encode', ] # # Quoted Printable # # regex based decoder. _q_byte_subber = functools.partial(re.compile(br'=([a-fA-F0-9]{2})').sub, lambda m: bytes.fromhex(m.group(1).decode())) def decode_q(encoded): encoded = encoded.replace(b'_', b' ') return _q_byte_subber(encoded), [] # dict mapping bytes to their encoded form class _QByteMap(dict): safe = b'-!*+/' + ascii_letters.encode('ascii') + digits.encode('ascii') def __missing__(self, key): if key in self.safe: self[key] = chr(key) else: self[key] = "={:02X}".format(key) return self[key] _q_byte_map = _QByteMap() # In headers spaces are mapped to '_'. _q_byte_map[ord(' ')] = '_' def encode_q(bstring): return ''.join(_q_byte_map[x] for x in bstring) def len_q(bstring): return sum(len(_q_byte_map[x]) for x in bstring) # # Base64 # def decode_b(encoded): # First try encoding with validate=True, fixing the padding if needed. # This will succeed only if encoded includes no invalid characters. pad_err = len(encoded) % 4 missing_padding = b'==='[:4-pad_err] if pad_err else b'' try: return ( base64.b64decode(encoded + missing_padding, validate=True), [errors.InvalidBase64PaddingDefect()] if pad_err else [], ) except binascii.Error: # Since we had correct padding, this is likely an invalid char error. # # The non-alphabet characters are ignored as far as padding # goes, but we don't know how many there are. So try without adding # padding to see if it works. try: return ( base64.b64decode(encoded, validate=False), [errors.InvalidBase64CharactersDefect()], ) except binascii.Error: # Add as much padding as could possibly be necessary (extra padding # is ignored). try: return ( base64.b64decode(encoded + b'==', validate=False), [errors.InvalidBase64CharactersDefect(), errors.InvalidBase64PaddingDefect()], ) except binascii.Error: # This only happens when the encoded string's length is 1 more # than a multiple of 4, which is invalid. # # bpo-27397: Just return the encoded string since there's no # way to decode. return encoded, [errors.InvalidBase64LengthDefect()] def encode_b(bstring): return base64.b64encode(bstring).decode('ascii') def len_b(bstring): groups_of_3, leftover = divmod(len(bstring), 3) # 4 bytes out for each 3 bytes (or nonzero fraction thereof) in. return groups_of_3 * 4 + (4 if leftover else 0) _cte_decoders = { 'q': decode_q, 'b': decode_b, } def decode(ew): """Decode encoded word and return (string, charset, lang, defects) tuple. An RFC 2047/2243 encoded word has the form: =?charset*lang?cte?encoded_string?= where '*lang' may be omitted but the other parts may not be. This function expects exactly such a string (that is, it does not check the syntax and may raise errors if the string is not well formed), and returns the encoded_string decoded first from its Content Transfer Encoding and then from the resulting bytes into unicode using the specified charset. If the cte-decoded string does not successfully decode using the specified character set, a defect is added to the defects list and the unknown octets are replaced by the unicode 'unknown' character \\uFDFF. The specified charset and language are returned. The default for language, which is rarely if ever encountered, is the empty string. """ _, charset, cte, cte_string, _ = ew.split('?') charset, _, lang = charset.partition('*') cte = cte.lower() # Recover the original bytes and do CTE decoding. bstring = cte_string.encode('ascii', 'surrogateescape') bstring, defects = _cte_decoders[cte](bstring) # Turn the CTE decoded bytes into unicode. try: string = bstring.decode(charset) except UnicodeError: defects.append(errors.UndecodableBytesDefect("Encoded word " "contains bytes not decodable using {} charset".format(charset))) string = bstring.decode(charset, 'surrogateescape') except LookupError: string = bstring.decode('ascii', 'surrogateescape') if charset.lower() != 'unknown-8bit': defects.append(errors.CharsetError("Unknown charset {} " "in encoded word; decoded as unknown bytes".format(charset))) return string, charset, lang, defects _cte_encoders = { 'q': encode_q, 'b': encode_b, } _cte_encode_length = { 'q': len_q, 'b': len_b, } def encode(string, charset='utf-8', encoding=None, lang=''): """Encode string using the CTE encoding that produces the shorter result. Produces an RFC 2047/2243 encoded word of the form: =?charset*lang?cte?encoded_string?= where '*lang' is omitted unless the 'lang' parameter is given a value. Optional argument charset (defaults to utf-8) specifies the charset to use to encode the string to binary before CTE encoding it. Optional argument 'encoding' is the cte specifier for the encoding that should be used ('q' or 'b'); if it is None (the default) the encoding which produces the shortest encoded sequence is used, except that 'q' is preferred if it is up to five characters longer. Optional argument 'lang' (default '') gives the RFC 2243 language string to specify in the encoded word. """ if charset == 'unknown-8bit': bstring = string.encode('ascii', 'surrogateescape') else: bstring = string.encode(charset) if encoding is None: qlen = _cte_encode_length['q'](bstring) blen = _cte_encode_length['b'](bstring) # Bias toward q. 5 is arbitrary. encoding = 'q' if qlen - blen < 5 else 'b' encoded = _cte_encoders[encoding](bstring) if lang: lang = '*' + lang return "=?{}{}?{}?{}?=".format(charset, lang, encoding, encoded) architecture.rst 0000644 00000022531 15204103444 0007760 0 ustar 00 :mod:`email` Package Architecture ================================= Overview -------- The email package consists of three major components: Model An object structure that represents an email message, and provides an API for creating, querying, and modifying a message. Parser Takes a sequence of characters or bytes and produces a model of the email message represented by those characters or bytes. Generator Takes a model and turns it into a sequence of characters or bytes. The sequence can either be intended for human consumption (a printable unicode string) or bytes suitable for transmission over the wire. In the latter case all data is properly encoded using the content transfer encodings specified by the relevant RFCs. Conceptually the package is organized around the model. The model provides both "external" APIs intended for use by application programs using the library, and "internal" APIs intended for use by the Parser and Generator components. This division is intentionally a bit fuzzy; the API described by this documentation is all a public, stable API. This allows for an application with special needs to implement its own parser and/or generator. In addition to the three major functional components, there is a third key component to the architecture: Policy An object that specifies various behavioral settings and carries implementations of various behavior-controlling methods. The Policy framework provides a simple and convenient way to control the behavior of the library, making it possible for the library to be used in a very flexible fashion while leveraging the common code required to parse, represent, and generate message-like objects. For example, in addition to the default :rfc:`5322` email message policy, we also have a policy that manages HTTP headers in a fashion compliant with :rfc:`2616`. Individual policy controls, such as the maximum line length produced by the generator, can also be controlled individually to meet specialized application requirements. The Model --------- The message model is implemented by the :class:`~email.message.Message` class. The model divides a message into the two fundamental parts discussed by the RFC: the header section and the body. The `Message` object acts as a pseudo-dictionary of named headers. Its dictionary interface provides convenient access to individual headers by name. However, all headers are kept internally in an ordered list, so that the information about the order of the headers in the original message is preserved. The `Message` object also has a `payload` that holds the body. A `payload` can be one of two things: data, or a list of `Message` objects. The latter is used to represent a multipart MIME message. Lists can be nested arbitrarily deeply in order to represent the message, with all terminal leaves having non-list data payloads. Message Lifecycle ----------------- The general lifecycle of a message is: Creation A `Message` object can be created by a Parser, or it can be instantiated as an empty message by an application. Manipulation The application may examine one or more headers, and/or the payload, and it may modify one or more headers and/or the payload. This may be done on the top level `Message` object, or on any sub-object. Finalization The Model is converted into a unicode or binary stream, or the model is discarded. Header Policy Control During Lifecycle -------------------------------------- One of the major controls exerted by the Policy is the management of headers during the `Message` lifecycle. Most applications don't need to be aware of this. A header enters the model in one of two ways: via a Parser, or by being set to a specific value by an application program after the Model already exists. Similarly, a header exits the model in one of two ways: by being serialized by a Generator, or by being retrieved from a Model by an application program. The Policy object provides hooks for all four of these pathways. The model storage for headers is a list of (name, value) tuples. The Parser identifies headers during parsing, and passes them to the :meth:`~email.policy.Policy.header_source_parse` method of the Policy. The result of that method is the (name, value) tuple to be stored in the model. When an application program supplies a header value (for example, through the `Message` object `__setitem__` interface), the name and the value are passed to the :meth:`~email.policy.Policy.header_store_parse` method of the Policy, which returns the (name, value) tuple to be stored in the model. When an application program retrieves a header (through any of the dict or list interfaces of `Message`), the name and value are passed to the :meth:`~email.policy.Policy.header_fetch_parse` method of the Policy to obtain the value returned to the application. When a Generator requests a header during serialization, the name and value are passed to the :meth:`~email.policy.Policy.fold` method of the Policy, which returns a string containing line breaks in the appropriate places. The :meth:`~email.policy.Policy.cte_type` Policy control determines whether or not Content Transfer Encoding is performed on the data in the header. There is also a :meth:`~email.policy.Policy.binary_fold` method for use by generators that produce binary output, which returns the folded header as binary data, possibly folded at different places than the corresponding string would be. Handling Binary Data -------------------- In an ideal world all message data would conform to the RFCs, meaning that the parser could decode the message into the idealized unicode message that the sender originally wrote. In the real world, the email package must also be able to deal with badly formatted messages, including messages containing non-ASCII characters that either have no indicated character set or are not valid characters in the indicated character set. Since email messages are *primarily* text data, and operations on message data are primarily text operations (except for binary payloads of course), the model stores all text data as unicode strings. Un-decodable binary inside text data is handled by using the `surrogateescape` error handler of the ASCII codec. As with the binary filenames the error handler was introduced to handle, this allows the email package to "carry" the binary data received during parsing along until the output stage, at which time it is regenerated in its original form. This carried binary data is almost entirely an implementation detail. The one place where it is visible in the API is in the "internal" API. A Parser must do the `surrogateescape` encoding of binary input data, and pass that data to the appropriate Policy method. The "internal" interface used by the Generator to access header values preserves the `surrogateescaped` bytes. All other interfaces convert the binary data either back into bytes or into a safe form (losing information in some cases). Backward Compatibility ---------------------- The :class:`~email.policy.Policy.Compat32` Policy provides backward compatibility with version 5.1 of the email package. It does this via the following implementation of the four+1 Policy methods described above: header_source_parse Splits the first line on the colon to obtain the name, discards any spaces after the colon, and joins the remainder of the line with all of the remaining lines, preserving the linesep characters to obtain the value. Trailing carriage return and/or linefeed characters are stripped from the resulting value string. header_store_parse Returns the name and value exactly as received from the application. header_fetch_parse If the value contains any `surrogateescaped` binary data, return the value as a :class:`~email.header.Header` object, using the character set `unknown-8bit`. Otherwise just returns the value. fold Uses :class:`~email.header.Header`'s folding to fold headers in the same way the email5.1 generator did. binary_fold Same as fold, but encodes to 'ascii'. New Algorithm ------------- header_source_parse Same as legacy behavior. header_store_parse Same as legacy behavior. header_fetch_parse If the value is already a header object, returns it. Otherwise, parses the value using the new parser, and returns the resulting object as the value. `surrogateescaped` bytes get turned into unicode unknown character code points. fold Uses the new header folding algorithm, respecting the policy settings. surrogateescaped bytes are encoded using the ``unknown-8bit`` charset for ``cte_type=7bit`` or ``8bit``. Returns a string. At some point there will also be a ``cte_type=unicode``, and for that policy fold will serialize the idealized unicode message with RFC-like folding, converting any surrogateescaped bytes into the unicode unknown character glyph. binary_fold Uses the new header folding algorithm, respecting the policy settings. surrogateescaped bytes are encoded using the `unknown-8bit` charset for ``cte_type=7bit``, and get turned back into bytes for ``cte_type=8bit``. Returns bytes. At some point there will also be a ``cte_type=unicode``, and for that policy binary_fold will serialize the message according to :rfc:``5335``. __pycache__/utils.cpython-38.opt-2.pyc 0000644 00000014114 15204103444 0013502 0 ustar 00 U e5d�4 � @ sf d ddddddddd d d d d dgZ ddlZddlZddlZddlZddlZddlZddlZddl m Z ddl m Z ddl m Z ddl mZmZmZ ddlmZ dZdZdZdZdZe�d�Ze�d�Zd d � Zd d � Z d6d!d�Z d"d� Z d#d$� Z d7d&d�Z d8d'd�Z!d9d(d�Z"d)d � Z#d*d � Z$d+d� Z%d,d� Z&d:d-d�Z'e�d.ej(�Z)d/d� Z*d;d2d �Z+d<d4d5�Z,dS )=�collapse_rfc2231_value� decode_params�decode_rfc2231�encode_rfc2231� formataddr� formatdate�format_datetime� getaddresses� make_msgid� mktime_tz� parseaddr� parsedate� parsedate_tz�parsedate_to_datetime�unquote� N)�quote)� AddressList)r )r r � _parsedate_tz)�Charsetz, � z �'z[][\\()<>@,:;".]z[\\"]c C s* z| � � W dS tk r$ Y dS X d S )NFT)�encode�UnicodeEncodeError)�s� r �#/usr/lib64/python3.8/email/utils.py�_has_surrogates3 s r c C s | � dd�}|�dd�S )N�utf-8�surrogateescape�replace)r �decode)�stringZoriginal_bytesr r r � _sanitize@ s r" r c C s� | \}}|� d� |r�z|� d� W n< tk r` t|t�rFt|�}|�|�}d||f Y S X d}t�|�rtd}t� d|�}d||||f S |S )N�asciiz%s <%s>r �"z\\\g<0>z %s%s%s <%s>) r r � isinstance�strr Z header_encode� specialsre�search� escapesre�sub)Zpair�charset�nameZaddressZ encoded_nameZquotesr r r r L s c C s t �| �}t|�}|jS )N)� COMMASPACE�join� _AddressList� addresslist)Z fieldvalues�all�ar r r r n s c C sf ddddddddg| d | d d d d dddddddddg | d d | d | d | d | d |f S ) Nz"%s, %02d %s %04d %02d:%02d:%02d %sZMonZTueZWedZThuZFriZSatZSun� � ZJanZFebZMarZAprZMayZJunZJulZAugZSepZOctZNovZDec� r � � � r )� timetuple�zoner r r �_format_timetuple_and_zoneu s& � � �r; Fc C sR | d krt � � } |s|r,tj�| tjj�}n tj�| �}|rH|�� }d}t||�S )NF)�time�datetimeZ fromtimestamp�timezone�utcZutcfromtimestamp� astimezoner )�timeval� localtime�usegmt�dtr r r r ~ s c C sV | � � }|r2| jd ks$| jtjjkr,td��d}n| jd krBd}n | �d�}t||�S )Nz%usegmt option requires a UTC datetimeZGMTz-0000z%z)r9 �tzinfor= r> r? � ValueError�strftimer; )rD rC �nowr: r r r r � s c C s^ t t�� d �}t�� }t�d�}| d kr0d} nd| } |d krHt�� }d|||| |f }|S )N�d �@ r �.z<%d.%d.%d%s@%s>)�intr< �os�getpid�randomZ getrandbits�socketZgetfqdn)ZidstringZdomainrA �pidZrandintZmsgidr r r r � s c C sN t | ��^ }}|d kr(tj|d d� � S tj|d d� dt�tj|d��i�S )Nr3 rE ��seconds)r r= r> � timedelta)�dataZdtuple�tzr r r r � s �c C s t | �j}|sdS |d S )N)r r r )r/ r0 )ZaddrZaddrsr r r r � s c C s` t | �dkr\| �d�r<| �d�r<| dd� �dd��dd�S | �d�r\| �d�r\| dd� S | S ) Nr5 r$ ���z\\�\z\"�<�>)�len� startswith�endswithr )r& r r r r � s c C s& | � td�}t|�dkr"d d | fS |S )Nr4 )�split�TICKr[ )r �partsr r r r � s c C sD t jj| d|pdd�} |d kr*|d kr*| S |d kr6d}d||| f S )Nr r# )Zsafe�encodingz%s'%s'%s)�urllib�parser )r r+ �languager r r r � s z&^(?P<name>\w+)\*((?P<num>[0-9]+)\*?)?$c C sl | d d � } g }i }| � d�\}}|�||f� | r�| � d�\}}|�d�rRd}nd}t|�}t�|�}|r�|�dd�\}}|d k r�t|�}|�|g ��|||f� q0|�|dt |� f� q0|�rh|� � D ]�\}}g }d} |� � |D ].\}} }|�r t j j| dd �} d} |�| � q�t t�|��}| �rTt|�\} } }|�|| | d| ff� q�|�|d| f� q�|S ) Nr �*TFr, �numz"%s"zlatin-1)ra )�pop�appendr] r �rfc2231_continuation�match�grouprL � setdefaultr �items�sortrb rc � EMPTYSTRINGr. r ) ZparamsZ new_paramsZrfc2231_paramsr, �valueZencodedZmorf Z continuationsZextendedr r+ rd r r r r sD r �us-asciic C sn t | t�rt| �dkr t| �S | \}}}|d kr4|}t|d�}zt|||�W S tk rh t|� Y S X d S )Nr6 zraw-unicode-escape)r% �tupler[ r �bytesr& � LookupError)rp �errorsZfallback_charsetr+ rd �textZrawbytesr r r r 9 s rW c C s | d kr t j �t jj��� S | jd k r.| �� S | �� d d� |f }t�|�}t� |�}z t j |j d�}t �||j �}W n� t k r� | t j t�|�d d� � }tjo�|jdk}|r�tjntj }|t j |d�kr�t �|tj| �}n t �|�}Y nX | j|d�S )NrW rR r3 r )rE )r= rH r> r? r@ rE r9 r< �mktimerB rT � tm_gmtoff�tm_zone�AttributeError�gmtime�daylight�tm_isdst�altzone�tznamer ) rD ZisdstZtmrS ZlocaltmZdeltarV ZdstZgmtoffr r r rB S s$ rB )r )NFF)F)NN)NN)r rq )NrW )-�__all__rM �rer< rO rP r= Z urllib.parserb Zemail._parseaddrr r r/ r r r r Z email.charsetr r- ro Z UEMPTYSTRINGZCRLFr_ �compiler' r) r r" r r r; r r r r r r r r �ASCIIri r r rB r r r r �<module> sn � " �8 � __pycache__/_encoded_words.cpython-38.opt-2.pyc 0000644 00000007332 15204103444 0015324 0 ustar 00 U e5dL! � @ s� d dl Z d dlZd dlZd dlZd dlmZmZ d dlmZ dddddd d d gZ e� e � d �j d d� �Z dd� ZG dd� de�Ze� Zdeed�< dd� Zdd� Zdd� Zdd� Zdd � Zeed�Zdd � Zeed�Zeed�Zd d d �Z dS ) � N)� ascii_letters�digits)�errors�decode_q�encode_q�decode_b�encode_b�len_q�len_b�decode�encodes =([a-fA-F0-9]{2})c C s t �| �d��� �S )N� )�bytes�fromhex�groupr )�m� r �,/usr/lib64/python3.8/email/_encoded_words.py�<lambda>A � r c C s | � dd�} t| �g fS )N� _� )�replace�_q_byte_subber)�encodedr r r r C s c @ s, e Zd Zde�d� e�d� Zdd� ZdS )� _QByteMaps -!*+/�asciic C s. || j krt|�| |< nd�|�| |< | | S )Nz={:02X})�safe�chr�format)�self�keyr r r � __missing__M s z_QByteMap.__missing__N)�__name__� __module__� __qualname__r r r r r" r r r r r I s r �_� c C s d� dd� | D ��S )N� c s s | ]}t | V qd S �N)� _q_byte_map��.0�xr r r � <genexpr>Z s zencode_q.<locals>.<genexpr>)�join��bstringr r r r Y s c C s t dd� | D ��S )Nc s s | ]}t t| �V qd S r) )�lenr* r+ r r r r. ] s zlen_q.<locals>.<genexpr>)�sumr0 r r r r \ s c C s� t | �d }|r dd d| � nd}z&tj| | dd�|rDt�� gng fW S tjk � r� z tj| dd�t�� gfW Y S tjk r� z,tj| d dd�t�� t�� gfW Y Y S tjk r� | t�� gf Y Y Y S X Y nX Y nX d S )N� s ===r T)ZvalidateFs ==) r2 �base64Z b64decoder ZInvalidBase64PaddingDefect�binascii�ErrorZ InvalidBase64CharactersDefectZInvalidBase64LengthDefect)r Zpad_errZmissing_paddingr r r r d s( � � ��c C s t �| ��d�S )Nr )r5 Z b64encoder r0 r r r r � s c C s& t t| �d�\}}|d |r dnd S )N� r4 r )�divmodr2 )r1 Z groups_of_3Zleftoverr r r r � s )�q�bc C s� | � d�\}}}}}|�d�\}}}|�� }|�dd�}t| |�\}}z|�|�}W nv tk r� |�t� d� |��� |�|d�}Y nB t k r� |�dd�}|�� dkr�|�t� d� |��� Y nX ||||fS )N�?�*r �surrogateescapez:Encoded word contains bytes not decodable using {} charset� unknown-8bitz<Unknown charset {} in encoded word; decoded as unknown bytes) �split� partition�lowerr � _cte_decodersr � UnicodeError�appendr ZUndecodableBytesDefectr � LookupErrorZ CharsetError) Zewr& �charsetZcteZ cte_string�langr1 Zdefects�stringr r r r � s& � ��utf-8r( c C s| |dkr| � dd�}n | � |�}|d krTtd |�}td |�}|| dk rPdnd}t| |�}|rld| }d�||||�S ) Nr? r r> r: r; � r= z=?{}{}?{}?{}?=)r �_cte_encode_length� _cte_encodersr )rI rG �encodingrH r1 ZqlenZblenr r r r r � s )rJ Nr( ) �rer5 r6 � functoolsrI r r Zemailr �__all__�partial�compile�subr r �dictr r* �ordr r r r r rC r rM rL r r r r r �<module>* sJ �� &�+�� __pycache__/base64mime.cpython-38.opt-2.pyc 0000644 00000002664 15204103444 0014305 0 ustar 00 U e5d� � @ sp d dddddgZ ddlmZ ddlmZmZ d Zd Zd Zd Z d d� Z ddd�Z defdd�Z dd� Z e Ze ZdS )� body_decode� body_encode�decode� decodestring� header_encode� header_length� )� b64encode)� b2a_base64� a2b_base64z � � � c C s* t t| �d�\}}|d }|r&|d7 }|S )N� � )�divmod�len)� bytearrayZ groups_of_3Zleftover�n� r �(/usr/lib64/python3.8/email/base64mime.pyr 2 s � iso-8859-1c C s6 | sdS t | t�r | �|�} t| ��d�}d||f S )Nr �asciiz =?%s?b?%s?=)� isinstance�str�encoder r )Z header_bytes�charsetZencodedr r r r = s �L c C s~ | s| S g }|d d }t dt| �|�D ]J}t| ||| � ��d�}|�t�rh|tkrh|d d� | }|�|� q(t�|�S )Nr r r r ���) �ranger r r �endswith�NL�append� EMPTYSTRING�join)�sZ maxlinelenZeolZencvecZ max_unencoded�i�encr r r r L s c C s. | s t � S t| t�r"t| �d��S t| �S d S )Nzraw-unicode-escape)�bytesr r r r )�stringr r r r f s N)r )�__all__�base64r Zbinasciir r ZCRLFr r" ZMISC_LENr r r r r r r r r r �<module> s$ � __pycache__/_header_value_parser.cpython-38.opt-1.pyc 0000644 00000234017 15204103444 0016506 0 ustar 00 U e5dϡ � @ s� d Z ddlZddlZddlZddlmZ ddlmZ ddlm Z ddlm Z ddlm Z e d�Zee d �B Ze d �ZeeB Zee d � Zee d � Zee d �B e d � ZeeB Zee d�B ZeeB Zee d� Zdd� Ze�dejej B �Z G dd� de �Z G dd� de �Z G dd� de �Z!G dd� de �Z"G dd � d e �Z#G d d � d e �Z$G d d � d e �Z%G d!d"� d"e �Z&G d#d$� d$e �Z'G d%d&� d&e �Z(G d'd(� d(e(�Z)G d)d*� d*e �Z*G d+d,� d,e �Z+G d-d.� d.e �Z,G d/d0� d0e �Z-G d1d2� d2e �Z.G d3d4� d4e �Z/G d5d6� d6e �Z0G d7d8� d8e �Z1G d9d:� d:e �Z2G d;d<� d<e �Z3G d=d>� d>e �Z4G d?d@� d@e �Z5G dAdB� dBe �Z6G dCdD� dDe �Z7G dEdF� dFe �Z8G dGdH� dHe �Z9G dIdJ� dJe �Z:G dKdL� dLe"�Z;G dMdN� dNe �Z<G dOdP� dPe �Z=G dQdR� dRe �Z>G dSdT� dTe �Z?G dUdV� dVe?�Z@G dWdX� dXe �ZAG dYdZ� dZe �ZBG d[d\� d\e �ZCG d]d^� d^e �ZDG d_d`� d`e �ZEG dadb� dbeE�ZFG dcdd� ddeE�ZGG dedf� dfe �ZHG dgdh� dhe �ZIG didj� dje �ZJG dkdl� dleJ�ZKG dmdn� dneK�ZLG dodp� dpe �ZMG dqdr� dreN�ZOG dsdt� dteO�ZPG dudv� dveO�ZQG dwdx� dxeP�ZRG dydz� dze jS�ZTeQd d{�ZUeQd|d}�ZVeQd~d�ZWe�d��Xd��Ye���jZZ[e�d��Xe�\d��Ye����j]Z^e�d��j_Z`e�d��Xe�\d��Ye����j]Zae�d��Xe�\d��Ye����j]Zbe�d��Xe�\d��Ye����j]Zcd�d�� Zdd�d�� Zed�d�� Zfd�d�� Zgd�d�� Zhd�d�� Zid�d�� Zjd�d�� Zkd�d�� Zld�d�� Zmd�d�� Znd�d�� Zod�d�� Zpd�d�� Zqd�d�� Zrd�d�� Zsd�d�� Ztd�d�� Zud�d�� Zvd�d�� Zwd�d�� Zxd�d�� Zyd�d�� Zzd�d�� Z{d�d�� Z|d�d�� Z}d�d�� Z~d�d�� Zd�d�� Z�d�d�� Z�d�d�� Z�d�dÄ Z�d�dń Z�d�dDŽ Z�d�dɄ Z�d�d˄ Z�d�d̈́ Z�d�dτ Z�d�dф Z�d�dӄ Z�d�dՄ Z�d�dׄ Z�d�dل Z�d�dۄ Z�d�d݄ Z�d�d߄ Z�d�d� Z�d�d� Z�d�d� Z�d�d� Z�d�d� Z�d�d� Z�d�d� Z�d�d� Z�d�d� Z�d�d� Z�d�d�� Z�d�d�� Z�dS )�al Header value parser implementing various email-related RFC parsing rules. The parsing methods defined in this module implement various email related parsing rules. Principal among them is RFC 5322, which is the followon to RFC 2822 and primarily a clarification of the former. It also implements RFC 2047 encoded word decoding. RFC 5322 goes to considerable trouble to maintain backward compatibility with RFC 822 in the parse phase, while cleaning up the structure on the generation phase. This parser supports correct RFC 5322 generation by tagging white space as folding white space only when folding is allowed in the non-obsolete rule sets. Actually, the parser is even more generous when accepting input than RFC 5322 mandates, following the spirit of Postel's Law, which RFC 5322 encourages. Where possible deviations from the standard are annotated on the 'defects' attribute of tokens that deviate. The general structure of the parser follows RFC 5322, and uses its terminology where there is a direct correspondence. Where the implementation requires a somewhat different structure than that used by the formal grammar, new terms that mimic the closest existing terms are used. Thus, it really helps to have a copy of RFC 5322 handy when studying this code. Input to the parser is a string that has already been unfolded according to RFC 5322 rules. According to the RFC this unfolding is the very first step, and this parser leaves the unfolding step to a higher level message parser, which will have already detected the line breaks that need unfolding while determining the beginning and end of each header. The output of the parser is a TokenList object, which is a list subclass. A TokenList is a recursive data structure. The terminal nodes of the structure are Terminal objects, which are subclasses of str. These do not correspond directly to terminal objects in the formal grammar, but are instead more practical higher level combinations of true terminals. All TokenList and Terminal objects have a 'value' attribute, which produces the semantically meaningful value of that part of the parse subtree. The value of all whitespace tokens (no matter how many sub-tokens they may contain) is a single space, as per the RFC rules. This includes 'CFWS', which is herein included in the general class of whitespace tokens. There is one exception to the rule that whitespace tokens are collapsed into single spaces in values: in the value of a 'bare-quoted-string' (a quoted-string with no leading or trailing whitespace), any whitespace that appeared between the quotation marks is preserved in the returned value. Note that in all Terminal strings quoted pairs are turned into their unquoted values. All TokenList and Terminal objects also have a string value, which attempts to be a "canonical" representation of the RFC-compliant form of the substring that produced the parsed subtree, including minimal use of quoted pair quoting. Whitespace runs are not collapsed. Comment tokens also have a 'content' attribute providing the string found between the parens (including any nested comments) with whitespace preserved. All TokenList and Terminal objects have a 'defects' attribute which is a possibly empty list all of the defects found while creating the token. Defects may appear on any token in the tree, and a composite list of all defects in the subtree is available through the 'all_defects' attribute of any node. (For Terminal notes x.defects == x.all_defects.) Each object in a parse tree is called a 'token', and each has a 'token_type' attribute that gives the name from the RFC 5322 grammar that it represents. Not all RFC 5322 nodes are produced, and there is one non-RFC 5322 node that may be produced: 'ptext'. A 'ptext' is a string of printable ascii characters. It is returned in place of lists of (ctext/quoted-pair) and (qtext/quoted-pair). XXX: provide complete list of token types. � N)� hexdigits)� itemgetter)�_encoded_words)�errors)�utilsz �(z ()<>@,:;.\"[]�.z."(z/?=z*'%�%c C s dt | ��dd��dd� d S )N�"�\�\\z\")�str�replace��value� r �2/usr/lib64/python3.8/email/_header_value_parser.py� quote_string` s r z� =\? # literal =? [^?]* # charset \? # literal ? [qQbB] # literal 'q' or 'b', case insensitive \? # literal ? .*? # encoded word \?= # literal ?= c s� e Zd ZdZdZdZ� fdd�Zdd� Z� fdd�Ze d d � �Z e d d � �Z d d� Z e dd� �Z e dd� �Zdd� Zd dd�Zd dd�Zd dd�Z� ZS ) � TokenListNTc s t � j||� g | _d S �N)�super�__init__�defects)�self�args�kw�� __class__r r r y s zTokenList.__init__c C s d� dd� | D ��S )N� c s s | ]}t |�V qd S r �r ��.0�xr r r � <genexpr>~ s z$TokenList.__str__.<locals>.<genexpr>��join�r r r r �__str__} s zTokenList.__str__c s d� | jjt� �� �S �Nz{}({})��formatr �__name__r �__repr__r& r r r r, � s �zTokenList.__repr__c C s d� dd� | D ��S )Nr c s s | ]}|j r|j V qd S r r r r r r r# � s z"TokenList.value.<locals>.<genexpr>r$ r& r r r r � s zTokenList.valuec C s t dd� | D �| j�S )Nc s s | ] }|j V qd S r )� all_defectsr r r r r# � s z(TokenList.all_defects.<locals>.<genexpr>)�sumr r& r r r r- � s zTokenList.all_defectsc C s | d � � S �Nr )�startswith_fwsr& r r r r0 � s zTokenList.startswith_fwsc C s t dd� | D ��S )zATrue if all top level tokens of this part may be RFC2047 encoded.c s s | ] }|j V qd S r )� as_ew_allowed)r! �partr r r r# � s z*TokenList.as_ew_allowed.<locals>.<genexpr>)�allr& r r r r1 � s zTokenList.as_ew_allowedc C s g }| D ]}|� |j� q|S r )�extend�comments)r r5 �tokenr r r r5 � s zTokenList.commentsc C s t | |d�S )N��policy)�_refold_parse_tree�r r8 r r r �fold� s zTokenList.foldr c C s t | j|d�� d S )N��indent)�print�ppstr�r r= r r r �pprint� s zTokenList.pprintc C s d� | j|d��S )N� r< )r% �_ppr@ r r r r? � s zTokenList.ppstrc c sz d� || jj| j�V | D ]4}t|d�s:|d� |� V q|�|d �E d H q| jrdd� | j�}nd}d� ||�V d S )Nz{}{}/{}(rC z* !! invalid element in token list: {!r}z z Defects: {}r z{}){})r* r r+ � token_type�hasattrrC r )r r= r6 Zextrar r r rC � s � � z TokenList._pp)r )r )r )r+ � __module__� __qualname__rD �syntactic_break�ew_combine_allowedr r' r, �propertyr r- r0 r1 r5 r; rA r? rC � __classcell__r r r r r s s& r c @ s$ e Zd Zedd� �Zedd� �ZdS )�WhiteSpaceTokenListc C s dS �N� r r& r r r r � s zWhiteSpaceTokenList.valuec C s dd� | D �S )Nc S s g | ]}|j d kr|j�qS )�comment)rD �contentr r r r � <listcomp>� s z0WhiteSpaceTokenList.comments.<locals>.<listcomp>r r& r r r r5 � s z WhiteSpaceTokenList.commentsN)r+ rF rG rJ r r5 r r r r rL � s rL c @ s e Zd ZdZdS )�UnstructuredTokenList� unstructuredN�r+ rF rG rD r r r r rR � s rR c @ s e Zd ZdZdS )�Phrase�phraseNrT r r r r rU � s rU c @ s e Zd ZdZdS )�WordZwordNrT r r r r rW � s rW c @ s e Zd ZdZdS )�CFWSList�cfwsNrT r r r r rX � s rX c @ s e Zd ZdZdS )�Atom�atomNrT r r r r rZ � s rZ c @ s e Zd ZdZdZdS )�Tokenr6 FN)r+ rF rG rD Z encode_as_ewr r r r r\ � s r\ c @ s e Zd ZdZdZdZdZdS )� EncodedWord� encoded-wordN)r+ rF rG rD �cte�charset�langr r r r r] � s r] c @ s4 e Zd ZdZedd� �Zedd� �Zedd� �ZdS ) � QuotedString� quoted-stringc C s" | D ]}|j dkr|j S qd S �N�bare-quoted-string�rD r �r r" r r r rP � s zQuotedString.contentc C s> g }| D ]*}|j dkr&|�t|�� q|�|j� qd�|�S )Nre r )rD �appendr r r% )r �resr" r r r � quoted_value� s zQuotedString.quoted_valuec C s" | D ]}|j dkr|j S qd S rd rf �r r6 r r r �stripped_value� s zQuotedString.stripped_valueN)r+ rF rG rD rJ rP rj rl r r r r rb � s rb c @ s$ e Zd ZdZdd� Zedd� �ZdS )�BareQuotedStringre c C s t d�dd� | D ���S )Nr c s s | ]}t |�V qd S r r r r r r r# s z+BareQuotedString.__str__.<locals>.<genexpr>)r r% r& r r r r' � s zBareQuotedString.__str__c C s d� dd� | D ��S )Nr c s s | ]}t |�V qd S r r r r r r r# s z)BareQuotedString.value.<locals>.<genexpr>r$ r& r r r r s zBareQuotedString.valueN)r+ rF rG rD r' rJ r r r r r rm � s rm c @ s8 e Zd ZdZdd� Zdd� Zedd� �Zedd � �Zd S ) �CommentrO c s( d� tdg� fdd�� D �dggg ��S )Nr r c s g | ]}� � |��qS r )�quoter r& r r rQ s z#Comment.__str__.<locals>.<listcomp>�))r% r. r& r r& r r' s ��zComment.__str__c C s2 |j dkrt|�S t|��dd��dd��dd�S )NrO r r r z\(rp z\))rD r r )r r r r r ro s � �z Comment.quotec C s d� dd� | D ��S )Nr c s s | ]}t |�V qd S r r r r r r r# s z"Comment.content.<locals>.<genexpr>r$ r& r r r rP s zComment.contentc C s | j gS r )rP r& r r r r5 s zComment.commentsN) r+ rF rG rD r' ro rJ rP r5 r r r r rn s rn c @ s4 e Zd ZdZedd� �Zedd� �Zedd� �ZdS ) � AddressListz address-listc C s dd� | D �S )Nc S s g | ]}|j d kr|�qS )�address�rD r r r r rQ ' s z)AddressList.addresses.<locals>.<listcomp>r r& r r r � addresses% s zAddressList.addressesc C s t dd� | D �g �S )Nc s s | ]}|j d kr|jV qdS �rr N�rD � mailboxesr r r r r# + s �z(AddressList.mailboxes.<locals>.<genexpr>�r. r& r r r rw ) s ��zAddressList.mailboxesc C s t dd� | D �g �S )Nc s s | ]}|j d kr|jV qdS ru �rD � all_mailboxesr r r r r# 0 s �z,AddressList.all_mailboxes.<locals>.<genexpr>rx r& r r r rz . s ��zAddressList.all_mailboxesN)r+ rF rG rD rJ rt rw rz r r r r rq ! s rq c @ s4 e Zd ZdZedd� �Zedd� �Zedd� �ZdS ) �Addressrr c C s | d j dkr| d jS d S )Nr �group�rD � display_namer& r r r r~ 8 s zAddress.display_namec C s4 | d j dkr| d gS | d j dkr*g S | d jS �Nr �mailbox�invalid-mailboxrv r& r r r rw = s zAddress.mailboxesc C s: | d j dkr| d gS | d j dkr0| d gS | d jS r ry r& r r r rz E s zAddress.all_mailboxesN)r+ rF rG rD rJ r~ rw rz r r r r r{ 4 s r{ c @ s( e Zd ZdZedd� �Zedd� �ZdS )� MailboxList� mailbox-listc C s dd� | D �S )Nc S s g | ]}|j d kr|�qS )r� rs r r r r rQ S s z)MailboxList.mailboxes.<locals>.<listcomp>r r& r r r rw Q s zMailboxList.mailboxesc C s dd� | D �S )Nc S s g | ]}|j d kr|�qS ))r� r� rs r r r r rQ W s �z-MailboxList.all_mailboxes.<locals>.<listcomp>r r& r r r rz U s zMailboxList.all_mailboxesN�r+ rF rG rD rJ rw rz r r r r r� M s r� c @ s( e Zd ZdZedd� �Zedd� �ZdS )� GroupList� group-listc C s | r| d j dkrg S | d jS �Nr r� rv r& r r r rw _ s zGroupList.mailboxesc C s | r| d j dkrg S | d jS r� ry r& r r r rz e s zGroupList.all_mailboxesNr� r r r r r� [ s r� c @ s4 e Zd ZdZedd� �Zedd� �Zedd� �ZdS ) �Groupr| c C s | d j dkrg S | d jS �N� r� rv r& r r r rw p s zGroup.mailboxesc C s | d j dkrg S | d jS r� ry r& r r r rz v s zGroup.all_mailboxesc C s | d j S r/ )r~ r& r r r r~ | s zGroup.display_nameN)r+ rF rG rD rJ rw rz r~ r r r r r� l s r� c @ sL e Zd ZdZedd� �Zedd� �Zedd� �Zedd � �Zed d � �Z d S ) �NameAddr� name-addrc C s t | �dkrd S | d jS �N� r )�lenr~ r& r r r r~ � s zNameAddr.display_namec C s | d j S �N����� local_partr& r r r r� � s zNameAddr.local_partc C s | d j S r� ��domainr& r r r r� � s zNameAddr.domainc C s | d j S r� )�router& r r r r� � s zNameAddr.routec C s | d j S r� �� addr_specr& r r r r� � s zNameAddr.addr_specN� r+ rF rG rD rJ r~ r� r� r� r� r r r r r� � s r� c @ s@ e Zd ZdZedd� �Zedd� �Zedd� �Zedd � �Zd S ) � AngleAddrz angle-addrc C s" | D ]}|j dkr|j S qd S �N� addr-spec)rD r� rg r r r r� � s zAngleAddr.local_partc C s" | D ]}|j dkr|j S qd S r� �rD r� rg r r r r� � s zAngleAddr.domainc C s" | D ]}|j dkr|j S qd S )N� obs-route)rD �domainsrg r r r r� � s zAngleAddr.routec C s< | D ]2}|j dkr|jr"|j S t|j�|j S qdS )Nr� z<>)rD r� r� r rg r r r r� � s zAngleAddr.addr_specN) r+ rF rG rD rJ r� r� r� r� r r r r r� � s r� c @ s e Zd ZdZedd� �ZdS )�ObsRouter� c C s dd� | D �S )Nc S s g | ]}|j d kr|j�qS r� r� r r r r rQ � s z$ObsRoute.domains.<locals>.<listcomp>r r& r r r r� � s zObsRoute.domainsN)r+ rF rG rD rJ r� r r r r r� � s r� c @ sL e Zd ZdZedd� �Zedd� �Zedd� �Zedd � �Zed d � �Z d S ) �Mailboxr� c C s | d j dkr| d jS d S �Nr r� r} r& r r r r~ � s zMailbox.display_namec C s | d j S r/ r� r& r r r r� � s zMailbox.local_partc C s | d j S r/ r� r& r r r r� � s zMailbox.domainc C s | d j dkr| d jS d S r� )rD r� r& r r r r� � s z Mailbox.routec C s | d j S r/ r� r& r r r r� � s zMailbox.addr_specNr� r r r r r� � s r� c @ s, e Zd ZdZedd� �Ze Z Z ZZ dS )�InvalidMailboxr� c C s d S r r r& r r r r~ � s zInvalidMailbox.display_nameNr� r r r r r� � s r� c s( e Zd ZdZdZe� fdd��Z� ZS )�Domainr� Fc s d� t� j�� �S �Nr �r% r r �splitr& r r r r� � s z Domain.domain)r+ rF rG rD r1 rJ r� rK r r r r r� � s r� c @ s e Zd ZdZdS )�DotAtom�dot-atomNrT r r r r r� � s r� c @ s e Zd ZdZdZdS )� DotAtomTextz dot-atom-textTN�r+ rF rG rD r1 r r r r r� � s r� c @ s e Zd ZdZdZdS )� NoFoldLiteralzno-fold-literalFNr� r r r r r� s r� c @ sD e Zd ZdZdZedd� �Zedd� �Zedd� �Zed d � �Z d S ) �AddrSpecr� Fc C s | d j S r/ r� r& r r r r� s zAddrSpec.local_partc C s t | �dk rd S | d jS )N� r� )r� r� r& r r r r� s zAddrSpec.domainc C s< t | �dk r| d jS | d j�� | d j | d j�� S )Nr� r r� r� )r� r �rstrip�lstripr& r r r r s zAddrSpec.valuec C sL t | j�}t|�t|t �kr*t| j�}n| j}| jd k rH|d | j S |S )N�@)�setr� r� � DOT_ATOM_ENDSr r� )r ZnamesetZlpr r r r� s zAddrSpec.addr_specN) r+ rF rG rD r1 rJ r� r� r r� r r r r r� s r� c @ s e Zd ZdZdZdS )� ObsLocalPartzobs-local-partFNr� r r r r r� & s r� c s4 e Zd ZdZdZedd� �Ze� fdd��Z� ZS )� DisplayNamez display-nameFc C s� t | �}t|�dkr|jS |d jdkr4|�d� n*|d d jdkr^t |d dd � �|d< |d jdkrv|�� n*|d d jdkr�t |d d d� �|d< |jS )Nr rY r� r� )r r� r rD �pop)r ri r r r r~ 1 s zDisplayName.display_namec s� d}| j rd}n| D ]}|jdkrd}qt| �dkr�|r�d }}| d jdks`| d d jdkrdd}| d jdks�| d d jdkr�d}|t| j� | S t� jS d S ) NFTrc r r rY rN r� )r rD r� r r~ r r )r ro r" ZpreZpostr r r r B s zDisplayName.value) r+ rF rG rD rI rJ r~ r rK r r r r r� , s r� c @ s, e Zd ZdZdZedd� �Zedd� �ZdS )� LocalPartz local-partFc C s& | d j dkr| d jS | d jS d S )Nr rc )rD rj r r& r r r r [ s zLocalPart.valuec C s� t g}t }d}| d t g D ]�}|jdkr,q |r\|jdkr\|d jdkr\t|d d� �|d< t|t�}|r�|jdkr�|d jdkr�|�t|dd � �� n |�|� |d }|}q t|dd� �}|jS )NFr rY �dotr� r� )�DOTrD r � isinstancerh r )r ri ZlastZ last_is_tl�tokZis_tlr r r r� b s( � � zLocalPart.local_partN)r+ rF rG rD r1 rJ r r� r r r r r� V s r� c s4 e Zd ZdZdZe� fdd��Zedd� �Z� ZS )� DomainLiteralzdomain-literalFc s d� t� j�� �S r� r� r& r r r r� s zDomainLiteral.domainc C s" | D ]}|j dkr|j S qd S )N�ptextrf rg r r r �ip� s zDomainLiteral.ip) r+ rF rG rD r1 rJ r� r� rK r r r r r� z s r� c @ s e Zd ZdZdZdZdS )� MIMEVersionz mime-versionN)r+ rF rG rD �major�minorr r r r r� � s r� c @ s4 e Zd ZdZdZdZdZedd� �Zedd� �Z dS ) � Parameter� parameterF�us-asciic C s | j r| d jS dS r� )� sectioned�numberr& r r r �section_number� s zParameter.section_numberc C sf | D ]\}|j dkr |j S |j dkr|D ]4}|j dkr*|D ] }|j dkr<|j S q<q*qdS )Nr rc re r )rD rl rk r r r � param_value� s zParameter.param_valueN) r+ rF rG rD r� �extendedr` rJ r� r� r r r r r� � s r� c @ s e Zd ZdZdS )�InvalidParameter�invalid-parameterNrT r r r r r� � s r� c @ s e Zd ZdZedd� �ZdS )� Attribute� attributec C s$ | D ]}|j �d�r|j S qd S )N�attrtext)rD �endswithr rk r r r rl � s zAttribute.stripped_valueN�r+ rF rG rD rJ rl r r r r r� � s r� c @ s e Zd ZdZdZdS )�Section�sectionN)r+ rF rG rD r� r r r r r� � s r� c @ s e Zd ZdZedd� �ZdS )�Valuer c C s2 | d }|j dkr| d }|j �d�r,|jS | jS )Nr rY r� )rc r� zextended-attribute)rD r� rl r rk r r r rl � s �zValue.stripped_valueNr� r r r r r� � s r� c @ s( e Zd ZdZdZedd� �Zdd� ZdS )�MimeParameters�mime-parametersFc c s� i }| D ]T}|j �d�sq|d j dkr*q|d j�� }||krHg ||< || �|j|f� q|�� D �]~\}}t|td�d�}|d d }|j }|j s�t |�dkr�|d d dkr�|d d j �t �d�� |d d� }g }d}|D ]�\} } | |k�r(| j �s| j �t �d�� q�n| j �t �d�� |d7 }| j} | j �r�ztj�| �} W n& tk �rt tjj| d d �} Y nRX z| �|d �} W n" tk �r� | �d d �} Y nX t�| ��r�| j �t �� � |�| � q�d �|�} || fV qfd S )Nr� r r� )�keyr� z.duplicate parameter name; duplicate(s) ignoredz+duplicate parameter name; duplicate ignoredz(inconsistent RFC2231 parameter numberingzlatin-1)�encoding�surrogateescaper� r )rD r� r �striprh r� �items�sortedr r` r� r� r r �InvalidHeaderDefectr� �urllib�parseZunquote_to_bytes�UnicodeEncodeErrorZunquote�decode� LookupErrorr �_has_surrogates�UndecodableBytesDefectr% ) r �paramsr6 �name�partsZ first_paramr` Z value_parts�ir� �paramr r r r r� � s` � � � zMimeParameters.paramsc C sT g }| j D ].\}}|r.|�d�|t|��� q |�|� q d�|�}|rPd| S dS )N�{}={}z; rN r )r� rh r* r r% )r r� r� r r r r r' s zMimeParameters.__str__N)r+ rF rG rD rH rJ r� r' r r r r r� � s Er� c @ s e Zd ZdZedd� �ZdS )�ParameterizedHeaderValueFc C s& t | �D ]}|jdkr|j S qi S )Nr� )�reversedrD r� rk r r r r� - s z ParameterizedHeaderValue.paramsN)r+ rF rG rH rJ r� r r r r r� ' s r� c @ s e Zd ZdZdZdZdZdS )� ContentTypez content-typeF�textZplainN)r+ rF rG rD r1 �maintype�subtyper r r r r� 5 s r� c @ s e Zd ZdZdZdZdS )�ContentDispositionzcontent-dispositionFN)r+ rF rG rD r1 �content_dispositionr r r r r� < s r� c @ s e Zd ZdZdZdZdS )�ContentTransferEncodingzcontent-transfer-encodingFZ7bitN)r+ rF rG rD r1 r_ r r r r r� B s r� c @ s e Zd ZdZdZdS )� HeaderLabelz header-labelFNr� r r r r r� H s r� c @ s e Zd ZdZdZdd� ZdS )�MsgIDzmsg-idFc C s t | �|j S r )r �linesepr: r r r r; Q s z MsgID.foldN)r+ rF rG rD r1 r; r r r r r� M s r� c @ s e Zd ZdZdS )� MessageIDz message-idNrT r r r r r� V s r� c @ s e Zd ZdZdS )�InvalidMessageIDzinvalid-message-idNrT r r r r r� Z s r� c @ s e Zd ZdZdS )�Header�headerNrT r r r r r� ^ s r� c sr e Zd ZdZdZdZ� fdd�Z� fdd�Zdd� Ze dd � �Z d� fd d � Z d d� Z e dd� �Z dd� Z� ZS )�TerminalTc s t � �| |�}||_g |_|S r )r �__new__rD r )�clsr rD r r r r r� l s zTerminal.__new__c s d� | jjt� �� �S r( r) r& r r r r, r s zTerminal.__repr__c C s t | jjd | j � d S )N�/)r> r r+ rD r& r r r rA u s zTerminal.pprintc C s t | j�S r )�listr r& r r r r- x s zTerminal.all_defectsr c s2 d� || jj| jt� �� | js"dn d� | j��gS )Nz {}{}/{}({}){}r z {})r* r r+ rD r r, r r@ r r r rC | s �z Terminal._ppc C s d S r r r& r r r �pop_trailing_ws� s zTerminal.pop_trailing_wsc C s g S r r r& r r r r5 � s zTerminal.commentsc C s t | �| jfS r )r rD r& r r r �__getnewargs__� s zTerminal.__getnewargs__)r )r+ rF rG r1 rI rH r� r, rA rJ r- rC r� r5 r rK r r r r r� f s r� c @ s e Zd Zedd� �Zdd� ZdS )�WhiteSpaceTerminalc C s dS rM r r& r r r r � s zWhiteSpaceTerminal.valuec C s dS )NTr r& r r r r0 � s z!WhiteSpaceTerminal.startswith_fwsN�r+ rF rG rJ r r0 r r r r r � s r c @ s e Zd Zedd� �Zdd� ZdS )� ValueTerminalc C s | S r r r& r r r r � s zValueTerminal.valuec C s dS )NFr r& r r r r0 � s z ValueTerminal.startswith_fwsNr r r r r r � s r c @ s e Zd Zedd� �Zdd� ZdS )�EWWhiteSpaceTerminalc C s dS r� r r& r r r r � s zEWWhiteSpaceTerminal.valuec C s dS r� r r& r r r r' � s z EWWhiteSpaceTerminal.__str__N)r+ rF rG rJ r r' r r r r r � s r c @ s e Zd ZdZdS )�_InvalidEwErrorz1Invalid encoded word found while parsing headers.N)r+ rF rG �__doc__r r r r r � s r r� �,�list-separatorr� zroute-component-markerz([{}]+)r z[^{}]+z[\x00-\x20\x7F]c C s> t | �}|r | j�t�|�� t�| �r:| j�t�d�� dS )z@If input token contains ASCII non-printables, register a defect.z*Non-ASCII characters found in header tokenN)�_non_printable_finderr rh r ZNonPrintableDefectr r� r� )�xtextZnon_printablesr r r �_validate_xtext� s �r c C s� t | d�^}}g }d}d}tt|��D ]L}|| dkrJ|rDd}d}nd}q&|rTd}n|| |krd q||�|| � q&|d }d�|�d�||d� g| �|fS )ak Scan printables/quoted-pairs until endchars and return unquoted ptext. This function turns a run of qcontent, ccontent-without-comments, or dtext-with-quoted-printables into a single string by unquoting any quoted printables. It returns the string, the remaining value, and a flag that is True iff there were any quoted printables decoded. r� Fr Tr N)� _wsp_splitter�ranger� rh r% )r �endcharsZfragment� remainderZvchars�escape�had_qp�posr r r �_get_ptext_to_endchars� s$ r c C s. | � � }t| dt| �t|� � d�}||fS )z�FWS = 1*WSP This isn't the RFC definition. We're using fws to represent tokens where folding can be done, but when we are parsing the *un*folding has already been done so we don't need to watch out for CRLF. N�fws)r� r r� )r Znewvaluer r r r �get_fws s r c C s� t � }| �d�s t�d�| ���| dd� �dd�^}}|| dd� krXt�d�| ���d�|�}t|�dkr�|d tkr�|d tkr�|� d �dk r�|�dd�^}}|d | }t|�� �dkr�|j � t� d �� | |_ d�|�} z t�d| d �\}}}} W n* ttfk �r* td �|j ���Y nX ||_||_|j �| � |�r�|d tk�rrt|�\} }|� | � �qDt|d�^} }t| d �} t| � |� | � d�|�}�qD| �r�| d tk�r�|j � t� d �� || fS )zE encoded-word = "=?" charset "?" encoding "?" encoded-text "?=" �=?z"expected encoded word but found {}r� Nz?=r� r r �?z whitespace inside encoded wordz!encoded word format invalid: '{}'�vtextz.missing trailing whitespace after encoded-word)r] � startswithr �HeaderParseErrorr* r� r% r� r �countr rh r� r_ �_ewr� � ValueError�KeyErrorr r` ra r4 �WSPr r r r ) r Zewr� r Zremstr�restr� r` ra r r6 �charsr r r r �get_encoded_word sd �� � � � � � �r" c C sF t � }| �rB| d tkr0t| �\}} |�|� qd}| �d�r�zt| �\}} W n, tk rf d}Y n� tjk rz Y nrX d}t |�dkr�|d j dkr�|j �t� d�� d}|r�t |�dkr�|d j d kr�t |d d�|d< |�|� qt| d�^}}|�rt�|��r| �d�^}}t|d �}t|� |�|� d �|�} q|S ) aO unstructured = (*([FWS] vchar) *WSP) / obs-unstruct obs-unstruct = *((*LF *CR *(obs-utext) *LF *CR)) / FWS) obs-utext = %d0 / obs-NO-WS-CTL / LF / CR obs-NO-WS-CTL is control characters except WSP/CR/LF. So, basically, we have printable runs, plus control characters or nulls in the obsolete syntax, separated by whitespace. Since RFC 2047 uses the obsolete syntax in its specification, but requires whitespace on either side of the encoded words, I can see no reason to need to separate the non-printable-non-whitespace from the printable runs if they occur, so we parse this into xtext tokens separated by WSP tokens. Because an 'unstructured' value must by definition constitute the entire value, this 'get' routine does not return a remaining value, only the parsed TokenList. r Tr Fr� r z&missing whitespace before encoded wordr� ���r^ r r )rR r r rh r r" r r r r� rD r r� r r �rfc2047_matcher�search� partitionr r r% )r rS r6 �valid_ewZhave_wsr� r r r r r �get_unstructured? sJ � � r( c C s* t | d�\}} }t|d�}t|� || fS )a ctext = <printable ascii except \ ( )> This is not the RFC ctext, since we are handling nested comments in comment and unquoting quoted-pairs here. We allow anything except the '()' characters, but if we find any ASCII other than the RFC defined printable ASCII, a NonPrintableDefect is added to the token's defects list. Since quoted pairs are converted to their unquoted values, what is returned is a 'ptext' token. In this case it is a WhiteSpaceTerminal, so it's value is ' '. z()r� )r r r �r r� �_r r r � get_qp_ctext� s r+ c C s* t | d�\}} }t|d�}t|� || fS )ao qcontent = qtext / quoted-pair We allow anything except the DQUOTE character, but if we find any ASCII other than the RFC defined printable ASCII, a NonPrintableDefect is added to the token's defects list. Any quoted pairs are converted to their unquoted values, so what is returned is a 'ptext' token. In this case it is a ValueTerminal. r r� )r r r r) r r r � get_qcontent� s r, c C sN t | �}|s t�d�| ���|�� }| t|�d� } t|d�}t|� || fS )z�atext = <matches _atext_matcher> We allow any non-ATOM_ENDS in atext, but add an InvalidATextDefect to the token's defects list if we find non-atext characters. z expected atext but found '{}'N�atext)�_non_atom_end_matcherr r r* r| r� r r )r �mr- r r r � get_atext� s � r0 c C sr | d dkr t �d�| ���t� }| dd� } | rT| d dkrTt| �\}} |�|� | �rB| d dk�rB| d tkr�t| �\}} n�| dd� dk�r*d}z&t| �\}} |j �t � d �� d }W n" t jk r� t| �\}} Y nX |�r6t |�dk�r6|d j d k�r6|d j dk�r6t |d d �|d < n t| �\}} |�|� qT| �sb|j �t � d�� || fS || dd� fS )z�bare-quoted-string = DQUOTE *([FWS] qcontent) [FWS] DQUOTE A quoted-string without the leading or trailing white space. Its value is the text between the quote marks, with whitespace preserved and quoted pairs decoded. r r zexpected '"' but found '{}'r� Nr� r Fz!encoded word inside quoted stringTr� r r# r^ z"end of header inside quoted string)r r r* rm r, rh r r r" r r� r� rD r )r Zbare_quoted_stringr6 r' r r r �get_bare_quoted_string� sL � � � � �r1 c C s� | r | d dkr t �d�| ���t� }| dd� } | r�| d dkr�| d tkr\t| �\}} n&| d dkrvt| �\}} n t| �\}} |�|� q2| s�|j �t � d�� || fS || dd� fS )z�comment = "(" *([FWS] ccontent) [FWS] ")" ccontent = ctext / quoted-pair / comment We handle nested comments here, and quoted-pair in our qp-ctext routine. r r zexpected '(' but found '{}'r� Nrp z end of header inside comment) r r r* rn r r � get_commentr+ rh r r� )r rO r6 r r r r2 � s& � �r2 c C sP t � }| rH| d tkrH| d tkr0t| �\}} n t| �\}} |�|� q|| fS )z,CFWS = (1*([FWS] comment) [FWS]) / FWS r )rX � CFWS_LEADERr r r2 rh )r rY r6 r r r �get_cfws� s r4 c C sp t � }| r,| d tkr,t| �\}} |�|� t| �\}} |�|� | rh| d tkrht| �\}} |�|� || fS )z�quoted-string = [CFWS] <bare-quoted-string> [CFWS] 'bare-quoted-string' is an intermediate class defined by this parser and not by the RFC grammar. It is the quoted string without any attached CFWS. r )rb r3 r4 rh r1 )r Z quoted_stringr6 r r r �get_quoted_string s r5 c C s� t � }| r,| d tkr,t| �\}} |�|� | rL| d tkrLt�d�| ���| �d�r�zt | �\}} W q� tjk r� t | �\}} Y q�X n t | �\}} |�|� | r�| d tkr�t| �\}} |�|� || fS )zPatom = [CFWS] 1*atext [CFWS] An atom could be an rfc2047 encoded word. r z expected atom but found '{}'r ) rZ r3 r4 rh � ATOM_ENDSr r r* r r" r0 )r r[ r6 r r r �get_atom s& � r7 c C s� t � }| r| d tkr&t�d�| ���| rt| d tkrtt| �\}} |�|� | r&| d dkr&|�t� | dd� } q&|d tkr�t�d�d| ���|| fS )z( dot-text = 1*atext *("." 1*atext) r z8expected atom at a start of dot-atom-text but found '{}'r r� Nr� z4expected atom at end of dot-atom-text but found '{}')r� r6 r r r* r0 rh r� )r Z dot_atom_textr6 r r r �get_dot_atom_text0 s � �r8 c C s� t � }| d tkr(t| �\}} |�|� | �d�rhzt| �\}} W qt tjk rd t| �\}} Y qtX n t| �\}} |�|� | r�| d tkr�t| �\}} |�|� || fS )z� dot-atom = [CFWS] dot-atom-text [CFWS] Any place we can have a dot atom, we could instead have an rfc2047 encoded word. r r ) r� r3 r4 rh r r" r r r8 )r Zdot_atomr6 r r r � get_dot_atomC s r9 c C s� | d t krt| �\}} nd}| s,t�d��| d dkrFt| �\}} n*| d tkrdt�d�| ���n t| �\}} |dk r�|g|dd�< || fS )a� word = atom / quoted-string Either atom or quoted-string may start with CFWS. We have to peel off this CFWS first to determine which type of word to parse. Afterward we splice the leading CFWS, if any, into the parsed sub-token. If neither an atom or a quoted-string is found before the next special, a HeaderParseError is raised. The token returned is either an Atom or a QuotedString, as appropriate. This means the 'word' level of the formal grammar is not represented in the parse tree; this is because having that extra layer when manipulating the parse tree is more confusing than it is helpful. r Nz5Expected 'atom' or 'quoted-string' but found nothing.r z1Expected 'atom' or 'quoted-string' but found '{}')r3 r4 r r r5 �SPECIALSr* r7 )r �leaderr6 r r r �get_word\ s" � � r< c C s� t � }zt| �\}} |�|� W n( tjk rH |j�t�d�� Y nX | r�| d tkr�| d dkr�|�t� |j�t� d�� | dd� } qJzt| �\}} W nD tjk r� | d t kr�t | �\}} |j�t� d�� n� Y nX |�|� qJ|| fS )a� phrase = 1*word / obs-phrase obs-phrase = word *(word / "." / CFWS) This means a phrase can be a sequence of words, periods, and CFWS in any order as long as it starts with at least one word. If anything other than words is detected, an ObsoleteHeaderDefect is added to the token's defect list. We also accept a phrase that starts with CFWS followed by a dot; this is registered as an InvalidHeaderDefect, since it is not supported by even the obsolete grammar. z phrase does not start with wordr r zperiod in 'phrase'r� Nzcomment found without atom) rU r< rh r r r r� � PHRASE_ENDSr� �ObsoleteHeaderDefectr3 r4 )r rV r6 r r r � get_phrase~ s4 � � � r? c C sv t � }d}| d tkr"t| �\}} | s6t�d�| ���zt| �\}} W n^ tjk r� zt| �\}} W n6 tjk r� | d dkr�| d tkr�� t � }Y nX Y nX |dk r�|g|dd�< |� |� | �r4| d dks�| d tk�r4t t |�| �\}} |j dk�r|j� t�d�� n|j� t�d�� ||d< z|j�d� W n( tk �rl |j� t�d �� Y nX || fS ) z= local-part = dot-atom / quoted-string / obs-local-part Nr z"expected local-part but found '{}'r �invalid-obs-local-partz<local-part is not dot-atom, quoted-string, or obs-local-partz,local-part is not a dot-atom (contains CFWS)�asciiz)local-part contains non-ASCII characters))r� r3 r4 r r r* r9 r< r= r rh �get_obs_local_partr rD r r� r> r �encoder� ZNonASCIILocalPartDefect)r r� r; r6 �obs_local_partr r r �get_local_part� sJ � � � � rE c C s� t � }d}| �r(| d dks*| d tk�r(| d dkrj|rL|j�t�d�� |�t� d}| dd� } q nD| d dkr�|�t| d d �� | dd� } |j�t�d �� d}q |r�|d jd kr�|j�t�d �� zt | �\}} d}W n4 tj k �r | d t k�r � t | �\}} Y nX |�|� q |d jd k�sX|d jdk�rj|d jd k�rj|j�t�d�� |d jd k�s�|d jdk�r�|d jd k�r�|j�t�d�� |j�r�d|_|| fS )z' obs-local-part = word *("." word) Fr r r zinvalid repeated '.'Tr� N�misplaced-specialz/'\' character outside of quoted-string/ccontentr� r� zmissing '.' between wordsrY z!Invalid leading '.' in local partr# z"Invalid trailing '.' in local partr@ ) r� r= r rh r r� r� r rD r< r r3 r4 )r rD Zlast_non_ws_was_dotr6 r r r rB � sj � � � � � � � � � �rB c C s@ t | d�\}} }t|d�}|r0|j�t�d�� t|� || fS )a dtext = <printable ascii except \ [ ]> / obs-dtext obs-dtext = obs-NO-WS-CTL / quoted-pair We allow anything except the excluded characters, but if we find any ASCII other than the RFC defined printable ASCII, a NonPrintableDefect is added to the token's defects list. Quoted pairs are converted to their unquoted values, so what is returned is a ptext token, in this case a ValueTerminal. If there were quoted-printables, an ObsoleteHeaderDefect is added to the returned token's defect list. z[]r� z(quoted printable found in domain-literal)r r r rh r r> r )r r� r r r r � get_dtext� s �rG c C s, | rdS |� t�d�� |� tdd�� dS )NFz"end of input inside domain-literal�]�domain-literal-endT)rh r r� r )r �domain_literalr r r �_check_for_early_dl_end s �rK c C sj t � }| d tkr(t| �\}} |�|� | s6t�d��| d dkrRt�d�| ���| dd� } t| |�rp|| fS |�tdd�� | d t kr�t | �\}} |�|� t | �\}} |�|� t| |�r�|| fS | d t kr�t | �\}} |�|� t| |�r�|| fS | d dk�r t�d �| ���|�tdd �� | dd� } | �rb| d tk�rbt| �\}} |�|� || fS ) zB domain-literal = [CFWS] "[" *([FWS] dtext) [FWS] "]" [CFWS] r zexpected domain-literal�[z6expected '[' at start of domain-literal but found '{}'r� Nzdomain-literal-startrH z4expected ']' at end of domain-literal but found '{}'rI ) r� r3 r4 rh r r r* rK r r r rG )r rJ r6 r r r �get_domain_literal sH � � rM c C sr t � }d}| d tkr"t| �\}} | s6t�d�| ���| d dkrvt| �\}} |dk rd|g|dd�< |�|� || fS zt| �\}} W n" tjk r� t | �\}} Y nX | r�| d dkr�t�d��|dk r�|g|dd�< |�|� | �rj| d dk�rj|j �t� d�� |d j d k�r*|d |dd�< | �rj| d dk�rj|�t � t | d d� �\}} |�|� �q*|| fS ) z] domain = dot-atom / domain-literal / obs-domain obs-domain = atom *("." atom)) Nr z expected domain but found '{}'rL r� zInvalid Domainr z(domain is not a dot-atom (contains CFWS)r� r� )r� r3 r4 r r r* rM rh r9 r7 r r> rD r� )r r� r; r6 r r r � get_domain= sD � � rN c C s| t � }t| �\}} |�|� | r,| d dkrF|j�t�d�� || fS |�tdd�� t| dd� �\}} |�|� || fS )z( addr-spec = local-part "@" domain r r� z#addr-spec local part with no domain�address-at-symbolr� N)r� rE rh r r r� r rN )r r� r6 r r r � get_addr_specc s � rP c C s� t � }| rj| d dks"| d tkrj| d tkrFt| �\}} |�|� q| d dkr|�t� | dd� } q| rz| d dkr�t�d�| ���|�t� t | dd� �\}} |�|� | �r>| d dk�r>|�t� | dd� } | s�q>| d tk�rt| �\}} |�|� | d dkr�|�t� t | dd� �\}} |�|� q�| �sNt�d��| d dk�rlt�d �| ���|�t dd �� || dd� fS ) z� obs-route = obs-domain-list ":" obs-domain-list = *(CFWS / ",") "@" domain *("," [CFWS] ["@" domain]) Returns an obs-route token with the appropriate sub-tokens (that is, there is no obs-domain-list in the parse tree). r r r� Nr� z(expected obs-route domain but found '{}'z%end of header while parsing obs-route�:z4expected ':' marking end of obs-route but found '{}'zend-of-obs-route-marker) r� r3 r4 rh � ListSeparatorr r r* �RouteComponentMarkerrN r )r Z obs_router6 r r r � get_obs_routes sF � �rT c C s� t � }| d tkr(t| �\}} |�|� | r8| d dkrHt�d�| ���|�tdd�� | dd� } | d dkr�|�tdd�� |j�t� d �� | dd� } || fS zt | �\}} W nz tjk �r0 z"t | �\}} |j�t� d �� W n( tjk �r t�d �| ���Y nX |�|� t | �\}} Y nX |�|� | �r^| d dk�r^| dd� } n|j�t� d �� |�tdd�� | �r�| d tk�r�t| �\}} |�|� || fS ) z� angle-addr = [CFWS] "<" addr-spec ">" [CFWS] / obs-angle-addr obs-angle-addr = [CFWS] "<" obs-route addr-spec ">" [CFWS] r �<z"expected angle-addr but found '{}'zangle-addr-startr� N�>zangle-addr-endz null addr-spec in angle-addrz*obsolete route specification in angle-addrz.expected addr-spec or obs-route but found '{}'z"missing trailing '>' on angle-addr) r� r3 r4 rh r r r* r r r� rP rT r> )r Z angle_addrr6 r r r �get_angle_addr� sT � � � � � rW c C s< t � }t| �\}} |�|dd� � |jdd� |_|| fS )z� display-name = phrase Because this is simply a name-rule, we don't return a display-name token containing a phrase, but rather a display-name token with the content of the phrase. N)r� r? r4 r )r r~ r6 r r r �get_display_name� s rX c C s� t � }d}| d tkr6t| �\}} | s6t�d�|���| d dkr�| d tkr^t�d�| ���t| �\}} | s~t�d�|���|dk r�|g|d dd�< d}|�|� t | �\}} |dk r�|g|dd�< |�|� || fS )z, name-addr = [display-name] angle-addr Nr z!expected name-addr but found '{}'rU ) r� r3 r4 r r r* r= rX rh rW )r Z name_addrr; r6 r r r � get_name_addr� s6 � � � rY c C s� t � }zt| �\}} W nN tjk rd zt| �\}} W n& tjk r^ t�d�| ���Y nX Y nX tdd� |jD ��r�d|_|� |� || fS )z& mailbox = name-addr / addr-spec z expected mailbox but found '{}'c s s | ]}t |tj�V qd S r )r� r r� r r r r r# s �z get_mailbox.<locals>.<genexpr>r� ) r� rY r r rP r* �anyr- rD rh )r r� r6 r r r � get_mailbox� s �� r[ c C sd t � }| r\| d |kr\| d tkrD|�t| d d�� | dd� } qt| �\}} |�|� q|| fS )z� Read everything up to one of the chars in endchars. This is outside the formal grammar. The InvalidMailbox TokenList that is returned acts like a Mailbox, but the data attributes are None. r rF r� N)r� r= rh r r? )r r Zinvalid_mailboxr6 r r r �get_invalid_mailbox s � r\ c C s� t � }| �r�| d dk�r�z t| �\}} |�|� W �n tjk �r< d}| d tkr�t| �\}} | rv| d dkr�|�|� |j�t�d�� n@t | d�\}} |dk r�|g|dd�< |�|� |j�t� d�� nb| d dkr�|j�t�d�� nBt | d�\}} |dk �r |g|dd�< |�|� |j�t� d�� Y nX | �r�| d dk�r�|d }d |_ t | d�\}} |� |� |j�t� d�� | r| d dkr|�t � | d d� } q|| fS ) aJ mailbox-list = (mailbox *("," mailbox)) / obs-mbox-list obs-mbox-list = *([CFWS] ",") mailbox *("," [mailbox / CFWS]) For this routine we go outside the formal grammar in order to improve error handling. We recognize the end of the mailbox list only at the end of the value or at a ';' (the group terminator). This is so that we can turn invalid mailboxes into InvalidMailbox tokens and continue parsing any remaining valid mailboxes. We also allow all mailbox entries to be null, and this condition is handled appropriately at a higher level. r �;Nz,;z empty element in mailbox-listz invalid mailbox in mailbox-listr r� r� r� )r� r[ rh r r r3 r4 r r> r\ r� rD r4 rR )r Z mailbox_listr6 r; r� r r r �get_mailbox_list sX � � � � � r^ c C s t � }| s$|j�t�d�� || fS d}| r�| d tkr�t| �\}} | sl|j�t�d�� |�|� || fS | d dkr�|�|� || fS t| �\}} t|j �dkr�|dk r�|�|� |� |� |j�t� d�� || fS |dk r�|g|dd�< |�|� || fS )zg group-list = mailbox-list / CFWS / obs-group-list obs-group-list = 1*([CFWS] ",") [CFWS] z end of header before group-listNr zend of header in group-listr] z group-list with empty entries) r� r rh r r� r3 r4 r^ r� rz r4 r> )r Z group_listr; r6 r r r �get_group_listW s> � � � r_ c C s t � }t| �\}} | r"| d dkr2t�d�| ���|�|� |�tdd�� | dd� } | r�| d dkr�|�tdd�� || dd� fS t| �\}} |�|� | s�|j�t� d �� n | d dkr�t�d �| ���|�tdd�� | dd� } | �r| d t k�rt | �\}} |�|� || fS ) z7 group = display-name ":" [group-list] ";" [CFWS] r rQ z8expected ':' at end of group display name but found '{}'z group-display-name-terminatorr� Nr] zgroup-terminatorzend of header in groupz)expected ';' at end of group but found {}) r� rX r r r* rh r r_ r r� r3 r4 )r r| r6 r r r � get_group| s8 � � � r` c C sx t � }zt| �\}} W nN tjk rd zt| �\}} W n& tjk r^ t�d�| ���Y nX Y nX |�|� || fS )a� address = mailbox / group Note that counter-intuitively, an address can be either a single address or a list of addresses (a group). This is why the returned Address object has a 'mailboxes' attribute which treats a single address as a list of length one. When you need to differentiate between to two cases, extract the single element, which is either a mailbox or a group token. z expected address but found '{}')r{ r` r r r[ r* rh )r rr r6 r r r � get_address� s � ra c C s� t � }| �r�z t| �\}} |�|� W �n tjk �rH } z�d}| d tkr�t| �\}} | rj| d dkr�|�|� |j�t�d�� nFt | d�\}} |dk r�|g|dd�< |�t |g�� |j�t� d�� nh| d dkr�|j�t�d�� nHt | d�\}} |dk �r|g|dd�< |�t |g�� |j�t� d�� W 5 d}~X Y nX | �r�| d dk�r�|d d }d|_ t | d�\}} |� |� |j�t� d�� | r|�tdd �� | d d� } q|| fS ) a� address_list = (address *("," address)) / obs-addr-list obs-addr-list = *([CFWS] ",") address *("," [address / CFWS]) We depart from the formal grammar here by continuing to parse until the end of the input, assuming the input to be entirely composed of an address-list. This is always true in email parsing, and allows us to skip invalid addresses to parse additional valid ones. Nr r z"address-list entry with no contentz invalid address in address-listz empty element in address-listr� r� r r� )rq ra rh r r r3 r4 r r> r\ r{ r� rD r4 r )r Z address_listr6 �errr; r� r r r �get_address_list� sX � � � � �rc c C s� t � }| st�d�| ���| d dkr6t�d�| ���|�tdd�� | dd� } t| �\}} |�|� | rx| d dkr�t�d �| ���|�tdd �� || dd� fS ) z& no-fold-literal = "[" *dtext "]" z'expected no-fold-literal but found '{}'r rL z;expected '[' at the start of no-fold-literal but found '{}'zno-fold-literal-startr� NrH z9expected ']' at the end of no-fold-literal but found '{}'zno-fold-literal-end)r� r r r* rh r rG )r Zno_fold_literalr6 r r r �get_no_fold_literal� s. � �� ��rd c C s� t � }| r,| d tkr,t| �\}} |�|� | r<| d dkrLt�d�| ���|�tdd�� | dd� } zt| �\}} W n` tjk r� z"t | �\}} |j �t� d�� W n& tjk r� t�d�| ���Y nX Y nX |�|� | r�| d d k�r@|j �t� d �� | �r8| d d k�r8|�td d �� | dd� } || fS |�td d �� | dd� } zt| �\}} W n� tjk �r zt | �\}} W nr tjk �r } zPz"t| �\}} |j �t� d�� W n( tjk �r� t�d�| ���Y nX W 5 d}~X Y nX Y nX |�|� | �r6| d d k�r6| dd� } n|j �t� d�� |�td d �� | �r�| d tk�r�t| �\}} |�|� || fS )z�msg-id = [CFWS] "<" id-left '@' id-right ">" [CFWS] id-left = dot-atom-text / obs-id-left id-right = dot-atom-text / no-fold-literal / obs-id-right no-fold-literal = "[" *dtext "]" r rU z expected msg-id but found '{}'z msg-id-startr� Nzobsolete id-left in msg-idz4expected dot-atom-text or obs-id-left but found '{}'r� zmsg-id with no id-rightrV z msg-id-endrO zobsolete id-right in msg-idzFexpected dot-atom-text, no-fold-literal or obs-id-right but found '{}'z missing trailing '>' on msg-id)r� r3 r4 rh r r r* r r8 rB r r> r� rd rN )r Zmsg_idr6 �er r r � get_msg_id s~ � � �� � � ��" � rf c C s� t � }zt| �\}} |�|� W nL tjk rl } z,t| �}t|�}|j�t�d� |��� W 5 d}~X Y n X | r�|j�t�d� | ��� |S )z2message-id = "Message-ID:" msg-id CRLF zInvalid msg-id: {!r}NzUnexpected {!r}) r� rf rh r r r( r� r r� r* )r Z message_idr6 Zexr r r �parse_message_idI s � �rg c C s� t � }| s |j�t�d�� |S | d tkrXt| �\}} |�|� | sX|j�t�d�� d}| r�| d dkr�| d tkr�|| d 7 }| dd� } q\|�� s�|j�t�d� |��� |�t |d �� nt |�|_ |�t |d �� | �r| d tk�rt| �\}} |�|� | �r | d dk�rT|j dk �r:|j�t�d �� | �rP|�t | d �� |S |�t dd �� | dd� } | �r�| d tk�r�t| �\}} |�|� | �s�|j dk �r�|j�t�d �� |S d}| �r�| d tk�r�|| d 7 }| dd� } �q�|�� �s*|j�t�d � |��� |�t |d �� nt |�|_ |�t |d �� | �rn| d tk�rnt| �\}} |�|� | �r�|j�t�d�� |�t | d �� |S )zE mime-version = [CFWS] 1*digit [CFWS] "." [CFWS] 1*digit [CFWS] z%Missing MIME version number (eg: 1.0)r z0Expected MIME version number but found only CFWSr r r� Nz1Expected MIME major version number but found {!r}r �digitsz0Incomplete MIME version; found only major numberzversion-separatorz1Expected MIME minor version number but found {!r}z'Excess non-CFWS text after MIME version)r� r rh r �HeaderMissingRequiredValuer3 r4 �isdigitr� r* r �intr� r� )r Z mime_versionr6 rh r r r �parse_mime_versione s� � � � � � � �rl c C sd t � }| r\| d dkr\| d tkrD|�t| d d�� | dd� } qt| �\}} |�|� q|| fS )z� Read everything up to the next ';'. This is outside the formal grammar. The InvalidParameter TokenList that is returned acts like a Parameter, but the data attributes are None. r r] rF r� N)r� r= rh r r? )r Zinvalid_parameterr6 r r r �get_invalid_parameter� s � rm c C sN t | �}|s t�d�| ���|�� }| t|�d� } t|d�}t|� || fS )a8 ttext = <matches _ttext_matcher> We allow any non-TOKEN_ENDS in ttext, but add defects to the token's defects list if we find non-ttext characters. We also register defects for *any* non-printables even though the RFC doesn't exclude all of them, because we follow the spirit of RFC 5322. z expected ttext but found '{}'N�ttext)�_non_token_end_matcherr r r* r| r� r r )r r/ rn r r r � get_ttext� s � rp c C s� t � }| r,| d tkr,t| �\}} |�|� | rL| d tkrLt�d�| ���t| �\}} |�|� | r�| d tkr�t| �\}} |�|� || fS )z�token = [CFWS] 1*ttext [CFWS] The RFC equivalent of ttext is any US-ASCII chars except space, ctls, or tspecials. We also exclude tabs even though the RFC doesn't. The RFC implies the CFWS but is not explicit about it in the BNF. r � expected token but found '{}') r\ r3 r4 rh � TOKEN_ENDSr r r* rp )r Zmtokenr6 r r r � get_token� s � rs c C sN t | �}|s t�d�| ���|�� }| t|�d� } t|d�}t|� || fS )aQ attrtext = 1*(any non-ATTRIBUTE_ENDS character) We allow any non-ATTRIBUTE_ENDS in attrtext, but add defects to the token's defects list if we find non-attrtext characters. We also register defects for *any* non-printables even though the RFC doesn't exclude all of them, because we follow the spirit of RFC 5322. z expected attrtext but found {!r}Nr� )�_non_attribute_end_matcherr r r* r| r� r r �r r/ r� r r r � get_attrtext� s � rv c C s� t � }| r,| d tkr,t| �\}} |�|� | rL| d tkrLt�d�| ���t| �\}} |�|� | r�| d tkr�t| �\}} |�|� || fS )aH [CFWS] 1*attrtext [CFWS] This version of the BNF makes the CFWS explicit, and as usual we use a value terminal for the actual run of characters. The RFC equivalent of attrtext is the token characters, with the subtraction of '*', "'", and '%'. We include tab in the excluded set just as we do for token. r rq ) r� r3 r4 rh �ATTRIBUTE_ENDSr r r* rv �r r� r6 r r r � get_attribute� s � ry c C sN t | �}|s t�d�| ���|�� }| t|�d� } t|d�}t|� || fS )z�attrtext = 1*(any non-ATTRIBUTE_ENDS character plus '%') This is a special parsing routine so that we get a value that includes % escapes as a single string (which we decode as a single string later). z)expected extended attrtext but found {!r}N�extended-attrtext)�#_non_extended_attribute_end_matcherr r r* r| r� r r ru r r r �get_extended_attrtext s � r| c C s� t � }| r,| d tkr,t| �\}} |�|� | rL| d tkrLt�d�| ���t| �\}} |�|� | r�| d tkr�t| �\}} |�|� || fS )z� [CFWS] 1*extended_attrtext [CFWS] This is like the non-extended version except we allow % characters, so that we can pick up an encoded value as a single string. r rq ) r� r3 r4 rh �EXTENDED_ATTRIBUTE_ENDSr r r* r| rx r r r �get_extended_attribute! s � r~ c C s� t � }| r| d dkr&t�d�| ���|�tdd�� | dd� } | rR| d �� sbt�d�| ���d}| r�| d �� r�|| d 7 }| dd� } qf|d d kr�|d kr�|j�t�d �� t |�|_ |�t|d �� || fS ) a6 '*' digits The formal BNF is more complicated because leading 0s are not allowed. We check for that and add a defect. We also assume no CFWS is allowed between the '*' and the digits, though the RFC is not crystal clear on that. The caller should already have dealt with leading CFWS. r �*z Expected section but found {}zsection-markerr� Nz$Expected section number but found {}r �0z'section number has an invalid leading 0rh ) r� r r r* rh r rj r ZInvalidHeaderErrorrk r� )r r� rh r r r � get_section7 s, � � � r� c C s� t � }| st�d��d}| d tkr0t| �\}} | sDt�d�|���| d dkr^t| �\}} n t| �\}} |dk r�|g|dd�< |�|� || fS )z quoted-string / attribute z&Expected value but found end of stringNr z Expected value but found only {}r ) r� r r r3 r4 r* r5 r~ rh )r �vr; r6 r r r � get_valueU s" � r� c C s� t � }t| �\}} |�|� | r,| d dkrL|j�t�d�|��� || fS | d dkr�z t| �\}} d|_|�|� W n tj k r� Y nX | s�t� d��| d dkr�|�t dd�� | dd � } d|_ | d d kr�t� d ��|�t d d �� | dd � } d }| �r,| d t k�r,t | �\}} |�|� d }|}|j �rF| �rF| d d k�rFt| �\}}|j}d}|jdk�r�|�r�|d dk�r�d}n$t|�\}} | �r�| d dk�r�d}n(zt|�\}} W n Y n X | �s�d}|�r0|j�t�d�� |�|� |D ](} | jdk�r g | d d �< | } �q*�q |} nd }|j�t�d�� | �r`| d dk�r`d }n t| �\}} |j �r�|jdk�r�| �r�| d dk�r�|�|� |d k �r�|} || fS |j�t�d�� | �s�|j�t�d�� |�|� |d k�r�|| fS n�|d k �r@|D ]} | jdk�r �q$�q | jdk |�| � | j|_| d dk�r^t� d�| ���|�t dd�� | dd � } | �r�| d dk�r�t| �\}} |�|� |j|_| �r�| d dk�r�t� d�| ���|�t dd�� | dd � } |d k �rdt� } | �r^| d tk�r t| �\}} n2| d d k�rDt d d�}| dd � } n t| �\}} | �|� �q�| }n t| �\}} |�|� |d k �r�|} || fS )aY attribute [section] ["*"] [CFWS] "=" value The CFWS is implied by the RFC but not made explicit in the BNF. This simplified form of the BNF from the RFC is made to conform with the RFC BNF through some extra checks. We do it this way because it makes both error recovery and working with the resulting parse tree easier. r r] z)Parameter contains name ({}) but no valuer TzIncomplete parameterzextended-parameter-markerr� N�=z Parameter not followed by '='�parameter-separatorr F�'z5Quoted string value for extended parameter is invalidre zZParameter marked as extended but appears to have a quoted string value that is non-encodedzcApparent initial-extended-value but attribute was not marked as extended or was not initial sectionz(Missing required charset/lang delimitersrz r� z=Expected RFC2231 char/lang encoding delimiter, but found {!r}zRFC2231-delimiterz;Expected RFC2231 char/lang encoding delimiter, but found {}ZDQUOTE) r� ry rh r r r� r* r� r� r r r� r3 r4 r5 rl r� rv r| rD r� r r` ra r� r r r, ) r r� r6 r; r ZappendtoZqstringZ inner_valueZ semi_validr �tr� r r r � get_parameterk s� � � � � � � � r� c C sj t � }| �rfzt| �\}} |�|� W n� tjk r� } z�d}| d tkrVt| �\}} | sp|�|� | W Y �xS | d dkr�|dk r�|�|� |j�t�d�� n@t | �\}} |r�|g|dd�< |�|� |j�t�d� |��� W 5 d}~X Y nX | �rD| d dk�rD|d }d|_ t | �\}} |� |� |j�t�d� |��� | r|�t dd �� | d d� } q|S ) a! parameter *( ";" parameter ) That BNF is meant to indicate this routine should only be called after finding and handling the leading ';'. There is no corresponding rule in the formal RFC grammar, but it is more convenient for us for the set of parameters to be treated as its own TokenList. This is 'parse' routine because it consumes the remaining value, but it would never be called to parse a full header. Instead it is called to parse everything after the non-parameter value of a specific MIME header. Nr r] z parameter entry with no contentzinvalid parameter {!r}r� r� z)parameter with invalid trailing text {!r}r� r� )r� r� rh r r r3 r4 r r� rm r* rD r4 r )r Zmime_parametersr6 rb r; r� r r r �parse_mime_parameters� sJ � � �r� c C s� |rV|d dkrV|d t kr>| �t|d d�� |dd� }q t|�\}}| �|� q |s^dS | �tdd�� | �t|dd� �� dS )zBDo our best to find the parameters in an invalid MIME header r r] rF r� Nr� )r= rh r r? r� )Z tokenlistr r6 r r r �_find_mime_parameters- s r� c C s� t � }d}| s$|j�t�d�� |S zt| �\}} W n< tjk rp |j�t�d�| ��� t || � | Y S X |�|� | r�| d dkr�|j�t�d�� | r�t || � |S |j � � � � |_ |�tdd�� | dd � } zt| �\}} W n> tjk �r* |j�t�d �| ��� t || � | Y S X |�|� |j � � � � |_| �sP|S | d d k�r�|j�t�d �| ��� |` |`t || � |S |�td d �� |�t| dd � �� |S )z� maintype "/" subtype *( ";" parameter ) The maintype and substype are tokens. Theoretically they could be checked against the official IANA list + x-token, but we don't do that. Fz"Missing content type specificationz(Expected content maintype but found {!r}r r� zInvalid content typezcontent-type-separatorr� Nz'Expected content subtype but found {!r}r] z<Only parameters are valid after content type, but found {!r}r� )r� r rh r ri rs r r� r* r� r r� �lowerr� r r� r� )r ZctypeZrecoverr6 r r r �parse_content_type_header= sd � � � � �� r� c C s� t � }| s |j�t�d�� |S zt| �\}} W n< tjk rl |j�t�d�| ��� t || � | Y S X |�|� |j � � � � |_ | s�|S | d dkr�|j�t�d�| ��� t || � |S |�tdd�� |�t| dd� �� |S ) z* disposition-type *( ";" parameter ) zMissing content dispositionz+Expected content disposition but found {!r}r r] zCOnly parameters are valid after content disposition, but found {!r}r� r� N)r� r rh r ri rs r r� r* r� r r� r� r� r r� )r Z disp_headerr6 r r r � parse_content_disposition_headerv s: � � �� r� c C s� t � }| s |j�t�d�� |S zt| �\}} W n. tjk r^ |j�t�d�| ��� Y n X |�|� |j � � � � |_ | s�|S | r�|j�t�d�� | d t kr�|�t| d d�� | dd� } q�t| �\}} |�|� q�|S )z mechanism z!Missing content transfer encodingz1Expected content transfer encoding but found {!r}z*Extra text after content transfer encodingr rF r� N)r� r rh r ri rs r r� r* r r� r� r_ r= r r? )r Z cte_headerr6 r r r �&parse_content_transfer_encoding_header� s4 � � � r� c C sD d}| r@| d r@| d d t kr@| d d }| d d d� | d< |S )Nr r� )r )�linesZwspr r r � _steal_trailing_WSP_if_exists� s r� c C s� |j p tj}|jrdnd}dg}d}d}d}tdd�}t| �} | �r�| �d�} | |kr`|d8 }q>t| �} | jd kr�t | �t @ r�d }z| � |� |} W n6 t k r� t d d � | jD ��r�d } nd} d }Y nX | jdkr�t| |||� q>|�r�|�s�| j�spd}d}| j�rp| j|d�dt|j� � } |j| k�rpt| �|t|d � k�r^t|�}|�|� |d | 7 < q>t| d��s�t| �| } nt| |||| j| �}d}q>t| �|t|d � k�r�|d | 7 < q>| j�rt| �d |k�rt|�}|�s| �� �r|�|| � d}q>t| d��sNt| �}| j�sD|d7 }|�|� || } q>| j�rn|�sn| �d| � d }q>t|�}|�s�| �� �r�|�|| � q>|d | 7 < q>|j� |�|j S )zLReturn string of contents of parse_tree folded according to RFC rules. �utf-8r� r Nr F�wrap_as_ew_blockedr� r� Tc s s | ]}t |tj�V qd S r )r� r r� r r r r r# � s �z%_refold_parse_tree.<locals>.<genexpr>� unknown-8bitr� r7 r� rC ) Zmax_line_length�sys�maxsize�utf8r� r� r� r rD r� r: rC r� rZ r- �_fold_mime_parametersr1 rH r; r� r� r� rh rE � _fold_as_ewrI r0 �insertr% )Z parse_treer8 �maxlenr� r� �last_ewr� Z want_encodingZend_ew_not_allowedr� r2 �tstrr` Z encoded_part�newlineZnewpartsr r r r9 � s� � �� r9 c C s� |dk r<|r<t t|d |d� | ��} |d d|� |d< | d tkr�| d }| dd� } t|d �|krz|�t|�� |d |7 < d}| d tkr�| d }| dd� } |dkr�t|d �n|}|dkr�dn|} t| �d } | d |kr�t�d ��| �r�|t|d � } | | } | dk�r,|�d � q�| d| � } tj | | d �}t|�| }|dk�r�| dd� } tj | | d �}t|�| }�qR|d |7 < | t| �d� } | r�|�d � t|d �}q�|d |7 < |�r�|S dS ) a� Fold string to_encode into lines as encoded word, combining if allowed. Return the new value for last_ew, or None if ew_combine_allowed is False. If there is already an encoded word in the last line of lines (indicated by a non-None value for last_ew) and ew_combine_allowed is true, decode the existing ew, combine it with to_encode, and re-encode. Otherwise, encode to_encode. In either case, split to_encode as necessary so that the encoded segments fit within maxlen. Nr� r r� r r� r� � z3max_line_length is too small to fit an encoded wordrN )r` ) r r( r r� rh r� r r r rC )Z to_encoder� r� r� rI r` Z leading_wspZ trailing_wspZ new_last_ewZ encode_as� chrome_lenZremaining_spaceZ text_spaceZto_encode_wordZ encoded_wordZexcessr r r r� 1 sT � � r� c C s� | j D �]�\}}|d �� �d�s2|d d7 < |}d}z|�|� d}W n0 tk r| d}t�|�rtd}d}nd}Y nX |r�tjj |d |d �} d � ||| �} nd � |t |��} t |d �t | � d |k r�|d d | |d< qn"t | �d |k�r |� d| � qd} |d } |rt |�t t| �� d t | � } || d k�rLd}|| d }}|d|� }tjj |d |d �} t | �|k�r��q�|d 8 }�q\|� d� || | | �� d } | d 7 } ||d� }|�r|d d7 < �qqdS )a> Fold TokenList 'part' into the 'lines' list as mime parameters. Using the decoded list of parameters and values, format them according to the RFC rules, including using RFC2231 encoding if the value cannot be expressed in 'encoding' and/or the parameter+value is too long to fit within 'maxlen'. r� r] �strictFTr� r� r� r )Zsafer z {}*={}''{}r� r� rN r� r z''r� �N Nz {}*{}*={}{})r� r� r� rC r� r r� r� r� ro r* r r� rh r )r2 r� r� r� r� r r` Z error_handlerZencoding_requiredZ encoded_valuer� r� Z extra_chromer� Z splitpointZmaxchars�partialr r r r� r sn � � � r� )�r �rer� r� �stringr �operatorr Zemailr r r r r� r r3 r: r6 r� r= Z TSPECIALSrr Z ASPECIALSrw r} r �compile�VERBOSE� MULTILINEr$ r� r rL rR rU rW rX rZ r\ r] rb rm rn rq r{ r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r r� r r r r r r� rR rS r* r% r� r r �matchr. �findallr ro rt r{ r r r r" r( r+ r, r0 r1 r2 r4 r5 r7 r8 r9 r< r? rE rB rG rK rM rN rP rT rW rX rY r[ r\ r^ r_ r` ra rc rd rf rg rl rm rp rs rv ry r| r~ r� r� r� r� r� r� r� r� r� r9 r� r� r r r r �<module> s. E �C " !*$ V + � ��� 1C+ "&'/'&). 9% 7E D 49 /gA __pycache__/iterators.cpython-38.pyc 0000644 00000003602 15204103444 0013416 0 ustar 00 U e5dW � @ sL d Z dddgZddlZddlmZ dd� Zdd d�Zdd d�Zdd d �ZdS )z1Various types of useful iterators and generators.�body_line_iterator�typed_subpart_iterator�walk� N)�StringIOc c s. | V | � � r*| �� D ]}|�� E dH qdS )z�Walk over the message tree, yielding each subpart. The walk is performed in depth-first order. This method is a generator. N)� is_multipart� get_payloadr )�self�subpart� r �'/usr/lib64/python3.8/email/iterators.pyr s Fc c s6 | � � D ](}|j|d�}t|t�rt|�E dH qdS )z�Iterate over the parts, returning string payloads line-by-line. Optional decode (default False) is passed through to .get_payload(). )�decodeN)r r � isinstance�strr )�msgr r Zpayloadr r r r " s �textc c s8 | � � D ]*}|�� |kr|dks,|�� |kr|V qdS )z�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. N)r Zget_content_maintypeZget_content_subtype)r ZmaintypeZsubtyper r r r r - s c C s� |dkrt j}d|d }t|| �� d|d� |rJtd| �� |d� n t|d� | �� r|| �� D ]}t|||d |� qddS ) zA handy debugging aidN� � � )�end�filez [%s])r � )�sys�stdout�printZget_content_typeZget_default_typer r � _structure)r �fp�levelZinclude_defaultZtabr r r r r ; s r )F)r N)Nr F) �__doc__�__all__r �ior r r r r r r r r �<module> s � __pycache__/feedparser.cpython-38.opt-1.pyc 0000644 00000024374 15204103444 0014472 0 ustar 00 U e5d�X � @ s� d Z ddgZddlZddlmZ ddlmZ ddlmZ ddl m Z e� d �Z e� d �Z e� d �Ze� d �Ze� d �Zd ZdZe� ZG dd� de�ZG dd� d�ZG dd� de�ZdS )a FeedParser - An email feed parser. The feed parser implements an interface for incrementally parsing an email message, line by line. This has advantages for certain applications, such as those reading email messages off a socket. FeedParser.feed() is the primary interface for pushing new data into the parser. It returns when there's nothing more it can do with the available data. When you have no more data to push into the parser, call .close(). This completes the parsing and returns the root message object. The other advantage of this parser is that it will never raise a parsing exception. Instead, when it finds something unexpected, it adds a 'defect' to the current message. Defects are just instances that live on the message object's .defects attribute. � FeedParser�BytesFeedParser� N)�errors)�compat32)�deque)�StringIOz \r\n|\r|\nz (\r\n|\r|\n)z(\r\n|\r|\n)\Zz%^(From |[\041-\071\073-\176]*:|[\t ])� � c @ s` e Zd ZdZdd� Zdd� Zdd� Zdd � Zd d � Zd d � Z dd� Z dd� Z dd� Z dd� Z dS )�BufferedSubFileak A file-ish object that can have new data loaded into it. You can also push and pop line-matching predicates onto a stack. When the current predicate matches the current line, a false EOF response (i.e. empty string) is returned instead. This lets the parser adhere to a simple abstraction -- it parses until EOF closes the current message. c C s$ t dd�| _t� | _g | _d| _d S )Nr )�newlineF)r �_partialr �_lines� _eofstack�_closed��self� r �(/usr/lib64/python3.8/email/feedparser.py�__init__5 s zBufferedSubFile.__init__c C s | j �|� d S �N)r �append)r Zpredr r r �push_eof_matcher@ s z BufferedSubFile.push_eof_matcherc C s | j �� S r )r �popr r r r �pop_eof_matcherC s z BufferedSubFile.pop_eof_matcherc C s< | j �d� | �| j �� � | j �d� | j �� d| _d S )Nr T)r �seek� pushlines� readlines�truncater r r r r �closeF s zBufferedSubFile.closec C sL | j s| jrdS tS | j �� }t| j�D ] }||�r(| j �|� dS q(|S �Nr )r r � NeedMoreData�popleft�reversedr � appendleft)r �lineZateofr r r �readlineN s zBufferedSubFile.readlinec C s | j �|� d S r )r r# �r r$ r r r � unreadline` s zBufferedSubFile.unreadlinec C sx | j �|� d|kr d|kr dS | j �d� | j �� }| j �d� | j �� |d �d�sj| j �|�� � | �|� dS )z$Push some new data into this object.r � Nr ���)r �writer r r �endswithr r )r �data�partsr r r �pushe s zBufferedSubFile.pushc C s | j �|� d S r )r �extend)r �linesr r r r z s zBufferedSubFile.pushlinesc C s | S r r r r r r �__iter__} s zBufferedSubFile.__iter__c C s | � � }|dkrt�|S r )r% � StopIterationr& r r r �__next__� s zBufferedSubFile.__next__N)�__name__� __module__� __qualname__�__doc__r r r r r% r' r. r r1 r3 r r r r r - s r c @ s` e Zd ZdZded�dd�Zdd� Zdd � Zd d � Zd d � Z dd� Z dd� Z dd� Z dd� Z dS )r z A feed-style parser of email.N��policyc C s� || _ d| _|dkr<|jdkr2ddlm} || _qn|j| _n2|| _z|| j d� W n tk rl d| _Y nX t� | _g | _ | � � j | _ d| _ d| _d| _dS )a _factory is called with no arguments to create a new message obj The policy keyword specifies a policy object that controls a number of aspects of the parser's operation. The default policy maintains backward compatibility. FNr )�Messager8 T)r9 �_old_style_factoryZmessage_factoryZ email.messager: �_factory� TypeErrorr �_input� _msgstack� _parsegenr3 �_parse�_cur�_last� _headersonly)r r< r9 r: r r r r � s$ zFeedParser.__init__c C s d| _ d S )NT)rD r r r r �_set_headersonly� s zFeedParser._set_headersonlyc C s | j �|� | �� dS )z Push more data into the parser.N)r> r. � _call_parse�r r, r r r �feed� s zFeedParser.feedc C s& z | � � W n tk r Y nX d S r )rA r2 r r r r rF � s zFeedParser._call_parsec C sH | j �� | �� | �� }|�� dkrD|�� sDt�� }| j� ||� |S )z<Parse all remaining data and return the root message object.� multipart) r> r rF � _pop_message�get_content_maintypeZ is_multipartr Z!MultipartInvariantViolationDefectr9 � handle_defect)r �root�defectr r r r � s �zFeedParser.closec C sn | j r| �� }n| j| jd�}| jr<| j�� dkr<|�d� | jrR| jd �|� | j�|� || _|| _ d S )Nr8 zmultipart/digestzmessage/rfc822r) ) r; r< r9 rB �get_content_typeZset_default_typer? Zattachr rC )r �msgr r r � _new_message� s zFeedParser._new_messagec C s( | j �� }| j r | j d | _nd | _|S )Nr) )r? r rB )r �retvalr r r rJ � s zFeedParser._pop_messagec c s | � � g }| jD ]Z}|tkr&tV qt�|�sbt�|�s^t�� }| j� | j |� | j� |� qn|� |� q| � |� | jr�g }| j�� }|tkr�tV q�|dkr�q�|� |� q�| j �t�|�� d S | j �� dk�r�| j�tj� | �� D ] }|tk�rtV q� �q q�| �� }| j�� | j�� }|tk�rDtV �q �qD�q | j�� }|tk�rjtV �qD�qj�qD|dk�rx�q�| j� |� q�d S | j �� dk�r�| �� D ] }|tk�r�tV �q� �qĐq�| �� d S | j �� dk�r�| j �� }|d k�rRt�� }| j� | j |� g }| jD ]$}|tk�r.tV �q|� |� �q| j �t�|�� d S t| j � dd��� � dk�r�t� � }| j� | j |� d| }t � d t �!|� d �} d } g } d } d } | j�� }|tk�r�tV �q�|dk�r�q�| �|�}|�r�|�"d ��rd } |�"d�} �q�| �rr| �r^| d }t#�$|�}|�rP|d t%|�"d�� � | d< t�| �| j _&d } | j� |� �q�| j�� }|tk�r�tV �qr| �|�}|�sr| j� |� �q��qr| j�| j� | �� D ] }|tk�r�tV �q� �q�q�| j'�� dk�rT| j'j(}|dk�rd | j'_(n:|d k �r�t#�$|�}|�r�t%|�"d��}|d | � | j'_(nD| j'j)}t*|t��r�t#�$|�}|�r�|d t%|�"d�� � }|| j'_)| j�� | �� | j | _'n | � |� �q�| �r*t�+� }| j� | j |� | j �t�| �� g }| jD ]}|tk�r�tV �q��q�t�|�| j _(d S | �sLt�,� }| j� | j |� d S | �rZdg}ng }| jD ]$}|tk�r|tV �qd|� |� �qd|�r�|d }t-�|�}|�r�|t%|�"d��d � |d< t�|�| j _(d S g }| jD ]$}|tk�r�tV �q�|� |� �q�| j �t�|�� d S )Nr zmessage/delivery-status�messagerI zcontent-transfer-encoding�8bit)Z7bitrT Zbinaryz--z(?P<sep>z4)(?P<end>--)?(?P<ws>[ \t]*)(?P<linesep>\r\n|\r|\n)?$TF�end�linesepr) r ).rQ r> r �headerRE�match�NLCREr Z MissingHeaderBodySeparatorDefectr9 rL rB r' r �_parse_headersrD r% Z set_payload� EMPTYSTRING�joinrO r r@ rJ r rK Z get_boundaryZNoBoundaryInMultipartDefect�str�get�lowerZ-InvalidMultipartContentTransferEncodingDefect�re�compile�escape�group� NLCRE_eol�search�len�preamblerC �epilogueZ_payload� isinstanceZStartBoundaryNotFoundDefectZCloseBoundaryNotFoundDefect� NLCRE_bol)r Zheadersr$ rN r0 rR rP �boundaryZ separatorZ boundaryreZcapturing_preamblerg rV Zclose_boundary_seen�moZlastlineZeolmorh rU Zpayload� firstlineZbolmor r r r@ � s` � �� zFeedParser._parsegenc C sX d}g }t |�D �]&\}}|d dkrR|sFt�|�}| j�| j|� q|�|� q|rt| jj| j�|�� dg }}|� d�r�|dkr�t � |�}|r�|d t |� d�� � }| j�|� qn<|t |�d kr�| j�|� d S t�|�}| jj�|� q|�d�}|dk�r&t�d�}| jj�|� q|d |� }|g}q|�rT| jj| j�|�� d S )Nr r z zFrom � �:zMissing header name.)� enumerater Z#FirstHeaderLineIsContinuationDefectr9 rL rB r Zset_rawZheader_source_parse� startswithrd re rf rc Z set_unixfromr> r' Z MisplacedEnvelopeHeaderDefectZdefects�findZInvalidHeaderDefect) r r0 Z lastheaderZ lastvalue�linenor$ rN rl �ir r r rZ � sF zFeedParser._parse_headers)N)r4 r5 r6 r7 r r rE rH rF r rQ rJ r@ rZ r r r r r � s ~c s e Zd ZdZ� fdd�Z� ZS )r z(Like FeedParser, but feed accepts bytes.c s t � �|�dd�� d S )N�ascii�surrogateescape)�superrH �decoderG �� __class__r r rH s zBytesFeedParser.feed)r4 r5 r6 r7 rH � __classcell__r r ry r r s )r7 �__all__r` Zemailr Zemail._policybaser � collectionsr �ior ra rY rj rd Z NLCRE_crackrW r[ �NL�objectr r r r r r r r �<module> s( [ __pycache__/header.cpython-38.pyc 0000644 00000040071 15204103444 0012633 0 ustar 00 U e5d&^ � @ s� d Z dddgZddlZddlZddlZddlZddlmZ ddlm Z e j Z dZ d Z d Zd Zd Zd ZdZe d�Ze d�Ze�dejejB �Ze�d�Ze�d�Zejj Z dd� Z ddd�Z G dd� d�Z G dd� d�Z G dd� de!�Z"dS ) z+Header encoding and decoding functionality.�Header� decode_header� make_header� N)�HeaderParseError)�charset� � � z � �N z �us-asciizutf-8ai =\? # literal =? (?P<charset>[^?]*?) # non-greedy up to the next ? is the charset \? # literal ? (?P<encoding>[qQbB]) # either a "q" or a "b", case insensitive \? # literal ? (?P<encoded>.*?) # non-greedy up to the next ?= is the encoded string \?= # literal ?= z[\041-\176]+:$z \n[^ \t]+:c C s� t | d�rdd� | jD �S t�| �s.| dfgS g }| �� D ]�}t�|�}d}|r:|�d�}|rj|�� }d}|r~|�|ddf� |rL|�d�� � }|�d�� � }|�d�}|�|||f� qLq:g } t |�D ]J\} } | dkr�| d r�|| d d r�|| d d � � r�| �| d � q�t | �D ] } || = �q g } |D ]�\}}}|dk�rV| �||f� n�|d k�r|t j�|�}| �||f� n~|d k�r�t|�d }|�r�|d dd | � 7 }zt j�|�}W n tjk �r� td��Y nX | �||f� n td| ���q2g }d }}| D ]v\}}t|t��r,t|d�}|dk�r@|}|}nB||k�rb|�||f� |}|}n |dk�rz|t| 7 }n||7 }�q|�||f� |S )a; Decode a message header value without converting charset. Returns a list of (string, charset) pairs containing each of the decoded parts of the header. Charset is None for non-encoded parts of the header, otherwise a lower-case string containing the name of the character set specified in the encoded string. header may be a string that may or may not contain RFC2047 encoded words, or it may be a Header object. An email.errors.HeaderParseError may be raised when certain decoding error occurs (e.g. a base64 decoding exception). �_chunksc S s( g | ] \}}t �|t|��t|�f�qS � )�_charsetZ_encode�str)�.0�stringr r r �$/usr/lib64/python3.8/email/header.py� <listcomp>M s �z!decode_header.<locals>.<listcomp>NTr F� � �q�b� z===zBase64 decoding errorzUnexpected encoding: zraw-unicode-escape)�hasattrr �ecre�search� splitlines�split�pop�lstrip�append�lower� enumerate�isspace�reversed�email� quoprimimeZ header_decode�lenZ base64mime�decode�binascii�Errorr �AssertionError� isinstancer �bytes�BSPACE)�headerZwords�line�parts�firstZ unencodedr �encodingZencodedZdroplist�n�w�dZ decoded_wordsZencoded_stringZwordZpaderrZ collapsedZ last_word� last_charsetr r r r = s| � 4 c C sF t |||d�}| D ].\}}|dk r4t|t�s4t|�}|�||� q|S )a� Create a Header from a sequence of pairs as returned by decode_header() decode_header() takes a header value string and returns a sequence of pairs of the format (decoded_string, charset) where charset is the string name of the character set. This function takes one of those sequence of pairs and returns a Header instance. Optional maxlinelen, header_name, and continuation_ws are as in the Header constructor. )� maxlinelen� header_name�continuation_wsN)r r- �Charsetr! )Z decoded_seqr9 r: r; �h�sr r r r r � s � c @ sJ e Zd Zddd�Zdd� Zdd � Zdd d �Zd d � Zddd�Zdd� Z dS )r Nr �strictc C s| |dkrt }nt|t�s t|�}|| _|| _g | _|dk rH| �|||� |dkrTt}|| _|dkrjd| _ nt |�d | _ dS )aD Create a MIME-compliant header that can contain many character sets. Optional s is the initial header value. If None, the initial header value is not set. You can later append to the header with .append() method calls. s may be a byte string or a Unicode string, but see the .append() documentation for semantics. Optional charset serves two purposes: it has the same meaning as the charset argument to the .append() method. It also sets the default character set for all subsequent .append() calls that omit the charset argument. If charset is not provided in the constructor, the us-ascii charset is used both as s's initial charset and as the default for subsequent .append() calls. The maximum line length can be specified explicitly via maxlinelen. For splitting the first line to a shorter value (to account for the field header which isn't included in s, e.g. `Subject') pass in the name of the field in header_name. The default maxlinelen is 78 as recommended by RFC 2822. continuation_ws must be RFC 2822 compliant folding whitespace (usually either a space or a hard tab) which will be prepended to continuation lines. errors is passed through to the .append() call. Nr r ) �USASCIIr- r< r �_continuation_wsr r! � MAXLINELEN� _maxlinelen� _headerlenr( )�selfr> r r9 r: r; �errorsr r r �__init__� s zHeader.__init__c C s� | � � g }d}d}| jD ]�\}}|}|tjkrH|�dd�}|�dd�}|r�|o\| �|d �}|dkr�|dkr�|s�|�t� d}n|dkr�|s�|�t� |o�| �|d �}|}|�|� qt � |�S )z&Return the string value of the header.N�ascii�surrogateescape�replacer �Nr ���) � _normalizer r � UNKNOWN8BIT�encoder) � _nonctextr! �SPACE� EMPTYSTRING�join) rE Zuchunks�lastcs� lastspacer r ZnextcsZoriginal_bytes�hasspacer r r �__str__� s* zHeader.__str__c C s |t | �kS �N)r )rE �otherr r r �__eq__ s z Header.__eq__c C s� |dkr| j }nt|t�s"t|�}t|t�sZ|jp4d}|t jkrN|�dd�}n |�||�}|jpbd}|t jkr�z|�||� W n" t k r� |dkr�� t }Y nX | j � ||f� dS )a. Append a string to the MIME header. Optional charset, if given, should be a Charset instance or the name of a character set (which will be converted to a Charset instance). A value of None (the default) means that the charset given in the constructor is used. s may be a byte string or a Unicode string. If it is a byte string (i.e. isinstance(s, str) is false), then charset is the encoding of that byte string, and a UnicodeError will be raised if the string cannot be decoded with that charset. If s is a Unicode string, then charset is a hint specifying the character set of the characters in the string. In either case, when producing an RFC 2822 compliant header using RFC 2047 rules, the string will be encoded using the output codec of the charset. If the string cannot be encoded to the output codec, a UnicodeError will be raised. Optional `errors' is passed as the errors argument to the decode call if s is a byte string. Nr rI ) r r- r< r Z input_codecrN r) Z output_codecrO �UnicodeEncodeError�UTF8r r! )rE r> r rF Z input_charsetZoutput_charsetr r r r! s$ z Header.appendc C s |� � p|dkS )z=True if string s is not a ctext character of RFC822. )�(�)�\)r$ )rE r> r r r rP 4 s zHeader._nonctext�;, r c C s� | � � |dkr| j}|dkr"d}t| j|| j|�}d}d }}| jD �] \}} |dk r�|oh| �|d �}|dkr�|r~| dkr�|�� n| dkr�|s�|�� |o�| �|d �}| }d}|�� } | r�|� d| d | � n|� dd| � | dd� D ]`} |� � | j dk �r"|� | jd | � � | � q�| � � } | dt | �t | � � } |� | | | � q�t | �dkrF|� � qF| j�rx|�� |�|�}t�|��r�td �|���|S ) a� Encode a message header into an RFC-compliant format. There are many issues involved in converting a given string for use in an email header. Only certain character sets are readable in most email clients, and as header strings can only contain a subset of 7-bit ASCII, care must be taken to properly convert and encode (with Base64 or quoted-printable) header strings. In addition, there is a 75-character length limit on any given encoded header field, so line-wrapping must be performed, even with double-byte character sets. Optional maxlinelen specifies the maximum length of each generated line, exclusive of the linesep string. Individual lines may be longer than maxlinelen if a folding point cannot be found. The first line will be shorter by the length of the header name plus ": " if a header name was specified at Header construction time. The default value for maxlinelen is determined at header construction time. Optional splitchars is a string containing characters which should be given extra weight by the splitting algorithm during normal header wrapping. This is in very rough support of RFC 2822's `higher level syntactic breaks': split points preceded by a splitchar are preferred during line splitting, with the characters preferred in the order in which they appear in the string. Space and tab may be included in the string to indicate whether preference should be given to one over the other as a split point when other split chars do not appear in the line being split. Splitchars does not affect RFC 2047 encoded lines. Optional linesep is a string to be used to separate the lines of the value. The default value is the most useful for typical Python applications, but it can be set to \r\n to produce RFC-compliant line separators when needed. Nr i@B rK rL Fr r r z8header value appears to contain an embedded header: {!r})rM rC �_ValueFormatterrD rA r rP �add_transitionr �feed�newline�header_encodingr r( �_str�_embedded_headerr r �format)rE � splitcharsr9 �linesepZ formatterrT rV rU r r �linesr1 Zsline�fws�valuer r r rO 9 sZ ! � � �z Header.encodec C sx g }d }g }| j D ]B\}}||kr.|�|� q|d k rJ|�t�|�|f� |g}|}q|rn|�t�|�|f� || _ d S rX )r r! rQ rS )rE Zchunksr8 Z last_chunkr r r r r rM � s zHeader._normalize)NNNNr r? )Nr? )r` Nr ) �__name__� __module__� __qualname__rG rW rZ r! rP rO rM r r r r r � s � / + Pc @ sT e Zd Zdd� Zdd� Zdd� Zdd� Zd d � Zd d � Zd d� Z dd� Z dd� Z dS )ra c C s0 || _ || _t|�| _|| _g | _t|�| _d S rX )�_maxlenrA r( �_continuation_ws_len� _splitchars�_lines� _Accumulator� _current_line)rE Z headerlen�maxlenr; ri r r r rG � s z_ValueFormatter.__init__c C s | � � |�| j�S rX )rd rS rt )rE rj r r r rf � s z_ValueFormatter._strc C s | � t�S rX )rf �NL�rE r r r rW � s z_ValueFormatter.__str__c C sv | j �� }|dkr | j j|� t| j �dkrh| j �� rV| jrV| jd t| j �7 < n| j�t| j �� | j �� d S )N)r r r rL ) rv r �pushr( � is_onlywsrt r r! �reset)rE Z end_of_liner r r rd � s z_ValueFormatter.newlinec C s | j �dd� d S )Nr r )rv rz ry r r r rb � s z _ValueFormatter.add_transitionc C s� |j d kr | �||| j� d S |�|| �� �}z|�d�}W n tk rR Y d S X |d k rh| �||� z |�� }W n tk r� Y d S X | �� | j � | j |� |D ]}| j � | j | � q�d S �Nr )re � _ascii_splitrs Zheader_encode_lines� _maxlengthsr � IndexError� _append_chunkrd rv rz rA rt r! )rE rl r r Z encoded_linesZ first_line� last_liner1 r r r rc � s$ z_ValueFormatter.feedc c s& | j t| j� V | j | j V qd S rX )rq r( rv rr ry r r r r � s z_ValueFormatter._maxlengthsc C sf t �dt d || �}|d r0dg|d d�< n |�d� tt|�gd � D ]\}}| �||� qLd S )Nz([z]+)r r r )�rer �FWSr �zip�iterr� )rE rl r ri r2 �partr r r r~ � s z _ValueFormatter._ascii_splitc C s | j �||� t| j �| jk�r| jD ]v}t| j �� d dd�D ]T}|�� rn| j | d }|rn|d |krn q�| j |d d }|r@|d |kr@ q�q@q& q�q&| j �� \}}| j j dkr�| � � |s�d}| j �||� d S | j � |�}| j � t| j �� | j �|� d S )Nr r rL r )rv rz r( rq rs �range� part_countr$ r � _initial_sizerd �pop_fromrt r! r r| )rE rl r Zch�iZprevpartr� Z remainderr r r r� � s. z _ValueFormatter._append_chunkN) rn ro rp rG rf rW rd rb rc r r~ r� r r r r ra � s %ra c sj e Zd Zd� fdd� Zdd� Zddd�Z� fdd �Zd d � Zd d � Zddd�Z dd� Z � fdd�Z � Z S )ru r c s || _ t� �� d S rX )r� �superrG )rE Z initial_size�� __class__r r rG s z_Accumulator.__init__c C s | � ||f� d S rX )r! )rE rl r r r r rz # s z_Accumulator.pushc C s | |d � }g | |d �< |S rX r )rE r� Zpoppedr r r r� & s z_Accumulator.pop_fromc s | � � dkrdS t� �� S )Nr )r r )r� r� r ry r� r r r + s z_Accumulator.popc C s t dd� | D �| j�S )Nc s s" | ]\}}t |�t |� V qd S rX )r( �r rl r� r r r � <genexpr>1 s z'_Accumulator.__len__.<locals>.<genexpr>)�sumr� ry r r r �__len__0 s �z_Accumulator.__len__c C s t �dd� | D ��S )Nc s s | ]\}}t �||f�V qd S rX �rR rS r� r r r r� 5 s �z'_Accumulator.__str__.<locals>.<genexpr>r� ry r r r rW 4 s �z_Accumulator.__str__Nc C s" |d kr g }|| d d �< d| _ d S r} )r� )rE Zstartvalr r r r| 8 s z_Accumulator.resetc C s | j dko| pt| ��� S r} )r� r r$ ry r r r r{ > s z_Accumulator.is_onlywsc s t � �� S rX )r� r� ry r� r r r� A s z_Accumulator.part_count)r )r )N) rn ro rp rG rz r� r r� rW r| r{ r� � __classcell__r r r� r ru s ru )NNr )#�__doc__�__all__r� r* Zemail.quoprimimer& Zemail.base64mimeZ email.errorsr r r r< rx rQ r/ ZSPACE8rR rB r� r@ r\ �compile�VERBOSE� MULTILINEr Zfcrerg r' Z _max_appendr r r ra �listru r r r r �<module> sF � � _ � k __pycache__/charset.cpython-38.opt-2.pyc 0000644 00000011747 15204103444 0014004 0 ustar 00 U e5d�B � @ sr d dddgZ ddlmZ ddlZddlZddlmZ ddlmZ d Z d Z d Z d Z d Z dZdZe e dfe e dfe e dfe e dfe e dfe e dfe e dfe e dfe e dfe e dfe e dfe e dfde e dfe e dfe ddfe ddfe ddfe e dfe e dfd�Zddddddddddddddddd d d d d d d d d!�Zd"d#dd$�Zd+d%d�Zd&d� Zd'd� Zd(d)� ZG d*d � d �ZdS ),�Charset� add_alias� add_charset� add_codec� )�partialN)�errors)�encode_7or8bit� � � � �us-asciiz unknown-8bit� )NNN� iso-2022-jp�utf-8)� iso-8859-1� iso-8859-2� iso-8859-3� iso-8859-4� iso-8859-9� iso-8859-10� iso-8859-13� iso-8859-14� iso-8859-15� iso-8859-16z windows-1252Zvisciir �big5�gb2312�euc-jp� shift_jisr zkoi8-rr r r r r r r r r r r zks_c_5601-1987r zeuc-kr)�latin_1zlatin-1Zlatin_2zlatin-2Zlatin_3zlatin-3Zlatin_4zlatin-4Zlatin_5zlatin-5Zlatin_6zlatin-6Zlatin_7zlatin-7Zlatin_8zlatin-8Zlatin_9zlatin-9Zlatin_10zlatin-10�cp949�euc_jp�euc_kr�ascii� eucgb2312_cn�big5_tw)r r r c C s" |t krtd��|||ft| < d S )Nz!SHORTEST not allowed for body_enc)�SHORTEST� ValueError�CHARSETS)�charsetZ header_encZbody_enc�output_charset� r+ �%/usr/lib64/python3.8/email/charset.pyr m s c C s |t | < d S �N)�ALIASES)�aliasZ canonicalr+ r+ r, r � s c C s |t | < d S r- )� CODEC_MAP)r) Z codecnamer+ r+ r, r � s c C s" |t kr| �dd�S | �|�S d S )Nr# �surrogateescape)� UNKNOWN8BIT�encode)�string�codecr+ r+ r, �_encode� s r6 c @ sX e Zd Zefdd�Zdd� Zdd� Zdd� Zd d � Zd d � Z d d� Z dd� Z dd� Z dS )r c C s� z$t |t�r|�d� n t|d�}W n tk rB t�|��Y nX |�� }t�||�| _ t �| j t t d f�\}}}|s~| j }|| _ || _t�||�| _t�| j | j �| _t�| j| j�| _d S )Nr# )� isinstance�strr3 � UnicodeErrorr Z CharsetError�lowerr. �get� input_charsetr( r& �BASE64�header_encoding� body_encodingr* r0 Z input_codec� output_codec)�selfr< ZhencZbencZconvr+ r+ r, �__init__� s, � ��zCharset.__init__c C s | j �� S r- )r< r: �rA r+ r+ r, �__repr__� s zCharset.__repr__c C s t | �t |��� kS r- )r8 r: )rA �otherr+ r+ r, �__eq__� s zCharset.__eq__c C s$ | j tkrdS | j tkr dS tS d S )Nzquoted-printable�base64)r? �QPr= r rC r+ r+ r, �get_body_encoding� s zCharset.get_body_encodingc C s | j p | jS r- )r* r< rC r+ r+ r, �get_output_charset s zCharset.get_output_charsetc C s6 | j pd}t||�}| �|�}|d kr*|S |�||�S )Nr )r@ r6 � _get_encoder� header_encode)rA r4 r5 � header_bytes�encoder_moduler+ r+ r, rL s zCharset.header_encodec C s | j pd}t||�}| �|�}t|j|d�}| �� }t|�t }g } g } t|�| } |D ]�} | � | � t � | �} |� t| |��}|| krX| � � | s�| s�| � d � n.| r�dnd}t � | �}t||�}| � ||�� | g} t|�| } qXt � | �}t||�}| � ||�� | S )Nr )r) � r )r@ r6 rK r rL rJ �len�RFC2047_CHROME_LEN�next�append� EMPTYSTRING�join� header_length�pop)rA r4 Z maxlengthsr5 rM rN �encoderr) Zextra�linesZ current_line�maxlen� characterZ this_lineZlengthZ separatorZ joined_liner+ r+ r, �header_encode_lines* s6 zCharset.header_encode_linesc C s` | j tkrtjS | j tkr tjS | j tkrXtj�|�}tj�|�}||k rPtjS tjS nd S d S r- )r> r= �email� base64mimerH � quoprimimer& rV )rA rM Zlen64Zlenqpr+ r+ r, rK h s zCharset._get_encoderc C s� |s|S | j tkr4t|t�r(|�| j�}tj�|�S | j t krjt|t�rT|�| j�}|� d�}tj �|�S t|t�r�|�| j�� d�}|S d S )N�latin1r# ) r? r= r7 r8 r3 r* r] r^ � body_encoderH �decoder_ )rA r4 r+ r+ r, ra w s zCharset.body_encodeN) �__name__� __module__� __qualname__�DEFAULT_CHARSETrB rD rF rI rJ rL r\ rK ra r+ r+ r+ r, r � s , !>)NNN)�__all__� functoolsr Zemail.base64mimer] Zemail.quoprimimer Zemail.encodersr rH r= r& rQ rf r2 rT r( r. r0 r r r r6 r r+ r+ r+ r, �<module> s� � � � � __pycache__/encoders.cpython-38.pyc 0000644 00000003116 15204103444 0013204 0 ustar 00 U e5d� � @ sT d Z ddddgZddlmZ ddlmZ dd � Zd d� Z d d� Z d d� Z d d� Z dS )z Encodings and related functions.�encode_7or8bit� encode_base64� encode_noop� encode_quopri� )� encodebytes)� encodestringc C s t | dd�}|�dd�S )NT)Z quotetabs� s =20)� _encodestring�replace)�s�enc� r �&/usr/lib64/python3.8/email/encoders.py�_qencode s r c C s0 | j dd�}tt|�d�}| �|� d| d< dS )zlEncode the message's payload in Base64. Also, add an appropriate Content-Transfer-Encoding header. T��decode�ascii�base64�Content-Transfer-EncodingN)� get_payload�str�_bencode� set_payload��msg�origZencdatar r r r s c C s* | j dd�}t|�}| �|� d| d< dS )zvEncode the message's payload in quoted-printable. Also, add an appropriate Content-Transfer-Encoding header. Tr zquoted-printabler N)r r r r r r r r & s c C sX | j dd�}|dkr d| d< dS z|�d� W n tk rJ d| d< Y n X d| d< dS )z9Set the Content-Transfer-Encoding header to 7bit or 8bit.Tr NZ7bitr r Z8bit)r r � UnicodeError)r r r r r r 2 s c C s dS )z Do nothing.Nr )r r r r r D s N) �__doc__�__all__r r r �quoprir r r r r r r r r r r �<module> s � __pycache__/errors.cpython-38.opt-1.pyc 0000644 00000013423 15204103444 0013657 0 ustar 00 U e5d? � @ s� d Z G dd� de�ZG dd� de�ZG dd� de�ZG dd� de�ZG d d � d ee�ZG d d � d e�ZG d d� de �Z G dd� de �Z G dd� de �Z G dd� de �Z G dd� de �ZG dd� de �ZG dd� de �ZeZG dd � d e �ZG d d � d e �ZG d d � d e �ZG d!d"� d"e �ZG d#d$� d$e �ZG d%d&� d&e �ZG d'd(� d(e �ZG d)d*� d*e�ZG d+d,� d,e�ZG d-d.� d.e�ZG d/d0� d0e�Z G d1d2� d2e�Z d3S )4z email package exception classes.c @ s e Zd ZdZdS )� MessageErrorz+Base class for errors in the email package.N��__name__� __module__� __qualname__�__doc__� r r �$/usr/lib64/python3.8/email/errors.pyr s r c @ s e Zd ZdZdS )�MessageParseErrorz&Base class for message parsing errors.Nr r r r r r s r c @ s e Zd ZdZdS )�HeaderParseErrorz Error while parsing headers.Nr r r r r r s r c @ s e Zd ZdZdS )� BoundaryErrorz#Couldn't find terminating boundary.Nr r r r r r s r c @ s e Zd ZdZdS )�MultipartConversionErrorz(Conversion to a multipart is prohibited.Nr r r r r r s r c @ s e Zd ZdZdS )� CharsetErrorz An illegal charset was given.Nr r r r r r s r c s" e Zd ZdZd� fdd� Z� ZS )� MessageDefectz Base class for a message defect.Nc s |d k rt � �|� || _d S �N)�super�__init__�line)�selfr �� __class__r r r $ s zMessageDefect.__init__)N�r r r r r � __classcell__r r r r r ! s r c @ s e Zd ZdZdS )�NoBoundaryInMultipartDefectzBA message claimed to be a multipart but had no boundary parameter.Nr r r r r r ) s r c @ s e Zd ZdZdS )�StartBoundaryNotFoundDefectz+The claimed start boundary was never found.Nr r r r r r , s r c @ s e Zd ZdZdS )�CloseBoundaryNotFoundDefectzEA start boundary was found, but not the corresponding close boundary.Nr r r r r r / s r c @ s e Zd ZdZdS )�#FirstHeaderLineIsContinuationDefectz;A message had a continuation line as its first header line.Nr r r r r r 2 s r c @ s e Zd ZdZdS )� MisplacedEnvelopeHeaderDefectz?A 'Unix-from' header was found in the middle of a header block.Nr r r r r r 5 s r c @ s e Zd ZdZdS )� MissingHeaderBodySeparatorDefectzEFound line with no leading whitespace and no colon before blank line.Nr r r r r r 8 s r c @ s e Zd ZdZdS )�!MultipartInvariantViolationDefectz?A message claimed to be a multipart but no subparts were found.Nr r r r r r = s r c @ s e Zd ZdZdS )�-InvalidMultipartContentTransferEncodingDefectzEAn invalid content transfer encoding was set on the multipart itself.Nr r r r r r @ s r c @ s e Zd ZdZdS )�UndecodableBytesDefectz0Header contained bytes that could not be decodedNr r r r r r C s r c @ s e Zd ZdZdS )�InvalidBase64PaddingDefectz/base64 encoded sequence had an incorrect lengthNr r r r r r! F s r! c @ s e Zd ZdZdS )� InvalidBase64CharactersDefectz=base64 encoded sequence had characters not in base64 alphabetNr r r r r r" I s r" c @ s e Zd ZdZdS )�InvalidBase64LengthDefectz4base64 encoded sequence had invalid length (1 mod 4)Nr r r r r r# L s r# c s e Zd ZdZ� fdd�Z� ZS )� HeaderDefectz Base class for a header defect.c s t � j||� d S r )r r )r �args�kwr r r r T s zHeaderDefect.__init__r r r r r r$ Q s r$ c @ s e Zd ZdZdS )�InvalidHeaderDefectz+Header is not valid, message gives details.Nr r r r r r' W s r' c @ s e Zd ZdZdS )�HeaderMissingRequiredValuez(A header that must have a value had noneNr r r r r r( Z s r( c s( e Zd ZdZ� fdd�Zdd� Z� ZS )�NonPrintableDefectz8ASCII characters outside the ascii-printable range foundc s t � �|� || _d S r )r r �non_printables)r r* r r r r ` s zNonPrintableDefect.__init__c C s d� | j�S )Nz6the following ASCII non-printables found in header: {})�formatr* )r r r r �__str__d s �zNonPrintableDefect.__str__)r r r r r r, r r r r r r) ] s r) c @ s e Zd ZdZdS )�ObsoleteHeaderDefectz0Header uses syntax declared obsolete by RFC 5322Nr r r r r r- h s r- c @ s e Zd ZdZdS )�NonASCIILocalPartDefectz(local_part contains non-ASCII charactersNr r r r r r. k s r. N) r � Exceptionr r r r � TypeErrorr r � ValueErrorr r r r r r r ZMalformedHeaderDefectr r r r! r" r# r$ r' r( r) r- r. r r r r �<module> s4 __pycache__/errors.cpython-38.opt-2.pyc 0000644 00000010573 15204103444 0013663 0 ustar 00 U e5d? � @ s� G d d� de �ZG dd� de�ZG dd� de�ZG dd� de�ZG dd � d ee�ZG d d � d e�ZG d d � d e�Z G dd� de �Z G dd� de �Z G dd� de �Z G dd� de �Z G dd� de �ZG dd� de �ZeZG dd� de �ZG d d � d e �ZG d d � d e �ZG d d!� d!e �ZG d"d#� d#e �ZG d$d%� d%e �ZG d&d'� d'e �ZG d(d)� d)e�ZG d*d+� d+e�ZG d,d-� d-e�ZG d.d/� d/e�ZG d0d1� d1e�Z d2S )3c @ s e Zd ZdS )� MessageErrorN��__name__� __module__� __qualname__� r r �$/usr/lib64/python3.8/email/errors.pyr s r c @ s e Zd ZdS )�MessageParseErrorNr r r r r r s r c @ s e Zd ZdS )�HeaderParseErrorNr r r r r r s r c @ s e Zd ZdS )� BoundaryErrorNr r r r r r s r c @ s e Zd ZdS )�MultipartConversionErrorNr r r r r r s r c @ s e Zd ZdS )� CharsetErrorNr r r r r r s r c s e Zd Zd� fdd� Z� ZS )� MessageDefectNc s |d k rt � �|� || _d S �N)�super�__init__�line)�selfr �� __class__r r r $ s zMessageDefect.__init__)N�r r r r � __classcell__r r r r r ! s r c @ s e Zd ZdS )�NoBoundaryInMultipartDefectNr r r r r r ) s r c @ s e Zd ZdS )�StartBoundaryNotFoundDefectNr r r r r r , s r c @ s e Zd ZdS )�CloseBoundaryNotFoundDefectNr r r r r r / s r c @ s e Zd ZdS )�#FirstHeaderLineIsContinuationDefectNr r r r r r 2 s r c @ s e Zd ZdS )� MisplacedEnvelopeHeaderDefectNr r r r r r 5 s r c @ s e Zd ZdS )� MissingHeaderBodySeparatorDefectNr r r r r r 8 s r c @ s e Zd ZdS )�!MultipartInvariantViolationDefectNr r r r r r = s r c @ s e Zd ZdS )�-InvalidMultipartContentTransferEncodingDefectNr r r r r r @ s r c @ s e Zd ZdS )�UndecodableBytesDefectNr r r r r r C s r c @ s e Zd ZdS )�InvalidBase64PaddingDefectNr r r r r r F s r c @ s e Zd ZdS )� InvalidBase64CharactersDefectNr r r r r r! I s r! c @ s e Zd ZdS )�InvalidBase64LengthDefectNr r r r r r" L s r" c s e Zd Z� fdd�Z� ZS )� HeaderDefectc s t � j||� d S r )r r )r �args�kwr r r r T s zHeaderDefect.__init__r r r r r r# Q s r# c @ s e Zd ZdS )�InvalidHeaderDefectNr r r r r r& W s r& c @ s e Zd ZdS )�HeaderMissingRequiredValueNr r r r r r' Z s r' c s$ e Zd Z� fdd�Zdd� Z� ZS )�NonPrintableDefectc s t � �|� || _d S r )r r �non_printables)r r) r r r r ` s zNonPrintableDefect.__init__c C s d� | j�S )Nz6the following ASCII non-printables found in header: {})�formatr) )r r r r �__str__d s �zNonPrintableDefect.__str__)r r r r r+ r r r r r r( ] s r( c @ s e Zd ZdS )�ObsoleteHeaderDefectNr r r r r r, h s r, c @ s e Zd ZdS )�NonASCIILocalPartDefectNr r r r r r- k s r- N) � Exceptionr r r r � TypeErrorr r � ValueErrorr r r r r r r ZMalformedHeaderDefectr r r r r! r" r# r& r' r( r, r- r r r r �<module> s2 __pycache__/encoders.cpython-38.opt-1.pyc 0000644 00000003116 15204103444 0014143 0 ustar 00 U e5d� � @ sT d Z ddddgZddlmZ ddlmZ dd � Zd d� Z d d� Z d d� Z d d� Z dS )z Encodings and related functions.�encode_7or8bit� encode_base64� encode_noop� encode_quopri� )� encodebytes)� encodestringc C s t | dd�}|�dd�S )NT)Z quotetabs� s =20)� _encodestring�replace)�s�enc� r �&/usr/lib64/python3.8/email/encoders.py�_qencode s r c C s0 | j dd�}tt|�d�}| �|� d| d< dS )zlEncode the message's payload in Base64. Also, add an appropriate Content-Transfer-Encoding header. T��decode�ascii�base64�Content-Transfer-EncodingN)� get_payload�str�_bencode� set_payload��msg�origZencdatar r r r s c C s* | j dd�}t|�}| �|� d| d< dS )zvEncode the message's payload in quoted-printable. Also, add an appropriate Content-Transfer-Encoding header. Tr zquoted-printabler N)r r r r r r r r & s c C sX | j dd�}|dkr d| d< dS z|�d� W n tk rJ d| d< Y n X d| d< dS )z9Set the Content-Transfer-Encoding header to 7bit or 8bit.Tr NZ7bitr r Z8bit)r r � UnicodeError)r r r r r r 2 s c C s dS )z Do nothing.Nr )r r r r r D s N) �__doc__�__all__r r r �quoprir r r r r r r r r r r �<module> s � __pycache__/message.cpython-38.opt-2.pyc 0000644 00000051506 15204103444 0013774 0 ustar 00 U e5d� � @ s� d dgZ ddlZddlZddlZddlmZmZ ddlmZ ddlm Z ddl m Z m Z ddlm Z dd lmZ ejZd Ze�d �Zd d � Zddd�Zdd� Zdd� ZG dd � d �ZG dd� de�ZG dd� de�ZdS )�Message� EmailMessage� N)�BytesIO�StringIO)�utils)�errors)�Policy�compat32��charset)�decode_bz; z[ \(\)<>@,;:\\"/\[\]\?=]c C s4 t | ��d�\}}}|s$|�� d fS |�� |�� fS )N�;)�str� partition�strip)�param�a�sep�b� r �%/usr/lib64/python3.8/email/message.py� _splitparam s r Tc C s� |d k r�t |�dkr�t|t�rL| d7 } t�|d |d |d �}d| |f S z|�d� W n6 tk r� | d7 } t�|dd�}d| |f Y S X |s�t�|�r�d | t� |�f S d| |f S n| S d S ) Nr �*� � �%s=%s�asciizutf-8� z%s="%s") �len� isinstance�tupler Zencode_rfc2231�encode�UnicodeEncodeError� tspecials�search�quote)r �valuer% r r r � _formatparam' s r' c C s� dt | � } g }| d d� dkr�| dd � } | �d�}|dkrp| �dd|�| �dd|� d rp| �d|d �}q6|dk r�t| �}| d |� }d|kr�|�d�}|d |� �� �� d ||d d � �� }|�|�� � | |d � } q|S )Nr r r �"z\"r �=)r �find�countr �indexr �lower�append)�sZplist�end�f�ir r r � _parseparamI s ( ,r3 c C s4 t | t�r&| d | d t�| d �fS t�| �S d S )Nr r r )r r r �unquote)r& r r r � _unquotevalue] s r5 c @ s� e Zd Zefdd�Zdd� Zdcdd �Zd d � Zddd d �Zdd� Z dd� Z dd� Z dd� Z dedd�Z dfdd�Zdd� Zd d � Zd d � Zd d!� Zd"d#� Zd$d%� Zd&d'� Zd(d)� Zd*d+� Zd,d-� Zd.d/� Zdgd0d1�Zd2d3� Zd4d5� Z dhd6d7�Z d8d9� Z d:d;� Z d<d=� Z d>d?� Z!d@dA� Z"dBdC� Z#dDdE� Z$dFdG� Z%didJdK�Z&djdLdM�Z'dkdPdQ�Z(dldRdS�Z)dmdTdU�Z*dndVdW�Z+dodXdY�Z,dZd[� Z-dpd\d]�Z.dqd^d_�Z/d`da� Z0ddbl1m2Z2 dS )rr c C s: || _ g | _d | _d | _d | _d | _| _g | _d| _d S )N� text/plain) �policy�_headers� _unixfrom�_payload�_charsetZpreambleZepilogue�defects� _default_type)�selfr7 r r r �__init__x s zMessage.__init__c C s | � � S �N)� as_string�r> r r r �__str__� s zMessage.__str__Fr Nc C sJ ddl m} |d kr| jn|}t� }||d||d�}|j| |d� |�� S )Nr )� GeneratorF)� mangle_from_� maxheaderlenr7 ��unixfrom)�email.generatorrD r7 r �flatten�getvalue)r> rH rF r7 rD �fp�gr r r rA � s �zMessage.as_stringc C s | � � S r@ )�as_bytesrB r r r � __bytes__� s zMessage.__bytes__c C sH ddl m} |d kr| jn|}t� }||d|d�}|j| |d� |�� S )Nr )�BytesGeneratorF)rE r7 rG )rI rP r7 r rJ rK )r> rH r7 rP rL rM r r r rN � s zMessage.as_bytesc C s t | jt�S r@ )r r: �listrB r r r � is_multipart� s zMessage.is_multipartc C s || _ d S r@ �r9 )r> rH r r r � set_unixfrom� s zMessage.set_unixfromc C s | j S r@ rS rB r r r � get_unixfrom� s zMessage.get_unixfromc C sF | j d kr|g| _ n.z| j �|� W n tk r@ td��Y nX d S )Nz=Attach is not valid on a message with a non-multipart payload)r: r. �AttributeError� TypeError)r> �payloadr r r �attach� s zMessage.attachc C s� | � � r(|rd S |d kr | jS | j| S |d k rNt| jt�sNtdt| j� ��| j}t| �dd���� }t|t�r�t � |�r�|� dd�}|s�z|� | � dd�d�}W q� tk r� |� dd�}Y q�X n2|r�z|� d�}W n tk r� |� d�}Y nX |�s|S |d k�rt�|�S |d k�rVtd �|�� ��\}}|D ]}| j�| |� �q<|S |d k�r�t|�} t� } ztj | | d d� | �� W S tjk �r� | Y S X t|t��r�|S |S )NzExpected list, got %szcontent-transfer-encodingr r �surrogateescaper �replace�raw-unicode-escapezquoted-printable�base64� )z x-uuencodeZuuencodeZuuezx-uueT)�quiet)rR r: r rQ rW �typer �getr- r Z_has_surrogatesr! �decode� get_param� LookupError� UnicodeError�quopriZ decodestringr �join� splitlinesr7 Z handle_defectr �uurK �Error) r> r2 rb rX �cteZbpayloadr& r< ZdefectZin_fileZout_filer r r � get_payload� sV " zMessage.get_payloadc C sp t |d�r:|d kr || _d S t|t�s.t|�}|�|j�}t |d�rT|�dd�| _n|| _|d k rl| �|� d S )Nr! rb r rZ )�hasattrr: r �Charsetr! �output_charsetrb � set_charset)r> rX r r r r � set_payload/ s zMessage.set_payloadc C s |d kr | � d� d | _d S t|t�s.t|�}|| _d| krH| �dd� d| krf| jdd|�� d� n| �d|�� � ||�� kr�|�| j�| _d| k�r|� � }z || � W nj t k �r | j}|r�z|� dd �}W n t k r� |� |j �}Y nX |�|�| _| �d|� Y nX d S ) Nr � MIME-Version�1.0� Content-Typer6 r zContent-Transfer-Encodingr rZ )� del_paramr; r rn � add_headerZget_output_charset� set_paramZ body_encoder: Zget_body_encodingrW r! re ro )r> r rk rX r r r rp C s: � zMessage.set_charsetc C s | j S r@ )r; rB r r r � get_charsetr s zMessage.get_charsetc C s t | j�S r@ )r r8 rB r r r �__len__z s zMessage.__len__c C s | � |�S r@ )ra �r> �namer r r � __getitem__~ s zMessage.__getitem__c C sr | j �|�}|rX|�� }d}| jD ]4\}}|�� |kr"|d7 }||kr"td�||���q"| j�| j �||�� d S )Nr r z/There may be at most {} {} headers in a message)r7 Zheader_max_countr- r8 � ValueError�formatr. �header_store_parse)r> r{ �valZ max_countZlname�found�k�vr r r � __setitem__� s �zMessage.__setitem__c C s@ |� � }g }| jD ]"\}}|� � |kr|�||f� q|| _d S r@ )r- r8 r. )r> r{ � newheadersr� r� r r r � __delitem__� s zMessage.__delitem__c C s |� � dd� | jD �kS )Nc S s g | ]\}}|� � �qS r )r- ��.0r� r� r r r � <listcomp>� s z(Message.__contains__.<locals>.<listcomp>)r- r8 rz r r r � __contains__� s zMessage.__contains__c c s | j D ]\}}|V qd S r@ �r8 )r> Zfieldr& r r r �__iter__� s zMessage.__iter__c C s dd� | j D �S )Nc S s g | ] \}}|�qS r r r� r r r r� � s z Message.keys.<locals>.<listcomp>r� rB r r r �keys� s z Message.keysc s � fdd�� j D �S )Nc s g | ]\}}� j �||��qS r �r7 �header_fetch_parser� rB r r r� � s �z"Message.values.<locals>.<listcomp>r� rB r rB r �values� s �zMessage.valuesc s � fdd�� j D �S )Nc s" g | ]\}}|� j �||�f�qS r r� r� rB r r r� � s �z!Message.items.<locals>.<listcomp>r� rB r rB r �items� s �z Message.itemsc C s: |� � }| jD ]&\}}|� � |kr| j�||� S q|S r@ )r- r8 r7 r� )r> r{ �failobjr� r� r r r ra � s z Message.getc C s | j �||f� d S r@ )r8 r. )r> r{ r& r r r �set_raw� s zMessage.set_rawc C s t | j�� �S r@ )�iterr8 �copyrB r r r � raw_items� s zMessage.raw_itemsc C sH g }|� � }| jD ](\}}|� � |kr|�| j�||�� q|sD|S |S r@ )r- r8 r. r7 r� )r> r{ r� r� r� r� r r r �get_all� s zMessage.get_allc K sp g }|� � D ]<\}}|d kr0|�|�dd�� q |�t|�dd�|�� q |d k r^|�d|� t�|�| |< d S )N�_�-r )r� r. r[ r' �insert� SEMISPACErg )r> �_name�_valueZ_params�partsr� r� r r r rv s zMessage.add_headerc C s\ |� � }ttt| j��| j�D ]0\}\}}|� � |kr | j�||�| j|< qXq t|��d S r@ )r- �zip�ranger r8 r7 r �KeyError)r> r� r� r2 r� r� r r r �replace_header! s " zMessage.replace_headerc C sH t � }| �d|�}||kr"| �� S t|�d �� }|�d�dkrDdS |S )N� content-typer �/r r6 )�objectra �get_default_typer r- r+ )r> �missingr& �ctyper r r �get_content_type4 s zMessage.get_content_typec C s | � � }|�d�d S )Nr� r �r� �split�r> r� r r r �get_content_maintypeL s z Message.get_content_maintypec C s | � � }|�d�d S )Nr� r r� r� r r r �get_content_subtypeU s zMessage.get_content_subtypec C s | j S r@ �r= rB r r r r� ^ s zMessage.get_default_typec C s || _ d S r@ r� r� r r r �set_default_typeg s zMessage.set_default_typec C s� t � }| �||�}||kr |S g }t|�D ]X}z$|�dd�\}}|�� }|�� }W n tk rr |�� }d}Y nX |�||f� q*t�|�}|S )Nr) r r ) r� ra r3 r� r r} r. r Z decode_params) r> r� �headerr� r& �params�pr{ r� r r r �_get_params_preservep s z Message._get_params_preserver� Tc C s8 t � }| �||�}||kr |S |r0dd� |D �S |S d S )Nc S s g | ]\}}|t |�f�qS r )r5 r� r r r r� � s z&Message.get_params.<locals>.<listcomp>)r� r� )r> r� r� r4 r� r� r r r � get_params� s zMessage.get_paramsc C sN || kr |S | � ||�D ]0\}}|�� |�� kr|r@t|� S | S q|S r@ )r� r- r5 )r> r r� r� r4 r� r� r r r rc � s zMessage.get_paramrt r c C s t |t�s|r|||f}|| kr2|�� dkr2d}n | �|�}| j||d�st|s\t|||�}q�t�|t|||�g�}nbd}| j||d�D ]N\} } d} | �� |�� kr�t|||�} n t| | |�} |s�| }q�t�|| g�}q�|| �|�k�r|r�| � ||� n| |= || |< d S )Nr� r6 )r� r �r� r4 ) r r r- ra rc r' r� rg r� r� ) r> r r& r� �requoter Zlanguager[ r� Z old_param� old_valueZ append_paramr r r rw � s6 �� zMessage.set_paramc C s� || kr d S d}| j ||d�D ]@\}}|�� |�� kr |sHt|||�}q t�|t|||�g�}q || �|�kr|| |= || |< d S )Nr r� )r� r- r' r� rg ra )r> r r� r� Z new_ctyper� r� r r r ru � s �zMessage.del_paramc C s� |� d�dkst�|�� dkr,| d= d| d< || kr@|| |< d S | j||d�}| |= || |< |dd � D ]\}}| �||||� qhd S )Nr� r r� z mime-versionrs rr r� )r+ r} r- r� rw )r> r` r� r� r� r� r� r r r �set_type s zMessage.set_typec C sD t � }| �d|d�}||kr*| �d|d�}||kr6|S t�|��� S )N�filename�content-dispositionr{ r� )r� rc r �collapse_rfc2231_valuer )r> r� r� r� r r r � get_filename& s zMessage.get_filenamec C s, t � }| �d|�}||kr |S t�|��� S )N�boundary)r� rc r r� �rstrip)r> r� r� r� r r r � get_boundary6 s zMessage.get_boundaryc C s t � }| �|d�}||kr$t�d��g }d}|D ]:\}}|�� dkr\|�dd| f� d}q0|�||f� q0|s�|�dd| f� g }| jD ]z\} } | �� dkr�g } |D ].\} } | dkr�| �| � q�| �d| | f � q�t�| �} |�| j � | | �� q�|�| | f� q�|| _d S ) Nr� z No Content-Type header foundFr� z"%s"Tr r ) r� r� r ZHeaderParseErrorr- r. r8 r� rg r7 r )r> r� r� r� Z newparamsZfoundpZpkZpvr� �hr� r� r� r� r r r � set_boundaryC s2 zMessage.set_boundaryc C s� t � }| �d|�}||kr |S t|t�rr|d p2d}z |d �d�}t||�}W n ttfk rp |d }Y nX z|�d� W n tk r� | Y S X |�� S )Nr r zus-asciir r\ ) r� rc r r r! r rd re r- )r> r� r� r ZpcharsetrN r r r �get_content_charsetq s zMessage.get_content_charsetc s � fdd�| � � D �S )Nc s g | ]}|� � ��qS r )r� )r� �part�r� r r r� � s z(Message.get_charsets.<locals>.<listcomp>��walk)r> r� r r� r � get_charsets� s zMessage.get_charsetsc C s* | � d�}|d krd S t|�d �� }|S )Nr� r )ra r r- )r> r& �c_dr r r �get_content_disposition� s z Message.get_content_dispositionr� )Fr N)FN)NF)N)N)N)Nr� T)Nr� T)rt TNr F)r� T)rt T)N)N)N)N)3�__name__� __module__� __qualname__r r? rC rA rO rN rR rT rU rY rl rq rp rx ry r| r� r� r� r� r� r� r� ra r� r� r� rv r� r� r� r� r� r� r� r� rc rw ru r� r� r� r� r� r� r� Zemail.iteratorsr� r r r r r i sh Z / � " � 3 . c s� e Zd Zd2dd�Zd3� fdd� Zdd� Zd d � Zd d � Zd4dd�ZddddhZ dd� Z dd� Z dd�dd�Z dd�dd �Z d d � Zd5d d �Zd6d!d"�Zd7d#d$�Zdd%�d&d'�Zd(d)� Zd*d+� Zd,d-� Zd.d/� Zd0d1� Z� ZS )8�MIMEPartNc C s( |d krddl m} |}t�| |� d S )Nr )�default)Z email.policyr� r r? )r> r7 r� r r r r? � s zMIMEPart.__init__Fc s0 |d kr| j n|}|d kr |j}t� j||d�S )N)rF r7 )r7 Zmax_line_length�superrA )r> rH rF r7 �� __class__r r rA � s zMIMEPart.as_stringc C s | j | jjdd�d�S )NT)�utf8�r7 )rA r7 ZclonerB r r r rC � s zMIMEPart.__str__c C s | � d�}|d krdS |jdkS )Nr� F� attachment)ra Zcontent_disposition)r> r� r r r � is_attachment� s zMIMEPart.is_attachmentc c s |� � r d S |�� �d�\}}|dkrB||kr>|�|�|fV d S |dkrNd S |dkrz|�� D ]}| �||�E d H q^d S d|kr�|�d�|fV d }|�d�}|r�|�� D ]}|d |kr�|} q�q�|d kr�|�� }|r�|d nd }|d k �r| �||�E d H d S )Nr� �text� multipart�related�start� content-idr )r� r� r� r, � iter_parts� _find_bodyrc rl ) r> r� �preferencelist�maintype�subtypeZsubpart� candidater� Zsubpartsr r r r� � s6 zMIMEPart._find_body�r� �html�plainc C sB t |�}d }| �| |�D ]$\}}||k r|}|}|dkr q>q|S )Nr )r r� )r> r� Z best_prioZbodyZprior� r r r �get_body� s zMIMEPart.get_body)r� r� )r� r� )r� r� )r� � alternativec c s$ | � � �d�\}}|dks"|dkr&d S | �� }z |�� }W n tk rP Y d S X |dkr�|dkr�| �d�}|r�d}g }|D ]"}|�d�|kr�d}q||�|� q||r�|E d H d S |�d � |E d H d S g } |D ]L}|� � �d�\}}||f| j k�r|� � �s|| k�r| �|� q�|V q�d S ) Nr� r� r� r� r� Fr� Tr ) r� r� rl r� rV rc ra r. �pop� _body_typesr� ) r> r� r� rX r� r� r� Z attachmentsr� �seenr r r �iter_attachments sD �� zMIMEPart.iter_attachmentsc c s | � � dkr| �� E d H d S )Nr� )r� rl rB r r r r� = s zMIMEPart.iter_parts)�content_managerc O s" |d kr| j j}|j| f|�|�S r@ )r7 r� � get_content�r> r� �args�kwr r r r� E s zMIMEPart.get_contentc O s& |d kr| j j}|j| f|�|� d S r@ )r7 r� � set_contentr� r r r r� J s zMIMEPart.set_contentc C s� | � � dkr6| �� }||f }||kr6td�||���g }g }| jD ]4\}}|�� �d�rj|�||f� qD|�||f� qD|r�t| �| j d�} || _| j | _ | g| _ ng | _ || _d| | d< |d k r�| � d|� d S )Nr� zCannot convert {} to {}�content-r� z multipart/rt r� ) r� r� r} r~ r8 r- � startswithr. r` r7 r: rw ) r> r� Zdisallowed_subtypesr� Zexisting_subtypeZ keep_headersZ part_headersr{ r& r� r r r �_make_multipartO s0 � zMIMEPart._make_multipartc C s | � dd|� d S )Nr� )r� �mixed�r� �r> r� r r r � make_relatedj s zMIMEPart.make_relatedc C s | � dd|� d S )Nr� )r� r� r� r r r �make_alternativem s zMIMEPart.make_alternativec C s | � dd|� d S )Nr� r r� r� r r r � make_mixedp s zMIMEPart.make_mixed)�_dispc O sf | � � dks| �� |kr(t| d| �� t| �| jd�}|j||� |rXd|krX||d< | �|� d S )Nr� Zmake_r� r� zContent-Disposition)r� r� �getattrr` r7 r� rY )r> Z_subtyper� r� r� r� r r r �_add_multiparts s � zMIMEPart._add_multipartc O s | j d|�ddi|�� d S )Nr� r� Zinline)r� �r� �r> r� r� r r r � add_related} s zMIMEPart.add_relatedc O s | j d|�|� d S )Nr� )r� r� r� r r r �add_alternative� s zMIMEPart.add_alternativec O s | j d|�ddi|�� d S )Nr� r� r� )r� r� r� r r r �add_attachment� s zMIMEPart.add_attachmentc C s g | _ d | _d S r@ �r8 r: rB r r r �clear� s zMIMEPart.clearc C s dd� | j D �| _ d | _d S )Nc S s& g | ] \}}|� � �d �s||f�qS )r� )r- r� )r� �nr� r r r r� � s �z*MIMEPart.clear_content.<locals>.<listcomp>r rB r r r � clear_content� s zMIMEPart.clear_content)N)FNN)r� )N)N)N)r� r� r� r? rA rC r� r� r� r� r� r� r� r� r� r� r� r� r� r� r r r r � __classcell__r r r� r r� � s2 �7 r� c s e Zd Z� fdd�Z� ZS )r c s" t � j||� d| kr d| d< d S )Nrr rs )r� r� r� r� r r r� � s zEmailMessage.set_content)r� r� r� r� r r r r� r r � s )NT) �__all__�reri rf �ior r Zemailr r Zemail._policybaser r r r; Zemail._encoded_wordsr rn r� �compiler# r r' r3 r5 r r� r r r r r �<module> s4 " N ` __pycache__/contentmanager.cpython-38.pyc 0000644 00000016303 15204103444 0014411 0 ustar 00 U e5d�) � @ s. d dl Z d dlZd dlZd dlZd dlmZ G dd� d�Ze� Zd%dd�Ze� de� d d � Z d � � D ]Z e� e e � qfd d � Z d� � D ]Ze� de e � q�dd� Ze� de� dd� Zdd� Zdd� Zdd� Zd&d d �Ze�ee� d'd d!�Ze�ejje� d(d#d$�Zee e fD ]Z e�e e� �qdS ))� N)� quoprimimec @ s< e Zd Zdd� Zdd� Zdd� Zdd� Zd d � Zd d � Zd S )�ContentManagerc C s i | _ i | _d S �N)� get_handlers� set_handlers)�self� r �,/usr/lib64/python3.8/email/contentmanager.py�__init__ s zContentManager.__init__c C s || j |< d S r )r )r �key�handlerr r r �add_get_handler s z ContentManager.add_get_handlerc O s| |� � }|| jkr(| j| |f|�|�S |�� }|| jkrP| j| |f|�|�S d| jkrp| jd |f|�|�S t|��d S )N� )Zget_content_typer �get_content_maintype�KeyError)r �msg�args�kwZ content_type�maintyper r r � get_content s zContentManager.get_contentc C s || j |< d S r )r )r Ztypekeyr r r r �add_set_handler s z ContentManager.add_set_handlerc O s> |� � dkrtd��| �||�}|�� |||f|�|� d S )NZ multipartz"set_content not valid on multipart)r � TypeError�_find_set_handlerZ clear_content)r r �objr r r r r r � set_content s zContentManager.set_contentc C s� d }t |�jD ]�}|| jkr*| j| S |j}t|dd�}|rNd�||f�n|}|d kr^|}|| jkrv| j| S || jkr�| j| S |j}|| jkr| j| S qd | jkr�| jd S t|��d S )N� __module__r �.)�type�__mro__r � __qualname__�getattr�join�__name__r ) r r r Zfull_path_for_error�typZqname�modname� full_path�namer r r r ' s& z ContentManager._find_set_handlerN) r" r r r r r r r r r r r r r s r �replacec C s& | j dd�}| �dd�}|j||d�S )NT��decode�charset�ASCII)�errors)� get_payloadZ get_paramr) )r r, Zcontentr* r r r �get_text_content@ s r. �textc C s | j dd�S )NTr( �r- �r r r r �get_non_text_contentG s r2 z audio image video applicationc C s | � d�S �Nr r0 r1 r r r �get_message_contentM s r4 zrfc822 external-bodyzmessage/c C s t | �d��S r3 )�bytesr- r1 r r r �%get_and_fixup_unknown_message_contentS s r6 �messagec s� d� ||f�| d< |r�t|d d�s<| j� � fdd�|D �}z(|D ] }|jrV|jd �|| |j< qBW n@ tjjk r� } z td� |j | jd���|�W 5 d }~X Y nX d S ) N�/z Content-Typer r& c s g | ]}� j � �|g�� �qS r )Zheader_factoryZheader_source_parse)�.0�header�Zmpr r � <listcomp>d s �z _prepare_set.<locals>.<listcomp>zInvalid header: {})�policy) r! �hasattrr= Zdefectsr& �emailr, Z HeaderDefect� ValueError�formatZfold)r r �subtype�headersr: �excr r; r � _prepare_set_ s$ � ��rE c C sx |d kr|d k rd}|d k r$|| d< |d k r>| j d|ddd� |d k rN|| d< |d k rt|�� D ]\}}| � ||� q^d S )NZ attachmentzContent-Disposition�filenameT)r: r' z Content-ID)� set_param�items)r � dispositionrF �cid�paramsr �valuer r r � _finalize_setp s �rM c C sV g }|d d }t dt| �|�D ]*}| ||| � }|�t�|��d�� q d�|�S )N� � r �asciir )�range�len�append�binascii� b2a_base64r) r! )�data�max_line_lengthZ encoded_linesZunencoded_bytes_per_line�iZthisliner r r �_encode_base64� s rY c s� | � |��� }|j� d�� � fdd�}dd� }|d kr�tdd� |D �dd �|jkr�zd ||��d�fW S tk rz Y nX |jd kr�d ||��dd �fS ||d d � �}t� |�d�|j�}t � |�} t |�t | �kr�d}nd}t |�d kr�||fS |d k�r||��d�} nj|d k�r,||��dd �} nN|dk�rPt� ||��d�|j�} n*|dk�rlt ||�|j�} ntd�|���|| fS )NrP c s � � | �� S r �r! ��lines��linesepr r � embedded_body� � z#_encode_text.<locals>.embedded_bodyc S s d� | �d S )N� rZ r[ r r r � normal_body� r` z!_encode_text.<locals>.normal_bodyc s s | ]}t |�V qd S r )rR )r9 �xr r r � <genexpr>� s z _encode_text.<locals>.<genexpr>r )�default�7bit�8bit�surrogateescape� zlatin-1�base64�quoted-printablez$Unknown content transfer encoding {})�encode� splitlinesr^ �maxrW r) �UnicodeDecodeErrorZcte_typer Z body_encoderT rU rR rY r@ rA ) �stringr* �cter= r\ r_ rb ZsniffZsniff_qpZ sniff_base64rV r r] r � _encode_text� sD � � rr �plain�utf-8c C sd t | d|| � t|||| j�\}} | �| � | jdtjj�||�dd� || d< t | ||||� d S )Nr/ r* T)r' �Content-Transfer-Encoding) rE rr r= � set_payloadrG r? r* ZALIASES�getrM ) r rp rB r* rq rI rF rJ rK rC Zpayloadr r r �set_text_content� s �rx �rfc822c C s� |dkrt d��|dkr@|dkr.t d�|���|d kr:dn|}n0|dkrd|dkr^t d �|���d }n |d krpd }t| d ||� | �|g� || d < t| ||||� d S ) N�partialz4message/partial is not supported for Message objectsry )Nrf rg �binaryz*message/rfc822 parts do not support cte={}rg z external-body)Nrf z1message/external-body parts do not support cte={}rf r7 ru )r@ rA rE rv rM ) r r7 rB rq rI rF rJ rK rC r r r �set_message_content� s( �� r| rj c C s� t | ||| � |dkr(t|| jjd�}nN|dkrNtj|dddd�}|�d�}n(|dkrb|�d� n|d krv|�dd �}| �|� || d < t | ||||� d S ) Nrj )rW rk FT)�istextr: Z quotetabsrP rf )rg r{ rh ru ) rE rY r= rW rT Zb2a_qpr) rl rv rM ) r rV r rB rq rI rF rJ rK rC r r r �set_bytes_content� s r~ )r' )rs rt NNNNNN)ry NNNNNN)rj NNNNN) rT Z email.charsetr? Z email.messageZ email.errorsr r Zraw_data_managerr. r r2 �splitr r4 rB r6 rE rM rY rr rx r �strr| r7 ZMessager~ r5 � bytearray� memoryviewr# r r r r �<module> s^ 6 � ' � � � __pycache__/message.cpython-38.pyc 0000644 00000111770 15204103444 0013034 0 ustar 00 U e5d� � @ s� d Z ddgZddlZddlZddlZddlmZmZ ddlm Z ddlm Z ddl m Z m Z dd lmZ dd lmZ ejZd Ze�d �Zd d� Zddd�Zdd� Zdd� ZG dd� d�ZG dd� de�ZG dd� de�Z dS )z8Basic message object for the email package object model.�Message� EmailMessage� N)�BytesIO�StringIO)�utils)�errors)�Policy�compat32��charset)�decode_bz; z[ \(\)<>@,;:\\"/\[\]\?=]c C s4 t | ��d�\}}}|s$|�� d fS |�� |�� fS )N�;)�str� partition�strip)�param�a�sep�b� r �%/usr/lib64/python3.8/email/message.py� _splitparam s r Tc C s� |dk r�t |�dkr�t|t�rL| d7 } t�|d |d |d �}d| |f S z|�d� W n6 tk r� | d7 } t�|dd �}d| |f Y S X |s�t�|�r�d | t� |�f S d| |f S n| S dS ) a~ Convenience function to format and return a key=value pair. This will quote the value if needed or if quote is true. If value is a three tuple (charset, language, value), it will be encoded according to RFC2231 rules. If it contains non-ascii characters it will likewise be encoded according to RFC2231 rules, using the utf-8 charset and a null language. Nr �*� � �%s=%s�asciizutf-8� z%s="%s") �len� isinstance�tupler Zencode_rfc2231�encode�UnicodeEncodeError� tspecials�search�quote)r �valuer% r r r � _formatparam' s r' c C s� dt | � } g }| d d� dkr�| dd � } | �d�}|dkrp| �dd|�| �dd|� d rp| �d|d �}q6|dk r�t| �}| d |� }d|kr�|�d�}|d |� �� �� d ||d d � �� }|�|�� � | |d � } q|S )Nr r r �"z\"r �=)r �find�countr �indexr �lower�append)�sZplist�end�f�ir r r � _parseparamI s ( ,r3 c C s4 t | t�r&| d | d t�| d �fS t�| �S d S )Nr r r )r r r �unquote)r& r r r � _unquotevalue] s r5 c @ s� e Zd ZdZefdd�Zdd� Zddd d �Zd d � Zded d�Z dd� Z dd� Z dd� Z dd� Z dfdd�Zdgdd�Zdd � Zd d � Zd d � Zd!d"� Zd#d$� Zd%d&� Zd'd(� Zd)d*� Zd+d,� Zd-d.� Zd/d0� Zdhd1d2�Zd3d4� Z d5d6� Z did7d8�Z d9d:� Z d;d<� Z d=d>� Z!d?d@� Z"dAdB� Z#dCdD� Z$dEdF� Z%dGdH� Z&djdKdL�Z'dkdMdN�Z(dldQdR�Z)dmdSdT�Z*dndUdV�Z+dodWdX�Z,dpdYdZ�Z-d[d\� Z.dqd]d^�Z/drd_d`�Z0dadb� Z1ddcl2m3Z3 dS )sr a� Basic message object. A message object is defined as something that has a bunch of RFC 2822 headers and a payload. It may optionally have an envelope header (a.k.a. Unix-From or From_ header). If the message is a container (i.e. a multipart or a message/rfc822), then the payload is a list of Message objects, otherwise it is a string. Message objects implement part of the `mapping' interface, which assumes there is exactly one occurrence of the header per message. Some headers do in fact appear multiple times (e.g. Received) and for those headers, you must use the explicit API to set or get all the headers. Not all of the mapping methods are implemented. c C s: || _ g | _d | _d | _d | _d | _| _g | _d| _d S )N� text/plain) �policy�_headers� _unixfrom�_payload�_charsetZpreambleZepilogue�defects� _default_type)�selfr7 r r r �__init__x s zMessage.__init__c C s | � � S )z9Return the entire formatted message as a string. )� as_string�r> r r r �__str__� s zMessage.__str__Fr Nc C sJ ddl m} |dkr| jn|}t� }||d||d�}|j| |d� |�� S )a� Return the entire formatted message as a string. Optional 'unixfrom', when true, means include the Unix From_ envelope header. For backward compatibility reasons, if maxheaderlen is not specified it defaults to 0, so you must override it explicitly if you want a different maxheaderlen. 'policy' is passed to the Generator instance used to serialize the message; if it is not specified the policy associated with the message instance is used. If the message object contains binary data that is not encoded according to RFC standards, the non-compliant data will be replaced by unicode "unknown character" code points. r )� GeneratorNF)� mangle_from_� maxheaderlenr7 ��unixfrom)�email.generatorrC r7 r �flatten�getvalue)r> rG rE r7 rC �fp�gr r r r@ � s �zMessage.as_stringc C s | � � S )z?Return the entire formatted message as a bytes object. )�as_bytesrA r r r � __bytes__� s zMessage.__bytes__c C sH ddl m} |dkr| jn|}t� }||d|d�}|j| |d� |�� S )aJ Return the entire formatted message as a bytes object. Optional 'unixfrom', when true, means include the Unix From_ envelope header. 'policy' is passed to the BytesGenerator instance used to serialize the message; if not specified the policy associated with the message instance is used. r )�BytesGeneratorNF)rD r7 rF )rH rO r7 r rI rJ )r> rG r7 rO rK rL r r r rM � s zMessage.as_bytesc C s t | jt�S )z6Return True if the message consists of multiple parts.)r r: �listrA r r r � is_multipart� s zMessage.is_multipartc C s || _ d S �N�r9 )r> rG r r r � set_unixfrom� s zMessage.set_unixfromc C s | j S rR rS rA r r r � get_unixfrom� s zMessage.get_unixfromc C sF | j dkr|g| _ n.z| j �|� W n tk r@ td��Y nX dS )z�Add the given payload to the current payload. The current payload will always be a list of objects after this method is called. If you want to set the payload to a scalar object, use set_payload() instead. Nz=Attach is not valid on a message with a non-multipart payload)r: r. �AttributeError� TypeError)r> �payloadr r r �attach� s zMessage.attachc C s� | � � r(|rdS |dkr | jS | j| S |dk rNt| jt�sNtdt| j� ��| j}t| �dd���� }t|t�r�t � |�r�|� dd�}|s�z|� | � dd�d�}W q� tk r� |� dd�}Y q�X n2|r�z|� d�}W n tk r� |� d �}Y nX |�s|S |d k�rt�|�S |d k�rVtd �|�� ��\}}|D ]}| j�| |� �q<|S |d k�r�t|�} t� } ztj | | dd� | �� W S tjk �r� | Y S X t|t��r�|S |S )aZ Return a reference to the payload. The payload will either be a list object or a string. If you mutate the list object, you modify the message's payload in place. Optional i returns that index into the payload. Optional decode is a flag indicating whether the payload should be decoded or not, according to the Content-Transfer-Encoding header (default is False). When True and the message is not a multipart, the payload will be decoded if this header's value is `quoted-printable' or `base64'. If some other encoding is used, or the header is missing, or if the payload has bogus data (i.e. bogus base64 or uuencoded data), the payload is returned as-is. If the message is a multipart and the decode flag is True, then None is returned. NzExpected list, got %szcontent-transfer-encodingr r �surrogateescaper �replace�raw-unicode-escapezquoted-printable�base64� )z x-uuencodeZuuencodeZuuezx-uueT)�quiet)rQ r: r rP rW �typer �getr- r Z_has_surrogatesr! �decode� get_param� LookupError� UnicodeError�quopriZ decodestringr �join� splitlinesr7 Z handle_defectr �uurJ �Error) r> r2 rb rX �cteZbpayloadr& r< ZdefectZin_fileZout_filer r r � get_payload� sV " zMessage.get_payloadc C sp t |d�r:|dkr || _dS t|t�s.t|�}|�|j�}t |d�rT|�dd�| _n|| _|dk rl| �|� dS )z�Set the payload to the given value. Optional charset sets the message's default character set. See set_charset() for details. r! Nrb r rZ )�hasattrr: r �Charsetr! �output_charsetrb � set_charset)r> rX r r r r � set_payload/ s zMessage.set_payloadc C s |dkr | � d� d| _dS t|t�s.t|�}|| _d| krH| �dd� d| krf| jdd|�� d� n| �d|�� � ||�� kr�|�| j�| _d| k�r|� � }z || � W nj t k �r | j}|r�z|� d d �}W n t k r� |� |j �}Y nX |�|�| _| �d|� Y nX dS ) a� Set the charset of the payload to a given character set. charset can be a Charset instance, a string naming a character set, or None. If it is a string it will be converted to a Charset instance. If charset is None, the charset parameter will be removed from the Content-Type field. Anything else will generate a TypeError. The message will be assumed to be of type text/* encoded with charset.input_charset. It will be converted to charset.output_charset and encoded properly, if needed, when generating the plain text representation of the message. MIME headers (MIME-Version, Content-Type, Content-Transfer-Encoding) will be added as needed. Nr � MIME-Version�1.0� Content-Typer6 r zContent-Transfer-Encodingr rZ )� del_paramr; r rn � add_headerZget_output_charset� set_paramZ body_encoder: Zget_body_encodingrW r! re ro )r> r rk rX r r r rp C s: � zMessage.set_charsetc C s | j S )zKReturn the Charset instance associated with the message's payload. )r; rA r r r � get_charsetr s zMessage.get_charsetc C s t | j�S )z9Return the total number of headers, including duplicates.)r r8 rA r r r �__len__z s zMessage.__len__c C s | � |�S )a- Get a header value. Return None if the header is missing instead of raising an exception. Note that if the header appeared multiple times, exactly which occurrence gets returned is undefined. Use get_all() to get all the values matching a header field name. )ra �r> �namer r r � __getitem__~ s zMessage.__getitem__c C sr | j �|�}|rX|�� }d}| jD ]4\}}|�� |kr"|d7 }||kr"td�||���q"| j�| j �||�� dS )z�Set the value of a header. Note: this does not overwrite an existing header with the same field name. Use __delitem__() first to delete any existing headers. r r z/There may be at most {} {} headers in a messageN)r7 Zheader_max_countr- r8 � ValueError�formatr. �header_store_parse)r> r{ �valZ max_countZlname�found�k�vr r r � __setitem__� s �zMessage.__setitem__c C s@ |� � }g }| jD ]"\}}|� � |kr|�||f� q|| _dS )zwDelete all occurrences of a header, if present. Does not raise an exception if the header is missing. N)r- r8 r. )r> r{ � newheadersr� r� r r r � __delitem__� s zMessage.__delitem__c C s |� � dd� | jD �kS )Nc S s g | ]\}}|� � �qS r )r- ��.0r� r� r r r � <listcomp>� s z(Message.__contains__.<locals>.<listcomp>)r- r8 rz r r r � __contains__� s zMessage.__contains__c c s | j D ]\}}|V qd S rR �r8 )r> Zfieldr& r r r �__iter__� s zMessage.__iter__c C s dd� | j D �S )a. Return a list of all the message's header field names. These will be sorted in the order they appeared in the original message, or were added to the message, and may contain duplicates. Any fields deleted and re-inserted are always appended to the header list. c S s g | ] \}}|�qS r r r� r r r r� � s z Message.keys.<locals>.<listcomp>r� rA r r r �keys� s z Message.keysc s � fdd�� j D �S )a) Return a list of all the message's header values. These will be sorted in the order they appeared in the original message, or were added to the message, and may contain duplicates. Any fields deleted and re-inserted are always appended to the header list. c s g | ]\}}� j �||��qS r �r7 �header_fetch_parser� rA r r r� � s �z"Message.values.<locals>.<listcomp>r� rA r rA r �values� s �zMessage.valuesc s � fdd�� j D �S )a' Get all the message's header fields and values. These will be sorted in the order they appeared in the original message, or were added to the message, and may contain duplicates. Any fields deleted and re-inserted are always appended to the header list. c s" g | ]\}}|� j �||�f�qS r r� r� rA r r r� � s �z!Message.items.<locals>.<listcomp>r� rA r rA r �items� s �z Message.itemsc C s: |� � }| jD ]&\}}|� � |kr| j�||� S q|S )z~Get a header value. Like __getitem__() but return failobj instead of None when the field is missing. )r- r8 r7 r� )r> r{ �failobjr� r� r r r ra � s z Message.getc C s | j �||f� dS )z�Store name and value in the model without modification. This is an "internal" API, intended only for use by a parser. N)r8 r. )r> r{ r& r r r �set_raw� s zMessage.set_rawc C s t | j�� �S )z�Return the (name, value) header pairs without modification. This is an "internal" API, intended only for use by a generator. )�iterr8 �copyrA r r r � raw_items� s zMessage.raw_itemsc C sH g }|� � }| jD ](\}}|� � |kr|�| j�||�� q|sD|S |S )aQ Return a list of all the values for the named field. These will be sorted in the order they appeared in the original message, and may contain duplicates. Any fields deleted and re-inserted are always appended to the header list. If no such fields exist, failobj is returned (defaults to None). )r- r8 r. r7 r� )r> r{ r� r� r� r� r r r �get_all� s zMessage.get_allc K sp g }|� � D ]<\}}|dkr0|�|�dd�� q |�t|�dd�|�� q |dk r^|�d|� t�|�| |< dS )u� Extended header setting. name is the header field to add. keyword arguments can be used to set additional parameters for the header field, with underscores converted to dashes. Normally the parameter will be added as key="value" unless value is None, in which case only the key will be added. If a parameter value contains non-ASCII characters it can be specified as a three-tuple of (charset, language, value), in which case it will be encoded according to RFC2231 rules. Otherwise it will be encoded using the utf-8 charset and a language of ''. Examples: msg.add_header('content-disposition', 'attachment', filename='bud.gif') msg.add_header('content-disposition', 'attachment', filename=('utf-8', '', Fußballer.ppt')) msg.add_header('content-disposition', 'attachment', filename='Fußballer.ppt')) N�_�-r )r� r. r[ r' �insert� SEMISPACErg )r> �_name�_valueZ_params�partsr� r� r r r rv s zMessage.add_headerc C s\ |� � }ttt| j��| j�D ]0\}\}}|� � |kr | j�||�| j|< qXq t|��dS )z�Replace a header. Replace the first matching header found in the message, retaining header order and case. If no matching header was found, a KeyError is raised. N)r- �zip�ranger r8 r7 r �KeyError)r> r� r� r2 r� r� r r r �replace_header! s " zMessage.replace_headerc C sH t � }| �d|�}||kr"| �� S t|�d �� }|�d�dkrDdS |S )a0 Return the message's content type. The returned string is coerced to lower case of the form `maintype/subtype'. If there was no Content-Type header in the message, the default type as given by get_default_type() will be returned. Since according to RFC 2045, messages always have a default type this will always return a value. RFC 2045 defines a message's default type to be text/plain unless it appears inside a multipart/digest container, in which case it would be message/rfc822. � content-typer �/r r6 )�objectra �get_default_typer r- r+ )r> �missingr& �ctyper r r �get_content_type4 s zMessage.get_content_typec C s | � � }|�d�d S )z�Return the message's main content type. This is the `maintype' part of the string returned by get_content_type(). r� r �r� �split�r> r� r r r �get_content_maintypeL s z Message.get_content_maintypec C s | � � }|�d�d S )z�Returns the message's sub-content type. This is the `subtype' part of the string returned by get_content_type(). r� r r� r� r r r �get_content_subtypeU s zMessage.get_content_subtypec C s | j S )a Return the `default' content type. Most messages have a default content type of text/plain, except for messages that are subparts of multipart/digest containers. Such subparts have a default content type of message/rfc822. �r= rA r r r r� ^ s zMessage.get_default_typec C s || _ dS )z�Set the `default' content type. ctype should be either "text/plain" or "message/rfc822", although this is not enforced. The default content type is not stored in the Content-Type header. Nr� r� r r r �set_default_typeg s zMessage.set_default_typec C s� t � }| �||�}||kr |S g }t|�D ]X}z$|�dd�\}}|�� }|�� }W n tk rr |�� }d}Y nX |�||f� q*t�|�}|S )Nr) r r ) r� ra r3 r� r r} r. r Z decode_params) r> r� �headerr� r& �params�pr{ r� r r r �_get_params_preservep s z Message._get_params_preserver� Tc C s8 t � }| �||�}||kr |S |r0dd� |D �S |S dS )am Return the message's Content-Type parameters, as a list. The elements of the returned list are 2-tuples of key/value pairs, as split on the `=' sign. The left hand side of the `=' is the key, while the right hand side is the value. If there is no `=' sign in the parameter the value is the empty string. The value is as described in the get_param() method. Optional failobj is the object to return if there is no Content-Type header. Optional header is the header to search instead of Content-Type. If unquote is True, the value is unquoted. c S s g | ]\}}|t |�f�qS r )r5 r� r r r r� � s z&Message.get_params.<locals>.<listcomp>N)r� r� )r> r� r� r4 r� r� r r r � get_params� s zMessage.get_paramsc C sN || kr |S | � ||�D ]0\}}|�� |�� kr|r@t|� S | S q|S )a� Return the parameter value if found in the Content-Type header. Optional failobj is the object to return if there is no Content-Type header, or the Content-Type header has no such parameter. Optional header is the header to search instead of Content-Type. Parameter keys are always compared case insensitively. The return value can either be a string, or a 3-tuple if the parameter was RFC 2231 encoded. When it's a 3-tuple, the elements of the value are of the form (CHARSET, LANGUAGE, VALUE). Note that both CHARSET and LANGUAGE can be None, in which case you should consider VALUE to be encoded in the us-ascii charset. You can usually ignore LANGUAGE. The parameter value (either the returned string, or the VALUE item in the 3-tuple) is always unquoted, unless unquote is set to False. If your application doesn't care whether the parameter was RFC 2231 encoded, it can turn the return value into a string as follows: rawparam = msg.get_param('foo') param = email.utils.collapse_rfc2231_value(rawparam) )r� r- r5 )r> r r� r� r4 r� r� r r r rc � s zMessage.get_paramrt r c C s t |t�s|r|||f}|| kr2|�� dkr2d}n | �|�}| j||d�st|s\t|||�}q�t�|t|||�g�}nbd}| j||d�D ]N\} } d} | �� |�� kr�t|||�} n t| | |�} |s�| }q�t�|| g�}q�|| �|�k�r|r�| � ||� n| |= || |< dS )a� Set a parameter in the Content-Type header. If the parameter already exists in the header, its value will be replaced with the new value. If header is Content-Type and has not yet been defined for this message, it will be set to "text/plain" and the new parameter and value will be appended as per RFC 2045. An alternate header can be specified in the header argument, and all parameters will be quoted as necessary unless requote is False. If charset is specified, the parameter will be encoded according to RFC 2231. Optional language specifies the RFC 2231 language, defaulting to the empty string. Both charset and language should be strings. r� r6 )r� r �r� r4 N) r r r- ra rc r' r� rg r� r� ) r> r r& r� �requoter Zlanguager[ r� Z old_param� old_valueZ append_paramr r r rw � s6 �� zMessage.set_paramc C s� || kr dS d}| j ||d�D ]@\}}|�� |�� kr |sHt|||�}q t�|t|||�g�}q || �|�kr|| |= || |< dS )a> Remove the given parameter completely from the Content-Type header. The header will be re-written in place without the parameter or its value. All values will be quoted as necessary unless requote is False. Optional header specifies an alternative to the Content-Type header. Nr r� )r� r- r' r� rg ra )r> r r� r� Z new_ctyper� r� r r r ru � s �zMessage.del_paramc C s� |� d�dkst�|�� dkr,| d= d| d< || kr@|| |< dS | j||d�}| |= || |< |dd� D ]\}}| �||||� qhdS ) aK Set the main type and subtype for the Content-Type header. type must be a string in the form "maintype/subtype", otherwise a ValueError is raised. This method replaces the Content-Type header, keeping all the parameters in place. If requote is False, this leaves the existing header's quoting as is. Otherwise, the parameters will be quoted (the default). An alternative header can be specified in the header argument. When the Content-Type header is set, we'll always also add a MIME-Version header. r� r r� z mime-versionrs rr Nr� )r+ r} r- r� rw )r> r` r� r� r� r� r� r r r �set_type s zMessage.set_typec C sD t � }| �d|d�}||kr*| �d|d�}||kr6|S t�|��� S )a@ Return the filename associated with the payload if present. The filename is extracted from the Content-Disposition header's `filename' parameter, and it is unquoted. If that header is missing the `filename' parameter, this method falls back to looking for the `name' parameter. �filename�content-dispositionr{ r� )r� rc r �collapse_rfc2231_valuer )r> r� r� r� r r r � get_filename& s zMessage.get_filenamec C s, t � }| �d|�}||kr |S t�|��� S )z�Return the boundary associated with the payload if present. The boundary is extracted from the Content-Type header's `boundary' parameter, and it is unquoted. �boundary)r� rc r r� �rstrip)r> r� r� r� r r r � get_boundary6 s zMessage.get_boundaryc C s t � }| �|d�}||kr$t�d��g }d}|D ]:\}}|�� dkr\|�dd| f� d}q0|�||f� q0|s�|�dd| f� g }| jD ]z\} } | �� dkr�g } |D ].\} } | dkr�| �| � q�| �d| | f � q�t�| �} |�| j � | | �� q�|�| | f� q�|| _d S ) a� Set the boundary parameter in Content-Type to 'boundary'. This is subtly different than deleting the Content-Type header and adding a new one with a new boundary parameter via add_header(). The main difference is that using the set_boundary() method preserves the order of the Content-Type header in the original message. HeaderParseError is raised if the message has no Content-Type header. r� z No Content-Type header foundFr� z"%s"Tr r N) r� r� r ZHeaderParseErrorr- r. r8 r� rg r7 r )r> r� r� r� Z newparamsZfoundpZpkZpvr� �hr� r� r� r� r r r � set_boundaryC s2 zMessage.set_boundaryc C s� t � }| �d|�}||kr |S t|t�rr|d p2d}z |d �d�}t||�}W n ttfk rp |d }Y nX z|�d� W n tk r� | Y S X |�� S )z�Return the charset parameter of the Content-Type header. The returned string is always coerced to lower case. If there is no Content-Type header, or if that header has no charset parameter, failobj is returned. r r zus-asciir r\ ) r� rc r r r! r rd re r- )r> r� r� r ZpcharsetrM r r r �get_content_charsetq s zMessage.get_content_charsetc s � fdd�| � � D �S )a� Return a list containing the charset(s) used in this message. The returned list of items describes the Content-Type headers' charset parameter for this message and all the subparts in its payload. Each item will either be a string (the value of the charset parameter in the Content-Type header of that part) or the value of the 'failobj' parameter (defaults to None), if the part does not have a main MIME type of "text", or the charset is not defined. The list will contain one string for each part of the message, plus one for the container message (i.e. self), so that a non-multipart message will still return a list of length 1. c s g | ]}|� � ��qS r )r� )r� �part�r� r r r� � s z(Message.get_charsets.<locals>.<listcomp>��walk)r> r� r r� r � get_charsets� s zMessage.get_charsetsc C s* | � d�}|dkrdS t|�d �� }|S )z�Return the message's content-disposition if it exists, or None. The return values can be either 'inline', 'attachment' or None according to the rfc2183. r� Nr )ra r r- )r> r& �c_dr r r �get_content_disposition� s z Message.get_content_dispositionr� )Fr N)FN)NF)N)N)N)Nr� T)Nr� T)rt TNr F)r� T)rt T)N)N)N)N)4�__name__� __module__� __qualname__�__doc__r r? rB r@ rN rM rQ rT rU rY rl rq rp rx ry r| r� r� r� r� r� r� r� ra r� r� r� rv r� r� r� r� r� r� r� r� rc rw ru r� r� r� r� r� r� r� Zemail.iteratorsr� r r r r r i sj Z / � " � 3 . c s� e Zd Zd2dd�Zd3� fdd� Zdd� Zd d � Zd d � Zd4dd�ZddddhZ dd� Z dd� Z dd�dd�Z dd�dd �Z d d � Zd5d d �Zd6d!d"�Zd7d#d$�Zdd%�d&d'�Zd(d)� Zd*d+� Zd,d-� Zd.d/� Zd0d1� Z� ZS )8�MIMEPartNc C s( |d krddl m} |}t�| |� d S )Nr )�default)Z email.policyr� r r? )r> r7 r� r r r r? � s zMIMEPart.__init__Fc s0 |dkr| j n|}|dkr |j}t� j||d�S )a Return the entire formatted message as a string. Optional 'unixfrom', when true, means include the Unix From_ envelope header. maxheaderlen is retained for backward compatibility with the base Message class, but defaults to None, meaning that the policy value for max_line_length controls the header maximum length. 'policy' is passed to the Generator instance used to serialize the message; if it is not specified the policy associated with the message instance is used. N)rE r7 )r7 Zmax_line_length�superr@ )r> rG rE r7 �� __class__r r r@ � s zMIMEPart.as_stringc C s | j | jjdd�d�S )NT)�utf8�r7 )r@ r7 ZclonerA r r r rB � s zMIMEPart.__str__c C s | � d�}|d krdS |jdkS )Nr� F� attachment)ra Zcontent_disposition)r> r� r r r � is_attachment� s zMIMEPart.is_attachmentc c s |� � r d S |�� �d�\}}|dkrB||kr>|�|�|fV d S |dkrNd S |dkrz|�� D ]}| �||�E d H q^d S d|kr�|�d�|fV d }|�d�}|r�|�� D ]}|d |kr�|} q�q�|d kr�|�� }|r�|d nd }|d k �r| �||�E d H d S )Nr� �text� multipart�related�start� content-idr )r� r� r� r, � iter_parts� _find_bodyrc rl ) r> r� �preferencelist�maintype�subtypeZsubpart� candidater� Zsubpartsr r r r� � s6 zMIMEPart._find_body�r� �html�plainc C sB t |�}d}| �| |�D ]$\}}||k r|}|}|dkr q>q|S )a Return best candidate mime part for display as 'body' of message. Do a depth first search, starting with self, looking for the first part matching each of the items in preferencelist, and return the part corresponding to the first item that has a match, or None if no items have a match. If 'related' is not included in preferencelist, consider the root part of any multipart/related encountered as a candidate match. Ignore parts with 'Content-Disposition: attachment'. Nr )r r� )r> r� Z best_prioZbodyZprior� r r r �get_body� s zMIMEPart.get_body)r� r� )r� r� )r� r� )r� � alternativec c s$ | � � �d�\}}|dks"|dkr&dS | �� }z |�� }W n tk rP Y dS X |dkr�|dkr�| �d�}|r�d}g }|D ]"}|�d�|kr�d }q||�|� q||r�|E dH dS |�d � |E dH dS g } |D ]L}|� � �d�\}}||f| j k�r|� � �s|| k�r| �|� q�|V q�dS ) a Return an iterator over the non-main parts of a multipart. Skip the first of each occurrence of text/plain, text/html, multipart/related, or multipart/alternative in the multipart (unless they have a 'Content-Disposition: attachment' header) and include all remaining subparts in the returned iterator. When applied to a multipart/related, return all parts except the root part. Return an empty iterator when applied to a multipart/alternative or a non-multipart. r� r� r� Nr� r� Fr� Tr ) r� r� rl r� rV rc ra r. �pop� _body_typesr� ) r> r� r� rX r� r� r� Z attachmentsr� �seenr r r �iter_attachments sD �� zMIMEPart.iter_attachmentsc c s | � � dkr| �� E dH dS )z~Return an iterator over all immediate subparts of a multipart. Return an empty iterator for a non-multipart. r� N)r� rl rA r r r r� = s zMIMEPart.iter_parts)�content_managerc O s" |d kr| j j}|j| f|�|�S rR )r7 r� � get_content�r> r� �args�kwr r r r� E s zMIMEPart.get_contentc O s& |d kr| j j}|j| f|�|� d S rR )r7 r� � set_contentr� r r r r� J s zMIMEPart.set_contentc C s� | � � dkr6| �� }||f }||kr6td�||���g }g }| jD ]4\}}|�� �d�rj|�||f� qD|�||f� qD|r�t| �| j d�} || _| j | _ | g| _ ng | _ || _d| | d< |d k r�| � d|� d S )Nr� zCannot convert {} to {}�content-r� z multipart/rt r� ) r� r� r} r~ r8 r- � startswithr. r` r7 r: rw ) r> r� Zdisallowed_subtypesr� Zexisting_subtypeZ keep_headersZ part_headersr{ r& r� r r r �_make_multipartO s0 � zMIMEPart._make_multipartc C s | � dd|� d S )Nr� )r� �mixed�r� �r> r� r r r � make_relatedj s zMIMEPart.make_relatedc C s | � dd|� d S )Nr� )r� r� r� r r r �make_alternativem s zMIMEPart.make_alternativec C s | � dd|� d S )Nr� r r� r� r r r � make_mixedp s zMIMEPart.make_mixed)�_dispc O sf | � � dks| �� |kr(t| d| �� t| �| jd�}|j||� |rXd|krX||d< | �|� d S )Nr� Zmake_r� r� zContent-Disposition)r� r� �getattrr` r7 r� rY )r> Z_subtyper� r� r� r� r r r �_add_multiparts s � zMIMEPart._add_multipartc O s | j d|�ddi|�� d S )Nr� r� Zinline)r� �r� �r> r� r� r r r � add_related} s zMIMEPart.add_relatedc O s | j d|�|� d S )Nr� )r� r� r� r r r �add_alternative� s zMIMEPart.add_alternativec O s | j d|�ddi|�� d S )Nr� r� r� )r� r� r� r r r �add_attachment� s zMIMEPart.add_attachmentc C s g | _ d | _d S rR �r8 r: rA r r r �clear� s zMIMEPart.clearc C s dd� | j D �| _ d | _d S )Nc S s& g | ] \}}|� � �d �s||f�qS )r� )r- r� )r� �nr� r r r r� � s �z*MIMEPart.clear_content.<locals>.<listcomp>r rA r r r � clear_content� s zMIMEPart.clear_content)N)FNN)r� )N)N)N)r� r� r� r? r@ rB r� r� r� r� r� r� r� r� r� r� r� r� r� r r r r r � __classcell__r r r� r r� � s2 �7 r� c s e Zd Z� fdd�Z� ZS )r c s" t � j||� d| kr d| d< d S )Nrr rs )r� r� r� r� r r r� � s zEmailMessage.set_content)r� r� r� r� r r r r� r r � s )NT) r� �__all__�reri rf �ior r Zemailr r Zemail._policybaser r r r; Zemail._encoded_wordsr rn r� �compiler# r r' r3 r5 r r� r r r r r �<module> s6 " N ` __pycache__/generator.cpython-38.opt-2.pyc 0000644 00000021173 15204103444 0014333 0 ustar 00 U e5d�N � @ s� d ddgZ ddlZddlZddlZddlZddlmZ ddlmZm Z ddl m Z dZ d Z e�d �Ze�d ej�ZG d d � d �ZG d d� de�ZdZG dd� de�Zeeejd ��Zde ZejZdS )� Generator�DecodedGenerator�BytesGenerator� N)�deepcopy)�StringIO�BytesIO)�_has_surrogates�_� z \r\n|\r|\nz^From c @ s� e Zd Zd&dd�dd�Zdd� Zd'dd �Zd d � Zd d � Zdd� Zdd� Z dd� Z dd� Z dd� Z dd� Z e Zdd� Zd d � Zd d � Zd d!� Zed(d"d#��Zed$d%� �ZdS ))r N��policyc C s6 |d kr|d krdn|j }|| _|| _|| _|| _d S )NT)� mangle_from_�_fp� _mangle_from_� maxheaderlenr )�self�outfpr r r � r �'/usr/lib64/python3.8/email/generator.py�__init__$ s zGenerator.__init__c C s | j �|� d S �N)r �write�r �sr r r r D s zGenerator.writeFc C s� | j d kr|j n| j }|d k r*|j|d�}| jd k rB|j| jd�}|j| _| �| j�| _d| _| �| j�| _| j }|j }zL|| _ ||_ |r�|� � }|s�dt � t � � � }| � || j � | � |� W 5 || _ ||_ X d S )N)�linesep�Zmax_line_length� z From nobody )r �cloner r �_NL�_encode� _encoded_NLZ_EMPTY�_encoded_EMPTYZ get_unixfrom�time�ctimer �_write)r �msg�unixfromr r Zold_gen_policyZold_msg_policyZufromr r r �flattenH s, zGenerator.flattenc C s | j || jd | jd�S �Nr )� __class__r r )r �fpr r r r y s �zGenerator.clonec C s t � S r )r �r r r r � _new_buffer� s zGenerator._new_bufferc C s |S r r r r r r r � s zGenerator._encodec C sT |sd S t �|�}|d d� D ]}| �|� | �| j� q |d rP| �|d � d S )N���)�NLCRE�splitr r )r �lines�liner r r � _write_lines� s zGenerator._write_linesc C s� | j }z"d | _| �� | _ }| �|� W 5 || _ | j}| `X |r�t|�}|�d�d krd|d |d< n|�d|d � |�d|d � t|dd �}|d kr�| �|� n|| � | j � |� � � d S )N�content-transfer-encodingr �Content-Transfer-Encoding� content-type� �_write_headers) r � _munge_cter, � _dispatchr �getZreplace_header�getattrr7 r �getvalue)r r% ZoldfpZ munge_cteZsfp�methr r r r$ � s& zGenerator._writec C st |� � }|�� }t�||f��dd�}t| d| d �}|d krh|�dd�}t| d| d �}|d krh| j}||� d S )N�-r Z_handle_)�get_content_maintype�get_content_subtype� UNDERSCORE�join�replacer; � _writeBody)r r% �main�subZspecificr= Zgenericr r r r9 � s zGenerator._dispatchc C s6 |� � D ] \}}| �| j�||�� q| �| j� d S r )� raw_itemsr r Zfoldr �r r% �h�vr r r r7 � s zGenerator._write_headersc C s� |� � }|d krd S t|t�s.tdt|� ��t|j�r~|�d�}|d k r~t|�}|d= |� ||� |� � }|d |d f| _ | j r�t � d|�}| �|� d S )Nzstring payload expected: %s�charsetr3 r5 �>From )� get_payload� isinstance�str� TypeError�typer �_payloadZ get_paramr Z set_payloadr8 r �fcrerF r2 )r r% �payloadrK r r r � _handle_text� s$ � zGenerator._handle_textc C s� g }|� � }|d krg }n(t|t�r2| �|� d S t|t�sB|g}|D ]6}| �� }| �|�}|j|d| jd� |� |� � � qF|� � }|s�| j � |�}| �|�}|�|� |jd k r�| jr�t�d|j�} n|j} | �| � | �| j� | �d| | j � |�r| j�|�d�� |D ],} | �| jd | | j � | j�| � �q| �| jd | d | j � |jd k �r�| j�r�t�d|j�} n|j} | �| � d S )NF�r& r rL z--r )rM rN rO r �listr, r r' r �appendr< Z get_boundaryr rB �_make_boundaryZ set_boundary�preambler rS rF r2 r �pop�epilogue) r r% ZmsgtextsZsubparts�partr �g�boundaryZalltextrZ Z body_partr\ r r r �_handle_multipart sJ zGenerator._handle_multipartc C s0 | j }|jdd�| _ z| �|� W 5 || _ X d S )Nr r )r r r` )r r% �pr r r �_handle_multipart_signed< s z"Generator._handle_multipart_signedc C s� g }|� � D ]t}| �� }| �|�}|j|d| jd� |�� }|�| j�}|rv|d | jkrv|� | j� |d d� �� q |� |� q | j � | j� |�� d S )NFrV r- ) rM r, r r' r r< r/ r r! rX rB r r )r r% Zblocksr] r r^ �textr0 r r r � _handle_message_delivery_statusG s z)Generator._handle_message_delivery_statusc C s^ | � � }| �|�}|j}t|t�rD|j|�d�d| jd� |�� }n | � |�}| j � |� d S )Nr FrV ) r, r rR rN rW r' rM r r< r r r )r r% r r^ rT r r r �_handle_message\ s zGenerator._handle_messagec C sv t �tj�}dt| d }|d kr(|S |}d}| �dt�|� d tj�}|� |�sXqr|d t |� }|d7 }q0|S )Nz===============z==r z^--z(--)?$�.r6 ) �randomZ randrange�sys�maxsize�_fmt� _compile_re�re�escape� MULTILINE�searchrO )�clsrc �tokenr_ �bZcounterZcrer r r rY u s zGenerator._make_boundaryc C s t �||�S r )rl �compile�rp r �flagsr r r rk � s zGenerator._compile_re)NN)FN)N)�__name__� __module__� __qualname__r r r' r r, r r2 r$ r9 r7 rU rD r` rb rd re � classmethodrY rk r r r r r s, � 1' : c sL e Zd Zdd� Zdd� Zdd� Zdd� Z� fd d �ZeZe d d � �Z � Z S ) r c C s | j �|�dd�� d S )N�ascii�surrogateescape)r r �encoder r r r r � s zBytesGenerator.writec C s t � S r )r r+ r r r r, � s zBytesGenerator._new_bufferc C s |� d�S �Nrz )r| r r r r r � s zBytesGenerator._encodec C s8 |� � D ] \}}| j�| j�||�� q| �| j� d S r )rG r r r Z fold_binaryr rH r r r r7 � s z BytesGenerator._write_headersc s\ |j d krd S t|j �rH| jjdksH| jr:t�d|j �|_ | �|j � ntt | �� |� d S )NZ7bitrL ) rR r r Zcte_typer rS rF r2 �superr rU )r r% �r) r r rU � s zBytesGenerator._handle_textc C s t �|�d�|�S r} )rl rs r| rt r r r rk � s zBytesGenerator._compile_re) rv rw rx r r, r r7 rU rD ry rk � __classcell__r r r r r � s zD[Non-text (%(type)s) part of message omitted, filename %(filename)s]c @ s$ e Zd Zddd�dd�Zdd� ZdS )r Nr c C s. t j| ||||d� |d kr$t| _n|| _d S r( )r r �_FMTrj )r r r r Zfmtr r r r r � s �zDecodedGenerator.__init__c C s� |� � D ]v}|�� }|dkr2t|jdd�| d� q|dkr<qt| j|�� |�� |�� |�d�|�dd�|�d d �d � | d� qd S ) Nrc F)�decode)�fileZ multipartz [no filename]zContent-Descriptionz[no description]r4 z [no encoding])rQ �maintypeZsubtype�filenameZ description�encoding) �walkr? �printrM rj Zget_content_typer@ � get_filenamer: )r r% r] r� r r r r9 � s( ��� �zDecodedGenerator._dispatch)NNN)rv rw rx r r9 r r r r r � s � r6 z%%0%dd) �__all__rl rh r" rg �copyr �ior r Z email.utilsr rA �NLrs r. rn rS r r r� r �len�reprri Z_widthrj rY r r r r �<module> s( t3; __pycache__/_parseaddr.cpython-38.opt-2.pyc 0000644 00000022446 15204103444 0014455 0 ustar 00 U e5dE � @ s� d dddgZ ddlZddlZdZdZdZd d d d d dddddddddddd dddd d d d gZd d!d"d#d$d%d&gZddddd'd(d)d'd*d)d+d*d,d+d-�Zd.d� Z d/d0� Z d1d� Z d2d � Z d3d� Z G d4d5� d5�ZG d6d7� d7e�ZdS )8� mktime_tz� parsedate� parsedate_tz�quote� N� � z, ZjanZfebZmarZaprZmayZjunZjulZaug�sep�octZnovZdecZjanuaryZfebruaryZmarchZaprilZjuneZjulyZaugustZ septemberZoctoberZnovemberZdecemberZmonZtueZwedZthuZfriZsatZsunip���i���i ���i����iD���i��)ZUTZUTCZGMT�ZZASTZADTZESTZEDTZCSTZCDTZMSTZMDTZPSTZPDTc C s, t | �}|sd S |d d kr$d|d< t|�S )N� r )� _parsedate_tz�tuple)�data�res� r �(/usr/lib64/python3.8/email/_parseaddr.pyr - s c C s� | sd S | � � } | sd S | d �d�s6| d �� tkr>| d= n.| d �d�}|dkrl| d |d d � | d< t| �dkr�| d � d�}t|�dkr�|| dd � } t| �dk�r| d }|�d�}|dkr�|�d�}|dkr�|d |� ||d � g| dd �< n | �d � t| �d k �rd S | d d � } | \}}}}}|�� }|tk�rb||�� }}|tk�rbd S t� |�d }|d k�r�|d 8 }|d dk�r�|d d� }|�d �}|dk�r�|| }}|d dk�r�|d d� }|d � � �s�|| }}|d dk�r|d d� }|� d �}t|�d k�r,|\} } d} n~t|�dk�rF|\} } } ndt|�dk�r�d|d k�r�|d � d�}t|�d k�r�|\} } d} nt|�dk�r�|\} } } nd S z,t |�}t |�}t | �} t | �} t | �} W n t k �r� Y d S X |dk �r|dk�r|d7 }n|d7 }d } |� � }|tk�r6t| } n>z t |�} W n t k �rX Y nX | dk�rt|�d��rtd } | �r�| dk �r�d} | } nd} | | d d | d d } |||| | | ddd| g S )Nr �,� � �-� �+���r � � �:� �0�.�d �D il i� i �< )�split�endswith�lower� _daynames�rfind�len�find�append� _monthnames�index�isdigit�int� ValueError�upper� _timezones� startswith)r �iZstuff�sZddZmmZyyZtmZtzZthhZtmmZtssZtzoffsetZtzsignr r r r 9 s� " r c C s& t | �}t|t�r |d d� S |S d S )Nr )r � isinstancer �r �tr r r r � s c C s< | d d kr"t �| d d� d �S t�| �}|| d S d S )Nr � )r )�time�mktime�calendarZtimegmr5 r r r r � s c C s | � dd�� dd�S )N�\z\\�"z\")�replace)�strr r r r � s c @ sx e Zd Zdd� Zdd� Zdd� Zdd� Zd d � Zd d � Zd d� Z d dd�Z dd� Z dd� Z dd� Z d dd�Zdd � ZdS ) � AddrlistClassc C sZ d| _ d| _d| _d| _| j| j | _| j | j | j | _| j�dd�| _|| _g | _ d S )Nz ()<>@,:;."[]r z z r r ) �specials�pos�LWSZCR�FWS�atomendsr= � phraseends�field� commentlist��selfrF r r r �__init__� s zAddrlistClass.__init__c C s� g }| j t| j�k r�| j| j | jd kr\| j| j dkrL|�| j| j � | j d7 _ q| j| j dkr�| j�| �� � qq�qt�|�S )Nz r �() rA r' rF rB r) rG � getcomment� EMPTYSTRING�join)rI Zwslistr r r �gotonext� s zAddrlistClass.gotonextc C s: g }| j t| j�k r6| �� }|r*||7 }q|�d� q|S )N)r r )rA r' rF � getaddressr) )rI �resultZadr r r � getaddrlist� s zAddrlistClass.getaddrlistc C s� g | _ | �� | j}| j }| �� }| �� g }| jt| j�kr\|rXt�| j �|d fg}�n\| j| j dkr�|| _|| _ | �� }t�| j �|fg}�n"| j| j dk�r g }t| j�}| jd7 _| jt| j�k �r�| �� | j|k �r| j| j dk�r| jd7 _�q�|| � � }q�n�| j| j dk�rx| � � }| j �rft�|�d d�| j � d |fg}nt�|�|fg}n@|�r�t�| j �|d fg}n"| j| j | j k�r�| jd7 _| �� | jt| j�k �r�| j| j d k�r�| jd7 _|S ) Nr z.@r r �;�<z (r �)r ) rG rO rA � getphraselistr' rF �SPACErN � getaddrspecrP � getrouteaddrr@ )rI ZoldposZoldcl�plistZ returnlistZaddrspecZfieldlenZ routeaddrr r r rP sX ���$zAddrlistClass.getaddressc C s� | j | j dkrd S d}| jd7 _| �� d}| jt| j �k r�|rT| �� d}n~| j | j dkrv| jd7 _q�n\| j | j dkr�| jd7 _d}n8| j | j dkr�| jd7 _n| �� }| jd7 _q�| �� q2|S ) NrT Fr r �>�@Tr )rF rA rO r' � getdomainrX )rI Z expectrouteZadlistr r r rY A s. zAddrlistClass.getrouteaddrc C sT g }| � � | jt| j�k r�d}| j| j dkrf|rH|d �� sH|�� |�d� | jd7 _d}nd| j| j dkr�|�dt| �� � � n<| j| j | j kr�|r�|d �� s�|�� q�n|�| � � � | � � }|r |r |�|� q | jt| j�k�s | j| j dk�rt � |�S |�d� | jd7 _| � � | � � }|�sFt S t � |�| S ) NTr r r Fr< z"%s"r\ )rO rA r' rF �strip�popr) r �getquoterD �getatomrM rN r] )rI ZaslistZ preserve_wsZwsZdomainr r r rX a s: $ zAddrlistClass.getaddrspecc C s� g }| j t| j�k r�| j| j | jkr6| j d7 _ q| j| j dkrX| j�| �� � q| j| j dkrx|�| �� � q| j| j dkr�| j d7 _ |�d� q| j| j dkr�tS | j| j | j kr�q�q|�| � � � qt� |�S )Nr rK �[r r\ ) rA r' rF rB rG r) rL �getdomainliteralrM rD ra rN )rI Zsdlistr r r r] � s" zAddrlistClass.getdomainTc C s� | j | j |krdS dg}d}| jd7 _| jt| j �k r�|rX|�| j | j � d}np| j | j |krz| jd7 _q�nN|r�| j | j dkr�|�| �� � q,n(| j | j dkr�d}n|�| j | j � | jd7 _q,t�|�S )Nr Fr rK r; T)rF rA r' r) rL rM rN )rI Z begincharZendcharsZ allowcommentsZslistr r r r � getdelimited� s( zAddrlistClass.getdelimitedc C s | � ddd�S )Nr< z" F�rd �rI r r r r` � s zAddrlistClass.getquotec C s | � ddd�S )NrK z) Tre rf r r r rL � s zAddrlistClass.getcommentc C s d| � ddd� S )Nz[%s]rb z] Fre rf r r r rc � s z AddrlistClass.getdomainliteralNc C sd dg}|d kr| j }| jt| j�k rZ| j| j |kr8qZn|�| j| j � | jd7 _qt�|�S )Nr r )rD rA r' rF r) rM rN )rI rD Zatomlistr r r ra � s zAddrlistClass.getatomc C s� g }| j t| j�k r�| j| j | jkr6| j d7 _ q| j| j dkrV|�| �� � q| j| j dkrx| j�| �� � q| j| j | jkr�q�q|�| � | j�� q|S )Nr r< rK ) rA r' rF rC r) r` rG rL rE ra )rI rZ r r r rV � s zAddrlistClass.getphraselist)T)N)�__name__� __module__� __qualname__rJ rO rR rP rY rX r] rd r` rL rc ra rV r r r r r? � s ; & % r? c @ sD e Zd Zdd� Zdd� Zdd� Zdd� Zd d � Zd d � Zd d� Z dS )� AddressListc C s& t �| |� |r | �� | _ng | _d S �N)r? rJ rR � addresslistrH r r r rJ � s zAddressList.__init__c C s t | j�S rk )r' rl rf r r r �__len__ s zAddressList.__len__c C s> t d �}| jd d � |_|jD ]}|| jkr |j�|� q |S rk �rj rl r) �rI �otherZnewaddr�xr r r �__add__ s zAddressList.__add__c C s& |j D ]}|| j kr| j �|� q| S rk )rl r) �rI rp rq r r r �__iadd__ s zAddressList.__iadd__c C s. t d �}| jD ]}||jkr|j�|� q|S rk rn ro r r r �__sub__ s zAddressList.__sub__c C s& |j D ]}|| j kr| j �|� q| S rk )rl �removers r r r �__isub__ s zAddressList.__isub__c C s | j | S rk )rl )rI r+ r r r � __getitem__% s zAddressList.__getitem__N) rg rh ri rJ rm rr rt ru rw rx r r r r rj � s rj )�__all__r8 r: rW rM Z COMMASPACEr* r% r0 r r r r r r? rj r r r r �<module> sb � � � w / __pycache__/__init__.cpython-38.opt-1.pyc 0000644 00000003235 15204103444 0014102 0 ustar 00 U e5d� � @ sN d Z ddddddddd d d d d ddddgZdd � Zdd � Zdd � Zdd � ZdS )z?A package for parsing, handling, and generating email messages.Z base64mime�charsetZencoders�errorsZ feedparser� generator�headerZ iterators�message�message_from_file�message_from_binary_file�message_from_string�message_from_bytesZmime�parserZ quoprimimeZutilsc O s ddl m} |||��| �S )zvParse a string into a Message object model. Optional _class and strict are passed to the Parser constructor. � ��Parser)� email.parserr Zparsestr)�s�args�kwsr � r �&/usr/lib64/python3.8/email/__init__.pyr s c O s ddl m} |||��| �S )z|Parse a bytes string into a Message object model. Optional _class and strict are passed to the Parser constructor. r �� BytesParser)r r Z parsebytes)r r r r r r r r ( s c O s ddl m} |||��| �S )z�Read a file and parse its contents into a Message object model. Optional _class and strict are passed to the Parser constructor. r r )r r �parse)�fpr r r r r r r 0 s c O s ddl m} |||��| �S )z�Read a binary file and parse its contents into a Message object model. Optional _class and strict are passed to the Parser constructor. r r )r r r )r r r r r r r r 8 s N)�__doc__�__all__r r r r r r r r �<module> s, � __pycache__/_policybase.cpython-38.pyc 0000644 00000034734 15204103444 0013705 0 ustar 00 U e5d�: � @ s� d Z ddlZddlmZ ddlmZ ddlmZ dddgZG d d � d �Z d d � Z d d� Z G dd� de ej d�Z e G dd� de ��Ze� ZdS )zwPolicy framework for the email package. Allows fine grained feature control of how the package parses and emits data. � N)�header)�charset)�_has_surrogates�Policy�Compat32�compat32c s@ e Zd ZdZ� fdd�Zdd� Zdd� Zdd � Zd d � Z� Z S ) � _PolicyBasea� Policy Object basic framework. This class is useless unless subclassed. A subclass should define class attributes with defaults for any values that are to be managed by the Policy object. The constructor will then allow non-default values to be set for these attributes at instance creation time. The instance will be callable, taking these same attributes keyword arguments, and returning a new instance identical to the called instance except for those values changed by the keyword arguments. Instances may be added, yielding new instances with any non-default values from the right hand operand overriding those in the left hand operand. That is, A + B == A(<non-default values of B>) The repr of an instance can be used to reconstruct the object if and only if the repr of the values can be used to reconstruct those values. c sH |� � D ]:\}}t| |�r.tt| ��||� qtd�|| jj���qdS )z�Create new Policy, possibly overriding some defaults. See class docstring for a list of overridable attributes. �*{!r} is an invalid keyword argument for {}N) �items�hasattr�superr � __setattr__� TypeError�format� __class__�__name__)�self�kw�name�value�r � �)/usr/lib64/python3.8/email/_policybase.py�__init__) s ��z_PolicyBase.__init__c C s* dd� | j �� D �}d�| jjd�|��S )Nc S s g | ]\}}d � ||��qS )z{}={!r})r )�.0r r r r r � <listcomp>8 s �z(_PolicyBase.__repr__.<locals>.<listcomp>z{}({})z, )�__dict__r r r r �join)r �argsr r r �__repr__7 s �z_PolicyBase.__repr__c K sr | j �| j �}| j�� D ]\}}t�|||� q|�� D ]4\}}t| |�s^td�|| j j ���t�|||� q8|S )z�Return a new instance with specified attributes changed. The new instance has the same attribute values as the current object, except for the changes passed in as keyword arguments. r ) r �__new__r r �objectr r r r r )r r Z newpolicy�attrr r r r �clone< s ��z_PolicyBase.clonec C s, t | |�rd}nd}t|�| jj|���d S )Nz'{!r} object attribute {!r} is read-onlyz!{!r} object has no attribute {!r})r �AttributeErrorr r r )r r r �msgr r r r N s z_PolicyBase.__setattr__c C s | j f |j�S )z�Non-default values from right operand override those from left. The object returned is a new instance of the subclass. )r# r )r �otherr r r �__add__U s z_PolicyBase.__add__) r � __module__� __qualname__�__doc__r r r# r r' � __classcell__r r r r r s r c C s, | � dd�d } |�dd�d }| d | S )N� � r )�rsplit�split)�docZ added_docr r r � _append_doc^ s r1 c C s� | j r(| j �d�r(t| jd j | j �| _ | j�� D ]V\}}|j r2|j �d�r2dd� | jD �D ]*}tt||�d�}|r\t||j �|_ q2q\q2| S )N�+r c s s | ]}|� � D ] }|V qqd S )N)�mro)r �base�cr r r � <genexpr>h s z%_extend_docstrings.<locals>.<genexpr>r* )r* � startswithr1 � __bases__r r �getattr)�clsr r" r5 r0 r r r �_extend_docstringsc s r; c @ s� e Zd ZdZdZdZdZdZdZdZ dd� Z d d � Z d d � Z e jd d� �Ze jdd� �Ze jdd� �Ze jdd� �Ze jdd� �ZdS )r aI Controls for how messages are interpreted and formatted. Most of the classes and many of the methods in the email package accept Policy objects as parameters. A Policy object contains a set of values and functions that control how input is interpreted and how output is rendered. For example, the parameter 'raise_on_defect' controls whether or not an RFC violation results in an error being raised or not, while 'max_line_length' controls the maximum length of output lines when a Message is serialized. Any valid attribute may be overridden when a Policy is created by passing it as a keyword argument to the constructor. Policy objects are immutable, but a new Policy object can be created with only certain values changed by calling the Policy instance with keyword arguments. Policy objects can also be added, producing a new Policy object in which the non-default attributes set in the right hand operand overwrite those specified in the left operand. Settable attributes: raise_on_defect -- If true, then defects should be raised as errors. Default: False. linesep -- string containing the value to use as separation between output lines. Default '\n'. cte_type -- Type of allowed content transfer encodings 7bit -- ASCII only 8bit -- Content-Transfer-Encoding: 8bit is allowed Default: 8bit. Also controls the disposition of (RFC invalid) binary data in headers; see the documentation of the binary_fold method. max_line_length -- maximum length of lines, excluding 'linesep', during serialization. None or 0 means no line wrapping is done. Default is 78. mangle_from_ -- a flag that, when True escapes From_ lines in the body of the message by putting a `>' in front of them. This is used when the message is being serialized by a generator. Default: True. message_factory -- the class to use to create new message objects. If the value is None, the default is Message. Fr, Z8bit�N Nc C s | j r |�| �||� dS )aZ Based on policy, either raise defect or call register_defect. handle_defect(obj, defect) defect should be a Defect subclass, but in any case must be an Exception subclass. obj is the object on which the defect should be registered if it is not raised. If the raise_on_defect is True, the defect is raised as an error, otherwise the object and the defect are passed to register_defect. This method is intended to be called by parsers that discover defects. The email package parsers always call it with Defect instances. N)�raise_on_defect�register_defect�r �objZdefectr r r � handle_defect� s zPolicy.handle_defectc C s |j �|� dS )a� Record 'defect' on 'obj'. Called by handle_defect if raise_on_defect is False. This method is part of the Policy API so that Policy subclasses can implement custom defect handling. The default implementation calls the append method of the defects attribute of obj. The objects used by the email package by default that get passed to this method will always have a defects attribute with an append method. N)Zdefects�appendr? r r r r> � s zPolicy.register_defectc C s dS )a[ Return the maximum allowed number of headers named 'name'. Called when a header is added to a Message object. If the returned value is not 0 or None, and there are already a number of headers with the name 'name' equal to the value returned, a ValueError is raised. Because the default behavior of Message's __setitem__ is to append the value to the list of headers, it is easy to create duplicate headers without realizing it. This method allows certain headers to be limited in the number of instances of that header that may be added to a Message programmatically. (The limit is not observed by the parser, which will faithfully produce as many headers as exist in the message being parsed.) The default implementation returns None for all header names. Nr )r r r r r �header_max_count� s zPolicy.header_max_countc C s t �dS )aZ Given a list of linesep terminated strings constituting the lines of a single header, return the (name, value) tuple that should be stored in the model. The input lines should retain their terminating linesep characters. The lines passed in by the email package may contain surrogateescaped binary data. N��NotImplementedError)r � sourcelinesr r r �header_source_parse� s zPolicy.header_source_parsec C s t �dS )z�Given the header name and the value provided by the application program, return the (name, value) that should be stored in the model. NrD �r r r r r r �header_store_parse� s zPolicy.header_store_parsec C s t �dS )aw Given the header name and the value from the model, return the value to be returned to the application program that is requesting that header. The value passed in by the email package may contain surrogateescaped binary data if the lines were parsed by a BytesParser. The returned value should not contain any surrogateescaped data. NrD rH r r r �header_fetch_parse� s zPolicy.header_fetch_parsec C s t �dS )a� Given the header name and the value from the model, return a string containing linesep characters that implement the folding of the header according to the policy controls. The value passed in by the email package may contain surrogateescaped binary data if the lines were parsed by a BytesParser. The returned value should not contain any surrogateescaped data. NrD rH r r r �fold� s z Policy.foldc C s t �dS )a% Given the header name and the value from the model, return binary data containing linesep characters that implement the folding of the header according to the policy controls. The value passed in by the email package may contain surrogateescaped binary data. NrD rH r r r � fold_binary s zPolicy.fold_binary)r r( r) r* r= �linesep�cte_type�max_line_length� mangle_from_Zmessage_factoryrA r> rC �abc�abstractmethodrG rI rJ rK rL r r r r r p s( 0 )� metaclassc @ sL e Zd ZdZdZdd� Zdd� Zdd� Zd d � Zd d � Z d d� Z dd� Z dS )r z�+ This particular policy is the backward compatibility Policy. It replicates the behavior of the email package version 5.1. Tc C s0 t |t�s|S t|�r(tj|tj|d�S |S d S )N�r � header_name)� isinstance�strr r �Header�_charset� UNKNOWN8BITrH r r r �_sanitize_header s �zCompat32._sanitize_headerc C s> |d � dd�\}}|�d�d�|dd� � }||�d�fS )a: + The name is parsed as everything up to the ':' and returned unmodified. The value is determined by stripping leading whitespace off the remainder of the first line, joining all subsequent lines together, and stripping any trailing carriage return or linefeed characters. r �:r- z � Nz )r/ �lstripr �rstrip)r rF r r r r r rG % s z Compat32.header_source_parsec C s ||fS )z>+ The name and value are returned unmodified. r rH r r r rI 1 s zCompat32.header_store_parsec C s | � ||�S )z�+ If the value contains binary data, it is converted into a Header object using the unknown-8bit charset. Otherwise it is returned unmodified. )r[ rH r r r rJ 7 s zCompat32.header_fetch_parsec C s | j ||dd�S )a + Headers are folded using the Header folding algorithm, which preserves existing line breaks in the value, and wraps each resulting line to the max_line_length. Non-ASCII binary data are CTE encoded using the unknown-8bit charset. T��sanitize)�_foldrH r r r rK > s z Compat32.foldc C s" | j ||| jdkd�}|�dd�S )a� + Headers are folded using the Header folding algorithm, which preserves existing line breaks in the value, and wraps each resulting line to the max_line_length. If cte_type is 7bit, non-ascii binary data is CTE encoded using the unknown-8bit charset. Otherwise the original source header is used, with its existing line breaks and/or binary data. Z7bitr` �ascii�surrogateescape)rb rN �encode)r r r Zfoldedr r r rL H s zCompat32.fold_binaryc C s� g }|� d| � t|t�r\t|�rL|r<tj|tj|d�}qZ|� |� d }q`tj||d�}n|}|d k r�d}| jd k r|| j}|� |j | j |d�� |� | j � d� |�S )Nz%s: rT )rU r )rM � maxlinelenr] ) rB rV rW r r rX rY rZ rO re rM r )r r r ra �parts�hrf r r r rb T s( � zCompat32._foldN) r r( r) r* rP r[ rG rI rJ rK rL rb r r r r r s )r* rQ Zemailr r rY Z email.utilsr �__all__r r1 r; �ABCMetar r r r r r r �<module> s �L f __pycache__/encoders.cpython-38.opt-2.pyc 0000644 00000002357 15204103444 0014152 0 ustar 00 U e5d� � @ sP d dddgZ ddlmZ ddlmZ dd� Zd d� Zd d� Z d d � Z d d� Z d S )�encode_7or8bit� encode_base64� encode_noop� encode_quopri� )� encodebytes)� encodestringc C s t | dd�}|�dd�S )NT)Z quotetabs� s =20)� _encodestring�replace)�s�enc� r �&/usr/lib64/python3.8/email/encoders.py�_qencode s r c C s0 | j dd�}tt|�d�}| �|� d| d< d S )NT��decode�ascii�base64�Content-Transfer-Encoding)� get_payload�str�_bencode� set_payload��msg�origZencdatar r r r s c C s* | j dd�}t|�}| �|� d| d< d S )NTr zquoted-printabler )r r r r r r r r & s c C sX | j dd�}|d kr d| d< d S z|�d� W n tk rJ d| d< Y n X d| d< d S )NTr Z7bitr r Z8bit)r r � UnicodeError)r r r r r r 2 s c C s d S )Nr )r r r r r D s N) �__all__r r r �quoprir r r r r r r r r r r �<module> s � __pycache__/generator.cpython-38.opt-1.pyc 0000644 00000030356 15204103444 0014335 0 ustar 00 U e5d�N � @ s� d Z dddgZddlZddlZddlZddlZddlmZ ddlm Z m Z ddl m Z d Z d Ze�d �Ze�d ej�ZG d d� d�ZG dd� de�ZdZG dd� de�Zeeejd ��Zde Zej Z dS )z:Classes to generate plain text from a message object tree.� Generator�DecodedGenerator�BytesGenerator� N)�deepcopy)�StringIO�BytesIO)�_has_surrogates�_� z \r\n|\r|\nz^From c @ s� e Zd ZdZd'dd�dd�Zdd� Zd(d d �Zd d � Zd d� Zdd� Z dd� Z dd� Z dd� Z dd� Z dd� ZeZdd � Zd d � Zd d � Zd!d"� Zed)d#d$��Zed%d&� �ZdS )*r z�Generates output from a Message object tree. This basic generator writes the message to the given file object as plain text. N��policyc C s6 |dkr|dkrdn|j }|| _|| _|| _|| _dS )a� Create the generator for message flattening. outfp is the output file-like object for writing the message to. It must have a write() method. Optional mangle_from_ is a flag that, when True (the default if policy is not set), escapes From_ lines in the body of the message by putting a `>' in front of them. Optional maxheaderlen specifies the longest length for a non-continued header. When a header line is longer (in characters, with tabs expanded to 8 spaces) than maxheaderlen, the header will split as defined in the Header class. Set maxheaderlen to zero to disable header wrapping. The default is 78, as recommended (but not required) by RFC 2822. The policy keyword specifies a policy object that controls a number of aspects of the generator's operation. If no policy is specified, the policy associated with the Message object passed to the flatten method is used. NT)� mangle_from_�_fp� _mangle_from_� maxheaderlenr )�self�outfpr r r � r �'/usr/lib64/python3.8/email/generator.py�__init__$ s zGenerator.__init__c C s | j �|� d S �N)r �write�r �sr r r r D s zGenerator.writeFc C s� | j dkr|j n| j }|dk r*|j|d�}| jdk rB|j| jd�}|j| _| �| j�| _d| _| �| j�| _| j }|j }zL|| _ ||_ |r�|� � }|s�dt � t � � � }| � || j � | � |� W 5 || _ ||_ X dS )a� Print the message object tree rooted at msg to the output file specified when the Generator instance was created. unixfrom is a flag that forces the printing of a Unix From_ delimiter before the first object in the message tree. If the original message has no From_ delimiter, a `standard' one is crafted. By default, this is False to inhibit the printing of any From_ delimiter. Note that for subobjects, no From_ line is printed. linesep specifies the characters used to indicate a new line in the output. The default value is determined by the policy specified when the Generator instance was created or, if none was specified, from the policy associated with the msg. N)�linesep�Zmax_line_length� z From nobody )r �cloner r �_NL�_encode� _encoded_NLZ_EMPTY�_encoded_EMPTYZ get_unixfrom�time�ctimer �_write)r �msg�unixfromr r Zold_gen_policyZold_msg_policyZufromr r r �flattenH s, zGenerator.flattenc C s | j || jd| jd�S )z1Clone this generator with the exact same options.Nr )� __class__r r )r �fpr r r r y s �zGenerator.clonec C s t � S r )r �r r r r � _new_buffer� s zGenerator._new_bufferc C s |S r r r r r r r � s zGenerator._encodec C sT |sd S t �|�}|d d� D ]}| �|� | �| j� q |d rP| �|d � d S )N���)�NLCRE�splitr r )r �lines�liner r r � _write_lines� s zGenerator._write_linesc C s� | j }z"d | _| �� | _ }| �|� W 5 || _ | j}| `X |r�t|�}|�d�d krd|d |d< n|�d|d � |�d|d � t|dd �}|d kr�| �|� n|| � | j � |� � � d S )N�content-transfer-encodingr �Content-Transfer-Encoding� content-type� �_write_headers) r � _munge_cter+ � _dispatchr �getZreplace_header�getattrr6 r �getvalue)r r% ZoldfpZ munge_cteZsfp�methr r r r$ � s& zGenerator._writec C st |� � }|�� }t�||f��dd�}t| d| d �}|d krh|�dd�}t| d| d �}|d krh| j}||� d S )N�-r Z_handle_)�get_content_maintype�get_content_subtype� UNDERSCORE�join�replacer: � _writeBody)r r% �main�subZspecificr< Zgenericr r r r8 � s zGenerator._dispatchc C s6 |� � D ] \}}| �| j�||�� q| �| j� d S r )� raw_itemsr r Zfoldr �r r% �h�vr r r r6 � s zGenerator._write_headersc C s� |� � }|d krd S t|t�s.tdt|� ��t|j�r~|�d�}|d k r~t|�}|d= |� ||� |� � }|d |d f| _ | j r�t � d|�}| �|� d S )Nzstring payload expected: %s�charsetr2 r4 �>From )� get_payload� isinstance�str� TypeError�typer �_payloadZ get_paramr Z set_payloadr7 r �fcrerE r1 )r r% �payloadrJ r r r � _handle_text� s$ � zGenerator._handle_textc C s� g }|� � }|d krg }n(t|t�r2| �|� d S t|t�sB|g}|D ]6}| �� }| �|�}|j|d| jd� |� |� � � qF|� � }|s�| j � |�}| �|�}|�|� |jd k r�| jr�t�d|j�} n|j} | �| � | �| j� | �d| | j � |�r| j�|�d�� |D ],} | �| jd | | j � | j�| � �q| �| jd | d | j � |jd k �r�| j�r�t�d|j�} n|j} | �| � d S )NF�r& r rK z--r )rL rM rN r �listr+ r r' r �appendr; Z get_boundaryr rA �_make_boundaryZ set_boundary�preambler rR rE r1 r �pop�epilogue) r r% ZmsgtextsZsubparts�partr �g�boundaryZalltextrY Z body_partr[ r r r �_handle_multipart sJ zGenerator._handle_multipartc C s0 | j }|jdd�| _ z| �|� W 5 || _ X d S )Nr r )r r r_ )r r% �pr r r �_handle_multipart_signed< s z"Generator._handle_multipart_signedc C s� g }|� � D ]t}| �� }| �|�}|j|d| jd� |�� }|�| j�}|rv|d | jkrv|� | j� |d d� �� q |� |� q | j � | j� |�� d S )NFrU r, ) rL r+ r r' r r; r. r r! rW rA r r )r r% Zblocksr\ r r] �textr/ r r r � _handle_message_delivery_statusG s z)Generator._handle_message_delivery_statusc C s^ | � � }| �|�}|j}t|t�rD|j|�d�d| jd� |�� }n | � |�}| j � |� d S )Nr FrU ) r+ r rQ rM rV r' rL r r; r r r )r r% r r] rS r r r �_handle_message\ s zGenerator._handle_messagec C sv t �tj�}dt| d }|d kr(|S |}d}| �dt�|� d tj�}|� |�sXqr|d t |� }|d7 }q0|S )Nz===============z==r z^--z(--)?$�.r5 ) �randomZ randrange�sys�maxsize�_fmt� _compile_re�re�escape� MULTILINE�searchrN )�clsrb �tokenr^ �bZcounterZcrer r r rX u s zGenerator._make_boundaryc C s t �||�S r )rk �compile�ro r �flagsr r r rj � s zGenerator._compile_re)NN)FN)N)�__name__� __module__� __qualname__�__doc__r r r' r r+ r r1 r$ r8 r6 rT rC r_ ra rc rd � classmethodrX rj r r r r r s. � 1' : c sP e Zd ZdZdd� Zdd� Zdd� Zdd � Z� fd d �ZeZ e d d � �Z � Z S )r a� Generates a bytes version of a Message object tree. Functionally identical to the base Generator except that the output is bytes and not string. When surrogates were used in the input to encode bytes, these are decoded back to bytes for output. If the policy has cte_type set to 7bit, then the message is transformed such that the non-ASCII bytes are properly content transfer encoded, using the charset unknown-8bit. The outfp object must accept bytes in its write method. c C s | j �|�dd�� d S )N�ascii�surrogateescape)r r �encoder r r r r � s zBytesGenerator.writec C s t � S r )r r* r r r r+ � s zBytesGenerator._new_bufferc C s |� d�S �Nrz )r| r r r r r � s zBytesGenerator._encodec C s8 |� � D ] \}}| j�| j�||�� q| �| j� d S r )rF r r r Z fold_binaryr rG r r r r6 � s z BytesGenerator._write_headersc s\ |j d krd S t|j �rH| jjdksH| jr:t�d|j �|_ | �|j � ntt | �� |� d S )NZ7bitrK ) rQ r r Zcte_typer rR rE r1 �superr rT )r r% �r( r r rT � s zBytesGenerator._handle_textc C s t �|�d�|�S r} )rk rr r| rs r r r rj � s zBytesGenerator._compile_re) ru rv rw rx r r+ r r6 rT rC ry rj � __classcell__r r r r r � s zD[Non-text (%(type)s) part of message omitted, filename %(filename)s]c @ s( e Zd ZdZddd�dd�Zdd� ZdS ) r z�Generates a text representation of a message. Like the Generator base class, except that non-text parts are substituted with a format string representing the part. Nr c C s. t j| ||||d� |dkr$t| _n|| _dS )a� Like Generator.__init__() except that an additional optional argument is allowed. Walks through all subparts of a message. If the subpart is of main type `text', then it prints the decoded payload of the subpart. Otherwise, fmt is a format string that is used instead of the message payload. fmt is expanded with the following keywords (in %(keyword)s format): type : Full MIME type of the non-text part maintype : Main MIME type of the non-text part subtype : Sub-MIME type of the non-text part filename : Filename of the non-text part description: Description associated with the non-text part encoding : Content transfer encoding of the non-text part The default value for fmt is None, meaning [Non-text (%(type)s) part of message omitted, filename %(filename)s] r N)r r �_FMTri )r r r r Zfmtr r r r r � s �zDecodedGenerator.__init__c C s� |� � D ]v}|�� }|dkr2t|jdd�| d� q|dkr<qt| j|�� |�� |�� |�d�|�dd�|�d d �d � | d� qd S ) Nrb F)�decode)�fileZ multipartz [no filename]zContent-Descriptionz[no description]r3 z [no encoding])rP �maintypeZsubtype�filenameZ description�encoding) �walkr> �printrL ri Zget_content_typer? � get_filenamer9 )r r% r\ r� r r r r8 � s( ��� �zDecodedGenerator._dispatch)NNN)ru rv rw rx r r8 r r r r r � s � r5 z%%0%dd) rx �__all__rk rg r" rf �copyr �ior r Z email.utilsr r@ �NLrr r- rm rR r r r� r �len�reprrh Z_widthri rX r r r r �<module> s* t3; __pycache__/__init__.cpython-38.opt-2.pyc 0000644 00000002054 15204103444 0014101 0 ustar 00 U e5d� � @ sJ d ddddddddd d d d d dddgZ dd � Zdd � Zdd � Zdd � ZdS )Z base64mime�charsetZencoders�errorsZ feedparser� generator�headerZ iterators�message�message_from_file�message_from_binary_file�message_from_string�message_from_bytesZmime�parserZ quoprimimeZutilsc O s ddl m} |||��| �S �N� )�Parser)� email.parserr Zparsestr)�s�args�kwsr � r �&/usr/lib64/python3.8/email/__init__.pyr s c O s ddl m} |||��| �S �Nr )� BytesParser)r r Z parsebytes)r r r r r r r r ( s c O s ddl m} |||��| �S r )r r �parse)�fpr r r r r r r 0 s c O s ddl m} |||��| �S r )r r r )r r r r r r r r 8 s N)�__all__r r r r r r r r �<module> s* � __pycache__/_policybase.cpython-38.opt-2.pyc 0000644 00000013540 15204103444 0014635 0 ustar 00 U e5d�: � @ s� d dl Z d dlmZ d dlmZ d dlmZ dddgZG dd � d �Zd d � Z d d � Z G dd� dee j d�Z e G dd� de ��Z e � ZdS )� N)�header)�charset)�_has_surrogates�Policy�Compat32�compat32c s< e Zd Z� fdd�Zdd� Zdd� Zdd� Zd d � Z� ZS ) � _PolicyBasec sH |� � D ]:\}}t| |�r.tt| ��||� qtd�|| jj���qd S �Nz*{!r} is an invalid keyword argument for {}) �items�hasattr�superr � __setattr__� TypeError�format� __class__�__name__)�self�kw�name�value�r � �)/usr/lib64/python3.8/email/_policybase.py�__init__) s ��z_PolicyBase.__init__c C s* dd� | j �� D �}d�| jjd�|��S )Nc S s g | ]\}}d � ||��qS )z{}={!r})r )�.0r r r r r � <listcomp>8 s �z(_PolicyBase.__repr__.<locals>.<listcomp>z{}({})z, )�__dict__r r r r �join)r �argsr r r �__repr__7 s �z_PolicyBase.__repr__c K sr | j �| j �}| j�� D ]\}}t�|||� q|�� D ]4\}}t| |�s^td�|| j j ���t�|||� q8|S r ) r �__new__r r �objectr r r r r )r r Z newpolicy�attrr r r r �clone< s ��z_PolicyBase.clonec C s, t | |�rd}nd}t|�| jj|���d S )Nz'{!r} object attribute {!r} is read-onlyz!{!r} object has no attribute {!r})r �AttributeErrorr r r )r r r �msgr r r r N s z_PolicyBase.__setattr__c C s | j f |j�S �N)r# r )r �otherr r r �__add__U s z_PolicyBase.__add__) r � __module__� __qualname__r r r# r r( � __classcell__r r r r r s r c C s, | � dd�d } |�dd�d }| d | S )N� � r )�rsplit�split)�docZ added_docr r r � _append_doc^ s r1 c C s� | j r(| j �d�r(t| jd j | j �| _ | j�� D ]V\}}|j r2|j �d�r2dd� | jD �D ]*}tt||�d�}|r\t||j �|_ q2q\q2| S )N�+r c s s | ]}|� � D ] }|V qqd S r& )�mro)r �base�cr r r � <genexpr>h s z%_extend_docstrings.<locals>.<genexpr>�__doc__)r7 � startswithr1 � __bases__r r �getattr)�clsr r" r5 r0 r r r �_extend_docstringsc s r< c @ s� e Zd ZdZdZdZdZdZdZdd� Z dd � Z d d � Z e j d d � �Ze j dd� �Ze j dd� �Ze j dd� �Ze j dd� �ZdS )r Fr, Z8bit�N Nc C s | j r |�| �||� d S r& )�raise_on_defect�register_defect�r �objZdefectr r r � handle_defect� s zPolicy.handle_defectc C s |j �|� d S r& )Zdefects�appendr@ r r r r? � s zPolicy.register_defectc C s d S r& r )r r r r r �header_max_count� s zPolicy.header_max_countc C s t �d S r& ��NotImplementedError)r � sourcelinesr r r �header_source_parse� s zPolicy.header_source_parsec C s t �d S r& rE �r r r r r r �header_store_parse� s zPolicy.header_store_parsec C s t �d S r& rE rI r r r �header_fetch_parse� s zPolicy.header_fetch_parsec C s t �d S r& rE rI r r r �fold� s z Policy.foldc C s t �d S r& rE rI r r r � fold_binary s zPolicy.fold_binary)r r) r* r> �linesep�cte_type�max_line_length� mangle_from_Zmessage_factoryrB r? rD �abc�abstractmethodrH rJ rK rL rM r r r r r p s& 2 )� metaclassc @ sH e Zd ZdZdd� Zdd� Zdd� Zdd � Zd d � Zd d � Z dd� Z dS )r Tc C s0 t |t�s|S t|�r(tj|tj|d�S |S d S )N�r � header_name)� isinstance�strr r �Header�_charset� UNKNOWN8BITrI r r r �_sanitize_header s �zCompat32._sanitize_headerc C s> |d � dd�\}}|�d�d�|dd � � }||�d�fS )Nr �:r- z � z )r/ �lstripr �rstrip)r rG r r r r r rH % s z Compat32.header_source_parsec C s ||fS r& r rI r r r rJ 1 s zCompat32.header_store_parsec C s | � ||�S r& )r\ rI r r r rK 7 s zCompat32.header_fetch_parsec C s | j ||dd�S )NT��sanitize)�_foldrI r r r rL > s z Compat32.foldc C s" | j ||| jdkd�}|�dd�S )NZ7bitra �ascii�surrogateescape)rc rO �encode)r r r Zfoldedr r r rM H s zCompat32.fold_binaryc C s� g }|� d| � t|t�r\t|�rL|r<tj|tj|d�}qZ|� |� d }q`tj||d�}n|}|d k r�d}| jd k r|| j}|� |j | j |d�� |� | j � d� |�S )Nz%s: rU )rV r )rN � maxlinelenr^ ) rC rW rX r r rY rZ r[ rP rf rN r )r r r rb �parts�hrg r r r rc T s( � zCompat32._foldN) r r) r* rQ r\ rH rJ rK rL rM rc r r r r r s )rR Zemailr r rZ Z email.utilsr �__all__r r1 r< �ABCMetar r r r r r r �<module> s �L f __pycache__/header.cpython-38.opt-1.pyc 0000644 00000040071 15204103444 0013572 0 ustar 00 U e5d&^ � @ s� d Z dddgZddlZddlZddlZddlZddlmZ ddlm Z e j Z dZ d Z d Zd Zd Zd ZdZe d�Ze d�Ze�dejejB �Ze�d�Ze�d�Zejj Z dd� Z ddd�Z G dd� d�Z G dd� d�Z G dd� de!�Z"dS ) z+Header encoding and decoding functionality.�Header� decode_header� make_header� N)�HeaderParseError)�charset� � � z � �N z �us-asciizutf-8ai =\? # literal =? (?P<charset>[^?]*?) # non-greedy up to the next ? is the charset \? # literal ? (?P<encoding>[qQbB]) # either a "q" or a "b", case insensitive \? # literal ? (?P<encoded>.*?) # non-greedy up to the next ?= is the encoded string \?= # literal ?= z[\041-\176]+:$z \n[^ \t]+:c C s� t | d�rdd� | jD �S t�| �s.| dfgS g }| �� D ]�}t�|�}d}|r:|�d�}|rj|�� }d}|r~|�|ddf� |rL|�d�� � }|�d�� � }|�d�}|�|||f� qLq:g } t |�D ]J\} } | dkr�| d r�|| d d r�|| d d � � r�| �| d � q�t | �D ] } || = �q g } |D ]�\}}}|dk�rV| �||f� n�|d k�r|t j�|�}| �||f� n~|d k�r�t|�d }|�r�|d dd | � 7 }zt j�|�}W n tjk �r� td��Y nX | �||f� n td| ���q2g }d }}| D ]v\}}t|t��r,t|d�}|dk�r@|}|}nB||k�rb|�||f� |}|}n |dk�rz|t| 7 }n||7 }�q|�||f� |S )a; Decode a message header value without converting charset. Returns a list of (string, charset) pairs containing each of the decoded parts of the header. Charset is None for non-encoded parts of the header, otherwise a lower-case string containing the name of the character set specified in the encoded string. header may be a string that may or may not contain RFC2047 encoded words, or it may be a Header object. An email.errors.HeaderParseError may be raised when certain decoding error occurs (e.g. a base64 decoding exception). �_chunksc S s( g | ] \}}t �|t|��t|�f�qS � )�_charsetZ_encode�str)�.0�stringr r r �$/usr/lib64/python3.8/email/header.py� <listcomp>M s �z!decode_header.<locals>.<listcomp>NTr F� � �q�b� z===zBase64 decoding errorzUnexpected encoding: zraw-unicode-escape)�hasattrr �ecre�search� splitlines�split�pop�lstrip�append�lower� enumerate�isspace�reversed�email� quoprimimeZ header_decode�lenZ base64mime�decode�binascii�Errorr �AssertionError� isinstancer �bytes�BSPACE)�headerZwords�line�parts�firstZ unencodedr �encodingZencodedZdroplist�n�w�dZ decoded_wordsZencoded_stringZwordZpaderrZ collapsedZ last_word� last_charsetr r r r = s| � 4 c C sF t |||d�}| D ].\}}|dk r4t|t�s4t|�}|�||� q|S )a� Create a Header from a sequence of pairs as returned by decode_header() decode_header() takes a header value string and returns a sequence of pairs of the format (decoded_string, charset) where charset is the string name of the character set. This function takes one of those sequence of pairs and returns a Header instance. Optional maxlinelen, header_name, and continuation_ws are as in the Header constructor. )� maxlinelen� header_name�continuation_wsN)r r- �Charsetr! )Z decoded_seqr9 r: r; �h�sr r r r r � s � c @ sJ e Zd Zddd�Zdd� Zdd � Zdd d �Zd d � Zddd�Zdd� Z dS )r Nr �strictc C s| |dkrt }nt|t�s t|�}|| _|| _g | _|dk rH| �|||� |dkrTt}|| _|dkrjd| _ nt |�d | _ dS )aD Create a MIME-compliant header that can contain many character sets. Optional s is the initial header value. If None, the initial header value is not set. You can later append to the header with .append() method calls. s may be a byte string or a Unicode string, but see the .append() documentation for semantics. Optional charset serves two purposes: it has the same meaning as the charset argument to the .append() method. It also sets the default character set for all subsequent .append() calls that omit the charset argument. If charset is not provided in the constructor, the us-ascii charset is used both as s's initial charset and as the default for subsequent .append() calls. The maximum line length can be specified explicitly via maxlinelen. For splitting the first line to a shorter value (to account for the field header which isn't included in s, e.g. `Subject') pass in the name of the field in header_name. The default maxlinelen is 78 as recommended by RFC 2822. continuation_ws must be RFC 2822 compliant folding whitespace (usually either a space or a hard tab) which will be prepended to continuation lines. errors is passed through to the .append() call. Nr r ) �USASCIIr- r< r �_continuation_wsr r! � MAXLINELEN� _maxlinelen� _headerlenr( )�selfr> r r9 r: r; �errorsr r r �__init__� s zHeader.__init__c C s� | � � g }d}d}| jD ]�\}}|}|tjkrH|�dd�}|�dd�}|r�|o\| �|d �}|dkr�|dkr�|s�|�t� d}n|dkr�|s�|�t� |o�| �|d �}|}|�|� qt � |�S )z&Return the string value of the header.N�ascii�surrogateescape�replacer �Nr ���) � _normalizer r � UNKNOWN8BIT�encoder) � _nonctextr! �SPACE� EMPTYSTRING�join) rE Zuchunks�lastcs� lastspacer r ZnextcsZoriginal_bytes�hasspacer r r �__str__� s* zHeader.__str__c C s |t | �kS �N)r )rE �otherr r r �__eq__ s z Header.__eq__c C s� |dkr| j }nt|t�s"t|�}t|t�sZ|jp4d}|t jkrN|�dd�}n |�||�}|jpbd}|t jkr�z|�||� W n" t k r� |dkr�� t }Y nX | j � ||f� dS )a. Append a string to the MIME header. Optional charset, if given, should be a Charset instance or the name of a character set (which will be converted to a Charset instance). A value of None (the default) means that the charset given in the constructor is used. s may be a byte string or a Unicode string. If it is a byte string (i.e. isinstance(s, str) is false), then charset is the encoding of that byte string, and a UnicodeError will be raised if the string cannot be decoded with that charset. If s is a Unicode string, then charset is a hint specifying the character set of the characters in the string. In either case, when producing an RFC 2822 compliant header using RFC 2047 rules, the string will be encoded using the output codec of the charset. If the string cannot be encoded to the output codec, a UnicodeError will be raised. Optional `errors' is passed as the errors argument to the decode call if s is a byte string. Nr rI ) r r- r< r Z input_codecrN r) Z output_codecrO �UnicodeEncodeError�UTF8r r! )rE r> r rF Z input_charsetZoutput_charsetr r r r! s$ z Header.appendc C s |� � p|dkS )z=True if string s is not a ctext character of RFC822. )�(�)�\)r$ )rE r> r r r rP 4 s zHeader._nonctext�;, r c C s� | � � |dkr| j}|dkr"d}t| j|| j|�}d}d }}| jD �] \}} |dk r�|oh| �|d �}|dkr�|r~| dkr�|�� n| dkr�|s�|�� |o�| �|d �}| }d}|�� } | r�|� d| d | � n|� dd| � | dd� D ]`} |� � | j dk �r"|� | jd | � � | � q�| � � } | dt | �t | � � } |� | | | � q�t | �dkrF|� � qF| j�rx|�� |�|�}t�|��r�td �|���|S ) a� Encode a message header into an RFC-compliant format. There are many issues involved in converting a given string for use in an email header. Only certain character sets are readable in most email clients, and as header strings can only contain a subset of 7-bit ASCII, care must be taken to properly convert and encode (with Base64 or quoted-printable) header strings. In addition, there is a 75-character length limit on any given encoded header field, so line-wrapping must be performed, even with double-byte character sets. Optional maxlinelen specifies the maximum length of each generated line, exclusive of the linesep string. Individual lines may be longer than maxlinelen if a folding point cannot be found. The first line will be shorter by the length of the header name plus ": " if a header name was specified at Header construction time. The default value for maxlinelen is determined at header construction time. Optional splitchars is a string containing characters which should be given extra weight by the splitting algorithm during normal header wrapping. This is in very rough support of RFC 2822's `higher level syntactic breaks': split points preceded by a splitchar are preferred during line splitting, with the characters preferred in the order in which they appear in the string. Space and tab may be included in the string to indicate whether preference should be given to one over the other as a split point when other split chars do not appear in the line being split. Splitchars does not affect RFC 2047 encoded lines. Optional linesep is a string to be used to separate the lines of the value. The default value is the most useful for typical Python applications, but it can be set to \r\n to produce RFC-compliant line separators when needed. Nr i@B rK rL Fr r r z8header value appears to contain an embedded header: {!r})rM rC �_ValueFormatterrD rA r rP �add_transitionr �feed�newline�header_encodingr r( �_str�_embedded_headerr r �format)rE � splitcharsr9 �linesepZ formatterrT rV rU r r �linesr1 Zsline�fws�valuer r r rO 9 sZ ! � � �z Header.encodec C sx g }d }g }| j D ]B\}}||kr.|�|� q|d k rJ|�t�|�|f� |g}|}q|rn|�t�|�|f� || _ d S rX )r r! rQ rS )rE Zchunksr8 Z last_chunkr r r r r rM � s zHeader._normalize)NNNNr r? )Nr? )r` Nr ) �__name__� __module__� __qualname__rG rW rZ r! rP rO rM r r r r r � s � / + Pc @ sT e Zd Zdd� Zdd� Zdd� Zdd� Zd d � Zd d � Zd d� Z dd� Z dd� Z dS )ra c C s0 || _ || _t|�| _|| _g | _t|�| _d S rX )�_maxlenrA r( �_continuation_ws_len� _splitchars�_lines� _Accumulator� _current_line)rE Z headerlen�maxlenr; ri r r r rG � s z_ValueFormatter.__init__c C s | � � |�| j�S rX )rd rS rt )rE rj r r r rf � s z_ValueFormatter._strc C s | � t�S rX )rf �NL�rE r r r rW � s z_ValueFormatter.__str__c C sv | j �� }|dkr | j j|� t| j �dkrh| j �� rV| jrV| jd t| j �7 < n| j�t| j �� | j �� d S )N)r r r rL ) rv r �pushr( � is_onlywsrt r r! �reset)rE Z end_of_liner r r rd � s z_ValueFormatter.newlinec C s | j �dd� d S )Nr r )rv rz ry r r r rb � s z _ValueFormatter.add_transitionc C s� |j d kr | �||| j� d S |�|| �� �}z|�d�}W n tk rR Y d S X |d k rh| �||� z |�� }W n tk r� Y d S X | �� | j � | j |� |D ]}| j � | j | � q�d S �Nr )re � _ascii_splitrs Zheader_encode_lines� _maxlengthsr � IndexError� _append_chunkrd rv rz rA rt r! )rE rl r r Z encoded_linesZ first_line� last_liner1 r r r rc � s$ z_ValueFormatter.feedc c s& | j t| j� V | j | j V qd S rX )rq r( rv rr ry r r r r � s z_ValueFormatter._maxlengthsc C sf t �dt d || �}|d r0dg|d d�< n |�d� tt|�gd � D ]\}}| �||� qLd S )Nz([z]+)r r r )�rer �FWSr �zip�iterr� )rE rl r ri r2 �partr r r r~ � s z _ValueFormatter._ascii_splitc C s | j �||� t| j �| jk�r| jD ]v}t| j �� d dd�D ]T}|�� rn| j | d }|rn|d |krn q�| j |d d }|r@|d |kr@ q�q@q& q�q&| j �� \}}| j j dkr�| � � |s�d}| j �||� d S | j � |�}| j � t| j �� | j �|� d S )Nr r rL r )rv rz r( rq rs �range� part_countr$ r � _initial_sizerd �pop_fromrt r! r r| )rE rl r Zch�iZprevpartr� Z remainderr r r r� � s. z _ValueFormatter._append_chunkN) rn ro rp rG rf rW rd rb rc r r~ r� r r r r ra � s %ra c sj e Zd Zd� fdd� Zdd� Zddd�Z� fdd �Zd d � Zd d � Zddd�Z dd� Z � fdd�Z � Z S )ru r c s || _ t� �� d S rX )r� �superrG )rE Z initial_size�� __class__r r rG s z_Accumulator.__init__c C s | � ||f� d S rX )r! )rE rl r r r r rz # s z_Accumulator.pushc C s | |d � }g | |d �< |S rX r )rE r� Zpoppedr r r r� & s z_Accumulator.pop_fromc s | � � dkrdS t� �� S )Nr )r r )r� r� r ry r� r r r + s z_Accumulator.popc C s t dd� | D �| j�S )Nc s s" | ]\}}t |�t |� V qd S rX )r( �r rl r� r r r � <genexpr>1 s z'_Accumulator.__len__.<locals>.<genexpr>)�sumr� ry r r r �__len__0 s �z_Accumulator.__len__c C s t �dd� | D ��S )Nc s s | ]\}}t �||f�V qd S rX �rR rS r� r r r r� 5 s �z'_Accumulator.__str__.<locals>.<genexpr>r� ry r r r rW 4 s �z_Accumulator.__str__Nc C s" |d kr g }|| d d �< d| _ d S r} )r� )rE Zstartvalr r r r| 8 s z_Accumulator.resetc C s | j dko| pt| ��� S r} )r� r r$ ry r r r r{ > s z_Accumulator.is_onlywsc s t � �� S rX )r� r� ry r� r r r� A s z_Accumulator.part_count)r )r )N) rn ro rp rG rz r� r r� rW r| r{ r� � __classcell__r r r� r ru s ru )NNr )#�__doc__�__all__r� r* Zemail.quoprimimer& Zemail.base64mimeZ email.errorsr r r r< rx rQ r/ ZSPACE8rR rB r� r@ r\ �compile�VERBOSE� MULTILINEr Zfcrerg r' Z _max_appendr r r ra �listru r r r r �<module> sF � � _ � k __pycache__/feedparser.cpython-38.opt-2.pyc 0000644 00000021175 15204103444 0014467 0 ustar 00 U e5d�X � @ s� d dgZ ddlZddlmZ ddlmZ ddlmZ ddlm Z e� d�Z e� d �Z e� d �Z e� d �Ze� d �Zd Zd Ze� ZG dd� de�ZG dd � d �ZG dd� de�ZdS )� FeedParser�BytesFeedParser� N)�errors)�compat32)�deque)�StringIOz \r\n|\r|\nz (\r\n|\r|\n)z(\r\n|\r|\n)\Zz%^(From |[\041-\071\073-\176]*:|[\t ])� � c @ s\ e Zd Zdd� Zdd� Zdd� Zdd� Zd d � Zd d � Zd d� Z dd� Z dd� Z dd� Z dS )�BufferedSubFilec C s$ t dd�| _t� | _g | _d| _d S )Nr )�newlineF)r �_partialr �_lines� _eofstack�_closed��self� r �(/usr/lib64/python3.8/email/feedparser.py�__init__5 s zBufferedSubFile.__init__c C s | j �|� d S �N)r �append)r Zpredr r r �push_eof_matcher@ s z BufferedSubFile.push_eof_matcherc C s | j �� S r )r �popr r r r �pop_eof_matcherC s z BufferedSubFile.pop_eof_matcherc C s< | j �d� | �| j �� � | j �d� | j �� d| _d S )Nr T)r �seek� pushlines� readlines�truncater r r r r �closeF s zBufferedSubFile.closec C sL | j s| jrdS tS | j �� }t| j�D ] }||�r(| j �|� dS q(|S �Nr )r r � NeedMoreData�popleft�reversedr � appendleft)r �lineZateofr r r �readlineN s zBufferedSubFile.readlinec C s | j �|� d S r )r r# �r r$ r r r � unreadline` s zBufferedSubFile.unreadlinec C sx | j �|� d|kr d|kr d S | j �d� | j �� }| j �d� | j �� |d �d�sj| j �|�� � | �|� d S )Nr � r ���)r �writer r r �endswithr r )r �data�partsr r r �pushe s zBufferedSubFile.pushc C s | j �|� d S r )r �extend)r �linesr r r r z s zBufferedSubFile.pushlinesc C s | S r r r r r r �__iter__} s zBufferedSubFile.__iter__c C s | � � }|dkrt�|S r )r% � StopIterationr& r r r �__next__� s zBufferedSubFile.__next__N) �__name__� __module__� __qualname__r r r r r% r' r. r r1 r3 r r r r r - s r c @ s\ e Zd Zded�dd�Zdd� Zdd� Zd d � Zd d � Zd d� Z dd� Z dd� Z dd� Z dS )r N��policyc C s� || _ d| _|d kr<|jd kr2ddlm} || _qn|j| _n2|| _z|| j d� W n tk rl d| _Y nX t� | _g | _ | � � j | _ d | _ d | _d| _d S )NFr )�Messager7 T)r8 �_old_style_factoryZmessage_factoryZ email.messager9 �_factory� TypeErrorr �_input� _msgstack� _parsegenr3 �_parse�_cur�_last� _headersonly)r r; r8 r9 r r r r � s$ zFeedParser.__init__c C s d| _ d S )NT)rC r r r r �_set_headersonly� s zFeedParser._set_headersonlyc C s | j �|� | �� d S r )r= r. � _call_parse�r r, r r r �feed� s zFeedParser.feedc C s& z | � � W n tk r Y nX d S r )r@ r2 r r r r rE � s zFeedParser._call_parsec C sH | j �� | �� | �� }|�� dkrD|�� sDt�� }| j� ||� |S )N� multipart) r= r rE � _pop_message�get_content_maintypeZ is_multipartr Z!MultipartInvariantViolationDefectr8 � handle_defect)r �root�defectr r r r � s �zFeedParser.closec C sn | j r| �� }n| j| jd�}| jr<| j�� dkr<|�d� | jrR| jd �|� | j�|� || _|| _ d S )Nr7 zmultipart/digestzmessage/rfc822r) ) r: r; r8 rA �get_content_typeZset_default_typer> Zattachr rB )r �msgr r r � _new_message� s zFeedParser._new_messagec C s( | j �� }| j r | j d | _nd | _|S )Nr) )r> r rA )r �retvalr r r rI � s zFeedParser._pop_messagec c s | � � g }| jD ]Z}|tkr&tV qt�|�sbt�|�s^t�� }| j� | j |� | j� |� qn|� |� q| � |� | jr�g }| j�� }|tkr�tV q�|dkr�q�|� |� q�| j �t�|�� d S | j �� dk�r�| j�tj� | �� D ] }|tk�rtV q� �q q�| �� }| j�� | j�� }|tk�rDtV �q �qD�q | j�� }|tk�rjtV �qD�qj�qD|dk�rx�q�| j� |� q�d S | j �� dk�r�| �� D ] }|tk�r�tV �q� �qĐq�| �� d S | j �� dk�r�| j �� }|d k�rRt�� }| j� | j |� g }| jD ]$}|tk�r.tV �q|� |� �q| j �t�|�� d S t| j � dd��� � dk�r�t� � }| j� | j |� d| }t � d t �!|� d �} d } g } d } d } | j�� }|tk�r�tV �q�|dk�r�q�| �|�}|�r�|�"d ��rd } |�"d�} �q�| �rr| �r^| d }t#�$|�}|�rP|d t%|�"d�� � | d< t�| �| j _&d } | j� |� �q�| j�� }|tk�r�tV �qr| �|�}|�sr| j� |� �q��qr| j�| j� | �� D ] }|tk�r�tV �q� �q�q�| j'�� dk�rT| j'j(}|dk�rd | j'_(n:|d k �r�t#�$|�}|�r�t%|�"d��}|d | � | j'_(nD| j'j)}t*|t��r�t#�$|�}|�r�|d t%|�"d�� � }|| j'_)| j�� | �� | j | _'n | � |� �q�| �r*t�+� }| j� | j |� | j �t�| �� g }| jD ]}|tk�r�tV �q��q�t�|�| j _(d S | �sLt�,� }| j� | j |� d S | �rZdg}ng }| jD ]$}|tk�r|tV �qd|� |� �qd|�r�|d }t-�|�}|�r�|t%|�"d��d � |d< t�|�| j _(d S g }| jD ]$}|tk�r�tV �q�|� |� �q�| j �t�|�� d S )Nr zmessage/delivery-status�messagerH zcontent-transfer-encoding�8bit)Z7bitrS Zbinaryz--z(?P<sep>z4)(?P<end>--)?(?P<ws>[ \t]*)(?P<linesep>\r\n|\r|\n)?$TF�end�linesepr) r ).rP r= r �headerRE�match�NLCREr Z MissingHeaderBodySeparatorDefectr8 rK rA r' r �_parse_headersrC r% Z set_payload� EMPTYSTRING�joinrN r r? rI r rJ Z get_boundaryZNoBoundaryInMultipartDefect�str�get�lowerZ-InvalidMultipartContentTransferEncodingDefect�re�compile�escape�group� NLCRE_eol�search�len�preamblerB �epilogueZ_payload� isinstanceZStartBoundaryNotFoundDefectZCloseBoundaryNotFoundDefect� NLCRE_bol)r Zheadersr$ rM r0 rQ rO �boundaryZ separatorZ boundaryreZcapturing_preamblerf rU Zclose_boundary_seen�moZlastlineZeolmorg rT Zpayload� firstlineZbolmor r r r? � s` � �� zFeedParser._parsegenc C sX d}g }t |�D �]&\}}|d dkrR|sFt�|�}| j�| j|� q|�|� q|rt| jj| j�|�� dg }}|� d�r�|dkr�t � |�}|r�|d t |� d�� � }| j�|� qn<|t |�d kr�| j�|� d S t�|�}| jj�|� q|�d�}|dk�r&t�d�}| jj�|� q|d |� }|g}q|�rT| jj| j�|�� d S )Nr r z zFrom � �:zMissing header name.)� enumerater Z#FirstHeaderLineIsContinuationDefectr8 rK rA r Zset_rawZheader_source_parse� startswithrc rd re rb Z set_unixfromr= r' Z MisplacedEnvelopeHeaderDefectZdefects�findZInvalidHeaderDefect) r r0 Z lastheaderZ lastvalue�linenor$ rM rk �ir r r rY � sF zFeedParser._parse_headers)N) r4 r5 r6 r r rD rG rE r rP rI r? rY r r r r r � s ~c s e Zd Z� fdd�Z� ZS )r c s t � �|�dd�� d S )N�ascii�surrogateescape)�superrG �decoderF �� __class__r r rG s zBytesFeedParser.feed)r4 r5 r6 rG � __classcell__r r rx r r s )�__all__r_ Zemailr Zemail._policybaser � collectionsr �ior r` rX ri rc Z NLCRE_crackrV rZ �NL�objectr r r r r r r r �<module> s& [ __pycache__/policy.cpython-38.opt-2.pyc 0000644 00000006565 15204103444 0013654 0 ustar 00 U e5d�( � @ s� d dl Z d dlZd dlmZmZmZmZ d dlmZ d dl m Z d dl m Z d dl mZ ddd d d d d dgZe �d�ZeG dd � d e��Ze� Ze`ejdd�Zejdd�Zejddd�Zejdd�ZdS )� N)�Policy�Compat32�compat32�_extend_docstrings)�_has_surrogates)�HeaderRegistry)�raw_data_manager)� EmailMessager r r � EmailPolicy�default�strict�SMTP�HTTPz\n|\rc sl e Zd ZeZdZdZe� Ze Z � fdd�Z dd� Z dd� Z d d � Zd d � Zd d� Zdd� Zddd�Z� ZS )r F�longc s* d|krt �| dt� � t� jf |� d S )N�header_factory)�object� __setattr__r �super�__init__)�self�kw�� __class__� �$/usr/lib64/python3.8/email/policy.pyr ] s zEmailPolicy.__init__c C s | j | jS �N)r Z max_count)r �namer r r �header_max_countd s z EmailPolicy.header_max_countc C s> |d � dd�\}}|�d�d�|dd � � }||�d�fS )Nr �:� z � � )�split�lstrip�join�rstrip)r Z sourcelinesr �valuer r r �header_source_parsev s z EmailPolicy.header_source_parsec C sV t |d�r$|j�� |�� kr$||fS t|t�rFt|�� �dkrFtd��|| �||�fS )Nr r zDHeader values may not contain linefeed or carriage return characters) �hasattrr �lower� isinstance�str�len� splitlines� ValueErrorr �r r r& r r r �header_store_parse� s z EmailPolicy.header_store_parsec C s* t |d�r|S d�t�|��}| �||�S )Nr r )r( r$ �linesep_splitterr" r r/ r r r �header_fetch_parse� s z EmailPolicy.header_fetch_parsec C s | j ||dd�S )NT�� refold_binary)�_foldr/ r r r �fold� s zEmailPolicy.foldc C s0 | j ||| jdkd�}| jr dnd}|�|d�S )NZ7bitr3 �utf8�ascii�surrogateescape)r5 Zcte_typer7 �encode)r r r& Zfolded�charsetr r r � fold_binary� s zEmailPolicy.fold_binaryc s� t |d�r|j| d�S | jr"| jntj� |�� }| jdkp�| jdko�|rdt|d �t|� d � kp�t� fdd�|d d � D ��}|s�|r�t |�r�| � |d � |��j| d�S |d | j � |� | j S ) Nr )Zpolicy�allr r � c 3 s | ]}t |�� kV qd S r )r, )�.0�x��maxlenr r � <genexpr>� s z$EmailPolicy._fold.<locals>.<genexpr>r r z: ) r( r6 �max_line_length�sys�maxsizer- � refold_sourcer, �anyr r r$ �linesep)r r r& r4 �linesZrefoldr rA r r5 � s �zEmailPolicy._fold)F)�__name__� __module__� __qualname__r Zmessage_factoryr7 rG r r r Zcontent_managerr r r' r0 r2 r6 r< r5 � __classcell__r r r r r s = T)Zraise_on_defectr! )rI )rI rD )r7 )�rerE Zemail._policybaser r r r Z email.utilsr Zemail.headerregistryr Zemail.contentmanagerr Z email.messager �__all__�compiler1 r r r Zcloner r r ZSMTPUTF8r r r r �<module> s2 � @ __pycache__/contentmanager.cpython-38.opt-1.pyc 0000644 00000016303 15204103444 0015350 0 ustar 00 U e5d�) � @ s. d dl Z d dlZd dlZd dlZd dlmZ G dd� d�Ze� Zd%dd�Ze� de� d d � Z d � � D ]Z e� e e � qfd d � Z d� � D ]Ze� de e � q�dd� Ze� de� dd� Zdd� Zdd� Zdd� Zd&d d �Ze�ee� d'd d!�Ze�ejje� d(d#d$�Zee e fD ]Z e�e e� �qdS ))� N)� quoprimimec @ s< e Zd Zdd� Zdd� Zdd� Zdd� Zd d � Zd d � Zd S )�ContentManagerc C s i | _ i | _d S �N)� get_handlers� set_handlers)�self� r �,/usr/lib64/python3.8/email/contentmanager.py�__init__ s zContentManager.__init__c C s || j |< d S r )r )r �key�handlerr r r �add_get_handler s z ContentManager.add_get_handlerc O s| |� � }|| jkr(| j| |f|�|�S |�� }|| jkrP| j| |f|�|�S d| jkrp| jd |f|�|�S t|��d S )N� )Zget_content_typer �get_content_maintype�KeyError)r �msg�args�kwZ content_type�maintyper r r � get_content s zContentManager.get_contentc C s || j |< d S r )r )r Ztypekeyr r r r �add_set_handler s z ContentManager.add_set_handlerc O s> |� � dkrtd��| �||�}|�� |||f|�|� d S )NZ multipartz"set_content not valid on multipart)r � TypeError�_find_set_handlerZ clear_content)r r �objr r r r r r � set_content s zContentManager.set_contentc C s� d }t |�jD ]�}|| jkr*| j| S |j}t|dd�}|rNd�||f�n|}|d kr^|}|| jkrv| j| S || jkr�| j| S |j}|| jkr| j| S qd | jkr�| jd S t|��d S )N� __module__r �.)�type�__mro__r � __qualname__�getattr�join�__name__r ) r r r Zfull_path_for_error�typZqname�modname� full_path�namer r r r ' s& z ContentManager._find_set_handlerN) r" r r r r r r r r r r r r r s r �replacec C s& | j dd�}| �dd�}|j||d�S )NT��decode�charset�ASCII)�errors)� get_payloadZ get_paramr) )r r, Zcontentr* r r r �get_text_content@ s r. �textc C s | j dd�S )NTr( �r- �r r r r �get_non_text_contentG s r2 z audio image video applicationc C s | � d�S �Nr r0 r1 r r r �get_message_contentM s r4 zrfc822 external-bodyzmessage/c C s t | �d��S r3 )�bytesr- r1 r r r �%get_and_fixup_unknown_message_contentS s r6 �messagec s� d� ||f�| d< |r�t|d d�s<| j� � fdd�|D �}z(|D ] }|jrV|jd �|| |j< qBW n@ tjjk r� } z td� |j | jd���|�W 5 d }~X Y nX d S ) N�/z Content-Typer r& c s g | ]}� j � �|g�� �qS r )Zheader_factoryZheader_source_parse)�.0�header�Zmpr r � <listcomp>d s �z _prepare_set.<locals>.<listcomp>zInvalid header: {})�policy) r! �hasattrr= Zdefectsr& �emailr, Z HeaderDefect� ValueError�formatZfold)r r �subtype�headersr: �excr r; r � _prepare_set_ s$ � ��rE c C sx |d kr|d k rd}|d k r$|| d< |d k r>| j d|ddd� |d k rN|| d< |d k rt|�� D ]\}}| � ||� q^d S )NZ attachmentzContent-Disposition�filenameT)r: r' z Content-ID)� set_param�items)r � dispositionrF �cid�paramsr �valuer r r � _finalize_setp s �rM c C sV g }|d d }t dt| �|�D ]*}| ||| � }|�t�|��d�� q d�|�S )N� � r �asciir )�range�len�append�binascii� b2a_base64r) r! )�data�max_line_lengthZ encoded_linesZunencoded_bytes_per_line�iZthisliner r r �_encode_base64� s rY c s� | � |��� }|j� d�� � fdd�}dd� }|d kr�tdd� |D �dd �|jkr�zd ||��d�fW S tk rz Y nX |jd kr�d ||��dd �fS ||d d � �}t� |�d�|j�}t � |�} t |�t | �kr�d}nd}t |�d kr�||fS |d k�r||��d�} nj|d k�r,||��dd �} nN|dk�rPt� ||��d�|j�} n*|dk�rlt ||�|j�} ntd�|���|| fS )NrP c s � � | �� S r �r! ��lines��linesepr r � embedded_body� � z#_encode_text.<locals>.embedded_bodyc S s d� | �d S )N� rZ r[ r r r � normal_body� r` z!_encode_text.<locals>.normal_bodyc s s | ]}t |�V qd S r )rR )r9 �xr r r � <genexpr>� s z _encode_text.<locals>.<genexpr>r )�default�7bit�8bit�surrogateescape� zlatin-1�base64�quoted-printablez$Unknown content transfer encoding {})�encode� splitlinesr^ �maxrW r) �UnicodeDecodeErrorZcte_typer Z body_encoderT rU rR rY r@ rA ) �stringr* �cter= r\ r_ rb ZsniffZsniff_qpZ sniff_base64rV r r] r � _encode_text� sD � � rr �plain�utf-8c C sd t | d|| � t|||| j�\}} | �| � | jdtjj�||�dd� || d< t | ||||� d S )Nr/ r* T)r' �Content-Transfer-Encoding) rE rr r= � set_payloadrG r? r* ZALIASES�getrM ) r rp rB r* rq rI rF rJ rK rC Zpayloadr r r �set_text_content� s �rx �rfc822c C s� |dkrt d��|dkr@|dkr.t d�|���|d kr:dn|}n0|dkrd|dkr^t d �|���d }n |d krpd }t| d ||� | �|g� || d < t| ||||� d S ) N�partialz4message/partial is not supported for Message objectsry )Nrf rg �binaryz*message/rfc822 parts do not support cte={}rg z external-body)Nrf z1message/external-body parts do not support cte={}rf r7 ru )r@ rA rE rv rM ) r r7 rB rq rI rF rJ rK rC r r r �set_message_content� s( �� r| rj c C s� t | ||| � |dkr(t|| jjd�}nN|dkrNtj|dddd�}|�d�}n(|dkrb|�d� n|d krv|�dd �}| �|� || d < t | ||||� d S ) Nrj )rW rk FT)�istextr: Z quotetabsrP rf )rg r{ rh ru ) rE rY r= rW rT Zb2a_qpr) rl rv rM ) r rV r rB rq rI rF rJ rK rC r r r �set_bytes_content� s r~ )r' )rs rt NNNNNN)ry NNNNNN)rj NNNNN) rT Z email.charsetr? Z email.messageZ email.errorsr r Zraw_data_managerr. r r2 �splitr r4 rB r6 rE rM rY rr rx r �strr| r7 ZMessager~ r5 � bytearray� memoryviewr# r r r r �<module> s^ 6 � ' � � � __pycache__/errors.cpython-38.pyc 0000644 00000013423 15204103444 0012720 0 ustar 00 U e5d? � @ s� d Z G dd� de�ZG dd� de�ZG dd� de�ZG dd� de�ZG d d � d ee�ZG d d � d e�ZG d d� de �Z G dd� de �Z G dd� de �Z G dd� de �Z G dd� de �ZG dd� de �ZG dd� de �ZeZG dd � d e �ZG d d � d e �ZG d d � d e �ZG d!d"� d"e �ZG d#d$� d$e �ZG d%d&� d&e �ZG d'd(� d(e �ZG d)d*� d*e�ZG d+d,� d,e�ZG d-d.� d.e�ZG d/d0� d0e�Z G d1d2� d2e�Z d3S )4z email package exception classes.c @ s e Zd ZdZdS )� MessageErrorz+Base class for errors in the email package.N��__name__� __module__� __qualname__�__doc__� r r �$/usr/lib64/python3.8/email/errors.pyr s r c @ s e Zd ZdZdS )�MessageParseErrorz&Base class for message parsing errors.Nr r r r r r s r c @ s e Zd ZdZdS )�HeaderParseErrorz Error while parsing headers.Nr r r r r r s r c @ s e Zd ZdZdS )� BoundaryErrorz#Couldn't find terminating boundary.Nr r r r r r s r c @ s e Zd ZdZdS )�MultipartConversionErrorz(Conversion to a multipart is prohibited.Nr r r r r r s r c @ s e Zd ZdZdS )� CharsetErrorz An illegal charset was given.Nr r r r r r s r c s" e Zd ZdZd� fdd� Z� ZS )� MessageDefectz Base class for a message defect.Nc s |d k rt � �|� || _d S �N)�super�__init__�line)�selfr �� __class__r r r $ s zMessageDefect.__init__)N�r r r r r � __classcell__r r r r r ! s r c @ s e Zd ZdZdS )�NoBoundaryInMultipartDefectzBA message claimed to be a multipart but had no boundary parameter.Nr r r r r r ) s r c @ s e Zd ZdZdS )�StartBoundaryNotFoundDefectz+The claimed start boundary was never found.Nr r r r r r , s r c @ s e Zd ZdZdS )�CloseBoundaryNotFoundDefectzEA start boundary was found, but not the corresponding close boundary.Nr r r r r r / s r c @ s e Zd ZdZdS )�#FirstHeaderLineIsContinuationDefectz;A message had a continuation line as its first header line.Nr r r r r r 2 s r c @ s e Zd ZdZdS )� MisplacedEnvelopeHeaderDefectz?A 'Unix-from' header was found in the middle of a header block.Nr r r r r r 5 s r c @ s e Zd ZdZdS )� MissingHeaderBodySeparatorDefectzEFound line with no leading whitespace and no colon before blank line.Nr r r r r r 8 s r c @ s e Zd ZdZdS )�!MultipartInvariantViolationDefectz?A message claimed to be a multipart but no subparts were found.Nr r r r r r = s r c @ s e Zd ZdZdS )�-InvalidMultipartContentTransferEncodingDefectzEAn invalid content transfer encoding was set on the multipart itself.Nr r r r r r @ s r c @ s e Zd ZdZdS )�UndecodableBytesDefectz0Header contained bytes that could not be decodedNr r r r r r C s r c @ s e Zd ZdZdS )�InvalidBase64PaddingDefectz/base64 encoded sequence had an incorrect lengthNr r r r r r! F s r! c @ s e Zd ZdZdS )� InvalidBase64CharactersDefectz=base64 encoded sequence had characters not in base64 alphabetNr r r r r r" I s r" c @ s e Zd ZdZdS )�InvalidBase64LengthDefectz4base64 encoded sequence had invalid length (1 mod 4)Nr r r r r r# L s r# c s e Zd ZdZ� fdd�Z� ZS )� HeaderDefectz Base class for a header defect.c s t � j||� d S r )r r )r �args�kwr r r r T s zHeaderDefect.__init__r r r r r r$ Q s r$ c @ s e Zd ZdZdS )�InvalidHeaderDefectz+Header is not valid, message gives details.Nr r r r r r' W s r' c @ s e Zd ZdZdS )�HeaderMissingRequiredValuez(A header that must have a value had noneNr r r r r r( Z s r( c s( e Zd ZdZ� fdd�Zdd� Z� ZS )�NonPrintableDefectz8ASCII characters outside the ascii-printable range foundc s t � �|� || _d S r )r r �non_printables)r r* r r r r ` s zNonPrintableDefect.__init__c C s d� | j�S )Nz6the following ASCII non-printables found in header: {})�formatr* )r r r r �__str__d s �zNonPrintableDefect.__str__)r r r r r r, r r r r r r) ] s r) c @ s e Zd ZdZdS )�ObsoleteHeaderDefectz0Header uses syntax declared obsolete by RFC 5322Nr r r r r r- h s r- c @ s e Zd ZdZdS )�NonASCIILocalPartDefectz(local_part contains non-ASCII charactersNr r r r r r. k s r. N) r � Exceptionr r r r � TypeErrorr r � ValueErrorr r r r r r r ZMalformedHeaderDefectr r r r! r" r# r$ r' r( r) r- r. r r r r �<module> s4 __pycache__/iterators.cpython-38.opt-2.pyc 0000644 00000002426 15204103444 0014361 0 ustar 00 U e5dW � @ sH d ddgZ ddlZddlmZ dd� Zd dd �Zdd d�Zdd d �ZdS )�body_line_iterator�typed_subpart_iterator�walk� N)�StringIOc c s. | V | � � r*| �� D ]}|�� E d H qd S �N)� is_multipart� get_payloadr )�self�subpart� r �'/usr/lib64/python3.8/email/iterators.pyr s Fc c s6 | � � D ](}|j|d�}t|t�rt|�E d H qd S )N)�decode)r r � isinstance�strr )�msgr r Zpayloadr r r r " s �textc c s8 | � � D ]*}|�� |kr|d ks,|�� |kr|V qd S r )r Zget_content_maintypeZget_content_subtype)r ZmaintypeZsubtyper r r r r - s c C s� |d krt j}d|d }t|| �� d|d� |rJtd| �� |d� n t|d� | �� r|| �� D ]}t|||d |� qdd S )N� � � )�end�filez [%s])r � )�sys�stdout�printZget_content_typeZget_default_typer r � _structure)r �fp�levelZinclude_defaultZtabr r r r r ; s r )F)r N)Nr F)�__all__r �ior r r r r r r r r �<module> s � __pycache__/quoprimime.cpython-38.pyc 0000644 00000017000 15204103444 0013566 0 ustar 00 U e5d�& � @ sX d Z ddddddddd d g Zd d lZd d lmZmZmZ dZdZdZ dd� e d�D �Z e d d � Z e d d � Z de�d� e�d� D ]Zee�e e< q�de ed�< dD ]Zee�e e< q�dd� Zdd � Zd d� Zd d� Zd,d d �Zd!d � Zd"d � Zd-d$d�Ze d d � Zd%D ]Zee�ee< �qd&efd'd�Zefd(d�Z e Z e Z d)d*� Z d+d� Z d S ).aF Quoted-printable content transfer encoding per RFCs 2045-2047. This module handles the content transfer encoding method defined in RFC 2045 to encode US ASCII-like 8-bit data called `quoted-printable'. It is used to safely encode text that is in a character set similar to the 7-bit US ASCII character set, but that includes some 8-bit characters that are normally not allowed in email bodies or headers. Quoted-printable is very space-inefficient for encoding binary files; use the email.base64mime module for that instead. This module provides an interface to encode and decode both headers and bodies with quoted-printable encoding. RFC 2045 defines a method for including character set information in an `encoded-word' in a header. This method is commonly used for 8-bit real names in To:/From:/Cc: etc. fields, as well as Subject: lines. This module does not do the line wrapping or end-of-line character conversion necessary for proper internationalized headers; it only does dumb encoding and decoding. To deal with the various line wrapping issues, use the email.header module. � body_decode� body_encode� body_length�decode� decodestring� header_decode� header_encode� header_length�quote�unquote� N)� ascii_letters�digits� hexdigits� � � c C s g | ] }d | �qS )z=%02X� )�.0�cr r �(/usr/lib64/python3.8/email/quoprimime.py� <listcomp>7 s r � s -!*+/�ascii�_� s_ !"#$%&'()*+,-./0123456789:;<>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~ c C s t | �t| kS )z>Return True if the octet should be escaped with header quopri.)�chr�_QUOPRI_HEADER_MAP��octetr r r � header_checkJ s r c C s t | �t| kS )z<Return True if the octet should be escaped with body quopri.)r �_QUOPRI_BODY_MAPr r r r � body_checkO s r! c C s t dd� | D ��S )a: Return a header quoted-printable encoding length. Note that this does not include any RFC 2047 chrome added by `header_encode()`. :param bytearray: An array of bytes (a.k.a. octets). :return: The length in bytes of the byte array when it is encoded with quoted-printable for headers. c s s | ]}t t| �V qd S �N)�lenr �r r r r r � <genexpr>^ s z header_length.<locals>.<genexpr>��sum�� bytearrayr r r r T s c C s t dd� | D ��S )z�Return a body quoted-printable encoding length. :param bytearray: An array of bytes (a.k.a. octets). :return: The length in bytes of the byte array when it is encoded with quoted-printable for bodies. c s s | ]}t t| �V qd S r" )r# r r$ r r r r% h s z body_length.<locals>.<genexpr>r& r( r r r r a s c C sf t |t�st|�}| s&| �|�� � n<t| d �t|� |krT| d || 7 < n| �|�� � d S )N���)� isinstance�strr �append�lstripr# )�L�s�maxlenZextrar r r � _max_appendk s r2 c C s t t| dd� d��S )zDTurn a string in the form =AB to the ASCII character with value 0xab� � � )r �int�r0 r r r r v s c C s t t| � S r" )� _QUOPRI_MAP�ord)r r r r r { s � iso-8859-1c C s$ | sdS | � d��t�}d||f S )a� Encode a single header line with quoted-printable (like) encoding. Defined in RFC 2045, this `Q' encoding is similar to quoted-printable, but used specifically for email header fields to allow charsets with mostly 7 bit characters (and some 8 bit) to remain more or less readable in non-RFC 2045 aware mail clients. charset names the character set to use in the RFC 2046 header. It defaults to iso-8859-1. r �latin1z =?%s?q?%s?=)r � translater )Z header_bytes�charset�encodedr r r r s s �L c C s� |dk rt d��| s| S | �t�} d| }|d }g }|j}| �� D �] }d}t|�d | } || kr�|| } || d dkr�|||| d � � | d }q^|| d dkr�|||| � � | d }q^|||| � d � | }q^|�rR|d dk�rR|| } | d k�rt|d �} n(| dk�r,|d | } n|t|d � } |||d� | � qD|||d � � qD| d tk�rz|d � |�|�S ) a� Encode with quoted-printable, wrapping at maxlinelen characters. Each line of encoded text will end with eol, which defaults to "\n". Set this to "\r\n" if you will be using the result of this function directly in an email. Each line will be wrapped at, at most, maxlinelen characters before the eol string (maxlinelen defaults to 76 characters, the maximum value permitted by RFC 2045). Long lines will have the 'soft line break' quoted-printable character "=" appended to them, so the decoded text will be identical to the original text. The minimum maxlinelen is 4 to have room for a quoted character ("=XX") followed by a soft line break. Smaller values will generate a ValueError. � z maxlinelen must be at least 4�=r3 r � r* z r4 Nr ) � ValueErrorr< �_QUOPRI_BODY_ENCODE_MAPr- � splitlinesr# r �CRLF�join) ZbodyZ maxlinelen�eolZ soft_breakZ maxlinelen1Z encoded_bodyr- �line�startZ laststart�stopZroom�qr r r r � sD c C s | s| S d}| � � D ]�}|�� }|s.||7 }qd}t|�}||k r|| }|dkrd||7 }|d7 }nv|d |kr||d7 }q:n^|d |k r�||d tkr�||d tkr�|t|||d � �7 }|d7 }n||7 }|d7 }||kr:||7 }q:q| d dk�r|�|��r|d d� }|S ) z_Decode a quoted-printable string. Lines are separated with eol, which defaults to \n. r r rA r3 rB r4 r* r N)rE �rstripr# r r �endswith)r> rH ZdecodedrI �i�nr r r r r � s8 , c C s | � d�}t|�S )zCTurn a match in the form =AB to the ASCII character with value 0xabr )�groupr )�matchr0 r r r �_unquote_match s rS c C s | � dd�} tjdt| tjd�S )a Decode a string encoded with RFC 2045 MIME header `Q' encoding. This function does not parse a full MIME header value encoded with quoted-printable (like =?iso-8859-1?q?Hello_World?=) -- please use the high level email.header class for that functionality. r r z=[a-fA-F0-9]{2})�flags)�replace�re�subrS �ASCIIr7 r r r r # s )r )r: )!�__doc__�__all__rV �stringr r r rF �NLZ EMPTYSTRING�ranger8 r r �encoder r r9 r r! r r r2 r r r rD r r r r rS r r r r r �<module> sR � O 0__pycache__/header.cpython-38.opt-2.pyc 0000644 00000025101 15204103444 0013570 0 ustar 00 U e5d&^ � @ s� d ddgZ ddlZddlZddlZddlZddlmZ ddlmZ e j Z dZ dZ d Z d Zd Zd Zd Ze d�Ze d�Ze�dejejB �Ze�d�Ze�d�ZejjZdd� Z ddd�Z G dd � d �Z G dd� d�Z G dd� de �Z!dS )�Header� decode_header� make_header� N)�HeaderParseError)�charset� � � z � �N z �us-asciizutf-8ai =\? # literal =? (?P<charset>[^?]*?) # non-greedy up to the next ? is the charset \? # literal ? (?P<encoding>[qQbB]) # either a "q" or a "b", case insensitive \? # literal ? (?P<encoded>.*?) # non-greedy up to the next ?= is the encoded string \?= # literal ?= z[\041-\176]+:$z \n[^ \t]+:c C s� t | d�rdd� | jD �S t�| �s.| d fgS g }| �� D ]�}t�|�}d}|r:|�d�}|rj|�� }d}|r~|�|d d f� |rL|�d�� � }|�d�� � }|�d�}|�|||f� qLq:g } t |�D ]J\} } | dkr�| d r�|| d d r�|| d d � � r�| �| d � q�t | �D ] } || = �q g } |D ]�\}}}|d k�rV| �||f� n�|d k�r|t j�|�}| �||f� n~|d k�r�t|�d }|�r�|d d d | � 7 }zt j�|�}W n tjk �r� td ��Y nX | �||f� n td| ���q2g }d }}| D ]v\}}t|t��r,t|d�}|d k�r@|}|}nB||k�rb|�||f� |}|}n |d k�rz|t| 7 }n||7 }�q|�||f� |S )N�_chunksc S s( g | ] \}}t �|t|��t|�f�qS � )�_charsetZ_encode�str)�.0�stringr r r �$/usr/lib64/python3.8/email/header.py� <listcomp>M s �z!decode_header.<locals>.<listcomp>Tr F� � �q�b� z===zBase64 decoding errorzUnexpected encoding: zraw-unicode-escape)�hasattrr �ecre�search� splitlines�split�pop�lstrip�append�lower� enumerate�isspace�reversed�email� quoprimimeZ header_decode�lenZ base64mime�decode�binascii�Errorr �AssertionError� isinstancer �bytes�BSPACE)�headerZwords�line�parts�firstZ unencodedr �encodingZencodedZdroplist�n�w�dZ decoded_wordsZencoded_stringZwordZpaderrZ collapsedZ last_word� last_charsetr r r r = s| � 4 c C sF t |||d�}| D ].\}}|d k r4t|t�s4t|�}|�||� q|S )N)� maxlinelen� header_name�continuation_ws)r r- �Charsetr! )Z decoded_seqr9 r: r; �h�sr r r r r � s � c @ sJ e Zd Zddd�Zdd� Zdd � Zdd d �Zd d � Zddd�Zdd� Z dS )r Nr �strictc C s| |d krt }nt|t�s t|�}|| _|| _g | _|d k rH| �|||� |d krTt}|| _|d krjd| _ nt |�d | _ d S )Nr r ) �USASCIIr- r< r �_continuation_wsr r! � MAXLINELEN� _maxlinelen� _headerlenr( )�selfr> r r9 r: r; �errorsr r r �__init__� s zHeader.__init__c C s� | � � g }d }d }| jD ]�\}}|}|tjkrH|�dd�}|�dd�}|r�|o\| �|d �}|dkr�|dkr�|s�|�t� d }n|dkr�|s�|�t� |o�| �|d �}|}|�|� qt � |�S )N�ascii�surrogateescape�replacer �Nr ���) � _normalizer r � UNKNOWN8BIT�encoder) � _nonctextr! �SPACE� EMPTYSTRING�join) rE Zuchunks�lastcs� lastspacer r ZnextcsZoriginal_bytes�hasspacer r r �__str__� s* zHeader.__str__c C s |t | �kS �N)r )rE �otherr r r �__eq__ s z Header.__eq__c C s� |d kr| j }nt|t�s"t|�}t|t�sZ|jp4d}|t jkrN|�dd�}n |�||�}|jpbd}|t jkr�z|�||� W n" t k r� |dkr�� t }Y nX | j � ||f� d S )Nr rI ) r r- r< r Z input_codecrN r) Z output_codecrO �UnicodeEncodeError�UTF8r r! )rE r> r rF Z input_charsetZoutput_charsetr r r r! s$ z Header.appendc C s |� � p|dkS )N)�(�)�\)r$ )rE r> r r r rP 4 s zHeader._nonctext�;, r c C s� | � � |d kr| j}|dkr"d}t| j|| j|�}d }d }}| jD �] \}} |d k r�|oh| �|d �}|dkr�|r~| dkr�|�� n| dkr�|s�|�� |o�| �|d �}| }d}|�� } | r�|� d| d | � n|� dd| � | dd � D ]`} |� � | j d k �r"|� | jd| � � | � q�| � � } | d t | �t | � � } |� | | | � q�t | �dkrF|� � qF| j�rx|�� |�|�}t�|��r�td �|���|S ) Nr i@B rK rL Fr r r z8header value appears to contain an embedded header: {!r})rM rC �_ValueFormatterrD rA r rP �add_transitionr �feed�newline�header_encodingr r( �_str�_embedded_headerr r �format)rE � splitcharsr9 �linesepZ formatterrT rV rU r r �linesr1 Zsline�fws�valuer r r rO 9 sZ ! � � �z Header.encodec C sx g }d }g }| j D ]B\}}||kr.|�|� q|d k rJ|�t�|�|f� |g}|}q|rn|�t�|�|f� || _ d S rX )r r! rQ rS )rE Zchunksr8 Z last_chunkr r r r r rM � s zHeader._normalize)NNNNr r? )Nr? )r` Nr ) �__name__� __module__� __qualname__rG rW rZ r! rP rO rM r r r r r � s � / + Pc @ sT e Zd Zdd� Zdd� Zdd� Zdd� Zd d � Zd d � Zd d� Z dd� Z dd� Z dS )ra c C s0 || _ || _t|�| _|| _g | _t|�| _d S rX )�_maxlenrA r( �_continuation_ws_len� _splitchars�_lines� _Accumulator� _current_line)rE Z headerlen�maxlenr; ri r r r rG � s z_ValueFormatter.__init__c C s | � � |�| j�S rX )rd rS rt )rE rj r r r rf � s z_ValueFormatter._strc C s | � t�S rX )rf �NL�rE r r r rW � s z_ValueFormatter.__str__c C sv | j �� }|dkr | j j|� t| j �dkrh| j �� rV| jrV| jd t| j �7 < n| j�t| j �� | j �� d S )N)r r r rL ) rv r �pushr( � is_onlywsrt r r! �reset)rE Z end_of_liner r r rd � s z_ValueFormatter.newlinec C s | j �dd� d S )Nr r )rv rz ry r r r rb � s z _ValueFormatter.add_transitionc C s� |j d kr | �||| j� d S |�|| �� �}z|�d�}W n tk rR Y d S X |d k rh| �||� z |�� }W n tk r� Y d S X | �� | j � | j |� |D ]}| j � | j | � q�d S �Nr )re � _ascii_splitrs Zheader_encode_lines� _maxlengthsr � IndexError� _append_chunkrd rv rz rA rt r! )rE rl r r Z encoded_linesZ first_line� last_liner1 r r r rc � s$ z_ValueFormatter.feedc c s& | j t| j� V | j | j V qd S rX )rq r( rv rr ry r r r r � s z_ValueFormatter._maxlengthsc C sf t �dt d || �}|d r0dg|d d�< n |�d� tt|�gd � D ]\}}| �||� qLd S )Nz([z]+)r r r )�rer �FWSr �zip�iterr� )rE rl r ri r2 �partr r r r~ � s z _ValueFormatter._ascii_splitc C s | j �||� t| j �| jk�r| jD ]v}t| j �� d dd�D ]T}|�� rn| j | d }|rn|d |krn q�| j |d d }|r@|d |kr@ q�q@q& q�q&| j �� \}}| j j dkr�| � � |s�d}| j �||� d S | j � |�}| j � t| j �� | j �|� d S )Nr r rL r )rv rz r( rq rs �range� part_countr$ r � _initial_sizerd �pop_fromrt r! r r| )rE rl r Zch�iZprevpartr� Z remainderr r r r� � s. z _ValueFormatter._append_chunkN) rn ro rp rG rf rW rd rb rc r r~ r� r r r r ra � s %ra c sj e Zd Zd� fdd� Zdd� Zddd�Z� fdd �Zd d � Zd d � Zddd�Z dd� Z � fdd�Z � Z S )ru r c s || _ t� �� d S rX )r� �superrG )rE Z initial_size�� __class__r r rG s z_Accumulator.__init__c C s | � ||f� d S rX )r! )rE rl r r r r rz # s z_Accumulator.pushc C s | |d � }g | |d �< |S rX r )rE r� Zpoppedr r r r� & s z_Accumulator.pop_fromc s | � � dkrdS t� �� S )Nr )r r )r� r� r ry r� r r r + s z_Accumulator.popc C s t dd� | D �| j�S )Nc s s" | ]\}}t |�t |� V qd S rX )r( �r rl r� r r r � <genexpr>1 s z'_Accumulator.__len__.<locals>.<genexpr>)�sumr� ry r r r �__len__0 s �z_Accumulator.__len__c C s t �dd� | D ��S )Nc s s | ]\}}t �||f�V qd S rX �rR rS r� r r r r� 5 s �z'_Accumulator.__str__.<locals>.<genexpr>r� ry r r r rW 4 s �z_Accumulator.__str__Nc C s" |d kr g }|| d d �< d| _ d S r} )r� )rE Zstartvalr r r r| 8 s z_Accumulator.resetc C s | j dko| pt| ��� S r} )r� r r$ ry r r r r{ > s z_Accumulator.is_onlywsc s t � �� S rX )r� r� ry r� r r r� A s z_Accumulator.part_count)r )r )N) rn ro rp rG rz r� r r� rW r| r{ r� � __classcell__r r r� r ru s ru )NNr )"�__all__r� r* Zemail.quoprimimer& Zemail.base64mimeZ email.errorsr r r r< rx rQ r/ ZSPACE8rR rB r� r@ r\ �compile�VERBOSE� MULTILINEr Zfcrerg r' Z _max_appendr r r ra �listru r r r r �<module> sD � � _ � k __pycache__/iterators.cpython-38.opt-1.pyc 0000644 00000003602 15204103444 0014355 0 ustar 00 U e5dW � @ sL d Z dddgZddlZddlmZ dd� Zdd d�Zdd d�Zdd d �ZdS )z1Various types of useful iterators and generators.�body_line_iterator�typed_subpart_iterator�walk� N)�StringIOc c s. | V | � � r*| �� D ]}|�� E dH qdS )z�Walk over the message tree, yielding each subpart. The walk is performed in depth-first order. This method is a generator. N)� is_multipart� get_payloadr )�self�subpart� r �'/usr/lib64/python3.8/email/iterators.pyr s Fc c s6 | � � D ](}|j|d�}t|t�rt|�E dH qdS )z�Iterate over the parts, returning string payloads line-by-line. Optional decode (default False) is passed through to .get_payload(). )�decodeN)r r � isinstance�strr )�msgr r Zpayloadr r r r " s �textc c s8 | � � D ]*}|�� |kr|dks,|�� |kr|V qdS )z�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. N)r Zget_content_maintypeZget_content_subtype)r ZmaintypeZsubtyper r r r r - s c C s� |dkrt j}d|d }t|| �� d|d� |rJtd| �� |d� n t|d� | �� r|| �� D ]}t|||d |� qddS ) zA handy debugging aidN� � � )�end�filez [%s])r � )�sys�stdout�printZget_content_typeZget_default_typer r � _structure)r �fp�levelZinclude_defaultZtabr r r r r ; s r )F)r N)Nr F) �__doc__�__all__r �ior r r r r r r r r �<module> s � __pycache__/headerregistry.cpython-38.pyc 0000644 00000053036 15204103444 0014431 0 ustar 00 U e5dKQ � @ sz d Z ddlmZ ddlmZ ddlmZ ddlmZ G dd� d�ZG dd � d �Z G d d � d e �Z d d � Z G dd� d�Z G dd� de �ZG dd� d�ZG dd� de�ZG dd� d�ZG dd� de�ZG dd� de�ZG d d � d e�ZG d d � d �ZG d d!� d!�ZG d"d#� d#e�ZG d$d%� d%e�ZG d&d'� d'�ZG d(d)� d)�Zeeeeeeeeeeeeeeeeeeeed*�ZG d+d,� d,�Z d-S ).a; Representing and manipulating email headers via custom objects. This module provides an implementation of the HeaderRegistry API. The implementation is designed to flexibly follow RFC5322 rules. Eventually HeaderRegistry will be a public API, but it isn't yet, and will probably change some before that happens. � )�MappingProxyType)�utils)�errors)�_header_value_parserc @ s^ e Zd Zddd�Zedd� �Zedd� �Zed d � �Zed d � �Zd d� Z dd� Z dd� Z dS )�Address� Nc C s� d� td||||f��}d|ks(d|kr0td��|dk r�|s@|rHtd��t�|�\}}|rjtd�||���|jrz|jd �|j}|j }|| _ || _ || _ dS ) a� Create an object representing a full email address. An address can have a 'display_name', a 'username', and a 'domain'. In addition to specifying the username and domain separately, they may be specified together by using the addr_spec keyword *instead of* the username and domain keywords. If an addr_spec string is specified it must be properly quoted according to RFC 5322 rules; an error will be raised if it is not. An Address object has display_name, username, domain, and addr_spec attributes, all of which are read-only. The addr_spec and the string value of the object are both quoted according to RFC5322 rules, but without any Content Transfer Encoding. r N� � z8invalid arguments; address parts cannot contain CR or LFz=addrspec specified when username and/or domain also specifiedz6Invalid addr_spec; only '{}' could be parsed from '{}'r ) �join�filter� ValueError� TypeError�parserZ get_addr_spec�format� all_defects� local_part�domain� _display_name� _username�_domain)�self� display_name�usernamer � addr_specZinputsZa_s�rest� r �,/usr/lib64/python3.8/email/headerregistry.py�__init__ s& � zAddress.__init__c C s | j S �N�r �r r r r r < s zAddress.display_namec C s | j S r )r r r r r r @ s zAddress.usernamec C s | j S r )r r r r r r D s zAddress.domainc C sT t | j�}t|�t|tj �kr.t�| j�}n| j}| jrH|d | j S |sPdS |S )z�The addr_spec (username@domain) portion of the address, quoted according to RFC 5322 rules, but with no Content Transfer Encoding. �@�<>)�setr �lenr Z DOT_ATOM_ENDS� quote_stringr )r �namesetZlpr r r r H s zAddress.addr_specc C s d� | jj| j| j| j�S )Nz1{}(display_name={!r}, username={!r}, domain={!r}))r � __class__�__name__r r r r r r r �__repr__X s �zAddress.__repr__c C s^ t | j�}t|�t|tj �kr.t�| j�}n| j}|rX| jdkrFdn| j}d�||�S | jS )Nr" r z{} <{}>)r# r r$ r �SPECIALSr% r r )r r& �dispr r r r �__str__] s zAddress.__str__c C s8 t |�t | �krdS | j|jko6| j|jko6| j|jkS �NF)�typer r r �r �otherr r r �__eq__h s � �zAddress.__eq__)r r r N) r( � __module__� __qualname__r �propertyr r r r r) r, r1 r r r r r s * r c @ sF e Zd Zddd�Zedd� �Zedd� �Zdd � Zd d � Zd d � Z dS )�GroupNc C s || _ |rt|�nt� | _dS )a Create an object representing an address group. An address group consists of a display_name followed by colon and a list of addresses (see Address) terminated by a semi-colon. The Group is created by specifying a display_name and a possibly empty list of Address objects. A Group can also be used to represent a single address that is not in a group, which is convenient when manipulating lists that are a combination of Groups and individual Addresses. In this case the display_name should be set to None. In particular, the string representation of a Group whose display_name is None is the same as the Address object, if there is one and only one Address object in the addresses list. N)r �tuple� _addresses)r r � addressesr r r r r s zGroup.__init__c C s | j S r r r r r r r � s zGroup.display_namec C s | j S r )r7 r r r r r8 � s zGroup.addressesc C s d� | jj| j| j�S )Nz${}(display_name={!r}, addresses={!r})r r' r( r r8 r r r r r) � s �zGroup.__repr__c C s� | j d kr&t| j�dkr&t| jd �S | j }|d k r\t|�}t|�t|tj �kr\t�|�}d�dd� | jD ��}|r~d| n|}d� ||�S )N� r �, c s s | ]}t |�V qd S r ��str)�.0�xr r r � <genexpr>� s z Group.__str__.<locals>.<genexpr>� z{}:{};) r r$ r8 r< r# r r* r% r r )r r+ r& Zadrstrr r r r, � s z Group.__str__c C s, t |�t | �krdS | j|jko*| j|jkS r- )r. r r8 r/ r r r r1 � s �z Group.__eq__)NN) r( r2 r3 r r4 r r8 r) r, r1 r r r r r5 p s r5 c @ sT e Zd ZdZdd� Zdd� Zedd� �Zedd � �Zd d � Z e d d � �Z dd� Z dS )� BaseHeadera| Base class for message headers. Implements generic behavior and provides tools for subclasses. A subclass must define a classmethod named 'parse' that takes an unfolded value string and a dictionary as its arguments. The dictionary will contain one key, 'defects', initialized to an empty list. After the call the dictionary must contain two additional keys: parse_tree, set to the parse tree obtained from parsing the header, and 'decoded', set to the string value of the idealized representation of the data from the value. (That is, encoded words are decoded, and values that have canonical representations are so represented.) The defects key is intended to collect parsing defects, which the message parser will subsequently dispose of as appropriate. The parser should not, insofar as practical, raise any errors. Defects should be added to the list instead. The standard header parsers register defects for RFC compliance issues, for obsolete RFC syntax, and for unrecoverable parsing errors. The parse method may add additional keys to the dictionary. In this case the subclass must define an 'init' method, which will be passed the dictionary as its keyword arguments. The method should use (usually by setting them as the value of similarly named attributes) and remove all the extra keys added by its parse method, and then use super to call its parent class with the remaining arguments and keywords. The subclass should also make sure that a 'max_count' attribute is defined that is either None or 1. XXX: need to better define this API. c C s\ dg i}| � ||� t�|d �r4t�|d �|d< t�| |d �}|d= |j|f|� |S )N�defects�decoded)�parser Z_has_surrogates� _sanitizer< �__new__�init)�cls�name�value�kwdsr r r r rF � s zBaseHeader.__new__c C s || _ || _|| _d S r )�_name� _parse_tree�_defects)r rI � parse_treerB r r r rG � s zBaseHeader.initc C s | j S r )rL r r r r rI � s zBaseHeader.namec C s t | j�S r )r6 rN r r r r rB � s zBaseHeader.defectsc C s t | jj| jjt| �f| jfS r )�_reconstruct_headerr' r( � __bases__r< �__dict__r r r r � __reduce__� s ��zBaseHeader.__reduce__c C s t �| |�S r )r< rF )rH rJ r r r � _reconstruct� s zBaseHeader._reconstructc C s` t �t �t �| jd�t �dd�g�g�}| jrH|�t �t �dd�g�� |�| j� |j |d�S )at Fold header according to policy. The parsed representation of the header is folded according to RFC5322 rules, as modified by the policy. If the parse tree contains surrogateescaped bytes, the bytes are CTE encoded using the charset 'unknown-8bit". Any non-ASCII characters in the parse tree are CTE encoded using charset utf-8. XXX: make this a policy setting. The returned value is an ASCII-only string possibly containing linesep characters, and ending with a linesep character. The string includes the header name and the ': ' separator. z header-name�:z header-sepr@ Zfws)�policy) r ZHeaderZ HeaderLabelZ ValueTerminalrI rM �appendZCFWSListZWhiteSpaceTerminal�fold)r rV �headerr r r rX � s ��� zBaseHeader.foldN) r( r2 r3 �__doc__rF rG r4 rI rB rS � classmethodrT rX r r r r rA � s rA c C s t | |i ��|�S r )r. rT )Zcls_name�basesrJ r r r rP s rP c @ s& e Zd ZdZeej�Zedd� �Z dS )�UnstructuredHeaderNc C s" | � |�|d< t|d �|d< d S )NrO rC )� value_parserr< �rH rJ rK r r r rD s zUnstructuredHeader.parse) r( r2 r3 � max_count� staticmethodr �get_unstructuredr^ r[ rD r r r r r] s r] c @ s e Zd ZdZdS )�UniqueUnstructuredHeaderr9 N�r( r2 r3 r` r r r r rc s rc c sF e Zd ZdZdZeej�Ze dd� �Z � fdd�Z e dd� �Z � ZS ) � DateHeadera� Header whose value consists of a single timestamp. Provides an additional attribute, datetime, which is either an aware datetime using a timezone, or a naive datetime if the timezone in the input string is -0000. Also accepts a datetime as input. The 'value' attribute is the normalized form of the timestamp, which means it is the output of format_datetime on the datetime. Nc C sz |s6|d � t�� � d |d< d|d< t�� |d< d S t|t�rJt�|�}||d< t� |d �|d< | � |d �|d< d S )NrB �datetimer rC rO ) rW r ZHeaderMissingRequiredValuer Z TokenList� isinstancer< r Zparsedate_to_datetimeZformat_datetimer^ r_ r r r rD . s zDateHeader.parsec s |� d�| _t� j||� d S )Nrf )�pop� _datetime�superrG �r �args�kw�r' r r rG < s zDateHeader.initc C s | j S r )ri r r r r rf @ s zDateHeader.datetime)r( r2 r3 rZ r` ra r rb r^ r[ rD rG r4 rf � __classcell__r r rn r re s re c @ s e Zd ZdZdS )�UniqueDateHeaderr9 Nrd r r r r rp E s rp c sP e Zd ZdZedd� �Zedd� �Z� fdd�Ze dd � �Z e d d � �Z � Z S ) � AddressHeaderNc C s t �| �\}} | rtd��|S )Nzthis should not happen)r Zget_address_list�AssertionError)rJ � address_listr r r r^ N s zAddressHeader.value_parserc C s� t |t�rV| �|� |d< }g }|jD ]"}|�t|jdd� |jD ��� q&t|j �}n"t |d�sf|g}dd� |D �}g }||d< ||d< d� d d� |D ��|d < d|kr�| �|d �|d< d S ) NrO c S s* g | ]"}t |jpd |jpd |jp"d ��qS )r )r r r r )r= Zmbr r r � <listcomp>] s � �z'AddressHeader.parse.<locals>.<listcomp>�__iter__c S s& g | ] }t |d �s td|g�n|�qS )r8 N)�hasattrr5 �r= �itemr r r rt f s ��groupsrB r: c S s g | ] }t |��qS r r; rw r r r rt l s rC ) rg r< r^ r8 rW r5 r Z all_mailboxes�listr rv r )rH rJ rK rs ry ZaddrrB r r r rD T s* �� �zAddressHeader.parsec s( t |�d��| _d | _t� j||� d S )Nry )r6 rh �_groupsr7 rj rG rk rn r r rG p s zAddressHeader.initc C s | j S r )r{ r r r r ry u s zAddressHeader.groupsc C s& | j d kr tdd� | jD ��| _ | j S )Nc s s | ]}|j D ] }|V q qd S r )r8 )r= �group�addressr r r r? | s �z*AddressHeader.addresses.<locals>.<genexpr>)r7 r6 r{ r r r r r8 y s zAddressHeader.addresses) r( r2 r3 r` ra r^ r[ rD rG r4 ry r8 ro r r rn r rq J s rq c @ s e Zd ZdZdS )�UniqueAddressHeaderr9 Nrd r r r r r~ � s r~ c @ s e Zd Zedd� �ZdS )�SingleAddressHeaderc C s( t | j�dkr td�| j���| jd S )Nr9 z9value of single address header {} is not a single addressr )r$ r8 r r rI r r r r r} � s �zSingleAddressHeader.addressN)r( r2 r3 r4 r} r r r r r � s r c @ s e Zd ZdZdS )�UniqueSingleAddressHeaderr9 Nrd r r r r r� � s r� c sZ e Zd ZdZeej�Zedd� �Z � fdd�Z e dd� �Z e dd � �Z e d d � �Z� ZS ) �MIMEVersionHeaderr9 c C s� | � |� |d< }t|�|d< |d �|j� |jd kr<d n|j|d< |j|d< |jd k rtd�|d |d �|d< nd |d< d S )NrO rC rB �major�minorz{}.{}�version)r^ r< �extendr r� r� r �rH rJ rK rO r r r rD � s zMIMEVersionHeader.parsec s6 |� d�| _|� d�| _|� d�| _t� j||� d S )Nr� r� r� )rh �_version�_major�_minorrj rG rk rn r r rG � s zMIMEVersionHeader.initc C s | j S r )r� r r r r r� � s zMIMEVersionHeader.majorc C s | j S r )r� r r r r r� � s zMIMEVersionHeader.minorc C s | j S r )r� r r r r r� � s zMIMEVersionHeader.version)r( r2 r3 r` ra r Zparse_mime_versionr^ r[ rD rG r4 r� r� r� ro r r rn r r� � s r� c s8 e Zd ZdZedd� �Z� fdd�Zedd� �Z� Z S )�ParameterizedMIMEHeaderr9 c C sZ | � |� |d< }t|�|d< |d �|j� |jd krBi |d< ndd� |jD �|d< d S )NrO rC rB �paramsc S s& i | ] \}}t �|��� t �|��qS r )r rE �lower)r= rI rJ r r r � <dictcomp>� s � z1ParameterizedMIMEHeader.parse.<locals>.<dictcomp>)r^ r< r� r r� r� r r r rD � s �z ParameterizedMIMEHeader.parsec s |� d�| _t� j||� d S )Nr� )rh �_paramsrj rG rk rn r r rG � s z ParameterizedMIMEHeader.initc C s t | j�S r )r r� r r r r r� � s z ParameterizedMIMEHeader.params) r( r2 r3 r` r[ rD rG r4 r� ro r r rn r r� � s r� c sJ e Zd Zeej�Z� fdd�Zedd� �Z edd� �Z edd� �Z � Z S ) �ContentTypeHeaderc s2 t � j||� t�| jj�| _t�| jj�| _d S r ) rj rG r rE rM �maintype� _maintype�subtype�_subtyperk rn r r rG � s zContentTypeHeader.initc C s | j S r )r� r r r r r� � s zContentTypeHeader.maintypec C s | j S r )r� r r r r r� � s zContentTypeHeader.subtypec C s | j d | j S )N�/)r� r� r r r r � content_type� s z ContentTypeHeader.content_type) r( r2 r3 ra r Zparse_content_type_headerr^ rG r4 r� r� r� ro r r rn r r� � s r� c s2 e Zd Zeej�Z� fdd�Zedd� �Z � Z S )�ContentDispositionHeaderc s2 t � j||� | jj}|d kr"|nt�|�| _d S r )rj rG rM �content_dispositionr rE �_content_disposition)r rl rm Zcdrn r r rG � s z ContentDispositionHeader.initc C s | j S r )r� r r r r r� � s z,ContentDispositionHeader.content_disposition) r( r2 r3 ra r Z parse_content_disposition_headerr^ rG r4 r� ro r r rn r r� � s r� c sB e Zd ZdZeej�Zedd� �Z � fdd�Z e dd� �Z � Z S )� ContentTransferEncodingHeaderr9 c C s2 | � |� |d< }t|�|d< |d �|j� d S �NrO rC rB �r^ r< r� r r� r r r rD s z#ContentTransferEncodingHeader.parsec s" t � j||� t�| jj�| _d S r )rj rG r rE rM �cte�_cterk rn r r rG s z"ContentTransferEncodingHeader.initc C s | j S r )r� r r r r r� s z!ContentTransferEncodingHeader.cte)r( r2 r3 r` ra r Z&parse_content_transfer_encoding_headerr^ r[ rD rG r4 r� ro r r rn r r� � s r� c @ s& e Zd ZdZeej�Zedd� �Z dS )�MessageIDHeaderr9 c C s2 | � |� |d< }t|�|d< |d �|j� d S r� r� r� r r r rD s zMessageIDHeader.parseN) r( r2 r3 r` ra r Zparse_message_idr^ r[ rD r r r r r� s r� )Zsubject�datez resent-datez orig-dateZsenderz resent-sender�toz resent-toZccz resent-ccZbccz resent-bcc�fromz resent-fromzreply-toz mime-versionz content-typezcontent-dispositionzcontent-transfer-encodingz message-idc @ s8 e Zd ZdZeedfdd�Zdd� Zdd� Zd d � Z d S ) �HeaderRegistryz%A header_factory and header registry.Tc C s& i | _ || _|| _|r"| j �t� dS )a� Create a header_factory that works with the Policy API. base_class is the class that will be the last class in the created header class's __bases__ list. default_class is the class that will be used if "name" (see __call__) does not appear in the registry. use_default_map controls whether or not the default mapping of names to specialized classes is copied in to the registry when the factory is created. The default is True. N)�registry� base_class� default_class�update�_default_header_map)r r� r� Zuse_default_mapr r r r 9 s zHeaderRegistry.__init__c C s || j |�� < dS )zLRegister cls as the specialized class for handling "name" headers. N)r� r� �r rI rH r r r � map_to_typeK s zHeaderRegistry.map_to_typec C s, | j �|�� | j�}td|j || jfi �S )N�_)r� �getr� r� r. r( r� r� r r r � __getitem__Q s zHeaderRegistry.__getitem__c C s | | ||�S )a� Create a header instance for header 'name' from 'value'. Creates a header instance by creating a specialized class for parsing and representing the specified header by combining the factory base_class with a specialized class from the registry or the default_class, and passing the name and value to the constructed class's constructor. r )r rI rJ r r r �__call__U s zHeaderRegistry.__call__N) r( r2 r3 rZ rA r] r r� r� r� r r r r r� 5 s � r� N) rZ �typesr Zemailr r r r r r5 r< rA rP r] rc re rp rq r~ r r� r� r� r� r� r� r� r� r� r r r r �<module> sX `6d '7 % � __pycache__/headerregistry.cpython-38.opt-1.pyc 0000644 00000052752 15204103444 0015374 0 ustar 00 U e5dKQ � @ sz d Z ddlmZ ddlmZ ddlmZ ddlmZ G dd� d�ZG dd � d �Z G d d � d e �Z d d � Z G dd� d�Z G dd� de �ZG dd� d�ZG dd� de�ZG dd� d�ZG dd� de�ZG dd� de�ZG d d � d e�ZG d d � d �ZG d d!� d!�ZG d"d#� d#e�ZG d$d%� d%e�ZG d&d'� d'�ZG d(d)� d)�Zeeeeeeeeeeeeeeeeeeeed*�ZG d+d,� d,�Z d-S ).a; Representing and manipulating email headers via custom objects. This module provides an implementation of the HeaderRegistry API. The implementation is designed to flexibly follow RFC5322 rules. Eventually HeaderRegistry will be a public API, but it isn't yet, and will probably change some before that happens. � )�MappingProxyType)�utils)�errors)�_header_value_parserc @ s^ e Zd Zddd�Zedd� �Zedd� �Zed d � �Zed d � �Zd d� Z dd� Z dd� Z dS )�Address� Nc C s� d� td||||f��}d|ks(d|kr0td��|dk r�|s@|rHtd��t�|�\}}|rjtd�||���|jrz|jd �|j}|j }|| _ || _ || _ dS ) a� Create an object representing a full email address. An address can have a 'display_name', a 'username', and a 'domain'. In addition to specifying the username and domain separately, they may be specified together by using the addr_spec keyword *instead of* the username and domain keywords. If an addr_spec string is specified it must be properly quoted according to RFC 5322 rules; an error will be raised if it is not. An Address object has display_name, username, domain, and addr_spec attributes, all of which are read-only. The addr_spec and the string value of the object are both quoted according to RFC5322 rules, but without any Content Transfer Encoding. r N� � z8invalid arguments; address parts cannot contain CR or LFz=addrspec specified when username and/or domain also specifiedz6Invalid addr_spec; only '{}' could be parsed from '{}'r ) �join�filter� ValueError� TypeError�parserZ get_addr_spec�format� all_defects� local_part�domain� _display_name� _username�_domain)�self� display_name�usernamer � addr_specZinputsZa_s�rest� r �,/usr/lib64/python3.8/email/headerregistry.py�__init__ s& � zAddress.__init__c C s | j S �N�r �r r r r r < s zAddress.display_namec C s | j S r )r r r r r r @ s zAddress.usernamec C s | j S r )r r r r r r D s zAddress.domainc C sT t | j�}t|�t|tj �kr.t�| j�}n| j}| jrH|d | j S |sPdS |S )z�The addr_spec (username@domain) portion of the address, quoted according to RFC 5322 rules, but with no Content Transfer Encoding. �@�<>)�setr �lenr Z DOT_ATOM_ENDS� quote_stringr )r �namesetZlpr r r r H s zAddress.addr_specc C s d� | jj| j| j| j�S )Nz1{}(display_name={!r}, username={!r}, domain={!r}))r � __class__�__name__r r r r r r r �__repr__X s �zAddress.__repr__c C s^ t | j�}t|�t|tj �kr.t�| j�}n| j}|rX| jdkrFdn| j}d�||�S | jS )Nr" r z{} <{}>)r# r r$ r �SPECIALSr% r r )r r& �dispr r r r �__str__] s zAddress.__str__c C s8 t |�t | �krdS | j|jko6| j|jko6| j|jkS �NF)�typer r r �r �otherr r r �__eq__h s � �zAddress.__eq__)r r r N) r( � __module__� __qualname__r �propertyr r r r r) r, r1 r r r r r s * r c @ sF e Zd Zddd�Zedd� �Zedd� �Zdd � Zd d � Zd d � Z dS )�GroupNc C s || _ |rt|�nt� | _dS )a Create an object representing an address group. An address group consists of a display_name followed by colon and a list of addresses (see Address) terminated by a semi-colon. The Group is created by specifying a display_name and a possibly empty list of Address objects. A Group can also be used to represent a single address that is not in a group, which is convenient when manipulating lists that are a combination of Groups and individual Addresses. In this case the display_name should be set to None. In particular, the string representation of a Group whose display_name is None is the same as the Address object, if there is one and only one Address object in the addresses list. N)r �tuple� _addresses)r r � addressesr r r r r s zGroup.__init__c C s | j S r r r r r r r � s zGroup.display_namec C s | j S r )r7 r r r r r8 � s zGroup.addressesc C s d� | jj| j| j�S )Nz${}(display_name={!r}, addresses={!r})r r' r( r r8 r r r r r) � s �zGroup.__repr__c C s� | j d kr&t| j�dkr&t| jd �S | j }|d k r\t|�}t|�t|tj �kr\t�|�}d�dd� | jD ��}|r~d| n|}d� ||�S )N� r �, c s s | ]}t |�V qd S r ��str)�.0�xr r r � <genexpr>� s z Group.__str__.<locals>.<genexpr>� z{}:{};) r r$ r8 r< r# r r* r% r r )r r+ r& Zadrstrr r r r, � s z Group.__str__c C s, t |�t | �krdS | j|jko*| j|jkS r- )r. r r8 r/ r r r r1 � s �z Group.__eq__)NN) r( r2 r3 r r4 r r8 r) r, r1 r r r r r5 p s r5 c @ sT e Zd ZdZdd� Zdd� Zedd� �Zedd � �Zd d � Z e d d � �Z dd� Z dS )� BaseHeadera| Base class for message headers. Implements generic behavior and provides tools for subclasses. A subclass must define a classmethod named 'parse' that takes an unfolded value string and a dictionary as its arguments. The dictionary will contain one key, 'defects', initialized to an empty list. After the call the dictionary must contain two additional keys: parse_tree, set to the parse tree obtained from parsing the header, and 'decoded', set to the string value of the idealized representation of the data from the value. (That is, encoded words are decoded, and values that have canonical representations are so represented.) The defects key is intended to collect parsing defects, which the message parser will subsequently dispose of as appropriate. The parser should not, insofar as practical, raise any errors. Defects should be added to the list instead. The standard header parsers register defects for RFC compliance issues, for obsolete RFC syntax, and for unrecoverable parsing errors. The parse method may add additional keys to the dictionary. In this case the subclass must define an 'init' method, which will be passed the dictionary as its keyword arguments. The method should use (usually by setting them as the value of similarly named attributes) and remove all the extra keys added by its parse method, and then use super to call its parent class with the remaining arguments and keywords. The subclass should also make sure that a 'max_count' attribute is defined that is either None or 1. XXX: need to better define this API. c C s\ dg i}| � ||� t�|d �r4t�|d �|d< t�| |d �}|d= |j|f|� |S )N�defects�decoded)�parser Z_has_surrogates� _sanitizer< �__new__�init)�cls�name�value�kwdsr r r r rF � s zBaseHeader.__new__c C s || _ || _|| _d S r )�_name� _parse_tree�_defects)r rI � parse_treerB r r r rG � s zBaseHeader.initc C s | j S r )rL r r r r rI � s zBaseHeader.namec C s t | j�S r )r6 rN r r r r rB � s zBaseHeader.defectsc C s t | jj| jjt| �f| jfS r )�_reconstruct_headerr' r( � __bases__r< �__dict__r r r r � __reduce__� s ��zBaseHeader.__reduce__c C s t �| |�S r )r< rF )rH rJ r r r � _reconstruct� s zBaseHeader._reconstructc C s` t �t �t �| jd�t �dd�g�g�}| jrH|�t �t �dd�g�� |�| j� |j |d�S )at Fold header according to policy. The parsed representation of the header is folded according to RFC5322 rules, as modified by the policy. If the parse tree contains surrogateescaped bytes, the bytes are CTE encoded using the charset 'unknown-8bit". Any non-ASCII characters in the parse tree are CTE encoded using charset utf-8. XXX: make this a policy setting. The returned value is an ASCII-only string possibly containing linesep characters, and ending with a linesep character. The string includes the header name and the ': ' separator. z header-name�:z header-sepr@ Zfws)�policy) r ZHeaderZ HeaderLabelZ ValueTerminalrI rM �appendZCFWSListZWhiteSpaceTerminal�fold)r rV �headerr r r rX � s ��� zBaseHeader.foldN) r( r2 r3 �__doc__rF rG r4 rI rB rS � classmethodrT rX r r r r rA � s rA c C s t | |i ��|�S r )r. rT )Zcls_name�basesrJ r r r rP s rP c @ s& e Zd ZdZeej�Zedd� �Z dS )�UnstructuredHeaderNc C s" | � |�|d< t|d �|d< d S )NrO rC )� value_parserr< �rH rJ rK r r r rD s zUnstructuredHeader.parse) r( r2 r3 � max_count� staticmethodr �get_unstructuredr^ r[ rD r r r r r] s r] c @ s e Zd ZdZdS )�UniqueUnstructuredHeaderr9 N�r( r2 r3 r` r r r r rc s rc c sF e Zd ZdZdZeej�Ze dd� �Z � fdd�Z e dd� �Z � ZS ) � DateHeadera� Header whose value consists of a single timestamp. Provides an additional attribute, datetime, which is either an aware datetime using a timezone, or a naive datetime if the timezone in the input string is -0000. Also accepts a datetime as input. The 'value' attribute is the normalized form of the timestamp, which means it is the output of format_datetime on the datetime. Nc C sz |s6|d � t�� � d |d< d|d< t�� |d< d S t|t�rJt�|�}||d< t� |d �|d< | � |d �|d< d S )NrB �datetimer rC rO ) rW r ZHeaderMissingRequiredValuer Z TokenList� isinstancer< r Zparsedate_to_datetimeZformat_datetimer^ r_ r r r rD . s zDateHeader.parsec s |� d�| _t� j||� d S )Nrf )�pop� _datetime�superrG �r �args�kw�r' r r rG < s zDateHeader.initc C s | j S r )ri r r r r rf @ s zDateHeader.datetime)r( r2 r3 rZ r` ra r rb r^ r[ rD rG r4 rf � __classcell__r r rn r re s re c @ s e Zd ZdZdS )�UniqueDateHeaderr9 Nrd r r r r rp E s rp c sP e Zd ZdZedd� �Zedd� �Z� fdd�Ze dd � �Z e d d � �Z � Z S ) � AddressHeaderNc C s t �| �\}} |S r )r Zget_address_list)rJ � address_listr r r r^ N s zAddressHeader.value_parserc C s� t |t�rV| �|� |d< }g }|jD ]"}|�t|jdd� |jD ��� q&t|j �}n"t |d�sf|g}dd� |D �}g }||d< ||d< d� d d� |D ��|d < d|kr�| �|d �|d< d S ) NrO c S s* g | ]"}t |jpd |jpd |jp"d ��qS )r )r r r r )r= Zmbr r r � <listcomp>] s � �z'AddressHeader.parse.<locals>.<listcomp>�__iter__c S s& g | ] }t |d �s td|g�n|�qS )r8 N)�hasattrr5 �r= �itemr r r rs f s ��groupsrB r: c S s g | ] }t |��qS r r; rv r r r rs l s rC ) rg r< r^ r8 rW r5 r Z all_mailboxes�listr ru r )rH rJ rK rr rx ZaddrrB r r r rD T s* �� �zAddressHeader.parsec s( t |�d��| _d | _t� j||� d S )Nrx )r6 rh �_groupsr7 rj rG rk rn r r rG p s zAddressHeader.initc C s | j S r )rz r r r r rx u s zAddressHeader.groupsc C s& | j d kr tdd� | jD ��| _ | j S )Nc s s | ]}|j D ] }|V q qd S r )r8 )r= �group�addressr r r r? | s �z*AddressHeader.addresses.<locals>.<genexpr>)r7 r6 rz r r r r r8 y s zAddressHeader.addresses) r( r2 r3 r` ra r^ r[ rD rG r4 rx r8 ro r r rn r rq J s rq c @ s e Zd ZdZdS )�UniqueAddressHeaderr9 Nrd r r r r r} � s r} c @ s e Zd Zedd� �ZdS )�SingleAddressHeaderc C s( t | j�dkr td�| j���| jd S )Nr9 z9value of single address header {} is not a single addressr )r$ r8 r r rI r r r r r| � s �zSingleAddressHeader.addressN)r( r2 r3 r4 r| r r r r r~ � s r~ c @ s e Zd ZdZdS )�UniqueSingleAddressHeaderr9 Nrd r r r r r � s r c sZ e Zd ZdZeej�Zedd� �Z � fdd�Z e dd� �Z e dd � �Z e d d � �Z� ZS ) �MIMEVersionHeaderr9 c C s� | � |� |d< }t|�|d< |d �|j� |jd kr<d n|j|d< |j|d< |jd k rtd�|d |d �|d< nd |d< d S )NrO rC rB �major�minorz{}.{}�version)r^ r< �extendr r� r� r �rH rJ rK rO r r r rD � s zMIMEVersionHeader.parsec s6 |� d�| _|� d�| _|� d�| _t� j||� d S )Nr� r� r� )rh �_version�_major�_minorrj rG rk rn r r rG � s zMIMEVersionHeader.initc C s | j S r )r� r r r r r� � s zMIMEVersionHeader.majorc C s | j S r )r� r r r r r� � s zMIMEVersionHeader.minorc C s | j S r )r� r r r r r� � s zMIMEVersionHeader.version)r( r2 r3 r` ra r Zparse_mime_versionr^ r[ rD rG r4 r� r� r� ro r r rn r r� � s r� c s8 e Zd ZdZedd� �Z� fdd�Zedd� �Z� Z S )�ParameterizedMIMEHeaderr9 c C sZ | � |� |d< }t|�|d< |d �|j� |jd krBi |d< ndd� |jD �|d< d S )NrO rC rB �paramsc S s& i | ] \}}t �|��� t �|��qS r )r rE �lower)r= rI rJ r r r � <dictcomp>� s � z1ParameterizedMIMEHeader.parse.<locals>.<dictcomp>)r^ r< r� r r� r� r r r rD � s �z ParameterizedMIMEHeader.parsec s |� d�| _t� j||� d S )Nr� )rh �_paramsrj rG rk rn r r rG � s z ParameterizedMIMEHeader.initc C s t | j�S r )r r� r r r r r� � s z ParameterizedMIMEHeader.params) r( r2 r3 r` r[ rD rG r4 r� ro r r rn r r� � s r� c sJ e Zd Zeej�Z� fdd�Zedd� �Z edd� �Z edd� �Z � Z S ) �ContentTypeHeaderc s2 t � j||� t�| jj�| _t�| jj�| _d S r ) rj rG r rE rM �maintype� _maintype�subtype�_subtyperk rn r r rG � s zContentTypeHeader.initc C s | j S r )r� r r r r r� � s zContentTypeHeader.maintypec C s | j S r )r� r r r r r� � s zContentTypeHeader.subtypec C s | j d | j S )N�/)r� r� r r r r � content_type� s z ContentTypeHeader.content_type) r( r2 r3 ra r Zparse_content_type_headerr^ rG r4 r� r� r� ro r r rn r r� � s r� c s2 e Zd Zeej�Z� fdd�Zedd� �Z � Z S )�ContentDispositionHeaderc s2 t � j||� | jj}|d kr"|nt�|�| _d S r )rj rG rM �content_dispositionr rE �_content_disposition)r rl rm Zcdrn r r rG � s z ContentDispositionHeader.initc C s | j S r )r� r r r r r� � s z,ContentDispositionHeader.content_disposition) r( r2 r3 ra r Z parse_content_disposition_headerr^ rG r4 r� ro r r rn r r� � s r� c sB e Zd ZdZeej�Zedd� �Z � fdd�Z e dd� �Z � Z S )� ContentTransferEncodingHeaderr9 c C s2 | � |� |d< }t|�|d< |d �|j� d S �NrO rC rB �r^ r< r� r r� r r r rD s z#ContentTransferEncodingHeader.parsec s" t � j||� t�| jj�| _d S r )rj rG r rE rM �cte�_cterk rn r r rG s z"ContentTransferEncodingHeader.initc C s | j S r )r� r r r r r� s z!ContentTransferEncodingHeader.cte)r( r2 r3 r` ra r Z&parse_content_transfer_encoding_headerr^ r[ rD rG r4 r� ro r r rn r r� � s r� c @ s& e Zd ZdZeej�Zedd� �Z dS )�MessageIDHeaderr9 c C s2 | � |� |d< }t|�|d< |d �|j� d S r� r� r� r r r rD s zMessageIDHeader.parseN) r( r2 r3 r` ra r Zparse_message_idr^ r[ rD r r r r r� s r� )Zsubject�datez resent-datez orig-dateZsenderz resent-sender�toz resent-toZccz resent-ccZbccz resent-bcc�fromz resent-fromzreply-toz mime-versionz content-typezcontent-dispositionzcontent-transfer-encodingz message-idc @ s8 e Zd ZdZeedfdd�Zdd� Zdd� Zd d � Z d S ) �HeaderRegistryz%A header_factory and header registry.Tc C s& i | _ || _|| _|r"| j �t� dS )a� Create a header_factory that works with the Policy API. base_class is the class that will be the last class in the created header class's __bases__ list. default_class is the class that will be used if "name" (see __call__) does not appear in the registry. use_default_map controls whether or not the default mapping of names to specialized classes is copied in to the registry when the factory is created. The default is True. N)�registry� base_class� default_class�update�_default_header_map)r r� r� Zuse_default_mapr r r r 9 s zHeaderRegistry.__init__c C s || j |�� < dS )zLRegister cls as the specialized class for handling "name" headers. N)r� r� �r rI rH r r r � map_to_typeK s zHeaderRegistry.map_to_typec C s, | j �|�� | j�}td|j || jfi �S )N�_)r� �getr� r� r. r( r� r� r r r � __getitem__Q s zHeaderRegistry.__getitem__c C s | | ||�S )a� Create a header instance for header 'name' from 'value'. Creates a header instance by creating a specialized class for parsing and representing the specified header by combining the factory base_class with a specialized class from the registry or the default_class, and passing the name and value to the constructed class's constructor. r )r rI rJ r r r �__call__U s zHeaderRegistry.__call__N) r( r2 r3 rZ rA r] r r� r� r� r r r r r� 5 s � r� N) rZ �typesr Zemailr r r r r r5 r< rA rP r] rc re rp rq r} r~ r r� r� r� r� r� r� r� r� r r r r �<module> sX `6d '7 % � __pycache__/_header_value_parser.cpython-38.pyc 0000644 00000234077 15204103444 0015555 0 ustar 00 U e5dϡ � @ s� d Z ddlZddlZddlZddlmZ ddlmZ ddlm Z ddlm Z ddlm Z e d�Zee d �B Ze d �ZeeB Zee d � Zee d � Zee d �B e d � ZeeB Zee d�B ZeeB Zee d� Zdd� Ze�dejej B �Z G dd� de �Z G dd� de �Z G dd� de �Z!G dd� de �Z"G dd � d e �Z#G d d � d e �Z$G d d � d e �Z%G d!d"� d"e �Z&G d#d$� d$e �Z'G d%d&� d&e �Z(G d'd(� d(e(�Z)G d)d*� d*e �Z*G d+d,� d,e �Z+G d-d.� d.e �Z,G d/d0� d0e �Z-G d1d2� d2e �Z.G d3d4� d4e �Z/G d5d6� d6e �Z0G d7d8� d8e �Z1G d9d:� d:e �Z2G d;d<� d<e �Z3G d=d>� d>e �Z4G d?d@� d@e �Z5G dAdB� dBe �Z6G dCdD� dDe �Z7G dEdF� dFe �Z8G dGdH� dHe �Z9G dIdJ� dJe �Z:G dKdL� dLe"�Z;G dMdN� dNe �Z<G dOdP� dPe �Z=G dQdR� dRe �Z>G dSdT� dTe �Z?G dUdV� dVe?�Z@G dWdX� dXe �ZAG dYdZ� dZe �ZBG d[d\� d\e �ZCG d]d^� d^e �ZDG d_d`� d`e �ZEG dadb� dbeE�ZFG dcdd� ddeE�ZGG dedf� dfe �ZHG dgdh� dhe �ZIG didj� dje �ZJG dkdl� dleJ�ZKG dmdn� dneK�ZLG dodp� dpe �ZMG dqdr� dreN�ZOG dsdt� dteO�ZPG dudv� dveO�ZQG dwdx� dxeP�ZRG dydz� dze jS�ZTeQd d{�ZUeQd|d}�ZVeQd~d�ZWe�d��Xd��Ye���jZZ[e�d��Xe�\d��Ye����j]Z^e�d��j_Z`e�d��Xe�\d��Ye����j]Zae�d��Xe�\d��Ye����j]Zbe�d��Xe�\d��Ye����j]Zcd�d�� Zdd�d�� Zed�d�� Zfd�d�� Zgd�d�� Zhd�d�� Zid�d�� Zjd�d�� Zkd�d�� Zld�d�� Zmd�d�� Znd�d�� Zod�d�� Zpd�d�� Zqd�d�� Zrd�d�� Zsd�d�� Ztd�d�� Zud�d�� Zvd�d�� Zwd�d�� Zxd�d�� Zyd�d�� Zzd�d�� Z{d�d�� Z|d�d�� Z}d�d�� Z~d�d�� Zd�d�� Z�d�d�� Z�d�d�� Z�d�dÄ Z�d�dń Z�d�dDŽ Z�d�dɄ Z�d�d˄ Z�d�d̈́ Z�d�dτ Z�d�dф Z�d�dӄ Z�d�dՄ Z�d�dׄ Z�d�dل Z�d�dۄ Z�d�d݄ Z�d�d߄ Z�d�d� Z�d�d� Z�d�d� Z�d�d� Z�d�d� Z�d�d� Z�d�d� Z�d�d� Z�d�d� Z�d�d� Z�d�d�� Z�d�d�� Z�dS )�al Header value parser implementing various email-related RFC parsing rules. The parsing methods defined in this module implement various email related parsing rules. Principal among them is RFC 5322, which is the followon to RFC 2822 and primarily a clarification of the former. It also implements RFC 2047 encoded word decoding. RFC 5322 goes to considerable trouble to maintain backward compatibility with RFC 822 in the parse phase, while cleaning up the structure on the generation phase. This parser supports correct RFC 5322 generation by tagging white space as folding white space only when folding is allowed in the non-obsolete rule sets. Actually, the parser is even more generous when accepting input than RFC 5322 mandates, following the spirit of Postel's Law, which RFC 5322 encourages. Where possible deviations from the standard are annotated on the 'defects' attribute of tokens that deviate. The general structure of the parser follows RFC 5322, and uses its terminology where there is a direct correspondence. Where the implementation requires a somewhat different structure than that used by the formal grammar, new terms that mimic the closest existing terms are used. Thus, it really helps to have a copy of RFC 5322 handy when studying this code. Input to the parser is a string that has already been unfolded according to RFC 5322 rules. According to the RFC this unfolding is the very first step, and this parser leaves the unfolding step to a higher level message parser, which will have already detected the line breaks that need unfolding while determining the beginning and end of each header. The output of the parser is a TokenList object, which is a list subclass. A TokenList is a recursive data structure. The terminal nodes of the structure are Terminal objects, which are subclasses of str. These do not correspond directly to terminal objects in the formal grammar, but are instead more practical higher level combinations of true terminals. All TokenList and Terminal objects have a 'value' attribute, which produces the semantically meaningful value of that part of the parse subtree. The value of all whitespace tokens (no matter how many sub-tokens they may contain) is a single space, as per the RFC rules. This includes 'CFWS', which is herein included in the general class of whitespace tokens. There is one exception to the rule that whitespace tokens are collapsed into single spaces in values: in the value of a 'bare-quoted-string' (a quoted-string with no leading or trailing whitespace), any whitespace that appeared between the quotation marks is preserved in the returned value. Note that in all Terminal strings quoted pairs are turned into their unquoted values. All TokenList and Terminal objects also have a string value, which attempts to be a "canonical" representation of the RFC-compliant form of the substring that produced the parsed subtree, including minimal use of quoted pair quoting. Whitespace runs are not collapsed. Comment tokens also have a 'content' attribute providing the string found between the parens (including any nested comments) with whitespace preserved. All TokenList and Terminal objects have a 'defects' attribute which is a possibly empty list all of the defects found while creating the token. Defects may appear on any token in the tree, and a composite list of all defects in the subtree is available through the 'all_defects' attribute of any node. (For Terminal notes x.defects == x.all_defects.) Each object in a parse tree is called a 'token', and each has a 'token_type' attribute that gives the name from the RFC 5322 grammar that it represents. Not all RFC 5322 nodes are produced, and there is one non-RFC 5322 node that may be produced: 'ptext'. A 'ptext' is a string of printable ascii characters. It is returned in place of lists of (ctext/quoted-pair) and (qtext/quoted-pair). XXX: provide complete list of token types. � N)� hexdigits)� itemgetter)�_encoded_words)�errors)�utilsz �(z ()<>@,:;.\"[]�.z."(z/?=z*'%�%c C s dt | ��dd��dd� d S )N�"�\�\\z\")�str�replace��value� r �2/usr/lib64/python3.8/email/_header_value_parser.py� quote_string` s r z� =\? # literal =? [^?]* # charset \? # literal ? [qQbB] # literal 'q' or 'b', case insensitive \? # literal ? .*? # encoded word \?= # literal ?= c s� e Zd ZdZdZdZ� fdd�Zdd� Z� fdd�Ze d d � �Z e d d � �Z d d� Z e dd� �Z e dd� �Zdd� Zd dd�Zd dd�Zd dd�Z� ZS ) � TokenListNTc s t � j||� g | _d S �N)�super�__init__�defects)�self�args�kw�� __class__r r r y s zTokenList.__init__c C s d� dd� | D ��S )N� c s s | ]}t |�V qd S r �r ��.0�xr r r � <genexpr>~ s z$TokenList.__str__.<locals>.<genexpr>��join�r r r r �__str__} s zTokenList.__str__c s d� | jjt� �� �S �Nz{}({})��formatr �__name__r �__repr__r& r r r r, � s �zTokenList.__repr__c C s d� dd� | D ��S )Nr c s s | ]}|j r|j V qd S r r r r r r r# � s z"TokenList.value.<locals>.<genexpr>r$ r& r r r r � s zTokenList.valuec C s t dd� | D �| j�S )Nc s s | ] }|j V qd S r )� all_defectsr r r r r# � s z(TokenList.all_defects.<locals>.<genexpr>)�sumr r& r r r r- � s zTokenList.all_defectsc C s | d � � S �Nr )�startswith_fwsr& r r r r0 � s zTokenList.startswith_fwsc C s t dd� | D ��S )zATrue if all top level tokens of this part may be RFC2047 encoded.c s s | ] }|j V qd S r )� as_ew_allowed)r! �partr r r r# � s z*TokenList.as_ew_allowed.<locals>.<genexpr>)�allr& r r r r1 � s zTokenList.as_ew_allowedc C s g }| D ]}|� |j� q|S r )�extend�comments)r r5 �tokenr r r r5 � s zTokenList.commentsc C s t | |d�S )N��policy)�_refold_parse_tree�r r8 r r r �fold� s zTokenList.foldr c C s t | j|d�� d S )N��indent)�print�ppstr�r r= r r r �pprint� s zTokenList.pprintc C s d� | j|d��S )N� r< )r% �_ppr@ r r r r? � s zTokenList.ppstrc c sz d� || jj| j�V | D ]4}t|d�s:|d� |� V q|�|d �E d H q| jrdd� | j�}nd}d� ||�V d S )Nz{}{}/{}(rC z* !! invalid element in token list: {!r}z z Defects: {}r z{}){})r* r r+ � token_type�hasattrrC r )r r= r6 Zextrar r r rC � s � � z TokenList._pp)r )r )r )r+ � __module__� __qualname__rD �syntactic_break�ew_combine_allowedr r' r, �propertyr r- r0 r1 r5 r; rA r? rC � __classcell__r r r r r s s& r c @ s$ e Zd Zedd� �Zedd� �ZdS )�WhiteSpaceTokenListc C s dS �N� r r& r r r r � s zWhiteSpaceTokenList.valuec C s dd� | D �S )Nc S s g | ]}|j d kr|j�qS )�comment)rD �contentr r r r � <listcomp>� s z0WhiteSpaceTokenList.comments.<locals>.<listcomp>r r& r r r r5 � s z WhiteSpaceTokenList.commentsN)r+ rF rG rJ r r5 r r r r rL � s rL c @ s e Zd ZdZdS )�UnstructuredTokenList� unstructuredN�r+ rF rG rD r r r r rR � s rR c @ s e Zd ZdZdS )�Phrase�phraseNrT r r r r rU � s rU c @ s e Zd ZdZdS )�WordZwordNrT r r r r rW � s rW c @ s e Zd ZdZdS )�CFWSList�cfwsNrT r r r r rX � s rX c @ s e Zd ZdZdS )�Atom�atomNrT r r r r rZ � s rZ c @ s e Zd ZdZdZdS )�Tokenr6 FN)r+ rF rG rD Z encode_as_ewr r r r r\ � s r\ c @ s e Zd ZdZdZdZdZdS )� EncodedWord� encoded-wordN)r+ rF rG rD �cte�charset�langr r r r r] � s r] c @ s4 e Zd ZdZedd� �Zedd� �Zedd� �ZdS ) � QuotedString� quoted-stringc C s" | D ]}|j dkr|j S qd S �N�bare-quoted-string�rD r �r r" r r r rP � s zQuotedString.contentc C s> g }| D ]*}|j dkr&|�t|�� q|�|j� qd�|�S )Nre r )rD �appendr r r% )r �resr" r r r � quoted_value� s zQuotedString.quoted_valuec C s" | D ]}|j dkr|j S qd S rd rf �r r6 r r r �stripped_value� s zQuotedString.stripped_valueN)r+ rF rG rD rJ rP rj rl r r r r rb � s rb c @ s$ e Zd ZdZdd� Zedd� �ZdS )�BareQuotedStringre c C s t d�dd� | D ���S )Nr c s s | ]}t |�V qd S r r r r r r r# s z+BareQuotedString.__str__.<locals>.<genexpr>)r r% r& r r r r' � s zBareQuotedString.__str__c C s d� dd� | D ��S )Nr c s s | ]}t |�V qd S r r r r r r r# s z)BareQuotedString.value.<locals>.<genexpr>r$ r& r r r r s zBareQuotedString.valueN)r+ rF rG rD r' rJ r r r r r rm � s rm c @ s8 e Zd ZdZdd� Zdd� Zedd� �Zedd � �Zd S ) �CommentrO c s( d� tdg� fdd�� D �dggg ��S )Nr r c s g | ]}� � |��qS r )�quoter r& r r rQ s z#Comment.__str__.<locals>.<listcomp>�))r% r. r& r r& r r' s ��zComment.__str__c C s2 |j dkrt|�S t|��dd��dd��dd�S )NrO r r r z\(rp z\))rD r r )r r r r r ro s � �z Comment.quotec C s d� dd� | D ��S )Nr c s s | ]}t |�V qd S r r r r r r r# s z"Comment.content.<locals>.<genexpr>r$ r& r r r rP s zComment.contentc C s | j gS r )rP r& r r r r5 s zComment.commentsN) r+ rF rG rD r' ro rJ rP r5 r r r r rn s rn c @ s4 e Zd ZdZedd� �Zedd� �Zedd� �ZdS ) � AddressListz address-listc C s dd� | D �S )Nc S s g | ]}|j d kr|�qS )�address�rD r r r r rQ ' s z)AddressList.addresses.<locals>.<listcomp>r r& r r r � addresses% s zAddressList.addressesc C s t dd� | D �g �S )Nc s s | ]}|j d kr|jV qdS �rr N�rD � mailboxesr r r r r# + s �z(AddressList.mailboxes.<locals>.<genexpr>�r. r& r r r rw ) s ��zAddressList.mailboxesc C s t dd� | D �g �S )Nc s s | ]}|j d kr|jV qdS ru �rD � all_mailboxesr r r r r# 0 s �z,AddressList.all_mailboxes.<locals>.<genexpr>rx r& r r r rz . s ��zAddressList.all_mailboxesN)r+ rF rG rD rJ rt rw rz r r r r rq ! s rq c @ s4 e Zd ZdZedd� �Zedd� �Zedd� �ZdS ) �Addressrr c C s | d j dkr| d jS d S )Nr �group�rD � display_namer& r r r r~ 8 s zAddress.display_namec C s4 | d j dkr| d gS | d j dkr*g S | d jS �Nr �mailbox�invalid-mailboxrv r& r r r rw = s zAddress.mailboxesc C s: | d j dkr| d gS | d j dkr0| d gS | d jS r ry r& r r r rz E s zAddress.all_mailboxesN)r+ rF rG rD rJ r~ rw rz r r r r r{ 4 s r{ c @ s( e Zd ZdZedd� �Zedd� �ZdS )� MailboxList� mailbox-listc C s dd� | D �S )Nc S s g | ]}|j d kr|�qS )r� rs r r r r rQ S s z)MailboxList.mailboxes.<locals>.<listcomp>r r& r r r rw Q s zMailboxList.mailboxesc C s dd� | D �S )Nc S s g | ]}|j d kr|�qS ))r� r� rs r r r r rQ W s �z-MailboxList.all_mailboxes.<locals>.<listcomp>r r& r r r rz U s zMailboxList.all_mailboxesN�r+ rF rG rD rJ rw rz r r r r r� M s r� c @ s( e Zd ZdZedd� �Zedd� �ZdS )� GroupList� group-listc C s | r| d j dkrg S | d jS �Nr r� rv r& r r r rw _ s zGroupList.mailboxesc C s | r| d j dkrg S | d jS r� ry r& r r r rz e s zGroupList.all_mailboxesNr� r r r r r� [ s r� c @ s4 e Zd ZdZedd� �Zedd� �Zedd� �ZdS ) �Groupr| c C s | d j dkrg S | d jS �N� r� rv r& r r r rw p s zGroup.mailboxesc C s | d j dkrg S | d jS r� ry r& r r r rz v s zGroup.all_mailboxesc C s | d j S r/ )r~ r& r r r r~ | s zGroup.display_nameN)r+ rF rG rD rJ rw rz r~ r r r r r� l s r� c @ sL e Zd ZdZedd� �Zedd� �Zedd� �Zedd � �Zed d � �Z d S ) �NameAddr� name-addrc C s t | �dkrd S | d jS �N� r )�lenr~ r& r r r r~ � s zNameAddr.display_namec C s | d j S �N����� local_partr& r r r r� � s zNameAddr.local_partc C s | d j S r� ��domainr& r r r r� � s zNameAddr.domainc C s | d j S r� )�router& r r r r� � s zNameAddr.routec C s | d j S r� �� addr_specr& r r r r� � s zNameAddr.addr_specN� r+ rF rG rD rJ r~ r� r� r� r� r r r r r� � s r� c @ s@ e Zd ZdZedd� �Zedd� �Zedd� �Zedd � �Zd S ) � AngleAddrz angle-addrc C s" | D ]}|j dkr|j S qd S �N� addr-spec)rD r� rg r r r r� � s zAngleAddr.local_partc C s" | D ]}|j dkr|j S qd S r� �rD r� rg r r r r� � s zAngleAddr.domainc C s" | D ]}|j dkr|j S qd S )N� obs-route)rD �domainsrg r r r r� � s zAngleAddr.routec C s< | D ]2}|j dkr|jr"|j S t|j�|j S qdS )Nr� z<>)rD r� r� r rg r r r r� � s zAngleAddr.addr_specN) r+ rF rG rD rJ r� r� r� r� r r r r r� � s r� c @ s e Zd ZdZedd� �ZdS )�ObsRouter� c C s dd� | D �S )Nc S s g | ]}|j d kr|j�qS r� r� r r r r rQ � s z$ObsRoute.domains.<locals>.<listcomp>r r& r r r r� � s zObsRoute.domainsN)r+ rF rG rD rJ r� r r r r r� � s r� c @ sL e Zd ZdZedd� �Zedd� �Zedd� �Zedd � �Zed d � �Z d S ) �Mailboxr� c C s | d j dkr| d jS d S �Nr r� r} r& r r r r~ � s zMailbox.display_namec C s | d j S r/ r� r& r r r r� � s zMailbox.local_partc C s | d j S r/ r� r& r r r r� � s zMailbox.domainc C s | d j dkr| d jS d S r� )rD r� r& r r r r� � s z Mailbox.routec C s | d j S r/ r� r& r r r r� � s zMailbox.addr_specNr� r r r r r� � s r� c @ s, e Zd ZdZedd� �Ze Z Z ZZ dS )�InvalidMailboxr� c C s d S r r r& r r r r~ � s zInvalidMailbox.display_nameNr� r r r r r� � s r� c s( e Zd ZdZdZe� fdd��Z� ZS )�Domainr� Fc s d� t� j�� �S �Nr �r% r r �splitr& r r r r� � s z Domain.domain)r+ rF rG rD r1 rJ r� rK r r r r r� � s r� c @ s e Zd ZdZdS )�DotAtom�dot-atomNrT r r r r r� � s r� c @ s e Zd ZdZdZdS )� DotAtomTextz dot-atom-textTN�r+ rF rG rD r1 r r r r r� � s r� c @ s e Zd ZdZdZdS )� NoFoldLiteralzno-fold-literalFNr� r r r r r� s r� c @ sD e Zd ZdZdZedd� �Zedd� �Zedd� �Zed d � �Z d S ) �AddrSpecr� Fc C s | d j S r/ r� r& r r r r� s zAddrSpec.local_partc C s t | �dk rd S | d jS )N� r� )r� r� r& r r r r� s zAddrSpec.domainc C s< t | �dk r| d jS | d j�� | d j | d j�� S )Nr� r r� r� )r� r �rstrip�lstripr& r r r r s zAddrSpec.valuec C sL t | j�}t|�t|t �kr*t| j�}n| j}| jd k rH|d | j S |S )N�@)�setr� r� � DOT_ATOM_ENDSr r� )r ZnamesetZlpr r r r� s zAddrSpec.addr_specN) r+ rF rG rD r1 rJ r� r� r r� r r r r r� s r� c @ s e Zd ZdZdZdS )� ObsLocalPartzobs-local-partFNr� r r r r r� & s r� c s4 e Zd ZdZdZedd� �Ze� fdd��Z� ZS )� DisplayNamez display-nameFc C s� t | �}t|�dkr|jS |d jdkr4|�d� n*|d d jdkr^t |d dd � �|d< |d jdkrv|�� n*|d d jdkr�t |d d d� �|d< |jS )Nr rY r� r� )r r� r rD �pop)r ri r r r r~ 1 s zDisplayName.display_namec s� d}| j rd}n| D ]}|jdkrd}qt| �dkr�|r�d }}| d jdks`| d d jdkrdd}| d jdks�| d d jdkr�d}|t| j� | S t� jS d S ) NFTrc r r rY rN r� )r rD r� r r~ r r )r ro r" ZpreZpostr r r r B s zDisplayName.value) r+ rF rG rD rI rJ r~ r rK r r r r r� , s r� c @ s, e Zd ZdZdZedd� �Zedd� �ZdS )� LocalPartz local-partFc C s& | d j dkr| d jS | d jS d S )Nr rc )rD rj r r& r r r r [ s zLocalPart.valuec C s� t g}t }d}| d t g D ]�}|jdkr,q |r\|jdkr\|d jdkr\t|d d� �|d< t|t�}|r�|jdkr�|d jdkr�|�t|dd � �� n |�|� |d }|}q t|dd� �}|jS )NFr rY �dotr� r� )�DOTrD r � isinstancerh r )r ri ZlastZ last_is_tl�tokZis_tlr r r r� b s( � � zLocalPart.local_partN)r+ rF rG rD r1 rJ r r� r r r r r� V s r� c s4 e Zd ZdZdZe� fdd��Zedd� �Z� ZS )� DomainLiteralzdomain-literalFc s d� t� j�� �S r� r� r& r r r r� s zDomainLiteral.domainc C s" | D ]}|j dkr|j S qd S )N�ptextrf rg r r r �ip� s zDomainLiteral.ip) r+ rF rG rD r1 rJ r� r� rK r r r r r� z s r� c @ s e Zd ZdZdZdZdS )� MIMEVersionz mime-versionN)r+ rF rG rD �major�minorr r r r r� � s r� c @ s4 e Zd ZdZdZdZdZedd� �Zedd� �Z dS ) � Parameter� parameterF�us-asciic C s | j r| d jS dS r� )� sectioned�numberr& r r r �section_number� s zParameter.section_numberc C sf | D ]\}|j dkr |j S |j dkr|D ]4}|j dkr*|D ] }|j dkr<|j S q<q*qdS )Nr rc re r )rD rl rk r r r � param_value� s zParameter.param_valueN) r+ rF rG rD r� �extendedr` rJ r� r� r r r r r� � s r� c @ s e Zd ZdZdS )�InvalidParameter�invalid-parameterNrT r r r r r� � s r� c @ s e Zd ZdZedd� �ZdS )� Attribute� attributec C s$ | D ]}|j �d�r|j S qd S )N�attrtext)rD �endswithr rk r r r rl � s zAttribute.stripped_valueN�r+ rF rG rD rJ rl r r r r r� � s r� c @ s e Zd ZdZdZdS )�Section�sectionN)r+ rF rG rD r� r r r r r� � s r� c @ s e Zd ZdZedd� �ZdS )�Valuer c C s2 | d }|j dkr| d }|j �d�r,|jS | jS )Nr rY r� )rc r� zextended-attribute)rD r� rl r rk r r r rl � s �zValue.stripped_valueNr� r r r r r� � s r� c @ s( e Zd ZdZdZedd� �Zdd� ZdS )�MimeParameters�mime-parametersFc c s� i }| D ]T}|j �d�sq|d j dkr*q|d j�� }||krHg ||< || �|j|f� q|�� D �]~\}}t|td�d�}|d d }|j }|j s�t |�dkr�|d d dkr�|d d j �t �d�� |d d� }g }d}|D ]�\} } | |k�r(| j �s| j �t �d�� q�n| j �t �d�� |d7 }| j} | j �r�ztj�| �} W n& tk �rt tjj| d d �} Y nRX z| �|d �} W n" tk �r� | �d d �} Y nX t�| ��r�| j �t �� � |�| � q�d �|�} || fV qfd S )Nr� r r� )�keyr� z.duplicate parameter name; duplicate(s) ignoredz+duplicate parameter name; duplicate ignoredz(inconsistent RFC2231 parameter numberingzlatin-1)�encoding�surrogateescaper� r )rD r� r �striprh r� �items�sortedr r` r� r� r r �InvalidHeaderDefectr� �urllib�parseZunquote_to_bytes�UnicodeEncodeErrorZunquote�decode� LookupErrorr �_has_surrogates�UndecodableBytesDefectr% ) r �paramsr6 �name�partsZ first_paramr` Z value_parts�ir� �paramr r r r r� � s` � � � zMimeParameters.paramsc C sT g }| j D ].\}}|r.|�d�|t|��� q |�|� q d�|�}|rPd| S dS )N�{}={}z; rN r )r� rh r* r r% )r r� r� r r r r r' s zMimeParameters.__str__N)r+ rF rG rD rH rJ r� r' r r r r r� � s Er� c @ s e Zd ZdZedd� �ZdS )�ParameterizedHeaderValueFc C s& t | �D ]}|jdkr|j S qi S )Nr� )�reversedrD r� rk r r r r� - s z ParameterizedHeaderValue.paramsN)r+ rF rG rH rJ r� r r r r r� ' s r� c @ s e Zd ZdZdZdZdZdS )� ContentTypez content-typeF�textZplainN)r+ rF rG rD r1 �maintype�subtyper r r r r� 5 s r� c @ s e Zd ZdZdZdZdS )�ContentDispositionzcontent-dispositionFN)r+ rF rG rD r1 �content_dispositionr r r r r� < s r� c @ s e Zd ZdZdZdZdS )�ContentTransferEncodingzcontent-transfer-encodingFZ7bitN)r+ rF rG rD r1 r_ r r r r r� B s r� c @ s e Zd ZdZdZdS )� HeaderLabelz header-labelFNr� r r r r r� H s r� c @ s e Zd ZdZdZdd� ZdS )�MsgIDzmsg-idFc C s t | �|j S r )r �linesepr: r r r r; Q s z MsgID.foldN)r+ rF rG rD r1 r; r r r r r� M s r� c @ s e Zd ZdZdS )� MessageIDz message-idNrT r r r r r� V s r� c @ s e Zd ZdZdS )�InvalidMessageIDzinvalid-message-idNrT r r r r r� Z s r� c @ s e Zd ZdZdS )�Header�headerNrT r r r r r� ^ s r� c sr e Zd ZdZdZdZ� fdd�Z� fdd�Zdd� Ze dd � �Z d� fd d � Z d d� Z e dd� �Z dd� Z� ZS )�TerminalTc s t � �| |�}||_g |_|S r )r �__new__rD r )�clsr rD r r r r r� l s zTerminal.__new__c s d� | jjt� �� �S r( r) r& r r r r, r s zTerminal.__repr__c C s t | jjd | j � d S )N�/)r> r r+ rD r& r r r rA u s zTerminal.pprintc C s t | j�S r )�listr r& r r r r- x s zTerminal.all_defectsr c s2 d� || jj| jt� �� | js"dn d� | j��gS )Nz {}{}/{}({}){}r z {})r* r r+ rD r r, r r@ r r r rC | s �z Terminal._ppc C s d S r r r& r r r �pop_trailing_ws� s zTerminal.pop_trailing_wsc C s g S r r r& r r r r5 � s zTerminal.commentsc C s t | �| jfS r )r rD r& r r r �__getnewargs__� s zTerminal.__getnewargs__)r )r+ rF rG r1 rI rH r� r, rA rJ r- rC r� r5 r rK r r r r r� f s r� c @ s e Zd Zedd� �Zdd� ZdS )�WhiteSpaceTerminalc C s dS rM r r& r r r r � s zWhiteSpaceTerminal.valuec C s dS )NTr r& r r r r0 � s z!WhiteSpaceTerminal.startswith_fwsN�r+ rF rG rJ r r0 r r r r r � s r c @ s e Zd Zedd� �Zdd� ZdS )� ValueTerminalc C s | S r r r& r r r r � s zValueTerminal.valuec C s dS )NFr r& r r r r0 � s z ValueTerminal.startswith_fwsNr r r r r r � s r c @ s e Zd Zedd� �Zdd� ZdS )�EWWhiteSpaceTerminalc C s dS r� r r& r r r r � s zEWWhiteSpaceTerminal.valuec C s dS r� r r& r r r r' � s z EWWhiteSpaceTerminal.__str__N)r+ rF rG rJ r r' r r r r r � s r c @ s e Zd ZdZdS )�_InvalidEwErrorz1Invalid encoded word found while parsing headers.N)r+ rF rG �__doc__r r r r r � s r r� �,�list-separatorr� zroute-component-markerz([{}]+)r z[^{}]+z[\x00-\x20\x7F]c C s> t | �}|r | j�t�|�� t�| �r:| j�t�d�� dS )z@If input token contains ASCII non-printables, register a defect.z*Non-ASCII characters found in header tokenN)�_non_printable_finderr rh r ZNonPrintableDefectr r� r� )�xtextZnon_printablesr r r �_validate_xtext� s �r c C s� t | d�^}}g }d}d}tt|��D ]L}|| dkrJ|rDd}d}nd}q&|rTd}n|| |krd q||�|| � q&|d }d�|�d�||d� g| �|fS )ak Scan printables/quoted-pairs until endchars and return unquoted ptext. This function turns a run of qcontent, ccontent-without-comments, or dtext-with-quoted-printables into a single string by unquoting any quoted printables. It returns the string, the remaining value, and a flag that is True iff there were any quoted printables decoded. r� Fr Tr N)� _wsp_splitter�ranger� rh r% )r �endcharsZfragment� remainderZvchars�escape�had_qp�posr r r �_get_ptext_to_endchars� s$ r c C s. | � � }t| dt| �t|� � d�}||fS )z�FWS = 1*WSP This isn't the RFC definition. We're using fws to represent tokens where folding can be done, but when we are parsing the *un*folding has already been done so we don't need to watch out for CRLF. N�fws)r� r r� )r Znewvaluer r r r �get_fws s r c C s� t � }| �d�s t�d�| ���| dd� �dd�^}}|| dd� krXt�d�| ���d�|�}t|�dkr�|d tkr�|d tkr�|� d �dk r�|�dd�^}}|d | }t|�� �dkr�|j � t� d �� | |_ d�|�} z t�d| d �\}}}} W n* ttfk �r* td �|j ���Y nX ||_||_|j �| � |�r�|d tk�rrt|�\} }|� | � �qDt|d�^} }t| d �} t| � |� | � d�|�}�qD| �r�| d tk�r�|j � t� d �� || fS )zE encoded-word = "=?" charset "?" encoding "?" encoded-text "?=" �=?z"expected encoded word but found {}r� Nz?=r� r r �?z whitespace inside encoded wordz!encoded word format invalid: '{}'�vtextz.missing trailing whitespace after encoded-word)r] � startswithr �HeaderParseErrorr* r� r% r� r �countr rh r� r_ �_ewr� � ValueError�KeyErrorr r` ra r4 �WSPr r r r ) r Zewr� r Zremstr�restr� r` ra r r6 �charsr r r r �get_encoded_word sd �� � � � � � �r" c C sF t � }| �rB| d tkr0t| �\}} |�|� qd}| �d�r�zt| �\}} W n, tk rf d}Y n� tjk rz Y nrX d}t |�dkr�|d j dkr�|j �t� d�� d}|r�t |�dkr�|d j d kr�t |d d�|d< |�|� qt| d�^}}|�rt�|��r| �d�^}}t|d �}t|� |�|� d �|�} q|S ) aO unstructured = (*([FWS] vchar) *WSP) / obs-unstruct obs-unstruct = *((*LF *CR *(obs-utext) *LF *CR)) / FWS) obs-utext = %d0 / obs-NO-WS-CTL / LF / CR obs-NO-WS-CTL is control characters except WSP/CR/LF. So, basically, we have printable runs, plus control characters or nulls in the obsolete syntax, separated by whitespace. Since RFC 2047 uses the obsolete syntax in its specification, but requires whitespace on either side of the encoded words, I can see no reason to need to separate the non-printable-non-whitespace from the printable runs if they occur, so we parse this into xtext tokens separated by WSP tokens. Because an 'unstructured' value must by definition constitute the entire value, this 'get' routine does not return a remaining value, only the parsed TokenList. r Tr Fr� r z&missing whitespace before encoded wordr� ���r^ r r )rR r r rh r r" r r r r� rD r r� r r �rfc2047_matcher�search� partitionr r r% )r rS r6 �valid_ewZhave_wsr� r r r r r �get_unstructured? sJ � � r( c C s* t | d�\}} }t|d�}t|� || fS )a ctext = <printable ascii except \ ( )> This is not the RFC ctext, since we are handling nested comments in comment and unquoting quoted-pairs here. We allow anything except the '()' characters, but if we find any ASCII other than the RFC defined printable ASCII, a NonPrintableDefect is added to the token's defects list. Since quoted pairs are converted to their unquoted values, what is returned is a 'ptext' token. In this case it is a WhiteSpaceTerminal, so it's value is ' '. z()r� )r r r �r r� �_r r r � get_qp_ctext� s r+ c C s* t | d�\}} }t|d�}t|� || fS )ao qcontent = qtext / quoted-pair We allow anything except the DQUOTE character, but if we find any ASCII other than the RFC defined printable ASCII, a NonPrintableDefect is added to the token's defects list. Any quoted pairs are converted to their unquoted values, so what is returned is a 'ptext' token. In this case it is a ValueTerminal. r r� )r r r r) r r r � get_qcontent� s r, c C sN t | �}|s t�d�| ���|�� }| t|�d� } t|d�}t|� || fS )z�atext = <matches _atext_matcher> We allow any non-ATOM_ENDS in atext, but add an InvalidATextDefect to the token's defects list if we find non-atext characters. z expected atext but found '{}'N�atext)�_non_atom_end_matcherr r r* r| r� r r )r �mr- r r r � get_atext� s � r0 c C sr | d dkr t �d�| ���t� }| dd� } | rT| d dkrTt| �\}} |�|� | �rB| d dk�rB| d tkr�t| �\}} n�| dd� dk�r*d}z&t| �\}} |j �t � d �� d }W n" t jk r� t| �\}} Y nX |�r6t |�dk�r6|d j d k�r6|d j dk�r6t |d d �|d < n t| �\}} |�|� qT| �sb|j �t � d�� || fS || dd� fS )z�bare-quoted-string = DQUOTE *([FWS] qcontent) [FWS] DQUOTE A quoted-string without the leading or trailing white space. Its value is the text between the quote marks, with whitespace preserved and quoted pairs decoded. r r zexpected '"' but found '{}'r� Nr� r Fz!encoded word inside quoted stringTr� r r# r^ z"end of header inside quoted string)r r r* rm r, rh r r r" r r� r� rD r )r Zbare_quoted_stringr6 r' r r r �get_bare_quoted_string� sL � � � � �r1 c C s� | r | d dkr t �d�| ���t� }| dd� } | r�| d dkr�| d tkr\t| �\}} n&| d dkrvt| �\}} n t| �\}} |�|� q2| s�|j �t � d�� || fS || dd� fS )z�comment = "(" *([FWS] ccontent) [FWS] ")" ccontent = ctext / quoted-pair / comment We handle nested comments here, and quoted-pair in our qp-ctext routine. r r zexpected '(' but found '{}'r� Nrp z end of header inside comment) r r r* rn r r � get_commentr+ rh r r� )r rO r6 r r r r2 � s& � �r2 c C sP t � }| rH| d tkrH| d tkr0t| �\}} n t| �\}} |�|� q|| fS )z,CFWS = (1*([FWS] comment) [FWS]) / FWS r )rX � CFWS_LEADERr r r2 rh )r rY r6 r r r �get_cfws� s r4 c C sp t � }| r,| d tkr,t| �\}} |�|� t| �\}} |�|� | rh| d tkrht| �\}} |�|� || fS )z�quoted-string = [CFWS] <bare-quoted-string> [CFWS] 'bare-quoted-string' is an intermediate class defined by this parser and not by the RFC grammar. It is the quoted string without any attached CFWS. r )rb r3 r4 rh r1 )r Z quoted_stringr6 r r r �get_quoted_string s r5 c C s� t � }| r,| d tkr,t| �\}} |�|� | rL| d tkrLt�d�| ���| �d�r�zt | �\}} W q� tjk r� t | �\}} Y q�X n t | �\}} |�|� | r�| d tkr�t| �\}} |�|� || fS )zPatom = [CFWS] 1*atext [CFWS] An atom could be an rfc2047 encoded word. r z expected atom but found '{}'r ) rZ r3 r4 rh � ATOM_ENDSr r r* r r" r0 )r r[ r6 r r r �get_atom s& � r7 c C s� t � }| r| d tkr&t�d�| ���| rt| d tkrtt| �\}} |�|� | r&| d dkr&|�t� | dd� } q&|d tkr�t�d�d| ���|| fS )z( dot-text = 1*atext *("." 1*atext) r z8expected atom at a start of dot-atom-text but found '{}'r r� Nr� z4expected atom at end of dot-atom-text but found '{}')r� r6 r r r* r0 rh r� )r Z dot_atom_textr6 r r r �get_dot_atom_text0 s � �r8 c C s� t � }| d tkr(t| �\}} |�|� | �d�rhzt| �\}} W qt tjk rd t| �\}} Y qtX n t| �\}} |�|� | r�| d tkr�t| �\}} |�|� || fS )z� dot-atom = [CFWS] dot-atom-text [CFWS] Any place we can have a dot atom, we could instead have an rfc2047 encoded word. r r ) r� r3 r4 rh r r" r r r8 )r Zdot_atomr6 r r r � get_dot_atomC s r9 c C s� | d t krt| �\}} nd}| s,t�d��| d dkrFt| �\}} n*| d tkrdt�d�| ���n t| �\}} |dk r�|g|dd�< || fS )a� word = atom / quoted-string Either atom or quoted-string may start with CFWS. We have to peel off this CFWS first to determine which type of word to parse. Afterward we splice the leading CFWS, if any, into the parsed sub-token. If neither an atom or a quoted-string is found before the next special, a HeaderParseError is raised. The token returned is either an Atom or a QuotedString, as appropriate. This means the 'word' level of the formal grammar is not represented in the parse tree; this is because having that extra layer when manipulating the parse tree is more confusing than it is helpful. r Nz5Expected 'atom' or 'quoted-string' but found nothing.r z1Expected 'atom' or 'quoted-string' but found '{}')r3 r4 r r r5 �SPECIALSr* r7 )r �leaderr6 r r r �get_word\ s" � � r< c C s� t � }zt| �\}} |�|� W n( tjk rH |j�t�d�� Y nX | r�| d tkr�| d dkr�|�t� |j�t� d�� | dd� } qJzt| �\}} W nD tjk r� | d t kr�t | �\}} |j�t� d�� n� Y nX |�|� qJ|| fS )a� phrase = 1*word / obs-phrase obs-phrase = word *(word / "." / CFWS) This means a phrase can be a sequence of words, periods, and CFWS in any order as long as it starts with at least one word. If anything other than words is detected, an ObsoleteHeaderDefect is added to the token's defect list. We also accept a phrase that starts with CFWS followed by a dot; this is registered as an InvalidHeaderDefect, since it is not supported by even the obsolete grammar. z phrase does not start with wordr r zperiod in 'phrase'r� Nzcomment found without atom) rU r< rh r r r r� � PHRASE_ENDSr� �ObsoleteHeaderDefectr3 r4 )r rV r6 r r r � get_phrase~ s4 � � � r? c C sv t � }d}| d tkr"t| �\}} | s6t�d�| ���zt| �\}} W n^ tjk r� zt| �\}} W n6 tjk r� | d dkr�| d tkr�� t � }Y nX Y nX |dk r�|g|dd�< |� |� | �r4| d dks�| d tk�r4t t |�| �\}} |j dk�r|j� t�d�� n|j� t�d�� ||d< z|j�d� W n( tk �rl |j� t�d �� Y nX || fS ) z= local-part = dot-atom / quoted-string / obs-local-part Nr z"expected local-part but found '{}'r �invalid-obs-local-partz<local-part is not dot-atom, quoted-string, or obs-local-partz,local-part is not a dot-atom (contains CFWS)�asciiz)local-part contains non-ASCII characters))r� r3 r4 r r r* r9 r< r= r rh �get_obs_local_partr rD r r� r> r �encoder� ZNonASCIILocalPartDefect)r r� r; r6 �obs_local_partr r r �get_local_part� sJ � � � � rE c C s� t � }d}| �r(| d dks*| d tk�r(| d dkrj|rL|j�t�d�� |�t� d}| dd� } q nD| d dkr�|�t| d d �� | dd� } |j�t�d �� d}q |r�|d jd kr�|j�t�d �� zt | �\}} d}W n4 tj k �r | d t k�r � t | �\}} Y nX |�|� q |d jd k�sX|d jdk�rj|d jd k�rj|j�t�d�� |d jd k�s�|d jdk�r�|d jd k�r�|j�t�d�� |j�r�d|_|| fS )z' obs-local-part = word *("." word) Fr r r zinvalid repeated '.'Tr� N�misplaced-specialz/'\' character outside of quoted-string/ccontentr� r� zmissing '.' between wordsrY z!Invalid leading '.' in local partr# z"Invalid trailing '.' in local partr@ ) r� r= r rh r r� r� r rD r< r r3 r4 )r rD Zlast_non_ws_was_dotr6 r r r rB � sj � � � � � � � � � �rB c C s@ t | d�\}} }t|d�}|r0|j�t�d�� t|� || fS )a dtext = <printable ascii except \ [ ]> / obs-dtext obs-dtext = obs-NO-WS-CTL / quoted-pair We allow anything except the excluded characters, but if we find any ASCII other than the RFC defined printable ASCII, a NonPrintableDefect is added to the token's defects list. Quoted pairs are converted to their unquoted values, so what is returned is a ptext token, in this case a ValueTerminal. If there were quoted-printables, an ObsoleteHeaderDefect is added to the returned token's defect list. z[]r� z(quoted printable found in domain-literal)r r r rh r r> r )r r� r r r r � get_dtext� s �rG c C s, | rdS |� t�d�� |� tdd�� dS )NFz"end of input inside domain-literal�]�domain-literal-endT)rh r r� r )r �domain_literalr r r �_check_for_early_dl_end s �rK c C sj t � }| d tkr(t| �\}} |�|� | s6t�d��| d dkrRt�d�| ���| dd� } t| |�rp|| fS |�tdd�� | d t kr�t | �\}} |�|� t | �\}} |�|� t| |�r�|| fS | d t kr�t | �\}} |�|� t| |�r�|| fS | d dk�r t�d �| ���|�tdd �� | dd� } | �rb| d tk�rbt| �\}} |�|� || fS ) zB domain-literal = [CFWS] "[" *([FWS] dtext) [FWS] "]" [CFWS] r zexpected domain-literal�[z6expected '[' at start of domain-literal but found '{}'r� Nzdomain-literal-startrH z4expected ']' at end of domain-literal but found '{}'rI ) r� r3 r4 rh r r r* rK r r r rG )r rJ r6 r r r �get_domain_literal sH � � rM c C sr t � }d}| d tkr"t| �\}} | s6t�d�| ���| d dkrvt| �\}} |dk rd|g|dd�< |�|� || fS zt| �\}} W n" tjk r� t | �\}} Y nX | r�| d dkr�t�d��|dk r�|g|dd�< |�|� | �rj| d dk�rj|j �t� d�� |d j d k�r*|d |dd�< | �rj| d dk�rj|�t � t | d d� �\}} |�|� �q*|| fS ) z] domain = dot-atom / domain-literal / obs-domain obs-domain = atom *("." atom)) Nr z expected domain but found '{}'rL r� zInvalid Domainr z(domain is not a dot-atom (contains CFWS)r� r� )r� r3 r4 r r r* rM rh r9 r7 r r> rD r� )r r� r; r6 r r r � get_domain= sD � � rN c C s| t � }t| �\}} |�|� | r,| d dkrF|j�t�d�� || fS |�tdd�� t| dd� �\}} |�|� || fS )z( addr-spec = local-part "@" domain r r� z#addr-spec local part with no domain�address-at-symbolr� N)r� rE rh r r r� r rN )r r� r6 r r r � get_addr_specc s � rP c C s� t � }| rj| d dks"| d tkrj| d tkrFt| �\}} |�|� q| d dkr|�t� | dd� } q| rz| d dkr�t�d�| ���|�t� t | dd� �\}} |�|� | �r>| d dk�r>|�t� | dd� } | s�q>| d tk�rt| �\}} |�|� | d dkr�|�t� t | dd� �\}} |�|� q�| �sNt�d��| d dk�rlt�d �| ���|�t dd �� || dd� fS ) z� obs-route = obs-domain-list ":" obs-domain-list = *(CFWS / ",") "@" domain *("," [CFWS] ["@" domain]) Returns an obs-route token with the appropriate sub-tokens (that is, there is no obs-domain-list in the parse tree). r r r� Nr� z(expected obs-route domain but found '{}'z%end of header while parsing obs-route�:z4expected ':' marking end of obs-route but found '{}'zend-of-obs-route-marker) r� r3 r4 rh � ListSeparatorr r r* �RouteComponentMarkerrN r )r Z obs_router6 r r r � get_obs_routes sF � �rT c C s� t � }| d tkr(t| �\}} |�|� | r8| d dkrHt�d�| ���|�tdd�� | dd� } | d dkr�|�tdd�� |j�t� d �� | dd� } || fS zt | �\}} W nz tjk �r0 z"t | �\}} |j�t� d �� W n( tjk �r t�d �| ���Y nX |�|� t | �\}} Y nX |�|� | �r^| d dk�r^| dd� } n|j�t� d �� |�tdd�� | �r�| d tk�r�t| �\}} |�|� || fS ) z� angle-addr = [CFWS] "<" addr-spec ">" [CFWS] / obs-angle-addr obs-angle-addr = [CFWS] "<" obs-route addr-spec ">" [CFWS] r �<z"expected angle-addr but found '{}'zangle-addr-startr� N�>zangle-addr-endz null addr-spec in angle-addrz*obsolete route specification in angle-addrz.expected addr-spec or obs-route but found '{}'z"missing trailing '>' on angle-addr) r� r3 r4 rh r r r* r r r� rP rT r> )r Z angle_addrr6 r r r �get_angle_addr� sT � � � � � rW c C s< t � }t| �\}} |�|dd� � |jdd� |_|| fS )z� display-name = phrase Because this is simply a name-rule, we don't return a display-name token containing a phrase, but rather a display-name token with the content of the phrase. N)r� r? r4 r )r r~ r6 r r r �get_display_name� s rX c C s� t � }d}| d tkr6t| �\}} | s6t�d�|���| d dkr�| d tkr^t�d�| ���t| �\}} | s~t�d�|���|dk r�|g|d dd�< d}|�|� t | �\}} |dk r�|g|dd�< |�|� || fS )z, name-addr = [display-name] angle-addr Nr z!expected name-addr but found '{}'rU ) r� r3 r4 r r r* r= rX rh rW )r Z name_addrr; r6 r r r � get_name_addr� s6 � � � rY c C s� t � }zt| �\}} W nN tjk rd zt| �\}} W n& tjk r^ t�d�| ���Y nX Y nX tdd� |jD ��r�d|_|� |� || fS )z& mailbox = name-addr / addr-spec z expected mailbox but found '{}'c s s | ]}t |tj�V qd S r )r� r r� r r r r r# s �z get_mailbox.<locals>.<genexpr>r� ) r� rY r r rP r* �anyr- rD rh )r r� r6 r r r � get_mailbox� s �� r[ c C sd t � }| r\| d |kr\| d tkrD|�t| d d�� | dd� } qt| �\}} |�|� q|| fS )z� Read everything up to one of the chars in endchars. This is outside the formal grammar. The InvalidMailbox TokenList that is returned acts like a Mailbox, but the data attributes are None. r rF r� N)r� r= rh r r? )r r Zinvalid_mailboxr6 r r r �get_invalid_mailbox s � r\ c C s� t � }| �r�| d dk�r�z t| �\}} |�|� W �n tjk �r< d}| d tkr�t| �\}} | rv| d dkr�|�|� |j�t�d�� n@t | d�\}} |dk r�|g|dd�< |�|� |j�t� d�� nb| d dkr�|j�t�d�� nBt | d�\}} |dk �r |g|dd�< |�|� |j�t� d�� Y nX | �r�| d dk�r�|d }d |_ t | d�\}} |� |� |j�t� d�� | r| d dkr|�t � | d d� } q|| fS ) aJ mailbox-list = (mailbox *("," mailbox)) / obs-mbox-list obs-mbox-list = *([CFWS] ",") mailbox *("," [mailbox / CFWS]) For this routine we go outside the formal grammar in order to improve error handling. We recognize the end of the mailbox list only at the end of the value or at a ';' (the group terminator). This is so that we can turn invalid mailboxes into InvalidMailbox tokens and continue parsing any remaining valid mailboxes. We also allow all mailbox entries to be null, and this condition is handled appropriately at a higher level. r �;Nz,;z empty element in mailbox-listz invalid mailbox in mailbox-listr r� r� r� )r� r[ rh r r r3 r4 r r> r\ r� rD r4 rR )r Z mailbox_listr6 r; r� r r r �get_mailbox_list sX � � � � � r^ c C s t � }| s$|j�t�d�� || fS d}| r�| d tkr�t| �\}} | sl|j�t�d�� |�|� || fS | d dkr�|�|� || fS t| �\}} t|j �dkr�|dk r�|�|� |� |� |j�t� d�� || fS |dk r�|g|dd�< |�|� || fS )zg group-list = mailbox-list / CFWS / obs-group-list obs-group-list = 1*([CFWS] ",") [CFWS] z end of header before group-listNr zend of header in group-listr] z group-list with empty entries) r� r rh r r� r3 r4 r^ r� rz r4 r> )r Z group_listr; r6 r r r �get_group_listW s> � � � r_ c C s t � }t| �\}} | r"| d dkr2t�d�| ���|�|� |�tdd�� | dd� } | r�| d dkr�|�tdd�� || dd� fS t| �\}} |�|� | s�|j�t� d �� n | d dkr�t�d �| ���|�tdd�� | dd� } | �r| d t k�rt | �\}} |�|� || fS ) z7 group = display-name ":" [group-list] ";" [CFWS] r rQ z8expected ':' at end of group display name but found '{}'z group-display-name-terminatorr� Nr] zgroup-terminatorzend of header in groupz)expected ';' at end of group but found {}) r� rX r r r* rh r r_ r r� r3 r4 )r r| r6 r r r � get_group| s8 � � � r` c C sx t � }zt| �\}} W nN tjk rd zt| �\}} W n& tjk r^ t�d�| ���Y nX Y nX |�|� || fS )a� address = mailbox / group Note that counter-intuitively, an address can be either a single address or a list of addresses (a group). This is why the returned Address object has a 'mailboxes' attribute which treats a single address as a list of length one. When you need to differentiate between to two cases, extract the single element, which is either a mailbox or a group token. z expected address but found '{}')r{ r` r r r[ r* rh )r rr r6 r r r � get_address� s � ra c C s� t � }| �r�z t| �\}} |�|� W �n tjk �rH } z�d}| d tkr�t| �\}} | rj| d dkr�|�|� |j�t�d�� nFt | d�\}} |dk r�|g|dd�< |�t |g�� |j�t� d�� nh| d dkr�|j�t�d�� nHt | d�\}} |dk �r|g|dd�< |�t |g�� |j�t� d�� W 5 d}~X Y nX | �r�| d dk�r�|d d }d|_ t | d�\}} |� |� |j�t� d�� | r|�tdd �� | d d� } q|| fS ) a� address_list = (address *("," address)) / obs-addr-list obs-addr-list = *([CFWS] ",") address *("," [address / CFWS]) We depart from the formal grammar here by continuing to parse until the end of the input, assuming the input to be entirely composed of an address-list. This is always true in email parsing, and allows us to skip invalid addresses to parse additional valid ones. Nr r z"address-list entry with no contentz invalid address in address-listz empty element in address-listr� r� r r� )rq ra rh r r r3 r4 r r> r\ r{ r� rD r4 r )r Z address_listr6 �errr; r� r r r �get_address_list� sX � � � � �rc c C s� t � }| st�d�| ���| d dkr6t�d�| ���|�tdd�� | dd� } t| �\}} |�|� | rx| d dkr�t�d �| ���|�tdd �� || dd� fS ) z& no-fold-literal = "[" *dtext "]" z'expected no-fold-literal but found '{}'r rL z;expected '[' at the start of no-fold-literal but found '{}'zno-fold-literal-startr� NrH z9expected ']' at the end of no-fold-literal but found '{}'zno-fold-literal-end)r� r r r* rh r rG )r Zno_fold_literalr6 r r r �get_no_fold_literal� s. � �� ��rd c C s� t � }| r,| d tkr,t| �\}} |�|� | r<| d dkrLt�d�| ���|�tdd�� | dd� } zt| �\}} W n` tjk r� z"t | �\}} |j �t� d�� W n& tjk r� t�d�| ���Y nX Y nX |�|� | r�| d d k�r@|j �t� d �� | �r8| d d k�r8|�td d �� | dd� } || fS |�td d �� | dd� } zt| �\}} W n� tjk �r zt | �\}} W nr tjk �r } zPz"t| �\}} |j �t� d�� W n( tjk �r� t�d�| ���Y nX W 5 d}~X Y nX Y nX |�|� | �r6| d d k�r6| dd� } n|j �t� d�� |�td d �� | �r�| d tk�r�t| �\}} |�|� || fS )z�msg-id = [CFWS] "<" id-left '@' id-right ">" [CFWS] id-left = dot-atom-text / obs-id-left id-right = dot-atom-text / no-fold-literal / obs-id-right no-fold-literal = "[" *dtext "]" r rU z expected msg-id but found '{}'z msg-id-startr� Nzobsolete id-left in msg-idz4expected dot-atom-text or obs-id-left but found '{}'r� zmsg-id with no id-rightrV z msg-id-endrO zobsolete id-right in msg-idzFexpected dot-atom-text, no-fold-literal or obs-id-right but found '{}'z missing trailing '>' on msg-id)r� r3 r4 rh r r r* r r8 rB r r> r� rd rN )r Zmsg_idr6 �er r r � get_msg_id s~ � � �� � � ��" � rf c C s� t � }zt| �\}} |�|� W nL tjk rl } z,t| �}t|�}|j�t�d� |��� W 5 d}~X Y n X | r�|j�t�d� | ��� |S )z2message-id = "Message-ID:" msg-id CRLF zInvalid msg-id: {!r}NzUnexpected {!r}) r� rf rh r r r( r� r r� r* )r Z message_idr6 Zexr r r �parse_message_idI s � �rg c C s� t � }| s |j�t�d�� |S | d tkrXt| �\}} |�|� | sX|j�t�d�� d}| r�| d dkr�| d tkr�|| d 7 }| dd� } q\|�� s�|j�t�d� |��� |�t |d �� nt |�|_ |�t |d �� | �r| d tk�rt| �\}} |�|� | �r | d dk�rT|j dk �r:|j�t�d �� | �rP|�t | d �� |S |�t dd �� | dd� } | �r�| d tk�r�t| �\}} |�|� | �s�|j dk �r�|j�t�d �� |S d}| �r�| d tk�r�|| d 7 }| dd� } �q�|�� �s*|j�t�d � |��� |�t |d �� nt |�|_ |�t |d �� | �rn| d tk�rnt| �\}} |�|� | �r�|j�t�d�� |�t | d �� |S )zE mime-version = [CFWS] 1*digit [CFWS] "." [CFWS] 1*digit [CFWS] z%Missing MIME version number (eg: 1.0)r z0Expected MIME version number but found only CFWSr r r� Nz1Expected MIME major version number but found {!r}r �digitsz0Incomplete MIME version; found only major numberzversion-separatorz1Expected MIME minor version number but found {!r}z'Excess non-CFWS text after MIME version)r� r rh r �HeaderMissingRequiredValuer3 r4 �isdigitr� r* r �intr� r� )r Z mime_versionr6 rh r r r �parse_mime_versione s� � � � � � � �rl c C sd t � }| r\| d dkr\| d tkrD|�t| d d�� | dd� } qt| �\}} |�|� q|| fS )z� Read everything up to the next ';'. This is outside the formal grammar. The InvalidParameter TokenList that is returned acts like a Parameter, but the data attributes are None. r r] rF r� N)r� r= rh r r? )r Zinvalid_parameterr6 r r r �get_invalid_parameter� s � rm c C sN t | �}|s t�d�| ���|�� }| t|�d� } t|d�}t|� || fS )a8 ttext = <matches _ttext_matcher> We allow any non-TOKEN_ENDS in ttext, but add defects to the token's defects list if we find non-ttext characters. We also register defects for *any* non-printables even though the RFC doesn't exclude all of them, because we follow the spirit of RFC 5322. z expected ttext but found '{}'N�ttext)�_non_token_end_matcherr r r* r| r� r r )r r/ rn r r r � get_ttext� s � rp c C s� t � }| r,| d tkr,t| �\}} |�|� | rL| d tkrLt�d�| ���t| �\}} |�|� | r�| d tkr�t| �\}} |�|� || fS )z�token = [CFWS] 1*ttext [CFWS] The RFC equivalent of ttext is any US-ASCII chars except space, ctls, or tspecials. We also exclude tabs even though the RFC doesn't. The RFC implies the CFWS but is not explicit about it in the BNF. r � expected token but found '{}') r\ r3 r4 rh � TOKEN_ENDSr r r* rp )r Zmtokenr6 r r r � get_token� s � rs c C sN t | �}|s t�d�| ���|�� }| t|�d� } t|d�}t|� || fS )aQ attrtext = 1*(any non-ATTRIBUTE_ENDS character) We allow any non-ATTRIBUTE_ENDS in attrtext, but add defects to the token's defects list if we find non-attrtext characters. We also register defects for *any* non-printables even though the RFC doesn't exclude all of them, because we follow the spirit of RFC 5322. z expected attrtext but found {!r}Nr� )�_non_attribute_end_matcherr r r* r| r� r r �r r/ r� r r r � get_attrtext� s � rv c C s� t � }| r,| d tkr,t| �\}} |�|� | rL| d tkrLt�d�| ���t| �\}} |�|� | r�| d tkr�t| �\}} |�|� || fS )aH [CFWS] 1*attrtext [CFWS] This version of the BNF makes the CFWS explicit, and as usual we use a value terminal for the actual run of characters. The RFC equivalent of attrtext is the token characters, with the subtraction of '*', "'", and '%'. We include tab in the excluded set just as we do for token. r rq ) r� r3 r4 rh �ATTRIBUTE_ENDSr r r* rv �r r� r6 r r r � get_attribute� s � ry c C sN t | �}|s t�d�| ���|�� }| t|�d� } t|d�}t|� || fS )z�attrtext = 1*(any non-ATTRIBUTE_ENDS character plus '%') This is a special parsing routine so that we get a value that includes % escapes as a single string (which we decode as a single string later). z)expected extended attrtext but found {!r}N�extended-attrtext)�#_non_extended_attribute_end_matcherr r r* r| r� r r ru r r r �get_extended_attrtext s � r| c C s� t � }| r,| d tkr,t| �\}} |�|� | rL| d tkrLt�d�| ���t| �\}} |�|� | r�| d tkr�t| �\}} |�|� || fS )z� [CFWS] 1*extended_attrtext [CFWS] This is like the non-extended version except we allow % characters, so that we can pick up an encoded value as a single string. r rq ) r� r3 r4 rh �EXTENDED_ATTRIBUTE_ENDSr r r* r| rx r r r �get_extended_attribute! s � r~ c C s� t � }| r| d dkr&t�d�| ���|�tdd�� | dd� } | rR| d �� sbt�d�| ���d}| r�| d �� r�|| d 7 }| dd� } qf|d d kr�|d kr�|j�t�d �� t |�|_ |�t|d �� || fS ) a6 '*' digits The formal BNF is more complicated because leading 0s are not allowed. We check for that and add a defect. We also assume no CFWS is allowed between the '*' and the digits, though the RFC is not crystal clear on that. The caller should already have dealt with leading CFWS. r �*z Expected section but found {}zsection-markerr� Nz$Expected section number but found {}r �0z'section number has an invalid leading 0rh ) r� r r r* rh r rj r ZInvalidHeaderErrorrk r� )r r� rh r r r � get_section7 s, � � � r� c C s� t � }| st�d��d}| d tkr0t| �\}} | sDt�d�|���| d dkr^t| �\}} n t| �\}} |dk r�|g|dd�< |�|� || fS )z quoted-string / attribute z&Expected value but found end of stringNr z Expected value but found only {}r ) r� r r r3 r4 r* r5 r~ rh )r �vr; r6 r r r � get_valueU s" � r� c C s� t � }t| �\}} |�|� | r,| d dkrL|j�t�d�|��� || fS | d dkr�z t| �\}} d|_|�|� W n tj k r� Y nX | s�t� d��| d dkr�|�t dd�� | dd � } d|_ | d d kr�t� d ��|�t d d �� | dd � } d }| �r,| d t k�r,t | �\}} |�|� d }|}|j �rF| �rF| d d k�rFt| �\}}|j}d}|jdk�r�|�r�|d dk�r�d}n$t|�\}} | �r�| d dk�r�d}n(zt|�\}} W n Y n X | �s�d}|�r0|j�t�d�� |�|� |D ](} | jdk�r g | d d �< | } �q*�q |} nd }|j�t�d�� | �r`| d dk�r`d }n t| �\}} |j �r�|jdk�r�| �r�| d dk�r�|�|� |d k �r�| �r�t| ��|} || fS |j�t�d�� | �s |j�t�d�� |�|� |d k�r�|| fS n�|d k �rN|D ]} | jdk�r �q2�q| jdk |�| � | j|_| d dk�rlt� d�| ���|�t dd�� | dd � } | �r�| d dk�r�t| �\}} |�|� |j|_| �r�| d dk�r�t� d�| ���|�t dd�� | dd � } |d k �rrt� } | �rl| d tk�r,t| �\}} n2| d d k�rRt d d�}| dd � } n t | �\}} | �|� �q | }n t| �\}} |�|� |d k �r�| �r�t| ��|} || fS )aY attribute [section] ["*"] [CFWS] "=" value The CFWS is implied by the RFC but not made explicit in the BNF. This simplified form of the BNF from the RFC is made to conform with the RFC BNF through some extra checks. We do it this way because it makes both error recovery and working with the resulting parse tree easier. r r] z)Parameter contains name ({}) but no valuer TzIncomplete parameterzextended-parameter-markerr� N�=z Parameter not followed by '='�parameter-separatorr F�'z5Quoted string value for extended parameter is invalidre zZParameter marked as extended but appears to have a quoted string value that is non-encodedzcApparent initial-extended-value but attribute was not marked as extended or was not initial sectionz(Missing required charset/lang delimitersrz r� z=Expected RFC2231 char/lang encoding delimiter, but found {!r}zRFC2231-delimiterz;Expected RFC2231 char/lang encoding delimiter, but found {}ZDQUOTE) r� ry rh r r r� r* r� r� r r r� r3 r4 r5 rl r� rv r| rD r� �AssertionErrorr r` ra r� r r r, ) r r� r6 r; r ZappendtoZqstringZ inner_valueZ semi_validr �tr� r r r � get_parameterk s� � � � � � � � r� c C sj t � }| �rfzt| �\}} |�|� W n� tjk r� } z�d}| d tkrVt| �\}} | sp|�|� | W Y �xS | d dkr�|dk r�|�|� |j�t�d�� n@t | �\}} |r�|g|dd�< |�|� |j�t�d� |��� W 5 d}~X Y nX | �rD| d dk�rD|d }d|_ t | �\}} |� |� |j�t�d� |��� | r|�t dd �� | d d� } q|S ) a! parameter *( ";" parameter ) That BNF is meant to indicate this routine should only be called after finding and handling the leading ';'. There is no corresponding rule in the formal RFC grammar, but it is more convenient for us for the set of parameters to be treated as its own TokenList. This is 'parse' routine because it consumes the remaining value, but it would never be called to parse a full header. Instead it is called to parse everything after the non-parameter value of a specific MIME header. Nr r] z parameter entry with no contentzinvalid parameter {!r}r� r� z)parameter with invalid trailing text {!r}r� r� )r� r� rh r r r3 r4 r r� rm r* rD r4 r )r Zmime_parametersr6 rb r; r� r r r �parse_mime_parameters� sJ � � �r� c C s� |rV|d dkrV|d t kr>| �t|d d�� |dd� }q t|�\}}| �|� q |s^dS | �tdd�� | �t|dd� �� dS )zBDo our best to find the parameters in an invalid MIME header r r] rF r� Nr� )r= rh r r? r� )Z tokenlistr r6 r r r �_find_mime_parameters- s r� c C s� t � }d}| s$|j�t�d�� |S zt| �\}} W n< tjk rp |j�t�d�| ��� t || � | Y S X |�|� | r�| d dkr�|j�t�d�� | r�t || � |S |j � � � � |_ |�tdd�� | dd � } zt| �\}} W n> tjk �r* |j�t�d �| ��� t || � | Y S X |�|� |j � � � � |_| �sP|S | d d k�r�|j�t�d �| ��� |` |`t || � |S |�td d �� |�t| dd � �� |S )z� maintype "/" subtype *( ";" parameter ) The maintype and substype are tokens. Theoretically they could be checked against the official IANA list + x-token, but we don't do that. Fz"Missing content type specificationz(Expected content maintype but found {!r}r r� zInvalid content typezcontent-type-separatorr� Nz'Expected content subtype but found {!r}r] z<Only parameters are valid after content type, but found {!r}r� )r� r rh r ri rs r r� r* r� r r� �lowerr� r r� r� )r ZctypeZrecoverr6 r r r �parse_content_type_header= sd � � � � �� r� c C s� t � }| s |j�t�d�� |S zt| �\}} W n< tjk rl |j�t�d�| ��� t || � | Y S X |�|� |j � � � � |_ | s�|S | d dkr�|j�t�d�| ��� t || � |S |�tdd�� |�t| dd� �� |S ) z* disposition-type *( ";" parameter ) zMissing content dispositionz+Expected content disposition but found {!r}r r] zCOnly parameters are valid after content disposition, but found {!r}r� r� N)r� r rh r ri rs r r� r* r� r r� r� r� r r� )r Z disp_headerr6 r r r � parse_content_disposition_headerv s: � � �� r� c C s� t � }| s |j�t�d�� |S zt| �\}} W n. tjk r^ |j�t�d�| ��� Y n X |�|� |j � � � � |_ | s�|S | r�|j�t�d�� | d t kr�|�t| d d�� | dd� } q�t| �\}} |�|� q�|S )z mechanism z!Missing content transfer encodingz1Expected content transfer encoding but found {!r}z*Extra text after content transfer encodingr rF r� N)r� r rh r ri rs r r� r* r r� r� r_ r= r r? )r Z cte_headerr6 r r r �&parse_content_transfer_encoding_header� s4 � � � r� c C sD d}| r@| d r@| d d t kr@| d d }| d d d� | d< |S )Nr r� )r )�linesZwspr r r � _steal_trailing_WSP_if_exists� s r� c C s� |j p tj}|jrdnd}dg}d}d}d}tdd�}t| �} | �r�| �d�} | |kr`|d8 }q>t| �} | jd kr�t | �t @ r�d }z| � |� |} W n6 t k r� t d d � | jD ��r�d } nd} d }Y nX | jdkr�t| |||� q>|�r�|�s�| j�spd}d}| j�rp| j|d�dt|j� � } |j| k�rpt| �|t|d � k�r^t|�}|�|� |d | 7 < q>t| d��s�t| �| } nt| |||| j| �}d}q>t| �|t|d � k�r�|d | 7 < q>| j�rt| �d |k�rt|�}|�s| �� �r|�|| � d}q>t| d��sNt| �}| j�sD|d7 }|�|� || } q>| j�rn|�sn| �d| � d }q>t|�}|�s�| �� �r�|�|| � q>|d | 7 < q>|j� |�|j S )zLReturn string of contents of parse_tree folded according to RFC rules. �utf-8r� r Nr F�wrap_as_ew_blockedr� r� Tc s s | ]}t |tj�V qd S r )r� r r� r r r r r# � s �z%_refold_parse_tree.<locals>.<genexpr>� unknown-8bitr� r7 r� rC ) Zmax_line_length�sys�maxsize�utf8r� r� r� r rD r� r: rC r� rZ r- �_fold_mime_parametersr1 rH r; r� r� r� rh rE � _fold_as_ewrI r0 �insertr% )Z parse_treer8 �maxlenr� r� �last_ewr� Z want_encodingZend_ew_not_allowedr� r2 �tstrr` Z encoded_part�newlineZnewpartsr r r r9 � s� � �� r9 c C s� |dk r<|r<t t|d |d� | ��} |d d|� |d< | d tkr�| d }| dd� } t|d �|krz|�t|�� |d |7 < d}| d tkr�| d }| dd� } |dkr�t|d �n|}|dkr�dn|} t| �d } | d |kr�t�d ��| �r�|t|d � } | | } | dk�r,|�d � q�| d| � } tj | | d �}t|�| }|dk�r�| dd� } tj | | d �}t|�| }�qR|d |7 < | t| �d� } | r�|�d � t|d �}q�|d |7 < |�r�|S dS ) a� Fold string to_encode into lines as encoded word, combining if allowed. Return the new value for last_ew, or None if ew_combine_allowed is False. If there is already an encoded word in the last line of lines (indicated by a non-None value for last_ew) and ew_combine_allowed is true, decode the existing ew, combine it with to_encode, and re-encode. Otherwise, encode to_encode. In either case, split to_encode as necessary so that the encoded segments fit within maxlen. Nr� r r� r r� r� � z3max_line_length is too small to fit an encoded wordrN )r` ) r r( r r� rh r� r r r rC )Z to_encoder� r� r� rI r` Z leading_wspZ trailing_wspZ new_last_ewZ encode_as� chrome_lenZremaining_spaceZ text_spaceZto_encode_wordZ encoded_wordZexcessr r r r� 1 sT � � r� c C s� | j D �]�\}}|d �� �d�s2|d d7 < |}d}z|�|� d}W n0 tk r| d}t�|�rtd}d}nd}Y nX |r�tjj |d |d �} d � ||| �} nd � |t |��} t |d �t | � d |k r�|d d | |d< qn"t | �d |k�r |� d| � qd} |d } |rt |�t t| �� d t | � } || d k�rLd}|| d }}|d|� }tjj |d |d �} t | �|k�r��q�|d 8 }�q\|� d� || | | �� d } | d 7 } ||d� }|�r|d d7 < �qqdS )a> Fold TokenList 'part' into the 'lines' list as mime parameters. Using the decoded list of parameters and values, format them according to the RFC rules, including using RFC2231 encoding if the value cannot be expressed in 'encoding' and/or the parameter+value is too long to fit within 'maxlen'. r� r] �strictFTr� r� r� r )Zsafer z {}*={}''{}r� r� rN r� r z''r� �N Nz {}*{}*={}{})r� r� r� rC r� r r� r� r� ro r* r r� rh r )r2 r� r� r� r� r r` Z error_handlerZencoding_requiredZ encoded_valuer� r� Z extra_chromer� Z splitpointZmaxchars�partialr r r r� r sn � � � r� )�r �rer� r� �stringr �operatorr Zemailr r r r r� r r3 r: r6 r� r= Z TSPECIALSrr Z ASPECIALSrw r} r �compile�VERBOSE� MULTILINEr$ r� r rL rR rU rW rX rZ r\ r] rb rm rn rq r{ r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r r� r r r r r r� rR rS r* r% r� r r �matchr. �findallr ro rt r{ r r r r" r( r+ r, r0 r1 r2 r4 r5 r7 r8 r9 r< r? rE rB rG rK rM rN rP rT rW rX rY r[ r\ r^ r_ r` ra rc rd rf rg rl rm rp rs rv ry r| r~ r� r� r� r� r� r� r� r� r� r9 r� r� r r r r �<module> s. E �C " !*$ V + � ��� 1C+ "&'/'&). 9% 7E D 49 /gA __pycache__/_parseaddr.cpython-38.opt-1.pyc 0000644 00000030266 15204103444 0014453 0 ustar 00 U e5dE � @ s� d Z ddddgZddlZddlZdZdZd Zd d d d dddddddddddddddd d d d d gZd!d"d#d$d%d&d'gZddddd(d)d*d(d+d*d,d+d-d,d.�Z d/d� Z d0d1� Z d2d� Z d3d� Z d4d� ZG d5d6� d6�ZG d7d8� d8e�ZdS )9zcEmail address parsing code. Lifted directly from rfc822.py. This should eventually be rewritten. � mktime_tz� parsedate� parsedate_tz�quote� N� � z, ZjanZfebZmarZaprZmayZjunZjulZaug�sep�octZnovZdecZjanuaryZfebruaryZmarchZaprilZjuneZjulyZaugustZ septemberZoctoberZnovemberZdecemberZmonZtueZwedZthuZfriZsatZsunip���i���i ���i����iD���i��)ZUTZUTCZGMT�ZZASTZADTZESTZEDTZCSTZCDTZMSTZMDTZPSTZPDTc C s, t | �}|sdS |d dkr$d|d< t|�S )zQConvert a date string to a time tuple. Accounts for military timezones. N� r )� _parsedate_tz�tuple)�data�res� r �(/usr/lib64/python3.8/email/_parseaddr.pyr - s c C s� | sdS | � � } | sdS | d �d�s6| d �� tkr>| d= n.| d �d�}|dkrl| d |d d� | d< t| �dkr�| d � d�}t|�dkr�|| dd� } t| �dk�r| d }|�d�}|d kr�|�d�}|dkr�|d|� ||d� g| dd�< n | �d � t| �d k �rdS | dd � } | \}}}}}|�� }|tk�rb||�� }}|tk�rbdS t� |�d }|d k�r�|d 8 }|d dk�r�|dd � }|�d �}|dk�r�|| }}|d dk�r�|dd � }|d � � �s�|| }}|d dk�r|dd � }|� d �}t|�dk�r,|\} } d} n~t|�dk�rF|\} } } ndt|�dk�r�d|d k�r�|d � d�}t|�dk�r�|\} } d} nt|�dk�r�|\} } } ndS z,t |�}t |�}t | �} t | �} t | �} W n t k �r� Y dS X |dk �r|dk�r|d7 }n|d7 }d} |� � }|tk�r6t| } n>z t |�} W n t k �rX Y nX | dk�rt|�d��rtd} | �r�| dk �r�d } | } nd} | | d d | d d } |||| | | ddd | g S )a� Convert date to extended time tuple. The last (additional) element is the time zone offset in seconds, except if the timezone was specified as -0000. In that case the last element is None. This indicates a UTC timestamp that explicitly declaims knowledge of the source timezone, as opposed to a +0000 timestamp that indicates the source timezone really was UTC. Nr �,� � �-� �+���r � � �:� �0�.�d �D il i� i �< )�split�endswith�lower� _daynames�rfind�len�find�append� _monthnames�index�isdigit�int� ValueError�upper� _timezones� startswith)r �iZstuff�sZddZmmZyyZtmZtzZthhZtmmZtssZtzoffsetZtzsignr r r r 9 s� " r c C s& t | �}t|t�r |dd� S |S dS )z&Convert a time string to a time tuple.Nr )r � isinstancer �r �tr r r r � s c C s< | d dkr"t �| dd� d �S t�| �}|| d S dS )zETurn a 10-tuple as returned by parsedate_tz() into a POSIX timestamp.r N� )r )�time�mktime�calendarZtimegmr5 r r r r � s c C s | � dd�� dd�S )z�Prepare string to be used in a quoted string. Turns backslash and double quote characters into quoted pairs. These are the only characters that need to be quoted inside a quoted string. Does not add the surrounding double quotes. �\z\\�"z\")�replace)�strr r r r � s c @ s| e Zd ZdZdd� Zdd� Zdd� Zdd � Zd d � Zd d � Z dd� Z d dd�Z dd� Z dd� Z dd� Zd dd�Zd d � ZdS ) � AddrlistClassa Address parser class by Ben Escoto. To understand what this class does, it helps to have a copy of RFC 2822 in front of you. Note: this class interface is deprecated and may be removed in the future. Use email.utils.AddressList instead. c C sZ d| _ d| _d| _d| _| j| j | _| j | j | j | _| j�dd�| _|| _g | _ dS )z�Initialize a new instance. `field' is an unparsed address header field, containing one or more addresses. z ()<>@,:;."[]r z z r r N) �specials�pos�LWSZCR�FWS�atomendsr= � phraseends�field� commentlist��selfrF r r r �__init__� s zAddrlistClass.__init__c C s� g }| j t| j�k r�| j| j | jd kr\| j| j dkrL|�| j| j � | j d7 _ q| j| j dkr�| j�| �� � qq�qt�|�S )z&Skip white space and extract comments.z r �() rA r' rF rB r) rG � getcomment� EMPTYSTRING�join)rI Zwslistr r r �gotonext� s zAddrlistClass.gotonextc C s: g }| j t| j�k r6| �� }|r*||7 }q|�d� q|S )zVParse all addresses. Returns a list containing all of the addresses. )r r )rA r' rF � getaddressr) )rI �resultZadr r r � getaddrlist� s zAddrlistClass.getaddrlistc C s� g | _ | �� | j}| j }| �� }| �� g }| jt| j�kr\|rXt�| j �|d fg}�n\| j| j dkr�|| _|| _ | �� }t�| j �|fg}�n"| j| j dk�r g }t| j�}| jd7 _| jt| j�k �r�| �� | j|k �r| j| j dk�r| jd7 _�q�|| � � }q�n�| j| j dk�rx| � � }| j �rft�|�d d�| j � d |fg}nt�|�|fg}n@|�r�t�| j �|d fg}n"| j| j | j k�r�| jd7 _| �� | jt| j�k �r�| j| j d k�r�| jd7 _|S ) zParse the next address.r z.@r r �;�<z (r �)r ) rG rO rA � getphraselistr' rF �SPACErN � getaddrspecrP � getrouteaddrr@ )rI ZoldposZoldcl�plistZ returnlistZaddrspecZfieldlenZ routeaddrr r r rP sX ���$zAddrlistClass.getaddressc C s� | j | j dkrdS d}| jd7 _| �� d}| jt| j �k r�|rT| �� d}n~| j | j dkrv| jd7 _q�n\| j | j dkr�| jd7 _d}n8| j | j d kr�| jd7 _n| �� }| jd7 _q�| �� q2|S ) z�Parse a route address (Return-path value). This method just skips all the route stuff and returns the addrspec. rT NFr r �>�@Tr )rF rA rO r' � getdomainrX )rI Z expectrouteZadlistr r r rY A s. zAddrlistClass.getrouteaddrc C sT g }| � � | jt| j�k r�d}| j| j dkrf|rH|d �� sH|�� |�d� | jd7 _d}nd| j| j dkr�|�dt| �� � � n<| j| j | j kr�|r�|d �� s�|�� q�n|�| � � � | � � }|r |r |�|� q | jt| j�k�s | j| j dk�rt � |�S |�d� | jd7 _| � � | � � }|�sFt S t � |�| S ) z Parse an RFC 2822 addr-spec.Tr r r Fr< z"%s"r\ )rO rA r' rF �strip�popr) r �getquoterD �getatomrM rN r] )rI ZaslistZ preserve_wsZwsZdomainr r r rX a s: $ zAddrlistClass.getaddrspecc C s� g }| j t| j�k r�| j| j | jkr6| j d7 _ q| j| j dkrX| j�| �� � q| j| j dkrx|�| �� � q| j| j dkr�| j d7 _ |�d� q| j| j dkr�tS | j| j | j kr�q�q|�| � � � qt� |�S )z-Get the complete domain name from an address.r rK �[r r\ ) rA r' rF rB rG r) rL �getdomainliteralrM rD ra rN )rI Zsdlistr r r r] � s" zAddrlistClass.getdomainTc C s� | j | j |krdS dg}d}| jd7 _| jt| j �k r�|rX|�| j | j � d}np| j | j |krz| jd7 _q�nN|r�| j | j dkr�|�| �� � q,n(| j | j dkr�d}n|�| j | j � | jd7 _q,t�|�S )a� Parse a header fragment delimited by special characters. `beginchar' is the start character for the fragment. If self is not looking at an instance of `beginchar' then getdelimited returns the empty string. `endchars' is a sequence of allowable end-delimiting characters. Parsing stops when one of these is encountered. If `allowcomments' is non-zero, embedded RFC 2822 comments are allowed within the parsed fragment. r Fr rK r; T)rF rA r' r) rL rM rN )rI Z begincharZendcharsZ allowcommentsZslistr r r r � getdelimited� s( zAddrlistClass.getdelimitedc C s | � ddd�S )z1Get a quote-delimited fragment from self's field.r< z" F�rd �rI r r r r` � s zAddrlistClass.getquotec C s | � ddd�S )z7Get a parenthesis-delimited fragment from self's field.rK z) Tre rf r r r rL � s zAddrlistClass.getcommentc C s d| � ddd� S )z!Parse an RFC 2822 domain-literal.z[%s]rb z] Fre rf r r r rc � s z AddrlistClass.getdomainliteralNc C sd dg}|dkr| j }| jt| j�k rZ| j| j |kr8qZn|�| j| j � | jd7 _qt�|�S )a Parse an RFC 2822 atom. Optional atomends specifies a different set of end token delimiters (the default is to use self.atomends). This is used e.g. in getphraselist() since phrase endings must not include the `.' (which is legal in phrases).r Nr )rD rA r' rF r) rM rN )rI rD Zatomlistr r r ra � s zAddrlistClass.getatomc C s� g }| j t| j�k r�| j| j | jkr6| j d7 _ q| j| j dkrV|�| �� � q| j| j dkrx| j�| �� � q| j| j | jkr�q�q|�| � | j�� q|S )z�Parse a sequence of RFC 2822 phrases. A phrase is a sequence of words, which are in turn either RFC 2822 atoms or quoted-strings. Phrases are canonicalized by squeezing all runs of continuous whitespace into one space. r r< rK ) rA r' rF rC r) r` rG rL rE ra )rI rZ r r r rV � s zAddrlistClass.getphraselist)T)N)�__name__� __module__� __qualname__�__doc__rJ rO rR rP rY rX r] rd r` rL rc ra rV r r r r r? � s ; & % r? c @ sH e Zd ZdZdd� Zdd� Zdd� Zdd � Zd d � Zd d � Z dd� Z dS )� AddressListz@An AddressList encapsulates a list of parsed RFC 2822 addresses.c C s& t �| |� |r | �� | _ng | _d S �N)r? rJ rR � addresslistrH r r r rJ � s zAddressList.__init__c C s t | j�S rl )r' rm rf r r r �__len__ s zAddressList.__len__c C s> t d �}| jd d � |_|jD ]}|| jkr |j�|� q |S rl �rk rm r) �rI �otherZnewaddr�xr r r �__add__ s zAddressList.__add__c C s& |j D ]}|| j kr| j �|� q| S rl )rm r) �rI rq rr r r r �__iadd__ s zAddressList.__iadd__c C s. t d �}| jD ]}||jkr|j�|� q|S rl ro rp r r r �__sub__ s zAddressList.__sub__c C s& |j D ]}|| j kr| j �|� q| S rl )rm �removert r r r �__isub__ s zAddressList.__isub__c C s | j | S rl )rm )rI r+ r r r � __getitem__% s zAddressList.__getitem__N) rg rh ri rj rJ rn rs ru rv rx ry r r r r rk � s rk )rj �__all__r8 r: rW rM Z COMMASPACEr* r% r0 r r r r r r? rk r r r r �<module> sd � � � w / __pycache__/utils.cpython-38.opt-1.pyc 0000644 00000022510 15204103444 0013500 0 ustar 00 U e5d�4 � @ sj d Z ddddddddd d d d d ddgZddlZddlZddlZddlZddlZddlZddlZ ddl m Z ddl m Z ddl mZ ddl mZmZmZ ddlmZ dZdZdZdZdZe�d�Ze�d �Zd d � Z d d � Z d7d"d�Z d#d� Z d$d%� Z d8d'd�Z!d9d(d�Z"d:d)d �Z#d*d� Z$d+d � Z%d,d� Z&d-d� Z'd;d.d�Z(e�d/ej)�Z*d0d� Z+d<d3d�Z,d=d5d6�Z-dS )>zMiscellaneous utilities.�collapse_rfc2231_value� decode_params�decode_rfc2231�encode_rfc2231� formataddr� formatdate�format_datetime� getaddresses� make_msgid� mktime_tz� parseaddr� parsedate� parsedate_tz�parsedate_to_datetime�unquote� N)�quote)� AddressList)r )r r � _parsedate_tz)�Charsetz, � z �'z[][\\()<>@,:;".]z[\\"]c C s* z| � � W dS tk r$ Y dS X dS )z8Return True if s contains surrogate-escaped binary data.FTN)�encode�UnicodeEncodeError)�s� r �#/usr/lib64/python3.8/email/utils.py�_has_surrogates3 s r c C s | � dd�}|�dd�S )N�utf-8�surrogateescape�replace)r �decode)�stringZoriginal_bytesr r r � _sanitize@ s r" r c C s� | \}}|� d� |r�z|� d� W n< tk r` t|t�rFt|�}|�|�}d||f Y S X d}t�|�rtd}t� d|�}d||||f S |S )a� The inverse of parseaddr(), this takes a 2-tuple of the form (realname, email_address) and returns the string value suitable for an RFC 2822 From, To or Cc header. If the first element of pair is false, then the second element is returned unmodified. The optional charset is the character set that is used to encode realname in case realname is not ASCII safe. Can be an instance of str or a Charset-like object which has a header_encode method. Default is 'utf-8'. �asciiz%s <%s>r �"z\\\g<0>z %s%s%s <%s>) r r � isinstance�strr Z header_encode� specialsre�search� escapesre�sub)Zpair�charset�nameZaddressZ encoded_nameZquotesr r r r L s c C s t �| �}t|�}|jS )z7Return a list of (REALNAME, EMAIL) for each fieldvalue.)� COMMASPACE�join� _AddressList� addresslist)Z fieldvalues�all�ar r r r n s c C sf ddddddddg| d | d d d d dddddddddg | d d | d | d | d | d |f S ) Nz"%s, %02d %s %04d %02d:%02d:%02d %sZMonZTueZWedZThuZFriZSatZSun� � ZJanZFebZMarZAprZMayZJunZJulZAugZSepZOctZNovZDec� r � � � r )� timetuple�zoner r r �_format_timetuple_and_zoneu s& � � �r; Fc C sR | dkrt � � } |s|r,tj�| tjj�}n tj�| �}|rH|�� }d}t||�S )a� Returns a date string as specified by RFC 2822, e.g.: Fri, 09 Nov 2001 01:08:47 -0000 Optional timeval if given is a floating point time value as accepted by gmtime() and localtime(), otherwise the current time is used. Optional localtime is a flag that when True, interprets timeval, and returns a date relative to the local timezone instead of UTC, properly taking daylight savings time into account. Optional argument usegmt means that the timezone is written out as an ascii string, not numeric one (so "GMT" instead of "+0000"). This is needed for HTTP, and is only used when localtime==False. NF)�time�datetimeZ fromtimestamp�timezone�utcZutcfromtimestamp� astimezoner )�timeval� localtime�usegmt�dtr r r r ~ s c C sV | � � }|r2| jdks$| jtjjkr,td��d}n| jdkrBd}n | �d�}t||�S )a$ Turn a datetime into a date string as specified in RFC 2822. If usegmt is True, dt must be an aware datetime with an offset of zero. In this case 'GMT' will be rendered instead of the normal +0000 required by RFC2822. This is to support HTTP headers involving date stamps. Nz%usegmt option requires a UTC datetimeZGMTz-0000z%z)r9 �tzinfor= r> r? � ValueError�strftimer; )rD rC �nowr: r r r r � s c C s^ t t�� d �}t�� }t�d�}| dkr0d} nd| } |dkrHt�� }d|||| |f }|S )a{ Returns a string suitable for RFC 2822 compliant Message-ID, e.g: <142480216486.20800.16526388040877946887@nightshade.la.mastaler.com> Optional idstring if given is a string used to strengthen the uniqueness of the message id. Optional domain if given provides the portion of the message id after the '@'. It defaults to the locally defined hostname. �d �@ Nr �.z<%d.%d.%d%s@%s>)�intr< �os�getpid�randomZ getrandbits�socketZgetfqdn)ZidstringZdomainrA �pidZrandintZmsgidr r r r � s c C sN t | ��^ }}|d kr(tj|d d� � S tj|d d� dt�tj|d��i�S )Nr3 rE ��seconds)r r= r> � timedelta)�dataZdtuple�tzr r r r � s �c C s t | �j}|sdS |d S )z� Parse addr into its constituent realname and email address parts. Return a tuple of realname and email address, unless the parse fails, in which case return a 2-tuple of ('', ''). )r r r )r/ r0 )ZaddrZaddrsr r r r � s c C s` t | �dkr\| �d�r<| �d�r<| dd� �dd��dd�S | �d�r\| �d�r\| dd� S | S ) z Remove quotes from a string.r5 r$ ���z\\�\z\"�<�>)�len� startswith�endswithr )r& r r r r � s c C s& | � td�}t|�dkr"dd| fS |S )z#Decode string according to RFC 2231r4 N)�split�TICKr[ )r �partsr r r r � s c C sD t jj| d|pdd�} |dkr*|dkr*| S |dkr6d}d||| f S )z�Encode string according to RFC 2231. If neither charset nor language is given, then s is returned as-is. If charset is given but not language, the string is encoded using the empty string for language. r r# )Zsafe�encodingNz%s'%s'%s)�urllib�parser )r r+ �languager r r r � s z&^(?P<name>\w+)\*((?P<num>[0-9]+)\*?)?$c C sl | dd� } g }i }| � d�\}}|�||f� | r�| � d�\}}|�d�rRd}nd}t|�}t�|�}|r�|�dd�\}}|dk r�t|�}|�|g ��|||f� q0|�|dt |� f� q0|�rh|� � D ]�\}}g }d} |� � |D ].\}} }|�r t j j| d d �} d} |�| � q�t t�|��}| �rTt|�\} } }|�|| | d| ff� q�|�|d| f� q�|S ) zDecode parameters list according to RFC 2231. params is a sequence of 2-tuples containing (param name, string value). Nr �*TFr, �numz"%s"zlatin-1)ra )�pop�appendr] r �rfc2231_continuation�match�grouprL � setdefaultr �items�sortrb rc � EMPTYSTRINGr. r ) ZparamsZ new_paramsZrfc2231_paramsr, �valueZencodedZmorf Z continuationsZextendedr r+ rd r r r r sD r �us-asciic C sn t | t�rt| �dkr t| �S | \}}}|d kr4|}t|d�}zt|||�W S tk rh t|� Y S X d S )Nr6 zraw-unicode-escape)r% �tupler[ r �bytesr& � LookupError)rp �errorsZfallback_charsetr+ rd �textZrawbytesr r r r 9 s rW c C s | dkr t j �t jj��� S | jdk r.| �� S | �� dd� |f }t�|�}t� |�}z t j |j d�}t �||j �}W n� t k r� | t j t�|�dd� � }tjo�|jdk}|r�tjntj }|t j |d�kr�t �|tj| �}n t �|�}Y nX | j|d�S )a� Return local time as an aware datetime object. If called without arguments, return current time. Otherwise *dt* argument should be a datetime instance, and it is converted to the local time zone according to the system time zone database. If *dt* is naive (that is, dt.tzinfo is None), it is assumed to be in local time. In this case, a positive or zero value for *isdst* causes localtime to presume initially that summer time (for example, Daylight Saving Time) is or is not (respectively) in effect for the specified time. A negative value for *isdst* causes the localtime() function to attempt to divine whether summer time is in effect for the specified time. NrW rR r3 r )rE )r= rH r> r? r@ rE r9 r< �mktimerB rT � tm_gmtoff�tm_zone�AttributeError�gmtime�daylight�tm_isdst�altzone�tznamer ) rD ZisdstZtmrS ZlocaltmZdeltarV ZdstZgmtoffr r r rB S s$ rB )r )NFF)F)NN)NN)r rq )NrW ).�__doc__�__all__rM �rer< rO rP r= Z urllib.parserb Zemail._parseaddrr r r/ r r r r Z email.charsetr r- ro Z UEMPTYSTRINGZCRLFr_ �compiler' r) r r" r r r; r r r r r r r r �ASCIIri r r rB r r r r �<module> sp � " �8 � __pycache__/_encoded_words.cpython-38.opt-1.pyc 0000644 00000013070 15204103444 0015317 0 ustar 00 U e5dL! � @ s� d Z ddlZddlZddlZddlZddlmZmZ ddlm Z ddddd d d d gZ e� e� d �j dd� �Zdd� ZG dd� de�Ze� Zdeed�< dd� Zdd � Zdd� Zdd� Zdd � Zeed�Zdd � Zeed�Zeed�Z d d d �Z dS ) z� Routines for manipulating RFC2047 encoded words. This is currently a package-private API, but will be considered for promotion to a public API if there is demand. � N)� ascii_letters�digits)�errors�decode_q�encode_q�decode_b�encode_b�len_q�len_b�decode�encodes =([a-fA-F0-9]{2})c C s t �| �d��� �S )N� )�bytes�fromhex�groupr )�m� r �,/usr/lib64/python3.8/email/_encoded_words.py�<lambda>A � r c C s | � dd�} t| �g fS )N� _� )�replace�_q_byte_subber)�encodedr r r r C s c @ s, e Zd Zde�d� e�d� Zdd� ZdS )� _QByteMaps -!*+/�asciic C s. || j krt|�| |< nd�|�| |< | | S )Nz={:02X})�safe�chr�format)�self�keyr r r � __missing__M s z_QByteMap.__missing__N)�__name__� __module__� __qualname__r r r r r" r r r r r I s r �_� c C s d� dd� | D ��S )N� c s s | ]}t | V qd S �N)� _q_byte_map��.0�xr r r � <genexpr>Z s zencode_q.<locals>.<genexpr>)�join��bstringr r r r Y s c C s t dd� | D ��S )Nc s s | ]}t t| �V qd S r) )�lenr* r+ r r r r. ] s zlen_q.<locals>.<genexpr>)�sumr0 r r r r \ s c C s� t | �d }|r dd d| � nd}z&tj| | dd�|rDt�� gng fW S tjk � r� z tj| dd�t�� gfW Y S tjk r� z,tj| d dd�t�� t�� gfW Y Y S tjk r� | t�� gf Y Y Y S X Y nX Y nX d S )N� s ===r T)ZvalidateFs ==) r2 �base64Z b64decoder ZInvalidBase64PaddingDefect�binascii�ErrorZ InvalidBase64CharactersDefectZInvalidBase64LengthDefect)r Zpad_errZmissing_paddingr r r r d s( � � ��c C s t �| ��d�S )Nr )r5 Z b64encoder r0 r r r r � s c C s& t t| �d�\}}|d |r dnd S )N� r4 r )�divmodr2 )r1 Z groups_of_3Zleftoverr r r r � s )�q�bc C s� | � d�\}}}}}|�d�\}}}|�� }|�dd�}t| |�\}}z|�|�}W nv tk r� |�t� d� |��� |�|d�}Y nB t k r� |�dd�}|�� dkr�|�t� d� |��� Y nX ||||fS )a� Decode encoded word and return (string, charset, lang, defects) tuple. An RFC 2047/2243 encoded word has the form: =?charset*lang?cte?encoded_string?= where '*lang' may be omitted but the other parts may not be. This function expects exactly such a string (that is, it does not check the syntax and may raise errors if the string is not well formed), and returns the encoded_string decoded first from its Content Transfer Encoding and then from the resulting bytes into unicode using the specified charset. If the cte-decoded string does not successfully decode using the specified character set, a defect is added to the defects list and the unknown octets are replaced by the unicode 'unknown' character \uFDFF. The specified charset and language are returned. The default for language, which is rarely if ever encountered, is the empty string. �?�*r �surrogateescapez:Encoded word contains bytes not decodable using {} charset� unknown-8bitz<Unknown charset {} in encoded word; decoded as unknown bytes) �split� partition�lowerr � _cte_decodersr � UnicodeError�appendr ZUndecodableBytesDefectr � LookupErrorZ CharsetError) Zewr& �charsetZcteZ cte_string�langr1 Zdefects�stringr r r r � s& � ��utf-8r( c C s| |dkr| � dd�}n | � |�}|dkrTtd |�}td |�}|| dk rPdnd}t| |�}|rld| }d �||||�S ) a Encode string using the CTE encoding that produces the shorter result. Produces an RFC 2047/2243 encoded word of the form: =?charset*lang?cte?encoded_string?= where '*lang' is omitted unless the 'lang' parameter is given a value. Optional argument charset (defaults to utf-8) specifies the charset to use to encode the string to binary before CTE encoding it. Optional argument 'encoding' is the cte specifier for the encoding that should be used ('q' or 'b'); if it is None (the default) the encoding which produces the shortest encoded sequence is used, except that 'q' is preferred if it is up to five characters longer. Optional argument 'lang' (default '') gives the RFC 2243 language string to specify in the encoded word. r? r r> Nr: r; � r= z=?{}{}?{}?{}?=)r �_cte_encode_length� _cte_encodersr )rI rG �encodingrH r1 ZqlenZblenr r r r r � s )rJ Nr( ) �__doc__�rer5 r6 � functoolsrI r r Zemailr �__all__�partial�compile�subr r �dictr r* �ordr r r r r rC r rM rL r r r r r �<module> sL ) �� &�+�� __pycache__/charset.cpython-38.opt-1.pyc 0000644 00000026240 15204103444 0013775 0 ustar 00 U e5d�B � @ sr d dddgZ ddlmZ ddlZddlZddlmZ ddlmZ d Z d Z d Z d Z d Z dZdZe e dfe e dfe e dfe e dfe e dfe e dfe e dfe e dfe e dfe e dfe e dfe e dfde e dfe e dfe ddfe ddfe ddfe e dfe e dfd�Zddddddddddddddddd d d d d d d d d!�Zd"d#dd$�Zd+d%d�Zd&d� Zd'd� Zd(d)� ZG d*d � d �ZdS ),�Charset� add_alias� add_charset� add_codec� )�partialN)�errors)�encode_7or8bit� � � � �us-asciiz unknown-8bit� )NNN� iso-2022-jp�utf-8)� iso-8859-1� iso-8859-2� iso-8859-3� iso-8859-4� iso-8859-9� iso-8859-10� iso-8859-13� iso-8859-14� iso-8859-15� iso-8859-16z windows-1252Zvisciir �big5�gb2312�euc-jp� shift_jisr zkoi8-rr r r r r r r r r r r zks_c_5601-1987r zeuc-kr)�latin_1zlatin-1Zlatin_2zlatin-2Zlatin_3zlatin-3Zlatin_4zlatin-4Zlatin_5zlatin-5Zlatin_6zlatin-6Zlatin_7zlatin-7Zlatin_8zlatin-8Zlatin_9zlatin-9Zlatin_10zlatin-10�cp949�euc_jp�euc_kr�ascii� eucgb2312_cn�big5_tw)r r r c C s" |t krtd��|||ft| < dS )a> Add character set properties to the global registry. charset is the input character set, and must be the canonical name of a character set. Optional header_enc and body_enc is either Charset.QP for quoted-printable, Charset.BASE64 for base64 encoding, Charset.SHORTEST for the shortest of qp or base64 encoding, or None for no encoding. SHORTEST is only valid for header_enc. It describes how message headers and message bodies in the input charset are to be encoded. Default is no encoding. Optional output_charset is the character set that the output should be in. Conversions will proceed from input charset, to Unicode, to the output charset when the method Charset.convert() is called. The default is to output in the same character set as the input. Both input_charset and output_charset must have Unicode codec entries in the module's charset-to-codec mapping; use add_codec(charset, codecname) to add codecs the module does not know about. See the codecs module's documentation for more information. z!SHORTEST not allowed for body_encN)�SHORTEST� ValueError�CHARSETS)�charsetZ header_encZbody_enc�output_charset� r+ �%/usr/lib64/python3.8/email/charset.pyr m s c C s |t | < dS )z�Add a character set alias. alias is the alias name, e.g. latin-1 canonical is the character set's canonical name, e.g. iso-8859-1 N)�ALIASES)�aliasZ canonicalr+ r+ r, r � s c C s |t | < dS )a$ Add a codec that map characters in the given charset to/from Unicode. charset is the canonical name of a character set. codecname is the name of a Python codec, as appropriate for the second argument to the unicode() built-in, or to the encode() method of a Unicode string. N)� CODEC_MAP)r) Z codecnamer+ r+ r, r � s c C s" |t kr| �dd�S | �|�S d S )Nr# �surrogateescape)� UNKNOWN8BIT�encode)�string�codecr+ r+ r, �_encode� s r5 c @ s\ e Zd ZdZefdd�Zdd� Zdd� Zdd � Zd d � Z d d � Z dd� Z dd� Z dd� Z dS )r a@ Map character sets to their email properties. This class provides information about the requirements imposed on email for a specific character set. It also provides convenience routines for converting between character sets, given the availability of the applicable codecs. Given a character set, it will do its best to provide information on how to use that character set in an email in an RFC-compliant way. Certain character sets must be encoded with quoted-printable or base64 when used in email headers or bodies. Certain character sets must be converted outright, and are not allowed in email. Instances of this module expose the following information about a character set: input_charset: The initial character set specified. Common aliases are converted to their `official' email names (e.g. latin_1 is converted to iso-8859-1). Defaults to 7-bit us-ascii. header_encoding: If the character set must be encoded before it can be used in an email header, this attribute will be set to Charset.QP (for quoted-printable), Charset.BASE64 (for base64 encoding), or Charset.SHORTEST for the shortest of QP or BASE64 encoding. Otherwise, it will be None. body_encoding: Same as header_encoding, but describes the encoding for the mail message's body, which indeed may be different than the header encoding. Charset.SHORTEST is not allowed for body_encoding. output_charset: Some character sets must be converted before they can be used in email headers or bodies. If the input_charset is one of them, this attribute will contain the name of the charset output will be converted to. Otherwise, it will be None. input_codec: The name of the Python codec used to convert the input_charset to Unicode. If no conversion codec is necessary, this attribute will be None. output_codec: The name of the Python codec used to convert Unicode to the output_charset. If no conversion codec is necessary, this attribute will have the same value as the input_codec. c C s� z$t |t�r|�d� n t|d�}W n tk rB t�|��Y nX |�� }t�||�| _ t �| j t t d f�\}}}|s~| j }|| _ || _t�||�| _t�| j | j �| _t�| j| j�| _d S )Nr# )� isinstance�strr2 � UnicodeErrorr Z CharsetError�lowerr- �get� input_charsetr( r& �BASE64�header_encoding� body_encodingr* r/ Z input_codec� output_codec)�selfr; ZhencZbencZconvr+ r+ r, �__init__� s, � ��zCharset.__init__c C s | j �� S �N)r; r9 �r@ r+ r+ r, �__repr__� s zCharset.__repr__c C s t | �t |��� kS rB )r7 r9 )r@ �otherr+ r+ r, �__eq__� s zCharset.__eq__c C s$ | j tkrdS | j tkr dS tS dS )aP Return the content-transfer-encoding used for body encoding. This is either the string `quoted-printable' or `base64' depending on the encoding used, or it is a function in which case you should call the function with a single argument, the Message object being encoded. The function should then set the Content-Transfer-Encoding header itself to whatever is appropriate. Returns "quoted-printable" if self.body_encoding is QP. Returns "base64" if self.body_encoding is BASE64. Returns conversion function otherwise. zquoted-printable�base64N)r> �QPr< r rC r+ r+ r, �get_body_encoding� s zCharset.get_body_encodingc C s | j p | jS )z�Return the output character set. This is self.output_charset if that is not None, otherwise it is self.input_charset. )r* r; rC r+ r+ r, �get_output_charset s zCharset.get_output_charsetc C s6 | j pd}t||�}| �|�}|dkr*|S |�||�S )a� Header-encode a string by converting it first to bytes. The type of encoding (base64 or quoted-printable) will be based on this charset's `header_encoding`. :param string: A unicode string for the header. It must be possible to encode this string to bytes using the character set's output codec. :return: The encoded string, with RFC 2047 chrome. r N)r? r5 � _get_encoder� header_encode)r@ r3 r4 � header_bytes�encoder_moduler+ r+ r, rL s zCharset.header_encodec C s | j pd}t||�}| �|�}t|j|d�}| �� }t|�t }g } g } t|�| } |D ]�} | � | � t � | �} |� t| |��}|| krX| � � | s�| s�| � d� n.| r�dnd}t � | �}t||�}| � ||�� | g} t|�| } qXt � | �}t||�}| � ||�� | S )af Header-encode a string by converting it first to bytes. This is similar to `header_encode()` except that the string is fit into maximum line lengths as given by the argument. :param string: A unicode string for the header. It must be possible to encode this string to bytes using the character set's output codec. :param maxlengths: Maximum line length iterator. Each element returned from this iterator will provide the next maximum line length. This parameter is used as an argument to built-in next() and should never be exhausted. The maximum line lengths should not count the RFC 2047 chrome. These line lengths are only a hint; the splitter does the best it can. :return: Lines of encoded strings, each with RFC 2047 chrome. r )r) N� r )r? r5 rK r rL rJ �len�RFC2047_CHROME_LEN�next�append� EMPTYSTRING�join� header_length�pop)r@ r3 Z maxlengthsr4 rM rN �encoderr) Zextra�linesZ current_line�maxlen� characterZ this_lineZlengthZ separatorZ joined_liner+ r+ r, �header_encode_lines* s6 zCharset.header_encode_linesc C s` | j tkrtjS | j tkr tjS | j tkrXtj�|�}tj�|�}||k rPtjS tjS nd S d S rB )r= r< �email� base64mimerH � quoprimimer& rV )r@ rM Zlen64Zlenqpr+ r+ r, rK h s zCharset._get_encoderc C s� |s|S | j tkr4t|t�r(|�| j�}tj�|�S | j t krjt|t�rT|�| j�}|� d�}tj �|�S t|t�r�|�| j�� d�}|S dS )av Body-encode a string by converting it first to bytes. The type of encoding (base64 or quoted-printable) will be based on self.body_encoding. If body_encoding is None, we assume the output charset is a 7bit encoding, so re-encoding the decoded string using the ascii codec produces the correct string version of the content. �latin1r# N) r> r< r6 r7 r2 r* r] r^ � body_encoderH �decoder_ )r@ r3 r+ r+ r, ra w s zCharset.body_encodeN)�__name__� __module__� __qualname__�__doc__�DEFAULT_CHARSETrA rD rF rI rJ rL r\ rK ra r+ r+ r+ r, r � s + !>)NNN)�__all__� functoolsr Zemail.base64mimer] Zemail.quoprimimer Zemail.encodersr rH r< r& rQ rg r1 rT r( r- r/ r r r r5 r r+ r+ r+ r, �<module> s� � � � � __pycache__/parser.cpython-38.pyc 0000644 00000013134 15204103444 0012677 0 ustar 00 U e5d� � @ s� d Z ddddddgZddlmZmZ dd lmZmZ dd lm Z G d d� d�Z G d d� de �Z G d d� d�Z G dd� de �Z dS )z-A parser of RFC 2822 and MIME email messages.�Parser� HeaderParser� BytesParser�BytesHeaderParser� FeedParser�BytesFeedParser� )�StringIO� TextIOWrapper)r r )�compat32c @ s0 e Zd Zd ed�dd�Zd dd�Zd dd �ZdS ) r N��policyc C s || _ || _dS )a� 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 preceded 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. N)�_classr )�selfr r � r �$/usr/lib64/python3.8/email/parser.py�__init__ s zParser.__init__Fc C s@ t | j| jd�}|r |�� |�d�}|s,q8|�|� q |�� S )a\ 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. r i )r r r Z_set_headersonly�readZfeed�close)r �fp� headersonlyZ feedparser�datar r r �parse) s z Parser.parsec C s | j t|�|d�S )a- 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. �r )r r �r �textr r r r �parsestr; s zParser.parsestr)N)F)F)�__name__� __module__� __qualname__r r r r r r r r r s c @ s e Zd Zddd�Zddd�ZdS ) r Tc C s t �| |d�S �NT)r r �r r r r r r r H s zHeaderParser.parsec C s t �| |d�S r )r r r r r r r K s zHeaderParser.parsestrN)T)T)r r r r r r r r r r G s c @ s( e Zd Zdd� Zd dd�Zd dd�ZdS ) r c O s t ||�| _dS )a� 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 preceded 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. N)r �parser)r �args�kwr r r r Q s zBytesParser.__init__Fc C s0 t |ddd�}z| j�||�W �S |�� X dS )ac 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. �ascii�surrogateescape)�encoding�errorsN)r �detachr! r r r r r r c s zBytesParser.parsec C s |j ddd�}| j�||�S )a2 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. �ASCIIr% )r' )�decoder! r r r r r � parsebytesr s zBytesParser.parsebytesN)F)F)r r r r r r+ r r r r r O s c @ s e Zd Zddd�Zddd�ZdS ) r Tc C s t j| |dd�S �NTr )r r r r r r r s zBytesHeaderParser.parsec C s t j| |dd�S r, )r r+ r r r r r+ � s z BytesHeaderParser.parsebytesN)T)T)r r r r r+ r r r r r ~ s N)�__doc__�__all__�ior r Zemail.feedparserr r Zemail._policybaser r r r r r r r r �<module> s � 7/ __pycache__/_parseaddr.cpython-38.pyc 0000644 00000030266 15204103444 0013514 0 ustar 00 U e5dE � @ s� d Z ddddgZddlZddlZdZdZd Zd d d d dddddddddddddddd d d d d gZd!d"d#d$d%d&d'gZddddd(d)d*d(d+d*d,d+d-d,d.�Z d/d� Z d0d1� Z d2d� Z d3d� Z d4d� ZG d5d6� d6�ZG d7d8� d8e�ZdS )9zcEmail address parsing code. Lifted directly from rfc822.py. This should eventually be rewritten. � mktime_tz� parsedate� parsedate_tz�quote� N� � z, ZjanZfebZmarZaprZmayZjunZjulZaug�sep�octZnovZdecZjanuaryZfebruaryZmarchZaprilZjuneZjulyZaugustZ septemberZoctoberZnovemberZdecemberZmonZtueZwedZthuZfriZsatZsunip���i���i ���i����iD���i��)ZUTZUTCZGMT�ZZASTZADTZESTZEDTZCSTZCDTZMSTZMDTZPSTZPDTc C s, t | �}|sdS |d dkr$d|d< t|�S )zQConvert a date string to a time tuple. Accounts for military timezones. N� r )� _parsedate_tz�tuple)�data�res� r �(/usr/lib64/python3.8/email/_parseaddr.pyr - s c C s� | sdS | � � } | sdS | d �d�s6| d �� tkr>| d= n.| d �d�}|dkrl| d |d d� | d< t| �dkr�| d � d�}t|�dkr�|| dd� } t| �dk�r| d }|�d�}|d kr�|�d�}|dkr�|d|� ||d� g| dd�< n | �d � t| �d k �rdS | dd � } | \}}}}}|�� }|tk�rb||�� }}|tk�rbdS t� |�d }|d k�r�|d 8 }|d dk�r�|dd � }|�d �}|dk�r�|| }}|d dk�r�|dd � }|d � � �s�|| }}|d dk�r|dd � }|� d �}t|�dk�r,|\} } d} n~t|�dk�rF|\} } } ndt|�dk�r�d|d k�r�|d � d�}t|�dk�r�|\} } d} nt|�dk�r�|\} } } ndS z,t |�}t |�}t | �} t | �} t | �} W n t k �r� Y dS X |dk �r|dk�r|d7 }n|d7 }d} |� � }|tk�r6t| } n>z t |�} W n t k �rX Y nX | dk�rt|�d��rtd} | �r�| dk �r�d } | } nd} | | d d | d d } |||| | | ddd | g S )a� Convert date to extended time tuple. The last (additional) element is the time zone offset in seconds, except if the timezone was specified as -0000. In that case the last element is None. This indicates a UTC timestamp that explicitly declaims knowledge of the source timezone, as opposed to a +0000 timestamp that indicates the source timezone really was UTC. Nr �,� � �-� �+���r � � �:� �0�.�d �D il i� i �< )�split�endswith�lower� _daynames�rfind�len�find�append� _monthnames�index�isdigit�int� ValueError�upper� _timezones� startswith)r �iZstuff�sZddZmmZyyZtmZtzZthhZtmmZtssZtzoffsetZtzsignr r r r 9 s� " r c C s& t | �}t|t�r |dd� S |S dS )z&Convert a time string to a time tuple.Nr )r � isinstancer �r �tr r r r � s c C s< | d dkr"t �| dd� d �S t�| �}|| d S dS )zETurn a 10-tuple as returned by parsedate_tz() into a POSIX timestamp.r N� )r )�time�mktime�calendarZtimegmr5 r r r r � s c C s | � dd�� dd�S )z�Prepare string to be used in a quoted string. Turns backslash and double quote characters into quoted pairs. These are the only characters that need to be quoted inside a quoted string. Does not add the surrounding double quotes. �\z\\�"z\")�replace)�strr r r r � s c @ s| e Zd ZdZdd� Zdd� Zdd� Zdd � Zd d � Zd d � Z dd� Z d dd�Z dd� Z dd� Z dd� Zd dd�Zd d � ZdS ) � AddrlistClassa Address parser class by Ben Escoto. To understand what this class does, it helps to have a copy of RFC 2822 in front of you. Note: this class interface is deprecated and may be removed in the future. Use email.utils.AddressList instead. c C sZ d| _ d| _d| _d| _| j| j | _| j | j | j | _| j�dd�| _|| _g | _ dS )z�Initialize a new instance. `field' is an unparsed address header field, containing one or more addresses. z ()<>@,:;."[]r z z r r N) �specials�pos�LWSZCR�FWS�atomendsr= � phraseends�field� commentlist��selfrF r r r �__init__� s zAddrlistClass.__init__c C s� g }| j t| j�k r�| j| j | jd kr\| j| j dkrL|�| j| j � | j d7 _ q| j| j dkr�| j�| �� � qq�qt�|�S )z&Skip white space and extract comments.z r �() rA r' rF rB r) rG � getcomment� EMPTYSTRING�join)rI Zwslistr r r �gotonext� s zAddrlistClass.gotonextc C s: g }| j t| j�k r6| �� }|r*||7 }q|�d� q|S )zVParse all addresses. Returns a list containing all of the addresses. )r r )rA r' rF � getaddressr) )rI �resultZadr r r � getaddrlist� s zAddrlistClass.getaddrlistc C s� g | _ | �� | j}| j }| �� }| �� g }| jt| j�kr\|rXt�| j �|d fg}�n\| j| j dkr�|| _|| _ | �� }t�| j �|fg}�n"| j| j dk�r g }t| j�}| jd7 _| jt| j�k �r�| �� | j|k �r| j| j dk�r| jd7 _�q�|| � � }q�n�| j| j dk�rx| � � }| j �rft�|�d d�| j � d |fg}nt�|�|fg}n@|�r�t�| j �|d fg}n"| j| j | j k�r�| jd7 _| �� | jt| j�k �r�| j| j d k�r�| jd7 _|S ) zParse the next address.r z.@r r �;�<z (r �)r ) rG rO rA � getphraselistr' rF �SPACErN � getaddrspecrP � getrouteaddrr@ )rI ZoldposZoldcl�plistZ returnlistZaddrspecZfieldlenZ routeaddrr r r rP sX ���$zAddrlistClass.getaddressc C s� | j | j dkrdS d}| jd7 _| �� d}| jt| j �k r�|rT| �� d}n~| j | j dkrv| jd7 _q�n\| j | j dkr�| jd7 _d}n8| j | j d kr�| jd7 _n| �� }| jd7 _q�| �� q2|S ) z�Parse a route address (Return-path value). This method just skips all the route stuff and returns the addrspec. rT NFr r �>�@Tr )rF rA rO r' � getdomainrX )rI Z expectrouteZadlistr r r rY A s. zAddrlistClass.getrouteaddrc C sT g }| � � | jt| j�k r�d}| j| j dkrf|rH|d �� sH|�� |�d� | jd7 _d}nd| j| j dkr�|�dt| �� � � n<| j| j | j kr�|r�|d �� s�|�� q�n|�| � � � | � � }|r |r |�|� q | jt| j�k�s | j| j dk�rt � |�S |�d� | jd7 _| � � | � � }|�sFt S t � |�| S ) z Parse an RFC 2822 addr-spec.Tr r r Fr< z"%s"r\ )rO rA r' rF �strip�popr) r �getquoterD �getatomrM rN r] )rI ZaslistZ preserve_wsZwsZdomainr r r rX a s: $ zAddrlistClass.getaddrspecc C s� g }| j t| j�k r�| j| j | jkr6| j d7 _ q| j| j dkrX| j�| �� � q| j| j dkrx|�| �� � q| j| j dkr�| j d7 _ |�d� q| j| j dkr�tS | j| j | j kr�q�q|�| � � � qt� |�S )z-Get the complete domain name from an address.r rK �[r r\ ) rA r' rF rB rG r) rL �getdomainliteralrM rD ra rN )rI Zsdlistr r r r] � s" zAddrlistClass.getdomainTc C s� | j | j |krdS dg}d}| jd7 _| jt| j �k r�|rX|�| j | j � d}np| j | j |krz| jd7 _q�nN|r�| j | j dkr�|�| �� � q,n(| j | j dkr�d}n|�| j | j � | jd7 _q,t�|�S )a� Parse a header fragment delimited by special characters. `beginchar' is the start character for the fragment. If self is not looking at an instance of `beginchar' then getdelimited returns the empty string. `endchars' is a sequence of allowable end-delimiting characters. Parsing stops when one of these is encountered. If `allowcomments' is non-zero, embedded RFC 2822 comments are allowed within the parsed fragment. r Fr rK r; T)rF rA r' r) rL rM rN )rI Z begincharZendcharsZ allowcommentsZslistr r r r � getdelimited� s( zAddrlistClass.getdelimitedc C s | � ddd�S )z1Get a quote-delimited fragment from self's field.r< z" F�rd �rI r r r r` � s zAddrlistClass.getquotec C s | � ddd�S )z7Get a parenthesis-delimited fragment from self's field.rK z) Tre rf r r r rL � s zAddrlistClass.getcommentc C s d| � ddd� S )z!Parse an RFC 2822 domain-literal.z[%s]rb z] Fre rf r r r rc � s z AddrlistClass.getdomainliteralNc C sd dg}|dkr| j }| jt| j�k rZ| j| j |kr8qZn|�| j| j � | jd7 _qt�|�S )a Parse an RFC 2822 atom. Optional atomends specifies a different set of end token delimiters (the default is to use self.atomends). This is used e.g. in getphraselist() since phrase endings must not include the `.' (which is legal in phrases).r Nr )rD rA r' rF r) rM rN )rI rD Zatomlistr r r ra � s zAddrlistClass.getatomc C s� g }| j t| j�k r�| j| j | jkr6| j d7 _ q| j| j dkrV|�| �� � q| j| j dkrx| j�| �� � q| j| j | jkr�q�q|�| � | j�� q|S )z�Parse a sequence of RFC 2822 phrases. A phrase is a sequence of words, which are in turn either RFC 2822 atoms or quoted-strings. Phrases are canonicalized by squeezing all runs of continuous whitespace into one space. r r< rK ) rA r' rF rC r) r` rG rL rE ra )rI rZ r r r rV � s zAddrlistClass.getphraselist)T)N)�__name__� __module__� __qualname__�__doc__rJ rO rR rP rY rX r] rd r` rL rc ra rV r r r r r? � s ; & % r? c @ sH e Zd ZdZdd� Zdd� Zdd� Zdd � Zd d � Zd d � Z dd� Z dS )� AddressListz@An AddressList encapsulates a list of parsed RFC 2822 addresses.c C s& t �| |� |r | �� | _ng | _d S �N)r? rJ rR � addresslistrH r r r rJ � s zAddressList.__init__c C s t | j�S rl )r' rm rf r r r �__len__ s zAddressList.__len__c C s> t d �}| jd d � |_|jD ]}|| jkr |j�|� q |S rl �rk rm r) �rI �otherZnewaddr�xr r r �__add__ s zAddressList.__add__c C s& |j D ]}|| j kr| j �|� q| S rl )rm r) �rI rq rr r r r �__iadd__ s zAddressList.__iadd__c C s. t d �}| jD ]}||jkr|j�|� q|S rl ro rp r r r �__sub__ s zAddressList.__sub__c C s& |j D ]}|| j kr| j �|� q| S rl )rm �removert r r r �__isub__ s zAddressList.__isub__c C s | j | S rl )rm )rI r+ r r r � __getitem__% s zAddressList.__getitem__N) rg rh ri rj rJ rn rs ru rv rx ry r r r r rk � s rk )rj �__all__r8 r: rW rM Z COMMASPACEr* r% r0 r r r r r r? rk r r r r �<module> sd � � � w / __pycache__/_header_value_parser.cpython-38.opt-2.pyc 0000644 00000173047 15204103444 0016514 0 ustar 00 U e5dϡ � @ s� d dl Z d dlZd dlZd dlmZ d dlmZ d dlmZ d dlm Z d dlm Z e d�Z e e d�B Ze d �Zee B Zee d � Zee d � Zee d �B e d � Zee B Zee d �B Zee B Zee d� Zdd� Ze �de je jB �Z G dd� de �Z G dd� de �Z G dd� de �Z G dd� de �Z!G dd� de �Z"G d d � d e �Z#G d d � d e �Z$G d d!� d!e �Z%G d"d#� d#e �Z&G d$d%� d%e �Z'G d&d'� d'e'�Z(G d(d)� d)e �Z)G d*d+� d+e �Z*G d,d-� d-e �Z+G d.d/� d/e �Z,G d0d1� d1e �Z-G d2d3� d3e �Z.G d4d5� d5e �Z/G d6d7� d7e �Z0G d8d9� d9e �Z1G d:d;� d;e �Z2G d<d=� d=e �Z3G d>d?� d?e �Z4G d@dA� dAe �Z5G dBdC� dCe �Z6G dDdE� dEe �Z7G dFdG� dGe �Z8G dHdI� dIe �Z9G dJdK� dKe!�Z:G dLdM� dMe �Z;G dNdO� dOe �Z<G dPdQ� dQe �Z=G dRdS� dSe �Z>G dTdU� dUe>�Z?G dVdW� dWe �Z@G dXdY� dYe �ZAG dZd[� d[e �ZBG d\d]� d]e �ZCG d^d_� d_e �ZDG d`da� daeD�ZEG dbdc� dceD�ZFG ddde� dee �ZGG dfdg� dge �ZHG dhdi� die �ZIG djdk� dkeI�ZJG dldm� dmeJ�ZKG dndo� doe �ZLG dpdq� dqeM�ZNG drds� dseN�ZOG dtdu� dueN�ZPG dvdw� dweO�ZQG dxdy� dye jR�ZSePd dz�ZTePd{d|�ZUePd}d~�ZVe �d�Wd��Xe ���jYZZe �d��We �[d��Xe����j\Z]e �d��j^Z_e �d��We �[d��Xe����j\Z`e �d��We �[d��Xe����j\Zae �d��We �[d��Xe����j\Zbd�d�� Zcd�d�� Zdd�d�� Zed�d�� Zfd�d�� Zgd�d�� Zhd�d�� Zid�d�� Zjd�d�� Zkd�d�� Zld�d�� Zmd�d�� Znd�d�� Zod�d�� Zpd�d�� Zqd�d�� Zrd�d�� Zsd�d�� Ztd�d�� Zud�d�� Zvd�d�� Zwd�d�� Zxd�d�� Zyd�d�� Zzd�d�� Z{d�d�� Z|d�d�� Z}d�d�� Z~d�d�� Zd�d�� Z�d�d�� Z�d�d Z�d�dĄ Z�d�dƄ Z�d�dȄ Z�d�dʄ Z�d�d̄ Z�d�d΄ Z�d�dЄ Z�d�d҄ Z�d�dԄ Z�d�dք Z�d�d Z�d�dڄ Z�d�d܄ Z�d�dބ Z�d�d� Z�d�d� Z�d�d� Z�d�d� Z�d�d� Z�d�d� Z�d�d� Z�d�d� Z�d�d� Z�d�d� Z�d�d� Z�d�d�� Z�dS )�� N)� hexdigits)� itemgetter)�_encoded_words)�errors)�utilsz �(z ()<>@,:;.\"[]�.z."(z/?=z*'%�%c C s dt | ��dd��dd� d S )N�"�\�\\z\")�str�replace��value� r �2/usr/lib64/python3.8/email/_header_value_parser.py� quote_string` s r z� =\? # literal =? [^?]* # charset \? # literal ? [qQbB] # literal 'q' or 'b', case insensitive \? # literal ? .*? # encoded word \?= # literal ?= c s� e Zd ZdZdZdZ� fdd�Zdd� Z� fdd�Ze d d � �Z e d d � �Z d d� Z e dd� �Z e dd� �Zdd� Zd dd�Zd dd�Zd dd�Z� ZS ) � TokenListNTc s t � j||� g | _d S �N)�super�__init__�defects)�self�args�kw�� __class__r r r y s zTokenList.__init__c C s d� dd� | D ��S )N� c s s | ]}t |�V qd S r �r ��.0�xr r r � <genexpr>~ s z$TokenList.__str__.<locals>.<genexpr>��join�r r r r �__str__} s zTokenList.__str__c s d� | jjt� �� �S �Nz{}({})��formatr �__name__r �__repr__r& r r r r, � s �zTokenList.__repr__c C s d� dd� | D ��S )Nr c s s | ]}|j r|j V qd S r r r r r r r# � s z"TokenList.value.<locals>.<genexpr>r$ r& r r r r � s zTokenList.valuec C s t dd� | D �| j�S )Nc s s | ] }|j V qd S r )� all_defectsr r r r r# � s z(TokenList.all_defects.<locals>.<genexpr>)�sumr r& r r r r- � s zTokenList.all_defectsc C s | d � � S �Nr )�startswith_fwsr& r r r r0 � s zTokenList.startswith_fwsc C s t dd� | D ��S )Nc s s | ] }|j V qd S r )� as_ew_allowed)r! �partr r r r# � s z*TokenList.as_ew_allowed.<locals>.<genexpr>)�allr& r r r r1 � s zTokenList.as_ew_allowedc C s g }| D ]}|� |j� q|S r )�extend�comments)r r5 �tokenr r r r5 � s zTokenList.commentsc C s t | |d�S )N��policy)�_refold_parse_tree�r r8 r r r �fold� s zTokenList.foldr c C s t | j|d�� d S )N��indent)�print�ppstr�r r= r r r �pprint� s zTokenList.pprintc C s d� | j|d��S )N� r< )r% �_ppr@ r r r r? � s zTokenList.ppstrc c sz d� || jj| j�V | D ]4}t|d�s:|d� |� V q|�|d �E d H q| jrdd� | j�}nd}d� ||�V d S )Nz{}{}/{}(rC z* !! invalid element in token list: {!r}z z Defects: {}r z{}){})r* r r+ � token_type�hasattrrC r )r r= r6 Zextrar r r rC � s � � z TokenList._pp)r )r )r )r+ � __module__� __qualname__rD �syntactic_break�ew_combine_allowedr r' r, �propertyr r- r0 r1 r5 r; rA r? rC � __classcell__r r r r r s s& r c @ s$ e Zd Zedd� �Zedd� �ZdS )�WhiteSpaceTokenListc C s dS �N� r r& r r r r � s zWhiteSpaceTokenList.valuec C s dd� | D �S )Nc S s g | ]}|j d kr|j�qS )�comment)rD �contentr r r r � <listcomp>� s z0WhiteSpaceTokenList.comments.<locals>.<listcomp>r r& r r r r5 � s z WhiteSpaceTokenList.commentsN)r+ rF rG rJ r r5 r r r r rL � s rL c @ s e Zd ZdZdS )�UnstructuredTokenList� unstructuredN�r+ rF rG rD r r r r rR � s rR c @ s e Zd ZdZdS )�Phrase�phraseNrT r r r r rU � s rU c @ s e Zd ZdZdS )�WordZwordNrT r r r r rW � s rW c @ s e Zd ZdZdS )�CFWSList�cfwsNrT r r r r rX � s rX c @ s e Zd ZdZdS )�Atom�atomNrT r r r r rZ � s rZ c @ s e Zd ZdZdZdS )�Tokenr6 FN)r+ rF rG rD Z encode_as_ewr r r r r\ � s r\ c @ s e Zd ZdZdZdZdZdS )� EncodedWord� encoded-wordN)r+ rF rG rD �cte�charset�langr r r r r] � s r] c @ s4 e Zd ZdZedd� �Zedd� �Zedd� �ZdS ) � QuotedString� quoted-stringc C s" | D ]}|j dkr|j S qd S �N�bare-quoted-string�rD r �r r" r r r rP � s zQuotedString.contentc C s> g }| D ]*}|j dkr&|�t|�� q|�|j� qd�|�S )Nre r )rD �appendr r r% )r �resr" r r r � quoted_value� s zQuotedString.quoted_valuec C s" | D ]}|j dkr|j S qd S rd rf �r r6 r r r �stripped_value� s zQuotedString.stripped_valueN)r+ rF rG rD rJ rP rj rl r r r r rb � s rb c @ s$ e Zd ZdZdd� Zedd� �ZdS )�BareQuotedStringre c C s t d�dd� | D ���S )Nr c s s | ]}t |�V qd S r r r r r r r# s z+BareQuotedString.__str__.<locals>.<genexpr>)r r% r& r r r r' � s zBareQuotedString.__str__c C s d� dd� | D ��S )Nr c s s | ]}t |�V qd S r r r r r r r# s z)BareQuotedString.value.<locals>.<genexpr>r$ r& r r r r s zBareQuotedString.valueN)r+ rF rG rD r' rJ r r r r r rm � s rm c @ s8 e Zd ZdZdd� Zdd� Zedd� �Zedd � �Zd S ) �CommentrO c s( d� tdg� fdd�� D �dggg ��S )Nr r c s g | ]}� � |��qS r )�quoter r& r r rQ s z#Comment.__str__.<locals>.<listcomp>�))r% r. r& r r& r r' s ��zComment.__str__c C s2 |j dkrt|�S t|��dd��dd��dd�S )NrO r r r z\(rp z\))rD r r )r r r r r ro s � �z Comment.quotec C s d� dd� | D ��S )Nr c s s | ]}t |�V qd S r r r r r r r# s z"Comment.content.<locals>.<genexpr>r$ r& r r r rP s zComment.contentc C s | j gS r )rP r& r r r r5 s zComment.commentsN) r+ rF rG rD r' ro rJ rP r5 r r r r rn s rn c @ s4 e Zd ZdZedd� �Zedd� �Zedd� �ZdS ) � AddressListz address-listc C s dd� | D �S )Nc S s g | ]}|j d kr|�qS )�address�rD r r r r rQ ' s z)AddressList.addresses.<locals>.<listcomp>r r& r r r � addresses% s zAddressList.addressesc C s t dd� | D �g �S )Nc s s | ]}|j d kr|jV qdS �rr N�rD � mailboxesr r r r r# + s �z(AddressList.mailboxes.<locals>.<genexpr>�r. r& r r r rw ) s ��zAddressList.mailboxesc C s t dd� | D �g �S )Nc s s | ]}|j d kr|jV qdS ru �rD � all_mailboxesr r r r r# 0 s �z,AddressList.all_mailboxes.<locals>.<genexpr>rx r& r r r rz . s ��zAddressList.all_mailboxesN)r+ rF rG rD rJ rt rw rz r r r r rq ! s rq c @ s4 e Zd ZdZedd� �Zedd� �Zedd� �ZdS ) �Addressrr c C s | d j dkr| d jS d S )Nr �group�rD � display_namer& r r r r~ 8 s zAddress.display_namec C s4 | d j dkr| d gS | d j dkr*g S | d jS �Nr �mailbox�invalid-mailboxrv r& r r r rw = s zAddress.mailboxesc C s: | d j dkr| d gS | d j dkr0| d gS | d jS r ry r& r r r rz E s zAddress.all_mailboxesN)r+ rF rG rD rJ r~ rw rz r r r r r{ 4 s r{ c @ s( e Zd ZdZedd� �Zedd� �ZdS )� MailboxList� mailbox-listc C s dd� | D �S )Nc S s g | ]}|j d kr|�qS )r� rs r r r r rQ S s z)MailboxList.mailboxes.<locals>.<listcomp>r r& r r r rw Q s zMailboxList.mailboxesc C s dd� | D �S )Nc S s g | ]}|j d kr|�qS ))r� r� rs r r r r rQ W s �z-MailboxList.all_mailboxes.<locals>.<listcomp>r r& r r r rz U s zMailboxList.all_mailboxesN�r+ rF rG rD rJ rw rz r r r r r� M s r� c @ s( e Zd ZdZedd� �Zedd� �ZdS )� GroupList� group-listc C s | r| d j dkrg S | d jS �Nr r� rv r& r r r rw _ s zGroupList.mailboxesc C s | r| d j dkrg S | d jS r� ry r& r r r rz e s zGroupList.all_mailboxesNr� r r r r r� [ s r� c @ s4 e Zd ZdZedd� �Zedd� �Zedd� �ZdS ) �Groupr| c C s | d j dkrg S | d jS �N� r� rv r& r r r rw p s zGroup.mailboxesc C s | d j dkrg S | d jS r� ry r& r r r rz v s zGroup.all_mailboxesc C s | d j S r/ )r~ r& r r r r~ | s zGroup.display_nameN)r+ rF rG rD rJ rw rz r~ r r r r r� l s r� c @ sL e Zd ZdZedd� �Zedd� �Zedd� �Zedd � �Zed d � �Z d S ) �NameAddr� name-addrc C s t | �dkrd S | d jS �N� r )�lenr~ r& r r r r~ � s zNameAddr.display_namec C s | d j S �N����� local_partr& r r r r� � s zNameAddr.local_partc C s | d j S r� ��domainr& r r r r� � s zNameAddr.domainc C s | d j S r� )�router& r r r r� � s zNameAddr.routec C s | d j S r� �� addr_specr& r r r r� � s zNameAddr.addr_specN� r+ rF rG rD rJ r~ r� r� r� r� r r r r r� � s r� c @ s@ e Zd ZdZedd� �Zedd� �Zedd� �Zedd � �Zd S ) � AngleAddrz angle-addrc C s" | D ]}|j dkr|j S qd S �N� addr-spec)rD r� rg r r r r� � s zAngleAddr.local_partc C s" | D ]}|j dkr|j S qd S r� �rD r� rg r r r r� � s zAngleAddr.domainc C s" | D ]}|j dkr|j S qd S )N� obs-route)rD �domainsrg r r r r� � s zAngleAddr.routec C s< | D ]2}|j dkr|jr"|j S t|j�|j S qdS )Nr� z<>)rD r� r� r rg r r r r� � s zAngleAddr.addr_specN) r+ rF rG rD rJ r� r� r� r� r r r r r� � s r� c @ s e Zd ZdZedd� �ZdS )�ObsRouter� c C s dd� | D �S )Nc S s g | ]}|j d kr|j�qS r� r� r r r r rQ � s z$ObsRoute.domains.<locals>.<listcomp>r r& r r r r� � s zObsRoute.domainsN)r+ rF rG rD rJ r� r r r r r� � s r� c @ sL e Zd ZdZedd� �Zedd� �Zedd� �Zedd � �Zed d � �Z d S ) �Mailboxr� c C s | d j dkr| d jS d S �Nr r� r} r& r r r r~ � s zMailbox.display_namec C s | d j S r/ r� r& r r r r� � s zMailbox.local_partc C s | d j S r/ r� r& r r r r� � s zMailbox.domainc C s | d j dkr| d jS d S r� )rD r� r& r r r r� � s z Mailbox.routec C s | d j S r/ r� r& r r r r� � s zMailbox.addr_specNr� r r r r r� � s r� c @ s, e Zd ZdZedd� �Ze Z Z ZZ dS )�InvalidMailboxr� c C s d S r r r& r r r r~ � s zInvalidMailbox.display_nameNr� r r r r r� � s r� c s( e Zd ZdZdZe� fdd��Z� ZS )�Domainr� Fc s d� t� j�� �S �Nr �r% r r �splitr& r r r r� � s z Domain.domain)r+ rF rG rD r1 rJ r� rK r r r r r� � s r� c @ s e Zd ZdZdS )�DotAtom�dot-atomNrT r r r r r� � s r� c @ s e Zd ZdZdZdS )� DotAtomTextz dot-atom-textTN�r+ rF rG rD r1 r r r r r� � s r� c @ s e Zd ZdZdZdS )� NoFoldLiteralzno-fold-literalFNr� r r r r r� s r� c @ sD e Zd ZdZdZedd� �Zedd� �Zedd� �Zed d � �Z d S ) �AddrSpecr� Fc C s | d j S r/ r� r& r r r r� s zAddrSpec.local_partc C s t | �dk rd S | d jS )N� r� )r� r� r& r r r r� s zAddrSpec.domainc C s< t | �dk r| d jS | d j�� | d j | d j�� S )Nr� r r� r� )r� r �rstrip�lstripr& r r r r s zAddrSpec.valuec C sL t | j�}t|�t|t �kr*t| j�}n| j}| jd k rH|d | j S |S )N�@)�setr� r� � DOT_ATOM_ENDSr r� )r ZnamesetZlpr r r r� s zAddrSpec.addr_specN) r+ rF rG rD r1 rJ r� r� r r� r r r r r� s r� c @ s e Zd ZdZdZdS )� ObsLocalPartzobs-local-partFNr� r r r r r� & s r� c s4 e Zd ZdZdZedd� �Ze� fdd��Z� ZS )� DisplayNamez display-nameFc C s� t | �}t|�dkr|jS |d jdkr4|�d� n*|d d jdkr^t |d dd � �|d< |d jdkrv|�� n*|d d jdkr�t |d d d� �|d< |jS )Nr rY r� r� )r r� r rD �pop)r ri r r r r~ 1 s zDisplayName.display_namec s� d}| j rd}n| D ]}|jdkrd}qt| �dkr�|r�d }}| d jdks`| d d jdkrdd}| d jdks�| d d jdkr�d}|t| j� | S t� jS d S ) NFTrc r r rY rN r� )r rD r� r r~ r r )r ro r" ZpreZpostr r r r B s zDisplayName.value) r+ rF rG rD rI rJ r~ r rK r r r r r� , s r� c @ s, e Zd ZdZdZedd� �Zedd� �ZdS )� LocalPartz local-partFc C s& | d j dkr| d jS | d jS d S )Nr rc )rD rj r r& r r r r [ s zLocalPart.valuec C s� t g}t }d}| d t g D ]�}|jdkr,q |r\|jdkr\|d jdkr\t|d d� �|d< t|t�}|r�|jdkr�|d jdkr�|�t|dd � �� n |�|� |d }|}q t|dd� �}|jS )NFr rY �dotr� r� )�DOTrD r � isinstancerh r )r ri ZlastZ last_is_tl�tokZis_tlr r r r� b s( � � zLocalPart.local_partN)r+ rF rG rD r1 rJ r r� r r r r r� V s r� c s4 e Zd ZdZdZe� fdd��Zedd� �Z� ZS )� DomainLiteralzdomain-literalFc s d� t� j�� �S r� r� r& r r r r� s zDomainLiteral.domainc C s" | D ]}|j dkr|j S qd S )N�ptextrf rg r r r �ip� s zDomainLiteral.ip) r+ rF rG rD r1 rJ r� r� rK r r r r r� z s r� c @ s e Zd ZdZdZdZdS )� MIMEVersionz mime-versionN)r+ rF rG rD �major�minorr r r r r� � s r� c @ s4 e Zd ZdZdZdZdZedd� �Zedd� �Z dS ) � Parameter� parameterF�us-asciic C s | j r| d jS dS r� )� sectioned�numberr& r r r �section_number� s zParameter.section_numberc C sf | D ]\}|j dkr |j S |j dkr|D ]4}|j dkr*|D ] }|j dkr<|j S q<q*qdS )Nr rc re r )rD rl rk r r r � param_value� s zParameter.param_valueN) r+ rF rG rD r� �extendedr` rJ r� r� r r r r r� � s r� c @ s e Zd ZdZdS )�InvalidParameter�invalid-parameterNrT r r r r r� � s r� c @ s e Zd ZdZedd� �ZdS )� Attribute� attributec C s$ | D ]}|j �d�r|j S qd S )N�attrtext)rD �endswithr rk r r r rl � s zAttribute.stripped_valueN�r+ rF rG rD rJ rl r r r r r� � s r� c @ s e Zd ZdZdZdS )�Section�sectionN)r+ rF rG rD r� r r r r r� � s r� c @ s e Zd ZdZedd� �ZdS )�Valuer c C s2 | d }|j dkr| d }|j �d�r,|jS | jS )Nr rY r� )rc r� zextended-attribute)rD r� rl r rk r r r rl � s �zValue.stripped_valueNr� r r r r r� � s r� c @ s( e Zd ZdZdZedd� �Zdd� ZdS )�MimeParameters�mime-parametersFc c s� i }| D ]T}|j �d�sq|d j dkr*q|d j�� }||krHg ||< || �|j|f� q|�� D �]~\}}t|td�d�}|d d }|j }|j s�t |�dkr�|d d dkr�|d d j �t �d�� |d d� }g }d}|D ]�\} } | |k�r(| j �s| j �t �d�� q�n| j �t �d�� |d7 }| j} | j �r�ztj�| �} W n& tk �rt tjj| d d �} Y nRX z| �|d �} W n" tk �r� | �d d �} Y nX t�| ��r�| j �t �� � |�| � q�d �|�} || fV qfd S )Nr� r r� )�keyr� z.duplicate parameter name; duplicate(s) ignoredz+duplicate parameter name; duplicate ignoredz(inconsistent RFC2231 parameter numberingzlatin-1)�encoding�surrogateescaper� r )rD r� r �striprh r� �items�sortedr r` r� r� r r �InvalidHeaderDefectr� �urllib�parseZunquote_to_bytes�UnicodeEncodeErrorZunquote�decode� LookupErrorr �_has_surrogates�UndecodableBytesDefectr% ) r �paramsr6 �name�partsZ first_paramr` Z value_parts�ir� �paramr r r r r� � s` � � � zMimeParameters.paramsc C sT g }| j D ].\}}|r.|�d�|t|��� q |�|� q d�|�}|rPd| S dS )N�{}={}z; rN r )r� rh r* r r% )r r� r� r r r r r' s zMimeParameters.__str__N)r+ rF rG rD rH rJ r� r' r r r r r� � s Er� c @ s e Zd ZdZedd� �ZdS )�ParameterizedHeaderValueFc C s& t | �D ]}|jdkr|j S qi S )Nr� )�reversedrD r� rk r r r r� - s z ParameterizedHeaderValue.paramsN)r+ rF rG rH rJ r� r r r r r� ' s r� c @ s e Zd ZdZdZdZdZdS )� ContentTypez content-typeF�textZplainN)r+ rF rG rD r1 �maintype�subtyper r r r r� 5 s r� c @ s e Zd ZdZdZdZdS )�ContentDispositionzcontent-dispositionFN)r+ rF rG rD r1 �content_dispositionr r r r r� < s r� c @ s e Zd ZdZdZdZdS )�ContentTransferEncodingzcontent-transfer-encodingFZ7bitN)r+ rF rG rD r1 r_ r r r r r� B s r� c @ s e Zd ZdZdZdS )� HeaderLabelz header-labelFNr� r r r r r� H s r� c @ s e Zd ZdZdZdd� ZdS )�MsgIDzmsg-idFc C s t | �|j S r )r �linesepr: r r r r; Q s z MsgID.foldN)r+ rF rG rD r1 r; r r r r r� M s r� c @ s e Zd ZdZdS )� MessageIDz message-idNrT r r r r r� V s r� c @ s e Zd ZdZdS )�InvalidMessageIDzinvalid-message-idNrT r r r r r� Z s r� c @ s e Zd ZdZdS )�Header�headerNrT r r r r r� ^ s r� c sr e Zd ZdZdZdZ� fdd�Z� fdd�Zdd� Ze dd � �Z d� fd d � Z d d� Z e dd� �Z dd� Z� ZS )�TerminalTc s t � �| |�}||_g |_|S r )r �__new__rD r )�clsr rD r r r r r� l s zTerminal.__new__c s d� | jjt� �� �S r( r) r& r r r r, r s zTerminal.__repr__c C s t | jjd | j � d S )N�/)r> r r+ rD r& r r r rA u s zTerminal.pprintc C s t | j�S r )�listr r& r r r r- x s zTerminal.all_defectsr c s2 d� || jj| jt� �� | js"dn d� | j��gS )Nz {}{}/{}({}){}r z {})r* r r+ rD r r, r r@ r r r rC | s �z Terminal._ppc C s d S r r r& r r r �pop_trailing_ws� s zTerminal.pop_trailing_wsc C s g S r r r& r r r r5 � s zTerminal.commentsc C s t | �| jfS r )r rD r& r r r �__getnewargs__� s zTerminal.__getnewargs__)r )r+ rF rG r1 rI rH r� r, rA rJ r- rC r� r5 r rK r r r r r� f s r� c @ s e Zd Zedd� �Zdd� ZdS )�WhiteSpaceTerminalc C s dS rM r r& r r r r � s zWhiteSpaceTerminal.valuec C s dS )NTr r& r r r r0 � s z!WhiteSpaceTerminal.startswith_fwsN�r+ rF rG rJ r r0 r r r r r � s r c @ s e Zd Zedd� �Zdd� ZdS )� ValueTerminalc C s | S r r r& r r r r � s zValueTerminal.valuec C s dS )NFr r& r r r r0 � s z ValueTerminal.startswith_fwsNr r r r r r � s r c @ s e Zd Zedd� �Zdd� ZdS )�EWWhiteSpaceTerminalc C s dS r� r r& r r r r � s zEWWhiteSpaceTerminal.valuec C s dS r� r r& r r r r' � s z EWWhiteSpaceTerminal.__str__N)r+ rF rG rJ r r' r r r r r � s r c @ s e Zd ZdS )�_InvalidEwErrorN)r+ rF rG r r r r r � s r r� �,�list-separatorr� zroute-component-markerz([{}]+)r z[^{}]+z[\x00-\x20\x7F]c C s> t | �}|r | j�t�|�� t�| �r:| j�t�d�� d S )Nz*Non-ASCII characters found in header token)�_non_printable_finderr rh r ZNonPrintableDefectr r� r� )�xtextZnon_printablesr r r �_validate_xtext� s �r c C s� t | d�^}}g }d}d}tt|��D ]L}|| dkrJ|rDd}d}nd}q&|rTd}n|| |krd q||�|| � q&|d }d�|�d�||d � g| �|fS )Nr� Fr Tr )� _wsp_splitter�ranger� rh r% )r �endcharsZfragment� remainderZvchars�escape�had_qp�posr r r �_get_ptext_to_endchars� s$ r c C s. | � � }t| d t| �t|� � d�}||fS )N�fws)r� r r� )r Znewvaluer r r r �get_fws s r c C s� t � }| �d�s t�d�| ���| dd � �dd�^}}|| dd � krXt�d�| ���d�|�}t|�dkr�|d tkr�|d tkr�|� d�dk r�|�dd�^}}|d | }t|�� �dkr�|j � t� d �� | |_ d�|�} z t�d| d �\}}}} W n* ttfk �r* td �|j ���Y nX ||_||_|j �| � |�r�|d tk�rrt|�\} }|� | � �qDt|d�^} }t| d �} t| � |� | � d�|�}�qD| �r�| d tk�r�|j � t� d �� || fS ) N�=?z"expected encoded word but found {}r� z?=r� r r �?z whitespace inside encoded wordz!encoded word format invalid: '{}'�vtextz.missing trailing whitespace after encoded-word)r] � startswithr �HeaderParseErrorr* r� r% r� r �countr rh r� r_ �_ewr� � ValueError�KeyErrorr r` ra r4 �WSPr r r r ) r Zewr� r Zremstr�restr� r` ra r r6 �charsr r r r �get_encoded_word sd �� � � � � � �r! c C sF t � }| �rB| d tkr0t| �\}} |�|� qd}| �d�r�zt| �\}} W n, tk rf d}Y n� tjk rz Y nrX d}t |�dkr�|d j dkr�|j �t� d�� d}|r�t |�dkr�|d j d kr�t |d d�|d< |�|� qt| d�^}}|�rt�|��r| �d�^}}t|d �}t|� |�|� d �|�} q|S ) Nr Tr Fr� r z&missing whitespace before encoded wordr� ���r^ r r )rR r r rh r r! r r r r� rD r r� r r �rfc2047_matcher�search� partitionr r r% )r rS r6 �valid_ewZhave_wsr� r r r r r �get_unstructured? sJ � � r' c C s* t | d�\}} }t|d�}t|� || fS )Nz()r� )r r r �r r� �_r r r � get_qp_ctext� s r* c C s* t | d�\}} }t|d�}t|� || fS )Nr r� )r r r r( r r r � get_qcontent� s r+ c C sN t | �}|s t�d�| ���|�� }| t|�d � } t|d�}t|� || fS )Nz expected atext but found '{}'�atext)�_non_atom_end_matcherr r r* r| r� r r )r �mr, r r r � get_atext� s � r/ c C sr | d dkr t �d�| ���t� }| dd � } | rT| d dkrTt| �\}} |�|� | �rB| d dk�rB| d tkr�t| �\}} n�| d d� dk�r*d}z&t| �\}} |j �t � d�� d }W n" t jk r� t| �\}} Y nX |�r6t |�dk�r6|d j d k�r6|d j d k�r6t |d d �|d < n t| �\}} |�|� qT| �sb|j �t � d�� || fS || dd � fS )Nr r zexpected '"' but found '{}'r� r� r Fz!encoded word inside quoted stringTr� r r" r^ z"end of header inside quoted string)r r r* rm r+ rh r r r! r r� r� rD r )r Zbare_quoted_stringr6 r& r r r �get_bare_quoted_string� sL � � � � �r0 c C s� | r | d dkr t �d�| ���t� }| dd � } | r�| d dkr�| d tkr\t| �\}} n&| d dkrvt| �\}} n t| �\}} |�|� q2| s�|j �t � d�� || fS || dd � fS )Nr r zexpected '(' but found '{}'r� rp z end of header inside comment) r r r* rn r r � get_commentr* rh r r� )r rO r6 r r r r1 � s& � �r1 c C sP t � }| rH| d tkrH| d tkr0t| �\}} n t| �\}} |�|� q|| fS r/ )rX � CFWS_LEADERr r r1 rh )r rY r6 r r r �get_cfws� s r3 c C sp t � }| r,| d tkr,t| �\}} |�|� t| �\}} |�|� | rh| d tkrht| �\}} |�|� || fS r/ )rb r2 r3 rh r0 )r Z quoted_stringr6 r r r �get_quoted_string s r4 c C s� t � }| r,| d tkr,t| �\}} |�|� | rL| d tkrLt�d�| ���| �d�r�zt | �\}} W q� tjk r� t | �\}} Y q�X n t | �\}} |�|� | r�| d tkr�t| �\}} |�|� || fS )Nr z expected atom but found '{}'r ) rZ r2 r3 rh � ATOM_ENDSr r r* r r! r/ )r r[ r6 r r r �get_atom s& � r6 c C s� t � }| r| d tkr&t�d�| ���| rt| d tkrtt| �\}} |�|� | r&| d dkr&|�t� | dd � } q&|d tkr�t�d�d| ���|| fS )Nr z8expected atom at a start of dot-atom-text but found '{}'r r� r� z4expected atom at end of dot-atom-text but found '{}')r� r5 r r r* r/ rh r� )r Z dot_atom_textr6 r r r �get_dot_atom_text0 s � �r7 c C s� t � }| d tkr(t| �\}} |�|� | �d�rhzt| �\}} W qt tjk rd t| �\}} Y qtX n t| �\}} |�|� | r�| d tkr�t| �\}} |�|� || fS )Nr r ) r� r2 r3 rh r r! r r r7 )r Zdot_atomr6 r r r � get_dot_atomC s r8 c C s� | d t krt| �\}} nd }| s,t�d��| d dkrFt| �\}} n*| d tkrdt�d�| ���n t| �\}} |d k r�|g|d d�< || fS )Nr z5Expected 'atom' or 'quoted-string' but found nothing.r z1Expected 'atom' or 'quoted-string' but found '{}')r2 r3 r r r4 �SPECIALSr* r6 )r �leaderr6 r r r �get_word\ s" � � r; c C s� t � }zt| �\}} |�|� W n( tjk rH |j�t�d�� Y nX | r�| d tkr�| d dkr�|�t� |j�t� d�� | dd � } qJzt| �\}} W nD tjk r� | d t kr�t | �\}} |j�t� d�� n� Y nX |�|� qJ|| fS )Nz phrase does not start with wordr r zperiod in 'phrase'r� zcomment found without atom) rU r; rh r r r r� � PHRASE_ENDSr� �ObsoleteHeaderDefectr2 r3 )r rV r6 r r r � get_phrase~ s4 � � � r> c C sv t � }d }| d tkr"t| �\}} | s6t�d�| ���zt| �\}} W n^ tjk r� zt| �\}} W n6 tjk r� | d dkr�| d tkr�� t � }Y nX Y nX |d k r�|g|d d�< |� |� | �r4| d dks�| d tk�r4t t |�| �\}} |j dk�r|j� t�d�� n|j� t�d�� ||d< z|j�d� W n( tk �rl |j� t�d�� Y nX || fS ) Nr z"expected local-part but found '{}'r �invalid-obs-local-partz<local-part is not dot-atom, quoted-string, or obs-local-partz,local-part is not a dot-atom (contains CFWS)�asciiz)local-part contains non-ASCII characters))r� r2 r3 r r r* r8 r; r< r rh �get_obs_local_partr rD r r� r= r �encoder� ZNonASCIILocalPartDefect)r r� r: r6 �obs_local_partr r r �get_local_part� sJ � � � � rD c C s� t � }d}| �r(| d dks*| d tk�r(| d dkrj|rL|j�t�d�� |�t� d}| dd � } q nD| d dkr�|�t| d d�� | dd � } |j�t�d �� d}q |r�|d jd kr�|j�t�d �� zt | �\}} d}W n4 tj k �r | d t k�r � t | �\}} Y nX |�|� q |d jd k�sX|d jd k�rj|d jd k�rj|j�t�d�� |d jd k�s�|d jd k�r�|d jd k�r�|j�t�d�� |j�r�d|_|| fS )NFr r r zinvalid repeated '.'Tr� �misplaced-specialz/'\' character outside of quoted-string/ccontentr� r� zmissing '.' between wordsrY z!Invalid leading '.' in local partr" z"Invalid trailing '.' in local partr? ) r� r< r rh r r� r� r rD r; r r2 r3 )r rC Zlast_non_ws_was_dotr6 r r r rA � sj � � � � � � � � � �rA c C s@ t | d�\}} }t|d�}|r0|j�t�d�� t|� || fS )Nz[]r� z(quoted printable found in domain-literal)r r r rh r r= r )r r� r r r r � get_dtext� s �rF c C s, | rdS |� t�d�� |� tdd�� dS )NFz"end of input inside domain-literal�]�domain-literal-endT)rh r r� r )r �domain_literalr r r �_check_for_early_dl_end s �rJ c C sj t � }| d tkr(t| �\}} |�|� | s6t�d��| d dkrRt�d�| ���| dd � } t| |�rp|| fS |�tdd�� | d t kr�t | �\}} |�|� t | �\}} |�|� t| |�r�|| fS | d t kr�t | �\}} |�|� t| |�r�|| fS | d dk�r t�d�| ���|�tdd �� | dd � } | �rb| d tk�rbt| �\}} |�|� || fS ) Nr zexpected domain-literal�[z6expected '[' at start of domain-literal but found '{}'r� zdomain-literal-startrG z4expected ']' at end of domain-literal but found '{}'rH ) r� r2 r3 rh r r r* rJ r r r rF )r rI r6 r r r �get_domain_literal sH � � rL c C sr t � }d }| d tkr"t| �\}} | s6t�d�| ���| d dkrvt| �\}} |d k rd|g|d d�< |�|� || fS zt| �\}} W n" tjk r� t | �\}} Y nX | r�| d dkr�t�d��|d k r�|g|d d�< |�|� | �rj| d dk�rj|j �t� d�� |d j dk�r*|d |d d �< | �rj| d dk�rj|�t � t | d d � �\}} |�|� �q*|| fS ) Nr z expected domain but found '{}'rK r� zInvalid Domainr z(domain is not a dot-atom (contains CFWS)r� r� )r� r2 r3 r r r* rL rh r8 r6 r r= rD r� )r r� r: r6 r r r � get_domain= sD � � rM c C s| t � }t| �\}} |�|� | r,| d dkrF|j�t�d�� || fS |�tdd�� t| dd � �\}} |�|� || fS )Nr r� z#addr-spec local part with no domain�address-at-symbolr� )r� rD rh r r r� r rM )r r� r6 r r r � get_addr_specc s � rO c C s� t � }| rj| d dks"| d tkrj| d tkrFt| �\}} |�|� q| d dkr|�t� | dd � } q| rz| d dkr�t�d�| ���|�t� t | dd � �\}} |�|� | �r>| d dk�r>|�t� | dd � } | s�q>| d tk�rt| �\}} |�|� | d dkr�|�t� t | dd � �\}} |�|� q�| �sNt�d��| d dk�rlt�d�| ���|�t dd �� || dd � fS ) Nr r r� r� z(expected obs-route domain but found '{}'z%end of header while parsing obs-route�:z4expected ':' marking end of obs-route but found '{}'zend-of-obs-route-marker) r� r2 r3 rh � ListSeparatorr r r* �RouteComponentMarkerrM r )r Z obs_router6 r r r � get_obs_routes sF � �rS c C s� t � }| d tkr(t| �\}} |�|� | r8| d dkrHt�d�| ���|�tdd�� | dd � } | d dkr�|�tdd�� |j�t� d�� | dd � } || fS zt | �\}} W nz tjk �r0 z"t | �\}} |j�t� d �� W n( tjk �r t�d �| ���Y nX |�|� t | �\}} Y nX |�|� | �r^| d dk�r^| dd � } n|j�t� d �� |�tdd�� | �r�| d tk�r�t| �\}} |�|� || fS ) Nr �<z"expected angle-addr but found '{}'zangle-addr-startr� �>zangle-addr-endz null addr-spec in angle-addrz*obsolete route specification in angle-addrz.expected addr-spec or obs-route but found '{}'z"missing trailing '>' on angle-addr) r� r2 r3 rh r r r* r r r� rO rS r= )r Z angle_addrr6 r r r �get_angle_addr� sT � � � � � rV c C s< t � }t| �\}} |�|d d � � |jd d � |_|| fS r )r� r> r4 r )r r~ r6 r r r �get_display_name� s rW c C s� t � }d }| d tkr6t| �\}} | s6t�d�|���| d dkr�| d tkr^t�d�| ���t| �\}} | s~t�d�|���|d k r�|g|d d d�< d }|�|� t | �\}} |d k r�|g|d d�< |�|� || fS )Nr z!expected name-addr but found '{}'rT ) r� r2 r3 r r r* r< rW rh rV )r Z name_addrr: r6 r r r � get_name_addr� s6 � � � rX c C s� t � }zt| �\}} W nN tjk rd zt| �\}} W n& tjk r^ t�d�| ���Y nX Y nX tdd� |jD ��r�d|_|� |� || fS )Nz expected mailbox but found '{}'c s s | ]}t |tj�V qd S r )r� r r� r r r r r# s �z get_mailbox.<locals>.<genexpr>r� ) r� rX r r rO r* �anyr- rD rh )r r� r6 r r r � get_mailbox� s �� rZ c C sd t � }| r\| d |kr\| d tkrD|�t| d d�� | dd � } qt| �\}} |�|� q|| fS )Nr rE r� )r� r< rh r r> )r r Zinvalid_mailboxr6 r r r �get_invalid_mailbox s � r[ c C s� t � }| �r�| d dk�r�z t| �\}} |�|� W �n tjk �r< d }| d tkr�t| �\}} | rv| d dkr�|�|� |j�t�d�� n@t | d�\}} |d k r�|g|d d�< |�|� |j�t� d�� nb| d dkr�|j�t�d�� nBt | d�\}} |d k �r |g|d d�< |�|� |j�t� d�� Y nX | �r�| d dk�r�|d }d|_ t | d�\}} |� |� |j�t� d�� | r| d dkr|�t � | d d � } q|| fS ) Nr �;z,;z empty element in mailbox-listz invalid mailbox in mailbox-listr r� r� r� )r� rZ rh r r r2 r3 r r= r[ r� rD r4 rQ )r Z mailbox_listr6 r: r� r r r �get_mailbox_list sX � � � � � r] c C s t � }| s$|j�t�d�� || fS d }| r�| d tkr�t| �\}} | sl|j�t�d�� |�|� || fS | d dkr�|�|� || fS t| �\}} t|j �dkr�|d k r�|�|� |� |� |j�t� d�� || fS |d k r�|g|d d�< |�|� || fS )Nz end of header before group-listr zend of header in group-listr\ z group-list with empty entries) r� r rh r r� r2 r3 r] r� rz r4 r= )r Z group_listr: r6 r r r �get_group_listW s> � � � r^ c C s t � }t| �\}} | r"| d dkr2t�d�| ���|�|� |�tdd�� | dd � } | r�| d dkr�|�tdd�� || dd � fS t| �\}} |�|� | s�|j�t� d�� n | d dkr�t�d �| ���|�tdd�� | dd � } | �r| d t k�rt | �\}} |�|� || fS ) Nr rP z8expected ':' at end of group display name but found '{}'z group-display-name-terminatorr� r\ zgroup-terminatorzend of header in groupz)expected ';' at end of group but found {}) r� rW r r r* rh r r^ r r� r2 r3 )r r| r6 r r r � get_group| s8 � � � r_ c C sx t � }zt| �\}} W nN tjk rd zt| �\}} W n& tjk r^ t�d�| ���Y nX Y nX |�|� || fS )Nz expected address but found '{}')r{ r_ r r rZ r* rh )r rr r6 r r r � get_address� s � r` c C s� t � }| �r�z t| �\}} |�|� W �n tjk �rH } z�d }| d tkr�t| �\}} | rj| d dkr�|�|� |j�t�d�� nFt | d�\}} |d k r�|g|d d�< |�t |g�� |j�t� d�� nh| d dkr�|j�t�d�� nHt | d�\}} |d k �r|g|d d�< |�t |g�� |j�t� d�� W 5 d }~X Y nX | �r�| d dk�r�|d d }d|_ t | d�\}} |� |� |j�t� d�� | r|�tdd�� | d d � } q|| fS ) Nr r z"address-list entry with no contentz invalid address in address-listz empty element in address-listr� r� r r� )rq r` rh r r r2 r3 r r= r[ r{ r� rD r4 r )r Z address_listr6 �errr: r� r r r �get_address_list� sX � � � � �rb c C s� t � }| st�d�| ���| d dkr6t�d�| ���|�tdd�� | dd � } t| �\}} |�|� | rx| d dkr�t�d�| ���|�tdd �� || dd � fS ) Nz'expected no-fold-literal but found '{}'r rK z;expected '[' at the start of no-fold-literal but found '{}'zno-fold-literal-startr� rG z9expected ']' at the end of no-fold-literal but found '{}'zno-fold-literal-end)r� r r r* rh r rF )r Zno_fold_literalr6 r r r �get_no_fold_literal� s. � �� ��rc c C s� t � }| r,| d tkr,t| �\}} |�|� | r<| d dkrLt�d�| ���|�tdd�� | dd � } zt| �\}} W n` tjk r� z"t | �\}} |j �t� d�� W n& tjk r� t�d�| ���Y nX Y nX |�|� | r�| d dk�r@|j �t� d �� | �r8| d d k�r8|�td d �� | dd � } || fS |�tdd �� | dd � } zt| �\}} W n� tjk �r zt | �\}} W nr tjk �r } zPz"t| �\}} |j �t� d �� W n( tjk �r� t�d�| ���Y nX W 5 d }~X Y nX Y nX |�|� | �r6| d d k�r6| dd � } n|j �t� d�� |�td d �� | �r�| d tk�r�t| �\}} |�|� || fS )Nr rT z expected msg-id but found '{}'z msg-id-startr� zobsolete id-left in msg-idz4expected dot-atom-text or obs-id-left but found '{}'r� zmsg-id with no id-rightrU z msg-id-endrN zobsolete id-right in msg-idzFexpected dot-atom-text, no-fold-literal or obs-id-right but found '{}'z missing trailing '>' on msg-id)r� r2 r3 rh r r r* r r7 rA r r= r� rc rM )r Zmsg_idr6 �er r r � get_msg_id s~ � � �� � � ��" � re c C s� t � }zt| �\}} |�|� W nL tjk rl } z,t| �}t|�}|j�t�d� |��� W 5 d }~X Y n X | r�|j�t�d� | ��� |S )NzInvalid msg-id: {!r}zUnexpected {!r}) r� re rh r r r' r� r r� r* )r Z message_idr6 Zexr r r �parse_message_idI s � �rf c C s� t � }| s |j�t�d�� |S | d tkrXt| �\}} |�|� | sX|j�t�d�� d}| r�| d dkr�| d tkr�|| d 7 }| dd � } q\|�� s�|j�t�d� |��� |�t |d�� nt |�|_ |�t |d �� | �r| d tk�rt| �\}} |�|� | �r | d dk�rT|j d k �r:|j�t�d �� | �rP|�t | d�� |S |�t dd �� | dd � } | �r�| d tk�r�t| �\}} |�|� | �s�|j d k �r�|j�t�d �� |S d}| �r�| d tk�r�|| d 7 }| dd � } �q�|�� �s*|j�t�d � |��� |�t |d�� nt |�|_ |�t |d �� | �rn| d tk�rnt| �\}} |�|� | �r�|j�t�d �� |�t | d�� |S )Nz%Missing MIME version number (eg: 1.0)r z0Expected MIME version number but found only CFWSr r r� z1Expected MIME major version number but found {!r}r �digitsz0Incomplete MIME version; found only major numberzversion-separatorz1Expected MIME minor version number but found {!r}z'Excess non-CFWS text after MIME version)r� r rh r �HeaderMissingRequiredValuer2 r3 �isdigitr� r* r �intr� r� )r Z mime_versionr6 rg r r r �parse_mime_versione s� � � � � � � �rk c C sd t � }| r\| d dkr\| d tkrD|�t| d d�� | dd � } qt| �\}} |�|� q|| fS )Nr r\ rE r� )r� r< rh r r> )r Zinvalid_parameterr6 r r r �get_invalid_parameter� s � rl c C sN t | �}|s t�d�| ���|�� }| t|�d � } t|d�}t|� || fS )Nz expected ttext but found '{}'�ttext)�_non_token_end_matcherr r r* r| r� r r )r r. rm r r r � get_ttext� s � ro c C s� t � }| r,| d tkr,t| �\}} |�|� | rL| d tkrLt�d�| ���t| �\}} |�|� | r�| d tkr�t| �\}} |�|� || fS �Nr z expected token but found '{}') r\ r2 r3 rh � TOKEN_ENDSr r r* ro )r Zmtokenr6 r r r � get_token� s � rr c C sN t | �}|s t�d�| ���|�� }| t|�d � } t|d�}t|� || fS )Nz expected attrtext but found {!r}r� )�_non_attribute_end_matcherr r r* r| r� r r �r r. r� r r r � get_attrtext� s � ru c C s� t � }| r,| d tkr,t| �\}} |�|� | rL| d tkrLt�d�| ���t| �\}} |�|� | r�| d tkr�t| �\}} |�|� || fS rp ) r� r2 r3 rh �ATTRIBUTE_ENDSr r r* ru �r r� r6 r r r � get_attribute� s � rx c C sN t | �}|s t�d�| ���|�� }| t|�d � } t|d�}t|� || fS )Nz)expected extended attrtext but found {!r}�extended-attrtext)�#_non_extended_attribute_end_matcherr r r* r| r� r r rt r r r �get_extended_attrtext s � r{ c C s� t � }| r,| d tkr,t| �\}} |�|� | rL| d tkrLt�d�| ���t| �\}} |�|� | r�| d tkr�t| �\}} |�|� || fS rp ) r� r2 r3 rh �EXTENDED_ATTRIBUTE_ENDSr r r* r{ rw r r r �get_extended_attribute! s � r} c C s� t � }| r| d dkr&t�d�| ���|�tdd�� | dd � } | rR| d �� sbt�d�| ���d}| r�| d �� r�|| d 7 }| dd � } qf|d dkr�|dkr�|j�t�d �� t |�|_ |�t|d �� || fS ) Nr �*z Expected section but found {}zsection-markerr� z$Expected section number but found {}r �0z'section number has an invalid leading 0rg ) r� r r r* rh r ri r ZInvalidHeaderErrorrj r� )r r� rg r r r � get_section7 s, � � � r� c C s� t � }| st�d��d }| d tkr0t| �\}} | sDt�d�|���| d dkr^t| �\}} n t| �\}} |d k r�|g|d d�< |�|� || fS )Nz&Expected value but found end of stringr z Expected value but found only {}r ) r� r r r2 r3 r* r4 r} rh )r �vr: r6 r r r � get_valueU s" � r� c C s� t � }t| �\}} |�|� | r,| d dkrL|j�t�d�|��� || fS | d dkr�z t| �\}} d|_|�|� W n tj k r� Y nX | s�t� d��| d dkr�|�t dd�� | dd � } d|_ | d d kr�t� d ��|�t d d �� | dd � } d }| �r,| d t k�r,t | �\}} |�|� d }|}|j �rF| �rF| d d k�rFt| �\}}|j}d }|jdk�r�|�r�|d dk�r�d}n$t|�\}} | �r�| d dk�r�d}n(zt|�\}} W n Y n X | �s�d}|�r0|j�t�d�� |�|� |D ](} | jdk�r g | d d �< | } �q*�q |} nd }|j�t�d�� | �r`| d dk�r`d }n t| �\}} |j �r�|jdk�r�| �r�| d dk�r�|�|� |d k �r�|} || fS |j�t�d�� | �s�|j�t�d�� |�|� |d k�r�|| fS n�|d k �r@|D ]} | jdk�r �q$�q | jdk |�| � | j|_| d dk�r^t� d�| ���|�t dd�� | dd � } | �r�| d dk�r�t| �\}} |�|� |j|_| �r�| d dk�r�t� d�| ���|�t dd�� | dd � } |d k �rdt� } | �r^| d tk�r t| �\}} n2| d d k�rDt d d�}| dd � } n t| �\}} | �|� �q�| }n t| �\}} |�|� |d k �r�|} || fS )Nr r\ z)Parameter contains name ({}) but no valuer~ TzIncomplete parameterzextended-parameter-markerr� �=z Parameter not followed by '='�parameter-separatorr F�'z5Quoted string value for extended parameter is invalidre zZParameter marked as extended but appears to have a quoted string value that is non-encodedzcApparent initial-extended-value but attribute was not marked as extended or was not initial sectionz(Missing required charset/lang delimitersry r� z=Expected RFC2231 char/lang encoding delimiter, but found {!r}zRFC2231-delimiterz;Expected RFC2231 char/lang encoding delimiter, but found {}ZDQUOTE) r� rx rh r r r� r* r� r� r r r� r2 r3 r4 rl r� ru r{ rD r� r r` ra r� r r r+ ) r r� r6 r: r ZappendtoZqstringZ inner_valueZ semi_validr �tr� r r r � get_parameterk s� � � � � � � � r� c C sj t � }| �rfzt| �\}} |�|� W n� tjk r� } z�d }| d tkrVt| �\}} | sp|�|� | W Y �xS | d dkr�|d k r�|�|� |j�t�d�� n@t | �\}} |r�|g|d d�< |�|� |j�t�d� |��� W 5 d }~X Y nX | �rD| d dk�rD|d }d|_ t | �\}} |� |� |j�t�d� |��� | r|�t dd�� | d d � } q|S ) Nr r\ z parameter entry with no contentzinvalid parameter {!r}r� r� z)parameter with invalid trailing text {!r}r� r� )r� r� rh r r r2 r3 r r� rl r* rD r4 r )r Zmime_parametersr6 ra r: r� r r r �parse_mime_parameters� sJ � � �r� c C s� |rV|d dkrV|d t kr>| �t|d d�� |dd � }q t|�\}}| �|� q |s^d S | �tdd�� | �t|dd � �� d S )Nr r\ rE r� r� )r< rh r r> r� )Z tokenlistr r6 r r r �_find_mime_parameters- s r� c C s� t � }d}| s$|j�t�d�� |S zt| �\}} W n< tjk rp |j�t�d�| ��� t || � | Y S X |�|� | r�| d dkr�|j�t�d�� | r�t || � |S |j � � � � |_ |�tdd�� | dd � } zt| �\}} W n> tjk �r* |j�t�d �| ��� t || � | Y S X |�|� |j � � � � |_| �sP|S | d d k�r�|j�t�d �| ��� |` |`t || � |S |�td d �� |�t| dd � �� |S ) NFz"Missing content type specificationz(Expected content maintype but found {!r}r r� zInvalid content typezcontent-type-separatorr� z'Expected content subtype but found {!r}r\ z<Only parameters are valid after content type, but found {!r}r� )r� r rh r rh rr r r� r* r� r r� �lowerr� r r� r� )r ZctypeZrecoverr6 r r r �parse_content_type_header= sd � � � � �� r� c C s� t � }| s |j�t�d�� |S zt| �\}} W n< tjk rl |j�t�d�| ��� t || � | Y S X |�|� |j � � � � |_ | s�|S | d dkr�|j�t�d�| ��� t || � |S |�tdd�� |�t| dd � �� |S )NzMissing content dispositionz+Expected content disposition but found {!r}r r\ zCOnly parameters are valid after content disposition, but found {!r}r� r� )r� r rh r rh rr r r� r* r� r r� r� r� r r� )r Z disp_headerr6 r r r � parse_content_disposition_headerv s: � � �� r� c C s� t � }| s |j�t�d�� |S zt| �\}} W n. tjk r^ |j�t�d�| ��� Y n X |�|� |j � � � � |_ | s�|S | r�|j�t�d�� | d t kr�|�t| d d�� | dd � } q�t| �\}} |�|� q�|S )Nz!Missing content transfer encodingz1Expected content transfer encoding but found {!r}z*Extra text after content transfer encodingr rE r� )r� r rh r rh rr r r� r* r r� r� r_ r< r r> )r Z cte_headerr6 r r r �&parse_content_transfer_encoding_header� s4 � � � r� c C sD d}| r@| d r@| d d t kr@| d d }| d d d� | d< |S )Nr r� )r )�linesZwspr r r � _steal_trailing_WSP_if_exists� s r� c C s� |j p tj}|jrdnd}dg}d }d}d}tdd�}t| �} | �r�| �d�} | |kr`|d8 }q>t| �} | jdkr�t | �t @ r�d }z| � |� |} W n6 t k r� t d d � | jD ��r�d } nd} d }Y nX | jd kr�t| |||� q>|�r�|�s�| j�spd}d }| j�rp| j|d�d t|j� � } |j| k�rpt| �|t|d � k�r^t|�}|�|� |d | 7 < q>t| d��s�t| �| } nt| |||| j| �}d}q>t| �|t|d � k�r�|d | 7 < q>| j�rt| �d |k�rt|�}|�s| �� �r|�|| � d }q>t| d��sNt| �}| j�sD|d7 }|�|� || } q>| j�rn|�sn| �d| � d }q>t|�}|�s�| �� �r�|�|| � q>|d | 7 < q>|j� |�|j S )N�utf-8r� r r F�wrap_as_ew_blockedr� r� Tc s s | ]}t |tj�V qd S r )r� r r� r r r r r# � s �z%_refold_parse_tree.<locals>.<genexpr>� unknown-8bitr� r7 r� rB ) Zmax_line_length�sys�maxsize�utf8r� r� r� r rD r� r9 rB r� rY r- �_fold_mime_parametersr1 rH r; r� r� r� rh rE � _fold_as_ewrI r0 �insertr% )Z parse_treer8 �maxlenr� r� �last_ewr� Z want_encodingZend_ew_not_allowedr� r2 �tstrr` Z encoded_part�newlineZnewpartsr r r r9 � s� � �� r9 c C s� |d k r<|r<t t|d |d � | ��} |d d |� |d< | d tkr�| d }| dd � } t|d �|krz|�t|�� |d |7 < d}| d tkr�| d }| d d� } |d kr�t|d �n|}|dkr�dn|} t| �d } | d |kr�t�d��| �r�|t|d � } | | } | dk�r,|�d � q�| d | � } tj | | d �}t|�| }|dk�r�| d d� } tj | | d �}t|�| }�qR|d |7 < | t| �d � } | r�|�d � t|d �}q�|d |7 < |�r�|S d S ) Nr� r r� r r� r� � z3max_line_length is too small to fit an encoded wordrN )r` ) r r' r r� rh r� r r r rB )Z to_encoder� r� r� rI r` Z leading_wspZ trailing_wspZ new_last_ewZ encode_as� chrome_lenZremaining_spaceZ text_spaceZto_encode_wordZ encoded_wordZexcessr r r r� 1 sT � � r� c C s� | j D �]�\}}|d �� �d�s2|d d7 < |}d}z|�|� d}W n0 tk r| d}t�|�rtd}d}nd}Y nX |r�tjj |d |d �} d � ||| �} nd � |t |��} t |d �t | � d |k r�|d d | |d< qn"t | �d |k�r |� d| � qd} |d } |rt |�t t| �� d t | � } || d k�rLd}|| d }}|d |� }tjj |d |d �} t | �|k�r��q�|d 8 }�q\|� d� || | | �� d } | d 7 } ||d � }|�r|d d7 < �qqd S )Nr� r\ �strictFTr� r� r� r )Zsafer z {}*={}''{}r� r� rN r� r z''r� �N z {}*{}*={}{})r� r� r� rB r� r r� r� r� ro r* r r� rh r )r2 r� r� r� r� r r` Z error_handlerZencoding_requiredZ encoded_valuer� r� Z extra_chromer� Z splitpointZmaxchars�partialr r r r� r sn � � � r� )��rer� r� �stringr �operatorr Zemailr r r r r� r r2 r9 r5 r� r< Z TSPECIALSrq Z ASPECIALSrv r| r �compile�VERBOSE� MULTILINEr# r� r rL rR rU rW rX rZ r\ r] rb rm rn rq r{ r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r r� r r r r r r� rQ rR r* r% r� r r �matchr- �findallr rn rs rz r r r r! r' r* r+ r/ r0 r1 r3 r4 r6 r7 r8 r; r> rD rA rF rJ rL rM rO rS rV rW rX rZ r[ r] r^ r_ r` rb rc re rf rk rl ro rr ru rx r{ r} r� r� r� r� r� r� r� r� r� r9 r� r� r r r r �<module>F s, �C " !*$ V + � ��� 1C+ "&'/'&). 9% 7E D 49 /gA __pycache__/policy.cpython-38.pyc 0000644 00000022674 15204103444 0012713 0 ustar 00 U e5d�( � @ s� d Z ddlZddlZddlmZmZmZmZ ddlm Z ddl m Z ddl m Z ddlmZ dd d d d d ddgZe�d�ZeG dd � d e��Ze� Ze`ejdd�Zejdd�Zejddd�Zejdd�ZdS )zcThis will be the home for the policy that hooks in the new code that adds all the email6 features. � N)�Policy�Compat32�compat32�_extend_docstrings)�_has_surrogates)�HeaderRegistry)�raw_data_manager)� EmailMessager r r � EmailPolicy�default�strict�SMTP�HTTPz\n|\rc sp e Zd ZdZeZdZdZe� Z e Z � fdd�Z dd� Z dd � Zd d � Zd d � Zdd� Zdd� Zddd�Z� ZS )r aQ + PROVISIONAL The API extensions enabled by this policy are currently provisional. Refer to the documentation for details. This policy adds new header parsing and folding algorithms. Instead of simple strings, headers are custom objects with custom attributes depending on the type of the field. The folding algorithm fully implements RFCs 2047 and 5322. In addition to the settable attributes listed above that apply to all Policies, this policy adds the following additional attributes: utf8 -- if False (the default) message headers will be serialized as ASCII, using encoded words to encode any non-ASCII characters in the source strings. If True, the message headers will be serialized using utf8 and will not contain encoded words (see RFC 6532 for more on this serialization format). refold_source -- if the value for a header in the Message object came from the parsing of some source, this attribute indicates whether or not a generator should refold that value when transforming the message back into stream form. The possible values are: none -- all source values use original folding long -- source values that have any line that is longer than max_line_length will be refolded all -- all values are refolded. The default is 'long'. header_factory -- a callable that takes two arguments, 'name' and 'value', where 'name' is a header field name and 'value' is an unfolded header field value, and returns a string-like object that represents that header. A default header_factory is provided that understands some of the RFC5322 header field types. (Currently address fields and date fields have special treatment, while all other fields are treated as unstructured. This list will be completed before the extension is marked stable.) content_manager -- an object with at least two methods: get_content and set_content. When the get_content or set_content method of a Message object is called, it calls the corresponding method of this object, passing it the message object as its first argument, and any arguments or keywords that were passed to it as additional arguments. The default content_manager is :data:`~email.contentmanager.raw_data_manager`. F�longc s* d|krt �| dt� � t� jf |� d S )N�header_factory)�object� __setattr__r �super�__init__)�self�kw�� __class__� �$/usr/lib64/python3.8/email/policy.pyr ] s zEmailPolicy.__init__c C s | j | jS )z�+ The implementation for this class returns the max_count attribute from the specialized header class that would be used to construct a header of type 'name'. )r Z max_count)r �namer r r �header_max_countd s z EmailPolicy.header_max_countc C s> |d � dd�\}}|�d�d�|dd� � }||�d�fS )ac + The name is parsed as everything up to the ':' and returned unmodified. The value is determined by stripping leading whitespace off the remainder of the first line, joining all subsequent lines together, and stripping any trailing carriage return or linefeed characters. (This is the same as Compat32). r �:� z � N� )�split�lstrip�join�rstrip)r Z sourcelinesr �valuer r r �header_source_parsev s z EmailPolicy.header_source_parsec C sV t |d�r$|j�� |�� kr$||fS t|t�rFt|�� �dkrFtd��|| �||�fS )a� + The name is returned unchanged. If the input value has a 'name' attribute and it matches the name ignoring case, the value is returned unchanged. Otherwise the name and value are passed to header_factory method, and the resulting custom header object is returned as the value. In this case a ValueError is raised if the input value contains CR or LF characters. r r zDHeader values may not contain linefeed or carriage return characters) �hasattrr �lower� isinstance�str�len� splitlines� ValueErrorr �r r r% r r r �header_store_parse� s z EmailPolicy.header_store_parsec C s* t |d�r|S d�t�|��}| �||�S )ai + If the value has a 'name' attribute, it is returned to unmodified. Otherwise the name and the value with any linesep characters removed are passed to the header_factory method, and the resulting custom header object is returned. Any surrogateescaped bytes get turned into the unicode unknown-character glyph. r r )r' r# �linesep_splitterr! r r. r r r �header_fetch_parse� s z EmailPolicy.header_fetch_parsec C s | j ||dd�S )a + Header folding is controlled by the refold_source policy setting. A value is considered to be a 'source value' if and only if it does not have a 'name' attribute (having a 'name' attribute means it is a header object of some sort). If a source value needs to be refolded according to the policy, it is converted into a custom header object by passing the name and the value with any linesep characters removed to the header_factory method. Folding of a custom header object is done by calling its fold method with the current policy. Source values are split into lines using splitlines. If the value is not to be refolded, the lines are rejoined using the linesep from the policy and returned. The exception is lines containing non-ascii binary data. In that case the value is refolded regardless of the refold_source setting, which causes the binary data to be CTE encoded using the unknown-8bit charset. T�� refold_binary)�_foldr. r r r �fold� s zEmailPolicy.foldc C s0 | j ||| jdkd�}| jr dnd}|�|d�S )a + The same as fold if cte_type is 7bit, except that the returned value is bytes. If cte_type is 8bit, non-ASCII binary data is converted back into bytes. Headers with binary data are not refolded, regardless of the refold_header setting, since there is no way to know whether the binary data consists of single byte characters or multibyte characters. If utf8 is true, headers are encoded to utf8, otherwise to ascii with non-ASCII unicode rendered as encoded words. Z7bitr2 �utf8�ascii�surrogateescape)r4 Zcte_typer6 �encode)r r r% Zfolded�charsetr r r � fold_binary� s zEmailPolicy.fold_binaryc s� t |d�r|j| d�S | jr"| jntj� |�� }| jdkp�| jdko�|rdt|d �t|� d � kp�t� fdd�|d d � D ��}|s�|r�t |�r�| � |d � |��j| d�S |d | j � |� | j S ) Nr )Zpolicy�allr r � c 3 s | ]}t |�� kV qd S )N)r+ )�.0�x��maxlenr r � <genexpr>� s z$EmailPolicy._fold.<locals>.<genexpr>r r z: ) r' r5 �max_line_length�sys�maxsizer, � refold_sourcer+ �anyr r r# �linesep)r r r% r3 �linesZrefoldr r@ r r4 � s �zEmailPolicy._fold)F)�__name__� __module__� __qualname__�__doc__r Zmessage_factoryr6 rF r r r Zcontent_managerr r r& r/ r1 r5 r; r4 � __classcell__r r r r r s : T)Zraise_on_defectr )rH )rH rC )r6 )rM �rerD Zemail._policybaser r r r Z email.utilsr Zemail.headerregistryr Zemail.contentmanagerr Z email.messager �__all__�compiler0 r r r Zcloner r r ZSMTPUTF8r r r r �<module> s4 � @ __pycache__/headerregistry.cpython-38.opt-2.pyc 0000644 00000037547 15204103444 0015402 0 ustar 00 U e5dKQ � @ sv d dl mZ d dlmZ d dlmZ d dlmZ G dd� d�ZG dd� d�ZG d d � d e �Z d d � Z G d d� d�Z G dd� de �Z G dd� d�ZG dd� de�ZG dd� d�ZG dd� de�ZG dd� de�ZG dd � d e�ZG d d � d �ZG d d � d �ZG d!d"� d"e�ZG d#d$� d$e�ZG d%d&� d&�ZG d'd(� d(�Ze eeeeeeeeeeeeeeeeeeed)�ZG d*d+� d+�Zd,S )-� )�MappingProxyType)�utils)�errors)�_header_value_parserc @ s^ e Zd Zddd�Zedd� �Zedd� �Zed d � �Zed d � �Zd d� Z dd� Z dd� Z dS )�Address� Nc C s� d� td ||||f��}d|ks(d|kr0td��|d k r�|s@|rHtd��t�|�\}}|rjtd�||���|jrz|jd �|j}|j }|| _ || _ || _ d S )Nr � � z8invalid arguments; address parts cannot contain CR or LFz=addrspec specified when username and/or domain also specifiedz6Invalid addr_spec; only '{}' could be parsed from '{}'r ) �join�filter� ValueError� TypeError�parserZ get_addr_spec�format� all_defects� local_part�domain� _display_name� _username�_domain)�self� display_name�usernamer � addr_specZinputsZa_s�rest� r �,/usr/lib64/python3.8/email/headerregistry.py�__init__ s& � zAddress.__init__c C s | j S �N�r �r r r r r < s zAddress.display_namec C s | j S r )r r r r r r @ s zAddress.usernamec C s | j S r )r r r r r r D s zAddress.domainc C sT t | j�}t|�t|tj �kr.t�| j�}n| j}| jrH|d | j S |sPdS |S )N�@�<>)�setr �lenr Z DOT_ATOM_ENDS� quote_stringr )r �namesetZlpr r r r H s zAddress.addr_specc C s d� | jj| j| j| j�S )Nz1{}(display_name={!r}, username={!r}, domain={!r}))r � __class__�__name__r r r r r r r �__repr__X s �zAddress.__repr__c C s^ t | j�}t|�t|tj �kr.t�| j�}n| j}|rX| jdkrFdn| j}d�||�S | jS )Nr" r z{} <{}>)r# r r$ r �SPECIALSr% r r )r r& �dispr r r r �__str__] s zAddress.__str__c C s8 t |�t | �krdS | j|jko6| j|jko6| j|jkS �NF)�typer r r �r �otherr r r �__eq__h s � �zAddress.__eq__)r r r N) r( � __module__� __qualname__r �propertyr r r r r) r, r1 r r r r r s * r c @ sF e Zd Zddd�Zedd� �Zedd� �Zdd � Zd d � Zd d � Z dS )�GroupNc C s || _ |rt|�nt� | _d S r )r �tuple� _addresses)r r � addressesr r r r r s zGroup.__init__c C s | j S r r r r r r r � s zGroup.display_namec C s | j S r )r7 r r r r r8 � s zGroup.addressesc C s d� | jj| j| j�S )Nz${}(display_name={!r}, addresses={!r})r r' r( r r8 r r r r r) � s �zGroup.__repr__c C s� | j d kr&t| j�dkr&t| jd �S | j }|d k r\t|�}t|�t|tj �kr\t�|�}d�dd� | jD ��}|r~d| n|}d� ||�S )N� r �, c s s | ]}t |�V qd S r ��str)�.0�xr r r � <genexpr>� s z Group.__str__.<locals>.<genexpr>� z{}:{};) r r$ r8 r< r# r r* r% r r )r r+ r& Zadrstrr r r r, � s z Group.__str__c C s, t |�t | �krdS | j|jko*| j|jkS r- )r. r r8 r/ r r r r1 � s �z Group.__eq__)NN) r( r2 r3 r r4 r r8 r) r, r1 r r r r r5 p s r5 c @ sP e Zd Zdd� Zdd� Zedd� �Zedd� �Zd d � Ze d d � �Z d d� Z dS )� BaseHeaderc C s\ dg i}| � ||� t�|d �r4t�|d �|d< t�| |d �}|d= |j|f|� |S )N�defects�decoded)�parser Z_has_surrogates� _sanitizer< �__new__�init)�cls�name�value�kwdsr r r r rF � s zBaseHeader.__new__c C s || _ || _|| _d S r )�_name� _parse_tree�_defects)r rI � parse_treerB r r r rG � s zBaseHeader.initc C s | j S r )rL r r r r rI � s zBaseHeader.namec C s t | j�S r )r6 rN r r r r rB � s zBaseHeader.defectsc C s t | jj| jjt| �f| jfS r )�_reconstruct_headerr' r( � __bases__r< �__dict__r r r r � __reduce__� s ��zBaseHeader.__reduce__c C s t �| |�S r )r< rF )rH rJ r r r � _reconstruct� s zBaseHeader._reconstructc C s` t �t �t �| jd�t �dd�g�g�}| jrH|�t �t �dd�g�� |�| j� |j |d�S )Nz header-name�:z header-sepr@ Zfws)�policy) r ZHeaderZ HeaderLabelZ ValueTerminalrI rM �appendZCFWSListZWhiteSpaceTerminal�fold)r rV �headerr r r rX � s ��� zBaseHeader.foldN) r( r2 r3 rF rG r4 rI rB rS � classmethodrT rX r r r r rA � s " rA c C s t | |i ��|�S r )r. rT )Zcls_name�basesrJ r r r rP s rP c @ s& e Zd ZdZeej�Zedd� �Z dS )�UnstructuredHeaderNc C s" | � |�|d< t|d �|d< d S )NrO rC )� value_parserr< �rH rJ rK r r r rD s zUnstructuredHeader.parse) r( r2 r3 � max_count� staticmethodr �get_unstructuredr] rZ rD r r r r r\ s r\ c @ s e Zd ZdZdS )�UniqueUnstructuredHeaderr9 N�r( r2 r3 r_ r r r r rb s rb c sB e Zd ZdZeej�Zedd� �Z � fdd�Z e dd� �Z � Z S )� DateHeaderNc C sz |s6|d � t�� � d |d< d|d< t�� |d< d S t|t�rJt�|�}||d< t� |d �|d< | � |d �|d< d S )NrB �datetimer rC rO ) rW r ZHeaderMissingRequiredValuer Z TokenList� isinstancer< r Zparsedate_to_datetimeZformat_datetimer] r^ r r r rD . s zDateHeader.parsec s |� d�| _t� j||� d S )Nre )�pop� _datetime�superrG �r �args�kw�r' r r rG < s zDateHeader.initc C s | j S r )rh r r r r re @ s zDateHeader.datetime)r( r2 r3 r_ r` r ra r] rZ rD rG r4 re � __classcell__r r rm r rd s rd c @ s e Zd ZdZdS )�UniqueDateHeaderr9 Nrc r r r r ro E s ro c sP e Zd ZdZedd� �Zedd� �Z� fdd�Ze dd � �Z e d d � �Z � Z S ) � AddressHeaderNc C s t �| �\}} |S r )r Zget_address_list)rJ � address_listr r r r] N s zAddressHeader.value_parserc C s� t |t�rV| �|� |d< }g }|jD ]"}|�t|jdd� |jD ��� q&t|j �}n"t |d�sf|g}dd� |D �}g }||d< ||d< d� d d� |D ��|d < d|kr�| �|d �|d< d S ) NrO c S s* g | ]"}t |jpd |jpd |jp"d ��qS )r )r r r r )r= Zmbr r r � <listcomp>] s � �z'AddressHeader.parse.<locals>.<listcomp>�__iter__c S s& g | ] }t |d �s td|g�n|�qS )r8 N)�hasattrr5 �r= �itemr r r rr f s ��groupsrB r: c S s g | ] }t |��qS r r; ru r r r rr l s rC ) rf r< r] r8 rW r5 r Z all_mailboxes�listr rt r )rH rJ rK rq rw ZaddrrB r r r rD T s* �� �zAddressHeader.parsec s( t |�d��| _d | _t� j||� d S )Nrw )r6 rg �_groupsr7 ri rG rj rm r r rG p s zAddressHeader.initc C s | j S r )ry r r r r rw u s zAddressHeader.groupsc C s& | j d kr tdd� | jD ��| _ | j S )Nc s s | ]}|j D ] }|V q qd S r )r8 )r= �group�addressr r r r? | s �z*AddressHeader.addresses.<locals>.<genexpr>)r7 r6 ry r r r r r8 y s zAddressHeader.addresses) r( r2 r3 r_ r` r] rZ rD rG r4 rw r8 rn r r rm r rp J s rp c @ s e Zd ZdZdS )�UniqueAddressHeaderr9 Nrc r r r r r| � s r| c @ s e Zd Zedd� �ZdS )�SingleAddressHeaderc C s( t | j�dkr td�| j���| jd S )Nr9 z9value of single address header {} is not a single addressr )r$ r8 r r rI r r r r r{ � s �zSingleAddressHeader.addressN)r( r2 r3 r4 r{ r r r r r} � s r} c @ s e Zd ZdZdS )�UniqueSingleAddressHeaderr9 Nrc r r r r r~ � s r~ c sZ e Zd ZdZeej�Zedd� �Z � fdd�Z e dd� �Z e dd � �Z e d d � �Z� ZS ) �MIMEVersionHeaderr9 c C s� | � |� |d< }t|�|d< |d �|j� |jd kr<d n|j|d< |j|d< |jd k rtd�|d |d �|d< nd |d< d S )NrO rC rB �major�minorz{}.{}�version)r] r< �extendr r� r� r �rH rJ rK rO r r r rD � s zMIMEVersionHeader.parsec s6 |� d�| _|� d�| _|� d�| _t� j||� d S )Nr� r� r� )rg �_version�_major�_minorri rG rj rm r r rG � s zMIMEVersionHeader.initc C s | j S r )r� r r r r r� � s zMIMEVersionHeader.majorc C s | j S r )r� r r r r r� � s zMIMEVersionHeader.minorc C s | j S r )r� r r r r r� � s zMIMEVersionHeader.version)r( r2 r3 r_ r` r Zparse_mime_versionr] rZ rD rG r4 r� r� r� rn r r rm r r � s r c s8 e Zd ZdZedd� �Z� fdd�Zedd� �Z� Z S )�ParameterizedMIMEHeaderr9 c C sZ | � |� |d< }t|�|d< |d �|j� |jd krBi |d< ndd� |jD �|d< d S )NrO rC rB �paramsc S s& i | ] \}}t �|��� t �|��qS r )r rE �lower)r= rI rJ r r r � <dictcomp>� s � z1ParameterizedMIMEHeader.parse.<locals>.<dictcomp>)r] r< r� r r� r� r r r rD � s �z ParameterizedMIMEHeader.parsec s |� d�| _t� j||� d S )Nr� )rg �_paramsri rG rj rm r r rG � s z ParameterizedMIMEHeader.initc C s t | j�S r )r r� r r r r r� � s z ParameterizedMIMEHeader.params) r( r2 r3 r_ rZ rD rG r4 r� rn r r rm r r� � s r� c sJ e Zd Zeej�Z� fdd�Zedd� �Z edd� �Z edd� �Z � Z S ) �ContentTypeHeaderc s2 t � j||� t�| jj�| _t�| jj�| _d S r ) ri rG r rE rM �maintype� _maintype�subtype�_subtyperj rm r r rG � s zContentTypeHeader.initc C s | j S r )r� r r r r r� � s zContentTypeHeader.maintypec C s | j S r )r� r r r r r� � s zContentTypeHeader.subtypec C s | j d | j S )N�/)r� r� r r r r � content_type� s z ContentTypeHeader.content_type) r( r2 r3 r` r Zparse_content_type_headerr] rG r4 r� r� r� rn r r rm r r� � s r� c s2 e Zd Zeej�Z� fdd�Zedd� �Z � Z S )�ContentDispositionHeaderc s2 t � j||� | jj}|d kr"|nt�|�| _d S r )ri rG rM �content_dispositionr rE �_content_disposition)r rk rl Zcdrm r r rG � s z ContentDispositionHeader.initc C s | j S r )r� r r r r r� � s z,ContentDispositionHeader.content_disposition) r( r2 r3 r` r Z parse_content_disposition_headerr] rG r4 r� rn r r rm r r� � s r� c sB e Zd ZdZeej�Zedd� �Z � fdd�Z e dd� �Z � Z S )� ContentTransferEncodingHeaderr9 c C s2 | � |� |d< }t|�|d< |d �|j� d S �NrO rC rB �r] r< r� r r� r r r rD s z#ContentTransferEncodingHeader.parsec s" t � j||� t�| jj�| _d S r )ri rG r rE rM �cte�_cterj rm r r rG s z"ContentTransferEncodingHeader.initc C s | j S r )r� r r r r r� s z!ContentTransferEncodingHeader.cte)r( r2 r3 r_ r` r Z&parse_content_transfer_encoding_headerr] rZ rD rG r4 r� rn r r rm r r� � s r� c @ s& e Zd ZdZeej�Zedd� �Z dS )�MessageIDHeaderr9 c C s2 | � |� |d< }t|�|d< |d �|j� d S r� r� r� r r r rD s zMessageIDHeader.parseN) r( r2 r3 r_ r` r Zparse_message_idr] rZ rD r r r r r� s r� )Zsubject�datez resent-datez orig-dateZsenderz resent-sender�toz resent-toZccz resent-ccZbccz resent-bcc�fromz resent-fromzreply-toz mime-versionz content-typezcontent-dispositionzcontent-transfer-encodingz message-idc @ s4 e Zd Zeedfdd�Zdd� Zdd� Zdd � Zd S ) �HeaderRegistryTc C s& i | _ || _|| _|r"| j �t� d S r )�registry� base_class� default_class�update�_default_header_map)r r� r� Zuse_default_mapr r r r 9 s zHeaderRegistry.__init__c C s || j |�� < d S r )r� r� �r rI rH r r r � map_to_typeK s zHeaderRegistry.map_to_typec C s, | j �|�� | j�}td|j || jfi �S )N�_)r� �getr� r� r. r( r� r� r r r � __getitem__Q s zHeaderRegistry.__getitem__c C s | | ||�S r r )r rI rJ r r r �__call__U s zHeaderRegistry.__call__N) r( r2 r3 rA r\ r r� r� r� r r r r r� 5 s � r� N) �typesr Zemailr r r r r r5 r< rA rP r\ rb rd ro rp r| r} r~ r r� r� r� r� r� r� r� r r r r �<module> sV `6d '7 % � __pycache__/parser.cpython-38.opt-2.pyc 0000644 00000005222 15204103444 0013636 0 ustar 00 U e5d� � @ s| d dddddgZ ddlmZmZ ddlmZmZ dd lmZ G d d � d �Z G d d� de �Z G d d� d�Z G d d� de �Z dS )�Parser� HeaderParser� BytesParser�BytesHeaderParser� FeedParser�BytesFeedParser� )�StringIO� TextIOWrapper)r r )�compat32c @ s0 e Zd Zd ed�dd�Zd dd�Zd dd �ZdS ) r N��policyc C s || _ || _d S �N)�_classr )�selfr r � r �$/usr/lib64/python3.8/email/parser.py�__init__ s zParser.__init__Fc C s@ t | j| jd�}|r |�� |�d�}|s,q8|�|� q |�� S )Nr i )r r r Z_set_headersonly�readZfeed�close)r �fp� headersonlyZ feedparser�datar r r �parse) s z Parser.parsec C s | j t|�|d�S )N�r )r r �r �textr r r r �parsestr; s zParser.parsestr)N)F)F)�__name__� __module__� __qualname__r r r r r r r r r s c @ s e Zd Zddd�Zddd�ZdS ) r Tc C s t �| |d�S �NT)r r �r r r r r r r H s zHeaderParser.parsec C s t �| |d�S r )r r r r r r r K s zHeaderParser.parsestrN)T)T)r r r r r r r r r r G s c @ s( e Zd Zdd� Zd dd�Zd dd�ZdS ) r c O s t ||�| _d S r )r �parser)r �args�kwr r r r Q s zBytesParser.__init__Fc C s0 t |ddd�}z| j�||�W �S |�� X d S )N�ascii�surrogateescape)�encoding�errors)r �detachr" r r! r r r r c s zBytesParser.parsec C s |j ddd�}| j�||�S )N�ASCIIr& )r( )�decoder" r r r r r � parsebytesr s zBytesParser.parsebytesN)F)F)r r r r r r, r r r r r O s c @ s e Zd Zddd�Zddd�ZdS ) r Tc C s t j| |dd�S �NTr )r r r! r r r r s zBytesHeaderParser.parsec C s t j| |dd�S r- )r r, r r r r r, � s z BytesHeaderParser.parsebytesN)T)T)r r r r r, r r r r r ~ s N) �__all__�ior r Zemail.feedparserr r Zemail._policybaser r r r r r r r r �<module> s � 7/ __pycache__/policy.cpython-38.opt-1.pyc 0000644 00000022674 15204103444 0013652 0 ustar 00 U e5d�( � @ s� d Z ddlZddlZddlmZmZmZmZ ddlm Z ddl m Z ddl m Z ddlmZ dd d d d d ddgZe�d�ZeG dd � d e��Ze� Ze`ejdd�Zejdd�Zejddd�Zejdd�ZdS )zcThis will be the home for the policy that hooks in the new code that adds all the email6 features. � N)�Policy�Compat32�compat32�_extend_docstrings)�_has_surrogates)�HeaderRegistry)�raw_data_manager)� EmailMessager r r � EmailPolicy�default�strict�SMTP�HTTPz\n|\rc sp e Zd ZdZeZdZdZe� Z e Z � fdd�Z dd� Z dd � Zd d � Zd d � Zdd� Zdd� Zddd�Z� ZS )r aQ + PROVISIONAL The API extensions enabled by this policy are currently provisional. Refer to the documentation for details. This policy adds new header parsing and folding algorithms. Instead of simple strings, headers are custom objects with custom attributes depending on the type of the field. The folding algorithm fully implements RFCs 2047 and 5322. In addition to the settable attributes listed above that apply to all Policies, this policy adds the following additional attributes: utf8 -- if False (the default) message headers will be serialized as ASCII, using encoded words to encode any non-ASCII characters in the source strings. If True, the message headers will be serialized using utf8 and will not contain encoded words (see RFC 6532 for more on this serialization format). refold_source -- if the value for a header in the Message object came from the parsing of some source, this attribute indicates whether or not a generator should refold that value when transforming the message back into stream form. The possible values are: none -- all source values use original folding long -- source values that have any line that is longer than max_line_length will be refolded all -- all values are refolded. The default is 'long'. header_factory -- a callable that takes two arguments, 'name' and 'value', where 'name' is a header field name and 'value' is an unfolded header field value, and returns a string-like object that represents that header. A default header_factory is provided that understands some of the RFC5322 header field types. (Currently address fields and date fields have special treatment, while all other fields are treated as unstructured. This list will be completed before the extension is marked stable.) content_manager -- an object with at least two methods: get_content and set_content. When the get_content or set_content method of a Message object is called, it calls the corresponding method of this object, passing it the message object as its first argument, and any arguments or keywords that were passed to it as additional arguments. The default content_manager is :data:`~email.contentmanager.raw_data_manager`. F�longc s* d|krt �| dt� � t� jf |� d S )N�header_factory)�object� __setattr__r �super�__init__)�self�kw�� __class__� �$/usr/lib64/python3.8/email/policy.pyr ] s zEmailPolicy.__init__c C s | j | jS )z�+ The implementation for this class returns the max_count attribute from the specialized header class that would be used to construct a header of type 'name'. )r Z max_count)r �namer r r �header_max_countd s z EmailPolicy.header_max_countc C s> |d � dd�\}}|�d�d�|dd� � }||�d�fS )ac + The name is parsed as everything up to the ':' and returned unmodified. The value is determined by stripping leading whitespace off the remainder of the first line, joining all subsequent lines together, and stripping any trailing carriage return or linefeed characters. (This is the same as Compat32). r �:� z � N� )�split�lstrip�join�rstrip)r Z sourcelinesr �valuer r r �header_source_parsev s z EmailPolicy.header_source_parsec C sV t |d�r$|j�� |�� kr$||fS t|t�rFt|�� �dkrFtd��|| �||�fS )a� + The name is returned unchanged. If the input value has a 'name' attribute and it matches the name ignoring case, the value is returned unchanged. Otherwise the name and value are passed to header_factory method, and the resulting custom header object is returned as the value. In this case a ValueError is raised if the input value contains CR or LF characters. r r zDHeader values may not contain linefeed or carriage return characters) �hasattrr �lower� isinstance�str�len� splitlines� ValueErrorr �r r r% r r r �header_store_parse� s z EmailPolicy.header_store_parsec C s* t |d�r|S d�t�|��}| �||�S )ai + If the value has a 'name' attribute, it is returned to unmodified. Otherwise the name and the value with any linesep characters removed are passed to the header_factory method, and the resulting custom header object is returned. Any surrogateescaped bytes get turned into the unicode unknown-character glyph. r r )r' r# �linesep_splitterr! r r. r r r �header_fetch_parse� s z EmailPolicy.header_fetch_parsec C s | j ||dd�S )a + Header folding is controlled by the refold_source policy setting. A value is considered to be a 'source value' if and only if it does not have a 'name' attribute (having a 'name' attribute means it is a header object of some sort). If a source value needs to be refolded according to the policy, it is converted into a custom header object by passing the name and the value with any linesep characters removed to the header_factory method. Folding of a custom header object is done by calling its fold method with the current policy. Source values are split into lines using splitlines. If the value is not to be refolded, the lines are rejoined using the linesep from the policy and returned. The exception is lines containing non-ascii binary data. In that case the value is refolded regardless of the refold_source setting, which causes the binary data to be CTE encoded using the unknown-8bit charset. T�� refold_binary)�_foldr. r r r �fold� s zEmailPolicy.foldc C s0 | j ||| jdkd�}| jr dnd}|�|d�S )a + The same as fold if cte_type is 7bit, except that the returned value is bytes. If cte_type is 8bit, non-ASCII binary data is converted back into bytes. Headers with binary data are not refolded, regardless of the refold_header setting, since there is no way to know whether the binary data consists of single byte characters or multibyte characters. If utf8 is true, headers are encoded to utf8, otherwise to ascii with non-ASCII unicode rendered as encoded words. Z7bitr2 �utf8�ascii�surrogateescape)r4 Zcte_typer6 �encode)r r r% Zfolded�charsetr r r � fold_binary� s zEmailPolicy.fold_binaryc s� t |d�r|j| d�S | jr"| jntj� |�� }| jdkp�| jdko�|rdt|d �t|� d � kp�t� fdd�|d d � D ��}|s�|r�t |�r�| � |d � |��j| d�S |d | j � |� | j S ) Nr )Zpolicy�allr r � c 3 s | ]}t |�� kV qd S )N)r+ )�.0�x��maxlenr r � <genexpr>� s z$EmailPolicy._fold.<locals>.<genexpr>r r z: ) r' r5 �max_line_length�sys�maxsizer, � refold_sourcer+ �anyr r r# �linesep)r r r% r3 �linesZrefoldr r@ r r4 � s �zEmailPolicy._fold)F)�__name__� __module__� __qualname__�__doc__r Zmessage_factoryr6 rF r r r Zcontent_managerr r r& r/ r1 r5 r; r4 � __classcell__r r r r r s : T)Zraise_on_defectr )rH )rH rC )r6 )rM �rerD Zemail._policybaser r r r Z email.utilsr Zemail.headerregistryr Zemail.contentmanagerr Z email.messager �__all__�compiler0 r r r Zcloner r r ZSMTPUTF8r r r r �<module> s4 � @ __pycache__/generator.cpython-38.pyc 0000644 00000030356 15204103444 0013376 0 ustar 00 U e5d�N � @ s� d Z dddgZddlZddlZddlZddlZddlmZ ddlm Z m Z ddl m Z d Z d Ze�d �Ze�d ej�ZG d d� d�ZG dd� de�ZdZG dd� de�Zeeejd ��Zde Zej Z dS )z:Classes to generate plain text from a message object tree.� Generator�DecodedGenerator�BytesGenerator� N)�deepcopy)�StringIO�BytesIO)�_has_surrogates�_� z \r\n|\r|\nz^From c @ s� e Zd ZdZd'dd�dd�Zdd� Zd(d d �Zd d � Zd d� Zdd� Z dd� Z dd� Z dd� Z dd� Z dd� ZeZdd � Zd d � Zd d � Zd!d"� Zed)d#d$��Zed%d&� �ZdS )*r z�Generates output from a Message object tree. This basic generator writes the message to the given file object as plain text. N��policyc C s6 |dkr|dkrdn|j }|| _|| _|| _|| _dS )a� Create the generator for message flattening. outfp is the output file-like object for writing the message to. It must have a write() method. Optional mangle_from_ is a flag that, when True (the default if policy is not set), escapes From_ lines in the body of the message by putting a `>' in front of them. Optional maxheaderlen specifies the longest length for a non-continued header. When a header line is longer (in characters, with tabs expanded to 8 spaces) than maxheaderlen, the header will split as defined in the Header class. Set maxheaderlen to zero to disable header wrapping. The default is 78, as recommended (but not required) by RFC 2822. The policy keyword specifies a policy object that controls a number of aspects of the generator's operation. If no policy is specified, the policy associated with the Message object passed to the flatten method is used. NT)� mangle_from_�_fp� _mangle_from_� maxheaderlenr )�self�outfpr r r � r �'/usr/lib64/python3.8/email/generator.py�__init__$ s zGenerator.__init__c C s | j �|� d S �N)r �write�r �sr r r r D s zGenerator.writeFc C s� | j dkr|j n| j }|dk r*|j|d�}| jdk rB|j| jd�}|j| _| �| j�| _d| _| �| j�| _| j }|j }zL|| _ ||_ |r�|� � }|s�dt � t � � � }| � || j � | � |� W 5 || _ ||_ X dS )a� Print the message object tree rooted at msg to the output file specified when the Generator instance was created. unixfrom is a flag that forces the printing of a Unix From_ delimiter before the first object in the message tree. If the original message has no From_ delimiter, a `standard' one is crafted. By default, this is False to inhibit the printing of any From_ delimiter. Note that for subobjects, no From_ line is printed. linesep specifies the characters used to indicate a new line in the output. The default value is determined by the policy specified when the Generator instance was created or, if none was specified, from the policy associated with the msg. N)�linesep�Zmax_line_length� z From nobody )r �cloner r �_NL�_encode� _encoded_NLZ_EMPTY�_encoded_EMPTYZ get_unixfrom�time�ctimer �_write)r �msg�unixfromr r Zold_gen_policyZold_msg_policyZufromr r r �flattenH s, zGenerator.flattenc C s | j || jd| jd�S )z1Clone this generator with the exact same options.Nr )� __class__r r )r �fpr r r r y s �zGenerator.clonec C s t � S r )r �r r r r � _new_buffer� s zGenerator._new_bufferc C s |S r r r r r r r � s zGenerator._encodec C sT |sd S t �|�}|d d� D ]}| �|� | �| j� q |d rP| �|d � d S )N���)�NLCRE�splitr r )r �lines�liner r r � _write_lines� s zGenerator._write_linesc C s� | j }z"d | _| �� | _ }| �|� W 5 || _ | j}| `X |r�t|�}|�d�d krd|d |d< n|�d|d � |�d|d � t|dd �}|d kr�| �|� n|| � | j � |� � � d S )N�content-transfer-encodingr �Content-Transfer-Encoding� content-type� �_write_headers) r � _munge_cter+ � _dispatchr �getZreplace_header�getattrr6 r �getvalue)r r% ZoldfpZ munge_cteZsfp�methr r r r$ � s& zGenerator._writec C st |� � }|�� }t�||f��dd�}t| d| d �}|d krh|�dd�}t| d| d �}|d krh| j}||� d S )N�-r Z_handle_)�get_content_maintype�get_content_subtype� UNDERSCORE�join�replacer: � _writeBody)r r% �main�subZspecificr< Zgenericr r r r8 � s zGenerator._dispatchc C s6 |� � D ] \}}| �| j�||�� q| �| j� d S r )� raw_itemsr r Zfoldr �r r% �h�vr r r r6 � s zGenerator._write_headersc C s� |� � }|d krd S t|t�s.tdt|� ��t|j�r~|�d�}|d k r~t|�}|d= |� ||� |� � }|d |d f| _ | j r�t � d|�}| �|� d S )Nzstring payload expected: %s�charsetr2 r4 �>From )� get_payload� isinstance�str� TypeError�typer �_payloadZ get_paramr Z set_payloadr7 r �fcrerE r1 )r r% �payloadrJ r r r � _handle_text� s$ � zGenerator._handle_textc C s� g }|� � }|d krg }n(t|t�r2| �|� d S t|t�sB|g}|D ]6}| �� }| �|�}|j|d| jd� |� |� � � qF|� � }|s�| j � |�}| �|�}|�|� |jd k r�| jr�t�d|j�} n|j} | �| � | �| j� | �d| | j � |�r| j�|�d�� |D ],} | �| jd | | j � | j�| � �q| �| jd | d | j � |jd k �r�| j�r�t�d|j�} n|j} | �| � d S )NF�r& r rK z--r )rL rM rN r �listr+ r r' r �appendr; Z get_boundaryr rA �_make_boundaryZ set_boundary�preambler rR rE r1 r �pop�epilogue) r r% ZmsgtextsZsubparts�partr �g�boundaryZalltextrY Z body_partr[ r r r �_handle_multipart sJ zGenerator._handle_multipartc C s0 | j }|jdd�| _ z| �|� W 5 || _ X d S )Nr r )r r r_ )r r% �pr r r �_handle_multipart_signed< s z"Generator._handle_multipart_signedc C s� g }|� � D ]t}| �� }| �|�}|j|d| jd� |�� }|�| j�}|rv|d | jkrv|� | j� |d d� �� q |� |� q | j � | j� |�� d S )NFrU r, ) rL r+ r r' r r; r. r r! rW rA r r )r r% Zblocksr\ r r] �textr/ r r r � _handle_message_delivery_statusG s z)Generator._handle_message_delivery_statusc C s^ | � � }| �|�}|j}t|t�rD|j|�d�d| jd� |�� }n | � |�}| j � |� d S )Nr FrU ) r+ r rQ rM rV r' rL r r; r r r )r r% r r] rS r r r �_handle_message\ s zGenerator._handle_messagec C sv t �tj�}dt| d }|d kr(|S |}d}| �dt�|� d tj�}|� |�sXqr|d t |� }|d7 }q0|S )Nz===============z==r z^--z(--)?$�.r5 ) �randomZ randrange�sys�maxsize�_fmt� _compile_re�re�escape� MULTILINE�searchrN )�clsrb �tokenr^ �bZcounterZcrer r r rX u s zGenerator._make_boundaryc C s t �||�S r )rk �compile�ro r �flagsr r r rj � s zGenerator._compile_re)NN)FN)N)�__name__� __module__� __qualname__�__doc__r r r' r r+ r r1 r$ r8 r6 rT rC r_ ra rc rd � classmethodrX rj r r r r r s. � 1' : c sP e Zd ZdZdd� Zdd� Zdd� Zdd � Z� fd d �ZeZ e d d � �Z � Z S )r a� Generates a bytes version of a Message object tree. Functionally identical to the base Generator except that the output is bytes and not string. When surrogates were used in the input to encode bytes, these are decoded back to bytes for output. If the policy has cte_type set to 7bit, then the message is transformed such that the non-ASCII bytes are properly content transfer encoded, using the charset unknown-8bit. The outfp object must accept bytes in its write method. c C s | j �|�dd�� d S )N�ascii�surrogateescape)r r �encoder r r r r � s zBytesGenerator.writec C s t � S r )r r* r r r r+ � s zBytesGenerator._new_bufferc C s |� d�S �Nrz )r| r r r r r � s zBytesGenerator._encodec C s8 |� � D ] \}}| j�| j�||�� q| �| j� d S r )rF r r r Z fold_binaryr rG r r r r6 � s z BytesGenerator._write_headersc s\ |j d krd S t|j �rH| jjdksH| jr:t�d|j �|_ | �|j � ntt | �� |� d S )NZ7bitrK ) rQ r r Zcte_typer rR rE r1 �superr rT )r r% �r( r r rT � s zBytesGenerator._handle_textc C s t �|�d�|�S r} )rk rr r| rs r r r rj � s zBytesGenerator._compile_re) ru rv rw rx r r+ r r6 rT rC ry rj � __classcell__r r r r r � s zD[Non-text (%(type)s) part of message omitted, filename %(filename)s]c @ s( e Zd ZdZddd�dd�Zdd� ZdS ) r z�Generates a text representation of a message. Like the Generator base class, except that non-text parts are substituted with a format string representing the part. Nr c C s. t j| ||||d� |dkr$t| _n|| _dS )a� Like Generator.__init__() except that an additional optional argument is allowed. Walks through all subparts of a message. If the subpart is of main type `text', then it prints the decoded payload of the subpart. Otherwise, fmt is a format string that is used instead of the message payload. fmt is expanded with the following keywords (in %(keyword)s format): type : Full MIME type of the non-text part maintype : Main MIME type of the non-text part subtype : Sub-MIME type of the non-text part filename : Filename of the non-text part description: Description associated with the non-text part encoding : Content transfer encoding of the non-text part The default value for fmt is None, meaning [Non-text (%(type)s) part of message omitted, filename %(filename)s] r N)r r �_FMTri )r r r r Zfmtr r r r r � s �zDecodedGenerator.__init__c C s� |� � D ]v}|�� }|dkr2t|jdd�| d� q|dkr<qt| j|�� |�� |�� |�d�|�dd�|�d d �d � | d� qd S ) Nrb F)�decode)�fileZ multipartz [no filename]zContent-Descriptionz[no description]r3 z [no encoding])rP �maintypeZsubtype�filenameZ description�encoding) �walkr> �printrL ri Zget_content_typer? � get_filenamer9 )r r% r\ r� r r r r8 � s( ��� �zDecodedGenerator._dispatch)NNN)ru rv rw rx r r8 r r r r r � s � r5 z%%0%dd) rx �__all__rk rg r" rf �copyr �ior r Z email.utilsr r@ �NLrr r- rm rR r r r� r �len�reprrh Z_widthri rX r r r r �<module> s* t3; __pycache__/_policybase.cpython-38.opt-1.pyc 0000644 00000034734 15204103444 0014644 0 ustar 00 U e5d�: � @ s� d Z ddlZddlmZ ddlmZ ddlmZ dddgZG d d � d �Z d d � Z d d� Z G dd� de ej d�Z e G dd� de ��Ze� ZdS )zwPolicy framework for the email package. Allows fine grained feature control of how the package parses and emits data. � N)�header)�charset)�_has_surrogates�Policy�Compat32�compat32c s@ e Zd ZdZ� fdd�Zdd� Zdd� Zdd � Zd d � Z� Z S ) � _PolicyBasea� Policy Object basic framework. This class is useless unless subclassed. A subclass should define class attributes with defaults for any values that are to be managed by the Policy object. The constructor will then allow non-default values to be set for these attributes at instance creation time. The instance will be callable, taking these same attributes keyword arguments, and returning a new instance identical to the called instance except for those values changed by the keyword arguments. Instances may be added, yielding new instances with any non-default values from the right hand operand overriding those in the left hand operand. That is, A + B == A(<non-default values of B>) The repr of an instance can be used to reconstruct the object if and only if the repr of the values can be used to reconstruct those values. c sH |� � D ]:\}}t| |�r.tt| ��||� qtd�|| jj���qdS )z�Create new Policy, possibly overriding some defaults. See class docstring for a list of overridable attributes. �*{!r} is an invalid keyword argument for {}N) �items�hasattr�superr � __setattr__� TypeError�format� __class__�__name__)�self�kw�name�value�r � �)/usr/lib64/python3.8/email/_policybase.py�__init__) s ��z_PolicyBase.__init__c C s* dd� | j �� D �}d�| jjd�|��S )Nc S s g | ]\}}d � ||��qS )z{}={!r})r )�.0r r r r r � <listcomp>8 s �z(_PolicyBase.__repr__.<locals>.<listcomp>z{}({})z, )�__dict__r r r r �join)r �argsr r r �__repr__7 s �z_PolicyBase.__repr__c K sr | j �| j �}| j�� D ]\}}t�|||� q|�� D ]4\}}t| |�s^td�|| j j ���t�|||� q8|S )z�Return a new instance with specified attributes changed. The new instance has the same attribute values as the current object, except for the changes passed in as keyword arguments. r ) r �__new__r r �objectr r r r r )r r Z newpolicy�attrr r r r �clone< s ��z_PolicyBase.clonec C s, t | |�rd}nd}t|�| jj|���d S )Nz'{!r} object attribute {!r} is read-onlyz!{!r} object has no attribute {!r})r �AttributeErrorr r r )r r r �msgr r r r N s z_PolicyBase.__setattr__c C s | j f |j�S )z�Non-default values from right operand override those from left. The object returned is a new instance of the subclass. )r# r )r �otherr r r �__add__U s z_PolicyBase.__add__) r � __module__� __qualname__�__doc__r r r# r r' � __classcell__r r r r r s r c C s, | � dd�d } |�dd�d }| d | S )N� � r )�rsplit�split)�docZ added_docr r r � _append_doc^ s r1 c C s� | j r(| j �d�r(t| jd j | j �| _ | j�� D ]V\}}|j r2|j �d�r2dd� | jD �D ]*}tt||�d�}|r\t||j �|_ q2q\q2| S )N�+r c s s | ]}|� � D ] }|V qqd S )N)�mro)r �base�cr r r � <genexpr>h s z%_extend_docstrings.<locals>.<genexpr>r* )r* � startswithr1 � __bases__r r �getattr)�clsr r" r5 r0 r r r �_extend_docstringsc s r; c @ s� e Zd ZdZdZdZdZdZdZdZ dd� Z d d � Z d d � Z e jd d� �Ze jdd� �Ze jdd� �Ze jdd� �Ze jdd� �ZdS )r aI Controls for how messages are interpreted and formatted. Most of the classes and many of the methods in the email package accept Policy objects as parameters. A Policy object contains a set of values and functions that control how input is interpreted and how output is rendered. For example, the parameter 'raise_on_defect' controls whether or not an RFC violation results in an error being raised or not, while 'max_line_length' controls the maximum length of output lines when a Message is serialized. Any valid attribute may be overridden when a Policy is created by passing it as a keyword argument to the constructor. Policy objects are immutable, but a new Policy object can be created with only certain values changed by calling the Policy instance with keyword arguments. Policy objects can also be added, producing a new Policy object in which the non-default attributes set in the right hand operand overwrite those specified in the left operand. Settable attributes: raise_on_defect -- If true, then defects should be raised as errors. Default: False. linesep -- string containing the value to use as separation between output lines. Default '\n'. cte_type -- Type of allowed content transfer encodings 7bit -- ASCII only 8bit -- Content-Transfer-Encoding: 8bit is allowed Default: 8bit. Also controls the disposition of (RFC invalid) binary data in headers; see the documentation of the binary_fold method. max_line_length -- maximum length of lines, excluding 'linesep', during serialization. None or 0 means no line wrapping is done. Default is 78. mangle_from_ -- a flag that, when True escapes From_ lines in the body of the message by putting a `>' in front of them. This is used when the message is being serialized by a generator. Default: True. message_factory -- the class to use to create new message objects. If the value is None, the default is Message. Fr, Z8bit�N Nc C s | j r |�| �||� dS )aZ Based on policy, either raise defect or call register_defect. handle_defect(obj, defect) defect should be a Defect subclass, but in any case must be an Exception subclass. obj is the object on which the defect should be registered if it is not raised. If the raise_on_defect is True, the defect is raised as an error, otherwise the object and the defect are passed to register_defect. This method is intended to be called by parsers that discover defects. The email package parsers always call it with Defect instances. N)�raise_on_defect�register_defect�r �objZdefectr r r � handle_defect� s zPolicy.handle_defectc C s |j �|� dS )a� Record 'defect' on 'obj'. Called by handle_defect if raise_on_defect is False. This method is part of the Policy API so that Policy subclasses can implement custom defect handling. The default implementation calls the append method of the defects attribute of obj. The objects used by the email package by default that get passed to this method will always have a defects attribute with an append method. N)Zdefects�appendr? r r r r> � s zPolicy.register_defectc C s dS )a[ Return the maximum allowed number of headers named 'name'. Called when a header is added to a Message object. If the returned value is not 0 or None, and there are already a number of headers with the name 'name' equal to the value returned, a ValueError is raised. Because the default behavior of Message's __setitem__ is to append the value to the list of headers, it is easy to create duplicate headers without realizing it. This method allows certain headers to be limited in the number of instances of that header that may be added to a Message programmatically. (The limit is not observed by the parser, which will faithfully produce as many headers as exist in the message being parsed.) The default implementation returns None for all header names. Nr )r r r r r �header_max_count� s zPolicy.header_max_countc C s t �dS )aZ Given a list of linesep terminated strings constituting the lines of a single header, return the (name, value) tuple that should be stored in the model. The input lines should retain their terminating linesep characters. The lines passed in by the email package may contain surrogateescaped binary data. N��NotImplementedError)r � sourcelinesr r r �header_source_parse� s zPolicy.header_source_parsec C s t �dS )z�Given the header name and the value provided by the application program, return the (name, value) that should be stored in the model. NrD �r r r r r r �header_store_parse� s zPolicy.header_store_parsec C s t �dS )aw Given the header name and the value from the model, return the value to be returned to the application program that is requesting that header. The value passed in by the email package may contain surrogateescaped binary data if the lines were parsed by a BytesParser. The returned value should not contain any surrogateescaped data. NrD rH r r r �header_fetch_parse� s zPolicy.header_fetch_parsec C s t �dS )a� Given the header name and the value from the model, return a string containing linesep characters that implement the folding of the header according to the policy controls. The value passed in by the email package may contain surrogateescaped binary data if the lines were parsed by a BytesParser. The returned value should not contain any surrogateescaped data. NrD rH r r r �fold� s z Policy.foldc C s t �dS )a% Given the header name and the value from the model, return binary data containing linesep characters that implement the folding of the header according to the policy controls. The value passed in by the email package may contain surrogateescaped binary data. NrD rH r r r � fold_binary s zPolicy.fold_binary)r r( r) r* r= �linesep�cte_type�max_line_length� mangle_from_Zmessage_factoryrA r> rC �abc�abstractmethodrG rI rJ rK rL r r r r r p s( 0 )� metaclassc @ sL e Zd ZdZdZdd� Zdd� Zdd� Zd d � Zd d � Z d d� Z dd� Z dS )r z�+ This particular policy is the backward compatibility Policy. It replicates the behavior of the email package version 5.1. Tc C s0 t |t�s|S t|�r(tj|tj|d�S |S d S )N�r � header_name)� isinstance�strr r �Header�_charset� UNKNOWN8BITrH r r r �_sanitize_header s �zCompat32._sanitize_headerc C s> |d � dd�\}}|�d�d�|dd� � }||�d�fS )a: + The name is parsed as everything up to the ':' and returned unmodified. The value is determined by stripping leading whitespace off the remainder of the first line, joining all subsequent lines together, and stripping any trailing carriage return or linefeed characters. r �:r- z � Nz )r/ �lstripr �rstrip)r rF r r r r r rG % s z Compat32.header_source_parsec C s ||fS )z>+ The name and value are returned unmodified. r rH r r r rI 1 s zCompat32.header_store_parsec C s | � ||�S )z�+ If the value contains binary data, it is converted into a Header object using the unknown-8bit charset. Otherwise it is returned unmodified. )r[ rH r r r rJ 7 s zCompat32.header_fetch_parsec C s | j ||dd�S )a + Headers are folded using the Header folding algorithm, which preserves existing line breaks in the value, and wraps each resulting line to the max_line_length. Non-ASCII binary data are CTE encoded using the unknown-8bit charset. T��sanitize)�_foldrH r r r rK > s z Compat32.foldc C s" | j ||| jdkd�}|�dd�S )a� + Headers are folded using the Header folding algorithm, which preserves existing line breaks in the value, and wraps each resulting line to the max_line_length. If cte_type is 7bit, non-ascii binary data is CTE encoded using the unknown-8bit charset. Otherwise the original source header is used, with its existing line breaks and/or binary data. Z7bitr` �ascii�surrogateescape)rb rN �encode)r r r Zfoldedr r r rL H s zCompat32.fold_binaryc C s� g }|� d| � t|t�r\t|�rL|r<tj|tj|d�}qZ|� |� d }q`tj||d�}n|}|d k r�d}| jd k r|| j}|� |j | j |d�� |� | j � d� |�S )Nz%s: rT )rU r )rM � maxlinelenr] ) rB rV rW r r rX rY rZ rO re rM r )r r r ra �parts�hrf r r r rb T s( � zCompat32._foldN) r r( r) r* rP r[ rG rI rJ rK rL rb r r r r r s )r* rQ Zemailr r rY Z email.utilsr �__all__r r1 r; �ABCMetar r r r r r r �<module> s �L f __pycache__/feedparser.cpython-38.pyc 0000644 00000024624 15204103444 0013531 0 ustar 00 U e5d�X � @ s� d Z ddgZddlZddlmZ ddlmZ ddlmZ ddl m Z e� d �Z e� d �Z e� d �Ze� d �Ze� d �Zd ZdZe� ZG dd� de�ZG dd� d�ZG dd� de�ZdS )a FeedParser - An email feed parser. The feed parser implements an interface for incrementally parsing an email message, line by line. This has advantages for certain applications, such as those reading email messages off a socket. FeedParser.feed() is the primary interface for pushing new data into the parser. It returns when there's nothing more it can do with the available data. When you have no more data to push into the parser, call .close(). This completes the parsing and returns the root message object. The other advantage of this parser is that it will never raise a parsing exception. Instead, when it finds something unexpected, it adds a 'defect' to the current message. Defects are just instances that live on the message object's .defects attribute. � FeedParser�BytesFeedParser� N)�errors)�compat32)�deque)�StringIOz \r\n|\r|\nz (\r\n|\r|\n)z(\r\n|\r|\n)\Zz%^(From |[\041-\071\073-\176]*:|[\t ])� � c @ s` e Zd ZdZdd� Zdd� Zdd� Zdd � Zd d � Zd d � Z dd� Z dd� Z dd� Z dd� Z dS )�BufferedSubFileak A file-ish object that can have new data loaded into it. You can also push and pop line-matching predicates onto a stack. When the current predicate matches the current line, a false EOF response (i.e. empty string) is returned instead. This lets the parser adhere to a simple abstraction -- it parses until EOF closes the current message. c C s$ t dd�| _t� | _g | _d| _d S )Nr )�newlineF)r �_partialr �_lines� _eofstack�_closed��self� r �(/usr/lib64/python3.8/email/feedparser.py�__init__5 s zBufferedSubFile.__init__c C s | j �|� d S �N)r �append)r Zpredr r r �push_eof_matcher@ s z BufferedSubFile.push_eof_matcherc C s | j �� S r )r �popr r r r �pop_eof_matcherC s z BufferedSubFile.pop_eof_matcherc C s< | j �d� | �| j �� � | j �d� | j �� d| _d S )Nr T)r �seek� pushlines� readlines�truncater r r r r �closeF s zBufferedSubFile.closec C sL | j s| jrdS tS | j �� }t| j�D ] }||�r(| j �|� dS q(|S �Nr )r r � NeedMoreData�popleft�reversedr � appendleft)r �lineZateofr r r �readlineN s zBufferedSubFile.readlinec C s |t k s t�| j�|� d S r )r �AssertionErrorr r# �r r$ r r r � unreadline` s zBufferedSubFile.unreadlinec C sx | j �|� d|kr d|kr dS | j �d� | j �� }| j �d� | j �� |d �d�sj| j �|�� � | �|� dS )z$Push some new data into this object.r � Nr ���)r �writer r r �endswithr r )r �data�partsr r r �pushe s zBufferedSubFile.pushc C s | j �|� d S r )r �extend)r �linesr r r r z s zBufferedSubFile.pushlinesc C s | S r r r r r r �__iter__} s zBufferedSubFile.__iter__c C s | � � }|dkrt�|S r )r% � StopIterationr' r r r �__next__� s zBufferedSubFile.__next__N)�__name__� __module__� __qualname__�__doc__r r r r r% r( r/ r r2 r4 r r r r r - s r c @ s` e Zd ZdZded�dd�Zdd� Zdd � Zd d � Zd d � Z dd� Z dd� Z dd� Z dd� Z dS )r z A feed-style parser of email.N��policyc C s� || _ d| _|dkr<|jdkr2ddlm} || _qn|j| _n2|| _z|| j d� W n tk rl d| _Y nX t� | _g | _ | � � j | _ d| _ d| _d| _dS )a _factory is called with no arguments to create a new message obj The policy keyword specifies a policy object that controls a number of aspects of the parser's operation. The default policy maintains backward compatibility. FNr )�Messager9 T)r: �_old_style_factoryZmessage_factoryZ email.messager; �_factory� TypeErrorr �_input� _msgstack� _parsegenr4 �_parse�_cur�_last� _headersonly)r r= r: r; r r r r � s$ zFeedParser.__init__c C s d| _ d S )NT)rE r r r r �_set_headersonly� s zFeedParser._set_headersonlyc C s | j �|� | �� dS )z Push more data into the parser.N)r? r/ � _call_parse�r r- r r r �feed� s zFeedParser.feedc C s& z | � � W n tk r Y nX d S r )rB r3 r r r r rG � s zFeedParser._call_parsec C sR | j �� | �� | �� }| jr$t�|�� dkrN|�� sNt� � }| j � ||� |S )z<Parse all remaining data and return the root message object.� multipart) r? r rG � _pop_messager@ r& �get_content_maintypeZ is_multipartr Z!MultipartInvariantViolationDefectr: � handle_defect)r �root�defectr r r r � s �zFeedParser.closec C sn | j r| �� }n| j| jd�}| jr<| j�� dkr<|�d� | jrR| jd �|� | j�|� || _|| _ d S )Nr9 zmultipart/digestzmessage/rfc822r* ) r< r= r: rC �get_content_typeZset_default_typer@ Zattachr rD )r �msgr r r � _new_message� s zFeedParser._new_messagec C s( | j �� }| j r | j d | _nd | _|S )Nr* )r@ r rC )r �retvalr r r rK � s zFeedParser._pop_messagec c s$ | � � g }| jD ]Z}|tkr&tV qt�|�sbt�|�s^t�� }| j� | j |� | j� |� qn|� |� q| � |� | jr�g }| j�� }|tkr�tV q�|dkr�q�|� |� q�| j �t�|�� d S | j �� dk�r�| j�tj� | �� D ] }|tk�rtV q� �q q�| �� }| j�� | j�� }|tk�rDtV �q �qD�q | j�� }|tk�rjtV �qD�qj�qD|dk�rx�q�| j� |� q�d S | j �� dk�r�| �� D ] }|tk�r�tV �q� �qĐq�| �� d S | j �� dk�r�| j �� }|d k�rRt�� }| j� | j |� g }| jD ]$}|tk�r.tV �q|� |� �q| j �t�|�� d S t| j � dd��� � dk�r�t� � }| j� | j |� d| }t � d t �!|� d �} d } g } d } d } | j�� }|tk�r�tV �q�|dk�r�q�| �|�}|�r�|�"d ��rd } |�"d�} �q�| �rr| �r^| d }t#�$|�}|�rP|d t%|�"d�� � | d< t�| �| j _&d } | j� |� �q�| j�� }|tk�r�tV �qr| �|�}|�sr| j� |� �q��qr| j�| j� | �� D ] }|tk�r�tV �q� �q�q�| j'�� dk�rT| j'j(}|dk�rd | j'_(n:|d k �r�t#�$|�}|�r�t%|�"d��}|d | � | j'_(nD| j'j)}t*|t��r�t#�$|�}|�r�|d t%|�"d�� � }|| j'_)| j�� | �� | j | _'n| �s�t+�| � |� �q�| �r4t�,� }| j� | j |� | j �t�| �� g }| jD ]}|tk�rtV �q�qt�|�| j _(d S | �sVt�-� }| j� | j |� d S | �rddg}ng }| jD ]$}|tk�r�tV �qn|� |� �qn|�r�|d }t.�|�}|�r�|t%|�"d��d � |d< t�|�| j _(d S g }| jD ]$}|tk�r tV �q�|� |� �q�| j �t�|�� d S )Nr zmessage/delivery-status�messagerJ zcontent-transfer-encoding�8bit)Z7bitrU Zbinaryz--z(?P<sep>z4)(?P<end>--)?(?P<ws>[ \t]*)(?P<linesep>\r\n|\r|\n)?$TF�end�linesepr* r )/rR r? r �headerRE�match�NLCREr Z MissingHeaderBodySeparatorDefectr: rM rC r( r �_parse_headersrE r% Z set_payload� EMPTYSTRING�joinrP r rA rK r rL Z get_boundaryZNoBoundaryInMultipartDefect�str�get�lowerZ-InvalidMultipartContentTransferEncodingDefect�re�compile�escape�group� NLCRE_eol�search�len�preamblerD �epilogueZ_payload� isinstancer& ZStartBoundaryNotFoundDefectZCloseBoundaryNotFoundDefect� NLCRE_bol)r Zheadersr$ rO r1 rS rQ �boundaryZ separatorZ boundaryreZcapturing_preamblerh rW Zclose_boundary_seen�moZlastlineZeolmori rV Zpayload� firstlineZbolmor r r rA � sb � �� zFeedParser._parsegenc C sj d}g }t |�D �]8\}}|d dkrR|sFt�|�}| j�| j|� q|�|� q|rt| jj| j�|�� dg }}|� d�r�|dkr�t � |�}|r�|d t |� d�� � }| j�|� qn<|t |�d kr�| j�|� d S t�|�}| jj�|� q|�d�}|dk�r&t�d�}| jj�|� q|dk�s8td��|d |� }|g}q|�rf| jj| j�|�� d S ) Nr r z zFrom � �:zMissing header name.z3_parse_headers fed line with no : and no leading WS)� enumerater Z#FirstHeaderLineIsContinuationDefectr: rM rC r Zset_rawZheader_source_parse� startswithre rf rg rd Z set_unixfromr? r( Z MisplacedEnvelopeHeaderDefectZdefects�findZInvalidHeaderDefectr& ) r r1 Z lastheaderZ lastvalue�linenor$ rO rm �ir r r r[ � sH zFeedParser._parse_headers)N)r5 r6 r7 r8 r r rF rI rG r rR rK rA r[ r r r r r � s ~c s e Zd ZdZ� fdd�Z� ZS )r z(Like FeedParser, but feed accepts bytes.c s t � �|�dd�� d S )N�ascii�surrogateescape)�superrI �decoderH �� __class__r r rI s zBytesFeedParser.feed)r5 r6 r7 r8 rI � __classcell__r r rz r r s )r8 �__all__ra Zemailr Zemail._policybaser � collectionsr �ior rb rZ rk re Z NLCRE_crackrX r\ �NL�objectr r r r r r r r �<module> s( [ __pycache__/quoprimime.cpython-38.opt-2.pyc 0000644 00000010157 15204103444 0014534 0 ustar 00 U e5d�& � @ sT d ddddddddd g Z d d lZd d lmZmZmZ d ZdZdZdd� e d�D �Z e d d � Z e d d � Z de� d� e� d� D ]Zee�e e< q�de ed�< dD ]Zee�e e< q�dd� Zdd� Zd d� Zd d� Zd+d d �Zd d � Zd!d� Zd,d#d�Ze d d � Zd$D ]Zee�ee< �q d%efd&d�Zefd'd�ZeZ eZ d(d)� Z d*d� Z d S )-� body_decode� body_encode� body_length�decode� decodestring� header_decode� header_encode� header_length�quote�unquote� N)� ascii_letters�digits� hexdigits� � � c C s g | ] }d | �qS )z=%02X� )�.0�cr r �(/usr/lib64/python3.8/email/quoprimime.py� <listcomp>7 s r � s -!*+/�ascii�_� s_ !"#$%&'()*+,-./0123456789:;<>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~ c C s t | �t| kS �N)�chr�_QUOPRI_HEADER_MAP��octetr r r � header_checkJ s r c C s t | �t| kS r )r �_QUOPRI_BODY_MAPr r r r � body_checkO s r" c C s t dd� | D ��S )Nc s s | ]}t t| �V qd S r )�lenr �r r r r r � <genexpr>^ s z header_length.<locals>.<genexpr>��sum�� bytearrayr r r r T s c C s t dd� | D ��S )Nc s s | ]}t t| �V qd S r )r# r! r$ r r r r% h s z body_length.<locals>.<genexpr>r& r( r r r r a s c C sf t |t�st|�}| s&| �|�� � n<t| d �t|� |krT| d || 7 < n| �|�� � d S )N���)� isinstance�strr �append�lstripr# )�L�s�maxlenZextrar r r � _max_appendk s r2 c C s t t| dd� d��S )N� � � )r �int�r0 r r r r v s c C s t t| � S r )� _QUOPRI_MAP�ord)r r r r r { s � iso-8859-1c C s$ | sdS | � d��t�}d||f S )Nr �latin1z =?%s?q?%s?=)r � translater )Z header_bytes�charset�encodedr r r r s s �L c C s� |dk rt d��| s| S | �t�} d| }|d }g }|j}| �� D �] }d}t|�d | } || kr�|| } || d dkr�|||| d � � | d }q^|| d dkr�|||| � � | d }q^|||| � d � | }q^|�rR|d dk�rR|| } | d k�rt|d �} n(| dk�r,|d | } n|t|d � } |||d� | � qD|||d � � qD| d tk�rz|d � |�|�S ) N� z maxlinelen must be at least 4�=r3 r � r* z r4 r ) � ValueErrorr< �_QUOPRI_BODY_ENCODE_MAPr- � splitlinesr# r �CRLF�join) ZbodyZ maxlinelen�eolZ soft_breakZ maxlinelen1Z encoded_bodyr- �line�startZ laststart�stopZroom�qr r r r � sD c C s | s| S d}| � � D ]�}|�� }|s.||7 }qd}t|�}||k r|| }|dkrd||7 }|d7 }nv|d |kr||d7 }q:n^|d |k r�||d tkr�||d tkr�|t|||d � �7 }|d7 }n||7 }|d7 }||kr:||7 }q:q| d dk�r|�|��r|d d� }|S ) Nr r rA r3 rB r4 r* r )rE �rstripr# r r �endswith)r> rH ZdecodedrI �i�nr r r r r � s8 , c C s | � d�}t|�S )Nr )�groupr )�matchr0 r r r �_unquote_match s rS c C s | � dd�} tjdt| tjd�S )Nr r z=[a-fA-F0-9]{2})�flags)�replace�re�subrS �ASCIIr7 r r r r # s )r )r: ) �__all__rV �stringr r r rF �NLZ EMPTYSTRING�ranger8 r r! �encoder r r9 r r" r r r2 r r r rD r r r r rS r r r r r �<module> sP � O 0 __pycache__/quoprimime.cpython-38.opt-1.pyc 0000644 00000017000 15204103444 0014525 0 ustar 00 U e5d�& � @ sX d Z ddddddddd d g Zd d lZd d lmZmZmZ dZdZdZ dd� e d�D �Z e d d � Z e d d � Z de�d� e�d� D ]Zee�e e< q�de ed�< dD ]Zee�e e< q�dd� Zdd � Zd d� Zd d� Zd,d d �Zd!d � Zd"d � Zd-d$d�Ze d d � Zd%D ]Zee�ee< �qd&efd'd�Zefd(d�Z e Z e Z d)d*� Z d+d� Z d S ).aF Quoted-printable content transfer encoding per RFCs 2045-2047. This module handles the content transfer encoding method defined in RFC 2045 to encode US ASCII-like 8-bit data called `quoted-printable'. It is used to safely encode text that is in a character set similar to the 7-bit US ASCII character set, but that includes some 8-bit characters that are normally not allowed in email bodies or headers. Quoted-printable is very space-inefficient for encoding binary files; use the email.base64mime module for that instead. This module provides an interface to encode and decode both headers and bodies with quoted-printable encoding. RFC 2045 defines a method for including character set information in an `encoded-word' in a header. This method is commonly used for 8-bit real names in To:/From:/Cc: etc. fields, as well as Subject: lines. This module does not do the line wrapping or end-of-line character conversion necessary for proper internationalized headers; it only does dumb encoding and decoding. To deal with the various line wrapping issues, use the email.header module. � body_decode� body_encode� body_length�decode� decodestring� header_decode� header_encode� header_length�quote�unquote� N)� ascii_letters�digits� hexdigits� � � c C s g | ] }d | �qS )z=%02X� )�.0�cr r �(/usr/lib64/python3.8/email/quoprimime.py� <listcomp>7 s r � s -!*+/�ascii�_� s_ !"#$%&'()*+,-./0123456789:;<>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^_`abcdefghijklmnopqrstuvwxyz{|}~ c C s t | �t| kS )z>Return True if the octet should be escaped with header quopri.)�chr�_QUOPRI_HEADER_MAP��octetr r r � header_checkJ s r c C s t | �t| kS )z<Return True if the octet should be escaped with body quopri.)r �_QUOPRI_BODY_MAPr r r r � body_checkO s r! c C s t dd� | D ��S )a: Return a header quoted-printable encoding length. Note that this does not include any RFC 2047 chrome added by `header_encode()`. :param bytearray: An array of bytes (a.k.a. octets). :return: The length in bytes of the byte array when it is encoded with quoted-printable for headers. c s s | ]}t t| �V qd S �N)�lenr �r r r r r � <genexpr>^ s z header_length.<locals>.<genexpr>��sum�� bytearrayr r r r T s c C s t dd� | D ��S )z�Return a body quoted-printable encoding length. :param bytearray: An array of bytes (a.k.a. octets). :return: The length in bytes of the byte array when it is encoded with quoted-printable for bodies. c s s | ]}t t| �V qd S r" )r# r r$ r r r r% h s z body_length.<locals>.<genexpr>r& r( r r r r a s c C sf t |t�st|�}| s&| �|�� � n<t| d �t|� |krT| d || 7 < n| �|�� � d S )N���)� isinstance�strr �append�lstripr# )�L�s�maxlenZextrar r r � _max_appendk s r2 c C s t t| dd� d��S )zDTurn a string in the form =AB to the ASCII character with value 0xab� � � )r �int�r0 r r r r v s c C s t t| � S r" )� _QUOPRI_MAP�ord)r r r r r { s � iso-8859-1c C s$ | sdS | � d��t�}d||f S )a� Encode a single header line with quoted-printable (like) encoding. Defined in RFC 2045, this `Q' encoding is similar to quoted-printable, but used specifically for email header fields to allow charsets with mostly 7 bit characters (and some 8 bit) to remain more or less readable in non-RFC 2045 aware mail clients. charset names the character set to use in the RFC 2046 header. It defaults to iso-8859-1. r �latin1z =?%s?q?%s?=)r � translater )Z header_bytes�charset�encodedr r r r s s �L c C s� |dk rt d��| s| S | �t�} d| }|d }g }|j}| �� D �] }d}t|�d | } || kr�|| } || d dkr�|||| d � � | d }q^|| d dkr�|||| � � | d }q^|||| � d � | }q^|�rR|d dk�rR|| } | d k�rt|d �} n(| dk�r,|d | } n|t|d � } |||d� | � qD|||d � � qD| d tk�rz|d � |�|�S ) a� Encode with quoted-printable, wrapping at maxlinelen characters. Each line of encoded text will end with eol, which defaults to "\n". Set this to "\r\n" if you will be using the result of this function directly in an email. Each line will be wrapped at, at most, maxlinelen characters before the eol string (maxlinelen defaults to 76 characters, the maximum value permitted by RFC 2045). Long lines will have the 'soft line break' quoted-printable character "=" appended to them, so the decoded text will be identical to the original text. The minimum maxlinelen is 4 to have room for a quoted character ("=XX") followed by a soft line break. Smaller values will generate a ValueError. � z maxlinelen must be at least 4�=r3 r � r* z r4 Nr ) � ValueErrorr< �_QUOPRI_BODY_ENCODE_MAPr- � splitlinesr# r �CRLF�join) ZbodyZ maxlinelen�eolZ soft_breakZ maxlinelen1Z encoded_bodyr- �line�startZ laststart�stopZroom�qr r r r � sD c C s | s| S d}| � � D ]�}|�� }|s.||7 }qd}t|�}||k r|| }|dkrd||7 }|d7 }nv|d |kr||d7 }q:n^|d |k r�||d tkr�||d tkr�|t|||d � �7 }|d7 }n||7 }|d7 }||kr:||7 }q:q| d dk�r|�|��r|d d� }|S ) z_Decode a quoted-printable string. Lines are separated with eol, which defaults to \n. r r rA r3 rB r4 r* r N)rE �rstripr# r r �endswith)r> rH ZdecodedrI �i�nr r r r r � s8 , c C s | � d�}t|�S )zCTurn a match in the form =AB to the ASCII character with value 0xabr )�groupr )�matchr0 r r r �_unquote_match s rS c C s | � dd�} tjdt| tjd�S )a Decode a string encoded with RFC 2045 MIME header `Q' encoding. This function does not parse a full MIME header value encoded with quoted-printable (like =?iso-8859-1?q?Hello_World?=) -- please use the high level email.header class for that functionality. r r z=[a-fA-F0-9]{2})�flags)�replace�re�subrS �ASCIIr7 r r r r # s )r )r: )!�__doc__�__all__rV �stringr r r rF �NLZ EMPTYSTRING�ranger8 r r �encoder r r9 r r! r r r2 r r r rD r r r r rS r r r r r �<module> sR � O 0__pycache__/charset.cpython-38.pyc 0000644 00000026305 15204103444 0013040 0 ustar 00 U e5d�B � @ sr d dddgZ ddlmZ ddlZddlZddlmZ ddlmZ d Z d Z d Z d Z d Z dZdZe e dfe e dfe e dfe e dfe e dfe e dfe e dfe e dfe e dfe e dfe e dfe e dfde e dfe e dfe ddfe ddfe ddfe e dfe e dfd�Zddddddddddddddddd d d d d d d d d!�Zd"d#dd$�Zd+d%d�Zd&d� Zd'd� Zd(d)� ZG d*d � d �ZdS ),�Charset� add_alias� add_charset� add_codec� )�partialN)�errors)�encode_7or8bit� � � � �us-asciiz unknown-8bit� )NNN� iso-2022-jp�utf-8)� iso-8859-1� iso-8859-2� iso-8859-3� iso-8859-4� iso-8859-9� iso-8859-10� iso-8859-13� iso-8859-14� iso-8859-15� iso-8859-16z windows-1252Zvisciir �big5�gb2312�euc-jp� shift_jisr zkoi8-rr r r r r r r r r r r zks_c_5601-1987r zeuc-kr)�latin_1zlatin-1Zlatin_2zlatin-2Zlatin_3zlatin-3Zlatin_4zlatin-4Zlatin_5zlatin-5Zlatin_6zlatin-6Zlatin_7zlatin-7Zlatin_8zlatin-8Zlatin_9zlatin-9Zlatin_10zlatin-10�cp949�euc_jp�euc_kr�ascii� eucgb2312_cn�big5_tw)r r r c C s" |t krtd��|||ft| < dS )a> Add character set properties to the global registry. charset is the input character set, and must be the canonical name of a character set. Optional header_enc and body_enc is either Charset.QP for quoted-printable, Charset.BASE64 for base64 encoding, Charset.SHORTEST for the shortest of qp or base64 encoding, or None for no encoding. SHORTEST is only valid for header_enc. It describes how message headers and message bodies in the input charset are to be encoded. Default is no encoding. Optional output_charset is the character set that the output should be in. Conversions will proceed from input charset, to Unicode, to the output charset when the method Charset.convert() is called. The default is to output in the same character set as the input. Both input_charset and output_charset must have Unicode codec entries in the module's charset-to-codec mapping; use add_codec(charset, codecname) to add codecs the module does not know about. See the codecs module's documentation for more information. z!SHORTEST not allowed for body_encN)�SHORTEST� ValueError�CHARSETS)�charsetZ header_encZbody_enc�output_charset� r+ �%/usr/lib64/python3.8/email/charset.pyr m s c C s |t | < dS )z�Add a character set alias. alias is the alias name, e.g. latin-1 canonical is the character set's canonical name, e.g. iso-8859-1 N)�ALIASES)�aliasZ canonicalr+ r+ r, r � s c C s |t | < dS )a$ Add a codec that map characters in the given charset to/from Unicode. charset is the canonical name of a character set. codecname is the name of a Python codec, as appropriate for the second argument to the unicode() built-in, or to the encode() method of a Unicode string. N)� CODEC_MAP)r) Z codecnamer+ r+ r, r � s c C s" |t kr| �dd�S | �|�S d S )Nr# �surrogateescape)� UNKNOWN8BIT�encode)�string�codecr+ r+ r, �_encode� s r5 c @ s\ e Zd ZdZefdd�Zdd� Zdd� Zdd � Zd d � Z d d � Z dd� Z dd� Z dd� Z dS )r a@ Map character sets to their email properties. This class provides information about the requirements imposed on email for a specific character set. It also provides convenience routines for converting between character sets, given the availability of the applicable codecs. Given a character set, it will do its best to provide information on how to use that character set in an email in an RFC-compliant way. Certain character sets must be encoded with quoted-printable or base64 when used in email headers or bodies. Certain character sets must be converted outright, and are not allowed in email. Instances of this module expose the following information about a character set: input_charset: The initial character set specified. Common aliases are converted to their `official' email names (e.g. latin_1 is converted to iso-8859-1). Defaults to 7-bit us-ascii. header_encoding: If the character set must be encoded before it can be used in an email header, this attribute will be set to Charset.QP (for quoted-printable), Charset.BASE64 (for base64 encoding), or Charset.SHORTEST for the shortest of QP or BASE64 encoding. Otherwise, it will be None. body_encoding: Same as header_encoding, but describes the encoding for the mail message's body, which indeed may be different than the header encoding. Charset.SHORTEST is not allowed for body_encoding. output_charset: Some character sets must be converted before they can be used in email headers or bodies. If the input_charset is one of them, this attribute will contain the name of the charset output will be converted to. Otherwise, it will be None. input_codec: The name of the Python codec used to convert the input_charset to Unicode. If no conversion codec is necessary, this attribute will be None. output_codec: The name of the Python codec used to convert Unicode to the output_charset. If no conversion codec is necessary, this attribute will have the same value as the input_codec. c C s� z$t |t�r|�d� n t|d�}W n tk rB t�|��Y nX |�� }t�||�| _ t �| j t t d f�\}}}|s~| j }|| _ || _t�||�| _t�| j | j �| _t�| j| j�| _d S )Nr# )� isinstance�strr2 � UnicodeErrorr Z CharsetError�lowerr- �get� input_charsetr( r& �BASE64�header_encoding� body_encodingr* r/ Z input_codec� output_codec)�selfr; ZhencZbencZconvr+ r+ r, �__init__� s, � ��zCharset.__init__c C s | j �� S �N)r; r9 �r@ r+ r+ r, �__repr__� s zCharset.__repr__c C s t | �t |��� kS rB )r7 r9 )r@ �otherr+ r+ r, �__eq__� s zCharset.__eq__c C s2 | j tkst�| j tkr dS | j tkr*dS tS dS )aP Return the content-transfer-encoding used for body encoding. This is either the string `quoted-printable' or `base64' depending on the encoding used, or it is a function in which case you should call the function with a single argument, the Message object being encoded. The function should then set the Content-Transfer-Encoding header itself to whatever is appropriate. Returns "quoted-printable" if self.body_encoding is QP. Returns "base64" if self.body_encoding is BASE64. Returns conversion function otherwise. zquoted-printable�base64N)r> r& �AssertionError�QPr< r rC r+ r+ r, �get_body_encoding� s zCharset.get_body_encodingc C s | j p | jS )z�Return the output character set. This is self.output_charset if that is not None, otherwise it is self.input_charset. )r* r; rC r+ r+ r, �get_output_charset s zCharset.get_output_charsetc C s6 | j pd}t||�}| �|�}|dkr*|S |�||�S )a� Header-encode a string by converting it first to bytes. The type of encoding (base64 or quoted-printable) will be based on this charset's `header_encoding`. :param string: A unicode string for the header. It must be possible to encode this string to bytes using the character set's output codec. :return: The encoded string, with RFC 2047 chrome. r N)r? r5 � _get_encoder� header_encode)r@ r3 r4 � header_bytes�encoder_moduler+ r+ r, rM s zCharset.header_encodec C s | j pd}t||�}| �|�}t|j|d�}| �� }t|�t }g } g } t|�| } |D ]�} | � | � t � | �} |� t| |��}|| krX| � � | s�| s�| � d� n.| r�dnd}t � | �}t||�}| � ||�� | g} t|�| } qXt � | �}t||�}| � ||�� | S )af Header-encode a string by converting it first to bytes. This is similar to `header_encode()` except that the string is fit into maximum line lengths as given by the argument. :param string: A unicode string for the header. It must be possible to encode this string to bytes using the character set's output codec. :param maxlengths: Maximum line length iterator. Each element returned from this iterator will provide the next maximum line length. This parameter is used as an argument to built-in next() and should never be exhausted. The maximum line lengths should not count the RFC 2047 chrome. These line lengths are only a hint; the splitter does the best it can. :return: Lines of encoded strings, each with RFC 2047 chrome. r )r) N� r )r? r5 rL r rM rK �len�RFC2047_CHROME_LEN�next�append� EMPTYSTRING�join� header_length�pop)r@ r3 Z maxlengthsr4 rN rO �encoderr) Zextra�linesZ current_line�maxlen� characterZ this_lineZlengthZ separatorZ joined_liner+ r+ r, �header_encode_lines* s6 zCharset.header_encode_linesc C s` | j tkrtjS | j tkr tjS | j tkrXtj�|�}tj�|�}||k rPtjS tjS nd S d S rB )r= r< �email� base64mimerI � quoprimimer& rW )r@ rN Zlen64Zlenqpr+ r+ r, rL h s zCharset._get_encoderc C s� |s|S | j tkr4t|t�r(|�| j�}tj�|�S | j t krjt|t�rT|�| j�}|� d�}tj �|�S t|t�r�|�| j�� d�}|S dS )av Body-encode a string by converting it first to bytes. The type of encoding (base64 or quoted-printable) will be based on self.body_encoding. If body_encoding is None, we assume the output charset is a 7bit encoding, so re-encoding the decoded string using the ascii codec produces the correct string version of the content. �latin1r# N) r> r< r6 r7 r2 r* r^ r_ � body_encoderI �decoder` )r@ r3 r+ r+ r, rb w s zCharset.body_encodeN)�__name__� __module__� __qualname__�__doc__�DEFAULT_CHARSETrA rD rF rJ rK rM r] rL rb r+ r+ r+ r, r � s + !>)NNN)�__all__� functoolsr Zemail.base64mimer^ Zemail.quoprimimer Zemail.encodersr rI r< r& rR rh r1 rU r( r- r/ r r r r5 r r+ r+ r+ r, �<module> s� � � � � __pycache__/_encoded_words.cpython-38.pyc 0000644 00000013070 15204103444 0014360 0 ustar 00 U e5dL! � @ s� d Z ddlZddlZddlZddlZddlmZmZ ddlm Z ddddd d d d gZ e� e� d �j dd� �Zdd� ZG dd� de�Ze� Zdeed�< dd� Zdd � Zdd� Zdd� Zdd � Zeed�Zdd � Zeed�Zeed�Z d d d �Z dS ) z� Routines for manipulating RFC2047 encoded words. This is currently a package-private API, but will be considered for promotion to a public API if there is demand. � N)� ascii_letters�digits)�errors�decode_q�encode_q�decode_b�encode_b�len_q�len_b�decode�encodes =([a-fA-F0-9]{2})c C s t �| �d��� �S )N� )�bytes�fromhex�groupr )�m� r �,/usr/lib64/python3.8/email/_encoded_words.py�<lambda>A � r c C s | � dd�} t| �g fS )N� _� )�replace�_q_byte_subber)�encodedr r r r C s c @ s, e Zd Zde�d� e�d� Zdd� ZdS )� _QByteMaps -!*+/�asciic C s. || j krt|�| |< nd�|�| |< | | S )Nz={:02X})�safe�chr�format)�self�keyr r r � __missing__M s z_QByteMap.__missing__N)�__name__� __module__� __qualname__r r r r r" r r r r r I s r �_� c C s d� dd� | D ��S )N� c s s | ]}t | V qd S �N)� _q_byte_map��.0�xr r r � <genexpr>Z s zencode_q.<locals>.<genexpr>)�join��bstringr r r r Y s c C s t dd� | D ��S )Nc s s | ]}t t| �V qd S r) )�lenr* r+ r r r r. ] s zlen_q.<locals>.<genexpr>)�sumr0 r r r r \ s c C s� t | �d }|r dd d| � nd}z&tj| | dd�|rDt�� gng fW S tjk � r� z tj| dd�t�� gfW Y S tjk r� z,tj| d dd�t�� t�� gfW Y Y S tjk r� | t�� gf Y Y Y S X Y nX Y nX d S )N� s ===r T)ZvalidateFs ==) r2 �base64Z b64decoder ZInvalidBase64PaddingDefect�binascii�ErrorZ InvalidBase64CharactersDefectZInvalidBase64LengthDefect)r Zpad_errZmissing_paddingr r r r d s( � � ��c C s t �| ��d�S )Nr )r5 Z b64encoder r0 r r r r � s c C s& t t| �d�\}}|d |r dnd S )N� r4 r )�divmodr2 )r1 Z groups_of_3Zleftoverr r r r � s )�q�bc C s� | � d�\}}}}}|�d�\}}}|�� }|�dd�}t| |�\}}z|�|�}W nv tk r� |�t� d� |��� |�|d�}Y nB t k r� |�dd�}|�� dkr�|�t� d� |��� Y nX ||||fS )a� Decode encoded word and return (string, charset, lang, defects) tuple. An RFC 2047/2243 encoded word has the form: =?charset*lang?cte?encoded_string?= where '*lang' may be omitted but the other parts may not be. This function expects exactly such a string (that is, it does not check the syntax and may raise errors if the string is not well formed), and returns the encoded_string decoded first from its Content Transfer Encoding and then from the resulting bytes into unicode using the specified charset. If the cte-decoded string does not successfully decode using the specified character set, a defect is added to the defects list and the unknown octets are replaced by the unicode 'unknown' character \uFDFF. The specified charset and language are returned. The default for language, which is rarely if ever encountered, is the empty string. �?�*r �surrogateescapez:Encoded word contains bytes not decodable using {} charset� unknown-8bitz<Unknown charset {} in encoded word; decoded as unknown bytes) �split� partition�lowerr � _cte_decodersr � UnicodeError�appendr ZUndecodableBytesDefectr � LookupErrorZ CharsetError) Zewr& �charsetZcteZ cte_string�langr1 Zdefects�stringr r r r � s& � ��utf-8r( c C s| |dkr| � dd�}n | � |�}|dkrTtd |�}td |�}|| dk rPdnd}t| |�}|rld| }d �||||�S ) a Encode string using the CTE encoding that produces the shorter result. Produces an RFC 2047/2243 encoded word of the form: =?charset*lang?cte?encoded_string?= where '*lang' is omitted unless the 'lang' parameter is given a value. Optional argument charset (defaults to utf-8) specifies the charset to use to encode the string to binary before CTE encoding it. Optional argument 'encoding' is the cte specifier for the encoding that should be used ('q' or 'b'); if it is None (the default) the encoding which produces the shortest encoded sequence is used, except that 'q' is preferred if it is up to five characters longer. Optional argument 'lang' (default '') gives the RFC 2243 language string to specify in the encoded word. r? r r> Nr: r; � r= z=?{}{}?{}?{}?=)r �_cte_encode_length� _cte_encodersr )rI rG �encodingrH r1 ZqlenZblenr r r r r � s )rJ Nr( ) �__doc__�rer5 r6 � functoolsrI r r Zemailr �__all__�partial�compile�subr r �dictr r* �ordr r r r r rC r rM rL r r r r r �<module> sL ) �� &�+�� __pycache__/utils.cpython-38.pyc 0000644 00000022510 15204103444 0012541 0 ustar 00 U e5d�4 � @ sj d Z ddddddddd d d d d ddgZddlZddlZddlZddlZddlZddlZddlZ ddl m Z ddl m Z ddl mZ ddl mZmZmZ ddlmZ dZdZdZdZdZe�d�Ze�d �Zd d � Z d d � Z d7d"d�Z d#d� Z d$d%� Z d8d'd�Z!d9d(d�Z"d:d)d �Z#d*d� Z$d+d � Z%d,d� Z&d-d� Z'd;d.d�Z(e�d/ej)�Z*d0d� Z+d<d3d�Z,d=d5d6�Z-dS )>zMiscellaneous utilities.�collapse_rfc2231_value� decode_params�decode_rfc2231�encode_rfc2231� formataddr� formatdate�format_datetime� getaddresses� make_msgid� mktime_tz� parseaddr� parsedate� parsedate_tz�parsedate_to_datetime�unquote� N)�quote)� AddressList)r )r r � _parsedate_tz)�Charsetz, � z �'z[][\\()<>@,:;".]z[\\"]c C s* z| � � W dS tk r$ Y dS X dS )z8Return True if s contains surrogate-escaped binary data.FTN)�encode�UnicodeEncodeError)�s� r �#/usr/lib64/python3.8/email/utils.py�_has_surrogates3 s r c C s | � dd�}|�dd�S )N�utf-8�surrogateescape�replace)r �decode)�stringZoriginal_bytesr r r � _sanitize@ s r" r c C s� | \}}|� d� |r�z|� d� W n< tk r` t|t�rFt|�}|�|�}d||f Y S X d}t�|�rtd}t� d|�}d||||f S |S )a� The inverse of parseaddr(), this takes a 2-tuple of the form (realname, email_address) and returns the string value suitable for an RFC 2822 From, To or Cc header. If the first element of pair is false, then the second element is returned unmodified. The optional charset is the character set that is used to encode realname in case realname is not ASCII safe. Can be an instance of str or a Charset-like object which has a header_encode method. Default is 'utf-8'. �asciiz%s <%s>r �"z\\\g<0>z %s%s%s <%s>) r r � isinstance�strr Z header_encode� specialsre�search� escapesre�sub)Zpair�charset�nameZaddressZ encoded_nameZquotesr r r r L s c C s t �| �}t|�}|jS )z7Return a list of (REALNAME, EMAIL) for each fieldvalue.)� COMMASPACE�join� _AddressList� addresslist)Z fieldvalues�all�ar r r r n s c C sf ddddddddg| d | d d d d dddddddddg | d d | d | d | d | d |f S ) Nz"%s, %02d %s %04d %02d:%02d:%02d %sZMonZTueZWedZThuZFriZSatZSun� � ZJanZFebZMarZAprZMayZJunZJulZAugZSepZOctZNovZDec� r � � � r )� timetuple�zoner r r �_format_timetuple_and_zoneu s& � � �r; Fc C sR | dkrt � � } |s|r,tj�| tjj�}n tj�| �}|rH|�� }d}t||�S )a� Returns a date string as specified by RFC 2822, e.g.: Fri, 09 Nov 2001 01:08:47 -0000 Optional timeval if given is a floating point time value as accepted by gmtime() and localtime(), otherwise the current time is used. Optional localtime is a flag that when True, interprets timeval, and returns a date relative to the local timezone instead of UTC, properly taking daylight savings time into account. Optional argument usegmt means that the timezone is written out as an ascii string, not numeric one (so "GMT" instead of "+0000"). This is needed for HTTP, and is only used when localtime==False. NF)�time�datetimeZ fromtimestamp�timezone�utcZutcfromtimestamp� astimezoner )�timeval� localtime�usegmt�dtr r r r ~ s c C sV | � � }|r2| jdks$| jtjjkr,td��d}n| jdkrBd}n | �d�}t||�S )a$ Turn a datetime into a date string as specified in RFC 2822. If usegmt is True, dt must be an aware datetime with an offset of zero. In this case 'GMT' will be rendered instead of the normal +0000 required by RFC2822. This is to support HTTP headers involving date stamps. Nz%usegmt option requires a UTC datetimeZGMTz-0000z%z)r9 �tzinfor= r> r? � ValueError�strftimer; )rD rC �nowr: r r r r � s c C s^ t t�� d �}t�� }t�d�}| dkr0d} nd| } |dkrHt�� }d|||| |f }|S )a{ Returns a string suitable for RFC 2822 compliant Message-ID, e.g: <142480216486.20800.16526388040877946887@nightshade.la.mastaler.com> Optional idstring if given is a string used to strengthen the uniqueness of the message id. Optional domain if given provides the portion of the message id after the '@'. It defaults to the locally defined hostname. �d �@ Nr �.z<%d.%d.%d%s@%s>)�intr< �os�getpid�randomZ getrandbits�socketZgetfqdn)ZidstringZdomainrA �pidZrandintZmsgidr r r r � s c C sN t | ��^ }}|d kr(tj|d d� � S tj|d d� dt�tj|d��i�S )Nr3 rE ��seconds)r r= r> � timedelta)�dataZdtuple�tzr r r r � s �c C s t | �j}|sdS |d S )z� Parse addr into its constituent realname and email address parts. Return a tuple of realname and email address, unless the parse fails, in which case return a 2-tuple of ('', ''). )r r r )r/ r0 )ZaddrZaddrsr r r r � s c C s` t | �dkr\| �d�r<| �d�r<| dd� �dd��dd�S | �d�r\| �d�r\| dd� S | S ) z Remove quotes from a string.r5 r$ ���z\\�\z\"�<�>)�len� startswith�endswithr )r& r r r r � s c C s& | � td�}t|�dkr"dd| fS |S )z#Decode string according to RFC 2231r4 N)�split�TICKr[ )r �partsr r r r � s c C sD t jj| d|pdd�} |dkr*|dkr*| S |dkr6d}d||| f S )z�Encode string according to RFC 2231. If neither charset nor language is given, then s is returned as-is. If charset is given but not language, the string is encoded using the empty string for language. r r# )Zsafe�encodingNz%s'%s'%s)�urllib�parser )r r+ �languager r r r � s z&^(?P<name>\w+)\*((?P<num>[0-9]+)\*?)?$c C sl | dd� } g }i }| � d�\}}|�||f� | r�| � d�\}}|�d�rRd}nd}t|�}t�|�}|r�|�dd�\}}|dk r�t|�}|�|g ��|||f� q0|�|dt |� f� q0|�rh|� � D ]�\}}g }d} |� � |D ].\}} }|�r t j j| d d �} d} |�| � q�t t�|��}| �rTt|�\} } }|�|| | d| ff� q�|�|d| f� q�|S ) zDecode parameters list according to RFC 2231. params is a sequence of 2-tuples containing (param name, string value). Nr �*TFr, �numz"%s"zlatin-1)ra )�pop�appendr] r �rfc2231_continuation�match�grouprL � setdefaultr �items�sortrb rc � EMPTYSTRINGr. r ) ZparamsZ new_paramsZrfc2231_paramsr, �valueZencodedZmorf Z continuationsZextendedr r+ rd r r r r sD r �us-asciic C sn t | t�rt| �dkr t| �S | \}}}|d kr4|}t|d�}zt|||�W S tk rh t|� Y S X d S )Nr6 zraw-unicode-escape)r% �tupler[ r �bytesr& � LookupError)rp �errorsZfallback_charsetr+ rd �textZrawbytesr r r r 9 s rW c C s | dkr t j �t jj��� S | jdk r.| �� S | �� dd� |f }t�|�}t� |�}z t j |j d�}t �||j �}W n� t k r� | t j t�|�dd� � }tjo�|jdk}|r�tjntj }|t j |d�kr�t �|tj| �}n t �|�}Y nX | j|d�S )a� Return local time as an aware datetime object. If called without arguments, return current time. Otherwise *dt* argument should be a datetime instance, and it is converted to the local time zone according to the system time zone database. If *dt* is naive (that is, dt.tzinfo is None), it is assumed to be in local time. In this case, a positive or zero value for *isdst* causes localtime to presume initially that summer time (for example, Daylight Saving Time) is or is not (respectively) in effect for the specified time. A negative value for *isdst* causes the localtime() function to attempt to divine whether summer time is in effect for the specified time. NrW rR r3 r )rE )r= rH r> r? r@ rE r9 r< �mktimerB rT � tm_gmtoff�tm_zone�AttributeError�gmtime�daylight�tm_isdst�altzone�tznamer ) rD ZisdstZtmrS ZlocaltmZdeltarV ZdstZgmtoffr r r rB S s$ rB )r )NFF)F)NN)NN)r rq )NrW ).�__doc__�__all__rM �rer< rO rP r= Z urllib.parserb Zemail._parseaddrr r r/ r r r r Z email.charsetr r- ro Z UEMPTYSTRINGZCRLFr_ �compiler' r) r r" r r r; r r r r r r r r �ASCIIri r r rB r r r r �<module> sp � " �8 � __pycache__/message.cpython-38.opt-1.pyc 0000644 00000111770 15204103444 0013773 0 ustar 00 U e5d� � @ s� d Z ddgZddlZddlZddlZddlmZmZ ddlm Z ddlm Z ddl m Z m Z dd lmZ dd lmZ ejZd Ze�d �Zd d� Zddd�Zdd� Zdd� ZG dd� d�ZG dd� de�ZG dd� de�Z dS )z8Basic message object for the email package object model.�Message� EmailMessage� N)�BytesIO�StringIO)�utils)�errors)�Policy�compat32��charset)�decode_bz; z[ \(\)<>@,;:\\"/\[\]\?=]c C s4 t | ��d�\}}}|s$|�� d fS |�� |�� fS )N�;)�str� partition�strip)�param�a�sep�b� r �%/usr/lib64/python3.8/email/message.py� _splitparam s r Tc C s� |dk r�t |�dkr�t|t�rL| d7 } t�|d |d |d �}d| |f S z|�d� W n6 tk r� | d7 } t�|dd �}d| |f Y S X |s�t�|�r�d | t� |�f S d| |f S n| S dS ) a~ Convenience function to format and return a key=value pair. This will quote the value if needed or if quote is true. If value is a three tuple (charset, language, value), it will be encoded according to RFC2231 rules. If it contains non-ascii characters it will likewise be encoded according to RFC2231 rules, using the utf-8 charset and a null language. Nr �*� � �%s=%s�asciizutf-8� z%s="%s") �len� isinstance�tupler Zencode_rfc2231�encode�UnicodeEncodeError� tspecials�search�quote)r �valuer% r r r � _formatparam' s r' c C s� dt | � } g }| d d� dkr�| dd � } | �d�}|dkrp| �dd|�| �dd|� d rp| �d|d �}q6|dk r�t| �}| d |� }d|kr�|�d�}|d |� �� �� d ||d d � �� }|�|�� � | |d � } q|S )Nr r r �"z\"r �=)r �find�countr �indexr �lower�append)�sZplist�end�f�ir r r � _parseparamI s ( ,r3 c C s4 t | t�r&| d | d t�| d �fS t�| �S d S )Nr r r )r r r �unquote)r& r r r � _unquotevalue] s r5 c @ s� e Zd ZdZefdd�Zdd� Zddd d �Zd d � Zded d�Z dd� Z dd� Z dd� Z dd� Z dfdd�Zdgdd�Zdd � Zd d � Zd d � Zd!d"� Zd#d$� Zd%d&� Zd'd(� Zd)d*� Zd+d,� Zd-d.� Zd/d0� Zdhd1d2�Zd3d4� Z d5d6� Z did7d8�Z d9d:� Z d;d<� Z d=d>� Z!d?d@� Z"dAdB� Z#dCdD� Z$dEdF� Z%dGdH� Z&djdKdL�Z'dkdMdN�Z(dldQdR�Z)dmdSdT�Z*dndUdV�Z+dodWdX�Z,dpdYdZ�Z-d[d\� Z.dqd]d^�Z/drd_d`�Z0dadb� Z1ddcl2m3Z3 dS )sr a� Basic message object. A message object is defined as something that has a bunch of RFC 2822 headers and a payload. It may optionally have an envelope header (a.k.a. Unix-From or From_ header). If the message is a container (i.e. a multipart or a message/rfc822), then the payload is a list of Message objects, otherwise it is a string. Message objects implement part of the `mapping' interface, which assumes there is exactly one occurrence of the header per message. Some headers do in fact appear multiple times (e.g. Received) and for those headers, you must use the explicit API to set or get all the headers. Not all of the mapping methods are implemented. c C s: || _ g | _d | _d | _d | _d | _| _g | _d| _d S )N� text/plain) �policy�_headers� _unixfrom�_payload�_charsetZpreambleZepilogue�defects� _default_type)�selfr7 r r r �__init__x s zMessage.__init__c C s | � � S )z9Return the entire formatted message as a string. )� as_string�r> r r r �__str__� s zMessage.__str__Fr Nc C sJ ddl m} |dkr| jn|}t� }||d||d�}|j| |d� |�� S )a� Return the entire formatted message as a string. Optional 'unixfrom', when true, means include the Unix From_ envelope header. For backward compatibility reasons, if maxheaderlen is not specified it defaults to 0, so you must override it explicitly if you want a different maxheaderlen. 'policy' is passed to the Generator instance used to serialize the message; if it is not specified the policy associated with the message instance is used. If the message object contains binary data that is not encoded according to RFC standards, the non-compliant data will be replaced by unicode "unknown character" code points. r )� GeneratorNF)� mangle_from_� maxheaderlenr7 ��unixfrom)�email.generatorrC r7 r �flatten�getvalue)r> rG rE r7 rC �fp�gr r r r@ � s �zMessage.as_stringc C s | � � S )z?Return the entire formatted message as a bytes object. )�as_bytesrA r r r � __bytes__� s zMessage.__bytes__c C sH ddl m} |dkr| jn|}t� }||d|d�}|j| |d� |�� S )aJ Return the entire formatted message as a bytes object. Optional 'unixfrom', when true, means include the Unix From_ envelope header. 'policy' is passed to the BytesGenerator instance used to serialize the message; if not specified the policy associated with the message instance is used. r )�BytesGeneratorNF)rD r7 rF )rH rO r7 r rI rJ )r> rG r7 rO rK rL r r r rM � s zMessage.as_bytesc C s t | jt�S )z6Return True if the message consists of multiple parts.)r r: �listrA r r r � is_multipart� s zMessage.is_multipartc C s || _ d S �N�r9 )r> rG r r r � set_unixfrom� s zMessage.set_unixfromc C s | j S rR rS rA r r r � get_unixfrom� s zMessage.get_unixfromc C sF | j dkr|g| _ n.z| j �|� W n tk r@ td��Y nX dS )z�Add the given payload to the current payload. The current payload will always be a list of objects after this method is called. If you want to set the payload to a scalar object, use set_payload() instead. Nz=Attach is not valid on a message with a non-multipart payload)r: r. �AttributeError� TypeError)r> �payloadr r r �attach� s zMessage.attachc C s� | � � r(|rdS |dkr | jS | j| S |dk rNt| jt�sNtdt| j� ��| j}t| �dd���� }t|t�r�t � |�r�|� dd�}|s�z|� | � dd�d�}W q� tk r� |� dd�}Y q�X n2|r�z|� d�}W n tk r� |� d �}Y nX |�s|S |d k�rt�|�S |d k�rVtd �|�� ��\}}|D ]}| j�| |� �q<|S |d k�r�t|�} t� } ztj | | dd� | �� W S tjk �r� | Y S X t|t��r�|S |S )aZ Return a reference to the payload. The payload will either be a list object or a string. If you mutate the list object, you modify the message's payload in place. Optional i returns that index into the payload. Optional decode is a flag indicating whether the payload should be decoded or not, according to the Content-Transfer-Encoding header (default is False). When True and the message is not a multipart, the payload will be decoded if this header's value is `quoted-printable' or `base64'. If some other encoding is used, or the header is missing, or if the payload has bogus data (i.e. bogus base64 or uuencoded data), the payload is returned as-is. If the message is a multipart and the decode flag is True, then None is returned. NzExpected list, got %szcontent-transfer-encodingr r �surrogateescaper �replace�raw-unicode-escapezquoted-printable�base64� )z x-uuencodeZuuencodeZuuezx-uueT)�quiet)rQ r: r rP rW �typer �getr- r Z_has_surrogatesr! �decode� get_param� LookupError� UnicodeError�quopriZ decodestringr �join� splitlinesr7 Z handle_defectr �uurJ �Error) r> r2 rb rX �cteZbpayloadr& r< ZdefectZin_fileZout_filer r r � get_payload� sV " zMessage.get_payloadc C sp t |d�r:|dkr || _dS t|t�s.t|�}|�|j�}t |d�rT|�dd�| _n|| _|dk rl| �|� dS )z�Set the payload to the given value. Optional charset sets the message's default character set. See set_charset() for details. r! Nrb r rZ )�hasattrr: r �Charsetr! �output_charsetrb � set_charset)r> rX r r r r � set_payload/ s zMessage.set_payloadc C s |dkr | � d� d| _dS t|t�s.t|�}|| _d| krH| �dd� d| krf| jdd|�� d� n| �d|�� � ||�� kr�|�| j�| _d| k�r|� � }z || � W nj t k �r | j}|r�z|� d d �}W n t k r� |� |j �}Y nX |�|�| _| �d|� Y nX dS ) a� Set the charset of the payload to a given character set. charset can be a Charset instance, a string naming a character set, or None. If it is a string it will be converted to a Charset instance. If charset is None, the charset parameter will be removed from the Content-Type field. Anything else will generate a TypeError. The message will be assumed to be of type text/* encoded with charset.input_charset. It will be converted to charset.output_charset and encoded properly, if needed, when generating the plain text representation of the message. MIME headers (MIME-Version, Content-Type, Content-Transfer-Encoding) will be added as needed. Nr � MIME-Version�1.0� Content-Typer6 r zContent-Transfer-Encodingr rZ )� del_paramr; r rn � add_headerZget_output_charset� set_paramZ body_encoder: Zget_body_encodingrW r! re ro )r> r rk rX r r r rp C s: � zMessage.set_charsetc C s | j S )zKReturn the Charset instance associated with the message's payload. )r; rA r r r � get_charsetr s zMessage.get_charsetc C s t | j�S )z9Return the total number of headers, including duplicates.)r r8 rA r r r �__len__z s zMessage.__len__c C s | � |�S )a- Get a header value. Return None if the header is missing instead of raising an exception. Note that if the header appeared multiple times, exactly which occurrence gets returned is undefined. Use get_all() to get all the values matching a header field name. )ra �r> �namer r r � __getitem__~ s zMessage.__getitem__c C sr | j �|�}|rX|�� }d}| jD ]4\}}|�� |kr"|d7 }||kr"td�||���q"| j�| j �||�� dS )z�Set the value of a header. Note: this does not overwrite an existing header with the same field name. Use __delitem__() first to delete any existing headers. r r z/There may be at most {} {} headers in a messageN)r7 Zheader_max_countr- r8 � ValueError�formatr. �header_store_parse)r> r{ �valZ max_countZlname�found�k�vr r r � __setitem__� s �zMessage.__setitem__c C s@ |� � }g }| jD ]"\}}|� � |kr|�||f� q|| _dS )zwDelete all occurrences of a header, if present. Does not raise an exception if the header is missing. N)r- r8 r. )r> r{ � newheadersr� r� r r r � __delitem__� s zMessage.__delitem__c C s |� � dd� | jD �kS )Nc S s g | ]\}}|� � �qS r )r- ��.0r� r� r r r � <listcomp>� s z(Message.__contains__.<locals>.<listcomp>)r- r8 rz r r r � __contains__� s zMessage.__contains__c c s | j D ]\}}|V qd S rR �r8 )r> Zfieldr& r r r �__iter__� s zMessage.__iter__c C s dd� | j D �S )a. Return a list of all the message's header field names. These will be sorted in the order they appeared in the original message, or were added to the message, and may contain duplicates. Any fields deleted and re-inserted are always appended to the header list. c S s g | ] \}}|�qS r r r� r r r r� � s z Message.keys.<locals>.<listcomp>r� rA r r r �keys� s z Message.keysc s � fdd�� j D �S )a) Return a list of all the message's header values. These will be sorted in the order they appeared in the original message, or were added to the message, and may contain duplicates. Any fields deleted and re-inserted are always appended to the header list. c s g | ]\}}� j �||��qS r �r7 �header_fetch_parser� rA r r r� � s �z"Message.values.<locals>.<listcomp>r� rA r rA r �values� s �zMessage.valuesc s � fdd�� j D �S )a' Get all the message's header fields and values. These will be sorted in the order they appeared in the original message, or were added to the message, and may contain duplicates. Any fields deleted and re-inserted are always appended to the header list. c s" g | ]\}}|� j �||�f�qS r r� r� rA r r r� � s �z!Message.items.<locals>.<listcomp>r� rA r rA r �items� s �z Message.itemsc C s: |� � }| jD ]&\}}|� � |kr| j�||� S q|S )z~Get a header value. Like __getitem__() but return failobj instead of None when the field is missing. )r- r8 r7 r� )r> r{ �failobjr� r� r r r ra � s z Message.getc C s | j �||f� dS )z�Store name and value in the model without modification. This is an "internal" API, intended only for use by a parser. N)r8 r. )r> r{ r& r r r �set_raw� s zMessage.set_rawc C s t | j�� �S )z�Return the (name, value) header pairs without modification. This is an "internal" API, intended only for use by a generator. )�iterr8 �copyrA r r r � raw_items� s zMessage.raw_itemsc C sH g }|� � }| jD ](\}}|� � |kr|�| j�||�� q|sD|S |S )aQ Return a list of all the values for the named field. These will be sorted in the order they appeared in the original message, and may contain duplicates. Any fields deleted and re-inserted are always appended to the header list. If no such fields exist, failobj is returned (defaults to None). )r- r8 r. r7 r� )r> r{ r� r� r� r� r r r �get_all� s zMessage.get_allc K sp g }|� � D ]<\}}|dkr0|�|�dd�� q |�t|�dd�|�� q |dk r^|�d|� t�|�| |< dS )u� Extended header setting. name is the header field to add. keyword arguments can be used to set additional parameters for the header field, with underscores converted to dashes. Normally the parameter will be added as key="value" unless value is None, in which case only the key will be added. If a parameter value contains non-ASCII characters it can be specified as a three-tuple of (charset, language, value), in which case it will be encoded according to RFC2231 rules. Otherwise it will be encoded using the utf-8 charset and a language of ''. Examples: msg.add_header('content-disposition', 'attachment', filename='bud.gif') msg.add_header('content-disposition', 'attachment', filename=('utf-8', '', Fußballer.ppt')) msg.add_header('content-disposition', 'attachment', filename='Fußballer.ppt')) N�_�-r )r� r. r[ r' �insert� SEMISPACErg )r> �_name�_valueZ_params�partsr� r� r r r rv s zMessage.add_headerc C s\ |� � }ttt| j��| j�D ]0\}\}}|� � |kr | j�||�| j|< qXq t|��dS )z�Replace a header. Replace the first matching header found in the message, retaining header order and case. If no matching header was found, a KeyError is raised. N)r- �zip�ranger r8 r7 r �KeyError)r> r� r� r2 r� r� r r r �replace_header! s " zMessage.replace_headerc C sH t � }| �d|�}||kr"| �� S t|�d �� }|�d�dkrDdS |S )a0 Return the message's content type. The returned string is coerced to lower case of the form `maintype/subtype'. If there was no Content-Type header in the message, the default type as given by get_default_type() will be returned. Since according to RFC 2045, messages always have a default type this will always return a value. RFC 2045 defines a message's default type to be text/plain unless it appears inside a multipart/digest container, in which case it would be message/rfc822. � content-typer �/r r6 )�objectra �get_default_typer r- r+ )r> �missingr& �ctyper r r �get_content_type4 s zMessage.get_content_typec C s | � � }|�d�d S )z�Return the message's main content type. This is the `maintype' part of the string returned by get_content_type(). r� r �r� �split�r> r� r r r �get_content_maintypeL s z Message.get_content_maintypec C s | � � }|�d�d S )z�Returns the message's sub-content type. This is the `subtype' part of the string returned by get_content_type(). r� r r� r� r r r �get_content_subtypeU s zMessage.get_content_subtypec C s | j S )a Return the `default' content type. Most messages have a default content type of text/plain, except for messages that are subparts of multipart/digest containers. Such subparts have a default content type of message/rfc822. �r= rA r r r r� ^ s zMessage.get_default_typec C s || _ dS )z�Set the `default' content type. ctype should be either "text/plain" or "message/rfc822", although this is not enforced. The default content type is not stored in the Content-Type header. Nr� r� r r r �set_default_typeg s zMessage.set_default_typec C s� t � }| �||�}||kr |S g }t|�D ]X}z$|�dd�\}}|�� }|�� }W n tk rr |�� }d}Y nX |�||f� q*t�|�}|S )Nr) r r ) r� ra r3 r� r r} r. r Z decode_params) r> r� �headerr� r& �params�pr{ r� r r r �_get_params_preservep s z Message._get_params_preserver� Tc C s8 t � }| �||�}||kr |S |r0dd� |D �S |S dS )am Return the message's Content-Type parameters, as a list. The elements of the returned list are 2-tuples of key/value pairs, as split on the `=' sign. The left hand side of the `=' is the key, while the right hand side is the value. If there is no `=' sign in the parameter the value is the empty string. The value is as described in the get_param() method. Optional failobj is the object to return if there is no Content-Type header. Optional header is the header to search instead of Content-Type. If unquote is True, the value is unquoted. c S s g | ]\}}|t |�f�qS r )r5 r� r r r r� � s z&Message.get_params.<locals>.<listcomp>N)r� r� )r> r� r� r4 r� r� r r r � get_params� s zMessage.get_paramsc C sN || kr |S | � ||�D ]0\}}|�� |�� kr|r@t|� S | S q|S )a� Return the parameter value if found in the Content-Type header. Optional failobj is the object to return if there is no Content-Type header, or the Content-Type header has no such parameter. Optional header is the header to search instead of Content-Type. Parameter keys are always compared case insensitively. The return value can either be a string, or a 3-tuple if the parameter was RFC 2231 encoded. When it's a 3-tuple, the elements of the value are of the form (CHARSET, LANGUAGE, VALUE). Note that both CHARSET and LANGUAGE can be None, in which case you should consider VALUE to be encoded in the us-ascii charset. You can usually ignore LANGUAGE. The parameter value (either the returned string, or the VALUE item in the 3-tuple) is always unquoted, unless unquote is set to False. If your application doesn't care whether the parameter was RFC 2231 encoded, it can turn the return value into a string as follows: rawparam = msg.get_param('foo') param = email.utils.collapse_rfc2231_value(rawparam) )r� r- r5 )r> r r� r� r4 r� r� r r r rc � s zMessage.get_paramrt r c C s t |t�s|r|||f}|| kr2|�� dkr2d}n | �|�}| j||d�st|s\t|||�}q�t�|t|||�g�}nbd}| j||d�D ]N\} } d} | �� |�� kr�t|||�} n t| | |�} |s�| }q�t�|| g�}q�|| �|�k�r|r�| � ||� n| |= || |< dS )a� Set a parameter in the Content-Type header. If the parameter already exists in the header, its value will be replaced with the new value. If header is Content-Type and has not yet been defined for this message, it will be set to "text/plain" and the new parameter and value will be appended as per RFC 2045. An alternate header can be specified in the header argument, and all parameters will be quoted as necessary unless requote is False. If charset is specified, the parameter will be encoded according to RFC 2231. Optional language specifies the RFC 2231 language, defaulting to the empty string. Both charset and language should be strings. r� r6 )r� r �r� r4 N) r r r- ra rc r' r� rg r� r� ) r> r r& r� �requoter Zlanguager[ r� Z old_param� old_valueZ append_paramr r r rw � s6 �� zMessage.set_paramc C s� || kr dS d}| j ||d�D ]@\}}|�� |�� kr |sHt|||�}q t�|t|||�g�}q || �|�kr|| |= || |< dS )a> Remove the given parameter completely from the Content-Type header. The header will be re-written in place without the parameter or its value. All values will be quoted as necessary unless requote is False. Optional header specifies an alternative to the Content-Type header. Nr r� )r� r- r' r� rg ra )r> r r� r� Z new_ctyper� r� r r r ru � s �zMessage.del_paramc C s� |� d�dkst�|�� dkr,| d= d| d< || kr@|| |< dS | j||d�}| |= || |< |dd� D ]\}}| �||||� qhdS ) aK Set the main type and subtype for the Content-Type header. type must be a string in the form "maintype/subtype", otherwise a ValueError is raised. This method replaces the Content-Type header, keeping all the parameters in place. If requote is False, this leaves the existing header's quoting as is. Otherwise, the parameters will be quoted (the default). An alternative header can be specified in the header argument. When the Content-Type header is set, we'll always also add a MIME-Version header. r� r r� z mime-versionrs rr Nr� )r+ r} r- r� rw )r> r` r� r� r� r� r� r r r �set_type s zMessage.set_typec C sD t � }| �d|d�}||kr*| �d|d�}||kr6|S t�|��� S )a@ Return the filename associated with the payload if present. The filename is extracted from the Content-Disposition header's `filename' parameter, and it is unquoted. If that header is missing the `filename' parameter, this method falls back to looking for the `name' parameter. �filename�content-dispositionr{ r� )r� rc r �collapse_rfc2231_valuer )r> r� r� r� r r r � get_filename& s zMessage.get_filenamec C s, t � }| �d|�}||kr |S t�|��� S )z�Return the boundary associated with the payload if present. The boundary is extracted from the Content-Type header's `boundary' parameter, and it is unquoted. �boundary)r� rc r r� �rstrip)r> r� r� r� r r r � get_boundary6 s zMessage.get_boundaryc C s t � }| �|d�}||kr$t�d��g }d}|D ]:\}}|�� dkr\|�dd| f� d}q0|�||f� q0|s�|�dd| f� g }| jD ]z\} } | �� dkr�g } |D ].\} } | dkr�| �| � q�| �d| | f � q�t�| �} |�| j � | | �� q�|�| | f� q�|| _d S ) a� Set the boundary parameter in Content-Type to 'boundary'. This is subtly different than deleting the Content-Type header and adding a new one with a new boundary parameter via add_header(). The main difference is that using the set_boundary() method preserves the order of the Content-Type header in the original message. HeaderParseError is raised if the message has no Content-Type header. r� z No Content-Type header foundFr� z"%s"Tr r N) r� r� r ZHeaderParseErrorr- r. r8 r� rg r7 r )r> r� r� r� Z newparamsZfoundpZpkZpvr� �hr� r� r� r� r r r � set_boundaryC s2 zMessage.set_boundaryc C s� t � }| �d|�}||kr |S t|t�rr|d p2d}z |d �d�}t||�}W n ttfk rp |d }Y nX z|�d� W n tk r� | Y S X |�� S )z�Return the charset parameter of the Content-Type header. The returned string is always coerced to lower case. If there is no Content-Type header, or if that header has no charset parameter, failobj is returned. r r zus-asciir r\ ) r� rc r r r! r rd re r- )r> r� r� r ZpcharsetrM r r r �get_content_charsetq s zMessage.get_content_charsetc s � fdd�| � � D �S )a� Return a list containing the charset(s) used in this message. The returned list of items describes the Content-Type headers' charset parameter for this message and all the subparts in its payload. Each item will either be a string (the value of the charset parameter in the Content-Type header of that part) or the value of the 'failobj' parameter (defaults to None), if the part does not have a main MIME type of "text", or the charset is not defined. The list will contain one string for each part of the message, plus one for the container message (i.e. self), so that a non-multipart message will still return a list of length 1. c s g | ]}|� � ��qS r )r� )r� �part�r� r r r� � s z(Message.get_charsets.<locals>.<listcomp>��walk)r> r� r r� r � get_charsets� s zMessage.get_charsetsc C s* | � d�}|dkrdS t|�d �� }|S )z�Return the message's content-disposition if it exists, or None. The return values can be either 'inline', 'attachment' or None according to the rfc2183. r� Nr )ra r r- )r> r& �c_dr r r �get_content_disposition� s z Message.get_content_dispositionr� )Fr N)FN)NF)N)N)N)Nr� T)Nr� T)rt TNr F)r� T)rt T)N)N)N)N)4�__name__� __module__� __qualname__�__doc__r r? rB r@ rN rM rQ rT rU rY rl rq rp rx ry r| r� r� r� r� r� r� r� ra r� r� r� rv r� r� r� r� r� r� r� r� rc rw ru r� r� r� r� r� r� r� Zemail.iteratorsr� r r r r r i sj Z / � " � 3 . c s� e Zd Zd2dd�Zd3� fdd� Zdd� Zd d � Zd d � Zd4dd�ZddddhZ dd� Z dd� Z dd�dd�Z dd�dd �Z d d � Zd5d d �Zd6d!d"�Zd7d#d$�Zdd%�d&d'�Zd(d)� Zd*d+� Zd,d-� Zd.d/� Zd0d1� Z� ZS )8�MIMEPartNc C s( |d krddl m} |}t�| |� d S )Nr )�default)Z email.policyr� r r? )r> r7 r� r r r r? � s zMIMEPart.__init__Fc s0 |dkr| j n|}|dkr |j}t� j||d�S )a Return the entire formatted message as a string. Optional 'unixfrom', when true, means include the Unix From_ envelope header. maxheaderlen is retained for backward compatibility with the base Message class, but defaults to None, meaning that the policy value for max_line_length controls the header maximum length. 'policy' is passed to the Generator instance used to serialize the message; if it is not specified the policy associated with the message instance is used. N)rE r7 )r7 Zmax_line_length�superr@ )r> rG rE r7 �� __class__r r r@ � s zMIMEPart.as_stringc C s | j | jjdd�d�S )NT)�utf8�r7 )r@ r7 ZclonerA r r r rB � s zMIMEPart.__str__c C s | � d�}|d krdS |jdkS )Nr� F� attachment)ra Zcontent_disposition)r> r� r r r � is_attachment� s zMIMEPart.is_attachmentc c s |� � r d S |�� �d�\}}|dkrB||kr>|�|�|fV d S |dkrNd S |dkrz|�� D ]}| �||�E d H q^d S d|kr�|�d�|fV d }|�d�}|r�|�� D ]}|d |kr�|} q�q�|d kr�|�� }|r�|d nd }|d k �r| �||�E d H d S )Nr� �text� multipart�related�start� content-idr )r� r� r� r, � iter_parts� _find_bodyrc rl ) r> r� �preferencelist�maintype�subtypeZsubpart� candidater� Zsubpartsr r r r� � s6 zMIMEPart._find_body�r� �html�plainc C sB t |�}d}| �| |�D ]$\}}||k r|}|}|dkr q>q|S )a Return best candidate mime part for display as 'body' of message. Do a depth first search, starting with self, looking for the first part matching each of the items in preferencelist, and return the part corresponding to the first item that has a match, or None if no items have a match. If 'related' is not included in preferencelist, consider the root part of any multipart/related encountered as a candidate match. Ignore parts with 'Content-Disposition: attachment'. Nr )r r� )r> r� Z best_prioZbodyZprior� r r r �get_body� s zMIMEPart.get_body)r� r� )r� r� )r� r� )r� � alternativec c s$ | � � �d�\}}|dks"|dkr&dS | �� }z |�� }W n tk rP Y dS X |dkr�|dkr�| �d�}|r�d}g }|D ]"}|�d�|kr�d }q||�|� q||r�|E dH dS |�d � |E dH dS g } |D ]L}|� � �d�\}}||f| j k�r|� � �s|| k�r| �|� q�|V q�dS ) a Return an iterator over the non-main parts of a multipart. Skip the first of each occurrence of text/plain, text/html, multipart/related, or multipart/alternative in the multipart (unless they have a 'Content-Disposition: attachment' header) and include all remaining subparts in the returned iterator. When applied to a multipart/related, return all parts except the root part. Return an empty iterator when applied to a multipart/alternative or a non-multipart. r� r� r� Nr� r� Fr� Tr ) r� r� rl r� rV rc ra r. �pop� _body_typesr� ) r> r� r� rX r� r� r� Z attachmentsr� �seenr r r �iter_attachments sD �� zMIMEPart.iter_attachmentsc c s | � � dkr| �� E dH dS )z~Return an iterator over all immediate subparts of a multipart. Return an empty iterator for a non-multipart. r� N)r� rl rA r r r r� = s zMIMEPart.iter_parts)�content_managerc O s" |d kr| j j}|j| f|�|�S rR )r7 r� � get_content�r> r� �args�kwr r r r� E s zMIMEPart.get_contentc O s& |d kr| j j}|j| f|�|� d S rR )r7 r� � set_contentr� r r r r� J s zMIMEPart.set_contentc C s� | � � dkr6| �� }||f }||kr6td�||���g }g }| jD ]4\}}|�� �d�rj|�||f� qD|�||f� qD|r�t| �| j d�} || _| j | _ | g| _ ng | _ || _d| | d< |d k r�| � d|� d S )Nr� zCannot convert {} to {}�content-r� z multipart/rt r� ) r� r� r} r~ r8 r- � startswithr. r` r7 r: rw ) r> r� Zdisallowed_subtypesr� Zexisting_subtypeZ keep_headersZ part_headersr{ r& r� r r r �_make_multipartO s0 � zMIMEPart._make_multipartc C s | � dd|� d S )Nr� )r� �mixed�r� �r> r� r r r � make_relatedj s zMIMEPart.make_relatedc C s | � dd|� d S )Nr� )r� r� r� r r r �make_alternativem s zMIMEPart.make_alternativec C s | � dd|� d S )Nr� r r� r� r r r � make_mixedp s zMIMEPart.make_mixed)�_dispc O sf | � � dks| �� |kr(t| d| �� t| �| jd�}|j||� |rXd|krX||d< | �|� d S )Nr� Zmake_r� r� zContent-Disposition)r� r� �getattrr` r7 r� rY )r> Z_subtyper� r� r� r� r r r �_add_multiparts s � zMIMEPart._add_multipartc O s | j d|�ddi|�� d S )Nr� r� Zinline)r� �r� �r> r� r� r r r � add_related} s zMIMEPart.add_relatedc O s | j d|�|� d S )Nr� )r� r� r� r r r �add_alternative� s zMIMEPart.add_alternativec O s | j d|�ddi|�� d S )Nr� r� r� )r� r� r� r r r �add_attachment� s zMIMEPart.add_attachmentc C s g | _ d | _d S rR �r8 r: rA r r r �clear� s zMIMEPart.clearc C s dd� | j D �| _ d | _d S )Nc S s& g | ] \}}|� � �d �s||f�qS )r� )r- r� )r� �nr� r r r r� � s �z*MIMEPart.clear_content.<locals>.<listcomp>r rA r r r � clear_content� s zMIMEPart.clear_content)N)FNN)r� )N)N)N)r� r� r� r? r@ rB r� r� r� r� r� r� r� r� r� r� r� r� r� r r r r r � __classcell__r r r� r r� � s2 �7 r� c s e Zd Z� fdd�Z� ZS )r c s" t � j||� d| kr d| d< d S )Nrr rs )r� r� r� r� r r r� � s zEmailMessage.set_content)r� r� r� r� r r r r� r r � s )NT) r� �__all__�reri rf �ior r Zemailr r Zemail._policybaser r r r; Zemail._encoded_wordsr rn r� �compiler# r r' r3 r5 r r� r r r r r �<module> s6 " N ` __pycache__/base64mime.cpython-38.opt-1.pyc 0000644 00000006245 15204103444 0014303 0 ustar 00 U e5d� � @ st d Z ddddddgZddlmZ dd lmZmZ d Zd Zd Z d Z dd� Z ddd�Z defdd�Z dd� ZeZeZdS )a� Base64 content transfer encoding per RFCs 2045-2047. This module handles the content transfer encoding method defined in RFC 2045 to encode arbitrary 8-bit data using the three 8-bit bytes in four 7-bit characters encoding known as Base64. It is used in the MIME standards for email to attach images, audio, and text using some 8-bit character sets to messages. This module provides an interface to encode and decode both headers and bodies with Base64 encoding. RFC 2045 defines a method for including character set information in an `encoded-word' in a header. This method is commonly used for 8-bit real names in To:, From:, Cc:, etc. fields, as well as Subject: lines. This module does not do the line wrapping or end-of-line character conversion necessary for proper internationalized headers; it only does dumb encoding and decoding. To deal with the various line wrapping issues, use the email.header module. � body_decode� body_encode�decode� decodestring� header_encode� header_length� )� b64encode)� b2a_base64� a2b_base64z � � � c C s* t t| �d�\}}|d }|r&|d7 }|S )z6Return the length of s when it is encoded with base64.� � )�divmod�len)� bytearrayZ groups_of_3Zleftover�n� r �(/usr/lib64/python3.8/email/base64mime.pyr 2 s � iso-8859-1c C s6 | sdS t | t�r | �|�} t| ��d�}d||f S )z�Encode a single header line with Base64 encoding in a given charset. charset names the character set to use to encode the header. It defaults to iso-8859-1. Base64 encoding is defined in RFC 2045. r �asciiz =?%s?b?%s?=)� isinstance�str�encoder r )Z header_bytes�charsetZencodedr r r r = s �L c C s~ | s| S g }|d d }t dt| �|�D ]J}t| ||| � ��d�}|�t�rh|tkrh|dd� | }|�|� q(t�|�S )a1 Encode a string with base64. Each line will be wrapped at, at most, maxlinelen characters (defaults to 76 characters). Each line of encoded text will end with eol, which defaults to "\n". Set this to "\r\n" if you will be using the result of this function directly in an email. r r r r N���) �ranger r r �endswith�NL�append� EMPTYSTRING�join)�sZ maxlinelenZeolZencvecZ max_unencoded�i�encr r r r L s c C s. | s t � S t| t�r"t| �d��S t| �S dS )z�Decode a raw base64 string, returning a bytes object. This function does not parse a full MIME header value encoded with base64 (like =?iso-8859-1?b?bmloISBuaWgh?=) -- please use the high level email.header class for that functionality. zraw-unicode-escapeN)�bytesr r r r )�stringr r r r f s N)r )�__doc__�__all__�base64r Zbinasciir r ZCRLFr r" ZMISC_LENr r r r r r r r r r �<module> s& � __pycache__/contentmanager.cpython-38.opt-2.pyc 0000644 00000016303 15204103444 0015351 0 ustar 00 U e5d�) � @ s. d dl Z d dlZd dlZd dlZd dlmZ G dd� d�Ze� Zd%dd�Ze� de� d d � Z d � � D ]Z e� e e � qfd d � Z d� � D ]Ze� de e � q�dd� Ze� de� dd� Zdd� Zdd� Zdd� Zd&d d �Ze�ee� d'd d!�Ze�ejje� d(d#d$�Zee e fD ]Z e�e e� �qdS ))� N)� quoprimimec @ s< e Zd Zdd� Zdd� Zdd� Zdd� Zd d � Zd d � Zd S )�ContentManagerc C s i | _ i | _d S �N)� get_handlers� set_handlers)�self� r �,/usr/lib64/python3.8/email/contentmanager.py�__init__ s zContentManager.__init__c C s || j |< d S r )r )r �key�handlerr r r �add_get_handler s z ContentManager.add_get_handlerc O s| |� � }|| jkr(| j| |f|�|�S |�� }|| jkrP| j| |f|�|�S d| jkrp| jd |f|�|�S t|��d S )N� )Zget_content_typer �get_content_maintype�KeyError)r �msg�args�kwZ content_type�maintyper r r � get_content s zContentManager.get_contentc C s || j |< d S r )r )r Ztypekeyr r r r �add_set_handler s z ContentManager.add_set_handlerc O s> |� � dkrtd��| �||�}|�� |||f|�|� d S )NZ multipartz"set_content not valid on multipart)r � TypeError�_find_set_handlerZ clear_content)r r �objr r r r r r � set_content s zContentManager.set_contentc C s� d }t |�jD ]�}|| jkr*| j| S |j}t|dd�}|rNd�||f�n|}|d kr^|}|| jkrv| j| S || jkr�| j| S |j}|| jkr| j| S qd | jkr�| jd S t|��d S )N� __module__r �.)�type�__mro__r � __qualname__�getattr�join�__name__r ) r r r Zfull_path_for_error�typZqname�modname� full_path�namer r r r ' s& z ContentManager._find_set_handlerN) r" r r r r r r r r r r r r r s r �replacec C s& | j dd�}| �dd�}|j||d�S )NT��decode�charset�ASCII)�errors)� get_payloadZ get_paramr) )r r, Zcontentr* r r r �get_text_content@ s r. �textc C s | j dd�S )NTr( �r- �r r r r �get_non_text_contentG s r2 z audio image video applicationc C s | � d�S �Nr r0 r1 r r r �get_message_contentM s r4 zrfc822 external-bodyzmessage/c C s t | �d��S r3 )�bytesr- r1 r r r �%get_and_fixup_unknown_message_contentS s r6 �messagec s� d� ||f�| d< |r�t|d d�s<| j� � fdd�|D �}z(|D ] }|jrV|jd �|| |j< qBW n@ tjjk r� } z td� |j | jd���|�W 5 d }~X Y nX d S ) N�/z Content-Typer r& c s g | ]}� j � �|g�� �qS r )Zheader_factoryZheader_source_parse)�.0�header�Zmpr r � <listcomp>d s �z _prepare_set.<locals>.<listcomp>zInvalid header: {})�policy) r! �hasattrr= Zdefectsr& �emailr, Z HeaderDefect� ValueError�formatZfold)r r �subtype�headersr: �excr r; r � _prepare_set_ s$ � ��rE c C sx |d kr|d k rd}|d k r$|| d< |d k r>| j d|ddd� |d k rN|| d< |d k rt|�� D ]\}}| � ||� q^d S )NZ attachmentzContent-Disposition�filenameT)r: r' z Content-ID)� set_param�items)r � dispositionrF �cid�paramsr �valuer r r � _finalize_setp s �rM c C sV g }|d d }t dt| �|�D ]*}| ||| � }|�t�|��d�� q d�|�S )N� � r �asciir )�range�len�append�binascii� b2a_base64r) r! )�data�max_line_lengthZ encoded_linesZunencoded_bytes_per_line�iZthisliner r r �_encode_base64� s rY c s� | � |��� }|j� d�� � fdd�}dd� }|d kr�tdd� |D �dd �|jkr�zd ||��d�fW S tk rz Y nX |jd kr�d ||��dd �fS ||d d � �}t� |�d�|j�}t � |�} t |�t | �kr�d}nd}t |�d kr�||fS |d k�r||��d�} nj|d k�r,||��dd �} nN|dk�rPt� ||��d�|j�} n*|dk�rlt ||�|j�} ntd�|���|| fS )NrP c s � � | �� S r �r! ��lines��linesepr r � embedded_body� � z#_encode_text.<locals>.embedded_bodyc S s d� | �d S )N� rZ r[ r r r � normal_body� r` z!_encode_text.<locals>.normal_bodyc s s | ]}t |�V qd S r )rR )r9 �xr r r � <genexpr>� s z _encode_text.<locals>.<genexpr>r )�default�7bit�8bit�surrogateescape� zlatin-1�base64�quoted-printablez$Unknown content transfer encoding {})�encode� splitlinesr^ �maxrW r) �UnicodeDecodeErrorZcte_typer Z body_encoderT rU rR rY r@ rA ) �stringr* �cter= r\ r_ rb ZsniffZsniff_qpZ sniff_base64rV r r] r � _encode_text� sD � � rr �plain�utf-8c C sd t | d|| � t|||| j�\}} | �| � | jdtjj�||�dd� || d< t | ||||� d S )Nr/ r* T)r' �Content-Transfer-Encoding) rE rr r= � set_payloadrG r? r* ZALIASES�getrM ) r rp rB r* rq rI rF rJ rK rC Zpayloadr r r �set_text_content� s �rx �rfc822c C s� |dkrt d��|dkr@|dkr.t d�|���|d kr:dn|}n0|dkrd|dkr^t d �|���d }n |d krpd }t| d ||� | �|g� || d < t| ||||� d S ) N�partialz4message/partial is not supported for Message objectsry )Nrf rg �binaryz*message/rfc822 parts do not support cte={}rg z external-body)Nrf z1message/external-body parts do not support cte={}rf r7 ru )r@ rA rE rv rM ) r r7 rB rq rI rF rJ rK rC r r r �set_message_content� s( �� r| rj c C s� t | ||| � |dkr(t|| jjd�}nN|dkrNtj|dddd�}|�d�}n(|dkrb|�d� n|d krv|�dd �}| �|� || d < t | ||||� d S ) Nrj )rW rk FT)�istextr: Z quotetabsrP rf )rg r{ rh ru ) rE rY r= rW rT Zb2a_qpr) rl rv rM ) r rV r rB rq rI rF rJ rK rC r r r �set_bytes_content� s r~ )r' )rs rt NNNNNN)ry NNNNNN)rj NNNNN) rT Z email.charsetr? Z email.messageZ email.errorsr r Zraw_data_managerr. r r2 �splitr r4 rB r6 rE rM rY rr rx r �strr| r7 ZMessager~ r5 � bytearray� memoryviewr# r r r r �<module> s^ 6 � ' � � � __pycache__/base64mime.cpython-38.pyc 0000644 00000006245 15204103444 0013344 0 ustar 00 U e5d� � @ st d Z ddddddgZddlmZ dd lmZmZ d Zd Zd Z d Z dd� Z ddd�Z defdd�Z dd� ZeZeZdS )a� Base64 content transfer encoding per RFCs 2045-2047. This module handles the content transfer encoding method defined in RFC 2045 to encode arbitrary 8-bit data using the three 8-bit bytes in four 7-bit characters encoding known as Base64. It is used in the MIME standards for email to attach images, audio, and text using some 8-bit character sets to messages. This module provides an interface to encode and decode both headers and bodies with Base64 encoding. RFC 2045 defines a method for including character set information in an `encoded-word' in a header. This method is commonly used for 8-bit real names in To:, From:, Cc:, etc. fields, as well as Subject: lines. This module does not do the line wrapping or end-of-line character conversion necessary for proper internationalized headers; it only does dumb encoding and decoding. To deal with the various line wrapping issues, use the email.header module. � body_decode� body_encode�decode� decodestring� header_encode� header_length� )� b64encode)� b2a_base64� a2b_base64z � � � c C s* t t| �d�\}}|d }|r&|d7 }|S )z6Return the length of s when it is encoded with base64.� � )�divmod�len)� bytearrayZ groups_of_3Zleftover�n� r �(/usr/lib64/python3.8/email/base64mime.pyr 2 s � iso-8859-1c C s6 | sdS t | t�r | �|�} t| ��d�}d||f S )z�Encode a single header line with Base64 encoding in a given charset. charset names the character set to use to encode the header. It defaults to iso-8859-1. Base64 encoding is defined in RFC 2045. r �asciiz =?%s?b?%s?=)� isinstance�str�encoder r )Z header_bytes�charsetZencodedr r r r = s �L c C s~ | s| S g }|d d }t dt| �|�D ]J}t| ||| � ��d�}|�t�rh|tkrh|dd� | }|�|� q(t�|�S )a1 Encode a string with base64. Each line will be wrapped at, at most, maxlinelen characters (defaults to 76 characters). Each line of encoded text will end with eol, which defaults to "\n". Set this to "\r\n" if you will be using the result of this function directly in an email. r r r r N���) �ranger r r �endswith�NL�append� EMPTYSTRING�join)�sZ maxlinelenZeolZencvecZ max_unencoded�i�encr r r r L s c C s. | s t � S t| t�r"t| �d��S t| �S dS )z�Decode a raw base64 string, returning a bytes object. This function does not parse a full MIME header value encoded with base64 (like =?iso-8859-1?b?bmloISBuaWgh?=) -- please use the high level email.header class for that functionality. zraw-unicode-escapeN)�bytesr r r r )�stringr r r r f s N)r )�__doc__�__all__�base64r Zbinasciir r ZCRLFr r" ZMISC_LENr r r r r r r r r r �<module> s& � __pycache__/parser.cpython-38.opt-1.pyc 0000644 00000013134 15204103444 0013636 0 ustar 00 U e5d� � @ s� d Z ddddddgZddlmZmZ dd lmZmZ dd lm Z G d d� d�Z G d d� de �Z G d d� d�Z G dd� de �Z dS )z-A parser of RFC 2822 and MIME email messages.�Parser� HeaderParser� BytesParser�BytesHeaderParser� FeedParser�BytesFeedParser� )�StringIO� TextIOWrapper)r r )�compat32c @ s0 e Zd Zd ed�dd�Zd dd�Zd dd �ZdS ) r N��policyc C s || _ || _dS )a� 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 preceded 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. N)�_classr )�selfr r � r �$/usr/lib64/python3.8/email/parser.py�__init__ s zParser.__init__Fc C s@ t | j| jd�}|r |�� |�d�}|s,q8|�|� q |�� S )a\ 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. r i )r r r Z_set_headersonly�readZfeed�close)r �fp� headersonlyZ feedparser�datar r r �parse) s z Parser.parsec C s | j t|�|d�S )a- 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. �r )r r �r �textr r r r �parsestr; s zParser.parsestr)N)F)F)�__name__� __module__� __qualname__r r r r r r r r r s c @ s e Zd Zddd�Zddd�ZdS ) r Tc C s t �| |d�S �NT)r r �r r r r r r r H s zHeaderParser.parsec C s t �| |d�S r )r r r r r r r K s zHeaderParser.parsestrN)T)T)r r r r r r r r r r G s c @ s( e Zd Zdd� Zd dd�Zd dd�ZdS ) r c O s t ||�| _dS )a� 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 preceded 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. N)r �parser)r �args�kwr r r r Q s zBytesParser.__init__Fc C s0 t |ddd�}z| j�||�W �S |�� X dS )ac 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. �ascii�surrogateescape)�encoding�errorsN)r �detachr! r r r r r r c s zBytesParser.parsec C s |j ddd�}| j�||�S )a2 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. �ASCIIr% )r' )�decoder! r r r r r � parsebytesr s zBytesParser.parsebytesN)F)F)r r r r r r+ r r r r r O s c @ s e Zd Zddd�Zddd�ZdS ) r Tc C s t j| |dd�S �NTr )r r r r r r r s zBytesHeaderParser.parsec C s t j| |dd�S r, )r r+ r r r r r+ � s z BytesHeaderParser.parsebytesN)T)T)r r r r r+ r r r r r ~ s N)�__doc__�__all__�ior r Zemail.feedparserr r Zemail._policybaser r r r r r r r r �<module> s � 7/ __pycache__/__init__.cpython-38.pyc 0000644 00000003235 15204103444 0013143 0 ustar 00 U e5d� � @ sN d Z ddddddddd d d d d ddddgZdd � Zdd � Zdd � Zdd � ZdS )z?A package for parsing, handling, and generating email messages.Z base64mime�charsetZencoders�errorsZ feedparser� generator�headerZ iterators�message�message_from_file�message_from_binary_file�message_from_string�message_from_bytesZmime�parserZ quoprimimeZutilsc O s ddl m} |||��| �S )zvParse a string into a Message object model. Optional _class and strict are passed to the Parser constructor. � ��Parser)� email.parserr Zparsestr)�s�args�kwsr � r �&/usr/lib64/python3.8/email/__init__.pyr s c O s ddl m} |||��| �S )z|Parse a bytes string into a Message object model. Optional _class and strict are passed to the Parser constructor. r �� BytesParser)r r Z parsebytes)r r r r r r r r ( s c O s ddl m} |||��| �S )z�Read a file and parse its contents into a Message object model. Optional _class and strict are passed to the Parser constructor. r r )r r �parse)�fpr r r r r r r 0 s c O s ddl m} |||��| �S )z�Read a binary file and parse its contents into a Message object model. Optional _class and strict are passed to the Parser constructor. r r )r r r )r r r r r r r r 8 s N)�__doc__�__all__r r r r r r r r �<module> s, � encoders.py 0000644 00000003737 15204103444 0006727 0 ustar 00 # Copyright (C) 2001-2006 Python Software Foundation # Author: Barry Warsaw # Contact: email-sig@python.org """Encodings and related functions.""" __all__ = [ 'encode_7or8bit', 'encode_base64', 'encode_noop', 'encode_quopri', ] import base64 from quopri import encodestring as _encodestring def _qencode(s): enc = _encodestring(s, quotetabs=True) # Must encode spaces, which quopri.encodestring() doesn't do return enc.replace(' ', '=20') def _bencode(s): # We can't quite use base64.encodestring() since it tacks on a "courtesy # newline". Blech! if not s: return s hasnewline = (s[-1] == '\n') value = base64.encodestring(s) if not hasnewline and value[-1] == '\n': return value[:-1] return value def encode_base64(msg): """Encode the message's payload in Base64. Also, add an appropriate Content-Transfer-Encoding header. """ orig = msg.get_payload() encdata = _bencode(orig) msg.set_payload(encdata) msg['Content-Transfer-Encoding'] = 'base64' def encode_quopri(msg): """Encode the message's payload in quoted-printable. Also, add an appropriate Content-Transfer-Encoding header. """ orig = msg.get_payload() encdata = _qencode(orig) msg.set_payload(encdata) msg['Content-Transfer-Encoding'] = 'quoted-printable' def encode_7or8bit(msg): """Set the Content-Transfer-Encoding header to 7bit or 8bit.""" orig = msg.get_payload() if orig is None: # There's no payload. For backwards compatibility we use 7bit msg['Content-Transfer-Encoding'] = '7bit' return # We play a trick to make this go fast. If encoding to ASCII succeeds, we # know the data must be 7bit, otherwise treat it as 8bit. try: orig.encode('ascii') except UnicodeError: msg['Content-Transfer-Encoding'] = '8bit' else: msg['Content-Transfer-Encoding'] = '7bit' def encode_noop(msg): """Do nothing.""" mime/message.py 0000644 00000002406 15204103444 0007470 0 ustar 00 # Copyright (C) 2001-2006 Python Software Foundation # Author: Barry Warsaw # Contact: email-sig@python.org """Class representing message/* MIME documents.""" __all__ = ['MIMEMessage'] from email import message from email.mime.nonmultipart import MIMENonMultipart class MIMEMessage(MIMENonMultipart): """Class representing message/* MIME documents.""" def __init__(self, _msg, _subtype='rfc822'): """Create a message/* type MIME document. _msg is a message object and must be an instance of Message, or a derived class of Message, otherwise a TypeError is raised. Optional _subtype defines the subtype of the contained message. The default is "rfc822" (this is defined by the MIME standard, even though the term "rfc822" is technically outdated by RFC 2822). """ MIMENonMultipart.__init__(self, 'message', _subtype) if not isinstance(_msg, message.Message): raise TypeError('Argument is not an instance of Message') # It's convenient to use this base class method. We need to do it # this way or we'll get an exception message.Message.attach(self, _msg) # And be sure our default type is set correctly self.set_default_type('message/rfc822') mime/__init__.py 0000644 00000000000 15204103444 0007567 0 ustar 00 mime/image.py 0000644 00000003344 15204103444 0007130 0 ustar 00 # Copyright (C) 2001-2006 Python Software Foundation # Author: Barry Warsaw # Contact: email-sig@python.org """Class representing image/* type MIME documents.""" __all__ = ['MIMEImage'] import imghdr from email import encoders from email.mime.nonmultipart import MIMENonMultipart class MIMEImage(MIMENonMultipart): """Class for generating image/* type MIME documents.""" def __init__(self, _imagedata, _subtype=None, _encoder=encoders.encode_base64, **_params): """Create an image/* type MIME document. _imagedata is a string containing the raw image data. If this data can be decoded by the standard Python `imghdr' module, then the subtype will be automatically included in the Content-Type header. Otherwise, you can specify the specific image subtype via the _subtype parameter. _encoder is a function which will perform the actual encoding for transport of the image data. It takes one argument, which is this Image instance. It should use get_payload() and set_payload() to change the payload to the encoded form. It should also add any Content-Transfer-Encoding or other headers to the message as necessary. The default encoding is Base64. Any additional keyword arguments are passed to the base class constructor, which turns them into parameters on the Content-Type header. """ if _subtype is None: _subtype = imghdr.what(None, _imagedata) if _subtype is None: raise TypeError('Could not guess image MIME subtype') MIMENonMultipart.__init__(self, 'image', _subtype, **_params) self.set_payload(_imagedata) _encoder(self) mime/nonmultipart.py 0000644 00000001263 15204103444 0010600 0 ustar 00 # Copyright (C) 2002-2006 Python Software Foundation # Author: Barry Warsaw # Contact: email-sig@python.org """Base class for MIME type messages that are not multipart.""" __all__ = ['MIMENonMultipart'] from email import errors from email.mime.base import MIMEBase class MIMENonMultipart(MIMEBase): """Base class for MIME non-multipart type messages.""" def attach(self, payload): # The public API prohibits attaching multiple subparts to MIMEBase # derived subtypes since none of them are, by definition, of content # type multipart/* raise errors.MultipartConversionError( 'Cannot attach additional subparts to non-multipart/*') mime/__pycache__/text.cpython-38.opt-2.pyc 0000644 00000001442 15204103444 0014255 0 ustar 00 U e5d� � @ s2 d gZ ddlmZ ddlmZ G dd � d e�ZdS )�MIMEText� )�Charset)�MIMENonMultipartc @ s e Zd Zddd�dd�ZdS )r �plainN)�policyc C sf |d kr4z|� d� d}W n tk r2 d}Y nX tj| d|fd|idt|�i�� | �||� d S )Nzus-asciizutf-8�textr �charset)�encode�UnicodeEncodeErrorr �__init__�strZ set_payload)�selfZ_textZ_subtypeZ_charsetr � r �'/usr/lib64/python3.8/email/mime/text.pyr s �zMIMEText.__init__)r N)�__name__� __module__� __qualname__r r r r r r s N)�__all__Z email.charsetr Zemail.mime.nonmultipartr r r r r r �<module> s mime/__pycache__/base.cpython-38.pyc 0000644 00000002023 15204103444 0013237 0 ustar 00 U e5d� � @ s4 d Z dgZddlZddlmZ G dd� dej�ZdS )�$Base class for MIME specializations.�MIMEBase� N)�messagec @ s e Zd ZdZdd�dd�ZdS )r r N��policyc K sH |dkrt jj}tjj| |d� d||f }| jd|f|� d| d< dS )z�This constructor adds a Content-Type: and a MIME-Version: header. The Content-Type: header is taken from the _maintype and _subtype arguments. Additional parameters for this header are taken from the keyword arguments. Nr z%s/%sz Content-Typez1.0z MIME-Version)�emailr Zcompat32r �Message�__init__Z add_header)�selfZ _maintypeZ_subtyper Z_paramsZctype� r �'/usr/lib64/python3.8/email/mime/base.pyr s zMIMEBase.__init__)�__name__� __module__� __qualname__�__doc__r r r r r r s )r �__all__Z email.policyr r r r r r r r �<module> s mime/__pycache__/text.cpython-38.opt-1.pyc 0000644 00000002441 15204103444 0014254 0 ustar 00 U e5d� � @ s6 d Z dgZddlmZ ddlmZ G dd� de�ZdS )z.Class representing text/* type MIME documents.�MIMEText� )�Charset)�MIMENonMultipartc @ s e Zd ZdZddd�dd�ZdS )r z0Class for generating text/* type MIME documents.�plainN)�policyc C sf |dkr4z|� d� d}W n tk r2 d}Y nX tj| d|fd|idt|�i�� | �||� dS )a~ Create a text/* type MIME document. _text is the string for this message object. _subtype is the MIME sub content type, defaulting to "plain". _charset is the character set parameter added to the Content-Type header. This defaults to "us-ascii". Note that as a side-effect, the Content-Transfer-Encoding header will also be set. Nzus-asciizutf-8�textr �charset)�encode�UnicodeEncodeErrorr �__init__�strZ set_payload)�selfZ_textZ_subtypeZ_charsetr � r �'/usr/lib64/python3.8/email/mime/text.pyr s �zMIMEText.__init__)r N)�__name__� __module__� __qualname__�__doc__r r r r r r s N)r �__all__Z email.charsetr Zemail.mime.nonmultipartr r r r r r �<module> s mime/__pycache__/application.cpython-38.pyc 0000644 00000002665 15204103444 0014644 0 ustar 00 U e5d) � @ s6 d Z dgZddlmZ ddlmZ G dd� de�ZdS )z5Class representing application/* type MIME documents.�MIMEApplication� )�encoders)�MIMENonMultipartc @ s& e Zd ZdZdejfdd�dd�ZdS )r z2Class for generating application/* MIME documents.z octet-streamN)�policyc K s@ |dkrt d��tj| d|fd|i|�� | �|� || � dS )a Create an application/* type MIME document. _data is a string containing the raw application data. _subtype is the MIME content type subtype, defaulting to 'octet-stream'. _encoder is a function which will perform the actual encoding for transport of the application data, defaulting to base64 encoding. Any additional keyword arguments are passed to the base class constructor, which turns them into parameters on the Content-Type header. Nz Invalid application MIME subtypeZ applicationr )� TypeErrorr �__init__Z set_payload)�self�_dataZ_subtypeZ_encoderr Z_params� r �./usr/lib64/python3.8/email/mime/application.pyr s � zMIMEApplication.__init__)�__name__� __module__� __qualname__�__doc__r Z encode_base64r r r r r r s ��N)r �__all__Zemailr Zemail.mime.nonmultipartr r r r r r �<module> s mime/__pycache__/base.cpython-38.opt-1.pyc 0000644 00000002023 15204103444 0014176 0 ustar 00 U e5d� � @ s4 d Z dgZddlZddlmZ G dd� dej�ZdS )�$Base class for MIME specializations.�MIMEBase� N)�messagec @ s e Zd ZdZdd�dd�ZdS )r r N��policyc K sH |dkrt jj}tjj| |d� d||f }| jd|f|� d| d< dS )z�This constructor adds a Content-Type: and a MIME-Version: header. The Content-Type: header is taken from the _maintype and _subtype arguments. Additional parameters for this header are taken from the keyword arguments. Nr z%s/%sz Content-Typez1.0z MIME-Version)�emailr Zcompat32r �Message�__init__Z add_header)�selfZ _maintypeZ_subtyper Z_paramsZctype� r �'/usr/lib64/python3.8/email/mime/base.pyr s zMIMEBase.__init__)�__name__� __module__� __qualname__�__doc__r r r r r r s )r �__all__Z email.policyr r r r r r r r �<module> s mime/__pycache__/multipart.cpython-38.pyc 0000644 00000002740 15204103444 0014354 0 ustar 00 U e5dU � @ s* d Z dgZddlmZ G dd� de�ZdS )�.Base class for MIME multipart/* type messages.� MIMEMultipart� )�MIMEBasec @ s e Zd ZdZddd�dd�ZdS )r r �mixedN)�policyc K sJ t j| d|fd|i|�� g | _|r8|D ]}| �|� q(|rF| �|� dS )a� Creates a multipart/* type message. By default, creates a multipart/mixed message, with proper Content-Type and MIME-Version headers. _subtype is the subtype of the multipart content type, defaulting to `mixed'. boundary is the multipart boundary string. By default it is calculated as needed. _subparts is a sequence of initial subparts for the payload. It must be an iterable object, such as a list. You can always attach new subparts to the message by using the attach() method. Additional parameters for the Content-Type header are taken from the keyword arguments (or passed into the _params argument). Z multipartr N)r �__init__Z_payloadZattachZ set_boundary)�selfZ_subtype�boundaryZ _subpartsr Z_params�p� r �,/usr/lib64/python3.8/email/mime/multipart.pyr s zMIMEMultipart.__init__)r NN)�__name__� __module__� __qualname__�__doc__r r r r r r s �N)r �__all__Zemail.mime.baser r r r r r �<module> s mime/__pycache__/message.cpython-38.opt-2.pyc 0000644 00000001430 15204103444 0014712 0 ustar 00 U e5d% � @ s2 d gZ ddlmZ ddlmZ G dd � d e�ZdS )� MIMEMessage� )�message)�MIMENonMultipartc @ s e Zd Zddd�dd�ZdS )r �rfc822N��policyc C sB t j| d||d� t|tj�s&td��tj�| |� | �d� d S )Nr r z&Argument is not an instance of Messagezmessage/rfc822)r �__init__� isinstancer ZMessage� TypeErrorZattachZset_default_type)�selfZ_msgZ_subtyper � r �*/usr/lib64/python3.8/email/mime/message.pyr s zMIMEMessage.__init__)r )�__name__� __module__� __qualname__r r r r r r s N)�__all__Zemailr Zemail.mime.nonmultipartr r r r r r �<module> s mime/__pycache__/message.cpython-38.pyc 0000644 00000002404 15204103444 0013754 0 ustar 00 U e5d% � @ s6 d Z dgZddlmZ ddlmZ G dd� de�ZdS )�,Class representing message/* MIME documents.� MIMEMessage� )�message)�MIMENonMultipartc @ s e Zd ZdZddd�dd�ZdS )r r �rfc822N��policyc C sB t j| d||d� t|tj�s&td��tj�| |� | �d� dS )a� Create a message/* type MIME document. _msg is a message object and must be an instance of Message, or a derived class of Message, otherwise a TypeError is raised. Optional _subtype defines the subtype of the contained message. The default is "rfc822" (this is defined by the MIME standard, even though the term "rfc822" is technically outdated by RFC 2822). r r z&Argument is not an instance of Messagezmessage/rfc822N)r �__init__� isinstancer ZMessage� TypeErrorZattachZset_default_type)�selfZ_msgZ_subtyper � r �*/usr/lib64/python3.8/email/mime/message.pyr s zMIMEMessage.__init__)r )�__name__� __module__� __qualname__�__doc__r r r r r r s N)r �__all__Zemailr Zemail.mime.nonmultipartr r r r r r �<module> s mime/__pycache__/application.cpython-38.opt-2.pyc 0000644 00000001447 15204103444 0015601 0 ustar 00 U e5d) � @ s2 d gZ ddlmZ ddlmZ G dd � d e�ZdS )�MIMEApplication� )�encoders)�MIMENonMultipartc @ s" e Zd Zdejfdd�dd�ZdS )r z octet-streamN)�policyc K s@ |d krt d��tj| d|fd|i|�� | �|� || � d S )Nz Invalid application MIME subtypeZ applicationr )� TypeErrorr �__init__Z set_payload)�self�_dataZ_subtypeZ_encoderr Z_params� r �./usr/lib64/python3.8/email/mime/application.pyr s � zMIMEApplication.__init__)�__name__� __module__� __qualname__r Z encode_base64r r r r r r s ��N)�__all__Zemailr Zemail.mime.nonmultipartr r r r r r �<module> s mime/__pycache__/__init__.cpython-38.opt-1.pyc 0000644 00000000206 15204103444 0015024 0 ustar 00 U ��.e � @ s d S )N� r r r �+/usr/lib64/python3.8/email/mime/__init__.py�<module> � mime/__pycache__/text.cpython-38.pyc 0000644 00000002441 15204103444 0013315 0 ustar 00 U e5d� � @ s6 d Z dgZddlmZ ddlmZ G dd� de�ZdS )z.Class representing text/* type MIME documents.�MIMEText� )�Charset)�MIMENonMultipartc @ s e Zd ZdZddd�dd�ZdS )r z0Class for generating text/* type MIME documents.�plainN)�policyc C sf |dkr4z|� d� d}W n tk r2 d}Y nX tj| d|fd|idt|�i�� | �||� dS )a~ Create a text/* type MIME document. _text is the string for this message object. _subtype is the MIME sub content type, defaulting to "plain". _charset is the character set parameter added to the Content-Type header. This defaults to "us-ascii". Note that as a side-effect, the Content-Transfer-Encoding header will also be set. Nzus-asciizutf-8�textr �charset)�encode�UnicodeEncodeErrorr �__init__�strZ set_payload)�selfZ_textZ_subtypeZ_charsetr � r �'/usr/lib64/python3.8/email/mime/text.pyr s �zMIMEText.__init__)r N)�__name__� __module__� __qualname__�__doc__r r r r r r s N)r �__all__Z email.charsetr Zemail.mime.nonmultipartr r r r r r �<module> s mime/__pycache__/__init__.cpython-38.opt-2.pyc 0000644 00000000206 15204103444 0015025 0 ustar 00 U ��.e � @ s d S )N� r r r �+/usr/lib64/python3.8/email/mime/__init__.py�<module> � mime/__pycache__/image.cpython-38.opt-1.pyc 0000644 00000003562 15204103444 0014357 0 ustar 00 U e5d% � @ s> d Z dgZddlZddlmZ ddlmZ G dd� de�ZdS )z/Class representing image/* type MIME documents.� MIMEImage� N)�encoders)�MIMENonMultipartc @ s& e Zd ZdZdejfdd�dd�ZdS )r z1Class for generating image/* type MIME documents.N)�policyc K sT |dkrt �d|�}|dkr$td��tj| d|fd|i|�� | �|� || � dS )a� Create an image/* type MIME document. _imagedata is a string containing the raw image data. If this data can be decoded by the standard Python `imghdr' module, then the subtype will be automatically included in the Content-Type header. Otherwise, you can specify the specific image subtype via the _subtype parameter. _encoder is a function which will perform the actual encoding for transport of the image data. It takes one argument, which is this Image instance. It should use get_payload() and set_payload() to change the payload to the encoded form. It should also add any Content-Transfer-Encoding or other headers to the message as necessary. The default encoding is Base64. Any additional keyword arguments are passed to the base class constructor, which turns them into parameters on the Content-Type header. Nz"Could not guess image MIME subtypeZimager )�imghdrZwhat� TypeErrorr �__init__Z set_payload)�selfZ _imagedataZ_subtypeZ_encoderr Z_params� r �(/usr/lib64/python3.8/email/mime/image.pyr s � zMIMEImage.__init__)�__name__� __module__� __qualname__�__doc__r Z encode_base64r r r r r r s ��)r �__all__r Zemailr Zemail.mime.nonmultipartr r r r r r �<module> s mime/__pycache__/image.cpython-38.opt-2.pyc 0000644 00000001475 15204103444 0014361 0 ustar 00 U e5d% � @ s: d gZ ddlZddlmZ ddlmZ G dd � d e�ZdS )� MIMEImage� N)�encoders)�MIMENonMultipartc @ s" e Zd Zdejfdd�dd�ZdS )r N)�policyc K sT |d krt �d |�}|d kr$td��tj| d|fd|i|�� | �|� || � d S )Nz"Could not guess image MIME subtypeZimager )�imghdrZwhat� TypeErrorr �__init__Z set_payload)�selfZ _imagedataZ_subtypeZ_encoderr Z_params� r �(/usr/lib64/python3.8/email/mime/image.pyr s � zMIMEImage.__init__)�__name__� __module__� __qualname__r Z encode_base64r r r r r r s ��)�__all__r Zemailr Zemail.mime.nonmultipartr r r r r r �<module> s mime/__pycache__/nonmultipart.cpython-38.opt-2.pyc 0000644 00000001167 15204103444 0016031 0 ustar 00 U e5d� � @ s2 d gZ ddlmZ ddlmZ G dd � d e�ZdS )�MIMENonMultipart� )�errors)�MIMEBasec @ s e Zd Zdd� ZdS )r c C s t �d��d S )Nz4Cannot attach additional subparts to non-multipart/*)r ZMultipartConversionError)�selfZpayload� r �//usr/lib64/python3.8/email/mime/nonmultipart.py�attach s �zMIMENonMultipart.attachN)�__name__� __module__� __qualname__r r r r r r s N)�__all__Zemailr Zemail.mime.baser r r r r r �<module> s mime/__pycache__/base.cpython-38.opt-2.pyc 0000644 00000001317 15204103444 0014204 0 ustar 00 U e5d� � @ s0 d gZ ddlZddlmZ G dd � d ej�ZdS )�MIMEBase� N)�messagec @ s e Zd Zdd�dd�ZdS )r N��policyc K sH |d krt jj}tjj| |d� d||f }| jd|f|� d| d< d S )Nr z%s/%sz Content-Typez1.0z MIME-Version)�emailr Zcompat32r �Message�__init__Z add_header)�selfZ _maintypeZ_subtyper Z_paramsZctype� r �'/usr/lib64/python3.8/email/mime/base.pyr s zMIMEBase.__init__)�__name__� __module__� __qualname__r r r r r r s )�__all__Z email.policyr r r r r r r r �<module> s mime/__pycache__/nonmultipart.cpython-38.pyc 0000644 00000001376 15204103444 0015073 0 ustar 00 U e5d� � @ s6 d Z dgZddlmZ ddlmZ G dd� de�ZdS )z9Base class for MIME type messages that are not multipart.�MIMENonMultipart� )�errors)�MIMEBasec @ s e Zd ZdZdd� ZdS )r z0Base class for MIME non-multipart type messages.c C s t �d��d S )Nz4Cannot attach additional subparts to non-multipart/*)r ZMultipartConversionError)�selfZpayload� r �//usr/lib64/python3.8/email/mime/nonmultipart.py�attach s �zMIMENonMultipart.attachN)�__name__� __module__� __qualname__�__doc__r r r r r r s N)r �__all__Zemailr Zemail.mime.baser r r r r r �<module> s mime/__pycache__/audio.cpython-38.pyc 0000644 00000005102 15204103444 0013427 0 ustar 00 U e5d� � @ s` d Z dgZddlZddlmZ ddlmZ ddlmZ ddd d d �Z d d � Z G d d� de�Z dS )z/Class representing audio/* type MIME documents.� MIMEAudio� N)�BytesIO)�encoders)�MIMENonMultipartZbasiczx-wavzx-aiff)ZauZwavZaiffZaifcc C sH | dd� }t |�}tjD ](}|||�}|dk rt�|d � S qdS )a Try to identify a sound file type. sndhdr.what() has a pretty cruddy interface, unfortunately. This is why we re-do it here. It would be easier to reverse engineer the Unix 'file' command and use the standard 'magic' file, as shipped with a modern Unix. Ni r )r �sndhdrZtests�_sndhdr_MIMEmap�get)�dataZhdrZfakefileZtestfn�res� r �(/usr/lib64/python3.8/email/mime/audio.py�_whatsnd s r c @ s& e Zd ZdZdejfdd�dd�ZdS )r z,Class for generating audio/* MIME documents.N)�policyc K sP |dkrt |�}|dkr td��tj| d|fd|i|�� | �|� || � dS )a Create an audio/* type MIME document. _audiodata is a string containing the raw audio data. If this data can be decoded by the standard Python `sndhdr' module, then the subtype will be automatically included in the Content-Type header. Otherwise, you can specify the specific audio subtype via the _subtype parameter. If _subtype is not given, and no subtype can be guessed, a TypeError is raised. _encoder is a function which will perform the actual encoding for transport of the image data. It takes one argument, which is this Image instance. It should use get_payload() and set_payload() to change the payload to the encoded form. It should also add any Content-Transfer-Encoding or other headers to the message as necessary. The default encoding is Base64. Any additional keyword arguments are passed to the base class constructor, which turns them into parameters on the Content-Type header. Nz!Could not find audio MIME subtypeZaudior )r � TypeErrorr �__init__Z set_payload)�selfZ _audiodataZ_subtypeZ_encoderr Z_paramsr r r r - s � zMIMEAudio.__init__)�__name__� __module__� __qualname__�__doc__r Z encode_base64r r r r r r * s ��) r �__all__r �ior Zemailr Zemail.mime.nonmultipartr r r r r r r r �<module> s � mime/__pycache__/multipart.cpython-38.opt-2.pyc 0000644 00000001304 15204103444 0015307 0 ustar 00 U e5dU � @ s& d gZ ddlmZ G dd � d e�ZdS )� MIMEMultipart� )�MIMEBasec @ s e Zd Zddd�dd�ZdS )r �mixedN)�policyc K sJ t j| d|fd|i|�� g | _|r8|D ]}| �|� q(|rF| �|� d S )NZ multipartr )r �__init__Z_payloadZattachZ set_boundary)�selfZ_subtype�boundaryZ _subpartsr Z_params�p� r �,/usr/lib64/python3.8/email/mime/multipart.pyr s zMIMEMultipart.__init__)r NN)�__name__� __module__� __qualname__r r r r r r s �N)�__all__Zemail.mime.baser r r r r r �<module> s mime/__pycache__/image.cpython-38.pyc 0000644 00000003562 15204103444 0013420 0 ustar 00 U e5d% � @ s> d Z dgZddlZddlmZ ddlmZ G dd� de�ZdS )z/Class representing image/* type MIME documents.� MIMEImage� N)�encoders)�MIMENonMultipartc @ s& e Zd ZdZdejfdd�dd�ZdS )r z1Class for generating image/* type MIME documents.N)�policyc K sT |dkrt �d|�}|dkr$td��tj| d|fd|i|�� | �|� || � dS )a� Create an image/* type MIME document. _imagedata is a string containing the raw image data. If this data can be decoded by the standard Python `imghdr' module, then the subtype will be automatically included in the Content-Type header. Otherwise, you can specify the specific image subtype via the _subtype parameter. _encoder is a function which will perform the actual encoding for transport of the image data. It takes one argument, which is this Image instance. It should use get_payload() and set_payload() to change the payload to the encoded form. It should also add any Content-Transfer-Encoding or other headers to the message as necessary. The default encoding is Base64. Any additional keyword arguments are passed to the base class constructor, which turns them into parameters on the Content-Type header. Nz"Could not guess image MIME subtypeZimager )�imghdrZwhat� TypeErrorr �__init__Z set_payload)�selfZ _imagedataZ_subtypeZ_encoderr Z_params� r �(/usr/lib64/python3.8/email/mime/image.pyr s � zMIMEImage.__init__)�__name__� __module__� __qualname__�__doc__r Z encode_base64r r r r r r s ��)r �__all__r Zemailr Zemail.mime.nonmultipartr r r r r r �<module> s mime/__pycache__/audio.cpython-38.opt-1.pyc 0000644 00000005102 15204103444 0014366 0 ustar 00 U e5d� � @ s` d Z dgZddlZddlmZ ddlmZ ddlmZ ddd d d �Z d d � Z G d d� de�Z dS )z/Class representing audio/* type MIME documents.� MIMEAudio� N)�BytesIO)�encoders)�MIMENonMultipartZbasiczx-wavzx-aiff)ZauZwavZaiffZaifcc C sH | dd� }t |�}tjD ](}|||�}|dk rt�|d � S qdS )a Try to identify a sound file type. sndhdr.what() has a pretty cruddy interface, unfortunately. This is why we re-do it here. It would be easier to reverse engineer the Unix 'file' command and use the standard 'magic' file, as shipped with a modern Unix. Ni r )r �sndhdrZtests�_sndhdr_MIMEmap�get)�dataZhdrZfakefileZtestfn�res� r �(/usr/lib64/python3.8/email/mime/audio.py�_whatsnd s r c @ s& e Zd ZdZdejfdd�dd�ZdS )r z,Class for generating audio/* MIME documents.N)�policyc K sP |dkrt |�}|dkr td��tj| d|fd|i|�� | �|� || � dS )a Create an audio/* type MIME document. _audiodata is a string containing the raw audio data. If this data can be decoded by the standard Python `sndhdr' module, then the subtype will be automatically included in the Content-Type header. Otherwise, you can specify the specific audio subtype via the _subtype parameter. If _subtype is not given, and no subtype can be guessed, a TypeError is raised. _encoder is a function which will perform the actual encoding for transport of the image data. It takes one argument, which is this Image instance. It should use get_payload() and set_payload() to change the payload to the encoded form. It should also add any Content-Transfer-Encoding or other headers to the message as necessary. The default encoding is Base64. Any additional keyword arguments are passed to the base class constructor, which turns them into parameters on the Content-Type header. Nz!Could not find audio MIME subtypeZaudior )r � TypeErrorr �__init__Z set_payload)�selfZ _audiodataZ_subtypeZ_encoderr Z_paramsr r r r - s � zMIMEAudio.__init__)�__name__� __module__� __qualname__�__doc__r Z encode_base64r r r r r r * s ��) r �__all__r �ior Zemailr Zemail.mime.nonmultipartr r r r r r r r �<module> s � mime/__pycache__/multipart.cpython-38.opt-1.pyc 0000644 00000002740 15204103444 0015313 0 ustar 00 U e5dU � @ s* d Z dgZddlmZ G dd� de�ZdS )�.Base class for MIME multipart/* type messages.� MIMEMultipart� )�MIMEBasec @ s e Zd ZdZddd�dd�ZdS )r r �mixedN)�policyc K sJ t j| d|fd|i|�� g | _|r8|D ]}| �|� q(|rF| �|� dS )a� Creates a multipart/* type message. By default, creates a multipart/mixed message, with proper Content-Type and MIME-Version headers. _subtype is the subtype of the multipart content type, defaulting to `mixed'. boundary is the multipart boundary string. By default it is calculated as needed. _subparts is a sequence of initial subparts for the payload. It must be an iterable object, such as a list. You can always attach new subparts to the message by using the attach() method. Additional parameters for the Content-Type header are taken from the keyword arguments (or passed into the _params argument). Z multipartr N)r �__init__Z_payloadZattachZ set_boundary)�selfZ_subtype�boundaryZ _subpartsr Z_params�p� r �,/usr/lib64/python3.8/email/mime/multipart.pyr s zMIMEMultipart.__init__)r NN)�__name__� __module__� __qualname__�__doc__r r r r r r s �N)r �__all__Zemail.mime.baser r r r r r �<module> s mime/__pycache__/audio.cpython-38.opt-2.pyc 0000644 00000002242 15204103444 0014371 0 ustar 00 U e5d� � @ s\ d gZ ddlZddlmZ ddlmZ ddlmZ ddddd �Zd d � Z G d d � d e�Z dS ) � MIMEAudio� N)�BytesIO)�encoders)�MIMENonMultipartZbasiczx-wavzx-aiff)ZauZwavZaiffZaifcc C sH | d d� }t |�}tjD ](}|||�}|d k rt�|d � S qd S )Ni r )r �sndhdrZtests�_sndhdr_MIMEmap�get)�dataZhdrZfakefileZtestfn�res� r �(/usr/lib64/python3.8/email/mime/audio.py�_whatsnd s r c @ s" e Zd Zdejfdd�dd�ZdS )r N)�policyc K sP |d krt |�}|d kr td��tj| d|fd|i|�� | �|� || � d S )Nz!Could not find audio MIME subtypeZaudior )r � TypeErrorr �__init__Z set_payload)�selfZ _audiodataZ_subtypeZ_encoderr Z_paramsr r r r - s � zMIMEAudio.__init__)�__name__� __module__� __qualname__r Z encode_base64r r r r r r * s ��) �__all__r �ior Zemailr Zemail.mime.nonmultipartr r r r r r r r �<module> s � mime/__pycache__/nonmultipart.cpython-38.opt-1.pyc 0000644 00000001376 15204103444 0016032 0 ustar 00 U e5d� � @ s6 d Z dgZddlmZ ddlmZ G dd� de�ZdS )z9Base class for MIME type messages that are not multipart.�MIMENonMultipart� )�errors)�MIMEBasec @ s e Zd ZdZdd� ZdS )r z0Base class for MIME non-multipart type messages.c C s t �d��d S )Nz4Cannot attach additional subparts to non-multipart/*)r ZMultipartConversionError)�selfZpayload� r �//usr/lib64/python3.8/email/mime/nonmultipart.py�attach s �zMIMENonMultipart.attachN)�__name__� __module__� __qualname__�__doc__r r r r r r s N)r �__all__Zemailr Zemail.mime.baser r r r r r �<module> s mime/__pycache__/application.cpython-38.opt-1.pyc 0000644 00000002665 15204103444 0015603 0 ustar 00 U e5d) � @ s6 d Z dgZddlmZ ddlmZ G dd� de�ZdS )z5Class representing application/* type MIME documents.�MIMEApplication� )�encoders)�MIMENonMultipartc @ s& e Zd ZdZdejfdd�dd�ZdS )r z2Class for generating application/* MIME documents.z octet-streamN)�policyc K s@ |dkrt d��tj| d|fd|i|�� | �|� || � dS )a Create an application/* type MIME document. _data is a string containing the raw application data. _subtype is the MIME content type subtype, defaulting to 'octet-stream'. _encoder is a function which will perform the actual encoding for transport of the application data, defaulting to base64 encoding. Any additional keyword arguments are passed to the base class constructor, which turns them into parameters on the Content-Type header. Nz Invalid application MIME subtypeZ applicationr )� TypeErrorr �__init__Z set_payload)�self�_dataZ_subtypeZ_encoderr Z_params� r �./usr/lib64/python3.8/email/mime/application.pyr s � zMIMEApplication.__init__)�__name__� __module__� __qualname__�__doc__r Z encode_base64r r r r r r s ��N)r �__all__Zemailr Zemail.mime.nonmultipartr r r r r r �<module> s mime/__pycache__/message.cpython-38.opt-1.pyc 0000644 00000002404 15204103444 0014713 0 ustar 00 U e5d% � @ s6 d Z dgZddlmZ ddlmZ G dd� de�ZdS )�,Class representing message/* MIME documents.� MIMEMessage� )�message)�MIMENonMultipartc @ s e Zd ZdZddd�dd�ZdS )r r �rfc822N��policyc C sB t j| d||d� t|tj�s&td��tj�| |� | �d� dS )a� Create a message/* type MIME document. _msg is a message object and must be an instance of Message, or a derived class of Message, otherwise a TypeError is raised. Optional _subtype defines the subtype of the contained message. The default is "rfc822" (this is defined by the MIME standard, even though the term "rfc822" is technically outdated by RFC 2822). r r z&Argument is not an instance of Messagezmessage/rfc822N)r �__init__� isinstancer ZMessage� TypeErrorZattachZset_default_type)�selfZ_msgZ_subtyper � r �*/usr/lib64/python3.8/email/mime/message.pyr s zMIMEMessage.__init__)r )�__name__� __module__� __qualname__�__doc__r r r r r r s N)r �__all__Zemailr Zemail.mime.nonmultipartr r r r r r �<module> s mime/__pycache__/__init__.cpython-38.pyc 0000644 00000000206 15204103444 0014065 0 ustar 00 U ��.e � @ s d S )N� r r r �+/usr/lib64/python3.8/email/mime/__init__.py�<module> � mime/text.py 0000644 00000001756 15204103444 0007037 0 ustar 00 # Copyright (C) 2001-2006 Python Software Foundation # Author: Barry Warsaw # Contact: email-sig@python.org """Class representing text/* type MIME documents.""" __all__ = ['MIMEText'] from email.encoders import encode_7or8bit from email.mime.nonmultipart import MIMENonMultipart class MIMEText(MIMENonMultipart): """Class for generating text/* type MIME documents.""" def __init__(self, _text, _subtype='plain', _charset='us-ascii'): """Create a text/* type MIME document. _text is the string for this message object. _subtype is the MIME sub content type, defaulting to "plain". _charset is the character set parameter added to the Content-Type header. This defaults to "us-ascii". Note that as a side-effect, the Content-Transfer-Encoding header will also be set. """ MIMENonMultipart.__init__(self, 'text', _subtype, **{'charset': _charset}) self.set_payload(_text, _charset) mime/audio.py 0000644 00000005173 15204103444 0007151 0 ustar 00 # Copyright (C) 2001-2006 Python Software Foundation # Author: Anthony Baxter # Contact: email-sig@python.org """Class representing audio/* type MIME documents.""" __all__ = ['MIMEAudio'] import sndhdr from cStringIO import StringIO from email import encoders from email.mime.nonmultipart import MIMENonMultipart _sndhdr_MIMEmap = {'au' : 'basic', 'wav' :'x-wav', 'aiff':'x-aiff', 'aifc':'x-aiff', } # There are others in sndhdr that don't have MIME types. :( # Additional ones to be added to sndhdr? midi, mp3, realaudio, wma?? def _whatsnd(data): """Try to identify a sound file type. sndhdr.what() has a pretty cruddy interface, unfortunately. This is why we re-do it here. It would be easier to reverse engineer the Unix 'file' command and use the standard 'magic' file, as shipped with a modern Unix. """ hdr = data[:512] fakefile = StringIO(hdr) for testfn in sndhdr.tests: res = testfn(hdr, fakefile) if res is not None: return _sndhdr_MIMEmap.get(res[0]) return None class MIMEAudio(MIMENonMultipart): """Class for generating audio/* MIME documents.""" def __init__(self, _audiodata, _subtype=None, _encoder=encoders.encode_base64, **_params): """Create an audio/* type MIME document. _audiodata is a string containing the raw audio data. If this data can be decoded by the standard Python `sndhdr' module, then the subtype will be automatically included in the Content-Type header. Otherwise, you can specify the specific audio subtype via the _subtype parameter. If _subtype is not given, and no subtype can be guessed, a TypeError is raised. _encoder is a function which will perform the actual encoding for transport of the image data. It takes one argument, which is this Image instance. It should use get_payload() and set_payload() to change the payload to the encoded form. It should also add any Content-Transfer-Encoding or other headers to the message as necessary. The default encoding is Base64. Any additional keyword arguments are passed to the base class constructor, which turns them into parameters on the Content-Type header. """ if _subtype is None: _subtype = _whatsnd(_audiodata) if _subtype is None: raise TypeError('Could not find audio MIME subtype') MIMENonMultipart.__init__(self, 'audio', _subtype, **_params) self.set_payload(_audiodata) _encoder(self) mime/application.py 0000644 00000002350 15204103444 0010345 0 ustar 00 # Copyright (C) 2001-2006 Python Software Foundation # Author: Keith Dart # Contact: email-sig@python.org """Class representing application/* type MIME documents.""" __all__ = ["MIMEApplication"] from email import encoders from email.mime.nonmultipart import MIMENonMultipart class MIMEApplication(MIMENonMultipart): """Class for generating application/* MIME documents.""" def __init__(self, _data, _subtype='octet-stream', _encoder=encoders.encode_base64, **_params): """Create an application/* type MIME document. _data is a string containing the raw application data. _subtype is the MIME content type subtype, defaulting to 'octet-stream'. _encoder is a function which will perform the actual encoding for transport of the application data, defaulting to base64 encoding. Any additional keyword arguments are passed to the base class constructor, which turns them into parameters on the Content-Type header. """ if _subtype is None: raise TypeError('Invalid application MIME subtype') MIMENonMultipart.__init__(self, 'application', _subtype, **_params) self.set_payload(_data) _encoder(self) mime/multipart.py 0000644 00000003045 15204103444 0010065 0 ustar 00 # Copyright (C) 2002-2006 Python Software Foundation # Author: Barry Warsaw # Contact: email-sig@python.org """Base class for MIME multipart/* type messages.""" __all__ = ['MIMEMultipart'] from email.mime.base import MIMEBase class MIMEMultipart(MIMEBase): """Base class for MIME multipart/* type messages.""" def __init__(self, _subtype='mixed', boundary=None, _subparts=None, **_params): """Creates a multipart/* type message. By default, creates a multipart/mixed message, with proper Content-Type and MIME-Version headers. _subtype is the subtype of the multipart content type, defaulting to `mixed'. boundary is the multipart boundary string. By default it is calculated as needed. _subparts is a sequence of initial subparts for the payload. It must be an iterable object, such as a list. You can always attach new subparts to the message by using the attach() method. Additional parameters for the Content-Type header are taken from the keyword arguments (or passed into the _params argument). """ MIMEBase.__init__(self, 'multipart', _subtype, **_params) # Initialise _payload to an empty list as the Message superclass's # implementation of is_multipart assumes that _payload is a list for # multipart messages. self._payload = [] if _subparts: for p in _subparts: self.attach(p) if boundary: self.set_boundary(boundary) mime/base.py 0000644 00000001432 15204103445 0006755 0 ustar 00 # Copyright (C) 2001-2006 Python Software Foundation # Author: Barry Warsaw # Contact: email-sig@python.org """Base class for MIME specializations.""" __all__ = ['MIMEBase'] from email import message class MIMEBase(message.Message): """Base class for MIME specializations.""" def __init__(self, _maintype, _subtype, **_params): """This constructor adds a Content-Type: and a MIME-Version: header. The Content-Type: header is taken from the _maintype and _subtype arguments. Additional parameters for this header are taken from the keyword arguments. """ message.Message.__init__(self) ctype = '%s/%s' % (_maintype, _subtype) self.add_header('Content-Type', ctype, **_params) self['MIME-Version'] = '1.0' policy.py 0000644 00000024217 15204103445 0006421 0 ustar 00 """This will be the home for the policy that hooks in the new code that adds all the email6 features. """ import re import sys from email._policybase import Policy, Compat32, compat32, _extend_docstrings from email.utils import _has_surrogates from email.headerregistry import HeaderRegistry as HeaderRegistry from email.contentmanager import raw_data_manager from email.message import EmailMessage __all__ = [ 'Compat32', 'compat32', 'Policy', 'EmailPolicy', 'default', 'strict', 'SMTP', 'HTTP', ] linesep_splitter = re.compile(r'\n|\r') @_extend_docstrings class EmailPolicy(Policy): """+ PROVISIONAL The API extensions enabled by this policy are currently provisional. Refer to the documentation for details. This policy adds new header parsing and folding algorithms. Instead of simple strings, headers are custom objects with custom attributes depending on the type of the field. The folding algorithm fully implements RFCs 2047 and 5322. In addition to the settable attributes listed above that apply to all Policies, this policy adds the following additional attributes: utf8 -- if False (the default) message headers will be serialized as ASCII, using encoded words to encode any non-ASCII characters in the source strings. If True, the message headers will be serialized using utf8 and will not contain encoded words (see RFC 6532 for more on this serialization format). refold_source -- if the value for a header in the Message object came from the parsing of some source, this attribute indicates whether or not a generator should refold that value when transforming the message back into stream form. The possible values are: none -- all source values use original folding long -- source values that have any line that is longer than max_line_length will be refolded all -- all values are refolded. The default is 'long'. header_factory -- a callable that takes two arguments, 'name' and 'value', where 'name' is a header field name and 'value' is an unfolded header field value, and returns a string-like object that represents that header. A default header_factory is provided that understands some of the RFC5322 header field types. (Currently address fields and date fields have special treatment, while all other fields are treated as unstructured. This list will be completed before the extension is marked stable.) content_manager -- an object with at least two methods: get_content and set_content. When the get_content or set_content method of a Message object is called, it calls the corresponding method of this object, passing it the message object as its first argument, and any arguments or keywords that were passed to it as additional arguments. The default content_manager is :data:`~email.contentmanager.raw_data_manager`. """ message_factory = EmailMessage utf8 = False refold_source = 'long' header_factory = HeaderRegistry() content_manager = raw_data_manager def __init__(self, **kw): # Ensure that each new instance gets a unique header factory # (as opposed to clones, which share the factory). if 'header_factory' not in kw: object.__setattr__(self, 'header_factory', HeaderRegistry()) super().__init__(**kw) def header_max_count(self, name): """+ The implementation for this class returns the max_count attribute from the specialized header class that would be used to construct a header of type 'name'. """ return self.header_factory[name].max_count # The logic of the next three methods is chosen such that it is possible to # switch a Message object between a Compat32 policy and a policy derived # from this class and have the results stay consistent. This allows a # Message object constructed with this policy to be passed to a library # that only handles Compat32 objects, or to receive such an object and # convert it to use the newer style by just changing its policy. It is # also chosen because it postpones the relatively expensive full rfc5322 # parse until as late as possible when parsing from source, since in many # applications only a few headers will actually be inspected. def header_source_parse(self, sourcelines): """+ The name is parsed as everything up to the ':' and returned unmodified. The value is determined by stripping leading whitespace off the remainder of the first line, joining all subsequent lines together, and stripping any trailing carriage return or linefeed characters. (This is the same as Compat32). """ name, value = sourcelines[0].split(':', 1) value = value.lstrip(' \t') + ''.join(sourcelines[1:]) return (name, value.rstrip('\r\n')) def header_store_parse(self, name, value): """+ The name is returned unchanged. If the input value has a 'name' attribute and it matches the name ignoring case, the value is returned unchanged. Otherwise the name and value are passed to header_factory method, and the resulting custom header object is returned as the value. In this case a ValueError is raised if the input value contains CR or LF characters. """ if hasattr(value, 'name') and value.name.lower() == name.lower(): return (name, value) if isinstance(value, str) and len(value.splitlines())>1: # XXX this error message isn't quite right when we use splitlines # (see issue 22233), but I'm not sure what should happen here. raise ValueError("Header values may not contain linefeed " "or carriage return characters") return (name, self.header_factory(name, value)) def header_fetch_parse(self, name, value): """+ If the value has a 'name' attribute, it is returned to unmodified. Otherwise the name and the value with any linesep characters removed are passed to the header_factory method, and the resulting custom header object is returned. Any surrogateescaped bytes get turned into the unicode unknown-character glyph. """ if hasattr(value, 'name'): return value # We can't use splitlines here because it splits on more than \r and \n. value = ''.join(linesep_splitter.split(value)) return self.header_factory(name, value) def fold(self, name, value): """+ Header folding is controlled by the refold_source policy setting. A value is considered to be a 'source value' if and only if it does not have a 'name' attribute (having a 'name' attribute means it is a header object of some sort). If a source value needs to be refolded according to the policy, it is converted into a custom header object by passing the name and the value with any linesep characters removed to the header_factory method. Folding of a custom header object is done by calling its fold method with the current policy. Source values are split into lines using splitlines. If the value is not to be refolded, the lines are rejoined using the linesep from the policy and returned. The exception is lines containing non-ascii binary data. In that case the value is refolded regardless of the refold_source setting, which causes the binary data to be CTE encoded using the unknown-8bit charset. """ return self._fold(name, value, refold_binary=True) def fold_binary(self, name, value): """+ The same as fold if cte_type is 7bit, except that the returned value is bytes. If cte_type is 8bit, non-ASCII binary data is converted back into bytes. Headers with binary data are not refolded, regardless of the refold_header setting, since there is no way to know whether the binary data consists of single byte characters or multibyte characters. If utf8 is true, headers are encoded to utf8, otherwise to ascii with non-ASCII unicode rendered as encoded words. """ folded = self._fold(name, value, refold_binary=self.cte_type=='7bit') charset = 'utf8' if self.utf8 else 'ascii' return folded.encode(charset, 'surrogateescape') def _fold(self, name, value, refold_binary=False): if hasattr(value, 'name'): return value.fold(policy=self) maxlen = self.max_line_length if self.max_line_length else sys.maxsize lines = value.splitlines() refold = (self.refold_source == 'all' or self.refold_source == 'long' and (lines and len(lines[0])+len(name)+2 > maxlen or any(len(x) > maxlen for x in lines[1:]))) if refold or refold_binary and _has_surrogates(value): return self.header_factory(name, ''.join(lines)).fold(policy=self) return name + ': ' + self.linesep.join(lines) + self.linesep default = EmailPolicy() # Make the default policy use the class default header_factory del default.header_factory strict = default.clone(raise_on_defect=True) SMTP = default.clone(linesep='\r\n') HTTP = default.clone(linesep='\r\n', max_line_length=None) SMTPUTF8 = SMTP.clone(utf8=True) utils.py 0000644 00000023452 15204103445 0006262 0 ustar 00 # Copyright (C) 2001-2010 Python Software Foundation # Author: Barry Warsaw # Contact: email-sig@python.org """Miscellaneous utilities.""" __all__ = [ 'collapse_rfc2231_value', 'decode_params', 'decode_rfc2231', 'encode_rfc2231', 'formataddr', 'formatdate', 'getaddresses', 'make_msgid', 'mktime_tz', 'parseaddr', 'parsedate', 'parsedate_tz', 'unquote', ] import os import re import time import base64 import random import socket import urllib import warnings from email._parseaddr import quote from email._parseaddr import AddressList as _AddressList from email._parseaddr import mktime_tz # We need wormarounds for bugs in these methods in older Pythons (see below) from email._parseaddr import parsedate as _parsedate from email._parseaddr import parsedate_tz as _parsedate_tz from quopri import decodestring as _qdecode # Intrapackage imports from email.encoders import _bencode, _qencode COMMASPACE = ', ' EMPTYSTRING = '' UEMPTYSTRING = u'' CRLF = '\r\n' TICK = "'" specialsre = re.compile(r'[][\\()<>@,:;".]') escapesre = re.compile(r'[][\\()"]') # Helpers def _identity(s): return s def _bdecode(s): """Decodes a base64 string. This function is equivalent to base64.decodestring and it's retained only for backward compatibility. It used to remove the last \\n of the decoded string, if it had any (see issue 7143). """ if not s: return s return base64.decodestring(s) def fix_eols(s): """Replace all line-ending characters with \\r\\n.""" # Fix newlines with no preceding carriage return s = re.sub(r'(?<!\r)\n', CRLF, s) # Fix carriage returns with no following newline s = re.sub(r'\r(?!\n)', CRLF, s) return s def formataddr(pair): """The inverse of parseaddr(), this takes a 2-tuple of the form (realname, email_address) and returns the string value suitable for an RFC 2822 From, To or Cc header. If the first element of pair is false, then the second element is returned unmodified. """ name, address = pair if name: quotes = '' if specialsre.search(name): quotes = '"' name = escapesre.sub(r'\\\g<0>', name) return '%s%s%s <%s>' % (quotes, name, quotes, address) return address def getaddresses(fieldvalues): """Return a list of (REALNAME, EMAIL) for each fieldvalue.""" all = COMMASPACE.join(fieldvalues) a = _AddressList(all) return a.addresslist ecre = re.compile(r''' =\? # literal =? (?P<charset>[^?]*?) # non-greedy up to the next ? is the charset \? # literal ? (?P<encoding>[qb]) # either a "q" or a "b", case insensitive \? # literal ? (?P<atom>.*?) # non-greedy up to the next ?= is the atom \?= # literal ?= ''', re.VERBOSE | re.IGNORECASE) def formatdate(timeval=None, localtime=False, usegmt=False): """Returns a date string as specified by RFC 2822, e.g.: Fri, 09 Nov 2001 01:08:47 -0000 Optional timeval if given is a floating point time value as accepted by gmtime() and localtime(), otherwise the current time is used. Optional localtime is a flag that when True, interprets timeval, and returns a date relative to the local timezone instead of UTC, properly taking daylight savings time into account. Optional argument usegmt means that the timezone is written out as an ascii string, not numeric one (so "GMT" instead of "+0000"). This is needed for HTTP, and is only used when localtime==False. """ # Note: we cannot use strftime() because that honors the locale and RFC # 2822 requires that day and month names be the English abbreviations. if timeval is None: timeval = time.time() if localtime: now = time.localtime(timeval) # Calculate timezone offset, based on whether the local zone has # daylight savings time, and whether DST is in effect. if time.daylight and now[-1]: offset = time.altzone else: offset = time.timezone hours, minutes = divmod(abs(offset), 3600) # Remember offset is in seconds west of UTC, but the timezone is in # minutes east of UTC, so the signs differ. if offset > 0: sign = '-' else: sign = '+' zone = '%s%02d%02d' % (sign, hours, minutes // 60) else: now = time.gmtime(timeval) # Timezone offset is always -0000 if usegmt: zone = 'GMT' else: zone = '-0000' return '%s, %02d %s %04d %02d:%02d:%02d %s' % ( ['Mon', 'Tue', 'Wed', 'Thu', 'Fri', 'Sat', 'Sun'][now[6]], now[2], ['Jan', 'Feb', 'Mar', 'Apr', 'May', 'Jun', 'Jul', 'Aug', 'Sep', 'Oct', 'Nov', 'Dec'][now[1] - 1], now[0], now[3], now[4], now[5], zone) def make_msgid(idstring=None): """Returns a string suitable for RFC 2822 compliant Message-ID, e.g: <142480216486.20800.16526388040877946887@nightshade.la.mastaler.com> Optional idstring if given is a string used to strengthen the uniqueness of the message id. """ timeval = int(time.time()*100) pid = os.getpid() randint = random.getrandbits(64) if idstring is None: idstring = '' else: idstring = '.' + idstring idhost = socket.getfqdn() msgid = '<%d.%d.%d%s@%s>' % (timeval, pid, randint, idstring, idhost) return msgid # These functions are in the standalone mimelib version only because they've # subsequently been fixed in the latest Python versions. We use this to worm # around broken older Pythons. def parsedate(data): if not data: return None return _parsedate(data) def parsedate_tz(data): if not data: return None return _parsedate_tz(data) def parseaddr(addr): """ Parse addr into its constituent realname and email address parts. Return a tuple of realname and email address, unless the parse fails, in which case return a 2-tuple of ('', ''). """ addrs = _AddressList(addr).addresslist if not addrs: return '', '' return addrs[0] # rfc822.unquote() doesn't properly de-backslash-ify in Python pre-2.3. def unquote(str): """Remove quotes from a string.""" if len(str) > 1: if str.startswith('"') and str.endswith('"'): return str[1:-1].replace('\\\\', '\\').replace('\\"', '"') if str.startswith('<') and str.endswith('>'): return str[1:-1] return str # RFC2231-related functions - parameter encoding and decoding def decode_rfc2231(s): """Decode string according to RFC 2231""" parts = s.split(TICK, 2) if len(parts) <= 2: return None, None, s return parts def encode_rfc2231(s, charset=None, language=None): """Encode string according to RFC 2231. If neither charset nor language is given, then s is returned as-is. If charset is given but not language, the string is encoded using the empty string for language. """ import urllib s = urllib.quote(s, safe='') if charset is None and language is None: return s if language is None: language = '' return "%s'%s'%s" % (charset, language, s) rfc2231_continuation = re.compile(r'^(?P<name>\w+)\*((?P<num>[0-9]+)\*?)?$') def decode_params(params): """Decode parameters list according to RFC 2231. params is a sequence of 2-tuples containing (param name, string value). """ # Copy params so we don't mess with the original params = params[:] new_params = [] # Map parameter's name to a list of continuations. The values are a # 3-tuple of the continuation number, the string value, and a flag # specifying whether a particular segment is %-encoded. rfc2231_params = {} name, value = params.pop(0) new_params.append((name, value)) while params: name, value = params.pop(0) if name.endswith('*'): encoded = True else: encoded = False value = unquote(value) mo = rfc2231_continuation.match(name) if mo: name, num = mo.group('name', 'num') if num is not None: num = int(num) rfc2231_params.setdefault(name, []).append((num, value, encoded)) else: new_params.append((name, '"%s"' % quote(value))) if rfc2231_params: for name, continuations in rfc2231_params.items(): value = [] extended = False # Sort by number continuations.sort() # And now append all values in numerical order, converting # %-encodings for the encoded segments. If any of the # continuation names ends in a *, then the entire string, after # decoding segments and concatenating, must have the charset and # language specifiers at the beginning of the string. for num, s, encoded in continuations: if encoded: s = urllib.unquote(s) extended = True value.append(s) value = quote(EMPTYSTRING.join(value)) if extended: charset, language, value = decode_rfc2231(value) new_params.append((name, (charset, language, '"%s"' % value))) else: new_params.append((name, '"%s"' % value)) return new_params def collapse_rfc2231_value(value, errors='replace', fallback_charset='us-ascii'): if isinstance(value, tuple): rawval = unquote(value[2]) charset = value[0] or 'us-ascii' try: return unicode(rawval, charset, errors) except LookupError: # XXX charset is unknown to Python. return unicode(rawval, fallback_charset, errors) else: return unquote(value) errors.py 0000644 00000003134 15204103445 0006431 0 ustar 00 # Copyright (C) 2001-2006 Python Software Foundation # Author: Barry Warsaw # Contact: email-sig@python.org """email package exception classes.""" class MessageError(Exception): """Base class for errors in the email package.""" class MessageParseError(MessageError): """Base class for message parsing errors.""" class HeaderParseError(MessageParseError): """Error while parsing headers.""" class BoundaryError(MessageParseError): """Couldn't find terminating boundary.""" class MultipartConversionError(MessageError, TypeError): """Conversion to a multipart is prohibited.""" class CharsetError(MessageError): """An illegal charset was given.""" # These are parsing defects which the parser was able to work around. class MessageDefect: """Base class for a message defect.""" def __init__(self, line=None): self.line = line class NoBoundaryInMultipartDefect(MessageDefect): """A message claimed to be a multipart but had no boundary parameter.""" class StartBoundaryNotFoundDefect(MessageDefect): """The claimed start boundary was never found.""" class FirstHeaderLineIsContinuationDefect(MessageDefect): """A message had a continuation line as its first header line.""" class MisplacedEnvelopeHeaderDefect(MessageDefect): """A 'Unix-from' header was found in the middle of a header block.""" class MalformedHeaderDefect(MessageDefect): """Found a header that was missing a colon, or was otherwise malformed.""" class MultipartInvariantViolationDefect(MessageDefect): """A message claimed to be a multipart but no subparts were found.""" quoprimime.py 0000644 00000025140 15204103445 0007305 0 ustar 00 # Copyright (C) 2001-2006 Python Software Foundation # Author: Ben Gertzfield # Contact: email-sig@python.org """Quoted-printable content transfer encoding per RFCs 2045-2047. This module handles the content transfer encoding method defined in RFC 2045 to encode US ASCII-like 8-bit data called `quoted-printable'. It is used to safely encode text that is in a character set similar to the 7-bit US ASCII character set, but that includes some 8-bit characters that are normally not allowed in email bodies or headers. Quoted-printable is very space-inefficient for encoding binary files; use the email.base64mime module for that instead. This module provides an interface to encode and decode both headers and bodies with quoted-printable encoding. RFC 2045 defines a method for including character set information in an `encoded-word' in a header. This method is commonly used for 8-bit real names in To:/From:/Cc: etc. fields, as well as Subject: lines. This module does not do the line wrapping or end-of-line character conversion necessary for proper internationalized headers; it only does dumb encoding and decoding. To deal with the various line wrapping issues, use the email.header module. """ __all__ = [ 'body_decode', 'body_encode', 'body_quopri_check', 'body_quopri_len', 'decode', 'decodestring', 'encode', 'encodestring', 'header_decode', 'header_encode', 'header_quopri_check', 'header_quopri_len', 'quote', 'unquote', ] import re from string import hexdigits from email.utils import fix_eols CRLF = '\r\n' NL = '\n' # See also Charset.py MISC_LEN = 7 hqre = re.compile(r'[^-a-zA-Z0-9!*+/ ]') bqre = re.compile(r'[^ !-<>-~\t]') # Helpers def header_quopri_check(c): """Return True if the character should be escaped with header quopri.""" return bool(hqre.match(c)) def body_quopri_check(c): """Return True if the character should be escaped with body quopri.""" return bool(bqre.match(c)) def header_quopri_len(s): """Return the length of str when it is encoded with header quopri.""" count = 0 for c in s: if hqre.match(c): count += 3 else: count += 1 return count def body_quopri_len(str): """Return the length of str when it is encoded with body quopri.""" count = 0 for c in str: if bqre.match(c): count += 3 else: count += 1 return count def _max_append(L, s, maxlen, extra=''): if not L: L.append(s.lstrip()) elif len(L[-1]) + len(s) <= maxlen: L[-1] += extra + s else: L.append(s.lstrip()) def unquote(s): """Turn a string in the form =AB to the ASCII character with value 0xab""" return chr(int(s[1:3], 16)) def quote(c): return "=%02X" % ord(c) def header_encode(header, charset="iso-8859-1", keep_eols=False, maxlinelen=76, eol=NL): """Encode a single header line with quoted-printable (like) encoding. Defined in RFC 2045, this `Q' encoding is similar to quoted-printable, but used specifically for email header fields to allow charsets with mostly 7 bit characters (and some 8 bit) to remain more or less readable in non-RFC 2045 aware mail clients. charset names the character set to use to encode the header. It defaults to iso-8859-1. The resulting string will be in the form: "=?charset?q?I_f=E2rt_in_your_g=E8n=E8ral_dire=E7tion?\\n =?charset?q?Silly_=C8nglish_Kn=EEghts?=" with each line wrapped safely at, at most, maxlinelen characters (defaults to 76 characters). If maxlinelen is None, the entire string is encoded in one chunk with no splitting. End-of-line characters (\\r, \\n, \\r\\n) will be automatically converted to the canonical email line separator \\r\\n unless the keep_eols parameter is True (the default is False). Each line of the header will be terminated in the value of eol, which defaults to "\\n". Set this to "\\r\\n" if you are using the result of this function directly in email. """ # Return empty headers unchanged if not header: return header if not keep_eols: header = fix_eols(header) # Quopri encode each line, in encoded chunks no greater than maxlinelen in # length, after the RFC chrome is added in. quoted = [] if maxlinelen is None: # An obnoxiously large number that's good enough max_encoded = 100000 else: max_encoded = maxlinelen - len(charset) - MISC_LEN - 1 for c in header: # Space may be represented as _ instead of =20 for readability if c == ' ': _max_append(quoted, '_', max_encoded) # These characters can be included verbatim elif not hqre.match(c): _max_append(quoted, c, max_encoded) # Otherwise, replace with hex value like =E2 else: _max_append(quoted, "=%02X" % ord(c), max_encoded) # Now add the RFC chrome to each encoded chunk and glue the chunks # together. BAW: should we be able to specify the leading whitespace in # the joiner? joiner = eol + ' ' return joiner.join(['=?%s?q?%s?=' % (charset, line) for line in quoted]) def encode(body, binary=False, maxlinelen=76, eol=NL): """Encode with quoted-printable, wrapping at maxlinelen characters. If binary is False (the default), end-of-line characters will be converted to the canonical email end-of-line sequence \\r\\n. Otherwise they will be left verbatim. Each line of encoded text will end with eol, which defaults to "\\n". Set this to "\\r\\n" if you will be using the result of this function directly in an email. Each line will be wrapped at, at most, maxlinelen characters (defaults to 76 characters). Long lines will have the `soft linefeed' quoted-printable character "=" appended to them, so the decoded text will be identical to the original text. """ if not body: return body if not binary: body = fix_eols(body) # BAW: We're accumulating the body text by string concatenation. That # can't be very efficient, but I don't have time now to rewrite it. It # just feels like this algorithm could be more efficient. encoded_body = '' lineno = -1 # Preserve line endings here so we can check later to see an eol needs to # be added to the output later. lines = body.splitlines(1) for line in lines: # But strip off line-endings for processing this line. if line.endswith(CRLF): line = line[:-2] elif line[-1] in CRLF: line = line[:-1] lineno += 1 encoded_line = '' prev = None linelen = len(line) # Now we need to examine every character to see if it needs to be # quopri encoded. BAW: again, string concatenation is inefficient. for j in range(linelen): c = line[j] prev = c if bqre.match(c): c = quote(c) elif j+1 == linelen: # Check for whitespace at end of line; special case if c not in ' \t': encoded_line += c prev = c continue # Check to see to see if the line has reached its maximum length if len(encoded_line) + len(c) >= maxlinelen: encoded_body += encoded_line + '=' + eol encoded_line = '' encoded_line += c # Now at end of line.. if prev and prev in ' \t': # Special case for whitespace at end of file if lineno + 1 == len(lines): prev = quote(prev) if len(encoded_line) + len(prev) > maxlinelen: encoded_body += encoded_line + '=' + eol + prev else: encoded_body += encoded_line + prev # Just normal whitespace at end of line else: encoded_body += encoded_line + prev + '=' + eol encoded_line = '' # Now look at the line we just finished and it has a line ending, we # need to add eol to the end of the line. if lines[lineno].endswith(CRLF) or lines[lineno][-1] in CRLF: encoded_body += encoded_line + eol else: encoded_body += encoded_line encoded_line = '' return encoded_body # For convenience and backwards compatibility w/ standard base64 module body_encode = encode encodestring = encode # BAW: I'm not sure if the intent was for the signature of this function to be # the same as base64MIME.decode() or not... def decode(encoded, eol=NL): """Decode a quoted-printable string. Lines are separated with eol, which defaults to \\n. """ if not encoded: return encoded # BAW: see comment in encode() above. Again, we're building up the # decoded string with string concatenation, which could be done much more # efficiently. decoded = '' for line in encoded.splitlines(): line = line.rstrip() if not line: decoded += eol continue i = 0 n = len(line) while i < n: c = line[i] if c != '=': decoded += c i += 1 # Otherwise, c == "=". Are we at the end of the line? If so, add # a soft line break. elif i+1 == n: i += 1 continue # Decode if in form =AB elif i+2 < n and line[i+1] in hexdigits and line[i+2] in hexdigits: decoded += unquote(line[i:i+3]) i += 3 # Otherwise, not in form =AB, pass literally else: decoded += c i += 1 if i == n: decoded += eol # Special case if original string did not end with eol if not encoded.endswith(eol) and decoded.endswith(eol): decoded = decoded[:-1] return decoded # For convenience and backwards compatibility w/ standard base64 module body_decode = decode decodestring = decode def _unquote_match(match): """Turn a match in the form =AB to the ASCII character with value 0xab""" s = match.group(0) return unquote(s) # Header decoding is done a bit differently def header_decode(s): """Decode a string encoded with RFC 2045 MIME header `Q' encoding. This function does not parse a full MIME header value encoded with quoted-printable (like =?iso-8859-1?q?Hello_World?=) -- please use the high level email.header class for that functionality. """ s = s.replace('_', ' ') return re.sub(r'=[a-fA-F0-9]{2}', _unquote_match, s) _header_value_parser.py 0000644 00000320717 15204103445 0011265 0 ustar 00 """Header value parser implementing various email-related RFC parsing rules. The parsing methods defined in this module implement various email related parsing rules. Principal among them is RFC 5322, which is the followon to RFC 2822 and primarily a clarification of the former. It also implements RFC 2047 encoded word decoding. RFC 5322 goes to considerable trouble to maintain backward compatibility with RFC 822 in the parse phase, while cleaning up the structure on the generation phase. This parser supports correct RFC 5322 generation by tagging white space as folding white space only when folding is allowed in the non-obsolete rule sets. Actually, the parser is even more generous when accepting input than RFC 5322 mandates, following the spirit of Postel's Law, which RFC 5322 encourages. Where possible deviations from the standard are annotated on the 'defects' attribute of tokens that deviate. The general structure of the parser follows RFC 5322, and uses its terminology where there is a direct correspondence. Where the implementation requires a somewhat different structure than that used by the formal grammar, new terms that mimic the closest existing terms are used. Thus, it really helps to have a copy of RFC 5322 handy when studying this code. Input to the parser is a string that has already been unfolded according to RFC 5322 rules. According to the RFC this unfolding is the very first step, and this parser leaves the unfolding step to a higher level message parser, which will have already detected the line breaks that need unfolding while determining the beginning and end of each header. The output of the parser is a TokenList object, which is a list subclass. A TokenList is a recursive data structure. The terminal nodes of the structure are Terminal objects, which are subclasses of str. These do not correspond directly to terminal objects in the formal grammar, but are instead more practical higher level combinations of true terminals. All TokenList and Terminal objects have a 'value' attribute, which produces the semantically meaningful value of that part of the parse subtree. The value of all whitespace tokens (no matter how many sub-tokens they may contain) is a single space, as per the RFC rules. This includes 'CFWS', which is herein included in the general class of whitespace tokens. There is one exception to the rule that whitespace tokens are collapsed into single spaces in values: in the value of a 'bare-quoted-string' (a quoted-string with no leading or trailing whitespace), any whitespace that appeared between the quotation marks is preserved in the returned value. Note that in all Terminal strings quoted pairs are turned into their unquoted values. All TokenList and Terminal objects also have a string value, which attempts to be a "canonical" representation of the RFC-compliant form of the substring that produced the parsed subtree, including minimal use of quoted pair quoting. Whitespace runs are not collapsed. Comment tokens also have a 'content' attribute providing the string found between the parens (including any nested comments) with whitespace preserved. All TokenList and Terminal objects have a 'defects' attribute which is a possibly empty list all of the defects found while creating the token. Defects may appear on any token in the tree, and a composite list of all defects in the subtree is available through the 'all_defects' attribute of any node. (For Terminal notes x.defects == x.all_defects.) Each object in a parse tree is called a 'token', and each has a 'token_type' attribute that gives the name from the RFC 5322 grammar that it represents. Not all RFC 5322 nodes are produced, and there is one non-RFC 5322 node that may be produced: 'ptext'. A 'ptext' is a string of printable ascii characters. It is returned in place of lists of (ctext/quoted-pair) and (qtext/quoted-pair). XXX: provide complete list of token types. """ import re import sys import urllib # For urllib.parse.unquote from string import hexdigits from operator import itemgetter from email import _encoded_words as _ew from email import errors from email import utils # # Useful constants and functions # WSP = set(' \t') CFWS_LEADER = WSP | set('(') SPECIALS = set(r'()<>@,:;.\"[]') ATOM_ENDS = SPECIALS | WSP DOT_ATOM_ENDS = ATOM_ENDS - set('.') # '.', '"', and '(' do not end phrases in order to support obs-phrase PHRASE_ENDS = SPECIALS - set('."(') TSPECIALS = (SPECIALS | set('/?=')) - set('.') TOKEN_ENDS = TSPECIALS | WSP ASPECIALS = TSPECIALS | set("*'%") ATTRIBUTE_ENDS = ASPECIALS | WSP EXTENDED_ATTRIBUTE_ENDS = ATTRIBUTE_ENDS - set('%') def quote_string(value): return '"'+str(value).replace('\\', '\\\\').replace('"', r'\"')+'"' # Match a RFC 2047 word, looks like =?utf-8?q?someword?= rfc2047_matcher = re.compile(r''' =\? # literal =? [^?]* # charset \? # literal ? [qQbB] # literal 'q' or 'b', case insensitive \? # literal ? .*? # encoded word \?= # literal ?= ''', re.VERBOSE | re.MULTILINE) # # TokenList and its subclasses # class TokenList(list): token_type = None syntactic_break = True ew_combine_allowed = True def __init__(self, *args, **kw): super().__init__(*args, **kw) self.defects = [] def __str__(self): return ''.join(str(x) for x in self) def __repr__(self): return '{}({})'.format(self.__class__.__name__, super().__repr__()) @property def value(self): return ''.join(x.value for x in self if x.value) @property def all_defects(self): return sum((x.all_defects for x in self), self.defects) def startswith_fws(self): return self[0].startswith_fws() @property def as_ew_allowed(self): """True if all top level tokens of this part may be RFC2047 encoded.""" return all(part.as_ew_allowed for part in self) @property def comments(self): comments = [] for token in self: comments.extend(token.comments) return comments def fold(self, *, policy): return _refold_parse_tree(self, policy=policy) def pprint(self, indent=''): print(self.ppstr(indent=indent)) def ppstr(self, indent=''): return '\n'.join(self._pp(indent=indent)) def _pp(self, indent=''): yield '{}{}/{}('.format( indent, self.__class__.__name__, self.token_type) for token in self: if not hasattr(token, '_pp'): yield (indent + ' !! invalid element in token ' 'list: {!r}'.format(token)) else: yield from token._pp(indent+' ') if self.defects: extra = ' Defects: {}'.format(self.defects) else: extra = '' yield '{}){}'.format(indent, extra) class WhiteSpaceTokenList(TokenList): @property def value(self): return ' ' @property def comments(self): return [x.content for x in self if x.token_type=='comment'] class UnstructuredTokenList(TokenList): token_type = 'unstructured' class Phrase(TokenList): token_type = 'phrase' class Word(TokenList): token_type = 'word' class CFWSList(WhiteSpaceTokenList): token_type = 'cfws' class Atom(TokenList): token_type = 'atom' class Token(TokenList): token_type = 'token' encode_as_ew = False class EncodedWord(TokenList): token_type = 'encoded-word' cte = None charset = None lang = None class QuotedString(TokenList): token_type = 'quoted-string' @property def content(self): for x in self: if x.token_type == 'bare-quoted-string': return x.value @property def quoted_value(self): res = [] for x in self: if x.token_type == 'bare-quoted-string': res.append(str(x)) else: res.append(x.value) return ''.join(res) @property def stripped_value(self): for token in self: if token.token_type == 'bare-quoted-string': return token.value class BareQuotedString(QuotedString): token_type = 'bare-quoted-string' def __str__(self): return quote_string(''.join(str(x) for x in self)) @property def value(self): return ''.join(str(x) for x in self) class Comment(WhiteSpaceTokenList): token_type = 'comment' def __str__(self): return ''.join(sum([ ["("], [self.quote(x) for x in self], [")"], ], [])) def quote(self, value): if value.token_type == 'comment': return str(value) return str(value).replace('\\', '\\\\').replace( '(', r'\(').replace( ')', r'\)') @property def content(self): return ''.join(str(x) for x in self) @property def comments(self): return [self.content] class AddressList(TokenList): token_type = 'address-list' @property def addresses(self): return [x for x in self if x.token_type=='address'] @property def mailboxes(self): return sum((x.mailboxes for x in self if x.token_type=='address'), []) @property def all_mailboxes(self): return sum((x.all_mailboxes for x in self if x.token_type=='address'), []) class Address(TokenList): token_type = 'address' @property def display_name(self): if self[0].token_type == 'group': return self[0].display_name @property def mailboxes(self): if self[0].token_type == 'mailbox': return [self[0]] elif self[0].token_type == 'invalid-mailbox': return [] return self[0].mailboxes @property def all_mailboxes(self): if self[0].token_type == 'mailbox': return [self[0]] elif self[0].token_type == 'invalid-mailbox': return [self[0]] return self[0].all_mailboxes class MailboxList(TokenList): token_type = 'mailbox-list' @property def mailboxes(self): return [x for x in self if x.token_type=='mailbox'] @property def all_mailboxes(self): return [x for x in self if x.token_type in ('mailbox', 'invalid-mailbox')] class GroupList(TokenList): token_type = 'group-list' @property def mailboxes(self): if not self or self[0].token_type != 'mailbox-list': return [] return self[0].mailboxes @property def all_mailboxes(self): if not self or self[0].token_type != 'mailbox-list': return [] return self[0].all_mailboxes class Group(TokenList): token_type = "group" @property def mailboxes(self): if self[2].token_type != 'group-list': return [] return self[2].mailboxes @property def all_mailboxes(self): if self[2].token_type != 'group-list': return [] return self[2].all_mailboxes @property def display_name(self): return self[0].display_name class NameAddr(TokenList): token_type = 'name-addr' @property def display_name(self): if len(self) == 1: return None return self[0].display_name @property def local_part(self): return self[-1].local_part @property def domain(self): return self[-1].domain @property def route(self): return self[-1].route @property def addr_spec(self): return self[-1].addr_spec class AngleAddr(TokenList): token_type = 'angle-addr' @property def local_part(self): for x in self: if x.token_type == 'addr-spec': return x.local_part @property def domain(self): for x in self: if x.token_type == 'addr-spec': return x.domain @property def route(self): for x in self: if x.token_type == 'obs-route': return x.domains @property def addr_spec(self): for x in self: if x.token_type == 'addr-spec': if x.local_part: return x.addr_spec else: return quote_string(x.local_part) + x.addr_spec else: return '<>' class ObsRoute(TokenList): token_type = 'obs-route' @property def domains(self): return [x.domain for x in self if x.token_type == 'domain'] class Mailbox(TokenList): token_type = 'mailbox' @property def display_name(self): if self[0].token_type == 'name-addr': return self[0].display_name @property def local_part(self): return self[0].local_part @property def domain(self): return self[0].domain @property def route(self): if self[0].token_type == 'name-addr': return self[0].route @property def addr_spec(self): return self[0].addr_spec class InvalidMailbox(TokenList): token_type = 'invalid-mailbox' @property def display_name(self): return None local_part = domain = route = addr_spec = display_name class Domain(TokenList): token_type = 'domain' as_ew_allowed = False @property def domain(self): return ''.join(super().value.split()) class DotAtom(TokenList): token_type = 'dot-atom' class DotAtomText(TokenList): token_type = 'dot-atom-text' as_ew_allowed = True class NoFoldLiteral(TokenList): token_type = 'no-fold-literal' as_ew_allowed = False class AddrSpec(TokenList): token_type = 'addr-spec' as_ew_allowed = False @property def local_part(self): return self[0].local_part @property def domain(self): if len(self) < 3: return None return self[-1].domain @property def value(self): if len(self) < 3: return self[0].value return self[0].value.rstrip()+self[1].value+self[2].value.lstrip() @property def addr_spec(self): nameset = set(self.local_part) if len(nameset) > len(nameset-DOT_ATOM_ENDS): lp = quote_string(self.local_part) else: lp = self.local_part if self.domain is not None: return lp + '@' + self.domain return lp class ObsLocalPart(TokenList): token_type = 'obs-local-part' as_ew_allowed = False class DisplayName(Phrase): token_type = 'display-name' ew_combine_allowed = False @property def display_name(self): res = TokenList(self) if len(res) == 0: return res.value if res[0].token_type == 'cfws': res.pop(0) else: if res[0][0].token_type == 'cfws': res[0] = TokenList(res[0][1:]) if res[-1].token_type == 'cfws': res.pop() else: if res[-1][-1].token_type == 'cfws': res[-1] = TokenList(res[-1][:-1]) return res.value @property def value(self): quote = False if self.defects: quote = True else: for x in self: if x.token_type == 'quoted-string': quote = True if len(self) != 0 and quote: pre = post = '' if self[0].token_type=='cfws' or self[0][0].token_type=='cfws': pre = ' ' if self[-1].token_type=='cfws' or self[-1][-1].token_type=='cfws': post = ' ' return pre+quote_string(self.display_name)+post else: return super().value class LocalPart(TokenList): token_type = 'local-part' as_ew_allowed = False @property def value(self): if self[0].token_type == "quoted-string": return self[0].quoted_value else: return self[0].value @property def local_part(self): # Strip whitespace from front, back, and around dots. res = [DOT] last = DOT last_is_tl = False for tok in self[0] + [DOT]: if tok.token_type == 'cfws': continue if (last_is_tl and tok.token_type == 'dot' and last[-1].token_type == 'cfws'): res[-1] = TokenList(last[:-1]) is_tl = isinstance(tok, TokenList) if (is_tl and last.token_type == 'dot' and tok[0].token_type == 'cfws'): res.append(TokenList(tok[1:])) else: res.append(tok) last = res[-1] last_is_tl = is_tl res = TokenList(res[1:-1]) return res.value class DomainLiteral(TokenList): token_type = 'domain-literal' as_ew_allowed = False @property def domain(self): return ''.join(super().value.split()) @property def ip(self): for x in self: if x.token_type == 'ptext': return x.value class MIMEVersion(TokenList): token_type = 'mime-version' major = None minor = None class Parameter(TokenList): token_type = 'parameter' sectioned = False extended = False charset = 'us-ascii' @property def section_number(self): # Because the first token, the attribute (name) eats CFWS, the second # token is always the section if there is one. return self[1].number if self.sectioned else 0 @property def param_value(self): # This is part of the "handle quoted extended parameters" hack. for token in self: if token.token_type == 'value': return token.stripped_value if token.token_type == 'quoted-string': for token in token: if token.token_type == 'bare-quoted-string': for token in token: if token.token_type == 'value': return token.stripped_value return '' class InvalidParameter(Parameter): token_type = 'invalid-parameter' class Attribute(TokenList): token_type = 'attribute' @property def stripped_value(self): for token in self: if token.token_type.endswith('attrtext'): return token.value class Section(TokenList): token_type = 'section' number = None class Value(TokenList): token_type = 'value' @property def stripped_value(self): token = self[0] if token.token_type == 'cfws': token = self[1] if token.token_type.endswith( ('quoted-string', 'attribute', 'extended-attribute')): return token.stripped_value return self.value class MimeParameters(TokenList): token_type = 'mime-parameters' syntactic_break = False @property def params(self): # The RFC specifically states that the ordering of parameters is not # guaranteed and may be reordered by the transport layer. So we have # to assume the RFC 2231 pieces can come in any order. However, we # output them in the order that we first see a given name, which gives # us a stable __str__. params = {} # Using order preserving dict from Python 3.7+ for token in self: if not token.token_type.endswith('parameter'): continue if token[0].token_type != 'attribute': continue name = token[0].value.strip() if name not in params: params[name] = [] params[name].append((token.section_number, token)) for name, parts in params.items(): parts = sorted(parts, key=itemgetter(0)) first_param = parts[0][1] charset = first_param.charset # Our arbitrary error recovery is to ignore duplicate parameters, # to use appearance order if there are duplicate rfc 2231 parts, # and to ignore gaps. This mimics the error recovery of get_param. if not first_param.extended and len(parts) > 1: if parts[1][0] == 0: parts[1][1].defects.append(errors.InvalidHeaderDefect( 'duplicate parameter name; duplicate(s) ignored')) parts = parts[:1] # Else assume the *0* was missing...note that this is different # from get_param, but we registered a defect for this earlier. value_parts = [] i = 0 for section_number, param in parts: if section_number != i: # We could get fancier here and look for a complete # duplicate extended parameter and ignore the second one # seen. But we're not doing that. The old code didn't. if not param.extended: param.defects.append(errors.InvalidHeaderDefect( 'duplicate parameter name; duplicate ignored')) continue else: param.defects.append(errors.InvalidHeaderDefect( "inconsistent RFC2231 parameter numbering")) i += 1 value = param.param_value if param.extended: try: value = urllib.parse.unquote_to_bytes(value) except UnicodeEncodeError: # source had surrogate escaped bytes. What we do now # is a bit of an open question. I'm not sure this is # the best choice, but it is what the old algorithm did value = urllib.parse.unquote(value, encoding='latin-1') else: try: value = value.decode(charset, 'surrogateescape') except LookupError: # XXX: there should really be a custom defect for # unknown character set to make it easy to find, # because otherwise unknown charset is a silent # failure. value = value.decode('us-ascii', 'surrogateescape') if utils._has_surrogates(value): param.defects.append(errors.UndecodableBytesDefect()) value_parts.append(value) value = ''.join(value_parts) yield name, value def __str__(self): params = [] for name, value in self.params: if value: params.append('{}={}'.format(name, quote_string(value))) else: params.append(name) params = '; '.join(params) return ' ' + params if params else '' class ParameterizedHeaderValue(TokenList): # Set this false so that the value doesn't wind up on a new line even # if it and the parameters would fit there but not on the first line. syntactic_break = False @property def params(self): for token in reversed(self): if token.token_type == 'mime-parameters': return token.params return {} class ContentType(ParameterizedHeaderValue): token_type = 'content-type' as_ew_allowed = False maintype = 'text' subtype = 'plain' class ContentDisposition(ParameterizedHeaderValue): token_type = 'content-disposition' as_ew_allowed = False content_disposition = None class ContentTransferEncoding(TokenList): token_type = 'content-transfer-encoding' as_ew_allowed = False cte = '7bit' class HeaderLabel(TokenList): token_type = 'header-label' as_ew_allowed = False class MsgID(TokenList): token_type = 'msg-id' as_ew_allowed = False def fold(self, policy): # message-id tokens may not be folded. return str(self) + policy.linesep class MessageID(MsgID): token_type = 'message-id' class InvalidMessageID(MessageID): token_type = 'invalid-message-id' class Header(TokenList): token_type = 'header' # # Terminal classes and instances # class Terminal(str): as_ew_allowed = True ew_combine_allowed = True syntactic_break = True def __new__(cls, value, token_type): self = super().__new__(cls, value) self.token_type = token_type self.defects = [] return self def __repr__(self): return "{}({})".format(self.__class__.__name__, super().__repr__()) def pprint(self): print(self.__class__.__name__ + '/' + self.token_type) @property def all_defects(self): return list(self.defects) def _pp(self, indent=''): return ["{}{}/{}({}){}".format( indent, self.__class__.__name__, self.token_type, super().__repr__(), '' if not self.defects else ' {}'.format(self.defects), )] def pop_trailing_ws(self): # This terminates the recursion. return None @property def comments(self): return [] def __getnewargs__(self): return(str(self), self.token_type) class WhiteSpaceTerminal(Terminal): @property def value(self): return ' ' def startswith_fws(self): return True class ValueTerminal(Terminal): @property def value(self): return self def startswith_fws(self): return False class EWWhiteSpaceTerminal(WhiteSpaceTerminal): @property def value(self): return '' def __str__(self): return '' class _InvalidEwError(errors.HeaderParseError): """Invalid encoded word found while parsing headers.""" # XXX these need to become classes and used as instances so # that a program can't change them in a parse tree and screw # up other parse trees. Maybe should have tests for that, too. DOT = ValueTerminal('.', 'dot') ListSeparator = ValueTerminal(',', 'list-separator') RouteComponentMarker = ValueTerminal('@', 'route-component-marker') # # Parser # # Parse strings according to RFC822/2047/2822/5322 rules. # # This is a stateless parser. Each get_XXX function accepts a string and # returns either a Terminal or a TokenList representing the RFC object named # by the method and a string containing the remaining unparsed characters # from the input. Thus a parser method consumes the next syntactic construct # of a given type and returns a token representing the construct plus the # unparsed remainder of the input string. # # For example, if the first element of a structured header is a 'phrase', # then: # # phrase, value = get_phrase(value) # # returns the complete phrase from the start of the string value, plus any # characters left in the string after the phrase is removed. _wsp_splitter = re.compile(r'([{}]+)'.format(''.join(WSP))).split _non_atom_end_matcher = re.compile(r"[^{}]+".format( re.escape(''.join(ATOM_ENDS)))).match _non_printable_finder = re.compile(r"[\x00-\x20\x7F]").findall _non_token_end_matcher = re.compile(r"[^{}]+".format( re.escape(''.join(TOKEN_ENDS)))).match _non_attribute_end_matcher = re.compile(r"[^{}]+".format( re.escape(''.join(ATTRIBUTE_ENDS)))).match _non_extended_attribute_end_matcher = re.compile(r"[^{}]+".format( re.escape(''.join(EXTENDED_ATTRIBUTE_ENDS)))).match def _validate_xtext(xtext): """If input token contains ASCII non-printables, register a defect.""" non_printables = _non_printable_finder(xtext) if non_printables: xtext.defects.append(errors.NonPrintableDefect(non_printables)) if utils._has_surrogates(xtext): xtext.defects.append(errors.UndecodableBytesDefect( "Non-ASCII characters found in header token")) def _get_ptext_to_endchars(value, endchars): """Scan printables/quoted-pairs until endchars and return unquoted ptext. This function turns a run of qcontent, ccontent-without-comments, or dtext-with-quoted-printables into a single string by unquoting any quoted printables. It returns the string, the remaining value, and a flag that is True iff there were any quoted printables decoded. """ fragment, *remainder = _wsp_splitter(value, 1) vchars = [] escape = False had_qp = False for pos in range(len(fragment)): if fragment[pos] == '\\': if escape: escape = False had_qp = True else: escape = True continue if escape: escape = False elif fragment[pos] in endchars: break vchars.append(fragment[pos]) else: pos = pos + 1 return ''.join(vchars), ''.join([fragment[pos:]] + remainder), had_qp def get_fws(value): """FWS = 1*WSP This isn't the RFC definition. We're using fws to represent tokens where folding can be done, but when we are parsing the *un*folding has already been done so we don't need to watch out for CRLF. """ newvalue = value.lstrip() fws = WhiteSpaceTerminal(value[:len(value)-len(newvalue)], 'fws') return fws, newvalue def get_encoded_word(value): """ encoded-word = "=?" charset "?" encoding "?" encoded-text "?=" """ ew = EncodedWord() if not value.startswith('=?'): raise errors.HeaderParseError( "expected encoded word but found {}".format(value)) tok, *remainder = value[2:].split('?=', 1) if tok == value[2:]: raise errors.HeaderParseError( "expected encoded word but found {}".format(value)) remstr = ''.join(remainder) if (len(remstr) > 1 and remstr[0] in hexdigits and remstr[1] in hexdigits and tok.count('?') < 2): # The ? after the CTE was followed by an encoded word escape (=XX). rest, *remainder = remstr.split('?=', 1) tok = tok + '?=' + rest if len(tok.split()) > 1: ew.defects.append(errors.InvalidHeaderDefect( "whitespace inside encoded word")) ew.cte = value value = ''.join(remainder) try: text, charset, lang, defects = _ew.decode('=?' + tok + '?=') except (ValueError, KeyError): raise _InvalidEwError( "encoded word format invalid: '{}'".format(ew.cte)) ew.charset = charset ew.lang = lang ew.defects.extend(defects) while text: if text[0] in WSP: token, text = get_fws(text) ew.append(token) continue chars, *remainder = _wsp_splitter(text, 1) vtext = ValueTerminal(chars, 'vtext') _validate_xtext(vtext) ew.append(vtext) text = ''.join(remainder) # Encoded words should be followed by a WS if value and value[0] not in WSP: ew.defects.append(errors.InvalidHeaderDefect( "missing trailing whitespace after encoded-word")) return ew, value def get_unstructured(value): """unstructured = (*([FWS] vchar) *WSP) / obs-unstruct obs-unstruct = *((*LF *CR *(obs-utext) *LF *CR)) / FWS) obs-utext = %d0 / obs-NO-WS-CTL / LF / CR obs-NO-WS-CTL is control characters except WSP/CR/LF. So, basically, we have printable runs, plus control characters or nulls in the obsolete syntax, separated by whitespace. Since RFC 2047 uses the obsolete syntax in its specification, but requires whitespace on either side of the encoded words, I can see no reason to need to separate the non-printable-non-whitespace from the printable runs if they occur, so we parse this into xtext tokens separated by WSP tokens. Because an 'unstructured' value must by definition constitute the entire value, this 'get' routine does not return a remaining value, only the parsed TokenList. """ # XXX: but what about bare CR and LF? They might signal the start or # end of an encoded word. YAGNI for now, since our current parsers # will never send us strings with bare CR or LF. unstructured = UnstructuredTokenList() while value: if value[0] in WSP: token, value = get_fws(value) unstructured.append(token) continue valid_ew = True if value.startswith('=?'): try: token, value = get_encoded_word(value) except _InvalidEwError: valid_ew = False except errors.HeaderParseError: # XXX: Need to figure out how to register defects when # appropriate here. pass else: have_ws = True if len(unstructured) > 0: if unstructured[-1].token_type != 'fws': unstructured.defects.append(errors.InvalidHeaderDefect( "missing whitespace before encoded word")) have_ws = False if have_ws and len(unstructured) > 1: if unstructured[-2].token_type == 'encoded-word': unstructured[-1] = EWWhiteSpaceTerminal( unstructured[-1], 'fws') unstructured.append(token) continue tok, *remainder = _wsp_splitter(value, 1) # Split in the middle of an atom if there is a rfc2047 encoded word # which does not have WSP on both sides. The defect will be registered # the next time through the loop. # This needs to only be performed when the encoded word is valid; # otherwise, performing it on an invalid encoded word can cause # the parser to go in an infinite loop. if valid_ew and rfc2047_matcher.search(tok): tok, *remainder = value.partition('=?') vtext = ValueTerminal(tok, 'vtext') _validate_xtext(vtext) unstructured.append(vtext) value = ''.join(remainder) return unstructured def get_qp_ctext(value): r"""ctext = <printable ascii except \ ( )> This is not the RFC ctext, since we are handling nested comments in comment and unquoting quoted-pairs here. We allow anything except the '()' characters, but if we find any ASCII other than the RFC defined printable ASCII, a NonPrintableDefect is added to the token's defects list. Since quoted pairs are converted to their unquoted values, what is returned is a 'ptext' token. In this case it is a WhiteSpaceTerminal, so it's value is ' '. """ ptext, value, _ = _get_ptext_to_endchars(value, '()') ptext = WhiteSpaceTerminal(ptext, 'ptext') _validate_xtext(ptext) return ptext, value def get_qcontent(value): """qcontent = qtext / quoted-pair We allow anything except the DQUOTE character, but if we find any ASCII other than the RFC defined printable ASCII, a NonPrintableDefect is added to the token's defects list. Any quoted pairs are converted to their unquoted values, so what is returned is a 'ptext' token. In this case it is a ValueTerminal. """ ptext, value, _ = _get_ptext_to_endchars(value, '"') ptext = ValueTerminal(ptext, 'ptext') _validate_xtext(ptext) return ptext, value def get_atext(value): """atext = <matches _atext_matcher> We allow any non-ATOM_ENDS in atext, but add an InvalidATextDefect to the token's defects list if we find non-atext characters. """ m = _non_atom_end_matcher(value) if not m: raise errors.HeaderParseError( "expected atext but found '{}'".format(value)) atext = m.group() value = value[len(atext):] atext = ValueTerminal(atext, 'atext') _validate_xtext(atext) return atext, value def get_bare_quoted_string(value): """bare-quoted-string = DQUOTE *([FWS] qcontent) [FWS] DQUOTE A quoted-string without the leading or trailing white space. Its value is the text between the quote marks, with whitespace preserved and quoted pairs decoded. """ if value[0] != '"': raise errors.HeaderParseError( "expected '\"' but found '{}'".format(value)) bare_quoted_string = BareQuotedString() value = value[1:] if value and value[0] == '"': token, value = get_qcontent(value) bare_quoted_string.append(token) while value and value[0] != '"': if value[0] in WSP: token, value = get_fws(value) elif value[:2] == '=?': valid_ew = False try: token, value = get_encoded_word(value) bare_quoted_string.defects.append(errors.InvalidHeaderDefect( "encoded word inside quoted string")) valid_ew = True except errors.HeaderParseError: token, value = get_qcontent(value) # Collapse the whitespace between two encoded words that occur in a # bare-quoted-string. if valid_ew and len(bare_quoted_string) > 1: if (bare_quoted_string[-1].token_type == 'fws' and bare_quoted_string[-2].token_type == 'encoded-word'): bare_quoted_string[-1] = EWWhiteSpaceTerminal( bare_quoted_string[-1], 'fws') else: token, value = get_qcontent(value) bare_quoted_string.append(token) if not value: bare_quoted_string.defects.append(errors.InvalidHeaderDefect( "end of header inside quoted string")) return bare_quoted_string, value return bare_quoted_string, value[1:] def get_comment(value): """comment = "(" *([FWS] ccontent) [FWS] ")" ccontent = ctext / quoted-pair / comment We handle nested comments here, and quoted-pair in our qp-ctext routine. """ if value and value[0] != '(': raise errors.HeaderParseError( "expected '(' but found '{}'".format(value)) comment = Comment() value = value[1:] while value and value[0] != ")": if value[0] in WSP: token, value = get_fws(value) elif value[0] == '(': token, value = get_comment(value) else: token, value = get_qp_ctext(value) comment.append(token) if not value: comment.defects.append(errors.InvalidHeaderDefect( "end of header inside comment")) return comment, value return comment, value[1:] def get_cfws(value): """CFWS = (1*([FWS] comment) [FWS]) / FWS """ cfws = CFWSList() while value and value[0] in CFWS_LEADER: if value[0] in WSP: token, value = get_fws(value) else: token, value = get_comment(value) cfws.append(token) return cfws, value def get_quoted_string(value): """quoted-string = [CFWS] <bare-quoted-string> [CFWS] 'bare-quoted-string' is an intermediate class defined by this parser and not by the RFC grammar. It is the quoted string without any attached CFWS. """ quoted_string = QuotedString() if value and value[0] in CFWS_LEADER: token, value = get_cfws(value) quoted_string.append(token) token, value = get_bare_quoted_string(value) quoted_string.append(token) if value and value[0] in CFWS_LEADER: token, value = get_cfws(value) quoted_string.append(token) return quoted_string, value def get_atom(value): """atom = [CFWS] 1*atext [CFWS] An atom could be an rfc2047 encoded word. """ atom = Atom() if value and value[0] in CFWS_LEADER: token, value = get_cfws(value) atom.append(token) if value and value[0] in ATOM_ENDS: raise errors.HeaderParseError( "expected atom but found '{}'".format(value)) if value.startswith('=?'): try: token, value = get_encoded_word(value) except errors.HeaderParseError: # XXX: need to figure out how to register defects when # appropriate here. token, value = get_atext(value) else: token, value = get_atext(value) atom.append(token) if value and value[0] in CFWS_LEADER: token, value = get_cfws(value) atom.append(token) return atom, value def get_dot_atom_text(value): """ dot-text = 1*atext *("." 1*atext) """ dot_atom_text = DotAtomText() if not value or value[0] in ATOM_ENDS: raise errors.HeaderParseError("expected atom at a start of " "dot-atom-text but found '{}'".format(value)) while value and value[0] not in ATOM_ENDS: token, value = get_atext(value) dot_atom_text.append(token) if value and value[0] == '.': dot_atom_text.append(DOT) value = value[1:] if dot_atom_text[-1] is DOT: raise errors.HeaderParseError("expected atom at end of dot-atom-text " "but found '{}'".format('.'+value)) return dot_atom_text, value def get_dot_atom(value): """ dot-atom = [CFWS] dot-atom-text [CFWS] Any place we can have a dot atom, we could instead have an rfc2047 encoded word. """ dot_atom = DotAtom() if value[0] in CFWS_LEADER: token, value = get_cfws(value) dot_atom.append(token) if value.startswith('=?'): try: token, value = get_encoded_word(value) except errors.HeaderParseError: # XXX: need to figure out how to register defects when # appropriate here. token, value = get_dot_atom_text(value) else: token, value = get_dot_atom_text(value) dot_atom.append(token) if value and value[0] in CFWS_LEADER: token, value = get_cfws(value) dot_atom.append(token) return dot_atom, value def get_word(value): """word = atom / quoted-string Either atom or quoted-string may start with CFWS. We have to peel off this CFWS first to determine which type of word to parse. Afterward we splice the leading CFWS, if any, into the parsed sub-token. If neither an atom or a quoted-string is found before the next special, a HeaderParseError is raised. The token returned is either an Atom or a QuotedString, as appropriate. This means the 'word' level of the formal grammar is not represented in the parse tree; this is because having that extra layer when manipulating the parse tree is more confusing than it is helpful. """ if value[0] in CFWS_LEADER: leader, value = get_cfws(value) else: leader = None if not value: raise errors.HeaderParseError( "Expected 'atom' or 'quoted-string' but found nothing.") if value[0]=='"': token, value = get_quoted_string(value) elif value[0] in SPECIALS: raise errors.HeaderParseError("Expected 'atom' or 'quoted-string' " "but found '{}'".format(value)) else: token, value = get_atom(value) if leader is not None: token[:0] = [leader] return token, value def get_phrase(value): """ phrase = 1*word / obs-phrase obs-phrase = word *(word / "." / CFWS) This means a phrase can be a sequence of words, periods, and CFWS in any order as long as it starts with at least one word. If anything other than words is detected, an ObsoleteHeaderDefect is added to the token's defect list. We also accept a phrase that starts with CFWS followed by a dot; this is registered as an InvalidHeaderDefect, since it is not supported by even the obsolete grammar. """ phrase = Phrase() try: token, value = get_word(value) phrase.append(token) except errors.HeaderParseError: phrase.defects.append(errors.InvalidHeaderDefect( "phrase does not start with word")) while value and value[0] not in PHRASE_ENDS: if value[0]=='.': phrase.append(DOT) phrase.defects.append(errors.ObsoleteHeaderDefect( "period in 'phrase'")) value = value[1:] else: try: token, value = get_word(value) except errors.HeaderParseError: if value[0] in CFWS_LEADER: token, value = get_cfws(value) phrase.defects.append(errors.ObsoleteHeaderDefect( "comment found without atom")) else: raise phrase.append(token) return phrase, value def get_local_part(value): """ local-part = dot-atom / quoted-string / obs-local-part """ local_part = LocalPart() leader = None if value[0] in CFWS_LEADER: leader, value = get_cfws(value) if not value: raise errors.HeaderParseError( "expected local-part but found '{}'".format(value)) try: token, value = get_dot_atom(value) except errors.HeaderParseError: try: token, value = get_word(value) except errors.HeaderParseError: if value[0] != '\\' and value[0] in PHRASE_ENDS: raise token = TokenList() if leader is not None: token[:0] = [leader] local_part.append(token) if value and (value[0]=='\\' or value[0] not in PHRASE_ENDS): obs_local_part, value = get_obs_local_part(str(local_part) + value) if obs_local_part.token_type == 'invalid-obs-local-part': local_part.defects.append(errors.InvalidHeaderDefect( "local-part is not dot-atom, quoted-string, or obs-local-part")) else: local_part.defects.append(errors.ObsoleteHeaderDefect( "local-part is not a dot-atom (contains CFWS)")) local_part[0] = obs_local_part try: local_part.value.encode('ascii') except UnicodeEncodeError: local_part.defects.append(errors.NonASCIILocalPartDefect( "local-part contains non-ASCII characters)")) return local_part, value def get_obs_local_part(value): """ obs-local-part = word *("." word) """ obs_local_part = ObsLocalPart() last_non_ws_was_dot = False while value and (value[0]=='\\' or value[0] not in PHRASE_ENDS): if value[0] == '.': if last_non_ws_was_dot: obs_local_part.defects.append(errors.InvalidHeaderDefect( "invalid repeated '.'")) obs_local_part.append(DOT) last_non_ws_was_dot = True value = value[1:] continue elif value[0]=='\\': obs_local_part.append(ValueTerminal(value[0], 'misplaced-special')) value = value[1:] obs_local_part.defects.append(errors.InvalidHeaderDefect( "'\\' character outside of quoted-string/ccontent")) last_non_ws_was_dot = False continue if obs_local_part and obs_local_part[-1].token_type != 'dot': obs_local_part.defects.append(errors.InvalidHeaderDefect( "missing '.' between words")) try: token, value = get_word(value) last_non_ws_was_dot = False except errors.HeaderParseError: if value[0] not in CFWS_LEADER: raise token, value = get_cfws(value) obs_local_part.append(token) if (obs_local_part[0].token_type == 'dot' or obs_local_part[0].token_type=='cfws' and obs_local_part[1].token_type=='dot'): obs_local_part.defects.append(errors.InvalidHeaderDefect( "Invalid leading '.' in local part")) if (obs_local_part[-1].token_type == 'dot' or obs_local_part[-1].token_type=='cfws' and obs_local_part[-2].token_type=='dot'): obs_local_part.defects.append(errors.InvalidHeaderDefect( "Invalid trailing '.' in local part")) if obs_local_part.defects: obs_local_part.token_type = 'invalid-obs-local-part' return obs_local_part, value def get_dtext(value): r""" dtext = <printable ascii except \ [ ]> / obs-dtext obs-dtext = obs-NO-WS-CTL / quoted-pair We allow anything except the excluded characters, but if we find any ASCII other than the RFC defined printable ASCII, a NonPrintableDefect is added to the token's defects list. Quoted pairs are converted to their unquoted values, so what is returned is a ptext token, in this case a ValueTerminal. If there were quoted-printables, an ObsoleteHeaderDefect is added to the returned token's defect list. """ ptext, value, had_qp = _get_ptext_to_endchars(value, '[]') ptext = ValueTerminal(ptext, 'ptext') if had_qp: ptext.defects.append(errors.ObsoleteHeaderDefect( "quoted printable found in domain-literal")) _validate_xtext(ptext) return ptext, value def _check_for_early_dl_end(value, domain_literal): if value: return False domain_literal.append(errors.InvalidHeaderDefect( "end of input inside domain-literal")) domain_literal.append(ValueTerminal(']', 'domain-literal-end')) return True def get_domain_literal(value): """ domain-literal = [CFWS] "[" *([FWS] dtext) [FWS] "]" [CFWS] """ domain_literal = DomainLiteral() if value[0] in CFWS_LEADER: token, value = get_cfws(value) domain_literal.append(token) if not value: raise errors.HeaderParseError("expected domain-literal") if value[0] != '[': raise errors.HeaderParseError("expected '[' at start of domain-literal " "but found '{}'".format(value)) value = value[1:] if _check_for_early_dl_end(value, domain_literal): return domain_literal, value domain_literal.append(ValueTerminal('[', 'domain-literal-start')) if value[0] in WSP: token, value = get_fws(value) domain_literal.append(token) token, value = get_dtext(value) domain_literal.append(token) if _check_for_early_dl_end(value, domain_literal): return domain_literal, value if value[0] in WSP: token, value = get_fws(value) domain_literal.append(token) if _check_for_early_dl_end(value, domain_literal): return domain_literal, value if value[0] != ']': raise errors.HeaderParseError("expected ']' at end of domain-literal " "but found '{}'".format(value)) domain_literal.append(ValueTerminal(']', 'domain-literal-end')) value = value[1:] if value and value[0] in CFWS_LEADER: token, value = get_cfws(value) domain_literal.append(token) return domain_literal, value def get_domain(value): """ domain = dot-atom / domain-literal / obs-domain obs-domain = atom *("." atom)) """ domain = Domain() leader = None if value[0] in CFWS_LEADER: leader, value = get_cfws(value) if not value: raise errors.HeaderParseError( "expected domain but found '{}'".format(value)) if value[0] == '[': token, value = get_domain_literal(value) if leader is not None: token[:0] = [leader] domain.append(token) return domain, value try: token, value = get_dot_atom(value) except errors.HeaderParseError: token, value = get_atom(value) if value and value[0] == '@': raise errors.HeaderParseError('Invalid Domain') if leader is not None: token[:0] = [leader] domain.append(token) if value and value[0] == '.': domain.defects.append(errors.ObsoleteHeaderDefect( "domain is not a dot-atom (contains CFWS)")) if domain[0].token_type == 'dot-atom': domain[:] = domain[0] while value and value[0] == '.': domain.append(DOT) token, value = get_atom(value[1:]) domain.append(token) return domain, value def get_addr_spec(value): """ addr-spec = local-part "@" domain """ addr_spec = AddrSpec() token, value = get_local_part(value) addr_spec.append(token) if not value or value[0] != '@': addr_spec.defects.append(errors.InvalidHeaderDefect( "addr-spec local part with no domain")) return addr_spec, value addr_spec.append(ValueTerminal('@', 'address-at-symbol')) token, value = get_domain(value[1:]) addr_spec.append(token) return addr_spec, value def get_obs_route(value): """ obs-route = obs-domain-list ":" obs-domain-list = *(CFWS / ",") "@" domain *("," [CFWS] ["@" domain]) Returns an obs-route token with the appropriate sub-tokens (that is, there is no obs-domain-list in the parse tree). """ obs_route = ObsRoute() while value and (value[0]==',' or value[0] in CFWS_LEADER): if value[0] in CFWS_LEADER: token, value = get_cfws(value) obs_route.append(token) elif value[0] == ',': obs_route.append(ListSeparator) value = value[1:] if not value or value[0] != '@': raise errors.HeaderParseError( "expected obs-route domain but found '{}'".format(value)) obs_route.append(RouteComponentMarker) token, value = get_domain(value[1:]) obs_route.append(token) while value and value[0]==',': obs_route.append(ListSeparator) value = value[1:] if not value: break if value[0] in CFWS_LEADER: token, value = get_cfws(value) obs_route.append(token) if value[0] == '@': obs_route.append(RouteComponentMarker) token, value = get_domain(value[1:]) obs_route.append(token) if not value: raise errors.HeaderParseError("end of header while parsing obs-route") if value[0] != ':': raise errors.HeaderParseError( "expected ':' marking end of " "obs-route but found '{}'".format(value)) obs_route.append(ValueTerminal(':', 'end-of-obs-route-marker')) return obs_route, value[1:] def get_angle_addr(value): """ angle-addr = [CFWS] "<" addr-spec ">" [CFWS] / obs-angle-addr obs-angle-addr = [CFWS] "<" obs-route addr-spec ">" [CFWS] """ angle_addr = AngleAddr() if value[0] in CFWS_LEADER: token, value = get_cfws(value) angle_addr.append(token) if not value or value[0] != '<': raise errors.HeaderParseError( "expected angle-addr but found '{}'".format(value)) angle_addr.append(ValueTerminal('<', 'angle-addr-start')) value = value[1:] # Although it is not legal per RFC5322, SMTP uses '<>' in certain # circumstances. if value[0] == '>': angle_addr.append(ValueTerminal('>', 'angle-addr-end')) angle_addr.defects.append(errors.InvalidHeaderDefect( "null addr-spec in angle-addr")) value = value[1:] return angle_addr, value try: token, value = get_addr_spec(value) except errors.HeaderParseError: try: token, value = get_obs_route(value) angle_addr.defects.append(errors.ObsoleteHeaderDefect( "obsolete route specification in angle-addr")) except errors.HeaderParseError: raise errors.HeaderParseError( "expected addr-spec or obs-route but found '{}'".format(value)) angle_addr.append(token) token, value = get_addr_spec(value) angle_addr.append(token) if value and value[0] == '>': value = value[1:] else: angle_addr.defects.append(errors.InvalidHeaderDefect( "missing trailing '>' on angle-addr")) angle_addr.append(ValueTerminal('>', 'angle-addr-end')) if value and value[0] in CFWS_LEADER: token, value = get_cfws(value) angle_addr.append(token) return angle_addr, value def get_display_name(value): """ display-name = phrase Because this is simply a name-rule, we don't return a display-name token containing a phrase, but rather a display-name token with the content of the phrase. """ display_name = DisplayName() token, value = get_phrase(value) display_name.extend(token[:]) display_name.defects = token.defects[:] return display_name, value def get_name_addr(value): """ name-addr = [display-name] angle-addr """ name_addr = NameAddr() # Both the optional display name and the angle-addr can start with cfws. leader = None if value[0] in CFWS_LEADER: leader, value = get_cfws(value) if not value: raise errors.HeaderParseError( "expected name-addr but found '{}'".format(leader)) if value[0] != '<': if value[0] in PHRASE_ENDS: raise errors.HeaderParseError( "expected name-addr but found '{}'".format(value)) token, value = get_display_name(value) if not value: raise errors.HeaderParseError( "expected name-addr but found '{}'".format(token)) if leader is not None: token[0][:0] = [leader] leader = None name_addr.append(token) token, value = get_angle_addr(value) if leader is not None: token[:0] = [leader] name_addr.append(token) return name_addr, value def get_mailbox(value): """ mailbox = name-addr / addr-spec """ # The only way to figure out if we are dealing with a name-addr or an # addr-spec is to try parsing each one. mailbox = Mailbox() try: token, value = get_name_addr(value) except errors.HeaderParseError: try: token, value = get_addr_spec(value) except errors.HeaderParseError: raise errors.HeaderParseError( "expected mailbox but found '{}'".format(value)) if any(isinstance(x, errors.InvalidHeaderDefect) for x in token.all_defects): mailbox.token_type = 'invalid-mailbox' mailbox.append(token) return mailbox, value def get_invalid_mailbox(value, endchars): """ Read everything up to one of the chars in endchars. This is outside the formal grammar. The InvalidMailbox TokenList that is returned acts like a Mailbox, but the data attributes are None. """ invalid_mailbox = InvalidMailbox() while value and value[0] not in endchars: if value[0] in PHRASE_ENDS: invalid_mailbox.append(ValueTerminal(value[0], 'misplaced-special')) value = value[1:] else: token, value = get_phrase(value) invalid_mailbox.append(token) return invalid_mailbox, value def get_mailbox_list(value): """ mailbox-list = (mailbox *("," mailbox)) / obs-mbox-list obs-mbox-list = *([CFWS] ",") mailbox *("," [mailbox / CFWS]) For this routine we go outside the formal grammar in order to improve error handling. We recognize the end of the mailbox list only at the end of the value or at a ';' (the group terminator). This is so that we can turn invalid mailboxes into InvalidMailbox tokens and continue parsing any remaining valid mailboxes. We also allow all mailbox entries to be null, and this condition is handled appropriately at a higher level. """ mailbox_list = MailboxList() while value and value[0] != ';': try: token, value = get_mailbox(value) mailbox_list.append(token) except errors.HeaderParseError: leader = None if value[0] in CFWS_LEADER: leader, value = get_cfws(value) if not value or value[0] in ',;': mailbox_list.append(leader) mailbox_list.defects.append(errors.ObsoleteHeaderDefect( "empty element in mailbox-list")) else: token, value = get_invalid_mailbox(value, ',;') if leader is not None: token[:0] = [leader] mailbox_list.append(token) mailbox_list.defects.append(errors.InvalidHeaderDefect( "invalid mailbox in mailbox-list")) elif value[0] == ',': mailbox_list.defects.append(errors.ObsoleteHeaderDefect( "empty element in mailbox-list")) else: token, value = get_invalid_mailbox(value, ',;') if leader is not None: token[:0] = [leader] mailbox_list.append(token) mailbox_list.defects.append(errors.InvalidHeaderDefect( "invalid mailbox in mailbox-list")) if value and value[0] not in ',;': # Crap after mailbox; treat it as an invalid mailbox. # The mailbox info will still be available. mailbox = mailbox_list[-1] mailbox.token_type = 'invalid-mailbox' token, value = get_invalid_mailbox(value, ',;') mailbox.extend(token) mailbox_list.defects.append(errors.InvalidHeaderDefect( "invalid mailbox in mailbox-list")) if value and value[0] == ',': mailbox_list.append(ListSeparator) value = value[1:] return mailbox_list, value def get_group_list(value): """ group-list = mailbox-list / CFWS / obs-group-list obs-group-list = 1*([CFWS] ",") [CFWS] """ group_list = GroupList() if not value: group_list.defects.append(errors.InvalidHeaderDefect( "end of header before group-list")) return group_list, value leader = None if value and value[0] in CFWS_LEADER: leader, value = get_cfws(value) if not value: # This should never happen in email parsing, since CFWS-only is a # legal alternative to group-list in a group, which is the only # place group-list appears. group_list.defects.append(errors.InvalidHeaderDefect( "end of header in group-list")) group_list.append(leader) return group_list, value if value[0] == ';': group_list.append(leader) return group_list, value token, value = get_mailbox_list(value) if len(token.all_mailboxes)==0: if leader is not None: group_list.append(leader) group_list.extend(token) group_list.defects.append(errors.ObsoleteHeaderDefect( "group-list with empty entries")) return group_list, value if leader is not None: token[:0] = [leader] group_list.append(token) return group_list, value def get_group(value): """ group = display-name ":" [group-list] ";" [CFWS] """ group = Group() token, value = get_display_name(value) if not value or value[0] != ':': raise errors.HeaderParseError("expected ':' at end of group " "display name but found '{}'".format(value)) group.append(token) group.append(ValueTerminal(':', 'group-display-name-terminator')) value = value[1:] if value and value[0] == ';': group.append(ValueTerminal(';', 'group-terminator')) return group, value[1:] token, value = get_group_list(value) group.append(token) if not value: group.defects.append(errors.InvalidHeaderDefect( "end of header in group")) elif value[0] != ';': raise errors.HeaderParseError( "expected ';' at end of group but found {}".format(value)) group.append(ValueTerminal(';', 'group-terminator')) value = value[1:] if value and value[0] in CFWS_LEADER: token, value = get_cfws(value) group.append(token) return group, value def get_address(value): """ address = mailbox / group Note that counter-intuitively, an address can be either a single address or a list of addresses (a group). This is why the returned Address object has a 'mailboxes' attribute which treats a single address as a list of length one. When you need to differentiate between to two cases, extract the single element, which is either a mailbox or a group token. """ # The formal grammar isn't very helpful when parsing an address. mailbox # and group, especially when allowing for obsolete forms, start off very # similarly. It is only when you reach one of @, <, or : that you know # what you've got. So, we try each one in turn, starting with the more # likely of the two. We could perhaps make this more efficient by looking # for a phrase and then branching based on the next character, but that # would be a premature optimization. address = Address() try: token, value = get_group(value) except errors.HeaderParseError: try: token, value = get_mailbox(value) except errors.HeaderParseError: raise errors.HeaderParseError( "expected address but found '{}'".format(value)) address.append(token) return address, value def get_address_list(value): """ address_list = (address *("," address)) / obs-addr-list obs-addr-list = *([CFWS] ",") address *("," [address / CFWS]) We depart from the formal grammar here by continuing to parse until the end of the input, assuming the input to be entirely composed of an address-list. This is always true in email parsing, and allows us to skip invalid addresses to parse additional valid ones. """ address_list = AddressList() while value: try: token, value = get_address(value) address_list.append(token) except errors.HeaderParseError as err: leader = None if value[0] in CFWS_LEADER: leader, value = get_cfws(value) if not value or value[0] == ',': address_list.append(leader) address_list.defects.append(errors.ObsoleteHeaderDefect( "address-list entry with no content")) else: token, value = get_invalid_mailbox(value, ',') if leader is not None: token[:0] = [leader] address_list.append(Address([token])) address_list.defects.append(errors.InvalidHeaderDefect( "invalid address in address-list")) elif value[0] == ',': address_list.defects.append(errors.ObsoleteHeaderDefect( "empty element in address-list")) else: token, value = get_invalid_mailbox(value, ',') if leader is not None: token[:0] = [leader] address_list.append(Address([token])) address_list.defects.append(errors.InvalidHeaderDefect( "invalid address in address-list")) if value and value[0] != ',': # Crap after address; treat it as an invalid mailbox. # The mailbox info will still be available. mailbox = address_list[-1][0] mailbox.token_type = 'invalid-mailbox' token, value = get_invalid_mailbox(value, ',') mailbox.extend(token) address_list.defects.append(errors.InvalidHeaderDefect( "invalid address in address-list")) if value: # Must be a , at this point. address_list.append(ValueTerminal(',', 'list-separator')) value = value[1:] return address_list, value def get_no_fold_literal(value): """ no-fold-literal = "[" *dtext "]" """ no_fold_literal = NoFoldLiteral() if not value: raise errors.HeaderParseError( "expected no-fold-literal but found '{}'".format(value)) if value[0] != '[': raise errors.HeaderParseError( "expected '[' at the start of no-fold-literal " "but found '{}'".format(value)) no_fold_literal.append(ValueTerminal('[', 'no-fold-literal-start')) value = value[1:] token, value = get_dtext(value) no_fold_literal.append(token) if not value or value[0] != ']': raise errors.HeaderParseError( "expected ']' at the end of no-fold-literal " "but found '{}'".format(value)) no_fold_literal.append(ValueTerminal(']', 'no-fold-literal-end')) return no_fold_literal, value[1:] def get_msg_id(value): """msg-id = [CFWS] "<" id-left '@' id-right ">" [CFWS] id-left = dot-atom-text / obs-id-left id-right = dot-atom-text / no-fold-literal / obs-id-right no-fold-literal = "[" *dtext "]" """ msg_id = MsgID() if value and value[0] in CFWS_LEADER: token, value = get_cfws(value) msg_id.append(token) if not value or value[0] != '<': raise errors.HeaderParseError( "expected msg-id but found '{}'".format(value)) msg_id.append(ValueTerminal('<', 'msg-id-start')) value = value[1:] # Parse id-left. try: token, value = get_dot_atom_text(value) except errors.HeaderParseError: try: # obs-id-left is same as local-part of add-spec. token, value = get_obs_local_part(value) msg_id.defects.append(errors.ObsoleteHeaderDefect( "obsolete id-left in msg-id")) except errors.HeaderParseError: raise errors.HeaderParseError( "expected dot-atom-text or obs-id-left" " but found '{}'".format(value)) msg_id.append(token) if not value or value[0] != '@': msg_id.defects.append(errors.InvalidHeaderDefect( "msg-id with no id-right")) # Even though there is no id-right, if the local part # ends with `>` let's just parse it too and return # along with the defect. if value and value[0] == '>': msg_id.append(ValueTerminal('>', 'msg-id-end')) value = value[1:] return msg_id, value msg_id.append(ValueTerminal('@', 'address-at-symbol')) value = value[1:] # Parse id-right. try: token, value = get_dot_atom_text(value) except errors.HeaderParseError: try: token, value = get_no_fold_literal(value) except errors.HeaderParseError as e: try: token, value = get_domain(value) msg_id.defects.append(errors.ObsoleteHeaderDefect( "obsolete id-right in msg-id")) except errors.HeaderParseError: raise errors.HeaderParseError( "expected dot-atom-text, no-fold-literal or obs-id-right" " but found '{}'".format(value)) msg_id.append(token) if value and value[0] == '>': value = value[1:] else: msg_id.defects.append(errors.InvalidHeaderDefect( "missing trailing '>' on msg-id")) msg_id.append(ValueTerminal('>', 'msg-id-end')) if value and value[0] in CFWS_LEADER: token, value = get_cfws(value) msg_id.append(token) return msg_id, value def parse_message_id(value): """message-id = "Message-ID:" msg-id CRLF """ message_id = MessageID() try: token, value = get_msg_id(value) message_id.append(token) except errors.HeaderParseError as ex: token = get_unstructured(value) message_id = InvalidMessageID(token) message_id.defects.append( errors.InvalidHeaderDefect("Invalid msg-id: {!r}".format(ex))) else: # Value after parsing a valid msg_id should be None. if value: message_id.defects.append(errors.InvalidHeaderDefect( "Unexpected {!r}".format(value))) return message_id # # XXX: As I begin to add additional header parsers, I'm realizing we probably # have two level of parser routines: the get_XXX methods that get a token in # the grammar, and parse_XXX methods that parse an entire field value. So # get_address_list above should really be a parse_ method, as probably should # be get_unstructured. # def parse_mime_version(value): """ mime-version = [CFWS] 1*digit [CFWS] "." [CFWS] 1*digit [CFWS] """ # The [CFWS] is implicit in the RFC 2045 BNF. # XXX: This routine is a bit verbose, should factor out a get_int method. mime_version = MIMEVersion() if not value: mime_version.defects.append(errors.HeaderMissingRequiredValue( "Missing MIME version number (eg: 1.0)")) return mime_version if value[0] in CFWS_LEADER: token, value = get_cfws(value) mime_version.append(token) if not value: mime_version.defects.append(errors.HeaderMissingRequiredValue( "Expected MIME version number but found only CFWS")) digits = '' while value and value[0] != '.' and value[0] not in CFWS_LEADER: digits += value[0] value = value[1:] if not digits.isdigit(): mime_version.defects.append(errors.InvalidHeaderDefect( "Expected MIME major version number but found {!r}".format(digits))) mime_version.append(ValueTerminal(digits, 'xtext')) else: mime_version.major = int(digits) mime_version.append(ValueTerminal(digits, 'digits')) if value and value[0] in CFWS_LEADER: token, value = get_cfws(value) mime_version.append(token) if not value or value[0] != '.': if mime_version.major is not None: mime_version.defects.append(errors.InvalidHeaderDefect( "Incomplete MIME version; found only major number")) if value: mime_version.append(ValueTerminal(value, 'xtext')) return mime_version mime_version.append(ValueTerminal('.', 'version-separator')) value = value[1:] if value and value[0] in CFWS_LEADER: token, value = get_cfws(value) mime_version.append(token) if not value: if mime_version.major is not None: mime_version.defects.append(errors.InvalidHeaderDefect( "Incomplete MIME version; found only major number")) return mime_version digits = '' while value and value[0] not in CFWS_LEADER: digits += value[0] value = value[1:] if not digits.isdigit(): mime_version.defects.append(errors.InvalidHeaderDefect( "Expected MIME minor version number but found {!r}".format(digits))) mime_version.append(ValueTerminal(digits, 'xtext')) else: mime_version.minor = int(digits) mime_version.append(ValueTerminal(digits, 'digits')) if value and value[0] in CFWS_LEADER: token, value = get_cfws(value) mime_version.append(token) if value: mime_version.defects.append(errors.InvalidHeaderDefect( "Excess non-CFWS text after MIME version")) mime_version.append(ValueTerminal(value, 'xtext')) return mime_version def get_invalid_parameter(value): """ Read everything up to the next ';'. This is outside the formal grammar. The InvalidParameter TokenList that is returned acts like a Parameter, but the data attributes are None. """ invalid_parameter = InvalidParameter() while value and value[0] != ';': if value[0] in PHRASE_ENDS: invalid_parameter.append(ValueTerminal(value[0], 'misplaced-special')) value = value[1:] else: token, value = get_phrase(value) invalid_parameter.append(token) return invalid_parameter, value def get_ttext(value): """ttext = <matches _ttext_matcher> We allow any non-TOKEN_ENDS in ttext, but add defects to the token's defects list if we find non-ttext characters. We also register defects for *any* non-printables even though the RFC doesn't exclude all of them, because we follow the spirit of RFC 5322. """ m = _non_token_end_matcher(value) if not m: raise errors.HeaderParseError( "expected ttext but found '{}'".format(value)) ttext = m.group() value = value[len(ttext):] ttext = ValueTerminal(ttext, 'ttext') _validate_xtext(ttext) return ttext, value def get_token(value): """token = [CFWS] 1*ttext [CFWS] The RFC equivalent of ttext is any US-ASCII chars except space, ctls, or tspecials. We also exclude tabs even though the RFC doesn't. The RFC implies the CFWS but is not explicit about it in the BNF. """ mtoken = Token() if value and value[0] in CFWS_LEADER: token, value = get_cfws(value) mtoken.append(token) if value and value[0] in TOKEN_ENDS: raise errors.HeaderParseError( "expected token but found '{}'".format(value)) token, value = get_ttext(value) mtoken.append(token) if value and value[0] in CFWS_LEADER: token, value = get_cfws(value) mtoken.append(token) return mtoken, value def get_attrtext(value): """attrtext = 1*(any non-ATTRIBUTE_ENDS character) We allow any non-ATTRIBUTE_ENDS in attrtext, but add defects to the token's defects list if we find non-attrtext characters. We also register defects for *any* non-printables even though the RFC doesn't exclude all of them, because we follow the spirit of RFC 5322. """ m = _non_attribute_end_matcher(value) if not m: raise errors.HeaderParseError( "expected attrtext but found {!r}".format(value)) attrtext = m.group() value = value[len(attrtext):] attrtext = ValueTerminal(attrtext, 'attrtext') _validate_xtext(attrtext) return attrtext, value def get_attribute(value): """ [CFWS] 1*attrtext [CFWS] This version of the BNF makes the CFWS explicit, and as usual we use a value terminal for the actual run of characters. The RFC equivalent of attrtext is the token characters, with the subtraction of '*', "'", and '%'. We include tab in the excluded set just as we do for token. """ attribute = Attribute() if value and value[0] in CFWS_LEADER: token, value = get_cfws(value) attribute.append(token) if value and value[0] in ATTRIBUTE_ENDS: raise errors.HeaderParseError( "expected token but found '{}'".format(value)) token, value = get_attrtext(value) attribute.append(token) if value and value[0] in CFWS_LEADER: token, value = get_cfws(value) attribute.append(token) return attribute, value def get_extended_attrtext(value): """attrtext = 1*(any non-ATTRIBUTE_ENDS character plus '%') This is a special parsing routine so that we get a value that includes % escapes as a single string (which we decode as a single string later). """ m = _non_extended_attribute_end_matcher(value) if not m: raise errors.HeaderParseError( "expected extended attrtext but found {!r}".format(value)) attrtext = m.group() value = value[len(attrtext):] attrtext = ValueTerminal(attrtext, 'extended-attrtext') _validate_xtext(attrtext) return attrtext, value def get_extended_attribute(value): """ [CFWS] 1*extended_attrtext [CFWS] This is like the non-extended version except we allow % characters, so that we can pick up an encoded value as a single string. """ # XXX: should we have an ExtendedAttribute TokenList? attribute = Attribute() if value and value[0] in CFWS_LEADER: token, value = get_cfws(value) attribute.append(token) if value and value[0] in EXTENDED_ATTRIBUTE_ENDS: raise errors.HeaderParseError( "expected token but found '{}'".format(value)) token, value = get_extended_attrtext(value) attribute.append(token) if value and value[0] in CFWS_LEADER: token, value = get_cfws(value) attribute.append(token) return attribute, value def get_section(value): """ '*' digits The formal BNF is more complicated because leading 0s are not allowed. We check for that and add a defect. We also assume no CFWS is allowed between the '*' and the digits, though the RFC is not crystal clear on that. The caller should already have dealt with leading CFWS. """ section = Section() if not value or value[0] != '*': raise errors.HeaderParseError("Expected section but found {}".format( value)) section.append(ValueTerminal('*', 'section-marker')) value = value[1:] if not value or not value[0].isdigit(): raise errors.HeaderParseError("Expected section number but " "found {}".format(value)) digits = '' while value and value[0].isdigit(): digits += value[0] value = value[1:] if digits[0] == '0' and digits != '0': section.defects.append(errors.InvalidHeaderError( "section number has an invalid leading 0")) section.number = int(digits) section.append(ValueTerminal(digits, 'digits')) return section, value def get_value(value): """ quoted-string / attribute """ v = Value() if not value: raise errors.HeaderParseError("Expected value but found end of string") leader = None if value[0] in CFWS_LEADER: leader, value = get_cfws(value) if not value: raise errors.HeaderParseError("Expected value but found " "only {}".format(leader)) if value[0] == '"': token, value = get_quoted_string(value) else: token, value = get_extended_attribute(value) if leader is not None: token[:0] = [leader] v.append(token) return v, value def get_parameter(value): """ attribute [section] ["*"] [CFWS] "=" value The CFWS is implied by the RFC but not made explicit in the BNF. This simplified form of the BNF from the RFC is made to conform with the RFC BNF through some extra checks. We do it this way because it makes both error recovery and working with the resulting parse tree easier. """ # It is possible CFWS would also be implicitly allowed between the section # and the 'extended-attribute' marker (the '*') , but we've never seen that # in the wild and we will therefore ignore the possibility. param = Parameter() token, value = get_attribute(value) param.append(token) if not value or value[0] == ';': param.defects.append(errors.InvalidHeaderDefect("Parameter contains " "name ({}) but no value".format(token))) return param, value if value[0] == '*': try: token, value = get_section(value) param.sectioned = True param.append(token) except errors.HeaderParseError: pass if not value: raise errors.HeaderParseError("Incomplete parameter") if value[0] == '*': param.append(ValueTerminal('*', 'extended-parameter-marker')) value = value[1:] param.extended = True if value[0] != '=': raise errors.HeaderParseError("Parameter not followed by '='") param.append(ValueTerminal('=', 'parameter-separator')) value = value[1:] leader = None if value and value[0] in CFWS_LEADER: token, value = get_cfws(value) param.append(token) remainder = None appendto = param if param.extended and value and value[0] == '"': # Now for some serious hackery to handle the common invalid case of # double quotes around an extended value. We also accept (with defect) # a value marked as encoded that isn't really. qstring, remainder = get_quoted_string(value) inner_value = qstring.stripped_value semi_valid = False if param.section_number == 0: if inner_value and inner_value[0] == "'": semi_valid = True else: token, rest = get_attrtext(inner_value) if rest and rest[0] == "'": semi_valid = True else: try: token, rest = get_extended_attrtext(inner_value) except: pass else: if not rest: semi_valid = True if semi_valid: param.defects.append(errors.InvalidHeaderDefect( "Quoted string value for extended parameter is invalid")) param.append(qstring) for t in qstring: if t.token_type == 'bare-quoted-string': t[:] = [] appendto = t break value = inner_value else: remainder = None param.defects.append(errors.InvalidHeaderDefect( "Parameter marked as extended but appears to have a " "quoted string value that is non-encoded")) if value and value[0] == "'": token = None else: token, value = get_value(value) if not param.extended or param.section_number > 0: if not value or value[0] != "'": appendto.append(token) if remainder is not None: assert not value, value value = remainder return param, value param.defects.append(errors.InvalidHeaderDefect( "Apparent initial-extended-value but attribute " "was not marked as extended or was not initial section")) if not value: # Assume the charset/lang is missing and the token is the value. param.defects.append(errors.InvalidHeaderDefect( "Missing required charset/lang delimiters")) appendto.append(token) if remainder is None: return param, value else: if token is not None: for t in token: if t.token_type == 'extended-attrtext': break t.token_type == 'attrtext' appendto.append(t) param.charset = t.value if value[0] != "'": raise errors.HeaderParseError("Expected RFC2231 char/lang encoding " "delimiter, but found {!r}".format(value)) appendto.append(ValueTerminal("'", 'RFC2231-delimiter')) value = value[1:] if value and value[0] != "'": token, value = get_attrtext(value) appendto.append(token) param.lang = token.value if not value or value[0] != "'": raise errors.HeaderParseError("Expected RFC2231 char/lang encoding " "delimiter, but found {}".format(value)) appendto.append(ValueTerminal("'", 'RFC2231-delimiter')) value = value[1:] if remainder is not None: # Treat the rest of value as bare quoted string content. v = Value() while value: if value[0] in WSP: token, value = get_fws(value) elif value[0] == '"': token = ValueTerminal('"', 'DQUOTE') value = value[1:] else: token, value = get_qcontent(value) v.append(token) token = v else: token, value = get_value(value) appendto.append(token) if remainder is not None: assert not value, value value = remainder return param, value def parse_mime_parameters(value): """ parameter *( ";" parameter ) That BNF is meant to indicate this routine should only be called after finding and handling the leading ';'. There is no corresponding rule in the formal RFC grammar, but it is more convenient for us for the set of parameters to be treated as its own TokenList. This is 'parse' routine because it consumes the remaining value, but it would never be called to parse a full header. Instead it is called to parse everything after the non-parameter value of a specific MIME header. """ mime_parameters = MimeParameters() while value: try: token, value = get_parameter(value) mime_parameters.append(token) except errors.HeaderParseError as err: leader = None if value[0] in CFWS_LEADER: leader, value = get_cfws(value) if not value: mime_parameters.append(leader) return mime_parameters if value[0] == ';': if leader is not None: mime_parameters.append(leader) mime_parameters.defects.append(errors.InvalidHeaderDefect( "parameter entry with no content")) else: token, value = get_invalid_parameter(value) if leader: token[:0] = [leader] mime_parameters.append(token) mime_parameters.defects.append(errors.InvalidHeaderDefect( "invalid parameter {!r}".format(token))) if value and value[0] != ';': # Junk after the otherwise valid parameter. Mark it as # invalid, but it will have a value. param = mime_parameters[-1] param.token_type = 'invalid-parameter' token, value = get_invalid_parameter(value) param.extend(token) mime_parameters.defects.append(errors.InvalidHeaderDefect( "parameter with invalid trailing text {!r}".format(token))) if value: # Must be a ';' at this point. mime_parameters.append(ValueTerminal(';', 'parameter-separator')) value = value[1:] return mime_parameters def _find_mime_parameters(tokenlist, value): """Do our best to find the parameters in an invalid MIME header """ while value and value[0] != ';': if value[0] in PHRASE_ENDS: tokenlist.append(ValueTerminal(value[0], 'misplaced-special')) value = value[1:] else: token, value = get_phrase(value) tokenlist.append(token) if not value: return tokenlist.append(ValueTerminal(';', 'parameter-separator')) tokenlist.append(parse_mime_parameters(value[1:])) def parse_content_type_header(value): """ maintype "/" subtype *( ";" parameter ) The maintype and substype are tokens. Theoretically they could be checked against the official IANA list + x-token, but we don't do that. """ ctype = ContentType() recover = False if not value: ctype.defects.append(errors.HeaderMissingRequiredValue( "Missing content type specification")) return ctype try: token, value = get_token(value) except errors.HeaderParseError: ctype.defects.append(errors.InvalidHeaderDefect( "Expected content maintype but found {!r}".format(value))) _find_mime_parameters(ctype, value) return ctype ctype.append(token) # XXX: If we really want to follow the formal grammar we should make # mantype and subtype specialized TokenLists here. Probably not worth it. if not value or value[0] != '/': ctype.defects.append(errors.InvalidHeaderDefect( "Invalid content type")) if value: _find_mime_parameters(ctype, value) return ctype ctype.maintype = token.value.strip().lower() ctype.append(ValueTerminal('/', 'content-type-separator')) value = value[1:] try: token, value = get_token(value) except errors.HeaderParseError: ctype.defects.append(errors.InvalidHeaderDefect( "Expected content subtype but found {!r}".format(value))) _find_mime_parameters(ctype, value) return ctype ctype.append(token) ctype.subtype = token.value.strip().lower() if not value: return ctype if value[0] != ';': ctype.defects.append(errors.InvalidHeaderDefect( "Only parameters are valid after content type, but " "found {!r}".format(value))) # The RFC requires that a syntactically invalid content-type be treated # as text/plain. Perhaps we should postel this, but we should probably # only do that if we were checking the subtype value against IANA. del ctype.maintype, ctype.subtype _find_mime_parameters(ctype, value) return ctype ctype.append(ValueTerminal(';', 'parameter-separator')) ctype.append(parse_mime_parameters(value[1:])) return ctype def parse_content_disposition_header(value): """ disposition-type *( ";" parameter ) """ disp_header = ContentDisposition() if not value: disp_header.defects.append(errors.HeaderMissingRequiredValue( "Missing content disposition")) return disp_header try: token, value = get_token(value) except errors.HeaderParseError: disp_header.defects.append(errors.InvalidHeaderDefect( "Expected content disposition but found {!r}".format(value))) _find_mime_parameters(disp_header, value) return disp_header disp_header.append(token) disp_header.content_disposition = token.value.strip().lower() if not value: return disp_header if value[0] != ';': disp_header.defects.append(errors.InvalidHeaderDefect( "Only parameters are valid after content disposition, but " "found {!r}".format(value))) _find_mime_parameters(disp_header, value) return disp_header disp_header.append(ValueTerminal(';', 'parameter-separator')) disp_header.append(parse_mime_parameters(value[1:])) return disp_header def parse_content_transfer_encoding_header(value): """ mechanism """ # We should probably validate the values, since the list is fixed. cte_header = ContentTransferEncoding() if not value: cte_header.defects.append(errors.HeaderMissingRequiredValue( "Missing content transfer encoding")) return cte_header try: token, value = get_token(value) except errors.HeaderParseError: cte_header.defects.append(errors.InvalidHeaderDefect( "Expected content transfer encoding but found {!r}".format(value))) else: cte_header.append(token) cte_header.cte = token.value.strip().lower() if not value: return cte_header while value: cte_header.defects.append(errors.InvalidHeaderDefect( "Extra text after content transfer encoding")) if value[0] in PHRASE_ENDS: cte_header.append(ValueTerminal(value[0], 'misplaced-special')) value = value[1:] else: token, value = get_phrase(value) cte_header.append(token) return cte_header # # Header folding # # Header folding is complex, with lots of rules and corner cases. The # following code does its best to obey the rules and handle the corner # cases, but you can be sure there are few bugs:) # # This folder generally canonicalizes as it goes, preferring the stringified # version of each token. The tokens contain information that supports the # folder, including which tokens can be encoded in which ways. # # Folded text is accumulated in a simple list of strings ('lines'), each # one of which should be less than policy.max_line_length ('maxlen'). # def _steal_trailing_WSP_if_exists(lines): wsp = '' if lines and lines[-1] and lines[-1][-1] in WSP: wsp = lines[-1][-1] lines[-1] = lines[-1][:-1] return wsp def _refold_parse_tree(parse_tree, *, policy): """Return string of contents of parse_tree folded according to RFC rules. """ # max_line_length 0/None means no limit, ie: infinitely long. maxlen = policy.max_line_length or sys.maxsize encoding = 'utf-8' if policy.utf8 else 'us-ascii' lines = [''] last_ew = None wrap_as_ew_blocked = 0 want_encoding = False end_ew_not_allowed = Terminal('', 'wrap_as_ew_blocked') parts = list(parse_tree) while parts: part = parts.pop(0) if part is end_ew_not_allowed: wrap_as_ew_blocked -= 1 continue tstr = str(part) if part.token_type == 'ptext' and set(tstr) & SPECIALS: # Encode if tstr contains special characters. want_encoding = True try: tstr.encode(encoding) charset = encoding except UnicodeEncodeError: if any(isinstance(x, errors.UndecodableBytesDefect) for x in part.all_defects): charset = 'unknown-8bit' else: # If policy.utf8 is false this should really be taken from a # 'charset' property on the policy. charset = 'utf-8' want_encoding = True if part.token_type == 'mime-parameters': # Mime parameter folding (using RFC2231) is extra special. _fold_mime_parameters(part, lines, maxlen, encoding) continue if want_encoding and not wrap_as_ew_blocked: if not part.as_ew_allowed: want_encoding = False last_ew = None if part.syntactic_break: encoded_part = part.fold(policy=policy)[:-len(policy.linesep)] if policy.linesep not in encoded_part: # It fits on a single line if len(encoded_part) > maxlen - len(lines[-1]): # But not on this one, so start a new one. newline = _steal_trailing_WSP_if_exists(lines) # XXX what if encoded_part has no leading FWS? lines.append(newline) lines[-1] += encoded_part continue # Either this is not a major syntactic break, so we don't # want it on a line by itself even if it fits, or it # doesn't fit on a line by itself. Either way, fall through # to unpacking the subparts and wrapping them. if not hasattr(part, 'encode'): # It's not a Terminal, do each piece individually. parts = list(part) + parts else: # It's a terminal, wrap it as an encoded word, possibly # combining it with previously encoded words if allowed. last_ew = _fold_as_ew(tstr, lines, maxlen, last_ew, part.ew_combine_allowed, charset) want_encoding = False continue if len(tstr) <= maxlen - len(lines[-1]): lines[-1] += tstr continue # This part is too long to fit. The RFC wants us to break at # "major syntactic breaks", so unless we don't consider this # to be one, check if it will fit on the next line by itself. if (part.syntactic_break and len(tstr) + 1 <= maxlen): newline = _steal_trailing_WSP_if_exists(lines) if newline or part.startswith_fws(): lines.append(newline + tstr) last_ew = None continue if not hasattr(part, 'encode'): # It's not a terminal, try folding the subparts. newparts = list(part) if not part.as_ew_allowed: wrap_as_ew_blocked += 1 newparts.append(end_ew_not_allowed) parts = newparts + parts continue if part.as_ew_allowed and not wrap_as_ew_blocked: # It doesn't need CTE encoding, but encode it anyway so we can # wrap it. parts.insert(0, part) want_encoding = True continue # We can't figure out how to wrap, it, so give up. newline = _steal_trailing_WSP_if_exists(lines) if newline or part.startswith_fws(): lines.append(newline + tstr) else: # We can't fold it onto the next line either... lines[-1] += tstr return policy.linesep.join(lines) + policy.linesep def _fold_as_ew(to_encode, lines, maxlen, last_ew, ew_combine_allowed, charset): """Fold string to_encode into lines as encoded word, combining if allowed. Return the new value for last_ew, or None if ew_combine_allowed is False. If there is already an encoded word in the last line of lines (indicated by a non-None value for last_ew) and ew_combine_allowed is true, decode the existing ew, combine it with to_encode, and re-encode. Otherwise, encode to_encode. In either case, split to_encode as necessary so that the encoded segments fit within maxlen. """ if last_ew is not None and ew_combine_allowed: to_encode = str( get_unstructured(lines[-1][last_ew:] + to_encode)) lines[-1] = lines[-1][:last_ew] if to_encode[0] in WSP: # We're joining this to non-encoded text, so don't encode # the leading blank. leading_wsp = to_encode[0] to_encode = to_encode[1:] if (len(lines[-1]) == maxlen): lines.append(_steal_trailing_WSP_if_exists(lines)) lines[-1] += leading_wsp trailing_wsp = '' if to_encode[-1] in WSP: # Likewise for the trailing space. trailing_wsp = to_encode[-1] to_encode = to_encode[:-1] new_last_ew = len(lines[-1]) if last_ew is None else last_ew encode_as = 'utf-8' if charset == 'us-ascii' else charset # The RFC2047 chrome takes up 7 characters plus the length # of the charset name. chrome_len = len(encode_as) + 7 if (chrome_len + 1) >= maxlen: raise errors.HeaderParseError( "max_line_length is too small to fit an encoded word") while to_encode: remaining_space = maxlen - len(lines[-1]) text_space = remaining_space - chrome_len if text_space <= 0: lines.append(' ') continue to_encode_word = to_encode[:text_space] encoded_word = _ew.encode(to_encode_word, charset=encode_as) excess = len(encoded_word) - remaining_space while excess > 0: # Since the chunk to encode is guaranteed to fit into less than 100 characters, # shrinking it by one at a time shouldn't take long. to_encode_word = to_encode_word[:-1] encoded_word = _ew.encode(to_encode_word, charset=encode_as) excess = len(encoded_word) - remaining_space lines[-1] += encoded_word to_encode = to_encode[len(to_encode_word):] if to_encode: lines.append(' ') new_last_ew = len(lines[-1]) lines[-1] += trailing_wsp return new_last_ew if ew_combine_allowed else None def _fold_mime_parameters(part, lines, maxlen, encoding): """Fold TokenList 'part' into the 'lines' list as mime parameters. Using the decoded list of parameters and values, format them according to the RFC rules, including using RFC2231 encoding if the value cannot be expressed in 'encoding' and/or the parameter+value is too long to fit within 'maxlen'. """ # Special case for RFC2231 encoding: start from decoded values and use # RFC2231 encoding iff needed. # # Note that the 1 and 2s being added to the length calculations are # accounting for the possibly-needed spaces and semicolons we'll be adding. # for name, value in part.params: # XXX What if this ';' puts us over maxlen the first time through the # loop? We should split the header value onto a newline in that case, # but to do that we need to recognize the need earlier or reparse the # header, so I'm going to ignore that bug for now. It'll only put us # one character over. if not lines[-1].rstrip().endswith(';'): lines[-1] += ';' charset = encoding error_handler = 'strict' try: value.encode(encoding) encoding_required = False except UnicodeEncodeError: encoding_required = True if utils._has_surrogates(value): charset = 'unknown-8bit' error_handler = 'surrogateescape' else: charset = 'utf-8' if encoding_required: encoded_value = urllib.parse.quote( value, safe='', errors=error_handler) tstr = "{}*={}''{}".format(name, charset, encoded_value) else: tstr = '{}={}'.format(name, quote_string(value)) if len(lines[-1]) + len(tstr) + 1 < maxlen: lines[-1] = lines[-1] + ' ' + tstr continue elif len(tstr) + 2 <= maxlen: lines.append(' ' + tstr) continue # We need multiple sections. We are allowed to mix encoded and # non-encoded sections, but we aren't going to. We'll encode them all. section = 0 extra_chrome = charset + "''" while value: chrome_len = len(name) + len(str(section)) + 3 + len(extra_chrome) if maxlen <= chrome_len + 3: # We need room for the leading blank, the trailing semicolon, # and at least one character of the value. If we don't # have that, we'd be stuck, so in that case fall back to # the RFC standard width. maxlen = 78 splitpoint = maxchars = maxlen - chrome_len - 2 while True: partial = value[:splitpoint] encoded_value = urllib.parse.quote( partial, safe='', errors=error_handler) if len(encoded_value) <= maxchars: break splitpoint -= 1 lines.append(" {}*{}*={}{}".format( name, section, extra_chrome, encoded_value)) extra_chrome = '' section += 1 value = value[splitpoint:] if value: lines[-1] += ';' base64mime.py 0000644 00000013242 15204103445 0007052 0 ustar 00 # Copyright (C) 2002-2006 Python Software Foundation # Author: Ben Gertzfield # Contact: email-sig@python.org """Base64 content transfer encoding per RFCs 2045-2047. This module handles the content transfer encoding method defined in RFC 2045 to encode arbitrary 8-bit data using the three 8-bit bytes in four 7-bit characters encoding known as Base64. It is used in the MIME standards for email to attach images, audio, and text using some 8-bit character sets to messages. This module provides an interface to encode and decode both headers and bodies with Base64 encoding. RFC 2045 defines a method for including character set information in an `encoded-word' in a header. This method is commonly used for 8-bit real names in To:, From:, Cc:, etc. fields, as well as Subject: lines. This module does not do the line wrapping or end-of-line character conversion necessary for proper internationalized headers; it only does dumb encoding and decoding. To deal with the various line wrapping issues, use the email.header module. """ __all__ = [ 'base64_len', 'body_decode', 'body_encode', 'decode', 'decodestring', 'encode', 'encodestring', 'header_encode', ] from binascii import b2a_base64, a2b_base64 from email.utils import fix_eols CRLF = '\r\n' NL = '\n' EMPTYSTRING = '' # See also Charset.py MISC_LEN = 7 # Helpers def base64_len(s): """Return the length of s when it is encoded with base64.""" groups_of_3, leftover = divmod(len(s), 3) # 4 bytes out for each 3 bytes (or nonzero fraction thereof) in. # Thanks, Tim! n = groups_of_3 * 4 if leftover: n += 4 return n def header_encode(header, charset='iso-8859-1', keep_eols=False, maxlinelen=76, eol=NL): """Encode a single header line with Base64 encoding in a given charset. Defined in RFC 2045, this Base64 encoding is identical to normal Base64 encoding, except that each line must be intelligently wrapped (respecting the Base64 encoding), and subsequent lines must start with a space. charset names the character set to use to encode the header. It defaults to iso-8859-1. End-of-line characters (\\r, \\n, \\r\\n) will be automatically converted to the canonical email line separator \\r\\n unless the keep_eols parameter is True (the default is False). Each line of the header will be terminated in the value of eol, which defaults to "\\n". Set this to "\\r\\n" if you are using the result of this function directly in email. The resulting string will be in the form: "=?charset?b?WW/5ciBtYXp66XLrIHf8eiBhIGhhbXBzdGHuciBBIFlv+XIgbWF6euly?=\\n =?charset?b?6yB3/HogYSBoYW1wc3Rh7nIgQkMgWW/5ciBtYXp66XLrIHf8eiBhIGhh?=" with each line wrapped at, at most, maxlinelen characters (defaults to 76 characters). """ # Return empty headers unchanged if not header: return header if not keep_eols: header = fix_eols(header) # Base64 encode each line, in encoded chunks no greater than maxlinelen in # length, after the RFC chrome is added in. base64ed = [] max_encoded = maxlinelen - len(charset) - MISC_LEN max_unencoded = max_encoded * 3 // 4 for i in range(0, len(header), max_unencoded): base64ed.append(b2a_base64(header[i:i+max_unencoded])) # Now add the RFC chrome to each encoded chunk lines = [] for line in base64ed: # Ignore the last character of each line if it is a newline if line.endswith(NL): line = line[:-1] # Add the chrome lines.append('=?%s?b?%s?=' % (charset, line)) # Glue the lines together and return it. BAW: should we be able to # specify the leading whitespace in the joiner? joiner = eol + ' ' return joiner.join(lines) def encode(s, binary=True, maxlinelen=76, eol=NL): """Encode a string with base64. Each line will be wrapped at, at most, maxlinelen characters (defaults to 76 characters). If binary is False, end-of-line characters will be converted to the canonical email end-of-line sequence \\r\\n. Otherwise they will be left verbatim (this is the default). Each line of encoded text will end with eol, which defaults to "\\n". Set this to "\\r\\n" if you will be using the result of this function directly in an email. """ if not s: return s if not binary: s = fix_eols(s) encvec = [] max_unencoded = maxlinelen * 3 // 4 for i in range(0, len(s), max_unencoded): # BAW: should encode() inherit b2a_base64()'s dubious behavior in # adding a newline to the encoded string? enc = b2a_base64(s[i:i + max_unencoded]) if enc.endswith(NL) and eol != NL: enc = enc[:-1] + eol encvec.append(enc) return EMPTYSTRING.join(encvec) # For convenience and backwards compatibility w/ standard base64 module body_encode = encode encodestring = encode def decode(s, convert_eols=None): """Decode a raw base64 string. If convert_eols is set to a string value, all canonical email linefeeds, e.g. "\\r\\n", in the decoded text will be converted to the value of convert_eols. os.linesep is a good choice for convert_eols if you are decoding a text attachment. This function does not parse a full MIME header value encoded with base64 (like =?iso-8859-1?b?bmloISBuaWgh?=) -- please use the high level email.header class for that functionality. """ if not s: return s dec = a2b_base64(s) if convert_eols: return dec.replace(CRLF, convert_eols) return dec # For convenience and backwards compatibility w/ standard base64 module body_decode = decode decodestring = decode _policybase.py 0000644 00000035341 15204103445 0007413 0 ustar 00 """Policy framework for the email package. Allows fine grained feature control of how the package parses and emits data. """ import abc from email import header from email import charset as _charset from email.utils import _has_surrogates __all__ = [ 'Policy', 'Compat32', 'compat32', ] class _PolicyBase: """Policy Object basic framework. This class is useless unless subclassed. A subclass should define class attributes with defaults for any values that are to be managed by the Policy object. The constructor will then allow non-default values to be set for these attributes at instance creation time. The instance will be callable, taking these same attributes keyword arguments, and returning a new instance identical to the called instance except for those values changed by the keyword arguments. Instances may be added, yielding new instances with any non-default values from the right hand operand overriding those in the left hand operand. That is, A + B == A(<non-default values of B>) The repr of an instance can be used to reconstruct the object if and only if the repr of the values can be used to reconstruct those values. """ def __init__(self, **kw): """Create new Policy, possibly overriding some defaults. See class docstring for a list of overridable attributes. """ for name, value in kw.items(): if hasattr(self, name): super(_PolicyBase,self).__setattr__(name, value) else: raise TypeError( "{!r} is an invalid keyword argument for {}".format( name, self.__class__.__name__)) def __repr__(self): args = [ "{}={!r}".format(name, value) for name, value in self.__dict__.items() ] return "{}({})".format(self.__class__.__name__, ', '.join(args)) def clone(self, **kw): """Return a new instance with specified attributes changed. The new instance has the same attribute values as the current object, except for the changes passed in as keyword arguments. """ newpolicy = self.__class__.__new__(self.__class__) for attr, value in self.__dict__.items(): object.__setattr__(newpolicy, attr, value) for attr, value in kw.items(): if not hasattr(self, attr): raise TypeError( "{!r} is an invalid keyword argument for {}".format( attr, self.__class__.__name__)) object.__setattr__(newpolicy, attr, value) return newpolicy def __setattr__(self, name, value): if hasattr(self, name): msg = "{!r} object attribute {!r} is read-only" else: msg = "{!r} object has no attribute {!r}" raise AttributeError(msg.format(self.__class__.__name__, name)) def __add__(self, other): """Non-default values from right operand override those from left. The object returned is a new instance of the subclass. """ return self.clone(**other.__dict__) def _append_doc(doc, added_doc): doc = doc.rsplit('\n', 1)[0] added_doc = added_doc.split('\n', 1)[1] return doc + '\n' + added_doc def _extend_docstrings(cls): if cls.__doc__ and cls.__doc__.startswith('+'): cls.__doc__ = _append_doc(cls.__bases__[0].__doc__, cls.__doc__) for name, attr in cls.__dict__.items(): if attr.__doc__ and attr.__doc__.startswith('+'): for c in (c for base in cls.__bases__ for c in base.mro()): doc = getattr(getattr(c, name), '__doc__') if doc: attr.__doc__ = _append_doc(doc, attr.__doc__) break return cls class Policy(_PolicyBase, metaclass=abc.ABCMeta): r"""Controls for how messages are interpreted and formatted. Most of the classes and many of the methods in the email package accept Policy objects as parameters. A Policy object contains a set of values and functions that control how input is interpreted and how output is rendered. For example, the parameter 'raise_on_defect' controls whether or not an RFC violation results in an error being raised or not, while 'max_line_length' controls the maximum length of output lines when a Message is serialized. Any valid attribute may be overridden when a Policy is created by passing it as a keyword argument to the constructor. Policy objects are immutable, but a new Policy object can be created with only certain values changed by calling the Policy instance with keyword arguments. Policy objects can also be added, producing a new Policy object in which the non-default attributes set in the right hand operand overwrite those specified in the left operand. Settable attributes: raise_on_defect -- If true, then defects should be raised as errors. Default: False. linesep -- string containing the value to use as separation between output lines. Default '\n'. cte_type -- Type of allowed content transfer encodings 7bit -- ASCII only 8bit -- Content-Transfer-Encoding: 8bit is allowed Default: 8bit. Also controls the disposition of (RFC invalid) binary data in headers; see the documentation of the binary_fold method. max_line_length -- maximum length of lines, excluding 'linesep', during serialization. None or 0 means no line wrapping is done. Default is 78. mangle_from_ -- a flag that, when True escapes From_ lines in the body of the message by putting a `>' in front of them. This is used when the message is being serialized by a generator. Default: True. message_factory -- the class to use to create new message objects. If the value is None, the default is Message. """ raise_on_defect = False linesep = '\n' cte_type = '8bit' max_line_length = 78 mangle_from_ = False message_factory = None def handle_defect(self, obj, defect): """Based on policy, either raise defect or call register_defect. handle_defect(obj, defect) defect should be a Defect subclass, but in any case must be an Exception subclass. obj is the object on which the defect should be registered if it is not raised. If the raise_on_defect is True, the defect is raised as an error, otherwise the object and the defect are passed to register_defect. This method is intended to be called by parsers that discover defects. The email package parsers always call it with Defect instances. """ if self.raise_on_defect: raise defect self.register_defect(obj, defect) def register_defect(self, obj, defect): """Record 'defect' on 'obj'. Called by handle_defect if raise_on_defect is False. This method is part of the Policy API so that Policy subclasses can implement custom defect handling. The default implementation calls the append method of the defects attribute of obj. The objects used by the email package by default that get passed to this method will always have a defects attribute with an append method. """ obj.defects.append(defect) def header_max_count(self, name): """Return the maximum allowed number of headers named 'name'. Called when a header is added to a Message object. If the returned value is not 0 or None, and there are already a number of headers with the name 'name' equal to the value returned, a ValueError is raised. Because the default behavior of Message's __setitem__ is to append the value to the list of headers, it is easy to create duplicate headers without realizing it. This method allows certain headers to be limited in the number of instances of that header that may be added to a Message programmatically. (The limit is not observed by the parser, which will faithfully produce as many headers as exist in the message being parsed.) The default implementation returns None for all header names. """ return None @abc.abstractmethod def header_source_parse(self, sourcelines): """Given a list of linesep terminated strings constituting the lines of a single header, return the (name, value) tuple that should be stored in the model. The input lines should retain their terminating linesep characters. The lines passed in by the email package may contain surrogateescaped binary data. """ raise NotImplementedError @abc.abstractmethod def header_store_parse(self, name, value): """Given the header name and the value provided by the application program, return the (name, value) that should be stored in the model. """ raise NotImplementedError @abc.abstractmethod def header_fetch_parse(self, name, value): """Given the header name and the value from the model, return the value to be returned to the application program that is requesting that header. The value passed in by the email package may contain surrogateescaped binary data if the lines were parsed by a BytesParser. The returned value should not contain any surrogateescaped data. """ raise NotImplementedError @abc.abstractmethod def fold(self, name, value): """Given the header name and the value from the model, return a string containing linesep characters that implement the folding of the header according to the policy controls. The value passed in by the email package may contain surrogateescaped binary data if the lines were parsed by a BytesParser. The returned value should not contain any surrogateescaped data. """ raise NotImplementedError @abc.abstractmethod def fold_binary(self, name, value): """Given the header name and the value from the model, return binary data containing linesep characters that implement the folding of the header according to the policy controls. The value passed in by the email package may contain surrogateescaped binary data. """ raise NotImplementedError @_extend_docstrings class Compat32(Policy): """+ This particular policy is the backward compatibility Policy. It replicates the behavior of the email package version 5.1. """ mangle_from_ = True def _sanitize_header(self, name, value): # If the header value contains surrogates, return a Header using # the unknown-8bit charset to encode the bytes as encoded words. if not isinstance(value, str): # Assume it is already a header object return value if _has_surrogates(value): return header.Header(value, charset=_charset.UNKNOWN8BIT, header_name=name) else: return value def header_source_parse(self, sourcelines): """+ The name is parsed as everything up to the ':' and returned unmodified. The value is determined by stripping leading whitespace off the remainder of the first line, joining all subsequent lines together, and stripping any trailing carriage return or linefeed characters. """ name, value = sourcelines[0].split(':', 1) value = value.lstrip(' \t') + ''.join(sourcelines[1:]) return (name, value.rstrip('\r\n')) def header_store_parse(self, name, value): """+ The name and value are returned unmodified. """ return (name, value) def header_fetch_parse(self, name, value): """+ If the value contains binary data, it is converted into a Header object using the unknown-8bit charset. Otherwise it is returned unmodified. """ return self._sanitize_header(name, value) def fold(self, name, value): """+ Headers are folded using the Header folding algorithm, which preserves existing line breaks in the value, and wraps each resulting line to the max_line_length. Non-ASCII binary data are CTE encoded using the unknown-8bit charset. """ return self._fold(name, value, sanitize=True) def fold_binary(self, name, value): """+ Headers are folded using the Header folding algorithm, which preserves existing line breaks in the value, and wraps each resulting line to the max_line_length. If cte_type is 7bit, non-ascii binary data is CTE encoded using the unknown-8bit charset. Otherwise the original source header is used, with its existing line breaks and/or binary data. """ folded = self._fold(name, value, sanitize=self.cte_type=='7bit') return folded.encode('ascii', 'surrogateescape') def _fold(self, name, value, sanitize): parts = [] parts.append('%s: ' % name) if isinstance(value, str): if _has_surrogates(value): if sanitize: h = header.Header(value, charset=_charset.UNKNOWN8BIT, header_name=name) else: # If we have raw 8bit data in a byte string, we have no idea # what the encoding is. There is no safe way to split this # string. If it's ascii-subset, then we could do a normal # ascii split, but if it's multibyte then we could break the # string. There's no way to know so the least harm seems to # be to not split the string and risk it being too long. parts.append(value) h = None else: h = header.Header(value, header_name=name) else: # Assume it is a Header-like object. h = value if h is not None: # The Header class interprets a value of None for maxlinelen as the # default value of 78, as recommended by RFC 2822. maxlinelen = 0 if self.max_line_length is not None: maxlinelen = self.max_line_length parts.append(h.encode(linesep=self.linesep, maxlinelen=maxlinelen)) parts.append(self.linesep) return ''.join(parts) compat32 = Compat32() generator.py 0000644 00000033573 15204103445 0007115 0 ustar 00 # Copyright (C) 2001-2010 Python Software Foundation # Contact: email-sig@python.org """Classes to generate plain text from a message object tree.""" __all__ = ['Generator', 'DecodedGenerator'] import re import sys import time import random import warnings from cStringIO import StringIO from email.header import Header UNDERSCORE = '_' NL = '\n' fcre = re.compile(r'^From ', re.MULTILINE) def _is8bitstring(s): if isinstance(s, str): try: unicode(s, 'us-ascii') except UnicodeError: return True return False class Generator: """Generates output from a Message object tree. This basic generator writes the message to the given file object as plain text. """ # # Public interface # def __init__(self, outfp, mangle_from_=True, maxheaderlen=78): """Create the generator for message flattening. outfp is the output file-like object for writing the message to. It must have a write() method. Optional mangle_from_ is a flag that, when True (the default), escapes From_ lines in the body of the message by putting a `>' in front of them. Optional maxheaderlen specifies the longest length for a non-continued header. When a header line is longer (in characters, with tabs expanded to 8 spaces) than maxheaderlen, the header will split as defined in the Header class. Set maxheaderlen to zero to disable header wrapping. The default is 78, as recommended (but not required) by RFC 2822. """ self._fp = outfp self._mangle_from_ = mangle_from_ self._maxheaderlen = maxheaderlen def write(self, s): # Just delegate to the file object self._fp.write(s) def flatten(self, msg, unixfrom=False): """Print the message object tree rooted at msg to the output file specified when the Generator instance was created. unixfrom is a flag that forces the printing of a Unix From_ delimiter before the first object in the message tree. If the original message has no From_ delimiter, a `standard' one is crafted. By default, this is False to inhibit the printing of any From_ delimiter. Note that for subobjects, no From_ line is printed. """ if unixfrom: ufrom = msg.get_unixfrom() if not ufrom: ufrom = 'From nobody ' + time.ctime(time.time()) print >> self._fp, ufrom self._write(msg) def clone(self, fp): """Clone this generator with the exact same options.""" return self.__class__(fp, self._mangle_from_, self._maxheaderlen) # # Protected interface - undocumented ;/ # def _write(self, msg): # We can't write the headers yet because of the following scenario: # say a multipart message includes the boundary string somewhere in # its body. We'd have to calculate the new boundary /before/ we write # the headers so that we can write the correct Content-Type: # parameter. # # The way we do this, so as to make the _handle_*() methods simpler, # is to cache any subpart writes into a StringIO. The we write the # headers and the StringIO contents. That way, subpart handlers can # Do The Right Thing, and can still modify the Content-Type: header if # necessary. oldfp = self._fp try: self._fp = sfp = StringIO() self._dispatch(msg) finally: self._fp = oldfp # Write the headers. First we see if the message object wants to # handle that itself. If not, we'll do it generically. meth = getattr(msg, '_write_headers', None) if meth is None: self._write_headers(msg) else: meth(self) self._fp.write(sfp.getvalue()) def _dispatch(self, msg): # Get the Content-Type: for the message, then try to dispatch to # self._handle_<maintype>_<subtype>(). If there's no handler for the # full MIME type, then dispatch to self._handle_<maintype>(). If # that's missing too, then dispatch to self._writeBody(). main = msg.get_content_maintype() sub = msg.get_content_subtype() specific = UNDERSCORE.join((main, sub)).replace('-', '_') meth = getattr(self, '_handle_' + specific, None) if meth is None: generic = main.replace('-', '_') meth = getattr(self, '_handle_' + generic, None) if meth is None: meth = self._writeBody meth(msg) # # Default handlers # def _write_headers(self, msg): for h, v in msg.items(): print >> self._fp, '%s:' % h, if self._maxheaderlen == 0: # Explicit no-wrapping print >> self._fp, v elif isinstance(v, Header): # Header instances know what to do print >> self._fp, v.encode() elif _is8bitstring(v): # If we have raw 8bit data in a byte string, we have no idea # what the encoding is. There is no safe way to split this # string. If it's ascii-subset, then we could do a normal # ascii split, but if it's multibyte then we could break the # string. There's no way to know so the least harm seems to # be to not split the string and risk it being too long. print >> self._fp, v else: # Header's got lots of smarts, so use it. Note that this is # fundamentally broken though because we lose idempotency when # the header string is continued with tabs. It will now be # continued with spaces. This was reversedly broken before we # fixed bug 1974. Either way, we lose. print >> self._fp, Header( v, maxlinelen=self._maxheaderlen, header_name=h).encode() # A blank line always separates headers from body print >> self._fp # # Handlers for writing types and subtypes # def _handle_text(self, msg): payload = msg.get_payload() if payload is None: return if not isinstance(payload, basestring): raise TypeError('string payload expected: %s' % type(payload)) if self._mangle_from_: payload = fcre.sub('>From ', payload) self._fp.write(payload) # Default body handler _writeBody = _handle_text def _handle_multipart(self, msg): # The trick here is to write out each part separately, merge them all # together, and then make sure that the boundary we've chosen isn't # present in the payload. msgtexts = [] subparts = msg.get_payload() if subparts is None: subparts = [] elif isinstance(subparts, basestring): # e.g. a non-strict parse of a message with no starting boundary. self._fp.write(subparts) return elif not isinstance(subparts, list): # Scalar payload subparts = [subparts] for part in subparts: s = StringIO() g = self.clone(s) g.flatten(part, unixfrom=False) msgtexts.append(s.getvalue()) # BAW: What about boundaries that are wrapped in double-quotes? boundary = msg.get_boundary() if not boundary: # Create a boundary that doesn't appear in any of the # message texts. alltext = NL.join(msgtexts) boundary = _make_boundary(alltext) msg.set_boundary(boundary) # If there's a preamble, write it out, with a trailing CRLF if msg.preamble is not None: if self._mangle_from_: preamble = fcre.sub('>From ', msg.preamble) else: preamble = msg.preamble print >> self._fp, preamble # dash-boundary transport-padding CRLF print >> self._fp, '--' + boundary # body-part if msgtexts: self._fp.write(msgtexts.pop(0)) # *encapsulation # --> delimiter transport-padding # --> CRLF body-part for body_part in msgtexts: # delimiter transport-padding CRLF print >> self._fp, '\n--' + boundary # body-part self._fp.write(body_part) # close-delimiter transport-padding self._fp.write('\n--' + boundary + '--' + NL) if msg.epilogue is not None: if self._mangle_from_: epilogue = fcre.sub('>From ', msg.epilogue) else: epilogue = msg.epilogue self._fp.write(epilogue) def _handle_multipart_signed(self, msg): # The contents of signed parts has to stay unmodified in order to keep # the signature intact per RFC1847 2.1, so we disable header wrapping. # RDM: This isn't enough to completely preserve the part, but it helps. old_maxheaderlen = self._maxheaderlen try: self._maxheaderlen = 0 self._handle_multipart(msg) finally: self._maxheaderlen = old_maxheaderlen def _handle_message_delivery_status(self, msg): # We can't just write the headers directly to self's file object # because this will leave an extra newline between the last header # block and the boundary. Sigh. blocks = [] for part in msg.get_payload(): s = StringIO() g = self.clone(s) g.flatten(part, unixfrom=False) text = s.getvalue() lines = text.split('\n') # Strip off the unnecessary trailing empty line if lines and lines[-1] == '': blocks.append(NL.join(lines[:-1])) else: blocks.append(text) # Now join all the blocks with an empty line. This has the lovely # effect of separating each block with an empty line, but not adding # an extra one after the last one. self._fp.write(NL.join(blocks)) def _handle_message(self, msg): s = StringIO() g = self.clone(s) # The payload of a message/rfc822 part should be a multipart sequence # of length 1. The zeroth element of the list should be the Message # object for the subpart. Extract that object, stringify it, and # write it out. # Except, it turns out, when it's a string instead, which happens when # and only when HeaderParser is used on a message of mime type # message/rfc822. Such messages are generated by, for example, # Groupwise when forwarding unadorned messages. (Issue 7970.) So # in that case we just emit the string body. payload = msg.get_payload() if isinstance(payload, list): g.flatten(msg.get_payload(0), unixfrom=False) payload = s.getvalue() self._fp.write(payload) _FMT = '[Non-text (%(type)s) part of message omitted, filename %(filename)s]' class DecodedGenerator(Generator): """Generates a text representation of a message. Like the Generator base class, except that non-text parts are substituted with a format string representing the part. """ def __init__(self, outfp, mangle_from_=True, maxheaderlen=78, fmt=None): """Like Generator.__init__() except that an additional optional argument is allowed. Walks through all subparts of a message. If the subpart is of main type `text', then it prints the decoded payload of the subpart. Otherwise, fmt is a format string that is used instead of the message payload. fmt is expanded with the following keywords (in %(keyword)s format): type : Full MIME type of the non-text part maintype : Main MIME type of the non-text part subtype : Sub-MIME type of the non-text part filename : Filename of the non-text part description: Description associated with the non-text part encoding : Content transfer encoding of the non-text part The default value for fmt is None, meaning [Non-text (%(type)s) part of message omitted, filename %(filename)s] """ Generator.__init__(self, outfp, mangle_from_, maxheaderlen) if fmt is None: self._fmt = _FMT else: self._fmt = fmt def _dispatch(self, msg): for part in msg.walk(): maintype = part.get_content_maintype() if maintype == 'text': print >> self, part.get_payload(decode=True) elif maintype == 'multipart': # Just skip this pass else: print >> self, self._fmt % { 'type' : part.get_content_type(), 'maintype' : part.get_content_maintype(), 'subtype' : part.get_content_subtype(), 'filename' : part.get_filename('[no filename]'), 'description': part.get('Content-Description', '[no description]'), 'encoding' : part.get('Content-Transfer-Encoding', '[no encoding]'), } # Helper _width = len(repr(sys.maxint-1)) _fmt = '%%0%dd' % _width def _make_boundary(text=None): # Craft a random boundary. If text is given, ensure that the chosen # boundary doesn't appear in the text. token = random.randrange(sys.maxint) boundary = ('=' * 15) + (_fmt % token) + '==' if text is None: return boundary b = boundary counter = 0 while True: cre = re.compile('^--' + re.escape(b) + '(--)?$', re.MULTILINE) if not cre.search(text): break b = boundary + '.' + str(counter) counter += 1 return b feedparser.py 0000644 00000050014 15204103445 0007234 0 ustar 00 # Copyright (C) 2004-2006 Python Software Foundation # Authors: Baxter, Wouters and Warsaw # Contact: email-sig@python.org """FeedParser - An email feed parser. The feed parser implements an interface for incrementally parsing an email message, line by line. This has advantages for certain applications, such as those reading email messages off a socket. FeedParser.feed() is the primary interface for pushing new data into the parser. It returns when there's nothing more it can do with the available data. When you have no more data to push into the parser, call .close(). This completes the parsing and returns the root message object. The other advantage of this parser is that it will never raise a parsing exception. Instead, when it finds something unexpected, it adds a 'defect' to the current message. Defects are just instances that live on the message object's .defects attribute. """ __all__ = ['FeedParser'] import re from email import errors from email import message NLCRE = re.compile('\r\n|\r|\n') NLCRE_bol = re.compile('(\r\n|\r|\n)') NLCRE_eol = re.compile('(\r\n|\r|\n)\Z') NLCRE_crack = re.compile('(\r\n|\r|\n)') # RFC 2822 $3.6.8 Optional fields. ftext is %d33-57 / %d59-126, Any character # except controls, SP, and ":". headerRE = re.compile(r'^(From |[\041-\071\073-\176]{1,}:|[\t ])') EMPTYSTRING = '' NL = '\n' NeedMoreData = object() class BufferedSubFile(object): """A file-ish object that can have new data loaded into it. You can also push and pop line-matching predicates onto a stack. When the current predicate matches the current line, a false EOF response (i.e. empty string) is returned instead. This lets the parser adhere to a simple abstraction -- it parses until EOF closes the current message. """ def __init__(self): # Chunks of the last partial line pushed into this object. self._partial = [] # The list of full, pushed lines, in reverse order self._lines = [] # The stack of false-EOF checking predicates. self._eofstack = [] # A flag indicating whether the file has been closed or not. self._closed = False def push_eof_matcher(self, pred): self._eofstack.append(pred) def pop_eof_matcher(self): return self._eofstack.pop() def close(self): # Don't forget any trailing partial line. self.pushlines(''.join(self._partial).splitlines(True)) self._partial = [] self._closed = True def readline(self): if not self._lines: if self._closed: return '' return NeedMoreData # Pop the line off the stack and see if it matches the current # false-EOF predicate. line = self._lines.pop() # RFC 2046, section 5.1.2 requires us to recognize outer level # boundaries at any level of inner nesting. Do this, but be sure it's # in the order of most to least nested. for ateof in self._eofstack[::-1]: if ateof(line): # We're at the false EOF. But push the last line back first. self._lines.append(line) return '' return line def unreadline(self, line): # Let the consumer push a line back into the buffer. assert line is not NeedMoreData self._lines.append(line) def push(self, data): """Push some new data into this object.""" # Crack into lines, but preserve the linesep characters on the end of each parts = data.splitlines(True) if not parts or not parts[0].endswith(('\n', '\r')): # No new complete lines, so just accumulate partials self._partial += parts return if self._partial: # If there are previous leftovers, complete them now self._partial.append(parts[0]) parts[0:1] = ''.join(self._partial).splitlines(True) del self._partial[:] # If the last element of the list does not end in a newline, then treat # it as a partial line. We only check for '\n' here because a line # ending with '\r' might be a line that was split in the middle of a # '\r\n' sequence (see bugs 1555570 and 1721862). if not parts[-1].endswith('\n'): self._partial = [parts.pop()] self.pushlines(parts) def pushlines(self, lines): # Reverse and insert at the front of the lines. self._lines[:0] = lines[::-1] def is_closed(self): return self._closed def __iter__(self): return self def next(self): line = self.readline() if line == '': raise StopIteration return line class FeedParser: """A feed-style parser of email.""" def __init__(self, _factory=message.Message): """_factory is called with no arguments to create a new message obj""" self._factory = _factory self._input = BufferedSubFile() self._msgstack = [] self._parse = self._parsegen().next self._cur = None self._last = None self._headersonly = False # Non-public interface for supporting Parser's headersonly flag def _set_headersonly(self): self._headersonly = True def feed(self, data): """Push more data into the parser.""" self._input.push(data) self._call_parse() def _call_parse(self): try: self._parse() except StopIteration: pass def close(self): """Parse all remaining data and return the root message object.""" self._input.close() self._call_parse() root = self._pop_message() assert not self._msgstack # Look for final set of defects if root.get_content_maintype() == 'multipart' \ and not root.is_multipart(): root.defects.append(errors.MultipartInvariantViolationDefect()) return root def _new_message(self): msg = self._factory() if self._cur and self._cur.get_content_type() == 'multipart/digest': msg.set_default_type('message/rfc822') if self._msgstack: self._msgstack[-1].attach(msg) self._msgstack.append(msg) self._cur = msg self._last = msg def _pop_message(self): retval = self._msgstack.pop() if self._msgstack: self._cur = self._msgstack[-1] else: self._cur = None return retval def _parsegen(self): # Create a new message and start by parsing headers. self._new_message() headers = [] # Collect the headers, searching for a line that doesn't match the RFC # 2822 header or continuation pattern (including an empty line). for line in self._input: if line is NeedMoreData: yield NeedMoreData continue if not headerRE.match(line): # If we saw the RFC defined header/body separator # (i.e. newline), just throw it away. Otherwise the line is # part of the body so push it back. if not NLCRE.match(line): self._input.unreadline(line) break headers.append(line) # Done with the headers, so parse them and figure out what we're # supposed to see in the body of the message. self._parse_headers(headers) # Headers-only parsing is a backwards compatibility hack, which was # necessary in the older parser, which could raise errors. All # remaining lines in the input are thrown into the message body. if self._headersonly: lines = [] while True: line = self._input.readline() if line is NeedMoreData: yield NeedMoreData continue if line == '': break lines.append(line) self._cur.set_payload(EMPTYSTRING.join(lines)) return if self._cur.get_content_type() == 'message/delivery-status': # message/delivery-status contains blocks of headers separated by # a blank line. We'll represent each header block as a separate # nested message object, but the processing is a bit different # than standard message/* types because there is no body for the # nested messages. A blank line separates the subparts. while True: self._input.push_eof_matcher(NLCRE.match) for retval in self._parsegen(): if retval is NeedMoreData: yield NeedMoreData continue break msg = self._pop_message() # We need to pop the EOF matcher in order to tell if we're at # the end of the current file, not the end of the last block # of message headers. self._input.pop_eof_matcher() # The input stream must be sitting at the newline or at the # EOF. We want to see if we're at the end of this subpart, so # first consume the blank line, then test the next line to see # if we're at this subpart's EOF. while True: line = self._input.readline() if line is NeedMoreData: yield NeedMoreData continue break while True: line = self._input.readline() if line is NeedMoreData: yield NeedMoreData continue break if line == '': break # Not at EOF so this is a line we're going to need. self._input.unreadline(line) return if self._cur.get_content_maintype() == 'message': # The message claims to be a message/* type, then what follows is # another RFC 2822 message. for retval in self._parsegen(): if retval is NeedMoreData: yield NeedMoreData continue break self._pop_message() return if self._cur.get_content_maintype() == 'multipart': boundary = self._cur.get_boundary() if boundary is None: # The message /claims/ to be a multipart but it has not # defined a boundary. That's a problem which we'll handle by # reading everything until the EOF and marking the message as # defective. self._cur.defects.append(errors.NoBoundaryInMultipartDefect()) lines = [] for line in self._input: if line is NeedMoreData: yield NeedMoreData continue lines.append(line) self._cur.set_payload(EMPTYSTRING.join(lines)) return # Create a line match predicate which matches the inter-part # boundary as well as the end-of-multipart boundary. Don't push # this onto the input stream until we've scanned past the # preamble. separator = '--' + boundary boundaryre = re.compile( '(?P<sep>' + re.escape(separator) + r')(?P<end>--)?(?P<ws>[ \t]*)(?P<linesep>\r\n|\r|\n)?$') capturing_preamble = True preamble = [] linesep = False while True: line = self._input.readline() if line is NeedMoreData: yield NeedMoreData continue if line == '': break mo = boundaryre.match(line) if mo: # If we're looking at the end boundary, we're done with # this multipart. If there was a newline at the end of # the closing boundary, then we need to initialize the # epilogue with the empty string (see below). if mo.group('end'): linesep = mo.group('linesep') break # We saw an inter-part boundary. Were we in the preamble? if capturing_preamble: if preamble: # According to RFC 2046, the last newline belongs # to the boundary. lastline = preamble[-1] eolmo = NLCRE_eol.search(lastline) if eolmo: preamble[-1] = lastline[:-len(eolmo.group(0))] self._cur.preamble = EMPTYSTRING.join(preamble) capturing_preamble = False self._input.unreadline(line) continue # We saw a boundary separating two parts. Consume any # multiple boundary lines that may be following. Our # interpretation of RFC 2046 BNF grammar does not produce # body parts within such double boundaries. while True: line = self._input.readline() if line is NeedMoreData: yield NeedMoreData continue mo = boundaryre.match(line) if not mo: self._input.unreadline(line) break # Recurse to parse this subpart; the input stream points # at the subpart's first line. self._input.push_eof_matcher(boundaryre.match) for retval in self._parsegen(): if retval is NeedMoreData: yield NeedMoreData continue break # Because of RFC 2046, the newline preceding the boundary # separator actually belongs to the boundary, not the # previous subpart's payload (or epilogue if the previous # part is a multipart). if self._last.get_content_maintype() == 'multipart': epilogue = self._last.epilogue if epilogue == '': self._last.epilogue = None elif epilogue is not None: mo = NLCRE_eol.search(epilogue) if mo: end = len(mo.group(0)) self._last.epilogue = epilogue[:-end] else: payload = self._last.get_payload() if isinstance(payload, basestring): mo = NLCRE_eol.search(payload) if mo: payload = payload[:-len(mo.group(0))] self._last.set_payload(payload) self._input.pop_eof_matcher() self._pop_message() # Set the multipart up for newline cleansing, which will # happen if we're in a nested multipart. self._last = self._cur else: # I think we must be in the preamble assert capturing_preamble preamble.append(line) # We've seen either the EOF or the end boundary. If we're still # capturing the preamble, we never saw the start boundary. Note # that as a defect and store the captured text as the payload. # Everything from here to the EOF is epilogue. if capturing_preamble: self._cur.defects.append(errors.StartBoundaryNotFoundDefect()) self._cur.set_payload(EMPTYSTRING.join(preamble)) epilogue = [] for line in self._input: if line is NeedMoreData: yield NeedMoreData continue self._cur.epilogue = EMPTYSTRING.join(epilogue) return # If the end boundary ended in a newline, we'll need to make sure # the epilogue isn't None if linesep: epilogue = [''] else: epilogue = [] for line in self._input: if line is NeedMoreData: yield NeedMoreData continue epilogue.append(line) # Any CRLF at the front of the epilogue is not technically part of # the epilogue. Also, watch out for an empty string epilogue, # which means a single newline. if epilogue: firstline = epilogue[0] bolmo = NLCRE_bol.match(firstline) if bolmo: epilogue[0] = firstline[len(bolmo.group(0)):] self._cur.epilogue = EMPTYSTRING.join(epilogue) return # Otherwise, it's some non-multipart type, so the entire rest of the # file contents becomes the payload. lines = [] for line in self._input: if line is NeedMoreData: yield NeedMoreData continue lines.append(line) self._cur.set_payload(EMPTYSTRING.join(lines)) def _parse_headers(self, lines): # Passed a list of lines that make up the headers for the current msg lastheader = '' lastvalue = [] for lineno, line in enumerate(lines): # Check for continuation if line[0] in ' \t': if not lastheader: # The first line of the headers was a continuation. This # is illegal, so let's note the defect, store the illegal # line, and ignore it for purposes of headers. defect = errors.FirstHeaderLineIsContinuationDefect(line) self._cur.defects.append(defect) continue lastvalue.append(line) continue if lastheader: # XXX reconsider the joining of folded lines lhdr = EMPTYSTRING.join(lastvalue)[:-1].rstrip('\r\n') self._cur[lastheader] = lhdr lastheader, lastvalue = '', [] # Check for envelope header, i.e. unix-from if line.startswith('From '): if lineno == 0: # Strip off the trailing newline mo = NLCRE_eol.search(line) if mo: line = line[:-len(mo.group(0))] self._cur.set_unixfrom(line) continue elif lineno == len(lines) - 1: # Something looking like a unix-from at the end - it's # probably the first line of the body, so push back the # line and stop. self._input.unreadline(line) return else: # Weirdly placed unix-from line. Note this as a defect # and ignore it. defect = errors.MisplacedEnvelopeHeaderDefect(line) self._cur.defects.append(defect) continue # Split the line on the colon separating field name from value. i = line.find(':') if i < 0: defect = errors.MalformedHeaderDefect(line) self._cur.defects.append(defect) continue lastheader = line[:i] lastvalue = [line[i+1:].lstrip()] # Done with all the lines, so handle the last header. if lastheader: # XXX reconsider the joining of folded lines self._cur[lastheader] = EMPTYSTRING.join(lastvalue).rstrip('\r\n') header.py 0000644 00000053343 15204103445 0006354 0 ustar 00 # Copyright (C) 2002-2006 Python Software Foundation # Author: Ben Gertzfield, Barry Warsaw # Contact: email-sig@python.org """Header encoding and decoding functionality.""" __all__ = [ 'Header', 'decode_header', 'make_header', ] import re import binascii import email.quoprimime import email.base64mime from email.errors import HeaderParseError from email.charset import Charset NL = '\n' SPACE = ' ' USPACE = u' ' SPACE8 = ' ' * 8 UEMPTYSTRING = u'' MAXLINELEN = 76 USASCII = Charset('us-ascii') UTF8 = Charset('utf-8') # Match encoded-word strings in the form =?charset?q?Hello_World?= ecre = re.compile(r''' =\? # literal =? (?P<charset>[^?]*?) # non-greedy up to the next ? is the charset \? # literal ? (?P<encoding>[qb]) # either a "q" or a "b", case insensitive \? # literal ? (?P<encoded>.*?) # non-greedy up to the next ?= is the encoded string \?= # literal ?= (?=[ \t]|$) # whitespace or the end of the string ''', re.VERBOSE | re.IGNORECASE | re.MULTILINE) # Field name regexp, including trailing colon, but not separating whitespace, # according to RFC 2822. Character range is from tilde to exclamation mark. # For use with .match() fcre = re.compile(r'[\041-\176]+:$') # Find a header embedded in a putative header value. Used to check for # header injection attack. _embeded_header = re.compile(r'\n[^ \t]+:') # Helpers _max_append = email.quoprimime._max_append def decode_header(header): """Decode a message header value without converting charset. Returns a list of (decoded_string, charset) pairs containing each of the decoded parts of the header. Charset is None for non-encoded parts of the header, otherwise a lower-case string containing the name of the character set specified in the encoded string. An email.errors.HeaderParseError may be raised when certain decoding error occurs (e.g. a base64 decoding exception). """ # If no encoding, just return the header header = str(header) if not ecre.search(header): return [(header, None)] decoded = [] dec = '' for line in header.splitlines(): # This line might not have an encoding in it if not ecre.search(line): decoded.append((line, None)) continue parts = ecre.split(line) while parts: unenc = parts.pop(0).strip() if unenc: # Should we continue a long line? if decoded and decoded[-1][1] is None: decoded[-1] = (decoded[-1][0] + SPACE + unenc, None) else: decoded.append((unenc, None)) if parts: charset, encoding = [s.lower() for s in parts[0:2]] encoded = parts[2] dec = None if encoding == 'q': dec = email.quoprimime.header_decode(encoded) elif encoding == 'b': paderr = len(encoded) % 4 # Postel's law: add missing padding if paderr: encoded += '==='[:4 - paderr] try: dec = email.base64mime.decode(encoded) except binascii.Error: # Turn this into a higher level exception. BAW: Right # now we throw the lower level exception away but # when/if we get exception chaining, we'll preserve it. raise HeaderParseError if dec is None: dec = encoded if decoded and decoded[-1][1] == charset: decoded[-1] = (decoded[-1][0] + dec, decoded[-1][1]) else: decoded.append((dec, charset)) del parts[0:3] return decoded def make_header(decoded_seq, maxlinelen=None, header_name=None, continuation_ws=' '): """Create a Header from a sequence of pairs as returned by decode_header() decode_header() takes a header value string and returns a sequence of pairs of the format (decoded_string, charset) where charset is the string name of the character set. This function takes one of those sequence of pairs and returns a Header instance. Optional maxlinelen, header_name, and continuation_ws are as in the Header constructor. """ h = Header(maxlinelen=maxlinelen, header_name=header_name, continuation_ws=continuation_ws) for s, charset in decoded_seq: # None means us-ascii but we can simply pass it on to h.append() if charset is not None and not isinstance(charset, Charset): charset = Charset(charset) h.append(s, charset) return h class Header: def __init__(self, s=None, charset=None, maxlinelen=None, header_name=None, continuation_ws=' ', errors='strict'): """Create a MIME-compliant header that can contain many character sets. Optional s is the initial header value. If None, the initial header value is not set. You can later append to the header with .append() method calls. s may be a byte string or a Unicode string, but see the .append() documentation for semantics. Optional charset serves two purposes: it has the same meaning as the charset argument to the .append() method. It also sets the default character set for all subsequent .append() calls that omit the charset argument. If charset is not provided in the constructor, the us-ascii charset is used both as s's initial charset and as the default for subsequent .append() calls. The maximum line length can be specified explicit via maxlinelen. For splitting the first line to a shorter value (to account for the field header which isn't included in s, e.g. `Subject') pass in the name of the field in header_name. The default maxlinelen is 76. continuation_ws must be RFC 2822 compliant folding whitespace (usually either a space or a hard tab) which will be prepended to continuation lines. errors is passed through to the .append() call. """ if charset is None: charset = USASCII if not isinstance(charset, Charset): charset = Charset(charset) self._charset = charset self._continuation_ws = continuation_ws cws_expanded_len = len(continuation_ws.replace('\t', SPACE8)) # BAW: I believe `chunks' and `maxlinelen' should be non-public. self._chunks = [] if s is not None: self.append(s, charset, errors) if maxlinelen is None: maxlinelen = MAXLINELEN if header_name is None: # We don't know anything about the field header so the first line # is the same length as subsequent lines. self._firstlinelen = maxlinelen else: # The first line should be shorter to take into account the field # header. Also subtract off 2 extra for the colon and space. self._firstlinelen = maxlinelen - len(header_name) - 2 # Second and subsequent lines should subtract off the length in # columns of the continuation whitespace prefix. self._maxlinelen = maxlinelen - cws_expanded_len def __str__(self): """A synonym for self.encode().""" return self.encode() def __unicode__(self): """Helper for the built-in unicode function.""" uchunks = [] lastcs = None for s, charset in self._chunks: # We must preserve spaces between encoded and non-encoded word # boundaries, which means for us we need to add a space when we go # from a charset to None/us-ascii, or from None/us-ascii to a # charset. Only do this for the second and subsequent chunks. nextcs = charset if uchunks: if lastcs not in (None, 'us-ascii'): if nextcs in (None, 'us-ascii'): uchunks.append(USPACE) nextcs = None elif nextcs not in (None, 'us-ascii'): uchunks.append(USPACE) lastcs = nextcs uchunks.append(unicode(s, str(charset))) return UEMPTYSTRING.join(uchunks) # Rich comparison operators for equality only. BAW: does it make sense to # have or explicitly disable <, <=, >, >= operators? def __eq__(self, other): # other may be a Header or a string. Both are fine so coerce # ourselves to a string, swap the args and do another comparison. return other == self.encode() def __ne__(self, other): return not self == other def append(self, s, charset=None, errors='strict'): """Append a string to the MIME header. Optional charset, if given, should be a Charset instance or the name of a character set (which will be converted to a Charset instance). A value of None (the default) means that the charset given in the constructor is used. s may be a byte string or a Unicode string. If it is a byte string (i.e. isinstance(s, str) is true), then charset is the encoding of that byte string, and a UnicodeError will be raised if the string cannot be decoded with that charset. If s is a Unicode string, then charset is a hint specifying the character set of the characters in the string. In this case, when producing an RFC 2822 compliant header using RFC 2047 rules, the Unicode string will be encoded using the following charsets in order: us-ascii, the charset hint, utf-8. The first character set not to provoke a UnicodeError is used. Optional `errors' is passed as the third argument to any unicode() or ustr.encode() call. """ if charset is None: charset = self._charset elif not isinstance(charset, Charset): charset = Charset(charset) # If the charset is our faux 8bit charset, leave the string unchanged if charset != '8bit': # We need to test that the string can be converted to unicode and # back to a byte string, given the input and output codecs of the # charset. if isinstance(s, str): # Possibly raise UnicodeError if the byte string can't be # converted to a unicode with the input codec of the charset. incodec = charset.input_codec or 'us-ascii' ustr = unicode(s, incodec, errors) # Now make sure that the unicode could be converted back to a # byte string with the output codec, which may be different # than the iput coded. Still, use the original byte string. outcodec = charset.output_codec or 'us-ascii' ustr.encode(outcodec, errors) elif isinstance(s, unicode): # Now we have to be sure the unicode string can be converted # to a byte string with a reasonable output codec. We want to # use the byte string in the chunk. for charset in USASCII, charset, UTF8: try: outcodec = charset.output_codec or 'us-ascii' s = s.encode(outcodec, errors) break except UnicodeError: pass else: assert False, 'utf-8 conversion failed' self._chunks.append((s, charset)) def _split(self, s, charset, maxlinelen, splitchars): # Split up a header safely for use with encode_chunks. splittable = charset.to_splittable(s) encoded = charset.from_splittable(splittable, True) elen = charset.encoded_header_len(encoded) # If the line's encoded length first, just return it if elen <= maxlinelen: return [(encoded, charset)] # If we have undetermined raw 8bit characters sitting in a byte # string, we really don't know what the right thing to do is. We # can't really split it because it might be multibyte data which we # could break if we split it between pairs. The least harm seems to # be to not split the header at all, but that means they could go out # longer than maxlinelen. if charset == '8bit': return [(s, charset)] # BAW: I'm not sure what the right test here is. What we're trying to # do is be faithful to RFC 2822's recommendation that ($2.2.3): # # "Note: Though structured field bodies are defined in such a way that # folding can take place between many of the lexical tokens (and even # within some of the lexical tokens), folding SHOULD be limited to # placing the CRLF at higher-level syntactic breaks." # # For now, I can only imagine doing this when the charset is us-ascii, # although it's possible that other charsets may also benefit from the # higher-level syntactic breaks. elif charset == 'us-ascii': return self._split_ascii(s, charset, maxlinelen, splitchars) # BAW: should we use encoded? elif elen == len(s): # We can split on _maxlinelen boundaries because we know that the # encoding won't change the size of the string splitpnt = maxlinelen first = charset.from_splittable(splittable[:splitpnt], False) last = charset.from_splittable(splittable[splitpnt:], False) else: # Binary search for split point first, last = _binsplit(splittable, charset, maxlinelen) # first is of the proper length so just wrap it in the appropriate # chrome. last must be recursively split. fsplittable = charset.to_splittable(first) fencoded = charset.from_splittable(fsplittable, True) chunk = [(fencoded, charset)] return chunk + self._split(last, charset, self._maxlinelen, splitchars) def _split_ascii(self, s, charset, firstlen, splitchars): chunks = _split_ascii(s, firstlen, self._maxlinelen, self._continuation_ws, splitchars) return zip(chunks, [charset]*len(chunks)) def _encode_chunks(self, newchunks, maxlinelen): # MIME-encode a header with many different charsets and/or encodings. # # Given a list of pairs (string, charset), return a MIME-encoded # string suitable for use in a header field. Each pair may have # different charsets and/or encodings, and the resulting header will # accurately reflect each setting. # # Each encoding can be email.utils.QP (quoted-printable, for # ASCII-like character sets like iso-8859-1), email.utils.BASE64 # (Base64, for non-ASCII like character sets like KOI8-R and # iso-2022-jp), or None (no encoding). # # Each pair will be represented on a separate line; the resulting # string will be in the format: # # =?charset1?q?Mar=EDa_Gonz=E1lez_Alonso?=\n # =?charset2?b?SvxyZ2VuIEL2aW5n?=" chunks = [] for header, charset in newchunks: if not header: continue if charset is None or charset.header_encoding is None: s = header else: s = charset.header_encode(header) # Don't add more folding whitespace than necessary if chunks and chunks[-1].endswith(' '): extra = '' else: extra = ' ' _max_append(chunks, s, maxlinelen, extra) joiner = NL + self._continuation_ws return joiner.join(chunks) def encode(self, splitchars=';, '): """Encode a message header into an RFC-compliant format. There are many issues involved in converting a given string for use in an email header. Only certain character sets are readable in most email clients, and as header strings can only contain a subset of 7-bit ASCII, care must be taken to properly convert and encode (with Base64 or quoted-printable) header strings. In addition, there is a 75-character length limit on any given encoded header field, so line-wrapping must be performed, even with double-byte character sets. This method will do its best to convert the string to the correct character set used in email, and encode and line wrap it safely with the appropriate scheme for that character set. If the given charset is not known or an error occurs during conversion, this function will return the header untouched. Optional splitchars is a string containing characters to split long ASCII lines on, in rough support of RFC 2822's `highest level syntactic breaks'. This doesn't affect RFC 2047 encoded lines. """ newchunks = [] maxlinelen = self._firstlinelen lastlen = 0 for s, charset in self._chunks: # The first bit of the next chunk should be just long enough to # fill the next line. Don't forget the space separating the # encoded words. targetlen = maxlinelen - lastlen - 1 if targetlen < charset.encoded_header_len(''): # Stick it on the next line targetlen = maxlinelen newchunks += self._split(s, charset, targetlen, splitchars) lastchunk, lastcharset = newchunks[-1] lastlen = lastcharset.encoded_header_len(lastchunk) value = self._encode_chunks(newchunks, maxlinelen) if _embeded_header.search(value): raise HeaderParseError("header value appears to contain " "an embedded header: {!r}".format(value)) return value def _split_ascii(s, firstlen, restlen, continuation_ws, splitchars): lines = [] maxlen = firstlen for line in s.splitlines(): # Ignore any leading whitespace (i.e. continuation whitespace) already # on the line, since we'll be adding our own. line = line.lstrip() if len(line) < maxlen: lines.append(line) maxlen = restlen continue # Attempt to split the line at the highest-level syntactic break # possible. Note that we don't have a lot of smarts about field # syntax; we just try to break on semi-colons, then commas, then # whitespace. for ch in splitchars: if ch in line: break else: # There's nothing useful to split the line on, not even spaces, so # just append this line unchanged lines.append(line) maxlen = restlen continue # Now split the line on the character plus trailing whitespace cre = re.compile(r'%s\s*' % ch) if ch in ';,': eol = ch else: eol = '' joiner = eol + ' ' joinlen = len(joiner) wslen = len(continuation_ws.replace('\t', SPACE8)) this = [] linelen = 0 for part in cre.split(line): curlen = linelen + max(0, len(this)-1) * joinlen partlen = len(part) onfirstline = not lines # We don't want to split after the field name, if we're on the # first line and the field name is present in the header string. if ch == ' ' and onfirstline and \ len(this) == 1 and fcre.match(this[0]): this.append(part) linelen += partlen elif curlen + partlen > maxlen: if this: lines.append(joiner.join(this) + eol) # If this part is longer than maxlen and we aren't already # splitting on whitespace, try to recursively split this line # on whitespace. if partlen > maxlen and ch != ' ': subl = _split_ascii(part, maxlen, restlen, continuation_ws, ' ') lines.extend(subl[:-1]) this = [subl[-1]] else: this = [part] linelen = wslen + len(this[-1]) maxlen = restlen else: this.append(part) linelen += partlen # Put any left over parts on a line by themselves if this: lines.append(joiner.join(this)) return lines def _binsplit(splittable, charset, maxlinelen): i = 0 j = len(splittable) while i < j: # Invariants: # 1. splittable[:k] fits for all k <= i (note that we *assume*, # at the start, that splittable[:0] fits). # 2. splittable[:k] does not fit for any k > j (at the start, # this means we shouldn't look at any k > len(splittable)). # 3. We don't know about splittable[:k] for k in i+1..j. # 4. We want to set i to the largest k that fits, with i <= k <= j. # m = (i+j+1) >> 1 # ceiling((i+j)/2); i < m <= j chunk = charset.from_splittable(splittable[:m], True) chunklen = charset.encoded_header_len(chunk) if chunklen <= maxlinelen: # m is acceptable, so is a new lower bound. i = m else: # m is not acceptable, so final i must be < m. j = m - 1 # i == j. Invariant #1 implies that splittable[:i] fits, and # invariant #2 implies that splittable[:i+1] does not fit, so i # is what we're looking for. first = charset.from_splittable(splittable[:i], False) last = charset.from_splittable(splittable[i:], False) return first, last parser.py 0000644 00000006343 15204103445 0006416 0 ustar 00 # Copyright (C) 2001-2006 Python Software Foundation # Author: Barry Warsaw, Thomas Wouters, Anthony Baxter # Contact: email-sig@python.org """A parser of RFC 2822 and MIME email messages.""" __all__ = ['Parser', 'HeaderParser'] import warnings from cStringIO import StringIO from email.feedparser import FeedParser from email.message import Message class Parser: def __init__(self, *args, **kws): """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 preceded 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. """ if len(args) >= 1: if '_class' in kws: raise TypeError("Multiple values for keyword arg '_class'") kws['_class'] = args[0] if len(args) == 2: if 'strict' in kws: raise TypeError("Multiple values for keyword arg 'strict'") kws['strict'] = args[1] if len(args) > 2: raise TypeError('Too many arguments') if '_class' in kws: self._class = kws['_class'] del kws['_class'] else: self._class = Message if 'strict' in kws: warnings.warn("'strict' argument is deprecated (and ignored)", DeprecationWarning, 2) del kws['strict'] if kws: raise TypeError('Unexpected keyword arguments') 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) 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) contentmanager.py 0000644 00000024713 15204103445 0010130 0 ustar 00 import binascii import email.charset import email.message import email.errors from email import quoprimime class ContentManager: def __init__(self): self.get_handlers = {} self.set_handlers = {} def add_get_handler(self, key, handler): self.get_handlers[key] = handler def get_content(self, msg, *args, **kw): content_type = msg.get_content_type() if content_type in self.get_handlers: return self.get_handlers[content_type](msg, *args, **kw) maintype = msg.get_content_maintype() if maintype in self.get_handlers: return self.get_handlers[maintype](msg, *args, **kw) if '' in self.get_handlers: return self.get_handlers[''](msg, *args, **kw) raise KeyError(content_type) def add_set_handler(self, typekey, handler): self.set_handlers[typekey] = handler def set_content(self, msg, obj, *args, **kw): if msg.get_content_maintype() == 'multipart': # XXX: is this error a good idea or not? We can remove it later, # but we can't add it later, so do it for now. raise TypeError("set_content not valid on multipart") handler = self._find_set_handler(msg, obj) msg.clear_content() handler(msg, obj, *args, **kw) def _find_set_handler(self, msg, obj): full_path_for_error = None for typ in type(obj).__mro__: if typ in self.set_handlers: return self.set_handlers[typ] qname = typ.__qualname__ modname = getattr(typ, '__module__', '') full_path = '.'.join((modname, qname)) if modname else qname if full_path_for_error is None: full_path_for_error = full_path if full_path in self.set_handlers: return self.set_handlers[full_path] if qname in self.set_handlers: return self.set_handlers[qname] name = typ.__name__ if name in self.set_handlers: return self.set_handlers[name] if None in self.set_handlers: return self.set_handlers[None] raise KeyError(full_path_for_error) raw_data_manager = ContentManager() def get_text_content(msg, errors='replace'): content = msg.get_payload(decode=True) charset = msg.get_param('charset', 'ASCII') return content.decode(charset, errors=errors) raw_data_manager.add_get_handler('text', get_text_content) def get_non_text_content(msg): return msg.get_payload(decode=True) for maintype in 'audio image video application'.split(): raw_data_manager.add_get_handler(maintype, get_non_text_content) def get_message_content(msg): return msg.get_payload(0) for subtype in 'rfc822 external-body'.split(): raw_data_manager.add_get_handler('message/'+subtype, get_message_content) def get_and_fixup_unknown_message_content(msg): # If we don't understand a message subtype, we are supposed to treat it as # if it were application/octet-stream, per # tools.ietf.org/html/rfc2046#section-5.2.4. Feedparser doesn't do that, # so do our best to fix things up. Note that it is *not* appropriate to # model message/partial content as Message objects, so they are handled # here as well. (How to reassemble them is out of scope for this comment :) return bytes(msg.get_payload(0)) raw_data_manager.add_get_handler('message', get_and_fixup_unknown_message_content) def _prepare_set(msg, maintype, subtype, headers): msg['Content-Type'] = '/'.join((maintype, subtype)) if headers: if not hasattr(headers[0], 'name'): mp = msg.policy headers = [mp.header_factory(*mp.header_source_parse([header])) for header in headers] try: for header in headers: if header.defects: raise header.defects[0] msg[header.name] = header except email.errors.HeaderDefect as exc: raise ValueError("Invalid header: {}".format( header.fold(policy=msg.policy))) from exc def _finalize_set(msg, disposition, filename, cid, params): if disposition is None and filename is not None: disposition = 'attachment' if disposition is not None: msg['Content-Disposition'] = disposition if filename is not None: msg.set_param('filename', filename, header='Content-Disposition', replace=True) if cid is not None: msg['Content-ID'] = cid if params is not None: for key, value in params.items(): msg.set_param(key, value) # XXX: This is a cleaned-up version of base64mime.body_encode (including a bug # fix in the calculation of unencoded_bytes_per_line). It would be nice to # drop both this and quoprimime.body_encode in favor of enhanced binascii # routines that accepted a max_line_length parameter. def _encode_base64(data, max_line_length): encoded_lines = [] unencoded_bytes_per_line = max_line_length // 4 * 3 for i in range(0, len(data), unencoded_bytes_per_line): thisline = data[i:i+unencoded_bytes_per_line] encoded_lines.append(binascii.b2a_base64(thisline).decode('ascii')) return ''.join(encoded_lines) def _encode_text(string, charset, cte, policy): lines = string.encode(charset).splitlines() linesep = policy.linesep.encode('ascii') def embedded_body(lines): return linesep.join(lines) + linesep def normal_body(lines): return b'\n'.join(lines) + b'\n' if cte==None: # Use heuristics to decide on the "best" encoding. if max((len(x) for x in lines), default=0) <= policy.max_line_length: try: return '7bit', normal_body(lines).decode('ascii') except UnicodeDecodeError: pass if policy.cte_type == '8bit': return '8bit', normal_body(lines).decode('ascii', 'surrogateescape') sniff = embedded_body(lines[:10]) sniff_qp = quoprimime.body_encode(sniff.decode('latin-1'), policy.max_line_length) sniff_base64 = binascii.b2a_base64(sniff) # This is a little unfair to qp; it includes lineseps, base64 doesn't. if len(sniff_qp) > len(sniff_base64): cte = 'base64' else: cte = 'quoted-printable' if len(lines) <= 10: return cte, sniff_qp if cte == '7bit': data = normal_body(lines).decode('ascii') elif cte == '8bit': data = normal_body(lines).decode('ascii', 'surrogateescape') elif cte == 'quoted-printable': data = quoprimime.body_encode(normal_body(lines).decode('latin-1'), policy.max_line_length) elif cte == 'base64': data = _encode_base64(embedded_body(lines), policy.max_line_length) else: raise ValueError("Unknown content transfer encoding {}".format(cte)) return cte, data def set_text_content(msg, string, subtype="plain", charset='utf-8', cte=None, disposition=None, filename=None, cid=None, params=None, headers=None): _prepare_set(msg, 'text', subtype, headers) cte, payload = _encode_text(string, charset, cte, msg.policy) msg.set_payload(payload) msg.set_param('charset', email.charset.ALIASES.get(charset, charset), replace=True) msg['Content-Transfer-Encoding'] = cte _finalize_set(msg, disposition, filename, cid, params) raw_data_manager.add_set_handler(str, set_text_content) def set_message_content(msg, message, subtype="rfc822", cte=None, disposition=None, filename=None, cid=None, params=None, headers=None): if subtype == 'partial': raise ValueError("message/partial is not supported for Message objects") if subtype == 'rfc822': if cte not in (None, '7bit', '8bit', 'binary'): # http://tools.ietf.org/html/rfc2046#section-5.2.1 mandate. raise ValueError( "message/rfc822 parts do not support cte={}".format(cte)) # 8bit will get coerced on serialization if policy.cte_type='7bit'. We # may end up claiming 8bit when it isn't needed, but the only negative # result of that should be a gateway that needs to coerce to 7bit # having to look through the whole embedded message to discover whether # or not it actually has to do anything. cte = '8bit' if cte is None else cte elif subtype == 'external-body': if cte not in (None, '7bit'): # http://tools.ietf.org/html/rfc2046#section-5.2.3 mandate. raise ValueError( "message/external-body parts do not support cte={}".format(cte)) cte = '7bit' elif cte is None: # http://tools.ietf.org/html/rfc2046#section-5.2.4 says all future # subtypes should be restricted to 7bit, so assume that. cte = '7bit' _prepare_set(msg, 'message', subtype, headers) msg.set_payload([message]) msg['Content-Transfer-Encoding'] = cte _finalize_set(msg, disposition, filename, cid, params) raw_data_manager.add_set_handler(email.message.Message, set_message_content) def set_bytes_content(msg, data, maintype, subtype, cte='base64', disposition=None, filename=None, cid=None, params=None, headers=None): _prepare_set(msg, maintype, subtype, headers) if cte == 'base64': data = _encode_base64(data, max_line_length=msg.policy.max_line_length) elif cte == 'quoted-printable': # XXX: quoprimime.body_encode won't encode newline characters in data, # so we can't use it. This means max_line_length is ignored. Another # bug to fix later. (Note: encoders.quopri is broken on line ends.) data = binascii.b2a_qp(data, istext=False, header=False, quotetabs=True) data = data.decode('ascii') elif cte == '7bit': # Make sure it really is only ASCII. The early warning here seems # worth the overhead...if you care write your own content manager :). data.encode('ascii') elif cte in ('8bit', 'binary'): data = data.decode('ascii', 'surrogateescape') msg.set_payload(data) msg['Content-Transfer-Encoding'] = cte _finalize_set(msg, disposition, filename, cid, params) for typ in (bytes, bytearray, memoryview): raw_data_manager.add_set_handler(typ, set_bytes_content) encoders.pyo 0000644 00000004270 15204114625 0007102 0 ustar 00 � { fc @ sn d Z d d d d g Z d d l Z d d l m Z d � Z d � Z d � Z d � Z d � Z d � Z d S( s Encodings and related functions.t encode_7or8bitt encode_base64t encode_noopt encode_quoprii����N( t encodestringc C s" t | d t �} | j d d � S( Nt quotetabst s =20( t _encodestringt Truet replace( t st enc( ( s& /usr/lib64/python2.7/email/encoders.pyt _qencode s c C sL | s | S| d d k } t j | � } | rH | d d k rH | d S| S( Ni����s ( t base64R ( R t hasnewlinet value( ( s& /usr/lib64/python2.7/email/encoders.pyt _bencode s c C s3 | j � } t | � } | j | � d | d <d S( sl Encode the message's payload in Base64. Also, add an appropriate Content-Transfer-Encoding header. R s Content-Transfer-EncodingN( t get_payloadR t set_payload( t msgt origt encdata( ( s& /usr/lib64/python2.7/email/encoders.pyR ' s c C s3 | j � } t | � } | j | � d | d <d S( sv Encode the message's payload in quoted-printable. Also, add an appropriate Content-Transfer-Encoding header. s quoted-printables Content-Transfer-EncodingN( R R R ( R R R ( ( s& /usr/lib64/python2.7/email/encoders.pyR 3 s c C sc | j � } | d k r& d | d <d Sy | j d � Wn t k rT d | d <n Xd | d <d S( s9 Set the Content-Transfer-Encoding header to 7bit or 8bit.t 7bits Content-Transfer-EncodingNt asciit 8bit( R t Nonet encodet UnicodeError( R R ( ( s& /usr/lib64/python2.7/email/encoders.pyR ? s c C s d S( s Do nothing.N( ( R ( ( s& /usr/lib64/python2.7/email/encoders.pyR Q t ( t __doc__t __all__R t quopriR R R R R R R R ( ( ( s& /usr/lib64/python2.7/email/encoders.pyt <module> s header.pyc 0000644 00000032536 15204114625 0006522 0 ustar 00 � { fc @ s6 d Z d d d g Z d d l Z d d l Z d d l Z d d l Z d d l m Z d d l m Z d Z d Z d Z d d Z d Z d Z e d � Z e d � Z e j d e j e j Be j B� Z e j d � Z e j d � Z e j j Z d � Z e e d d � Z d f d � � YZ d � Z d � Z! d S( s+ Header encoding and decoding functionality.t Headert decode_headert make_headeri����N( t HeaderParseError( t Charsets t u i u iL s us-asciis utf-8s� =\? # literal =? (?P<charset>[^?]*?) # non-greedy up to the next ? is the charset \? # literal ? (?P<encoding>[qb]) # either a "q" or a "b", case insensitive \? # literal ? (?P<encoded>.*?) # non-greedy up to the next ?= is the encoded string \?= # literal ?= (?=[ \t]|$) # whitespace or the end of the string s [\041-\176]+:$s \n[^ \t]+:c C sG t | � } t j | � s( | d f g Sg } d } x | j � D]�} t j | � so | j | d f � qA n t j | � } x�| r>| j d � j � } | r� | r� | d d d k r� | d d t | d f | d <q� | j | d f � n | r1g | d d !D] } | j � ^ q \ } } | d } d } | d k rXt j j | � } nm | d k r�t | � d } | r�| d d | 7} n y t j j | � } Wq�t j k r�t � q�Xn | d k r�| } n | r| d d | k r| d d | | d d f | d <q1| j | | f � n | d d 5q� WqA W| S( s� Decode a message header value without converting charset. Returns a list of (decoded_string, charset) pairs containing each of the decoded parts of the header. Charset is None for non-encoded parts of the header, otherwise a lower-case string containing the name of the character set specified in the encoded string. An email.errors.HeaderParseError may be raised when certain decoding error occurs (e.g. a base64 decoding exception). t i i����i i t qt bi s ===i N( t strt ecret searcht Nonet splitlinest appendt splitt popt stript SPACEt lowert emailt quoprimimet header_decodet lent base64mimet decodet binasciit ErrorR ( t headert decodedt dect linet partst unenct st charsett encodingt encodedt paderr( ( s$ /usr/lib64/python2.7/email/header.pyR = sJ #, 'c C sq t d | d | d | � } xO | D]G \ } } | d k rY t | t � rY t | � } n | j | | � q" W| S( s� Create a Header from a sequence of pairs as returned by decode_header() decode_header() takes a header value string and returns a sequence of pairs of the format (decoded_string, charset) where charset is the string name of the character set. This function takes one of those sequence of pairs and returns a Header instance. Optional maxlinelen, header_name, and continuation_ws are as in the Header constructor. t maxlinelent header_namet continuation_wsN( R R t isinstanceR R ( t decoded_seqR' R( R) t hR" R# ( ( s$ /usr/lib64/python2.7/email/header.pyR y s c B s} e Z d d d d d d d � Z d � Z d � Z d � Z d � Z d d d � Z d � Z d � Z d � Z d d � Z RS( R t strictc C s� | d k r t } n t | t � s3 t | � } n | | _ | | _ t | j d t � � } g | _ | d k r� | j | | | � n | d k r� t } n | d k r� | | _ n | t | � d | _ | | | _ d S( s Create a MIME-compliant header that can contain many character sets. Optional s is the initial header value. If None, the initial header value is not set. You can later append to the header with .append() method calls. s may be a byte string or a Unicode string, but see the .append() documentation for semantics. Optional charset serves two purposes: it has the same meaning as the charset argument to the .append() method. It also sets the default character set for all subsequent .append() calls that omit the charset argument. If charset is not provided in the constructor, the us-ascii charset is used both as s's initial charset and as the default for subsequent .append() calls. The maximum line length can be specified explicit via maxlinelen. For splitting the first line to a shorter value (to account for the field header which isn't included in s, e.g. `Subject') pass in the name of the field in header_name. The default maxlinelen is 76. continuation_ws must be RFC 2822 compliant folding whitespace (usually either a space or a hard tab) which will be prepended to continuation lines. errors is passed through to the .append() call. s i N( R t USASCIIR* R t _charsett _continuation_wsR t replacet SPACE8t _chunksR t MAXLINELENt _firstlinelent _maxlinelen( t selfR" R# R' R( R) t errorst cws_expanded_len( ( s$ /usr/lib64/python2.7/email/header.pyt __init__� s c C s | j � S( s A synonym for self.encode().( t encode( R7 ( ( s$ /usr/lib64/python2.7/email/header.pyt __str__� s c C s� g } d } x� | j D]� \ } } | } | r~ | d k r_ | d k r{ | j t � d } q{ q~ | d k r~ | j t � q~ n | } | j t | t | � � � q Wt j | � S( s) Helper for the built-in unicode function.s us-asciiN( Ns us-ascii( Ns us-ascii( Ns us-ascii( R R3 R t USPACEt unicodeR t UEMPTYSTRINGt join( R7 t uchunkst lastcsR" R# t nextcs( ( s$ /usr/lib64/python2.7/email/header.pyt __unicode__� s c C s | | j � k S( N( R; ( R7 t other( ( s$ /usr/lib64/python2.7/email/header.pyt __eq__� s c C s | | k S( N( ( R7 RE ( ( s$ /usr/lib64/python2.7/email/header.pyt __ne__� s c C s) | d k r | j } n t | t � s6 t | � } n | d k rt | t � r� | j p] d } t | | | � } | j p~ d } | j | | � qt | t � rxf t | t f D]@ } y& | j p� d } | j | | � } PWq� t k r� q� Xq� Wt s t d � � qn | j j | | f � d S( s> Append a string to the MIME header. Optional charset, if given, should be a Charset instance or the name of a character set (which will be converted to a Charset instance). A value of None (the default) means that the charset given in the constructor is used. s may be a byte string or a Unicode string. If it is a byte string (i.e. isinstance(s, str) is true), then charset is the encoding of that byte string, and a UnicodeError will be raised if the string cannot be decoded with that charset. If s is a Unicode string, then charset is a hint specifying the character set of the characters in the string. In this case, when producing an RFC 2822 compliant header using RFC 2047 rules, the Unicode string will be encoded using the following charsets in order: us-ascii, the charset hint, utf-8. The first character set not to provoke a UnicodeError is used. Optional `errors' is passed as the third argument to any unicode() or ustr.encode() call. t 8bits us-asciis utf-8 conversion failedN( R R/ R* R R t input_codecR> t output_codecR; R. t UTF8t UnicodeErrort Falset AssertionErrorR3 R ( R7 R" R# R8 t incodect ustrt outcodec( ( s$ /usr/lib64/python2.7/email/header.pyR � s( c C s0 | j | � } | j | t � } | j | � } | | k rI | | f g S| d k rb | | f g S| d k r� | j | | | | � S| t | � k r� | } | j | | t � } | j | | t � } n t | | | � \ } } | j | � } | j | t � } | | f g } | | j | | | j | � S( NRH s us-ascii( t to_splittablet from_splittablet Truet encoded_header_lent _split_asciiR RM t _binsplitt _splitR6 ( R7 R" R# R' t splitcharst splittableR% t elent splitpntt firstt lastt fsplittablet fencodedt chunk( ( s$ /usr/lib64/python2.7/email/header.pyRX s$ c C s8 t | | | j | j | � } t | | g t | � � S( N( RV R6 R0 t zipR ( R7 R" R# t firstlenRY t chunks( ( s$ /usr/lib64/python2.7/email/header.pyRV N s c C s� g } x� | D]� \ } } | s% q n | d k s@ | j d k rI | } n | j | � } | rz | d j d � rz d } n d } t | | | | � q Wt | j } | j | � S( Ni����R R ( R t header_encodingt header_encodet endswitht _max_appendt NLR0 R@ ( R7 t newchunksR' Rd R R# R" t extrat joiner( ( s$ /usr/lib64/python2.7/email/header.pyt _encode_chunksS s s ;, c C s� g } | j } d } x~ | j D]s \ } } | | d } | | j d � k rW | } n | | j | | | | � 7} | d \ } } | j | � } q W| j | | � } t j | � r� t d j | � � � n | S( s� Encode a message header into an RFC-compliant format. There are many issues involved in converting a given string for use in an email header. Only certain character sets are readable in most email clients, and as header strings can only contain a subset of 7-bit ASCII, care must be taken to properly convert and encode (with Base64 or quoted-printable) header strings. In addition, there is a 75-character length limit on any given encoded header field, so line-wrapping must be performed, even with double-byte character sets. This method will do its best to convert the string to the correct character set used in email, and encode and line wrap it safely with the appropriate scheme for that character set. If the given charset is not known or an error occurs during conversion, this function will return the header untouched. Optional splitchars is a string containing characters to split long ASCII lines on, in rough support of RFC 2822's `highest level syntactic breaks'. This doesn't affect RFC 2047 encoded lines. i i R i����s8 header value appears to contain an embedded header: {!r}( R5 R3 RU RX Rm t _embeded_headerR R t format( R7 RY Rj R' t lastlenR" R# t targetlent lastchunkt lastcharsett value( ( s$ /usr/lib64/python2.7/email/header.pyR; v s N( t __name__t __module__R R: R< RD RF RG R RX RV Rm R; ( ( ( s$ /usr/lib64/python2.7/email/header.pyR � s 3 7 . #c C s| g } | } xi| j � D][} | j � } t | � | k rV | j | � | } q n x4 | D] } | | k r] Pq] q] W| j | � | } q t j d | � } | d k r� | } n d } | d } t | � } t | j d t � � } g } d } x]| j | � D]L} | t d t | � d � | } t | � } | } | d k r�| r�t | � d k r�t j | d � r�| j | � | | 7} q| | | k r:| r�| j | j | � | � n | | k r| d k rt | | | | d � } | j | d � | d g } n | g } | t | d � } | } q| j | � | | 7} qW| r | j | j | � � q q W| S( Ns %s\s*s ;,R R s i i i����( R t lstripR R t ret compileR1 R2 R t maxt fcret matchR@ RV t extend( R" Rc t restlenR) RY t linest maxlenR t cht cret eolRl t joinlent wslent thist linelent partt curlent partlent onfirstlinet subl( ( s$ /usr/lib64/python2.7/email/header.pyRV � s^ ! % c C s� d } t | � } xf | | k rz | | d d ?} | j | | t � } | j | � } | | k rm | } q | d } q W| j | | t � } | j | | t � } | | f S( Ni i ( R RS RT RU RM ( RZ R# R' t it jt mRa t chunklenR] R^ ( ( s$ /usr/lib64/python2.7/email/header.pyRW � s (" t __doc__t __all__Rx R t email.quoprimimeR t email.base64mimet email.errorsR t email.charsetR Ri R R= R2 R? R4 R. RK Ry t VERBOSEt IGNORECASEt MULTILINER R{ Rn R Rh R R R R RV RW ( ( ( s$ /usr/lib64/python2.7/email/header.pyt <module> s: < � F base64mime.pyo 0000644 00000012313 15204114626 0007232 0 ustar 00 � { fc @ s� d Z d d d d d d d d g Z d d l m Z m Z d d l m Z d Z d Z d Z d Z d � Z d e d e d � Z e d e d � Z e Z e Z d d � Z e Z e Z d S( s� Base64 content transfer encoding per RFCs 2045-2047. This module handles the content transfer encoding method defined in RFC 2045 to encode arbitrary 8-bit data using the three 8-bit bytes in four 7-bit characters encoding known as Base64. It is used in the MIME standards for email to attach images, audio, and text using some 8-bit character sets to messages. This module provides an interface to encode and decode both headers and bodies with Base64 encoding. RFC 2045 defines a method for including character set information in an `encoded-word' in a header. This method is commonly used for 8-bit real names in To:, From:, Cc:, etc. fields, as well as Subject: lines. This module does not do the line wrapping or end-of-line character conversion necessary for proper internationalized headers; it only does dumb encoding and decoding. To deal with the various line wrapping issues, use the email.header module. t base64_lent body_decodet body_encodet decodet decodestringt encodet encodestringt header_encodei����( t b2a_base64t a2b_base64( t fix_eolss s t i c C s< t t | � d � \ } } | d } | r8 | d 7} n | S( s6 Return the length of s when it is encoded with base64.i i ( t divmodt len( t st groups_of_3t leftovert n( ( s( /usr/lib64/python2.7/email/base64mime.pyR 4 s s iso-8859-1iL c C s� | s | S| s t | � } n g } | t | � t } | d d } x> t d t | � | � D]$ } | j t | | | | !� � q` Wg } xA | D]9 } | j t � r� | d } n | j d | | f � q� W| d } | j | � S( s0 Encode a single header line with Base64 encoding in a given charset. Defined in RFC 2045, this Base64 encoding is identical to normal Base64 encoding, except that each line must be intelligently wrapped (respecting the Base64 encoding), and subsequent lines must start with a space. charset names the character set to use to encode the header. It defaults to iso-8859-1. End-of-line characters (\r, \n, \r\n) will be automatically converted to the canonical email line separator \r\n unless the keep_eols parameter is True (the default is False). Each line of the header will be terminated in the value of eol, which defaults to "\n". Set this to "\r\n" if you are using the result of this function directly in email. The resulting string will be in the form: "=?charset?b?WW/5ciBtYXp66XLrIHf8eiBhIGhhbXBzdGHuciBBIFlv+XIgbWF6euly?=\n =?charset?b?6yB3/HogYSBoYW1wc3Rh7nIgQkMgWW/5ciBtYXp66XLrIHf8eiBhIGhh?=" with each line wrapped at, at most, maxlinelen characters (defaults to 76 characters). i i i i����s =?%s?b?%s?=t ( R R t MISC_LENt ranget appendR t endswitht NLt join( t headert charsett keep_eolst maxlinelent eolt base64edt max_encodedt max_unencodedt it linest linet joiner( ( s( /usr/lib64/python2.7/email/base64mime.pyR @ s " c C s� | s | S| s t | � } n g } | d d } xp t d t | � | � D]V } t | | | | !� } | j t � r� | t k r� | d | } n | j | � qL Wt j | � S( s� Encode a string with base64. Each line will be wrapped at, at most, maxlinelen characters (defaults to 76 characters). If binary is False, end-of-line characters will be converted to the canonical email end-of-line sequence \r\n. Otherwise they will be left verbatim (this is the default). Each line of encoded text will end with eol, which defaults to "\n". Set this to "\r\n" if you will be using the result of this function directly in an email. i i i i����( R R R R R R R t EMPTYSTRINGR ( R t binaryR R t encvecR R! t enc( ( s( /usr/lib64/python2.7/email/base64mime.pyR z s c C s0 | s | St | � } | r, | j t | � S| S( s� Decode a raw base64 string. If convert_eols is set to a string value, all canonical email linefeeds, e.g. "\r\n", in the decoded text will be converted to the value of convert_eols. os.linesep is a good choice for convert_eols if you are decoding a text attachment. This function does not parse a full MIME header value encoded with base64 (like =?iso-8859-1?b?bmloISBuaWgh?=) -- please use the high level email.header class for that functionality. ( R t replacet CRLF( R t convert_eolst dec( ( s( /usr/lib64/python2.7/email/base64mime.pyR � s N( t __doc__t __all__t binasciiR R t email.utilsR R* R R% R R t FalseR t TrueR R R t NoneR R R ( ( ( s( /usr/lib64/python2.7/email/base64mime.pyt <module> s. 9! charset.pyo 0000644 00000032266 15204114626 0006740 0 ustar 00 � { fc @ s� d d d d g Z d d l Z d d l Z d d l Z d d l m Z d d l m Z d Z d Z d Z d Z d Z i e e d f d 6e e d f d 6e e d f d 6e e d f d 6e e d f d 6e e d f d 6e e d f d 6e e d f d 6e e d f d 6e e d f d 6e e d f d 6e e d f d 6dA d 6e e d f d 6e e d f d 6e d d f d 6e d d f d 6e d d f d 6e e d f d 6e e d f d 6d e d f d 6Z i d d! 6d d" 6d d# 6d d$ 6d d% 6d d& 6d d' 6d d( 6d d) 6d d* 6d d+ 6d d, 6d d- 6d d. 6d d/ 6d d0 6d d1 6d d2 6d d3 6d d4 6d5 d6 6d d7 6d8 d9 6d d: 6Z i d; d 6d< d 6d d 6Z d d d d= � Z d> � Z d? � Z d dB d@ � � YZ d S(C t Charsett add_aliast add_charsett add_codeci����N( t errors( t encode_7or8biti i i i s us-asciis iso-8859-1s iso-8859-2s iso-8859-3s iso-8859-4s iso-8859-9s iso-8859-10s iso-8859-13s iso-8859-14s iso-8859-15s iso-8859-16s windows-1252t visciit big5t gb2312s iso-2022-jps euc-jpt shift_jiss koi8-rs utf-8t 8bitt latin_1s latin-1t latin_2s latin-2t latin_3s latin-3t latin_4s latin-4t latin_5s latin-5t latin_6s latin-6t latin_7s latin-7t latin_8s latin-8t latin_9s latin-9t latin_10s latin-10s ks_c_5601-1987t cp949t euc_jps euc-krt euc_krt asciit eucgb2312_cnt big5_twc C s2 | t k r t d � � n | | | f t | <d S( s> Add character set properties to the global registry. charset is the input character set, and must be the canonical name of a character set. Optional header_enc and body_enc is either Charset.QP for quoted-printable, Charset.BASE64 for base64 encoding, Charset.SHORTEST for the shortest of qp or base64 encoding, or None for no encoding. SHORTEST is only valid for header_enc. It describes how message headers and message bodies in the input charset are to be encoded. Default is no encoding. Optional output_charset is the character set that the output should be in. Conversions will proceed from input charset, to Unicode, to the output charset when the method Charset.convert() is called. The default is to output in the same character set as the input. Both input_charset and output_charset must have Unicode codec entries in the module's charset-to-codec mapping; use add_codec(charset, codecname) to add codecs the module does not know about. See the codecs module's documentation for more information. s! SHORTEST not allowed for body_encN( t SHORTESTt ValueErrort CHARSETS( t charsett header_enct body_enct output_charset( ( s% /usr/lib64/python2.7/email/charset.pyR l s c C s | t | <d S( s� Add a character set alias. alias is the alias name, e.g. latin-1 canonical is the character set's canonical name, e.g. iso-8859-1 N( t ALIASES( t aliast canonical( ( s% /usr/lib64/python2.7/email/charset.pyR � s c C s | t | <d S( s$ Add a codec that map characters in the given charset to/from Unicode. charset is the canonical name of a character set. codecname is the name of a Python codec, as appropriate for the second argument to the unicode() built-in, or to the encode() method of a Unicode string. N( t CODEC_MAP( R t codecname( ( s% /usr/lib64/python2.7/email/charset.pyR � s c B s� e Z d Z e d � Z d � Z e Z d � Z d � Z d � Z d � Z d � Z e d � Z d � Z d � Z e d � Z e d � Z RS( s@ Map character sets to their email properties. This class provides information about the requirements imposed on email for a specific character set. It also provides convenience routines for converting between character sets, given the availability of the applicable codecs. Given a character set, it will do its best to provide information on how to use that character set in an email in an RFC-compliant way. Certain character sets must be encoded with quoted-printable or base64 when used in email headers or bodies. Certain character sets must be converted outright, and are not allowed in email. Instances of this module expose the following information about a character set: input_charset: The initial character set specified. Common aliases are converted to their `official' email names (e.g. latin_1 is converted to iso-8859-1). Defaults to 7-bit us-ascii. header_encoding: If the character set must be encoded before it can be used in an email header, this attribute will be set to Charset.QP (for quoted-printable), Charset.BASE64 (for base64 encoding), or Charset.SHORTEST for the shortest of QP or BASE64 encoding. Otherwise, it will be None. body_encoding: Same as header_encoding, but describes the encoding for the mail message's body, which indeed may be different than the header encoding. Charset.SHORTEST is not allowed for body_encoding. output_charset: Some character sets must be converted before they can be used in email headers or bodies. If the input_charset is one of them, this attribute will contain the name of the charset output will be converted to. Otherwise, it will be None. input_codec: The name of the Python codec used to convert the input_charset to Unicode. If no conversion codec is necessary, this attribute will be None. output_codec: The name of the Python codec used to convert Unicode to the output_charset. If no conversion codec is necessary, this attribute will have the same value as the input_codec. c C s^ y2 t | t � r" | j d � n t | d � } Wn t k rT t j | � � n X| j � j d � } | t k p | t k s� y t j | � j } Wq� t k r� q� Xn t j | | � | _ t j | j t t d f � \ } } } | s� | j } n | | _ | | _ t j | | � | _ t j | j | j � | _ t j | j | j � | _ d S( NR ( t isinstancet unicodet encodet UnicodeErrorR t CharsetErrort lowerR" R t codecst lookupt namet LookupErrort gett input_charsetR t BASE64t Nonet header_encodingt body_encodingR! R% t input_codect output_codec( t selfR2 t henct benct conv( ( s% /usr/lib64/python2.7/email/charset.pyt __init__� s0 c C s | j j � S( N( R2 R, ( R9 ( ( s% /usr/lib64/python2.7/email/charset.pyt __str__� s c C s t | � t | � j � k S( N( t strR, ( R9 t other( ( s% /usr/lib64/python2.7/email/charset.pyt __eq__� s c C s | j | � S( N( RA ( R9 R@ ( ( s% /usr/lib64/python2.7/email/charset.pyt __ne__� s c C s. | j t k r d S| j t k r& d St Sd S( sC Return the content-transfer-encoding used for body encoding. This is either the string `quoted-printable' or `base64' depending on the encoding used, or it is a function in which case you should call the function with a single argument, the Message object being encoded. The function should then set the Content-Transfer-Encoding header itself to whatever is appropriate. Returns "quoted-printable" if self.body_encoding is QP. Returns "base64" if self.body_encoding is BASE64. Returns "7bit" otherwise. s quoted-printablet base64N( R6 t QPR3 R ( R9 ( ( s% /usr/lib64/python2.7/email/charset.pyt get_body_encoding� s c C s6 | j | j k r. t | | j � j | j � S| Sd S( s: Convert a string from the input_codec to the output_codec.N( R7 R8 R( R) ( R9 t s( ( s% /usr/lib64/python2.7/email/charset.pyt convert s c C sR t | t � s | j d k r" | Sy t | | j d � SWn t k rM | SXd S( s� Convert a possibly multibyte string to a safely splittable format. Uses the input_codec to try and convert the string to Unicode, so it can be safely split on character boundaries (even for multibyte characters). Returns the string as-is if it isn't known how to convert it to Unicode with the input_charset. Characters that could not be converted to Unicode will be replaced with the Unicode replacement character U+FFFD. t replaceN( R' R( R7 R4 R0 ( R9 RF ( ( s% /usr/lib64/python2.7/email/charset.pyt to_splittable s c C sh | r | j } n | j } t | t � s7 | d k r; | Sy | j | d � SWn t k rc | SXd S( s* Convert a splittable string back into an encoded string. Uses the proper codec to try and convert the string from Unicode back into an encoded format. Return the string as-is if it is not Unicode, or if it could not be converted from Unicode. Characters that could not be converted from Unicode will be replaced with an appropriate character (usually '?'). If to_output is True (the default), uses output_codec to convert to an encoded format. If to_output is False, uses input_codec. RH N( R8 R7 R' R( R4 R) R0 ( R9 t ustrt to_outputt codec( ( s% /usr/lib64/python2.7/email/charset.pyt from_splittable+ s c C s | j p | j S( s� Return the output character set. This is self.output_charset if that is not None, otherwise it is self.input_charset. ( R! R2 ( R9 ( ( s% /usr/lib64/python2.7/email/charset.pyt get_output_charsetD s c C s� | j � } | j t k r9 t j j | � t | � t S| j t k rf t j j | � t | � t S| j t k r� t j j | � } t j j | � } t | | � t | � t St | � Sd S( s/ Return the length of the encoded header string.N( RN R5 R3 t emailt base64mimet base64_lent lent MISC_LENRD t quoprimimet header_quopri_lenR t min( R9 RF t csett lenb64t lenqp( ( s% /usr/lib64/python2.7/email/charset.pyt encoded_header_lenL s c C s� | j � } | r$ | j | � } n | j t k rF t j j | | � S| j t k rn t j j | | d d �S| j t k r� t j j | � } t j j | � } | | k r� t j j | | � St j j | | d d �Sn | Sd S( sE Header-encode a string, optionally converting it to output_charset. If convert is True, the string will be converted from the input charset to the output charset automatically. This is not useful for multibyte character sets, which have line length issues (multibyte characters must be split on a character, not a byte boundary); use the high-level Header class to deal with these issues. convert defaults to False. The type of encoding (base64 or quoted-printable) will be based on self.header_encoding. t maxlinelenN( RN RG R5 R3 RO RP t header_encodeRD RT R4 R RQ RU ( R9 RF RG RW RX RY ( ( s% /usr/lib64/python2.7/email/charset.pyR\ [ s c C s^ | r | j | � } n | j t k r7 t j j | � S| j t k rV t j j | � S| Sd S( s� Body-encode a string and convert it to output_charset. If convert is True (the default), the string will be converted from the input charset to output charset automatically. Unlike header_encode(), there are no issues with byte boundaries and multibyte charsets in email bodies, so this is usually pretty safe. The type of encoding (base64 or quoted-printable) will be based on self.body_encoding. N( RG R6 R3 RO RP t body_encodeRD RT ( R9 RF RG ( ( s% /usr/lib64/python2.7/email/charset.pyR] z s ( t __name__t __module__t __doc__t DEFAULT_CHARSETR= R> t __repr__RA RB RE RG RI t TrueRM RN RZ t FalseR\ R] ( ( ( s% /usr/lib64/python2.7/email/charset.pyR � s + & ( NNN( ( t __all__R- t email.base64mimeRO t email.quoprimimeR t email.encodersR RD R3 R RS Ra R4 R R" R% R R R R ( ( ( s% /usr/lib64/python2.7/email/charset.pyt <module> s� _parseaddr.pyc 0000644 00000033105 15204114626 0007370 0 ustar 00 � { fc @ sd d Z d d d d g Z d d l Z d d l Z d Z d Z d Z d d d d d d d d d d d d d d d d d d d d d d d d g Z d! d" d# d$ d% d& d' g Z i d( d) 6d( d* 6d( d+ 6d( d, 6d- d. 6d/ d0 6d1 d2 6d- d3 6d4 d5 6d1 d6 6d7 d8 6d4 d9 6d: d; 6d7 d< 6Z d= � Z d> � Z d? � Z d@ � Z dA f dB � � YZ dC e f dD � � YZ d S(E sc Email address parsing code. Lifted directly from rfc822.py. This should eventually be rewritten. t mktime_tzt parsedatet parsedate_tzt quotei����Nt t s , t jant febt mart aprt mayt junt jult augt sept octt novt dect januaryt februaryt marcht aprilt junet julyt augustt septembert octobert novembert decembert mont tuet wedt thut frit satt suni t UTt UTCt GMTt Zip���t ASTi���t ADTi ���t ESTt EDTi����t CSTt CDTiD���t MSTt MDTi��t PSTt PDTc C s | j � } | d j d � s5 | d j � t k r? | d =n8 | d j d � } | d k rw | d | d | d <n t | � d k r� | d j d � } t | � d k r� | | d } q� n t | � d k r(| d } | j d � } | d k r| | | | d g | d )q(| j d � n t | � d k r>d S| d } | \ } } } } } | j � } | t k r�| | j � } } | t k r�d Sn t j | � d } | d k r�| d 8} n | d d k r�| d } n | j d � } | d k r| | } } n | d d k r,| d } n | d j � sL| | } } n | d d k ri| d } n | j d � } t | � d k r�| \ } } d } n( t | � d k r�| \ } } } n d Sy@ t | � } t | � } t | � } t | � } t | � } Wn t k rd SX| d k rN| d k rA| d 7} qN| d 7} n d } | j � } | t k ryt | } n$ y t | � } Wn t k r�n X| r�| d k r�d } | } n d } | | d d | d d } n | | | | | | d d d | f S( sQ Convert a date string to a time tuple. Accounts for military timezones. i t ,i i t -i t +R i i i����t :i t 0id iD il i� i i< N( t splitt endswitht lowert _daynamest rfindt lent findt appendt Nonet _monthnamest indext isdigitt intt ValueErrort uppert _timezones( t datat it stufft st ddt mmt yyt tmt tzt thht tmmt tsst tzoffsett tzsign( ( s( /usr/lib64/python2.7/email/_parseaddr.pyR - s� ) !c C s+ t | � } t | t � r# | d S| Sd S( s& Convert a time string to a time tuple.i N( R t isinstancet tuple( RG t t( ( s( /usr/lib64/python2.7/email/_parseaddr.pyR � s c C sD | d d k r% t j | d d � St j | � } | | d Sd S( sE Turn a 10-tuple as returned by parsedate_tz() into a POSIX timestamp.i i i����N( i����( R? t timet mktimet calendart timegm( RG RW ( ( s( /usr/lib64/python2.7/email/_parseaddr.pyR � s c C s | j d d � j d d � S( s� Prepare string to be used in a quoted string. Turns backslash and double quote characters into quoted pairs. These are the only characters that need to be quoted inside a quoted string. Does not add the surrounding double quotes. s \s \\t "s \"( t replace( t str( ( s( /usr/lib64/python2.7/email/_parseaddr.pyR � s t AddrlistClassc B s� e Z d Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z e d � Z d � Z d � Z d � Z d d � Z d � Z RS( s� Address parser class by Ben Escoto. To understand what this class does, it helps to have a copy of RFC 2822 in front of you. Note: this class interface is deprecated and may be removed in the future. Use rfc822.AddressList instead. c C s d | _ d | _ d | _ d | _ | j | j | _ | j | j | j | _ | j j d d � | _ | | _ g | _ d S( s� Initialize a new instance. `field' is an unparsed address header field, containing one or more addresses. s ()<>@,:;."[]i s s t .R N( t specialst post LWSt CRt FWSt atomendsR] t phraseendst fieldt commentlist( t selfRh ( ( s( /usr/lib64/python2.7/email/_parseaddr.pyt __init__� s c C s� x{ | j t | j � k r} | j | j | j d k rJ | j d 7_ q | j | j d k ry | j j | j � � q Pq Wd S( s* Parse up to the start of the next address.s i t (N( Rb R< Rh Rc Ri R> t getcomment( Rj ( ( s( /usr/lib64/python2.7/email/_parseaddr.pyt gotonext� s c C sU g } xH | j t | j � k rP | j � } | r@ | | 7} q | j d � q W| S( sV Parse all addresses. Returns a list containing all of the addresses. R ( R R ( Rb R< Rh t getaddressR> ( Rj t resultt ad( ( s( /usr/lib64/python2.7/email/_parseaddr.pyt getaddrlist� s c C s� g | _ | j � | j } | j } | j � } | j � g } | j t | j � k r� | rPt j | j � | d f g } qPn�| j | j d k r� | | _ | | _ | j � } t j | j � | f g } nz| j | j d k r�g } t | j � } | j d 7_ x=| j t | j � k r�| j � | j | k rm| j | j d k rm| j d 7_ Pn | | j � } qWn� | j | j d k r�| j � } | j r�t j | � d d j | j � d | f g } qPt j | � | f g } nS | r%t j | j � | d f g } n+ | j | j | j k rP| j d 7_ n | j � | j t | j � k r�| j | j d k r�| j d 7_ n | S( s Parse the next address.i s .@R5 i t ;t <s (R t )R2 ( Ri Rn Rb t getphraselistR< Rh t SPACEt joint getaddrspecRo t getrouteaddrRa ( Rj t oldpost oldclt plistt returnlistt addrspect fieldlent routeaddr( ( s( /usr/lib64/python2.7/email/_parseaddr.pyRo � sL % % 3" .c C s | j | j d k r d St } | j d 7_ | j � d } x� | j t | j � k r| rs | j � t } n� | j | j d k r� | j d 7_ Pnr | j | j d k r� | j d 7_ t } nD | j | j d k r� | j d 7_ n | j � } | j d 7_ P| j � qB W| S( s� Parse a route address (Return-path value). This method just skips all the route stuff and returns the addrspec. Rt Ni R t >t @R5 ( Rh Rb t FalseRn R< t getdomaint TrueRy ( Rj t expectroutet adlist( ( s( /usr/lib64/python2.7/email/_parseaddr.pyRz s. c C s\ g } | j � x� | j t | j � k r� | j | j d k r` | j d � | j d 7_ nf | j | j d k r� | j d t | j � � � n0 | j | j | j k r� Pn | j | j � � | j � q W| j t | j � k s| j | j d k rt j | � S| j d � | j d 7_ | j � | j � } | sKt St j | � | S( s Parse an RFC 2822 addr-spec.R` i R\ s "%s"R� ( Rn Rb R< Rh R> R t getquoteRf t getatomt EMPTYSTRINGRx R� ( Rj t aslistt domain( ( s( /usr/lib64/python2.7/email/_parseaddr.pyRy < s* . c C s7 g } x!| j t | j � k r)| j | j | j k rL | j d 7_ q | j | j d k r{ | j j | j � � q | j | j d k r� | j | j � � q | j | j d k r� | j d 7_ | j d � q | j | j d k r� t S| j | j | j k rPq | j | j � � q Wt j | � S( s- Get the complete domain name from an address.i Rl t [R` R� ( Rb R< Rh Rc Ri R> Rm t getdomainliteralR� Rf R� Rx ( Rj t sdlist( ( s( /usr/lib64/python2.7/email/_parseaddr.pyR� Z s" c C s- | j | j | k r d Sd g } t } | j d 7_ x� | j t | j � k r | ry | j | j | j � t } n� | j | j | k r� | j d 7_ Pnk | r� | j | j d k r� | j | j � � q; n6 | j | j d k r� t } n | j | j | j � | j d 7_ q; Wt j | � S( s� Parse a header fragment delimited by special characters. `beginchar' is the start character for the fragment. If self is not looking at an instance of `beginchar' then getdelimited returns the empty string. `endchars' is a sequence of allowable end-delimiting characters. Parsing stops when one of these is encountered. If `allowcomments' is non-zero, embedded RFC 2822 comments are allowed within the parsed fragment. R i Rl s \( Rh Rb R� R< R> Rm R� R� Rx ( Rj t beginchart endcharst allowcommentst slistR ( ( s( /usr/lib64/python2.7/email/_parseaddr.pyt getdelimitedq s( c C s | j d d t � S( s1 Get a quote-delimited fragment from self's field.R\ s " ( R� R� ( Rj ( ( s( /usr/lib64/python2.7/email/_parseaddr.pyR� � s c C s | j d d t � S( s7 Get a parenthesis-delimited fragment from self's field.Rl s ) ( R� R� ( Rj ( ( s( /usr/lib64/python2.7/email/_parseaddr.pyRm � s c C s d | j d d t � S( s! Parse an RFC 2822 domain-literal.s [%s]R� s ] ( R� R� ( Rj ( ( s( /usr/lib64/python2.7/email/_parseaddr.pyR� � s c C s� d g } | d k r! | j } n x\ | j t | j � k r | j | j | k rV Pn | j | j | j � | j d 7_ q$ Wt j | � S( s Parse an RFC 2822 atom. Optional atomends specifies a different set of end token delimiters (the default is to use self.atomends). This is used e.g. in getphraselist() since phrase endings must not include the `.' (which is legal in phrases).R i N( R? Rf Rb R< Rh R> R� Rx ( Rj Rf t atomlist( ( s( /usr/lib64/python2.7/email/_parseaddr.pyR� � s c C s� g } x� | j t | j � k r� | j | j | j k rL | j d 7_ q | j | j d k rx | j | j � � q | j | j d k r� | j j | j � � q | j | j | j k r� Pq | j | j | j � � q W| S( s� Parse a sequence of RFC 2822 phrases. A phrase is a sequence of words, which are in turn either RFC 2822 atoms or quoted-strings. Phrases are canonicalized by squeezing all runs of continuous whitespace into one space. i R\ Rl ( Rb R< Rh Re R> R� Ri Rm Rg R� ( Rj R} ( ( s( /usr/lib64/python2.7/email/_parseaddr.pyRv � s N( t __name__t __module__t __doc__Rk Rn Rr Ro Rz Ry R� R� R� R� Rm R� R? R� Rv ( ( ( s( /usr/lib64/python2.7/email/_parseaddr.pyR_ � s ; % t AddressListc B sM e Z d Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z RS( s@ An AddressList encapsulates a list of parsed RFC 2822 addresses.c C s5 t j | | � | r( | j � | _ n g | _ d S( N( R_ Rk Rr t addresslist( Rj Rh ( ( s( /usr/lib64/python2.7/email/_parseaddr.pyRk � s c C s t | j � S( N( R< R� ( Rj ( ( s( /usr/lib64/python2.7/email/_parseaddr.pyt __len__� s c C sS t d � } | j | _ x3 | j D]( } | | j k r# | j j | � q# q# W| S( N( R� R? R� R> ( Rj t othert newaddrt x( ( s( /usr/lib64/python2.7/email/_parseaddr.pyt __add__� s c C s: x3 | j D]( } | | j k r | j j | � q q W| S( N( R� R> ( Rj R� R� ( ( s( /usr/lib64/python2.7/email/_parseaddr.pyt __iadd__� s c C sF t d � } x3 | j D]( } | | j k r | j j | � q q W| S( N( R� R? R� R> ( Rj R� R� R� ( ( s( /usr/lib64/python2.7/email/_parseaddr.pyt __sub__� s c C s: x3 | j D]( } | | j k r | j j | � q q W| S( N( R� t remove( Rj R� R� ( ( s( /usr/lib64/python2.7/email/_parseaddr.pyt __isub__� s c C s | j | S( N( R� ( Rj RA ( ( s( /usr/lib64/python2.7/email/_parseaddr.pyt __getitem__� s ( R� R� R� Rk R� R� R� R� R� R� ( ( ( s( /usr/lib64/python2.7/email/_parseaddr.pyR� � s ( R� t __all__RX RZ Rw R� t COMMASPACER@ R: RF R R R R R_ R� ( ( ( s( /usr/lib64/python2.7/email/_parseaddr.pyt <module> s4 b � " quoprimime.pyo 0000644 00000021222 15204114626 0007464 0 ustar 00 � { fc @ s5 d Z d d d d d d d d d d d d d d g Z d d l Z d d l m Z d d l m Z d Z d Z d Z e j d � Z e j d � Z d � Z d � Z d � Z d � Z d d � Z d � Z d � Z d e d! e d" � Z e d! e d# � Z e Z e Z e d$ � Z e Z e Z d% � Z d& � Z d S(' sF Quoted-printable content transfer encoding per RFCs 2045-2047. This module handles the content transfer encoding method defined in RFC 2045 to encode US ASCII-like 8-bit data called `quoted-printable'. It is used to safely encode text that is in a character set similar to the 7-bit US ASCII character set, but that includes some 8-bit characters that are normally not allowed in email bodies or headers. Quoted-printable is very space-inefficient for encoding binary files; use the email.base64mime module for that instead. This module provides an interface to encode and decode both headers and bodies with quoted-printable encoding. RFC 2045 defines a method for including character set information in an `encoded-word' in a header. This method is commonly used for 8-bit real names in To:/From:/Cc: etc. fields, as well as Subject: lines. This module does not do the line wrapping or end-of-line character conversion necessary for proper internationalized headers; it only does dumb encoding and decoding. To deal with the various line wrapping issues, use the email.header module. t body_decodet body_encodet body_quopri_checkt body_quopri_lent decodet decodestringt encodet encodestringt header_decodet header_encodet header_quopri_checkt header_quopri_lent quotet unquotei����N( t hexdigits( t fix_eolss s i s [^-a-zA-Z0-9!*+/ ]s [^ !-<>-~\t]c C s t t j | � � S( sB Return True if the character should be escaped with header quopri.( t boolt hqret match( t c( ( s( /usr/lib64/python2.7/email/quoprimime.pyR ? s c C s t t j | � � S( s@ Return True if the character should be escaped with body quopri.( R t bqreR ( R ( ( s( /usr/lib64/python2.7/email/quoprimime.pyR D s c C sA d } x4 | D], } t j | � r/ | d 7} q | d 7} q W| S( s? Return the length of str when it is encoded with header quopri.i i i ( R R ( t st countR ( ( s( /usr/lib64/python2.7/email/quoprimime.pyR I s c C sA d } x4 | D], } t j | � r/ | d 7} q | d 7} q W| S( s= Return the length of str when it is encoded with body quopri.i i i ( R R ( t strR R ( ( s( /usr/lib64/python2.7/email/quoprimime.pyR T s t c C sj | s | j | j � � nJ t | d � t | � | k rS | d c | | 7<n | j | j � � d S( Ni����( t appendt lstript len( t LR t maxlent extra( ( s( /usr/lib64/python2.7/email/quoprimime.pyt _max_append_ s c C s t t | d d !d � � S( sD Turn a string in the form =AB to the ASCII character with value 0xabi i i ( t chrt int( R ( ( s( /usr/lib64/python2.7/email/quoprimime.pyR h s c C s d t | � S( Ns =%02X( t ord( R ( ( s( /usr/lib64/python2.7/email/quoprimime.pyR m s s iso-8859-1iL c C s� | s | S| s t | � } n g } | d k r: d } n | t | � t d } xi | D]a } | d k r~ t | d | � qY t j | � s� t | | | � qY t | d t | � | � qY W| d } | j g | D] } d | | f ^ q� � S( s� Encode a single header line with quoted-printable (like) encoding. Defined in RFC 2045, this `Q' encoding is similar to quoted-printable, but used specifically for email header fields to allow charsets with mostly 7 bit characters (and some 8 bit) to remain more or less readable in non-RFC 2045 aware mail clients. charset names the character set to use to encode the header. It defaults to iso-8859-1. The resulting string will be in the form: "=?charset?q?I_f=E2rt_in_your_g=E8n=E8ral_dire=E7tion?\n =?charset?q?Silly_=C8nglish_Kn=EEghts?=" with each line wrapped safely at, at most, maxlinelen characters (defaults to 76 characters). If maxlinelen is None, the entire string is encoded in one chunk with no splitting. End-of-line characters (\r, \n, \r\n) will be automatically converted to the canonical email line separator \r\n unless the keep_eols parameter is True (the default is False). Each line of the header will be terminated in the value of eol, which defaults to "\n". Set this to "\r\n" if you are using the result of this function directly in email. i�� i t t _s =%02Xs =?%s?q?%s?=N( R t NoneR t MISC_LENR R R R" t join( t headert charsett keep_eolst maxlinelent eolt quotedt max_encodedR t joinert line( ( s( /usr/lib64/python2.7/email/quoprimime.pyR r s c C sF | s | S| s t | � } n d } d } | j d � } x| D]�} | j t � rc | d } n | d t k r� | d } n | d 7} d } d } t | � } x� t | � D]� } | | } | } t j | � r� t | � } n5 | d | k r| d k r | | 7} n | } q� n t | � t | � | k rO| | d | 7} d } n | | 7} q� W| r�| d k r�| d t | � k r�t | � } t | � t | � | k r�| | d | | 7} q�| | | 7} n | | | d | 7} d } n | | j t � s | | d t k r.| | | 7} n | | 7} d } qA W| S( s� Encode with quoted-printable, wrapping at maxlinelen characters. If binary is False (the default), end-of-line characters will be converted to the canonical email end-of-line sequence \r\n. Otherwise they will be left verbatim. Each line of encoded text will end with eol, which defaults to "\n". Set this to "\r\n" if you will be using the result of this function directly in an email. Each line will be wrapped at, at most, maxlinelen characters (defaults to 76 characters). Long lines will have the `soft linefeed' quoted-printable character "=" appended to them, so the decoded text will be identical to the original text. R i����i i����s t =N( R t splitlinest endswitht CRLFR% R t rangeR R R ( t bodyt binaryR+ R, t encoded_bodyt linenot linesR0 t encoded_linet prevt linelent jR ( ( s( /usr/lib64/python2.7/email/quoprimime.pyR � sV ' c C sx | s | Sd } x5| j � D]'} | j � } | sE | | 7} q n d } t | � } x� | | k rC| | } | d k r� | | 7} | d 7} n� | d | k r� | d 7} qZ nt | d | k r| | d t k r| | d t k r| t | | | d !� 7} | d 7} n | | 7} | d 7} | | k rZ | | 7} qZ qZ Wq W| j | � rt| j | � rt| d } n | S( s_ Decode a quoted-printable string. Lines are separated with eol, which defaults to \n. R i R1 i i i i����( R2 t rstripR R R R3 ( t encodedR, t decodedR0 t it nR ( ( s( /usr/lib64/python2.7/email/quoprimime.pyR s8 8 c C s | j d � } t | � S( sC Turn a match in the form =AB to the ASCII character with value 0xabi ( t groupR ( R R ( ( s( /usr/lib64/python2.7/email/quoprimime.pyt _unquote_matchA s c C s% | j d d � } t j d t | � S( s Decode a string encoded with RFC 2045 MIME header `Q' encoding. This function does not parse a full MIME header value encoded with quoted-printable (like =?iso-8859-1?q?Hello_World?=) -- please use the high level email.header class for that functionality. R$ R# s =[a-fA-F0-9]{2}( t replacet ret subRE ( R ( ( s( /usr/lib64/python2.7/email/quoprimime.pyR H s ( t __doc__t __all__RG t stringR t email.utilsR R4 t NLR& t compileR R R R R R R R R t FalseR R R R R R R RE R ( ( ( s( /usr/lib64/python2.7/email/quoprimime.pyt <module> sN ?S 0 __init__.pyo 0000644 00000005470 15204114626 0007043 0 ustar 00 � { fc @ s� d Z d Z d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d! g Z d" � Z d# � Z d$ d% l Z d& e f d' � � YZ d d d d( d d d d d d d d g Z d) d* d+ d d, d- d. g Z xH e D]@ Z e e j � � Z e e j d/ e <e e j d0 e e � q� Wd$ d% l Z xg e D]_ Z e d1 e j � � Z e e j d2 e <e e j d0 d3 e e � e e j d4 e e � qIWd% S(5 s? A package for parsing, handling, and generating email messages.s 4.0.3t base64MIMEt Charsett Encoderst Errorst Generatort Headert Iteratorst Messaget MIMEAudiot MIMEBaset MIMEImaget MIMEMessaget MIMEMultipartt MIMENonMultipartt MIMETextt Parsert quopriMIMEt Utilst message_from_stringt message_from_filet base64mimet charsett encoderst errorst generatort headert iteratorst messaget mimet parsert quoprimimet utilsc O s& d d l m } | | | � j | � S( sv Parse a string into a Message object model. Optional _class and strict are passed to the Parser constructor. i����( R ( t email.parserR t parsestr( t st argst kwsR ( ( s& /usr/lib64/python2.7/email/__init__.pyR 3 s c O s& d d l m } | | | � j | � S( s� Read a file and parse its contents into a Message object model. Optional _class and strict are passed to the Parser constructor. i����( R ( R R t parse( t fpR# R$ R ( ( s& /usr/lib64/python2.7/email/__init__.pyR < s i����Nt LazyImporterc B s e Z d � Z d � Z RS( c C s d | | _ d S( Ns email.( t __name__( t selft module_name( ( s& /usr/lib64/python2.7/email/__init__.pyt __init__K s c C s= t | j � t j | j } | j j | j � t | | � S( N( t __import__R( t syst modulest __dict__t updatet getattr( R) t namet mod( ( s& /usr/lib64/python2.7/email/__init__.pyt __getattr__N s ( R( t __module__R+ R4 ( ( ( s& /usr/lib64/python2.7/email/__init__.pyR' J s t FeedParsert Audiot Baset Imaget Multipartt NonMultipartt Texts email.t emails mime.s email.MIMEt MIMEs email.mime( t __doc__t __version__t __all__R R R- t objectR' t _LOWERNAMESt _MIMENAMESt _namet lowert importerR. t setattrt email.mimeR= ( ( ( s& /usr/lib64/python2.7/email/__init__.pyt <module> s� parser.pyc 0000644 00000007364 15204114626 0006570 0 ustar 00 � { fc @ s{ d Z d d g Z d d l Z d d l m Z d d l m Z d d l m Z d d d � � YZ d e f d � � YZ d S( s- A parser of RFC 2822 and MIME email messages.t Parsert HeaderParseri����N( t StringIO( t FeedParser( t Messagec B s) e Z d � Z e d � Z e d � Z RS( c O s t | � d k r> d | k r- t d � � n | d | d <n t | � d k r| d | k rk t d � � n | d | d <n t | � d k r� t d � � n d | k r� | d | _ | d =n t | _ d | k r� t j d t d � | d =n | rt d � � n d S( s� 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 preceded 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. i t _classs( Multiple values for keyword arg '_class'i i t stricts( Multiple values for keyword arg 'strict's Too many argumentss- 'strict' argument is deprecated (and ignored)s Unexpected keyword argumentsN( t lent TypeErrorR R t warningst warnt DeprecationWarning( t selft argst kws( ( s$ /usr/lib64/python2.7/email/parser.pyt __init__ s( c C s_ t | j � } | r" | j � n x0 t rT | j d � } | sD Pn | j | � q% W| j � S( s\ 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. i ( R R t _set_headersonlyt Truet readt feedt close( R t fpt headersonlyt feedparsert data( ( s$ /usr/lib64/python2.7/email/parser.pyt parse8 s c C s | j t | � d | �S( s- 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. R ( R R ( R t textR ( ( s$ /usr/lib64/python2.7/email/parser.pyt parsestrJ s ( t __name__t __module__R t FalseR R ( ( ( s$ /usr/lib64/python2.7/email/parser.pyR s & c B s e Z e d � Z e d � Z RS( c C s t j | | t � S( N( R R R ( R R R ( ( s$ /usr/lib64/python2.7/email/parser.pyR W s c C s t j | | t � S( N( R R R ( R R R ( ( s$ /usr/lib64/python2.7/email/parser.pyR Z s ( R R R R R ( ( ( s$ /usr/lib64/python2.7/email/parser.pyR V s ( ( t __doc__t __all__R t cStringIOR t email.feedparserR t email.messageR R R ( ( ( s$ /usr/lib64/python2.7/email/parser.pyt <module> s E _parseaddr.pyo 0000644 00000033105 15204114626 0007404 0 ustar 00 � { fc @ sd d Z d d d d g Z d d l Z d d l Z d Z d Z d Z d d d d d d d d d d d d d d d d d d d d d d d d g Z d! d" d# d$ d% d& d' g Z i d( d) 6d( d* 6d( d+ 6d( d, 6d- d. 6d/ d0 6d1 d2 6d- d3 6d4 d5 6d1 d6 6d7 d8 6d4 d9 6d: d; 6d7 d< 6Z d= � Z d> � Z d? � Z d@ � Z dA f dB � � YZ dC e f dD � � YZ d S(E sc Email address parsing code. Lifted directly from rfc822.py. This should eventually be rewritten. t mktime_tzt parsedatet parsedate_tzt quotei����Nt t s , t jant febt mart aprt mayt junt jult augt sept octt novt dect januaryt februaryt marcht aprilt junet julyt augustt septembert octobert novembert decembert mont tuet wedt thut frit satt suni t UTt UTCt GMTt Zip���t ASTi���t ADTi ���t ESTt EDTi����t CSTt CDTiD���t MSTt MDTi��t PSTt PDTc C s | j � } | d j d � s5 | d j � t k r? | d =n8 | d j d � } | d k rw | d | d | d <n t | � d k r� | d j d � } t | � d k r� | | d } q� n t | � d k r(| d } | j d � } | d k r| | | | d g | d )q(| j d � n t | � d k r>d S| d } | \ } } } } } | j � } | t k r�| | j � } } | t k r�d Sn t j | � d } | d k r�| d 8} n | d d k r�| d } n | j d � } | d k r| | } } n | d d k r,| d } n | d j � sL| | } } n | d d k ri| d } n | j d � } t | � d k r�| \ } } d } n( t | � d k r�| \ } } } n d Sy@ t | � } t | � } t | � } t | � } t | � } Wn t k rd SX| d k rN| d k rA| d 7} qN| d 7} n d } | j � } | t k ryt | } n$ y t | � } Wn t k r�n X| r�| d k r�d } | } n d } | | d d | d d } n | | | | | | d d d | f S( sQ Convert a date string to a time tuple. Accounts for military timezones. i t ,i i t -i t +R i i i����t :i t 0id iD il i� i i< N( t splitt endswitht lowert _daynamest rfindt lent findt appendt Nonet _monthnamest indext isdigitt intt ValueErrort uppert _timezones( t datat it stufft st ddt mmt yyt tmt tzt thht tmmt tsst tzoffsett tzsign( ( s( /usr/lib64/python2.7/email/_parseaddr.pyR - s� ) !c C s+ t | � } t | t � r# | d S| Sd S( s& Convert a time string to a time tuple.i N( R t isinstancet tuple( RG t t( ( s( /usr/lib64/python2.7/email/_parseaddr.pyR � s c C sD | d d k r% t j | d d � St j | � } | | d Sd S( sE Turn a 10-tuple as returned by parsedate_tz() into a POSIX timestamp.i i i����N( i����( R? t timet mktimet calendart timegm( RG RW ( ( s( /usr/lib64/python2.7/email/_parseaddr.pyR � s c C s | j d d � j d d � S( s� Prepare string to be used in a quoted string. Turns backslash and double quote characters into quoted pairs. These are the only characters that need to be quoted inside a quoted string. Does not add the surrounding double quotes. s \s \\t "s \"( t replace( t str( ( s( /usr/lib64/python2.7/email/_parseaddr.pyR � s t AddrlistClassc B s� e Z d Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z e d � Z d � Z d � Z d � Z d d � Z d � Z RS( s� Address parser class by Ben Escoto. To understand what this class does, it helps to have a copy of RFC 2822 in front of you. Note: this class interface is deprecated and may be removed in the future. Use rfc822.AddressList instead. c C s d | _ d | _ d | _ d | _ | j | j | _ | j | j | j | _ | j j d d � | _ | | _ g | _ d S( s� Initialize a new instance. `field' is an unparsed address header field, containing one or more addresses. s ()<>@,:;."[]i s s t .R N( t specialst post LWSt CRt FWSt atomendsR] t phraseendst fieldt commentlist( t selfRh ( ( s( /usr/lib64/python2.7/email/_parseaddr.pyt __init__� s c C s� x{ | j t | j � k r} | j | j | j d k rJ | j d 7_ q | j | j d k ry | j j | j � � q Pq Wd S( s* Parse up to the start of the next address.s i t (N( Rb R< Rh Rc Ri R> t getcomment( Rj ( ( s( /usr/lib64/python2.7/email/_parseaddr.pyt gotonext� s c C sU g } xH | j t | j � k rP | j � } | r@ | | 7} q | j d � q W| S( sV Parse all addresses. Returns a list containing all of the addresses. R ( R R ( Rb R< Rh t getaddressR> ( Rj t resultt ad( ( s( /usr/lib64/python2.7/email/_parseaddr.pyt getaddrlist� s c C s� g | _ | j � | j } | j } | j � } | j � g } | j t | j � k r� | rPt j | j � | d f g } qPn�| j | j d k r� | | _ | | _ | j � } t j | j � | f g } nz| j | j d k r�g } t | j � } | j d 7_ x=| j t | j � k r�| j � | j | k rm| j | j d k rm| j d 7_ Pn | | j � } qWn� | j | j d k r�| j � } | j r�t j | � d d j | j � d | f g } qPt j | � | f g } nS | r%t j | j � | d f g } n+ | j | j | j k rP| j d 7_ n | j � | j t | j � k r�| j | j d k r�| j d 7_ n | S( s Parse the next address.i s .@R5 i t ;t <s (R t )R2 ( Ri Rn Rb t getphraselistR< Rh t SPACEt joint getaddrspecRo t getrouteaddrRa ( Rj t oldpost oldclt plistt returnlistt addrspect fieldlent routeaddr( ( s( /usr/lib64/python2.7/email/_parseaddr.pyRo � sL % % 3" .c C s | j | j d k r d St } | j d 7_ | j � d } x� | j t | j � k r| rs | j � t } n� | j | j d k r� | j d 7_ Pnr | j | j d k r� | j d 7_ t } nD | j | j d k r� | j d 7_ n | j � } | j d 7_ P| j � qB W| S( s� Parse a route address (Return-path value). This method just skips all the route stuff and returns the addrspec. Rt Ni R t >t @R5 ( Rh Rb t FalseRn R< t getdomaint TrueRy ( Rj t expectroutet adlist( ( s( /usr/lib64/python2.7/email/_parseaddr.pyRz s. c C s\ g } | j � x� | j t | j � k r� | j | j d k r` | j d � | j d 7_ nf | j | j d k r� | j d t | j � � � n0 | j | j | j k r� Pn | j | j � � | j � q W| j t | j � k s| j | j d k rt j | � S| j d � | j d 7_ | j � | j � } | sKt St j | � | S( s Parse an RFC 2822 addr-spec.R` i R\ s "%s"R� ( Rn Rb R< Rh R> R t getquoteRf t getatomt EMPTYSTRINGRx R� ( Rj t aslistt domain( ( s( /usr/lib64/python2.7/email/_parseaddr.pyRy < s* . c C s7 g } x!| j t | j � k r)| j | j | j k rL | j d 7_ q | j | j d k r{ | j j | j � � q | j | j d k r� | j | j � � q | j | j d k r� | j d 7_ | j d � q | j | j d k r� t S| j | j | j k rPq | j | j � � q Wt j | � S( s- Get the complete domain name from an address.i Rl t [R` R� ( Rb R< Rh Rc Ri R> Rm t getdomainliteralR� Rf R� Rx ( Rj t sdlist( ( s( /usr/lib64/python2.7/email/_parseaddr.pyR� Z s" c C s- | j | j | k r d Sd g } t } | j d 7_ x� | j t | j � k r | ry | j | j | j � t } n� | j | j | k r� | j d 7_ Pnk | r� | j | j d k r� | j | j � � q; n6 | j | j d k r� t } n | j | j | j � | j d 7_ q; Wt j | � S( s� Parse a header fragment delimited by special characters. `beginchar' is the start character for the fragment. If self is not looking at an instance of `beginchar' then getdelimited returns the empty string. `endchars' is a sequence of allowable end-delimiting characters. Parsing stops when one of these is encountered. If `allowcomments' is non-zero, embedded RFC 2822 comments are allowed within the parsed fragment. R i Rl s \( Rh Rb R� R< R> Rm R� R� Rx ( Rj t beginchart endcharst allowcommentst slistR ( ( s( /usr/lib64/python2.7/email/_parseaddr.pyt getdelimitedq s( c C s | j d d t � S( s1 Get a quote-delimited fragment from self's field.R\ s " ( R� R� ( Rj ( ( s( /usr/lib64/python2.7/email/_parseaddr.pyR� � s c C s | j d d t � S( s7 Get a parenthesis-delimited fragment from self's field.Rl s ) ( R� R� ( Rj ( ( s( /usr/lib64/python2.7/email/_parseaddr.pyRm � s c C s d | j d d t � S( s! Parse an RFC 2822 domain-literal.s [%s]R� s ] ( R� R� ( Rj ( ( s( /usr/lib64/python2.7/email/_parseaddr.pyR� � s c C s� d g } | d k r! | j } n x\ | j t | j � k r | j | j | k rV Pn | j | j | j � | j d 7_ q$ Wt j | � S( s Parse an RFC 2822 atom. Optional atomends specifies a different set of end token delimiters (the default is to use self.atomends). This is used e.g. in getphraselist() since phrase endings must not include the `.' (which is legal in phrases).R i N( R? Rf Rb R< Rh R> R� Rx ( Rj Rf t atomlist( ( s( /usr/lib64/python2.7/email/_parseaddr.pyR� � s c C s� g } x� | j t | j � k r� | j | j | j k rL | j d 7_ q | j | j d k rx | j | j � � q | j | j d k r� | j j | j � � q | j | j | j k r� Pq | j | j | j � � q W| S( s� Parse a sequence of RFC 2822 phrases. A phrase is a sequence of words, which are in turn either RFC 2822 atoms or quoted-strings. Phrases are canonicalized by squeezing all runs of continuous whitespace into one space. i R\ Rl ( Rb R< Rh Re R> R� Ri Rm Rg R� ( Rj R} ( ( s( /usr/lib64/python2.7/email/_parseaddr.pyRv � s N( t __name__t __module__t __doc__Rk Rn Rr Ro Rz Ry R� R� R� R� Rm R� R? R� Rv ( ( ( s( /usr/lib64/python2.7/email/_parseaddr.pyR_ � s ; % t AddressListc B sM e Z d Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z RS( s@ An AddressList encapsulates a list of parsed RFC 2822 addresses.c C s5 t j | | � | r( | j � | _ n g | _ d S( N( R_ Rk Rr t addresslist( Rj Rh ( ( s( /usr/lib64/python2.7/email/_parseaddr.pyRk � s c C s t | j � S( N( R< R� ( Rj ( ( s( /usr/lib64/python2.7/email/_parseaddr.pyt __len__� s c C sS t d � } | j | _ x3 | j D]( } | | j k r# | j j | � q# q# W| S( N( R� R? R� R> ( Rj t othert newaddrt x( ( s( /usr/lib64/python2.7/email/_parseaddr.pyt __add__� s c C s: x3 | j D]( } | | j k r | j j | � q q W| S( N( R� R> ( Rj R� R� ( ( s( /usr/lib64/python2.7/email/_parseaddr.pyt __iadd__� s c C sF t d � } x3 | j D]( } | | j k r | j j | � q q W| S( N( R� R? R� R> ( Rj R� R� R� ( ( s( /usr/lib64/python2.7/email/_parseaddr.pyt __sub__� s c C s: x3 | j D]( } | | j k r | j j | � q q W| S( N( R� t remove( Rj R� R� ( ( s( /usr/lib64/python2.7/email/_parseaddr.pyt __isub__� s c C s | j | S( N( R� ( Rj RA ( ( s( /usr/lib64/python2.7/email/_parseaddr.pyt __getitem__� s ( R� R� R� Rk R� R� R� R� R� R� ( ( ( s( /usr/lib64/python2.7/email/_parseaddr.pyR� � s ( R� t __all__RX RZ Rw R� t COMMASPACER@ R: RF R R R R R_ R� ( ( ( s( /usr/lib64/python2.7/email/_parseaddr.pyt <module> s4 b � " message.pyo 0000644 00000070004 15204114626 0006723 0 ustar 00 � { fc @ s� d Z d g Z d d l Z d d l Z d d l Z d d l Z d d l m Z d d l Z d d l m Z d d l m Z d Z e j d � Z d � Z d e d � Z d � Z d � Z d d d � � YZ d S( s8 Basic message object for the email package object model.t Messagei����N( t StringIO( t utils( t errorss ; s [ \(\)<>@,;:\\"/\[\]\?=]c C sD | j d � \ } } } | s. | j � d f S| j � | j � f S( Nt ;( t partitiont stript None( t paramt at sept b( ( s% /usr/lib64/python2.7/email/message.pyt _splitparam s c C s� | d k r� t | � d k r� t | t � r[ | d 7} t j | d | d | d � } n | sp t j | � r� d | t j | � f Sd | | f Sn | Sd S( s� Convenience function to format and return a key=value pair. This will quote the value if needed or if quote is true. If value is a three tuple (charset, language, value), it will be encoded according to RFC2231 rules. i t *i i s %s="%s"s %s=%sN( R t lent isinstancet tupleR t encode_rfc2231t tspecialst searcht quote( R t valueR ( ( s% /usr/lib64/python2.7/email/message.pyt _formatparam& s $c C s g } x| d d k r| d } | j d � } xR | d k r� | j d d | � | j d d | � d r� | j d | d � } q5 W| d k r� t | � } n | | } d | k r� | j d � } | | j � j � d | | d j � } n | j | j � � | | } q W| S( Ni R i t "s \"i t =( t findt countR t indexR t lowert append( t st plistt endt ft i( ( s% /usr/lib64/python2.7/email/message.pyt _parseparam> s ; /c C sB t | t � r1 | d | d t j | d � f St j | � Sd S( Ni i i ( R R R t unquote( R ( ( s% /usr/lib64/python2.7/email/message.pyt _unquotevalueP s "c B s� e Z d Z d � Z d � Z e d � Z d � Z d � Z d � Z d � Z d. e d � Z d. d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d. d � Z d. d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z! d � Z" d. d e# d � Z$ d. d e# d! � Z% d" e# d. d# d$ � Z& d e# d% � Z' d" e# d& � Z( d. d' � Z) d. d( � Z* d) � Z+ d. d* � Z, d. d+ � Z- d, d- l. m/ Z/ RS(/ s� Basic message object. A message object is defined as something that has a bunch of RFC 2822 headers and a payload. It may optionally have an envelope header (a.k.a. Unix-From or From_ header). If the message is a container (i.e. a multipart or a message/rfc822), then the payload is a list of Message objects, otherwise it is a string. Message objects implement part of the `mapping' interface, which assumes there is exactly one occurrence of the header per message. Some headers do in fact appear multiple times (e.g. Received) and for those headers, you must use the explicit API to set or get all the headers. Not all of the mapping methods are implemented. c C sJ g | _ d | _ d | _ d | _ d | _ | _ g | _ d | _ d S( Ns text/plain( t _headersR t _unixfromt _payloadt _charsett preamblet epiloguet defectst _default_type( t self( ( s% /usr/lib64/python2.7/email/message.pyt __init__k s c C s | j d t � S( sw Return the entire formatted message as a string. This includes the headers, body, and envelope header. t unixfrom( t as_stringt True( R. ( ( s% /usr/lib64/python2.7/email/message.pyt __str__v s c C sB d d l m } t � } | | � } | j | d | �| j � S( s� Return the entire formatted message as a string. Optional `unixfrom' when True, means include the Unix From_ envelope header. This is a convenience method and may not generate the message exactly as you intend because by default it mangles lines that begin with "From ". For more flexibility, use the flatten() method of a Generator instance. i����( t GeneratorR0 ( t email.generatorR4 R t flattent getvalue( R. R0 R4 t fpt g( ( s% /usr/lib64/python2.7/email/message.pyR1 | s c C s t | j t � S( s6 Return True if the message consists of multiple parts.( R R( t list( R. ( ( s% /usr/lib64/python2.7/email/message.pyt is_multipart� s c C s | | _ d S( N( R' ( R. R0 ( ( s% /usr/lib64/python2.7/email/message.pyt set_unixfrom� s c C s | j S( N( R' ( R. ( ( s% /usr/lib64/python2.7/email/message.pyt get_unixfrom� s c C s2 | j d k r | g | _ n | j j | � d S( s� Add the given payload to the current payload. The current payload will always be a list of objects after this method is called. If you want to set the payload to a scalar object, use set_payload() instead. N( R( R R ( R. t payload( ( s% /usr/lib64/python2.7/email/message.pyt attach� s c C s9 | d k r | j } n; t | j t � sF t d t | j � � � n | j | } | r5| j � ri d S| j d d � j � } | d k r� t j | � S| d k r� y t j | � SWq2t j k r� | SXq5| d k r5t � } y0 t j t | d � | d t �| j � } Wq2t j k r.| SXq5n | S( sZ Return a reference to the payload. The payload will either be a list object or a string. If you mutate the list object, you modify the message's payload in place. Optional i returns that index into the payload. Optional decode is a flag indicating whether the payload should be decoded or not, according to the Content-Transfer-Encoding header (default is False). When True and the message is not a multipart, the payload will be decoded if this header's value is `quoted-printable' or `base64'. If some other encoding is used, or the header is missing, or if the payload has bogus data (i.e. bogus base64 or uuencoded data), the payload is returned as-is. If the message is a multipart and the decode flag is True, then None is returned. s Expected list, got %ss content-transfer-encodingt s quoted-printablet base64s x-uuencodet uuencodet uues x-uues t quietN( s x-uuencodeRB RC s x-uue( R R( R R: t TypeErrort typeR; t getR R t _qdecodet _bdecodet binasciit ErrorR t uut decodeR2 R7 ( R. R" RM R> t ctet sfp( ( s% /usr/lib64/python2.7/email/message.pyt get_payload� s0 c C s) | | _ | d k r% | j | � n d S( s� Set the payload to the given value. Optional charset sets the message's default character set. See set_charset() for details. N( R( R t set_charset( R. R> t charset( ( s% /usr/lib64/python2.7/email/message.pyt set_payload� s c C s� | d k r& | j d � d | _ d St | t � rJ t j j | � } n t | t j j � sn t | � � n | | _ d | k r� | j d d � n d | k r� | j d d d | j � �n | j d | j � � t | j t � r| j j | j � | _ n t | � | j � k r4| j | j � | _ n d | k r�| j � } y | | � Wq�t k r�| j | j � | _ | j d | � q�Xn d S( s� Set the charset of the payload to a given character set. charset can be a Charset instance, a string naming a character set, or None. If it is a string it will be converted to a Charset instance. If charset is None, the charset parameter will be removed from the Content-Type field. Anything else will generate a TypeError. The message will be assumed to be of type text/* encoded with charset.input_charset. It will be converted to charset.output_charset and encoded properly, if needed, when generating the plain text representation of the message. MIME headers (MIME-Version, Content-Type, Content-Transfer-Encoding) will be added as needed. RR Ns MIME-Versions 1.0s Content-Types text/plains Content-Transfer-Encoding( R t del_paramR) R t basestringt emailRR t CharsetRE t add_headert get_output_charsett set_paramR( t unicodet encodet output_charsett strt body_encodet get_body_encoding( R. RR RN ( ( s% /usr/lib64/python2.7/email/message.pyRQ � s4 c C s | j S( sK Return the Charset instance associated with the message's payload. ( R) ( R. ( ( s% /usr/lib64/python2.7/email/message.pyt get_charset s c C s t | j � S( s9 Return the total number of headers, including duplicates.( R R& ( R. ( ( s% /usr/lib64/python2.7/email/message.pyt __len__ s c C s | j | � S( s- Get a header value. Return None if the header is missing instead of raising an exception. Note that if the header appeared multiple times, exactly which occurrence gets returned is undefined. Use get_all() to get all the values matching a header field name. ( RG ( R. t name( ( s% /usr/lib64/python2.7/email/message.pyt __getitem__ s c C s | j j | | f � d S( s� Set the value of a header. Note: this does not overwrite an existing header with the same field name. Use __delitem__() first to delete any existing headers. N( R& R ( R. Rc t val( ( s% /usr/lib64/python2.7/email/message.pyt __setitem__( s c C sa | j � } g } x? | j D]4 \ } } | j � | k r | j | | f � q q W| | _ d S( sw Delete all occurrences of a header, if present. Does not raise an exception if the header is missing. N( R R& R ( R. Rc t newheaderst kt v( ( s% /usr/lib64/python2.7/email/message.pyt __delitem__0 s c C s2 | j � g | j D] \ } } | j � ^ q k S( N( R R& ( R. Rc Rh Ri ( ( s% /usr/lib64/python2.7/email/message.pyt __contains__< s c C s t � } | j | | � | k S( s/ Return true if the message contains the header.( t objectRG ( R. Rc t missing( ( s% /usr/lib64/python2.7/email/message.pyt has_key? s c C s g | j D] \ } } | ^ q S( s. Return a list of all the message's header field names. These will be sorted in the order they appeared in the original message, or were added to the message, and may contain duplicates. Any fields deleted and re-inserted are always appended to the header list. ( R& ( R. Rh Ri ( ( s% /usr/lib64/python2.7/email/message.pyt keysD s c C s g | j D] \ } } | ^ q S( s) Return a list of all the message's header values. These will be sorted in the order they appeared in the original message, or were added to the message, and may contain duplicates. Any fields deleted and re-inserted are always appended to the header list. ( R& ( R. Rh Ri ( ( s% /usr/lib64/python2.7/email/message.pyt valuesN s c C s | j S( s' Get all the message's header fields and values. These will be sorted in the order they appeared in the original message, or were added to the message, and may contain duplicates. Any fields deleted and re-inserted are always appended to the header list. ( R& ( R. ( ( s% /usr/lib64/python2.7/email/message.pyt itemsX s c C s@ | j � } x- | j D]" \ } } | j � | k r | Sq W| S( s~ Get a header value. Like __getitem__() but return failobj instead of None when the field is missing. ( R R& ( R. Rc t failobjRh Ri ( ( s% /usr/lib64/python2.7/email/message.pyRG b s c C s\ g } | j � } x9 | j D]. \ } } | j � | k r | j | � q q W| sX | S| S( sQ Return a list of all the values for the named field. These will be sorted in the order they appeared in the original message, and may contain duplicates. Any fields deleted and re-inserted are always appended to the header list. If no such fields exist, failobj is returned (defaults to None). ( R R& R ( R. Rc Rr Rp Rh Ri ( ( s% /usr/lib64/python2.7/email/message.pyt get_allr s c K s� g } xd | j � D]V \ } } | d k rG | j | j d d � � q | j t | j d d � | � � q W| d k r� | j d | � n | j j | t j | � f � d S( s� Extended header setting. name is the header field to add. keyword arguments can be used to set additional parameters for the header field, with underscores converted to dashes. Normally the parameter will be added as key="value" unless value is None, in which case only the key will be added. If a parameter value contains non-ASCII characters it must be specified as a three-tuple of (charset, language, value), in which case it will be encoded according to RFC2231 rules. Example: msg.add_header('content-disposition', 'attachment', filename='bud.gif') t _t -i N( Rq R R t replaceR t insertR& t SEMISPACEt join( R. t _namet _valuet _paramst partsRh Ri ( ( s% /usr/lib64/python2.7/email/message.pyRX � s & c C s} | j � } xj t t t | j � � | j � D]; \ } \ } } | j � | k r. | | f | j | <Pq. q. Wt | � � d S( s� Replace a header. Replace the first matching header found in the message, retaining header order and case. If no matching header was found, a KeyError is raised. N( R t zipt rangeR R& t KeyError( R. Rz R{ R" Rh Ri ( ( s% /usr/lib64/python2.7/email/message.pyt replace_header� s 4c C sd t � } | j d | � } | | k r1 | j � St | � d j � } | j d � d k r` d S| S( s0 Return the message's content type. The returned string is coerced to lower case of the form `maintype/subtype'. If there was no Content-Type header in the message, the default type as given by get_default_type() will be returned. Since according to RFC 2045, messages always have a default type this will always return a value. RFC 2045 defines a message's default type to be text/plain unless it appears inside a multipart/digest container, in which case it would be message/rfc822. s content-typei t /i s text/plain( Rl RG t get_default_typeR R R ( R. Rm R t ctype( ( s% /usr/lib64/python2.7/email/message.pyt get_content_type� s c C s | j � } | j d � d S( s� Return the message's main content type. This is the `maintype' part of the string returned by get_content_type(). R� i ( R� t split( R. R� ( ( s% /usr/lib64/python2.7/email/message.pyt get_content_maintype� s c C s | j � } | j d � d S( s� Returns the message's sub-content type. This is the `subtype' part of the string returned by get_content_type(). R� i ( R� R� ( R. R� ( ( s% /usr/lib64/python2.7/email/message.pyt get_content_subtype� s c C s | j S( s Return the `default' content type. Most messages have a default content type of text/plain, except for messages that are subparts of multipart/digest containers. Such subparts have a default content type of message/rfc822. ( R- ( R. ( ( s% /usr/lib64/python2.7/email/message.pyR� � s c C s | | _ d S( s� Set the `default' content type. ctype should be either "text/plain" or "message/rfc822", although this is not enforced. The default content type is not stored in the Content-Type header. N( R- ( R. R� ( ( s% /usr/lib64/python2.7/email/message.pyt set_default_type� s c C s� t � } | j | | � } | | k r+ | Sg } x� t d | � D]s } y4 | j d d � \ } } | j � } | j � } Wn# t k r� | j � } d } n X| j | | f � qB Wt j | � } | S( NR R i R@ ( Rl RG R# R� R t ValueErrorR R t decode_params( R. Rr t headerRm R t paramst pRc Re ( ( s% /usr/lib64/python2.7/email/message.pyt _get_params_preserve� s s content-typec C sb t � } | j | | � } | | k r+ | S| rZ g | D] \ } } | t | � f ^ q8 S| Sd S( sm Return the message's Content-Type parameters, as a list. The elements of the returned list are 2-tuples of key/value pairs, as split on the `=' sign. The left hand side of the `=' is the key, while the right hand side is the value. If there is no `=' sign in the parameter the value is the empty string. The value is as described in the get_param() method. Optional failobj is the object to return if there is no Content-Type header. Optional header is the header to search instead of Content-Type. If unquote is True, the value is unquoted. N( Rl R� R% ( R. Rr R� R$ Rm R� Rh Ri ( ( s% /usr/lib64/python2.7/email/message.pyt get_params s )c C sf | | k r | SxO | j | | � D]; \ } } | j � | j � k r# | rW t | � S| Sq# q# W| S( s� Return the parameter value if found in the Content-Type header. Optional failobj is the object to return if there is no Content-Type header, or the Content-Type header has no such parameter. Optional header is the header to search instead of Content-Type. Parameter keys are always compared case insensitively. The return value can either be a string, or a 3-tuple if the parameter was RFC 2231 encoded. When it's a 3-tuple, the elements of the value are of the form (CHARSET, LANGUAGE, VALUE). Note that both CHARSET and LANGUAGE can be None, in which case you should consider VALUE to be encoded in the us-ascii charset. You can usually ignore LANGUAGE. Your application should be prepared to deal with 3-tuple return values, and can convert the parameter to a Unicode string like so: param = msg.get_param('foo') if isinstance(param, tuple): param = unicode(param[2], param[0] or 'us-ascii') In any case, the parameter value (either the returned string, or the VALUE item in the 3-tuple) is always unquoted, unless unquote is set to False. ( R� R R% ( R. R Rr R� R$ Rh Ri ( ( s% /usr/lib64/python2.7/email/message.pyt get_param s s Content-TypeR@ c C sw t | t � r( | r( | | | f } n | | k rO | j � d k rO d } n | j | � } | j | d | �s� | s� t | | | � } qJt j | t | | | � g � } n� d } x� | j d | d | � D]u \ } } d } | j � | j � k rt | | | � } n t | | | � } | s1| } q� t j | | g � } q� W| | j | � k rs| | =| | | <n d S( s� Set a parameter in the Content-Type header. If the parameter already exists in the header, its value will be replaced with the new value. If header is Content-Type and has not yet been defined for this message, it will be set to "text/plain" and the new parameter and value will be appended as per RFC 2045. An alternate header can be specified in the header argument, and all parameters will be quoted as necessary unless requote is False. If charset is specified, the parameter will be encoded according to RFC 2231. Optional language specifies the RFC 2231 language, defaulting to the empty string. Both charset and language should be strings. s content-types text/plainR� R@ R$ N( R R R RG R� R Rx Ry R� ( R. R R R� t requoteRR t languageR� t old_paramt old_valuet append_param( ( s% /usr/lib64/python2.7/email/message.pyRZ ; s. c C s� | | k r d Sd } x} | j d | d | � D]c \ } } | j � | j � k r/ | sn t | | | � } q� t j | t | | | � g � } q/ q/ W| | j | � k r� | | =| | | <n d S( s> Remove the given parameter completely from the Content-Type header. The header will be re-written in place without the parameter or its value. All values will be quoted as necessary unless requote is False. Optional header specifies an alternative to the Content-Type header. NR@ R� R$ ( R� R R Rx Ry RG ( R. R R� R� t new_ctypeR� Ri ( ( s% /usr/lib64/python2.7/email/message.pyRT k s % c C s� | j d � d k s t � n | j � d k rD | d =d | d <n | | k r^ | | | <d S| j d | d | � } | | =| | | <x. | d D]" \ } } | j | | | | � q� Wd S( sK Set the main type and subtype for the Content-Type header. type must be a string in the form "maintype/subtype", otherwise a ValueError is raised. This method replaces the Content-Type header, keeping all the parameters in place. If requote is False, this leaves the existing header's quoting as is. Otherwise, the parameters will be quoted (the default). An alternative header can be specified in the header argument. When the Content-Type header is set, we'll always also add a MIME-Version header. R� i s content-types mime-versions 1.0s MIME-VersionNR� R$ ( R R� R R� RZ ( R. RF R� R� R� R� Ri ( ( s% /usr/lib64/python2.7/email/message.pyt set_type� s c C se t � } | j d | d � } | | k rB | j d | d � } n | | k rR | St j | � j � S( s@ Return the filename associated with the payload if present. The filename is extracted from the Content-Disposition header's `filename' parameter, and it is unquoted. If that header is missing the `filename' parameter, this method falls back to looking for the `name' parameter. t filenames content-dispositionRc s content-type( Rl R� R t collapse_rfc2231_valueR ( R. Rr Rm R� ( ( s% /usr/lib64/python2.7/email/message.pyt get_filename� s c C s> t � } | j d | � } | | k r+ | St j | � j � S( s� Return the boundary associated with the payload if present. The boundary is extracted from the Content-Type header's `boundary' parameter, and it is unquoted. t boundary( Rl R� R R� t rstrip( R. Rr Rm R� ( ( s% /usr/lib64/python2.7/email/message.pyt get_boundary� s c C s� t � } | j | d � } | | k r9 t j d � � n g } t } xY | D]Q \ } } | j � d k r� | j d d | f � t } qL | j | | f � qL W| s� | j d d | f � n g } x� | j D]� \ } } | j � d k r^g } xG | D]? \ } } | d k r$| j | � q� | j d | | f � q� W| j | t j | � f � q� | j | | f � q� W| | _ d S( s� Set the boundary parameter in Content-Type to 'boundary'. This is subtly different than deleting the Content-Type header and adding a new one with a new boundary parameter via add_header(). The main difference is that using the set_boundary() method preserves the order of the Content-Type header in the original message. HeaderParseError is raised if the message has no Content-Type header. s content-types No Content-Type header foundR� s "%s"R@ s %s=%sN( Rl R� R t HeaderParseErrort FalseR R R2 R& Rx Ry ( R. R� Rm R� t newparamst foundpt pkt pvRg t hRi R} Rh ( ( s% /usr/lib64/python2.7/email/message.pyt set_boundary� s0 c C s� t � } | j d | � } | | k r+ | St | t � r� | d pG d } y t | d | � j d � } Wq� t t f k r� | d } q� Xn y4 t | t � r� t | d � } n | j d � } Wn t k r� | SX| j � S( s� Return the charset parameter of the Content-Type header. The returned string is always coerced to lower case. If there is no Content-Type header, or if that header has no charset parameter, failobj is returned. RR i s us-asciii ( Rl R� R R R[ R\ t LookupErrort UnicodeErrorR^ R ( R. Rr Rm RR t pcharset( ( s% /usr/lib64/python2.7/email/message.pyt get_content_charset� s" c C s& g | j � D] } | j | � ^ q S( s� Return a list containing the charset(s) used in this message. The returned list of items describes the Content-Type headers' charset parameter for this message and all the subparts in its payload. Each item will either be a string (the value of the charset parameter in the Content-Type header of that part) or the value of the 'failobj' parameter (defaults to None), if the part does not have a main MIME type of "text", or the charset is not defined. The list will contain one string for each part of the message, plus one for the container message (i.e. self), so that a non-multipart message will still return a list of length 1. ( t walkR� ( R. Rr t part( ( s% /usr/lib64/python2.7/email/message.pyt get_charsets s i����( R� N(0 t __name__t __module__t __doc__R/ R3 R� R1 R; R< R= R? R RP RS RQ Ra Rb Rd Rf Rj Rk Rn Ro Rp Rq RG Rs RX R� R� R� R� R� R� R� R2 R� R� RZ RT R� R� R� R� R� R� t email.iteratorsR� ( ( ( s% /usr/lib64/python2.7/email/message.pyR \ sX 2 - #/ - ( ( R� t __all__t reRL RJ t warningst cStringIOR t email.charsetRV R R Rx t compileR R R R2 R R# R% R ( ( ( s% /usr/lib64/python2.7/email/message.pyt <module> s generator.pyc 0000644 00000024214 15204114626 0007253 0 ustar 00 � { fc @ s� d Z d d g Z d d l Z d d l Z d d l Z d d l Z d d l Z d d l m Z d d l m Z d Z d Z e j d e j � Z d � Z d f d � � YZ d Z d e f d � � YZ e e e j d � � Z d e Z e d � Z d S( s: Classes to generate plain text from a message object tree.t Generatort DecodedGeneratori����N( t StringIO( t Headert _s s ^From c C s< t | t � r8 y t | d � Wq8 t k r4 t SXn t S( Ns us-ascii( t isinstancet strt unicodet UnicodeErrort Truet False( t s( ( s' /usr/lib64/python2.7/email/generator.pyt _is8bitstring s c B s� e Z d Z e d d � Z d � Z e d � Z d � Z d � Z d � Z d � Z d � Z e Z d � Z d � Z d � Z d � Z RS( s� Generates output from a Message object tree. This basic generator writes the message to the given file object as plain text. iN c C s | | _ | | _ | | _ d S( s� Create the generator for message flattening. outfp is the output file-like object for writing the message to. It must have a write() method. Optional mangle_from_ is a flag that, when True (the default), escapes From_ lines in the body of the message by putting a `>' in front of them. Optional maxheaderlen specifies the longest length for a non-continued header. When a header line is longer (in characters, with tabs expanded to 8 spaces) than maxheaderlen, the header will split as defined in the Header class. Set maxheaderlen to zero to disable header wrapping. The default is 78, as recommended (but not required) by RFC 2822. N( t _fpt _mangle_from_t _maxheaderlen( t selft outfpt mangle_from_t maxheaderlen( ( s' /usr/lib64/python2.7/email/generator.pyt __init__* s c C s | j j | � d S( N( R t write( R R ( ( s' /usr/lib64/python2.7/email/generator.pyR ? s c C sU | rD | j � } | s4 d t j t j � � } n | j | IJn | j | � d S( s� Print the message object tree rooted at msg to the output file specified when the Generator instance was created. unixfrom is a flag that forces the printing of a Unix From_ delimiter before the first object in the message tree. If the original message has no From_ delimiter, a `standard' one is crafted. By default, this is False to inhibit the printing of any From_ delimiter. Note that for subobjects, no From_ line is printed. s From nobody N( t get_unixfromt timet ctimeR t _write( R t msgt unixfromt ufrom( ( s' /usr/lib64/python2.7/email/generator.pyt flattenC s c C s | j | | j | j � S( s1 Clone this generator with the exact same options.( t __class__R R ( R t fp( ( s' /usr/lib64/python2.7/email/generator.pyt cloneU s c C s� | j } z! t � | _ } | j | � Wd | | _ Xt | d d � } | d k re | j | � n | | � | j j | j � � d S( Nt _write_headers( R R t _dispatcht getattrt NoneR! R t getvalue( R R t oldfpt sfpt meth( ( s' /usr/lib64/python2.7/email/generator.pyR ] s c C s� | j � } | j � } t j | | f � j d d � } t | d | d � } | d k r� | j d d � } t | d | d � } | d k r� | j } q� n | | � d S( Nt -R t _handle_( t get_content_maintypet get_content_subtypet UNDERSCOREt joint replaceR# R$ t _writeBody( R R t maint subt specificR( t generic( ( s' /usr/lib64/python2.7/email/generator.pyR" x s ! c C s� x� | j � D]� \ } } | j d | I| j d k rI | j | IJq t | t � rn | j | j � IJq t | � r� | j | IJq | j t | d | j d | �j � IJq W| j Jd S( Ns %s:i t maxlinelent header_name( t itemsR R R R t encodeR ( R R t ht v( ( s' /usr/lib64/python2.7/email/generator.pyR! � s "c C sv | j � } | d k r d St | t � sD t d t | � � � n | j rb t j d | � } n | j j | � d S( Ns string payload expected: %ss >From ( t get_payloadR$ R t basestringt TypeErrort typeR t fcreR2 R R ( R R t payload( ( s' /usr/lib64/python2.7/email/generator.pyt _handle_text� s c C s g } | j � } | d k r' g } n> t | t � rJ | j j | � d St | t � se | g } n xL | D]D } t � } | j | � } | j | d t �| j | j � � ql W| j � } | s� t j | � } t | � } | j | � n | j d k r:| j r!t j d | j � } n | j } | j | IJn | j d | IJ| rm| j j | j d � � n x/ | D]' } | j d | IJ| j j | � qtW| j j d | d t � | j d k r| j r�t j d | j � } n | j } | j j | � n d S( NR s >From s --i s --( R; R$ R R< R R t listR R R R t appendR% t get_boundaryt NLR. t _make_boundaryt set_boundaryt preambleR R? R2 t popt epilogue( R R t msgtextst subpartst partR t gt boundaryt alltextRH t body_partRJ ( ( s' /usr/lib64/python2.7/email/generator.pyt _handle_multipart� sH c C s4 | j } z d | _ | j | � Wd | | _ Xd S( Ni ( R RR ( R R t old_maxheaderlen( ( s' /usr/lib64/python2.7/email/generator.pyt _handle_multipart_signed� s c C s� g } x� | j � D]� } t � } | j | � } | j | d t �| j � } | j d � } | r� | d d k r� | j t j | d � � q | j | � q W| j j t j | � � d S( NR s i����t ( R; R R R R R% t splitRC RE R. R R ( R R t blocksRM R RN t textt lines( ( s' /usr/lib64/python2.7/email/generator.pyt _handle_message_delivery_status� s c C sr t � } | j | � } | j � } t | t � r^ | j | j d � d t �| j � } n | j j | � d S( Ni R ( R R R; R RB R R R% R R ( R R R RN R@ ( ( s' /usr/lib64/python2.7/email/generator.pyt _handle_message s ( t __name__t __module__t __doc__R R R R R R R R" R! RA R0 RR RT RZ R[ ( ( ( s' /usr/lib64/python2.7/email/generator.pyR s 9 sD [Non-text (%(type)s) part of message omitted, filename %(filename)s]c B s) e Z d Z e d d d � Z d � Z RS( s� Generates a text representation of a message. Like the Generator base class, except that non-text parts are substituted with a format string representing the part. iN c C s; t j | | | | � | d k r. t | _ n | | _ d S( s� Like Generator.__init__() except that an additional optional argument is allowed. Walks through all subparts of a message. If the subpart is of main type `text', then it prints the decoded payload of the subpart. Otherwise, fmt is a format string that is used instead of the message payload. fmt is expanded with the following keywords (in %(keyword)s format): type : Full MIME type of the non-text part maintype : Main MIME type of the non-text part subtype : Sub-MIME type of the non-text part filename : Filename of the non-text part description: Description associated with the non-text part encoding : Content transfer encoding of the non-text part The default value for fmt is None, meaning [Non-text (%(type)s) part of message omitted, filename %(filename)s] N( R R R$ t _FMTt _fmt( R R R R t fmt( ( s' /usr/lib64/python2.7/email/generator.pyR . s c C s� x� | j � D]� } | j � } | d k rD | | j d t � IJq | d k rS q | | j i | j � d 6| j � d 6| j � d 6| j d � d 6| j d d � d 6| j d d � d 6IJq Wd S( NRX t decodet multipartR> t maintypet subtypes [no filename]t filenames Content-Descriptions [no description]t descriptions Content-Transfer-Encodings [no encoding]t encoding( t walkR+ R; R R` t get_content_typeR, t get_filenamet get( R R RM Rd ( ( s' /usr/lib64/python2.7/email/generator.pyR" J s N( R\ R] R^ R R$ R R" ( ( ( s' /usr/lib64/python2.7/email/generator.pyR ( s i s %%0%ddc C s� t j t j � } d t | d } | d k r4 | S| } d } xa t r� t j d t j | � d t j � } | j | � s� Pn | d t | � } | d 7} qC W| S( Nt =i s ==i s ^--s (--)?$t .i s ===============( t randomt randranget syst maxintR` R$ R t ret compilet escapet MULTILINEt searchR ( RX t tokenRO t bt countert cre( ( s' /usr/lib64/python2.7/email/generator.pyRF d s &( R^ t __all__Rs Rq R Ro t warningst cStringIOR t email.headerR R- RE Rt Rv R? R R R_ R t lent reprRr t _widthR` R$ RF ( ( ( s' /usr/lib64/python2.7/email/generator.pyt <module> s& � 9 charset.pyc 0000644 00000032345 15204114626 0006722 0 ustar 00 � { fc @ s� d d d d g Z d d l Z d d l Z d d l Z d d l m Z d d l m Z d Z d Z d Z d Z d Z i e e d f d 6e e d f d 6e e d f d 6e e d f d 6e e d f d 6e e d f d 6e e d f d 6e e d f d 6e e d f d 6e e d f d 6e e d f d 6e e d f d 6dA d 6e e d f d 6e e d f d 6e d d f d 6e d d f d 6e d d f d 6e e d f d 6e e d f d 6d e d f d 6Z i d d! 6d d" 6d d# 6d d$ 6d d% 6d d& 6d d' 6d d( 6d d) 6d d* 6d d+ 6d d, 6d d- 6d d. 6d d/ 6d d0 6d d1 6d d2 6d d3 6d d4 6d5 d6 6d d7 6d8 d9 6d d: 6Z i d; d 6d< d 6d d 6Z d d d d= � Z d> � Z d? � Z d dB d@ � � YZ d S(C t Charsett add_aliast add_charsett add_codeci����N( t errors( t encode_7or8biti i i i s us-asciis iso-8859-1s iso-8859-2s iso-8859-3s iso-8859-4s iso-8859-9s iso-8859-10s iso-8859-13s iso-8859-14s iso-8859-15s iso-8859-16s windows-1252t visciit big5t gb2312s iso-2022-jps euc-jpt shift_jiss koi8-rs utf-8t 8bitt latin_1s latin-1t latin_2s latin-2t latin_3s latin-3t latin_4s latin-4t latin_5s latin-5t latin_6s latin-6t latin_7s latin-7t latin_8s latin-8t latin_9s latin-9t latin_10s latin-10s ks_c_5601-1987t cp949t euc_jps euc-krt euc_krt asciit eucgb2312_cnt big5_twc C s2 | t k r t d � � n | | | f t | <d S( s> Add character set properties to the global registry. charset is the input character set, and must be the canonical name of a character set. Optional header_enc and body_enc is either Charset.QP for quoted-printable, Charset.BASE64 for base64 encoding, Charset.SHORTEST for the shortest of qp or base64 encoding, or None for no encoding. SHORTEST is only valid for header_enc. It describes how message headers and message bodies in the input charset are to be encoded. Default is no encoding. Optional output_charset is the character set that the output should be in. Conversions will proceed from input charset, to Unicode, to the output charset when the method Charset.convert() is called. The default is to output in the same character set as the input. Both input_charset and output_charset must have Unicode codec entries in the module's charset-to-codec mapping; use add_codec(charset, codecname) to add codecs the module does not know about. See the codecs module's documentation for more information. s! SHORTEST not allowed for body_encN( t SHORTESTt ValueErrort CHARSETS( t charsett header_enct body_enct output_charset( ( s% /usr/lib64/python2.7/email/charset.pyR l s c C s | t | <d S( s� Add a character set alias. alias is the alias name, e.g. latin-1 canonical is the character set's canonical name, e.g. iso-8859-1 N( t ALIASES( t aliast canonical( ( s% /usr/lib64/python2.7/email/charset.pyR � s c C s | t | <d S( s$ Add a codec that map characters in the given charset to/from Unicode. charset is the canonical name of a character set. codecname is the name of a Python codec, as appropriate for the second argument to the unicode() built-in, or to the encode() method of a Unicode string. N( t CODEC_MAP( R t codecname( ( s% /usr/lib64/python2.7/email/charset.pyR � s c B s� e Z d Z e d � Z d � Z e Z d � Z d � Z d � Z d � Z d � Z e d � Z d � Z d � Z e d � Z e d � Z RS( s@ Map character sets to their email properties. This class provides information about the requirements imposed on email for a specific character set. It also provides convenience routines for converting between character sets, given the availability of the applicable codecs. Given a character set, it will do its best to provide information on how to use that character set in an email in an RFC-compliant way. Certain character sets must be encoded with quoted-printable or base64 when used in email headers or bodies. Certain character sets must be converted outright, and are not allowed in email. Instances of this module expose the following information about a character set: input_charset: The initial character set specified. Common aliases are converted to their `official' email names (e.g. latin_1 is converted to iso-8859-1). Defaults to 7-bit us-ascii. header_encoding: If the character set must be encoded before it can be used in an email header, this attribute will be set to Charset.QP (for quoted-printable), Charset.BASE64 (for base64 encoding), or Charset.SHORTEST for the shortest of QP or BASE64 encoding. Otherwise, it will be None. body_encoding: Same as header_encoding, but describes the encoding for the mail message's body, which indeed may be different than the header encoding. Charset.SHORTEST is not allowed for body_encoding. output_charset: Some character sets must be converted before they can be used in email headers or bodies. If the input_charset is one of them, this attribute will contain the name of the charset output will be converted to. Otherwise, it will be None. input_codec: The name of the Python codec used to convert the input_charset to Unicode. If no conversion codec is necessary, this attribute will be None. output_codec: The name of the Python codec used to convert Unicode to the output_charset. If no conversion codec is necessary, this attribute will have the same value as the input_codec. c C s^ y2 t | t � r" | j d � n t | d � } Wn t k rT t j | � � n X| j � j d � } | t k p | t k s� y t j | � j } Wq� t k r� q� Xn t j | | � | _ t j | j t t d f � \ } } } | s� | j } n | | _ | | _ t j | | � | _ t j | j | j � | _ t j | j | j � | _ d S( NR ( t isinstancet unicodet encodet UnicodeErrorR t CharsetErrort lowerR" R t codecst lookupt namet LookupErrort gett input_charsetR t BASE64t Nonet header_encodingt body_encodingR! R% t input_codect output_codec( t selfR2 t henct benct conv( ( s% /usr/lib64/python2.7/email/charset.pyt __init__� s0 c C s | j j � S( N( R2 R, ( R9 ( ( s% /usr/lib64/python2.7/email/charset.pyt __str__� s c C s t | � t | � j � k S( N( t strR, ( R9 t other( ( s% /usr/lib64/python2.7/email/charset.pyt __eq__� s c C s | j | � S( N( RA ( R9 R@ ( ( s% /usr/lib64/python2.7/email/charset.pyt __ne__� s c C sC | j t k s t � | j t k r( d S| j t k r; d St Sd S( sC Return the content-transfer-encoding used for body encoding. This is either the string `quoted-printable' or `base64' depending on the encoding used, or it is a function in which case you should call the function with a single argument, the Message object being encoded. The function should then set the Content-Transfer-Encoding header itself to whatever is appropriate. Returns "quoted-printable" if self.body_encoding is QP. Returns "base64" if self.body_encoding is BASE64. Returns "7bit" otherwise. s quoted-printablet base64N( R6 R t AssertionErrort QPR3 R ( R9 ( ( s% /usr/lib64/python2.7/email/charset.pyt get_body_encoding� s c C s6 | j | j k r. t | | j � j | j � S| Sd S( s: Convert a string from the input_codec to the output_codec.N( R7 R8 R( R) ( R9 t s( ( s% /usr/lib64/python2.7/email/charset.pyt convert s c C sR t | t � s | j d k r" | Sy t | | j d � SWn t k rM | SXd S( s� Convert a possibly multibyte string to a safely splittable format. Uses the input_codec to try and convert the string to Unicode, so it can be safely split on character boundaries (even for multibyte characters). Returns the string as-is if it isn't known how to convert it to Unicode with the input_charset. Characters that could not be converted to Unicode will be replaced with the Unicode replacement character U+FFFD. t replaceN( R' R( R7 R4 R0 ( R9 RG ( ( s% /usr/lib64/python2.7/email/charset.pyt to_splittable s c C sh | r | j } n | j } t | t � s7 | d k r; | Sy | j | d � SWn t k rc | SXd S( s* Convert a splittable string back into an encoded string. Uses the proper codec to try and convert the string from Unicode back into an encoded format. Return the string as-is if it is not Unicode, or if it could not be converted from Unicode. Characters that could not be converted from Unicode will be replaced with an appropriate character (usually '?'). If to_output is True (the default), uses output_codec to convert to an encoded format. If to_output is False, uses input_codec. RI N( R8 R7 R' R( R4 R) R0 ( R9 t ustrt to_outputt codec( ( s% /usr/lib64/python2.7/email/charset.pyt from_splittable+ s c C s | j p | j S( s� Return the output character set. This is self.output_charset if that is not None, otherwise it is self.input_charset. ( R! R2 ( R9 ( ( s% /usr/lib64/python2.7/email/charset.pyt get_output_charsetD s c C s� | j � } | j t k r9 t j j | � t | � t S| j t k rf t j j | � t | � t S| j t k r� t j j | � } t j j | � } t | | � t | � t St | � Sd S( s/ Return the length of the encoded header string.N( RO R5 R3 t emailt base64mimet base64_lent lent MISC_LENRE t quoprimimet header_quopri_lenR t min( R9 RG t csett lenb64t lenqp( ( s% /usr/lib64/python2.7/email/charset.pyt encoded_header_lenL s c C s� | j � } | r$ | j | � } n | j t k rF t j j | | � S| j t k rn t j j | | d d �S| j t k r� t j j | � } t j j | � } | | k r� t j j | | � St j j | | d d �Sn | Sd S( sE Header-encode a string, optionally converting it to output_charset. If convert is True, the string will be converted from the input charset to the output charset automatically. This is not useful for multibyte character sets, which have line length issues (multibyte characters must be split on a character, not a byte boundary); use the high-level Header class to deal with these issues. convert defaults to False. The type of encoding (base64 or quoted-printable) will be based on self.header_encoding. t maxlinelenN( RO RH R5 R3 RP RQ t header_encodeRE RU R4 R RR RV ( R9 RG RH RX RY RZ ( ( s% /usr/lib64/python2.7/email/charset.pyR] [ s c C s^ | r | j | � } n | j t k r7 t j j | � S| j t k rV t j j | � S| Sd S( s� Body-encode a string and convert it to output_charset. If convert is True (the default), the string will be converted from the input charset to output charset automatically. Unlike header_encode(), there are no issues with byte boundaries and multibyte charsets in email bodies, so this is usually pretty safe. The type of encoding (base64 or quoted-printable) will be based on self.body_encoding. N( RH R6 R3 RP RQ t body_encodeRE RU ( R9 RG RH ( ( s% /usr/lib64/python2.7/email/charset.pyR^ z s ( t __name__t __module__t __doc__t DEFAULT_CHARSETR= R> t __repr__RA RB RF RH RJ t TrueRN RO R[ t FalseR] R^ ( ( ( s% /usr/lib64/python2.7/email/charset.pyR � s + & ( NNN( ( t __all__R- t email.base64mimeRP t email.quoprimimeR t email.encodersR RE R3 R RT Rb R4 R R" R% R R R R ( ( ( s% /usr/lib64/python2.7/email/charset.pyt <module> s� mime/text.pyc 0000644 00000002434 15204114627 0007201 0 ustar 00 � { fc @ sI d Z d g Z d d l m Z d d l m Z d e f d � � YZ d S( s. Class representing text/* type MIME documents.t MIMETexti����( t encode_7or8bit( t MIMENonMultipartc B s e Z d Z d d d � Z RS( s0 Class for generating text/* type MIME documents.t plains us-asciic C s1 t j | d | i | d 6� | j | | � d S( s~ Create a text/* type MIME document. _text is the string for this message object. _subtype is the MIME sub content type, defaulting to "plain". _charset is the character set parameter added to the Content-Type header. This defaults to "us-ascii". Note that as a side-effect, the Content-Transfer-Encoding header will also be set. t textt charsetN( R t __init__t set_payload( t selft _textt _subtypet _charset( ( s' /usr/lib64/python2.7/email/mime/text.pyR s ( t __name__t __module__t __doc__R ( ( ( s' /usr/lib64/python2.7/email/mime/text.pyR s N( R t __all__t email.encodersR t email.mime.nonmultipartR R ( ( ( s' /usr/lib64/python2.7/email/mime/text.pyt <module> s mime/application.pyc 0000644 00000003060 15204114627 0010514 0 ustar 00 � { fc @ sI d Z d g Z d d l m Z d d l m Z d e f d � � YZ d S( s5 Class representing application/* type MIME documents.t MIMEApplicationi����( t encoders( t MIMENonMultipartc B s e Z d Z d e j d � Z RS( s2 Class for generating application/* MIME documents.s octet-streamc K sL | d k r t d � � n t j | d | | � | j | � | | � d S( s Create an application/* type MIME document. _data is a string containing the raw application data. _subtype is the MIME content type subtype, defaulting to 'octet-stream'. _encoder is a function which will perform the actual encoding for transport of the application data, defaulting to base64 encoding. Any additional keyword arguments are passed to the base class constructor, which turns them into parameters on the Content-Type header. s Invalid application MIME subtypet applicationN( t Nonet TypeErrorR t __init__t set_payload( t selft _datat _subtypet _encodert _params( ( s. /usr/lib64/python2.7/email/mime/application.pyR s ( t __name__t __module__t __doc__R t encode_base64R ( ( ( s. /usr/lib64/python2.7/email/mime/application.pyR s N( R t __all__t emailR t email.mime.nonmultipartR R ( ( ( s. /usr/lib64/python2.7/email/mime/application.pyt <module> s mime/base.pyo 0000644 00000002134 15204114627 0007140 0 ustar 00 � { fc @ s< d Z d g Z d d l m Z d e j f d � � YZ d S( s$ Base class for MIME specializations.t MIMEBasei����( t messagec B s e Z d Z d � Z RS( s$ Base class for MIME specializations.c K sA t j j | � d | | f } | j d | | � d | d <d S( s� This constructor adds a Content-Type: and a MIME-Version: header. The Content-Type: header is taken from the _maintype and _subtype arguments. Additional parameters for this header are taken from the keyword arguments. s %s/%ss Content-Types 1.0s MIME-VersionN( R t Messaget __init__t add_header( t selft _maintypet _subtypet _paramst ctype( ( s' /usr/lib64/python2.7/email/mime/base.pyR s ( t __name__t __module__t __doc__R ( ( ( s' /usr/lib64/python2.7/email/mime/base.pyR s N( R t __all__t emailR R R ( ( ( s' /usr/lib64/python2.7/email/mime/base.pyt <module> s mime/__init__.pyo 0000644 00000000202 15204114627 0007757 0 ustar 00 � { fc @ s d S( N( ( ( ( s+ /usr/lib64/python2.7/email/mime/__init__.pyt <module> t mime/multipart.pyc 0000644 00000003205 15204114627 0010233 0 ustar 00 � { fc @ s9 d Z d g Z d d l m Z d e f d � � YZ d S( s. Base class for MIME multipart/* type messages.t MIMEMultiparti����( t MIMEBasec B s e Z d Z d d d d � Z RS( s. Base class for MIME multipart/* type messages.t mixedc K s` t j | d | | � g | _ | rF x | D] } | j | � q, Wn | r\ | j | � n d S( s� Creates a multipart/* type message. By default, creates a multipart/mixed message, with proper Content-Type and MIME-Version headers. _subtype is the subtype of the multipart content type, defaulting to `mixed'. boundary is the multipart boundary string. By default it is calculated as needed. _subparts is a sequence of initial subparts for the payload. It must be an iterable object, such as a list. You can always attach new subparts to the message by using the attach() method. Additional parameters for the Content-Type header are taken from the keyword arguments (or passed into the _params argument). t multipartN( R t __init__t _payloadt attacht set_boundary( t selft _subtypet boundaryt _subpartst _paramst p( ( s, /usr/lib64/python2.7/email/mime/multipart.pyR s N( t __name__t __module__t __doc__t NoneR ( ( ( s, /usr/lib64/python2.7/email/mime/multipart.pyR s N( R t __all__t email.mime.baseR R ( ( ( s, /usr/lib64/python2.7/email/mime/multipart.pyt <module> s mime/multipart.pyo 0000644 00000003205 15204114627 0010247 0 ustar 00 � { fc @ s9 d Z d g Z d d l m Z d e f d � � YZ d S( s. Base class for MIME multipart/* type messages.t MIMEMultiparti����( t MIMEBasec B s e Z d Z d d d d � Z RS( s. Base class for MIME multipart/* type messages.t mixedc K s` t j | d | | � g | _ | rF x | D] } | j | � q, Wn | r\ | j | � n d S( s� Creates a multipart/* type message. By default, creates a multipart/mixed message, with proper Content-Type and MIME-Version headers. _subtype is the subtype of the multipart content type, defaulting to `mixed'. boundary is the multipart boundary string. By default it is calculated as needed. _subparts is a sequence of initial subparts for the payload. It must be an iterable object, such as a list. You can always attach new subparts to the message by using the attach() method. Additional parameters for the Content-Type header are taken from the keyword arguments (or passed into the _params argument). t multipartN( R t __init__t _payloadt attacht set_boundary( t selft _subtypet boundaryt _subpartst _paramst p( ( s, /usr/lib64/python2.7/email/mime/multipart.pyR s N( t __name__t __module__t __doc__t NoneR ( ( ( s, /usr/lib64/python2.7/email/mime/multipart.pyR s N( R t __all__t email.mime.baseR R ( ( ( s, /usr/lib64/python2.7/email/mime/multipart.pyt <module> s mime/message.pyo 0000644 00000002650 15204114627 0007655 0 ustar 00 � { fc @ sI d Z d g Z d d l m Z d d l m Z d e f d � � YZ d S( s, Class representing message/* MIME documents.t MIMEMessagei����( t message( t MIMENonMultipartc B s e Z d Z d d � Z RS( s, Class representing message/* MIME documents.t rfc822c C sX t j | d | � t | t j � s4 t d � � n t j j | | � | j d � d S( s� Create a message/* type MIME document. _msg is a message object and must be an instance of Message, or a derived class of Message, otherwise a TypeError is raised. Optional _subtype defines the subtype of the contained message. The default is "rfc822" (this is defined by the MIME standard, even though the term "rfc822" is technically outdated by RFC 2822). R s& Argument is not an instance of Messages message/rfc822N( R t __init__t isinstanceR t Messaget TypeErrort attacht set_default_type( t selft _msgt _subtype( ( s* /usr/lib64/python2.7/email/mime/message.pyR s ( t __name__t __module__t __doc__R ( ( ( s* /usr/lib64/python2.7/email/mime/message.pyR s N( R t __all__t emailR t email.mime.nonmultipartR R ( ( ( s* /usr/lib64/python2.7/email/mime/message.pyt <module> s mime/text.pyo 0000644 00000002434 15204114627 0007215 0 ustar 00 � { fc @ sI d Z d g Z d d l m Z d d l m Z d e f d � � YZ d S( s. Class representing text/* type MIME documents.t MIMETexti����( t encode_7or8bit( t MIMENonMultipartc B s e Z d Z d d d � Z RS( s0 Class for generating text/* type MIME documents.t plains us-asciic C s1 t j | d | i | d 6� | j | | � d S( s~ Create a text/* type MIME document. _text is the string for this message object. _subtype is the MIME sub content type, defaulting to "plain". _charset is the character set parameter added to the Content-Type header. This defaults to "us-ascii". Note that as a side-effect, the Content-Transfer-Encoding header will also be set. t textt charsetN( R t __init__t set_payload( t selft _textt _subtypet _charset( ( s' /usr/lib64/python2.7/email/mime/text.pyR s ( t __name__t __module__t __doc__R ( ( ( s' /usr/lib64/python2.7/email/mime/text.pyR s N( R t __all__t email.encodersR t email.mime.nonmultipartR R ( ( ( s' /usr/lib64/python2.7/email/mime/text.pyt <module> s mime/message.pyc 0000644 00000002650 15204114627 0007641 0 ustar 00 � { fc @ sI d Z d g Z d d l m Z d d l m Z d e f d � � YZ d S( s, Class representing message/* MIME documents.t MIMEMessagei����( t message( t MIMENonMultipartc B s e Z d Z d d � Z RS( s, Class representing message/* MIME documents.t rfc822c C sX t j | d | � t | t j � s4 t d � � n t j j | | � | j d � d S( s� Create a message/* type MIME document. _msg is a message object and must be an instance of Message, or a derived class of Message, otherwise a TypeError is raised. Optional _subtype defines the subtype of the contained message. The default is "rfc822" (this is defined by the MIME standard, even though the term "rfc822" is technically outdated by RFC 2822). R s& Argument is not an instance of Messages message/rfc822N( R t __init__t isinstanceR t Messaget TypeErrort attacht set_default_type( t selft _msgt _subtype( ( s* /usr/lib64/python2.7/email/mime/message.pyR s ( t __name__t __module__t __doc__R ( ( ( s* /usr/lib64/python2.7/email/mime/message.pyR s N( R t __all__t emailR t email.mime.nonmultipartR R ( ( ( s* /usr/lib64/python2.7/email/mime/message.pyt <module> s mime/application.pyo 0000644 00000003060 15204114627 0010530 0 ustar 00 � { fc @ sI d Z d g Z d d l m Z d d l m Z d e f d � � YZ d S( s5 Class representing application/* type MIME documents.t MIMEApplicationi����( t encoders( t MIMENonMultipartc B s e Z d Z d e j d � Z RS( s2 Class for generating application/* MIME documents.s octet-streamc K sL | d k r t d � � n t j | d | | � | j | � | | � d S( s Create an application/* type MIME document. _data is a string containing the raw application data. _subtype is the MIME content type subtype, defaulting to 'octet-stream'. _encoder is a function which will perform the actual encoding for transport of the application data, defaulting to base64 encoding. Any additional keyword arguments are passed to the base class constructor, which turns them into parameters on the Content-Type header. s Invalid application MIME subtypet applicationN( t Nonet TypeErrorR t __init__t set_payload( t selft _datat _subtypet _encodert _params( ( s. /usr/lib64/python2.7/email/mime/application.pyR s ( t __name__t __module__t __doc__R t encode_base64R ( ( ( s. /usr/lib64/python2.7/email/mime/application.pyR s N( R t __all__t emailR t email.mime.nonmultipartR R ( ( ( s. /usr/lib64/python2.7/email/mime/application.pyt <module> s mime/base.pyc 0000644 00000002134 15204114627 0007124 0 ustar 00 � { fc @ s< d Z d g Z d d l m Z d e j f d � � YZ d S( s$ Base class for MIME specializations.t MIMEBasei����( t messagec B s e Z d Z d � Z RS( s$ Base class for MIME specializations.c K sA t j j | � d | | f } | j d | | � d | d <d S( s� This constructor adds a Content-Type: and a MIME-Version: header. The Content-Type: header is taken from the _maintype and _subtype arguments. Additional parameters for this header are taken from the keyword arguments. s %s/%ss Content-Types 1.0s MIME-VersionN( R t Messaget __init__t add_header( t selft _maintypet _subtypet _paramst ctype( ( s' /usr/lib64/python2.7/email/mime/base.pyR s ( t __name__t __module__t __doc__R ( ( ( s' /usr/lib64/python2.7/email/mime/base.pyR s N( R t __all__t emailR R R ( ( ( s' /usr/lib64/python2.7/email/mime/base.pyt <module> s mime/image.pyo 0000644 00000004001 15204114627 0007303 0 ustar 00 � { fc @ sU d Z d g Z d d l Z d d l m Z d d l m Z d e f d � � YZ d S( s/ Class representing image/* type MIME documents.t MIMEImagei����N( t encoders( t MIMENonMultipartc B s e Z d Z d e j d � Z RS( s1 Class for generating image/* type MIME documents.c K sm | d k r! t j d | � } n | d k r< t d � � n t j | d | | � | j | � | | � d S( s� Create an image/* type MIME document. _imagedata is a string containing the raw image data. If this data can be decoded by the standard Python `imghdr' module, then the subtype will be automatically included in the Content-Type header. Otherwise, you can specify the specific image subtype via the _subtype parameter. _encoder is a function which will perform the actual encoding for transport of the image data. It takes one argument, which is this Image instance. It should use get_payload() and set_payload() to change the payload to the encoded form. It should also add any Content-Transfer-Encoding or other headers to the message as necessary. The default encoding is Base64. Any additional keyword arguments are passed to the base class constructor, which turns them into parameters on the Content-Type header. s" Could not guess image MIME subtypet imageN( t Nonet imghdrt whatt TypeErrorR t __init__t set_payload( t selft _imagedatat _subtypet _encodert _params( ( s( /usr/lib64/python2.7/email/mime/image.pyR s N( t __name__t __module__t __doc__R R t encode_base64R ( ( ( s( /usr/lib64/python2.7/email/mime/image.pyR s ( R t __all__R t emailR t email.mime.nonmultipartR R ( ( ( s( /usr/lib64/python2.7/email/mime/image.pyt <module> s mime/nonmultipart.pyo 0000644 00000001570 15204114630 0010757 0 ustar 00 � { fc @ sI d Z d g Z d d l m Z d d l m Z d e f d � � YZ d S( s9 Base class for MIME type messages that are not multipart.t MIMENonMultiparti����( t errors( t MIMEBasec B s e Z d Z d � Z RS( s0 Base class for MIME non-multipart type messages.c C s t j d � � d S( Ns4 Cannot attach additional subparts to non-multipart/*( R t MultipartConversionError( t selft payload( ( s/ /usr/lib64/python2.7/email/mime/nonmultipart.pyt attach s ( t __name__t __module__t __doc__R ( ( ( s/ /usr/lib64/python2.7/email/mime/nonmultipart.pyR s N( R t __all__t emailR t email.mime.baseR R ( ( ( s/ /usr/lib64/python2.7/email/mime/nonmultipart.pyt <module> s mime/audio.pyc 0000644 00000005535 15204114630 0007315 0 ustar 00 � { fc @ s� d Z d g Z d d l Z d d l m Z d d l m Z d d l m Z i d d 6d d 6d d 6d d 6Z d � Z d e f d � � YZ d S( s/ Class representing audio/* type MIME documents.t MIMEAudioi����N( t StringIO( t encoders( t MIMENonMultipartt basict aus x-wavt wavs x-aifft aifft aifcc C sZ | d } t | � } x= t j D]2 } | | | � } | d k r t j | d � Sq Wd S( s Try to identify a sound file type. sndhdr.what() has a pretty cruddy interface, unfortunately. This is why we re-do it here. It would be easier to reverse engineer the Unix 'file' command and use the standard 'magic' file, as shipped with a modern Unix. i i N( R t sndhdrt testst Nonet _sndhdr_MIMEmapt get( t datat hdrt fakefilet testfnt res( ( s( /usr/lib64/python2.7/email/mime/audio.pyt _whatsnd s c B s e Z d Z d e j d � Z RS( s, Class for generating audio/* MIME documents.c K sg | d k r t | � } n | d k r6 t d � � n t j | d | | � | j | � | | � d S( s Create an audio/* type MIME document. _audiodata is a string containing the raw audio data. If this data can be decoded by the standard Python `sndhdr' module, then the subtype will be automatically included in the Content-Type header. Otherwise, you can specify the specific audio subtype via the _subtype parameter. If _subtype is not given, and no subtype can be guessed, a TypeError is raised. _encoder is a function which will perform the actual encoding for transport of the image data. It takes one argument, which is this Image instance. It should use get_payload() and set_payload() to change the payload to the encoded form. It should also add any Content-Transfer-Encoding or other headers to the message as necessary. The default encoding is Base64. Any additional keyword arguments are passed to the base class constructor, which turns them into parameters on the Content-Type header. s! Could not find audio MIME subtypet audioN( R R t TypeErrorR t __init__t set_payload( t selft _audiodatat _subtypet _encodert _params( ( s( /usr/lib64/python2.7/email/mime/audio.pyR - s N( t __name__t __module__t __doc__R R t encode_base64R ( ( ( s( /usr/lib64/python2.7/email/mime/audio.pyR * s ( R t __all__R t cStringIOR t emailR t email.mime.nonmultipartR R R R ( ( ( s( /usr/lib64/python2.7/email/mime/audio.pyt <module> s mime/image.pyc 0000644 00000004001 15204114630 0007261 0 ustar 00 � { fc @ sU d Z d g Z d d l Z d d l m Z d d l m Z d e f d � � YZ d S( s/ Class representing image/* type MIME documents.t MIMEImagei����N( t encoders( t MIMENonMultipartc B s e Z d Z d e j d � Z RS( s1 Class for generating image/* type MIME documents.c K sm | d k r! t j d | � } n | d k r< t d � � n t j | d | | � | j | � | | � d S( s� Create an image/* type MIME document. _imagedata is a string containing the raw image data. If this data can be decoded by the standard Python `imghdr' module, then the subtype will be automatically included in the Content-Type header. Otherwise, you can specify the specific image subtype via the _subtype parameter. _encoder is a function which will perform the actual encoding for transport of the image data. It takes one argument, which is this Image instance. It should use get_payload() and set_payload() to change the payload to the encoded form. It should also add any Content-Transfer-Encoding or other headers to the message as necessary. The default encoding is Base64. Any additional keyword arguments are passed to the base class constructor, which turns them into parameters on the Content-Type header. s" Could not guess image MIME subtypet imageN( t Nonet imghdrt whatt TypeErrorR t __init__t set_payload( t selft _imagedatat _subtypet _encodert _params( ( s( /usr/lib64/python2.7/email/mime/image.pyR s N( t __name__t __module__t __doc__R R t encode_base64R ( ( ( s( /usr/lib64/python2.7/email/mime/image.pyR s ( R t __all__R t emailR t email.mime.nonmultipartR R ( ( ( s( /usr/lib64/python2.7/email/mime/image.pyt <module> s mime/audio.pyo 0000644 00000005535 15204114630 0007331 0 ustar 00 � { fc @ s� d Z d g Z d d l Z d d l m Z d d l m Z d d l m Z i d d 6d d 6d d 6d d 6Z d � Z d e f d � � YZ d S( s/ Class representing audio/* type MIME documents.t MIMEAudioi����N( t StringIO( t encoders( t MIMENonMultipartt basict aus x-wavt wavs x-aifft aifft aifcc C sZ | d } t | � } x= t j D]2 } | | | � } | d k r t j | d � Sq Wd S( s Try to identify a sound file type. sndhdr.what() has a pretty cruddy interface, unfortunately. This is why we re-do it here. It would be easier to reverse engineer the Unix 'file' command and use the standard 'magic' file, as shipped with a modern Unix. i i N( R t sndhdrt testst Nonet _sndhdr_MIMEmapt get( t datat hdrt fakefilet testfnt res( ( s( /usr/lib64/python2.7/email/mime/audio.pyt _whatsnd s c B s e Z d Z d e j d � Z RS( s, Class for generating audio/* MIME documents.c K sg | d k r t | � } n | d k r6 t d � � n t j | d | | � | j | � | | � d S( s Create an audio/* type MIME document. _audiodata is a string containing the raw audio data. If this data can be decoded by the standard Python `sndhdr' module, then the subtype will be automatically included in the Content-Type header. Otherwise, you can specify the specific audio subtype via the _subtype parameter. If _subtype is not given, and no subtype can be guessed, a TypeError is raised. _encoder is a function which will perform the actual encoding for transport of the image data. It takes one argument, which is this Image instance. It should use get_payload() and set_payload() to change the payload to the encoded form. It should also add any Content-Transfer-Encoding or other headers to the message as necessary. The default encoding is Base64. Any additional keyword arguments are passed to the base class constructor, which turns them into parameters on the Content-Type header. s! Could not find audio MIME subtypet audioN( R R t TypeErrorR t __init__t set_payload( t selft _audiodatat _subtypet _encodert _params( ( s( /usr/lib64/python2.7/email/mime/audio.pyR - s N( t __name__t __module__t __doc__R R t encode_base64R ( ( ( s( /usr/lib64/python2.7/email/mime/audio.pyR * s ( R t __all__R t cStringIOR t emailR t email.mime.nonmultipartR R R R ( ( ( s( /usr/lib64/python2.7/email/mime/audio.pyt <module> s mime/__init__.pyc 0000644 00000000202 15204114630 0007735 0 ustar 00 � { fc @ s d S( N( ( ( ( s+ /usr/lib64/python2.7/email/mime/__init__.pyt <module> t mime/nonmultipart.pyc 0000644 00000001570 15204114630 0010743 0 ustar 00 � { fc @ sI d Z d g Z d d l m Z d d l m Z d e f d � � YZ d S( s9 Base class for MIME type messages that are not multipart.t MIMENonMultiparti����( t errors( t MIMEBasec B s e Z d Z d � Z RS( s0 Base class for MIME non-multipart type messages.c C s t j d � � d S( Ns4 Cannot attach additional subparts to non-multipart/*( R t MultipartConversionError( t selft payload( ( s/ /usr/lib64/python2.7/email/mime/nonmultipart.pyt attach s ( t __name__t __module__t __doc__R ( ( ( s/ /usr/lib64/python2.7/email/mime/nonmultipart.pyR s N( R t __all__t emailR t email.mime.baseR R ( ( ( s/ /usr/lib64/python2.7/email/mime/nonmultipart.pyt <module> s iterators.pyo 0000644 00000004476 15204114630 0007320 0 ustar 00 � { fc @ sk d Z d d d g Z d d l Z d d l m Z d � Z e d � Z d d d � Z d d e d � Z d S( s1 Various types of useful iterators and generators.t body_line_iteratort typed_subpart_iteratort walki����N( t StringIOc c sK | V| j � rG x3 | j � D]" } x | j � D] } | Vq1 Wq Wn d S( s� Walk over the message tree, yielding each subpart. The walk is performed in depth-first order. This method is a generator. N( t is_multipartt get_payloadR ( t selft subpartt subsubpart( ( s' /usr/lib64/python2.7/email/iterators.pyR s c c s[ xT | j � D]F } | j d | � } t | t � r x t | � D] } | VqA Wq q Wd S( s� Iterate over the parts, returning string payloads line-by-line. Optional decode (default False) is passed through to .get_payload(). t decodeN( R R t isinstancet basestringR ( t msgR R t payloadt line( ( s' /usr/lib64/python2.7/email/iterators.pyR # s t textc c sV xO | j � D]A } | j � | k r | d k sC | j � | k rN | VqN q q Wd S( s� 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. N( R t get_content_maintypet Nonet get_content_subtype( R t maintypet subtypeR ( ( s' /usr/lib64/python2.7/email/iterators.pyR / s i c C s� | d k r t j } n d | d } | | | j � I| rW | d | j � IJn | J| j � r� x. | j � D] } t | | | d | � qt Wn d S( s A handy debugging aidt i s [%s]i N( R t syst stdoutt get_content_typet get_default_typeR R t _structure( R t fpt levelt include_defaultt tabR ( ( s' /usr/lib64/python2.7/email/iterators.pyR = s ( t __doc__t __all__R t cStringIOR R t FalseR R R R ( ( ( s' /usr/lib64/python2.7/email/iterators.pyt <module> s message.pyc 0000644 00000070004 15204114630 0006702 0 ustar 00 � { fc @ s� d Z d g Z d d l Z d d l Z d d l Z d d l Z d d l m Z d d l Z d d l m Z d d l m Z d Z e j d � Z d � Z d e d � Z d � Z d � Z d d d � � YZ d S( s8 Basic message object for the email package object model.t Messagei����N( t StringIO( t utils( t errorss ; s [ \(\)<>@,;:\\"/\[\]\?=]c C sD | j d � \ } } } | s. | j � d f S| j � | j � f S( Nt ;( t partitiont stript None( t paramt at sept b( ( s% /usr/lib64/python2.7/email/message.pyt _splitparam s c C s� | d k r� t | � d k r� t | t � r[ | d 7} t j | d | d | d � } n | sp t j | � r� d | t j | � f Sd | | f Sn | Sd S( s� Convenience function to format and return a key=value pair. This will quote the value if needed or if quote is true. If value is a three tuple (charset, language, value), it will be encoded according to RFC2231 rules. i t *i i s %s="%s"s %s=%sN( R t lent isinstancet tupleR t encode_rfc2231t tspecialst searcht quote( R t valueR ( ( s% /usr/lib64/python2.7/email/message.pyt _formatparam& s $c C s g } x| d d k r| d } | j d � } xR | d k r� | j d d | � | j d d | � d r� | j d | d � } q5 W| d k r� t | � } n | | } d | k r� | j d � } | | j � j � d | | d j � } n | j | j � � | | } q W| S( Ni R i t "s \"i t =( t findt countR t indexR t lowert append( t st plistt endt ft i( ( s% /usr/lib64/python2.7/email/message.pyt _parseparam> s ; /c C sB t | t � r1 | d | d t j | d � f St j | � Sd S( Ni i i ( R R R t unquote( R ( ( s% /usr/lib64/python2.7/email/message.pyt _unquotevalueP s "c B s� e Z d Z d � Z d � Z e d � Z d � Z d � Z d � Z d � Z d. e d � Z d. d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d. d � Z d. d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z! d � Z" d. d e# d � Z$ d. d e# d! � Z% d" e# d. d# d$ � Z& d e# d% � Z' d" e# d& � Z( d. d' � Z) d. d( � Z* d) � Z+ d. d* � Z, d. d+ � Z- d, d- l. m/ Z/ RS(/ s� Basic message object. A message object is defined as something that has a bunch of RFC 2822 headers and a payload. It may optionally have an envelope header (a.k.a. Unix-From or From_ header). If the message is a container (i.e. a multipart or a message/rfc822), then the payload is a list of Message objects, otherwise it is a string. Message objects implement part of the `mapping' interface, which assumes there is exactly one occurrence of the header per message. Some headers do in fact appear multiple times (e.g. Received) and for those headers, you must use the explicit API to set or get all the headers. Not all of the mapping methods are implemented. c C sJ g | _ d | _ d | _ d | _ d | _ | _ g | _ d | _ d S( Ns text/plain( t _headersR t _unixfromt _payloadt _charsett preamblet epiloguet defectst _default_type( t self( ( s% /usr/lib64/python2.7/email/message.pyt __init__k s c C s | j d t � S( sw Return the entire formatted message as a string. This includes the headers, body, and envelope header. t unixfrom( t as_stringt True( R. ( ( s% /usr/lib64/python2.7/email/message.pyt __str__v s c C sB d d l m } t � } | | � } | j | d | �| j � S( s� Return the entire formatted message as a string. Optional `unixfrom' when True, means include the Unix From_ envelope header. This is a convenience method and may not generate the message exactly as you intend because by default it mangles lines that begin with "From ". For more flexibility, use the flatten() method of a Generator instance. i����( t GeneratorR0 ( t email.generatorR4 R t flattent getvalue( R. R0 R4 t fpt g( ( s% /usr/lib64/python2.7/email/message.pyR1 | s c C s t | j t � S( s6 Return True if the message consists of multiple parts.( R R( t list( R. ( ( s% /usr/lib64/python2.7/email/message.pyt is_multipart� s c C s | | _ d S( N( R' ( R. R0 ( ( s% /usr/lib64/python2.7/email/message.pyt set_unixfrom� s c C s | j S( N( R' ( R. ( ( s% /usr/lib64/python2.7/email/message.pyt get_unixfrom� s c C s2 | j d k r | g | _ n | j j | � d S( s� Add the given payload to the current payload. The current payload will always be a list of objects after this method is called. If you want to set the payload to a scalar object, use set_payload() instead. N( R( R R ( R. t payload( ( s% /usr/lib64/python2.7/email/message.pyt attach� s c C s9 | d k r | j } n; t | j t � sF t d t | j � � � n | j | } | r5| j � ri d S| j d d � j � } | d k r� t j | � S| d k r� y t j | � SWq2t j k r� | SXq5| d k r5t � } y0 t j t | d � | d t �| j � } Wq2t j k r.| SXq5n | S( sZ Return a reference to the payload. The payload will either be a list object or a string. If you mutate the list object, you modify the message's payload in place. Optional i returns that index into the payload. Optional decode is a flag indicating whether the payload should be decoded or not, according to the Content-Transfer-Encoding header (default is False). When True and the message is not a multipart, the payload will be decoded if this header's value is `quoted-printable' or `base64'. If some other encoding is used, or the header is missing, or if the payload has bogus data (i.e. bogus base64 or uuencoded data), the payload is returned as-is. If the message is a multipart and the decode flag is True, then None is returned. s Expected list, got %ss content-transfer-encodingt s quoted-printablet base64s x-uuencodet uuencodet uues x-uues t quietN( s x-uuencodeRB RC s x-uue( R R( R R: t TypeErrort typeR; t getR R t _qdecodet _bdecodet binasciit ErrorR t uut decodeR2 R7 ( R. R" RM R> t ctet sfp( ( s% /usr/lib64/python2.7/email/message.pyt get_payload� s0 c C s) | | _ | d k r% | j | � n d S( s� Set the payload to the given value. Optional charset sets the message's default character set. See set_charset() for details. N( R( R t set_charset( R. R> t charset( ( s% /usr/lib64/python2.7/email/message.pyt set_payload� s c C s� | d k r& | j d � d | _ d St | t � rJ t j j | � } n t | t j j � sn t | � � n | | _ d | k r� | j d d � n d | k r� | j d d d | j � �n | j d | j � � t | j t � r| j j | j � | _ n t | � | j � k r4| j | j � | _ n d | k r�| j � } y | | � Wq�t k r�| j | j � | _ | j d | � q�Xn d S( s� Set the charset of the payload to a given character set. charset can be a Charset instance, a string naming a character set, or None. If it is a string it will be converted to a Charset instance. If charset is None, the charset parameter will be removed from the Content-Type field. Anything else will generate a TypeError. The message will be assumed to be of type text/* encoded with charset.input_charset. It will be converted to charset.output_charset and encoded properly, if needed, when generating the plain text representation of the message. MIME headers (MIME-Version, Content-Type, Content-Transfer-Encoding) will be added as needed. RR Ns MIME-Versions 1.0s Content-Types text/plains Content-Transfer-Encoding( R t del_paramR) R t basestringt emailRR t CharsetRE t add_headert get_output_charsett set_paramR( t unicodet encodet output_charsett strt body_encodet get_body_encoding( R. RR RN ( ( s% /usr/lib64/python2.7/email/message.pyRQ � s4 c C s | j S( sK Return the Charset instance associated with the message's payload. ( R) ( R. ( ( s% /usr/lib64/python2.7/email/message.pyt get_charset s c C s t | j � S( s9 Return the total number of headers, including duplicates.( R R& ( R. ( ( s% /usr/lib64/python2.7/email/message.pyt __len__ s c C s | j | � S( s- Get a header value. Return None if the header is missing instead of raising an exception. Note that if the header appeared multiple times, exactly which occurrence gets returned is undefined. Use get_all() to get all the values matching a header field name. ( RG ( R. t name( ( s% /usr/lib64/python2.7/email/message.pyt __getitem__ s c C s | j j | | f � d S( s� Set the value of a header. Note: this does not overwrite an existing header with the same field name. Use __delitem__() first to delete any existing headers. N( R& R ( R. Rc t val( ( s% /usr/lib64/python2.7/email/message.pyt __setitem__( s c C sa | j � } g } x? | j D]4 \ } } | j � | k r | j | | f � q q W| | _ d S( sw Delete all occurrences of a header, if present. Does not raise an exception if the header is missing. N( R R& R ( R. Rc t newheaderst kt v( ( s% /usr/lib64/python2.7/email/message.pyt __delitem__0 s c C s2 | j � g | j D] \ } } | j � ^ q k S( N( R R& ( R. Rc Rh Ri ( ( s% /usr/lib64/python2.7/email/message.pyt __contains__< s c C s t � } | j | | � | k S( s/ Return true if the message contains the header.( t objectRG ( R. Rc t missing( ( s% /usr/lib64/python2.7/email/message.pyt has_key? s c C s g | j D] \ } } | ^ q S( s. Return a list of all the message's header field names. These will be sorted in the order they appeared in the original message, or were added to the message, and may contain duplicates. Any fields deleted and re-inserted are always appended to the header list. ( R& ( R. Rh Ri ( ( s% /usr/lib64/python2.7/email/message.pyt keysD s c C s g | j D] \ } } | ^ q S( s) Return a list of all the message's header values. These will be sorted in the order they appeared in the original message, or were added to the message, and may contain duplicates. Any fields deleted and re-inserted are always appended to the header list. ( R& ( R. Rh Ri ( ( s% /usr/lib64/python2.7/email/message.pyt valuesN s c C s | j S( s' Get all the message's header fields and values. These will be sorted in the order they appeared in the original message, or were added to the message, and may contain duplicates. Any fields deleted and re-inserted are always appended to the header list. ( R& ( R. ( ( s% /usr/lib64/python2.7/email/message.pyt itemsX s c C s@ | j � } x- | j D]" \ } } | j � | k r | Sq W| S( s~ Get a header value. Like __getitem__() but return failobj instead of None when the field is missing. ( R R& ( R. Rc t failobjRh Ri ( ( s% /usr/lib64/python2.7/email/message.pyRG b s c C s\ g } | j � } x9 | j D]. \ } } | j � | k r | j | � q q W| sX | S| S( sQ Return a list of all the values for the named field. These will be sorted in the order they appeared in the original message, and may contain duplicates. Any fields deleted and re-inserted are always appended to the header list. If no such fields exist, failobj is returned (defaults to None). ( R R& R ( R. Rc Rr Rp Rh Ri ( ( s% /usr/lib64/python2.7/email/message.pyt get_allr s c K s� g } xd | j � D]V \ } } | d k rG | j | j d d � � q | j t | j d d � | � � q W| d k r� | j d | � n | j j | t j | � f � d S( s� Extended header setting. name is the header field to add. keyword arguments can be used to set additional parameters for the header field, with underscores converted to dashes. Normally the parameter will be added as key="value" unless value is None, in which case only the key will be added. If a parameter value contains non-ASCII characters it must be specified as a three-tuple of (charset, language, value), in which case it will be encoded according to RFC2231 rules. Example: msg.add_header('content-disposition', 'attachment', filename='bud.gif') t _t -i N( Rq R R t replaceR t insertR& t SEMISPACEt join( R. t _namet _valuet _paramst partsRh Ri ( ( s% /usr/lib64/python2.7/email/message.pyRX � s & c C s} | j � } xj t t t | j � � | j � D]; \ } \ } } | j � | k r. | | f | j | <Pq. q. Wt | � � d S( s� Replace a header. Replace the first matching header found in the message, retaining header order and case. If no matching header was found, a KeyError is raised. N( R t zipt rangeR R& t KeyError( R. Rz R{ R" Rh Ri ( ( s% /usr/lib64/python2.7/email/message.pyt replace_header� s 4c C sd t � } | j d | � } | | k r1 | j � St | � d j � } | j d � d k r` d S| S( s0 Return the message's content type. The returned string is coerced to lower case of the form `maintype/subtype'. If there was no Content-Type header in the message, the default type as given by get_default_type() will be returned. Since according to RFC 2045, messages always have a default type this will always return a value. RFC 2045 defines a message's default type to be text/plain unless it appears inside a multipart/digest container, in which case it would be message/rfc822. s content-typei t /i s text/plain( Rl RG t get_default_typeR R R ( R. Rm R t ctype( ( s% /usr/lib64/python2.7/email/message.pyt get_content_type� s c C s | j � } | j d � d S( s� Return the message's main content type. This is the `maintype' part of the string returned by get_content_type(). R� i ( R� t split( R. R� ( ( s% /usr/lib64/python2.7/email/message.pyt get_content_maintype� s c C s | j � } | j d � d S( s� Returns the message's sub-content type. This is the `subtype' part of the string returned by get_content_type(). R� i ( R� R� ( R. R� ( ( s% /usr/lib64/python2.7/email/message.pyt get_content_subtype� s c C s | j S( s Return the `default' content type. Most messages have a default content type of text/plain, except for messages that are subparts of multipart/digest containers. Such subparts have a default content type of message/rfc822. ( R- ( R. ( ( s% /usr/lib64/python2.7/email/message.pyR� � s c C s | | _ d S( s� Set the `default' content type. ctype should be either "text/plain" or "message/rfc822", although this is not enforced. The default content type is not stored in the Content-Type header. N( R- ( R. R� ( ( s% /usr/lib64/python2.7/email/message.pyt set_default_type� s c C s� t � } | j | | � } | | k r+ | Sg } x� t d | � D]s } y4 | j d d � \ } } | j � } | j � } Wn# t k r� | j � } d } n X| j | | f � qB Wt j | � } | S( NR R i R@ ( Rl RG R# R� R t ValueErrorR R t decode_params( R. Rr t headerRm R t paramst pRc Re ( ( s% /usr/lib64/python2.7/email/message.pyt _get_params_preserve� s s content-typec C sb t � } | j | | � } | | k r+ | S| rZ g | D] \ } } | t | � f ^ q8 S| Sd S( sm Return the message's Content-Type parameters, as a list. The elements of the returned list are 2-tuples of key/value pairs, as split on the `=' sign. The left hand side of the `=' is the key, while the right hand side is the value. If there is no `=' sign in the parameter the value is the empty string. The value is as described in the get_param() method. Optional failobj is the object to return if there is no Content-Type header. Optional header is the header to search instead of Content-Type. If unquote is True, the value is unquoted. N( Rl R� R% ( R. Rr R� R$ Rm R� Rh Ri ( ( s% /usr/lib64/python2.7/email/message.pyt get_params s )c C sf | | k r | SxO | j | | � D]; \ } } | j � | j � k r# | rW t | � S| Sq# q# W| S( s� Return the parameter value if found in the Content-Type header. Optional failobj is the object to return if there is no Content-Type header, or the Content-Type header has no such parameter. Optional header is the header to search instead of Content-Type. Parameter keys are always compared case insensitively. The return value can either be a string, or a 3-tuple if the parameter was RFC 2231 encoded. When it's a 3-tuple, the elements of the value are of the form (CHARSET, LANGUAGE, VALUE). Note that both CHARSET and LANGUAGE can be None, in which case you should consider VALUE to be encoded in the us-ascii charset. You can usually ignore LANGUAGE. Your application should be prepared to deal with 3-tuple return values, and can convert the parameter to a Unicode string like so: param = msg.get_param('foo') if isinstance(param, tuple): param = unicode(param[2], param[0] or 'us-ascii') In any case, the parameter value (either the returned string, or the VALUE item in the 3-tuple) is always unquoted, unless unquote is set to False. ( R� R R% ( R. R Rr R� R$ Rh Ri ( ( s% /usr/lib64/python2.7/email/message.pyt get_param s s Content-TypeR@ c C sw t | t � r( | r( | | | f } n | | k rO | j � d k rO d } n | j | � } | j | d | �s� | s� t | | | � } qJt j | t | | | � g � } n� d } x� | j d | d | � D]u \ } } d } | j � | j � k rt | | | � } n t | | | � } | s1| } q� t j | | g � } q� W| | j | � k rs| | =| | | <n d S( s� Set a parameter in the Content-Type header. If the parameter already exists in the header, its value will be replaced with the new value. If header is Content-Type and has not yet been defined for this message, it will be set to "text/plain" and the new parameter and value will be appended as per RFC 2045. An alternate header can be specified in the header argument, and all parameters will be quoted as necessary unless requote is False. If charset is specified, the parameter will be encoded according to RFC 2231. Optional language specifies the RFC 2231 language, defaulting to the empty string. Both charset and language should be strings. s content-types text/plainR� R@ R$ N( R R R RG R� R Rx Ry R� ( R. R R R� t requoteRR t languageR� t old_paramt old_valuet append_param( ( s% /usr/lib64/python2.7/email/message.pyRZ ; s. c C s� | | k r d Sd } x} | j d | d | � D]c \ } } | j � | j � k r/ | sn t | | | � } q� t j | t | | | � g � } q/ q/ W| | j | � k r� | | =| | | <n d S( s> Remove the given parameter completely from the Content-Type header. The header will be re-written in place without the parameter or its value. All values will be quoted as necessary unless requote is False. Optional header specifies an alternative to the Content-Type header. NR@ R� R$ ( R� R R Rx Ry RG ( R. R R� R� t new_ctypeR� Ri ( ( s% /usr/lib64/python2.7/email/message.pyRT k s % c C s� | j d � d k s t � n | j � d k rD | d =d | d <n | | k r^ | | | <d S| j d | d | � } | | =| | | <x. | d D]" \ } } | j | | | | � q� Wd S( sK Set the main type and subtype for the Content-Type header. type must be a string in the form "maintype/subtype", otherwise a ValueError is raised. This method replaces the Content-Type header, keeping all the parameters in place. If requote is False, this leaves the existing header's quoting as is. Otherwise, the parameters will be quoted (the default). An alternative header can be specified in the header argument. When the Content-Type header is set, we'll always also add a MIME-Version header. R� i s content-types mime-versions 1.0s MIME-VersionNR� R$ ( R R� R R� RZ ( R. RF R� R� R� R� Ri ( ( s% /usr/lib64/python2.7/email/message.pyt set_type� s c C se t � } | j d | d � } | | k rB | j d | d � } n | | k rR | St j | � j � S( s@ Return the filename associated with the payload if present. The filename is extracted from the Content-Disposition header's `filename' parameter, and it is unquoted. If that header is missing the `filename' parameter, this method falls back to looking for the `name' parameter. t filenames content-dispositionRc s content-type( Rl R� R t collapse_rfc2231_valueR ( R. Rr Rm R� ( ( s% /usr/lib64/python2.7/email/message.pyt get_filename� s c C s> t � } | j d | � } | | k r+ | St j | � j � S( s� Return the boundary associated with the payload if present. The boundary is extracted from the Content-Type header's `boundary' parameter, and it is unquoted. t boundary( Rl R� R R� t rstrip( R. Rr Rm R� ( ( s% /usr/lib64/python2.7/email/message.pyt get_boundary� s c C s� t � } | j | d � } | | k r9 t j d � � n g } t } xY | D]Q \ } } | j � d k r� | j d d | f � t } qL | j | | f � qL W| s� | j d d | f � n g } x� | j D]� \ } } | j � d k r^g } xG | D]? \ } } | d k r$| j | � q� | j d | | f � q� W| j | t j | � f � q� | j | | f � q� W| | _ d S( s� Set the boundary parameter in Content-Type to 'boundary'. This is subtly different than deleting the Content-Type header and adding a new one with a new boundary parameter via add_header(). The main difference is that using the set_boundary() method preserves the order of the Content-Type header in the original message. HeaderParseError is raised if the message has no Content-Type header. s content-types No Content-Type header foundR� s "%s"R@ s %s=%sN( Rl R� R t HeaderParseErrort FalseR R R2 R& Rx Ry ( R. R� Rm R� t newparamst foundpt pkt pvRg t hRi R} Rh ( ( s% /usr/lib64/python2.7/email/message.pyt set_boundary� s0 c C s� t � } | j d | � } | | k r+ | St | t � r� | d pG d } y t | d | � j d � } Wq� t t f k r� | d } q� Xn y4 t | t � r� t | d � } n | j d � } Wn t k r� | SX| j � S( s� Return the charset parameter of the Content-Type header. The returned string is always coerced to lower case. If there is no Content-Type header, or if that header has no charset parameter, failobj is returned. RR i s us-asciii ( Rl R� R R R[ R\ t LookupErrort UnicodeErrorR^ R ( R. Rr Rm RR t pcharset( ( s% /usr/lib64/python2.7/email/message.pyt get_content_charset� s" c C s& g | j � D] } | j | � ^ q S( s� Return a list containing the charset(s) used in this message. The returned list of items describes the Content-Type headers' charset parameter for this message and all the subparts in its payload. Each item will either be a string (the value of the charset parameter in the Content-Type header of that part) or the value of the 'failobj' parameter (defaults to None), if the part does not have a main MIME type of "text", or the charset is not defined. The list will contain one string for each part of the message, plus one for the container message (i.e. self), so that a non-multipart message will still return a list of length 1. ( t walkR� ( R. Rr t part( ( s% /usr/lib64/python2.7/email/message.pyt get_charsets s i����( R� N(0 t __name__t __module__t __doc__R/ R3 R� R1 R; R< R= R? R RP RS RQ Ra Rb Rd Rf Rj Rk Rn Ro Rp Rq RG Rs RX R� R� R� R� R� R� R� R2 R� R� RZ RT R� R� R� R� R� R� t email.iteratorsR� ( ( ( s% /usr/lib64/python2.7/email/message.pyR \ sX 2 - #/ - ( ( R� t __all__t reRL RJ t warningst cStringIOR t email.charsetRV R R Rx t compileR R R R2 R R# R% R ( ( ( s% /usr/lib64/python2.7/email/message.pyt <module> s encoders.pyc 0000644 00000004270 15204114630 0007062 0 ustar 00 � { fc @ sn d Z d d d d g Z d d l Z d d l m Z d � Z d � Z d � Z d � Z d � Z d � Z d S( s Encodings and related functions.t encode_7or8bitt encode_base64t encode_noopt encode_quoprii����N( t encodestringc C s" t | d t �} | j d d � S( Nt quotetabst s =20( t _encodestringt Truet replace( t st enc( ( s& /usr/lib64/python2.7/email/encoders.pyt _qencode s c C sL | s | S| d d k } t j | � } | rH | d d k rH | d S| S( Ni����s ( t base64R ( R t hasnewlinet value( ( s& /usr/lib64/python2.7/email/encoders.pyt _bencode s c C s3 | j � } t | � } | j | � d | d <d S( sl Encode the message's payload in Base64. Also, add an appropriate Content-Transfer-Encoding header. R s Content-Transfer-EncodingN( t get_payloadR t set_payload( t msgt origt encdata( ( s& /usr/lib64/python2.7/email/encoders.pyR ' s c C s3 | j � } t | � } | j | � d | d <d S( sv Encode the message's payload in quoted-printable. Also, add an appropriate Content-Transfer-Encoding header. s quoted-printables Content-Transfer-EncodingN( R R R ( R R R ( ( s& /usr/lib64/python2.7/email/encoders.pyR 3 s c C sc | j � } | d k r& d | d <d Sy | j d � Wn t k rT d | d <n Xd | d <d S( s9 Set the Content-Transfer-Encoding header to 7bit or 8bit.t 7bits Content-Transfer-EncodingNt asciit 8bit( R t Nonet encodet UnicodeError( R R ( ( s& /usr/lib64/python2.7/email/encoders.pyR ? s c C s d S( s Do nothing.N( ( R ( ( s& /usr/lib64/python2.7/email/encoders.pyR Q t ( t __doc__t __all__R t quopriR R R R R R R R ( ( ( s& /usr/lib64/python2.7/email/encoders.pyt <module> s feedparser.pyo 0000644 00000025454 15204114630 0007423 0 ustar 00 � { fc @ s� d Z d g Z d d l Z d d l m Z d d l m Z e j d � Z e j d � Z e j d � Z e j d � Z e j d � Z d Z d Z e � Z d e f d � � YZ d d d � � YZ d S( s FeedParser - An email feed parser. The feed parser implements an interface for incrementally parsing an email message, line by line. This has advantages for certain applications, such as those reading email messages off a socket. FeedParser.feed() is the primary interface for pushing new data into the parser. It returns when there's nothing more it can do with the available data. When you have no more data to push into the parser, call .close(). This completes the parsing and returns the root message object. The other advantage of this parser is that it will never raise a parsing exception. Instead, when it finds something unexpected, it adds a 'defect' to the current message. Defects are just instances that live on the message object's .defects attribute. t FeedParseri����N( t errors( t messages | | s ( | | )s ( | | )\Zs( ^(From |[\041-\071\073-\176]{1,}:|[\t ])t s t BufferedSubFilec B sq e Z d Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z RS( sk A file-ish object that can have new data loaded into it. You can also push and pop line-matching predicates onto a stack. When the current predicate matches the current line, a false EOF response (i.e. empty string) is returned instead. This lets the parser adhere to a simple abstraction -- it parses until EOF closes the current message. c C s( g | _ g | _ g | _ t | _ d S( N( t _partialt _linest _eofstackt Falset _closed( t self( ( s( /usr/lib64/python2.7/email/feedparser.pyt __init__3 s c C s | j j | � d S( N( R t append( R t pred( ( s( /usr/lib64/python2.7/email/feedparser.pyt push_eof_matcher= s c C s | j j � S( N( R t pop( R ( ( s( /usr/lib64/python2.7/email/feedparser.pyt pop_eof_matcher@ s c C s8 | j d j | j � j t � � g | _ t | _ d S( NR ( t pushlinest joinR t splitlinest TrueR ( R ( ( s( /usr/lib64/python2.7/email/feedparser.pyt closeC s " c C sn | j s | j r d St S| j j � } x> | j d d d � D]& } | | � r@ | j j | � d Sq@ W| S( NR i����( R R t NeedMoreDataR R R ( R t linet ateof( ( s( /usr/lib64/python2.7/email/feedparser.pyt readlineI s c C s | j j | � d S( N( R R ( R R ( ( s( /usr/lib64/python2.7/email/feedparser.pyt unreadline[ s c C s� | j t � } | s* | d j d � r= | j | 7_ d S| j r� | j j | d � d j | j � j t � | d d +| j 2n | d j d � s� | j � g | _ n | j | � d S( s$ Push some new data into this object.i s s NR i i����( s s ( R R t endswithR R R R R ( R t datat parts( ( s( /usr/lib64/python2.7/email/feedparser.pyt push` s " c C s | d d d � | j d *d S( Ni����i ( R ( R t lines( ( s( /usr/lib64/python2.7/email/feedparser.pyR x s c C s | j S( N( R ( R ( ( s( /usr/lib64/python2.7/email/feedparser.pyt is_closed| s c C s | S( N( ( R ( ( s( /usr/lib64/python2.7/email/feedparser.pyt __iter__ s c C s% | j � } | d k r! t � n | S( NR ( R t StopIteration( R R ( ( s( /usr/lib64/python2.7/email/feedparser.pyt next� s ( t __name__t __module__t __doc__R R R R R R R R R R! R# ( ( ( s( /usr/lib64/python2.7/email/feedparser.pyR + s c B se e Z d Z e j d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z RS( s A feed-style parser of email.c C sO | | _ t � | _ g | _ | j � j | _ d | _ d | _ t | _ d S( s@ _factory is called with no arguments to create a new message objN( t _factoryR t _inputt _msgstackt _parsegenR# t _parset Nonet _curt _lastR t _headersonly( R R' ( ( s( /usr/lib64/python2.7/email/feedparser.pyR � s c C s t | _ d S( N( R R/ ( R ( ( s( /usr/lib64/python2.7/email/feedparser.pyt _set_headersonly� s c C s | j j | � | j � d S( s Push more data into the parser.N( R( R t _call_parse( R R ( ( s( /usr/lib64/python2.7/email/feedparser.pyt feed� s c C s& y | j � Wn t k r! n Xd S( N( R+ R" ( R ( ( s( /usr/lib64/python2.7/email/feedparser.pyR1 � s c C s_ | j j � | j � | j � } | j � d k r[ | j � r[ | j j t j � � n | S( s< Parse all remaining data and return the root message object.t multipart( R( R R1 t _pop_messaget get_content_maintypet is_multipartt defectsR R t! MultipartInvariantViolationDefect( R t root( ( s( /usr/lib64/python2.7/email/feedparser.pyR � s c C s� | j � } | j r: | j j � d k r: | j d � n | j rZ | j d j | � n | j j | � | | _ | | _ d S( Ns multipart/digests message/rfc822i����( R' R- t get_content_typet set_default_typeR) t attachR R. ( R t msg( ( s( /usr/lib64/python2.7/email/feedparser.pyt _new_message� s c C s8 | j j � } | j r+ | j d | _ n d | _ | S( Ni����( R) R R- R, ( R t retval( ( s( /usr/lib64/python2.7/email/feedparser.pyR4 � s c c s� | j � g } xj | j D]_ } | t k r7 t Vq n t j | � sl t j | � sh | j j | � n Pn | j | � q W| j | � | j rg } xM t r� | j j � } | t k r� t Vq� n | d k r� Pn | j | � q� W| j j t j | � � d S| j j � d k rx� t r | j j t j � x, | j � D] } | t k rat VqDn PqDW| j � } | j j � x1 t r�| j j � } | t k r�t Vq�n Pq�Wx1 t r�| j j � } | t k r�t Vq�n Pq�W| d k r�Pn | j j | � q Wd S| j j � d k rax, | j � D] } | t k rNt Vq1n Pq1W| j � d S| j j � d k r.| j j � } | d k r| j j j t j � � g } x5 | j D]* } | t k r�t Vq�n | j | � q�W| j j t j | � � d Sd | } t j d t j | � d � } t } g } t } x�t r�| j j � } | t k rpt VqDn | d k r�Pn | j | � } | r�| j d � r�| j d � } Pn | r7| r| d } t j! | � } | r| t" | j d � � | d <n t j | � | j _# n t } | j j | � qDn xY t r�| j j � } | t k rft Vq:n | j | � } | s:| j j | � Pq:q:W| j j | j � x, | j � D] } | t k r�t Vq�n Pq�W| j$ j � d k ra| j$ j% } | d k rd | j$ _% q�| d k r�t j! | � } | r^t" | j d � � } | | | j$ _% q^q�nc | j$ j& � } t' | t( � r�t j! | � } | r�| t" | j d � � } | j$ j | � q�n | j j � | j � | j | _$ qD| j | � qDW| r}| j j j t j) � � | j j t j | � � g } x( | j D] } | t k rCt VqCqCqCWt j | � | j _% d S| r�d g } n g } x5 | j D]* } | t k r�t Vq�n | j | � q�W| r| d } t* j | � } | r| t" | j d � � | d <qn t j | � | j _% d Sg } x5 | j D]* } | t k r[t Vq>n | j | � q>W| j j t j | � � d S( NR s message/delivery-statusR R3 s --s (?P<sep>s4 )(?P<end>--)?(?P<ws>[ \t]*)(?P<linesep>\r\n|\r|\n)?$t endt linesepi����i (+ R> R( R t headerREt matcht NLCRER R t _parse_headersR/ R R R- t set_payloadt EMPTYSTRINGR R: R R* R4 R R5 t get_boundaryR, R7 R t NoBoundaryInMultipartDefectt ret compilet escapeR t groupt NLCRE_eolt searcht lent preambleR. t epiloguet get_payloadt isinstancet basestringt StartBoundaryNotFoundDefectt NLCRE_bol( R t headersR R R? R= t boundaryt separatort boundaryret capturing_preambleRQ RA t mot lastlinet eolmoRR R@ t payloadt firstlinet bolmo( ( s( /usr/lib64/python2.7/email/feedparser.pyR* � sJ ! # c C s� d } g } x�t | � D]�\ } } | d d k rv | sc t j | � } | j j j | � q n | j | � q n | r� t j | � d j d � } | | j | <d g } } n | j d � rj| d k rt j | � } | r| t | j d � � } n | j j | � q qj| t | � d k rB| j j | � d St j | � } | j j j | � q n | j d � } | d k r�t j | � } | j j j | � q n | | } | | d j � g } q W| r�t j | � j d � | j | <n d S( NR i s i����s s From i t :( t enumerateR t# FirstHeaderLineIsContinuationDefectR- R7 R RG R t rstript startswithRN RO RP RM t set_unixfromR( R t MisplacedEnvelopeHeaderDefectt findt MalformedHeaderDefectt lstrip( R R t lastheadert lastvaluet linenoR t defectt lhdrR] t i( ( s( /usr/lib64/python2.7/email/feedparser.pyRE � sH ( R$ R% R& R t MessageR R0 R2 R1 R R> R4 R* RE ( ( ( s( /usr/lib64/python2.7/email/feedparser.pyR � s �( ( R& t __all__RJ t emailR R RK RD RW RN t NLCRE_crackRB RG t NLt objectR R R ( ( ( s( /usr/lib64/python2.7/email/feedparser.pyt <module> s _ utils.pyc 0000644 00000022154 15204114630 0006421 0 ustar 00 � { fc @ s d Z d d d d d d d d d d d d d g Z d d l Z d d l Z d d l Z d d l Z d d l Z d d l Z d d l Z d d l Z d d l m Z d d l m Z d d l m Z d d l m Z d d l m Z d d l m Z d d l m Z m Z d Z d Z d Z d Z d Z e j d � Z e j d � Z d � Z! d � Z" d � Z# d! � Z$ d" � Z% e j d# e j& e j' B� Z( d e* e* d$ � Z+ d d% � Z, d& � Z d' � Z d( � Z- d) � Z. d* � Z/ d d d+ � Z0 e j d, � Z1 d- � Z2 d. d/ d0 � Z3 d S(1 s Miscellaneous utilities.t collapse_rfc2231_valuet decode_paramst decode_rfc2231t encode_rfc2231t formataddrt formatdatet getaddressest make_msgidt mktime_tzt parseaddrt parsedatet parsedate_tzt unquotei����N( t quote( t AddressList( R ( R ( R ( t decodestring( t _bencodet _qencodes , t u s t 's [][\\()<>@,:;".]s [][\\()"]c C s | S( N( ( t s( ( s# /usr/lib64/python2.7/email/utils.pyt _identity: s c C s | s | St j | � S( s� Decodes a base64 string. This function is equivalent to base64.decodestring and it's retained only for backward compatibility. It used to remove the last \n of the decoded string, if it had any (see issue 7143). ( t base64R ( R ( ( s# /usr/lib64/python2.7/email/utils.pyt _bdecode> s c C s. t j d t | � } t j d t | � } | S( s- Replace all line-ending characters with \r\n.s (?<!\r)\ns \r(?!\n)( t ret subt CRLF( R ( ( s# /usr/lib64/python2.7/email/utils.pyt fix_eolsK s c C sZ | \ } } | rV d } t j | � r0 d } n t j d | � } d | | | | f S| S( s The inverse of parseaddr(), this takes a 2-tuple of the form (realname, email_address) and returns the string value suitable for an RFC 2822 From, To or Cc header. If the first element of pair is false, then the second element is returned unmodified. R t "s \\\g<0>s %s%s%s <%s>( t specialsret searcht escapesreR ( t pairt namet addresst quotes( ( s# /usr/lib64/python2.7/email/utils.pyR U s c C s" t j | � } t | � } | j S( s7 Return a list of (REALNAME, EMAIL) for each fieldvalue.( t COMMASPACEt joint _AddressListt addresslist( t fieldvaluest allt a( ( s# /usr/lib64/python2.7/email/utils.pyR h s s_ =\? # literal =? (?P<charset>[^?]*?) # non-greedy up to the next ? is the charset \? # literal ? (?P<encoding>[qb]) # either a "q" or a "b", case insensitive \? # literal ? (?P<atom>.*?) # non-greedy up to the next ?= is the atom \?= # literal ?= c C sM | d$ k r t j � } n | r� t j | � } t j rO | d rO t j } n t j } t t | � d � \ } } | d k r� d } n d } d | | | d f } n$ t j | � } | r� d } n d } d d d d d d d d g | d | d d d d d d d d d d d d d g | d d | d | d! | d" | d# | f S(% s� Returns a date string as specified by RFC 2822, e.g.: Fri, 09 Nov 2001 01:08:47 -0000 Optional timeval if given is a floating point time value as accepted by gmtime() and localtime(), otherwise the current time is used. Optional localtime is a flag that when True, interprets timeval, and returns a date relative to the local timezone instead of UTC, properly taking daylight savings time into account. Optional argument usegmt means that the timezone is written out as an ascii string, not numeric one (so "GMT" instead of "+0000"). This is needed for HTTP, and is only used when localtime==False. i����i i t -t +s %s%02d%02di< t GMTs -0000s" %s, %02d %s %04d %02d:%02d:%02d %st Mont Tuet Wedt Thut Frit Satt Suni i t Jant Febt Mart Aprt Mayt Junt Jult Augt Sept Octt Novt Deci i i i N( t Nonet timet localtimet daylightt altzonet timezonet divmodt abst gmtime( t timevalRC t usegmtt nowt offsett hourst minutest signt zone( ( s# /usr/lib64/python2.7/email/utils.pyR | s. ! c C sy t t j � d � } t j � } t j d � } | d k rF d } n d | } t j � } d | | | | | f } | S( s� Returns a string suitable for RFC 2822 compliant Message-ID, e.g: <142480216486.20800.16526388040877946887@nightshade.la.mastaler.com> Optional idstring if given is a string used to strengthen the uniqueness of the message id. id i@ R t .s <%d.%d.%d%s@%s>N( t intRB t ost getpidt randomt getrandbitsRA t sockett getfqdn( t idstringRJ t pidt randintt idhostt msgid( ( s# /usr/lib64/python2.7/email/utils.pyR � s c C s | s d St | � S( N( RA t _parsedate( t data( ( s# /usr/lib64/python2.7/email/utils.pyR � s c C s | s d St | � S( N( RA t _parsedate_tz( R` ( ( s# /usr/lib64/python2.7/email/utils.pyR � s c C s! t | � j } | s d S| d S( s� Parse addr into its constituent realname and email address parts. Return a tuple of realname and email address, unless the parse fails, in which case return a 2-tuple of ('', ''). R i ( R R ( R& R' ( t addrt addrs( ( s# /usr/lib64/python2.7/email/utils.pyR � s c C s� t | � d k r | j d � rS | j d � rS | d d !j d d � j d d � S| j d � r | j d � r | d d !Sn | S( s Remove quotes from a string.i R i����s \\s \s \"t <t >( t lent startswitht endswitht replace( t str( ( s# /usr/lib64/python2.7/email/utils.pyR � s # c C s5 | j t d � } t | � d k r1 d d | f S| S( s# Decode string according to RFC 2231i N( t splitt TICKRf RA ( R t parts( ( s# /usr/lib64/python2.7/email/utils.pyR � s c C sc d d l } | j | d d �} | d k r= | d k r= | S| d k rR d } n d | | | f S( s� Encode string according to RFC 2231. If neither charset nor language is given, then s is returned as-is. If charset is given but not language, the string is encoded using the empty string for language. i����Nt safeR s %s'%s'%s( t urllibR RA ( R t charsett languageRo ( ( s# /usr/lib64/python2.7/email/utils.pyR � s s& ^(?P<name>\w+)\*((?P<num>[0-9]+)\*?)?$c C s | } g } i } | j d � \ } } | j | | f � x� | r| j d � \ } } | j d � rq t } n t } t | � } t j | � } | r� | j d d � \ } } | d k r� t | � } n | j | g � j | | | f � q> | j | d t | � f � q> W| r�x� | j � D]� \ } } g } t } | j � xB | D]: \ } } } | rzt j | � } t } n | j | � qMWt t j | � � } | r�t | � \ } } } | j | | | d | f f � q$| j | d | f � q$Wn | S( s Decode parameters list according to RFC 2231. params is a sequence of 2-tuples containing (param name, string value). i t *R! t nums "%s"N( t popt appendRh t Truet FalseR t rfc2231_continuationt matcht groupRA RS t setdefaultR t itemst sortRo t EMPTYSTRINGR% R ( t paramst new_paramst rfc2231_paramsR! t valuet encodedt moRs t continuationst extendedR Rp Rq ( ( s# /usr/lib64/python2.7/email/utils.pyR sD %! # Ri s us-asciic C su t | t � rg t | d � } | d p, d } y t | | | � SWqq t k rc t | | | � SXn t | � Sd S( Ni i s us-ascii( t isinstancet tupleR t unicodet LookupError( R� t errorst fallback_charsett rawvalRp ( ( s# /usr/lib64/python2.7/email/utils.pyR > s (4 t __doc__t __all__RT R RB R RV RX Ro t warningst email._parseaddrR R R& R R R_ R Ra t quopriR t _qdecodet email.encodersR R R$ R~ t UEMPTYSTRINGR Rl t compileR R R R R R R t VERBOSEt IGNORECASEt ecreRA Rw R R R R R R Rx R R ( ( ( s# /usr/lib64/python2.7/email/utils.pyt <module> sl 5 5 errors.pyo 0000644 00000006711 15204114630 0006612 0 ustar 00 � { fc @ s( d Z d e f d � � YZ d e f d � � YZ d e f d � � YZ d e f d � � YZ d e e f d � � YZ d e f d � � YZ d d d � � YZ d e f d � � YZ d e f d � � YZ d e f d � � YZ d e f d � � YZ d e f d � � YZ d e f d � � YZ d S( s email package exception classes.t MessageErrorc B s e Z d Z RS( s+ Base class for errors in the email package.( t __name__t __module__t __doc__( ( ( s$ /usr/lib64/python2.7/email/errors.pyR s t MessageParseErrorc B s e Z d Z RS( s& Base class for message parsing errors.( R R R ( ( ( s$ /usr/lib64/python2.7/email/errors.pyR s t HeaderParseErrorc B s e Z d Z RS( s Error while parsing headers.( R R R ( ( ( s$ /usr/lib64/python2.7/email/errors.pyR s t BoundaryErrorc B s e Z d Z RS( s# Couldn't find terminating boundary.( R R R ( ( ( s$ /usr/lib64/python2.7/email/errors.pyR s t MultipartConversionErrorc B s e Z d Z RS( s( Conversion to a multipart is prohibited.( R R R ( ( ( s$ /usr/lib64/python2.7/email/errors.pyR s t CharsetErrorc B s e Z d Z RS( s An illegal charset was given.( R R R ( ( ( s$ /usr/lib64/python2.7/email/errors.pyR s t MessageDefectc B s e Z d Z d d � Z RS( s Base class for a message defect.c C s | | _ d S( N( t line( t selfR ( ( s$ /usr/lib64/python2.7/email/errors.pyt __init__& s N( R R R t NoneR ( ( ( s$ /usr/lib64/python2.7/email/errors.pyR # s t NoBoundaryInMultipartDefectc B s e Z d Z RS( sB A message claimed to be a multipart but had no boundary parameter.( R R R ( ( ( s$ /usr/lib64/python2.7/email/errors.pyR ) s t StartBoundaryNotFoundDefectc B s e Z d Z RS( s+ The claimed start boundary was never found.( R R R ( ( ( s$ /usr/lib64/python2.7/email/errors.pyR , s t# FirstHeaderLineIsContinuationDefectc B s e Z d Z RS( s; A message had a continuation line as its first header line.( R R R ( ( ( s$ /usr/lib64/python2.7/email/errors.pyR / s t MisplacedEnvelopeHeaderDefectc B s e Z d Z RS( s? A 'Unix-from' header was found in the middle of a header block.( R R R ( ( ( s$ /usr/lib64/python2.7/email/errors.pyR 2 s t MalformedHeaderDefectc B s e Z d Z RS( sD Found a header that was missing a colon, or was otherwise malformed.( R R R ( ( ( s$ /usr/lib64/python2.7/email/errors.pyR 5 s t! MultipartInvariantViolationDefectc B s e Z d Z RS( s? A message claimed to be a multipart but no subparts were found.( R R R ( ( ( s$ /usr/lib64/python2.7/email/errors.pyR 8 s N( ( R t ExceptionR R R R t TypeErrorR R R R R R R R R ( ( ( s$ /usr/lib64/python2.7/email/errors.pyt <module> s feedparser.pyc 0000644 00000025607 15204114631 0007410 0 ustar 00 � { fc @ s� d Z d g Z d d l Z d d l m Z d d l m Z e j d � Z e j d � Z e j d � Z e j d � Z e j d � Z d Z d Z e � Z d e f d � � YZ d d d � � YZ d S( s FeedParser - An email feed parser. The feed parser implements an interface for incrementally parsing an email message, line by line. This has advantages for certain applications, such as those reading email messages off a socket. FeedParser.feed() is the primary interface for pushing new data into the parser. It returns when there's nothing more it can do with the available data. When you have no more data to push into the parser, call .close(). This completes the parsing and returns the root message object. The other advantage of this parser is that it will never raise a parsing exception. Instead, when it finds something unexpected, it adds a 'defect' to the current message. Defects are just instances that live on the message object's .defects attribute. t FeedParseri����N( t errors( t messages | | s ( | | )s ( | | )\Zs( ^(From |[\041-\071\073-\176]{1,}:|[\t ])t s t BufferedSubFilec B sq e Z d Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z RS( sk A file-ish object that can have new data loaded into it. You can also push and pop line-matching predicates onto a stack. When the current predicate matches the current line, a false EOF response (i.e. empty string) is returned instead. This lets the parser adhere to a simple abstraction -- it parses until EOF closes the current message. c C s( g | _ g | _ g | _ t | _ d S( N( t _partialt _linest _eofstackt Falset _closed( t self( ( s( /usr/lib64/python2.7/email/feedparser.pyt __init__3 s c C s | j j | � d S( N( R t append( R t pred( ( s( /usr/lib64/python2.7/email/feedparser.pyt push_eof_matcher= s c C s | j j � S( N( R t pop( R ( ( s( /usr/lib64/python2.7/email/feedparser.pyt pop_eof_matcher@ s c C s8 | j d j | j � j t � � g | _ t | _ d S( NR ( t pushlinest joinR t splitlinest TrueR ( R ( ( s( /usr/lib64/python2.7/email/feedparser.pyt closeC s " c C sn | j s | j r d St S| j j � } x> | j d d d � D]& } | | � r@ | j j | � d Sq@ W| S( NR i����( R R t NeedMoreDataR R R ( R t linet ateof( ( s( /usr/lib64/python2.7/email/feedparser.pyt readlineI s c C s& | t k s t � | j j | � d S( N( R t AssertionErrorR R ( R R ( ( s( /usr/lib64/python2.7/email/feedparser.pyt unreadline[ s c C s� | j t � } | s* | d j d � r= | j | 7_ d S| j r� | j j | d � d j | j � j t � | d d +| j 2n | d j d � s� | j � g | _ n | j | � d S( s$ Push some new data into this object.i s s NR i i����( s s ( R R t endswithR R R R R ( R t datat parts( ( s( /usr/lib64/python2.7/email/feedparser.pyt push` s " c C s | d d d � | j d *d S( Ni����i ( R ( R t lines( ( s( /usr/lib64/python2.7/email/feedparser.pyR x s c C s | j S( N( R ( R ( ( s( /usr/lib64/python2.7/email/feedparser.pyt is_closed| s c C s | S( N( ( R ( ( s( /usr/lib64/python2.7/email/feedparser.pyt __iter__ s c C s% | j � } | d k r! t � n | S( NR ( R t StopIteration( R R ( ( s( /usr/lib64/python2.7/email/feedparser.pyt next� s ( t __name__t __module__t __doc__R R R R R R R R R! R" R$ ( ( ( s( /usr/lib64/python2.7/email/feedparser.pyR + s c B se e Z d Z e j d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z RS( s A feed-style parser of email.c C sO | | _ t � | _ g | _ | j � j | _ d | _ d | _ t | _ d S( s@ _factory is called with no arguments to create a new message objN( t _factoryR t _inputt _msgstackt _parsegenR$ t _parset Nonet _curt _lastR t _headersonly( R R( ( ( s( /usr/lib64/python2.7/email/feedparser.pyR � s c C s t | _ d S( N( R R0 ( R ( ( s( /usr/lib64/python2.7/email/feedparser.pyt _set_headersonly� s c C s | j j | � | j � d S( s Push more data into the parser.N( R) R t _call_parse( R R ( ( s( /usr/lib64/python2.7/email/feedparser.pyt feed� s c C s& y | j � Wn t k r! n Xd S( N( R, R# ( R ( ( s( /usr/lib64/python2.7/email/feedparser.pyR2 � s c C so | j j � | j � | j � } | j s3 t � | j � d k rk | j � rk | j j t j � � n | S( s< Parse all remaining data and return the root message object.t multipart( R) R R2 t _pop_messageR* R t get_content_maintypet is_multipartt defectsR R t! MultipartInvariantViolationDefect( R t root( ( s( /usr/lib64/python2.7/email/feedparser.pyR � s c C s� | j � } | j r: | j j � d k r: | j d � n | j rZ | j d j | � n | j j | � | | _ | | _ d S( Ns multipart/digests message/rfc822i����( R( R. t get_content_typet set_default_typeR* t attachR R/ ( R t msg( ( s( /usr/lib64/python2.7/email/feedparser.pyt _new_message� s c C s8 | j j � } | j r+ | j d | _ n d | _ | S( Ni����( R* R R. R- ( R t retval( ( s( /usr/lib64/python2.7/email/feedparser.pyR5 � s c c s� | j � g } xj | j D]_ } | t k r7 t Vq n t j | � sl t j | � sh | j j | � n Pn | j | � q W| j | � | j rg } xM t r� | j j � } | t k r� t Vq� n | d k r� Pn | j | � q� W| j j t j | � � d S| j j � d k rx� t r | j j t j � x, | j � D] } | t k rat VqDn PqDW| j � } | j j � x1 t r�| j j � } | t k r�t Vq�n Pq�Wx1 t r�| j j � } | t k r�t Vq�n Pq�W| d k r�Pn | j j | � q Wd S| j j � d k rax, | j � D] } | t k rNt Vq1n Pq1W| j � d S| j j � d k r:| j j � } | d k r| j j j t j � � g } x5 | j D]* } | t k r�t Vq�n | j | � q�W| j j t j | � � d Sd | } t j d t j | � d � } t } g } t } x�t r| j j � } | t k rpt VqDn | d k r�Pn | j | � } | r�| j d � r�| j d � } Pn | r7| r| d } t j! | � } | r| t" | j d � � | d <n t j | � | j _# n t } | j j | � qDn xY t r�| j j � } | t k rft Vq:n | j | � } | s:| j j | � Pq:q:W| j j | j � x, | j � D] } | t k r�t Vq�n Pq�W| j$ j � d k ra| j$ j% } | d k rd | j$ _% q�| d k r�t j! | � } | r^t" | j d � � } | | | j$ _% q^q�nc | j$ j& � } t' | t( � r�t j! | � } | r�| t" | j d � � } | j$ j | � q�n | j j � | j � | j | _$ qD| s�t) � | j | � qDW| r�| j j j t j* � � | j j t j | � � g } x( | j D] } | t k rOt VqOqOqOWt j | � | j _% d S| r�d g } n g } x5 | j D]* } | t k r�t Vq�n | j | � q�W| r!| d } t+ j | � } | r!| t" | j d � � | d <q!n t j | � | j _% d Sg } x5 | j D]* } | t k rgt VqJn | j | � qJW| j j t j | � � d S( NR s message/delivery-statusR R4 s --s (?P<sep>s4 )(?P<end>--)?(?P<ws>[ \t]*)(?P<linesep>\r\n|\r|\n)?$t endt linesepi����i (, R? R) R t headerREt matcht NLCRER R t _parse_headersR0 R R R. t set_payloadt EMPTYSTRINGR R; R R+ R5 R R6 t get_boundaryR- R8 R t NoBoundaryInMultipartDefectt ret compilet escapeR t groupt NLCRE_eolt searcht lent preambleR/ t epiloguet get_payloadt isinstancet basestringR t StartBoundaryNotFoundDefectt NLCRE_bol( R t headersR R R@ R> t boundaryt separatort boundaryret capturing_preambleRR RB t mot lastlinet eolmoRS RA t payloadt firstlinet bolmo( ( s( /usr/lib64/python2.7/email/feedparser.pyR+ � sL ! # c C s� d } g } x�t | � D]�\ } } | d d k rv | sc t j | � } | j j j | � q n | j | � q n | r� t j | � d j d � } | | j | <d g } } n | j d � rj| d k rt j | � } | r| t | j d � � } n | j j | � q qj| t | � d k rB| j j | � d St j | � } | j j j | � q n | j d � } | d k r�t j | � } | j j j | � q n | | } | | d j � g } q W| r�t j | � j d � | j | <n d S( NR i s i����s s From i t :( t enumerateR t# FirstHeaderLineIsContinuationDefectR. R8 R RH R t rstript startswithRO RP RQ RN t set_unixfromR) R t MisplacedEnvelopeHeaderDefectt findt MalformedHeaderDefectt lstrip( R R t lastheadert lastvaluet linenoR t defectt lhdrR^ t i( ( s( /usr/lib64/python2.7/email/feedparser.pyRF � sH ( R% R& R' R t MessageR R1 R3 R2 R R? R5 R+ RF ( ( ( s( /usr/lib64/python2.7/email/feedparser.pyR � s �( ( R' t __all__RK t emailR R RL RE RX RO t NLCRE_crackRC RH t NLt objectR R R ( ( ( s( /usr/lib64/python2.7/email/feedparser.pyt <module> s _ errors.pyc 0000644 00000006711 15204114631 0006577 0 ustar 00 � { fc @ s( d Z d e f d � � YZ d e f d � � YZ d e f d � � YZ d e f d � � YZ d e e f d � � YZ d e f d � � YZ d d d � � YZ d e f d � � YZ d e f d � � YZ d e f d � � YZ d e f d � � YZ d e f d � � YZ d e f d � � YZ d S( s email package exception classes.t MessageErrorc B s e Z d Z RS( s+ Base class for errors in the email package.( t __name__t __module__t __doc__( ( ( s$ /usr/lib64/python2.7/email/errors.pyR s t MessageParseErrorc B s e Z d Z RS( s& Base class for message parsing errors.( R R R ( ( ( s$ /usr/lib64/python2.7/email/errors.pyR s t HeaderParseErrorc B s e Z d Z RS( s Error while parsing headers.( R R R ( ( ( s$ /usr/lib64/python2.7/email/errors.pyR s t BoundaryErrorc B s e Z d Z RS( s# Couldn't find terminating boundary.( R R R ( ( ( s$ /usr/lib64/python2.7/email/errors.pyR s t MultipartConversionErrorc B s e Z d Z RS( s( Conversion to a multipart is prohibited.( R R R ( ( ( s$ /usr/lib64/python2.7/email/errors.pyR s t CharsetErrorc B s e Z d Z RS( s An illegal charset was given.( R R R ( ( ( s$ /usr/lib64/python2.7/email/errors.pyR s t MessageDefectc B s e Z d Z d d � Z RS( s Base class for a message defect.c C s | | _ d S( N( t line( t selfR ( ( s$ /usr/lib64/python2.7/email/errors.pyt __init__& s N( R R R t NoneR ( ( ( s$ /usr/lib64/python2.7/email/errors.pyR # s t NoBoundaryInMultipartDefectc B s e Z d Z RS( sB A message claimed to be a multipart but had no boundary parameter.( R R R ( ( ( s$ /usr/lib64/python2.7/email/errors.pyR ) s t StartBoundaryNotFoundDefectc B s e Z d Z RS( s+ The claimed start boundary was never found.( R R R ( ( ( s$ /usr/lib64/python2.7/email/errors.pyR , s t# FirstHeaderLineIsContinuationDefectc B s e Z d Z RS( s; A message had a continuation line as its first header line.( R R R ( ( ( s$ /usr/lib64/python2.7/email/errors.pyR / s t MisplacedEnvelopeHeaderDefectc B s e Z d Z RS( s? A 'Unix-from' header was found in the middle of a header block.( R R R ( ( ( s$ /usr/lib64/python2.7/email/errors.pyR 2 s t MalformedHeaderDefectc B s e Z d Z RS( sD Found a header that was missing a colon, or was otherwise malformed.( R R R ( ( ( s$ /usr/lib64/python2.7/email/errors.pyR 5 s t! MultipartInvariantViolationDefectc B s e Z d Z RS( s? A message claimed to be a multipart but no subparts were found.( R R R ( ( ( s$ /usr/lib64/python2.7/email/errors.pyR 8 s N( ( R t ExceptionR R R R t TypeErrorR R R R R R R R R ( ( ( s$ /usr/lib64/python2.7/email/errors.pyt <module> s base64mime.pyc 0000644 00000012313 15204114631 0007212 0 ustar 00 � { fc @ s� d Z d d d d d d d d g Z d d l m Z m Z d d l m Z d Z d Z d Z d Z d � Z d e d e d � Z e d e d � Z e Z e Z d d � Z e Z e Z d S( s� Base64 content transfer encoding per RFCs 2045-2047. This module handles the content transfer encoding method defined in RFC 2045 to encode arbitrary 8-bit data using the three 8-bit bytes in four 7-bit characters encoding known as Base64. It is used in the MIME standards for email to attach images, audio, and text using some 8-bit character sets to messages. This module provides an interface to encode and decode both headers and bodies with Base64 encoding. RFC 2045 defines a method for including character set information in an `encoded-word' in a header. This method is commonly used for 8-bit real names in To:, From:, Cc:, etc. fields, as well as Subject: lines. This module does not do the line wrapping or end-of-line character conversion necessary for proper internationalized headers; it only does dumb encoding and decoding. To deal with the various line wrapping issues, use the email.header module. t base64_lent body_decodet body_encodet decodet decodestringt encodet encodestringt header_encodei����( t b2a_base64t a2b_base64( t fix_eolss s t i c C s< t t | � d � \ } } | d } | r8 | d 7} n | S( s6 Return the length of s when it is encoded with base64.i i ( t divmodt len( t st groups_of_3t leftovert n( ( s( /usr/lib64/python2.7/email/base64mime.pyR 4 s s iso-8859-1iL c C s� | s | S| s t | � } n g } | t | � t } | d d } x> t d t | � | � D]$ } | j t | | | | !� � q` Wg } xA | D]9 } | j t � r� | d } n | j d | | f � q� W| d } | j | � S( s0 Encode a single header line with Base64 encoding in a given charset. Defined in RFC 2045, this Base64 encoding is identical to normal Base64 encoding, except that each line must be intelligently wrapped (respecting the Base64 encoding), and subsequent lines must start with a space. charset names the character set to use to encode the header. It defaults to iso-8859-1. End-of-line characters (\r, \n, \r\n) will be automatically converted to the canonical email line separator \r\n unless the keep_eols parameter is True (the default is False). Each line of the header will be terminated in the value of eol, which defaults to "\n". Set this to "\r\n" if you are using the result of this function directly in email. The resulting string will be in the form: "=?charset?b?WW/5ciBtYXp66XLrIHf8eiBhIGhhbXBzdGHuciBBIFlv+XIgbWF6euly?=\n =?charset?b?6yB3/HogYSBoYW1wc3Rh7nIgQkMgWW/5ciBtYXp66XLrIHf8eiBhIGhh?=" with each line wrapped at, at most, maxlinelen characters (defaults to 76 characters). i i i i����s =?%s?b?%s?=t ( R R t MISC_LENt ranget appendR t endswitht NLt join( t headert charsett keep_eolst maxlinelent eolt base64edt max_encodedt max_unencodedt it linest linet joiner( ( s( /usr/lib64/python2.7/email/base64mime.pyR @ s " c C s� | s | S| s t | � } n g } | d d } xp t d t | � | � D]V } t | | | | !� } | j t � r� | t k r� | d | } n | j | � qL Wt j | � S( s� Encode a string with base64. Each line will be wrapped at, at most, maxlinelen characters (defaults to 76 characters). If binary is False, end-of-line characters will be converted to the canonical email end-of-line sequence \r\n. Otherwise they will be left verbatim (this is the default). Each line of encoded text will end with eol, which defaults to "\n". Set this to "\r\n" if you will be using the result of this function directly in an email. i i i i����( R R R R R R R t EMPTYSTRINGR ( R t binaryR R t encvecR R! t enc( ( s( /usr/lib64/python2.7/email/base64mime.pyR z s c C s0 | s | St | � } | r, | j t | � S| S( s� Decode a raw base64 string. If convert_eols is set to a string value, all canonical email linefeeds, e.g. "\r\n", in the decoded text will be converted to the value of convert_eols. os.linesep is a good choice for convert_eols if you are decoding a text attachment. This function does not parse a full MIME header value encoded with base64 (like =?iso-8859-1?b?bmloISBuaWgh?=) -- please use the high level email.header class for that functionality. ( R t replacet CRLF( R t convert_eolst dec( ( s( /usr/lib64/python2.7/email/base64mime.pyR � s N( t __doc__t __all__t binasciiR R t email.utilsR R* R R% R R t FalseR t TrueR R R t NoneR R R ( ( ( s( /usr/lib64/python2.7/email/base64mime.pyt <module> s. 9! header.pyo 0000644 00000032430 15204114631 0006524 0 ustar 00 � { fc @ s6 d Z d d d g Z d d l Z d d l Z d d l Z d d l Z d d l m Z d d l m Z d Z d Z d Z d d Z d Z d Z e d � Z e d � Z e j d e j e j Be j B� Z e j d � Z e j d � Z e j j Z d � Z e e d d � Z d f d � � YZ d � Z d � Z! d S( s+ Header encoding and decoding functionality.t Headert decode_headert make_headeri����N( t HeaderParseError( t Charsets t u i u iL s us-asciis utf-8s� =\? # literal =? (?P<charset>[^?]*?) # non-greedy up to the next ? is the charset \? # literal ? (?P<encoding>[qb]) # either a "q" or a "b", case insensitive \? # literal ? (?P<encoded>.*?) # non-greedy up to the next ?= is the encoded string \?= # literal ?= (?=[ \t]|$) # whitespace or the end of the string s [\041-\176]+:$s \n[^ \t]+:c C sG t | � } t j | � s( | d f g Sg } d } x | j � D]�} t j | � so | j | d f � qA n t j | � } x�| r>| j d � j � } | r� | r� | d d d k r� | d d t | d f | d <q� | j | d f � n | r1g | d d !D] } | j � ^ q \ } } | d } d } | d k rXt j j | � } nm | d k r�t | � d } | r�| d d | 7} n y t j j | � } Wq�t j k r�t � q�Xn | d k r�| } n | r| d d | k r| d d | | d d f | d <q1| j | | f � n | d d 5q� WqA W| S( s� Decode a message header value without converting charset. Returns a list of (decoded_string, charset) pairs containing each of the decoded parts of the header. Charset is None for non-encoded parts of the header, otherwise a lower-case string containing the name of the character set specified in the encoded string. An email.errors.HeaderParseError may be raised when certain decoding error occurs (e.g. a base64 decoding exception). t i i����i i t qt bi s ===i N( t strt ecret searcht Nonet splitlinest appendt splitt popt stript SPACEt lowert emailt quoprimimet header_decodet lent base64mimet decodet binasciit ErrorR ( t headert decodedt dect linet partst unenct st charsett encodingt encodedt paderr( ( s$ /usr/lib64/python2.7/email/header.pyR = sJ #, 'c C sq t d | d | d | � } xO | D]G \ } } | d k rY t | t � rY t | � } n | j | | � q" W| S( s� Create a Header from a sequence of pairs as returned by decode_header() decode_header() takes a header value string and returns a sequence of pairs of the format (decoded_string, charset) where charset is the string name of the character set. This function takes one of those sequence of pairs and returns a Header instance. Optional maxlinelen, header_name, and continuation_ws are as in the Header constructor. t maxlinelent header_namet continuation_wsN( R R t isinstanceR R ( t decoded_seqR' R( R) t hR" R# ( ( s$ /usr/lib64/python2.7/email/header.pyR y s c B s} e Z d d d d d d d � Z d � Z d � Z d � Z d � Z d d d � Z d � Z d � Z d � Z d d � Z RS( R t strictc C s� | d k r t } n t | t � s3 t | � } n | | _ | | _ t | j d t � � } g | _ | d k r� | j | | | � n | d k r� t } n | d k r� | | _ n | t | � d | _ | | | _ d S( s Create a MIME-compliant header that can contain many character sets. Optional s is the initial header value. If None, the initial header value is not set. You can later append to the header with .append() method calls. s may be a byte string or a Unicode string, but see the .append() documentation for semantics. Optional charset serves two purposes: it has the same meaning as the charset argument to the .append() method. It also sets the default character set for all subsequent .append() calls that omit the charset argument. If charset is not provided in the constructor, the us-ascii charset is used both as s's initial charset and as the default for subsequent .append() calls. The maximum line length can be specified explicit via maxlinelen. For splitting the first line to a shorter value (to account for the field header which isn't included in s, e.g. `Subject') pass in the name of the field in header_name. The default maxlinelen is 76. continuation_ws must be RFC 2822 compliant folding whitespace (usually either a space or a hard tab) which will be prepended to continuation lines. errors is passed through to the .append() call. s i N( R t USASCIIR* R t _charsett _continuation_wsR t replacet SPACE8t _chunksR t MAXLINELENt _firstlinelent _maxlinelen( t selfR" R# R' R( R) t errorst cws_expanded_len( ( s$ /usr/lib64/python2.7/email/header.pyt __init__� s c C s | j � S( s A synonym for self.encode().( t encode( R7 ( ( s$ /usr/lib64/python2.7/email/header.pyt __str__� s c C s� g } d } x� | j D]� \ } } | } | r~ | d k r_ | d k r{ | j t � d } q{ q~ | d k r~ | j t � q~ n | } | j t | t | � � � q Wt j | � S( s) Helper for the built-in unicode function.s us-asciiN( Ns us-ascii( Ns us-ascii( Ns us-ascii( R R3 R t USPACEt unicodeR t UEMPTYSTRINGt join( R7 t uchunkst lastcsR" R# t nextcs( ( s$ /usr/lib64/python2.7/email/header.pyt __unicode__� s c C s | | j � k S( N( R; ( R7 t other( ( s$ /usr/lib64/python2.7/email/header.pyt __eq__� s c C s | | k S( N( ( R7 RE ( ( s$ /usr/lib64/python2.7/email/header.pyt __ne__� s c C s | d k r | j } n t | t � s6 t | � } n | d k r� t | t � r� | j p] d } t | | | � } | j p~ d } | j | | � q� t | t � r� xT t | t f D]@ } y& | j p� d } | j | | � } PWq� t k r� q� Xq� Wq� n | j j | | f � d S( s> Append a string to the MIME header. Optional charset, if given, should be a Charset instance or the name of a character set (which will be converted to a Charset instance). A value of None (the default) means that the charset given in the constructor is used. s may be a byte string or a Unicode string. If it is a byte string (i.e. isinstance(s, str) is true), then charset is the encoding of that byte string, and a UnicodeError will be raised if the string cannot be decoded with that charset. If s is a Unicode string, then charset is a hint specifying the character set of the characters in the string. In this case, when producing an RFC 2822 compliant header using RFC 2047 rules, the Unicode string will be encoded using the following charsets in order: us-ascii, the charset hint, utf-8. The first character set not to provoke a UnicodeError is used. Optional `errors' is passed as the third argument to any unicode() or ustr.encode() call. t 8bits us-asciiN( R R/ R* R R t input_codecR> t output_codecR; R. t UTF8t UnicodeErrorR3 R ( R7 R" R# R8 t incodect ustrt outcodec( ( s$ /usr/lib64/python2.7/email/header.pyR � s( c C s0 | j | � } | j | t � } | j | � } | | k rI | | f g S| d k rb | | f g S| d k r� | j | | | | � S| t | � k r� | } | j | | t � } | j | | t � } n t | | | � \ } } | j | � } | j | t � } | | f g } | | j | | | j | � S( NRH s us-ascii( t to_splittablet from_splittablet Truet encoded_header_lent _split_asciiR t Falset _binsplitt _splitR6 ( R7 R" R# R' t splitcharst splittableR% t elent splitpntt firstt lastt fsplittablet fencodedt chunk( ( s$ /usr/lib64/python2.7/email/header.pyRW s$ c C s8 t | | | j | j | � } t | | g t | � � S( N( RT R6 R0 t zipR ( R7 R" R# t firstlenRX t chunks( ( s$ /usr/lib64/python2.7/email/header.pyRT N s c C s� g } x� | D]� \ } } | s% q n | d k s@ | j d k rI | } n | j | � } | rz | d j d � rz d } n d } t | | | | � q Wt | j } | j | � S( Ni����R R ( R t header_encodingt header_encodet endswitht _max_appendt NLR0 R@ ( R7 t newchunksR' Rc R R# R" t extrat joiner( ( s$ /usr/lib64/python2.7/email/header.pyt _encode_chunksS s s ;, c C s� g } | j } d } x~ | j D]s \ } } | | d } | | j d � k rW | } n | | j | | | | � 7} | d \ } } | j | � } q W| j | | � } t j | � r� t d j | � � � n | S( s� Encode a message header into an RFC-compliant format. There are many issues involved in converting a given string for use in an email header. Only certain character sets are readable in most email clients, and as header strings can only contain a subset of 7-bit ASCII, care must be taken to properly convert and encode (with Base64 or quoted-printable) header strings. In addition, there is a 75-character length limit on any given encoded header field, so line-wrapping must be performed, even with double-byte character sets. This method will do its best to convert the string to the correct character set used in email, and encode and line wrap it safely with the appropriate scheme for that character set. If the given charset is not known or an error occurs during conversion, this function will return the header untouched. Optional splitchars is a string containing characters to split long ASCII lines on, in rough support of RFC 2822's `highest level syntactic breaks'. This doesn't affect RFC 2047 encoded lines. i i R i����s8 header value appears to contain an embedded header: {!r}( R5 R3 RS RW Rl t _embeded_headerR R t format( R7 RX Ri R' t lastlenR" R# t targetlent lastchunkt lastcharsett value( ( s$ /usr/lib64/python2.7/email/header.pyR; v s N( t __name__t __module__R R: R< RD RF RG R RW RT Rl R; ( ( ( s$ /usr/lib64/python2.7/email/header.pyR � s 3 7 . #c C s| g } | } xi| j � D][} | j � } t | � | k rV | j | � | } q n x4 | D] } | | k r] Pq] q] W| j | � | } q t j d | � } | d k r� | } n d } | d } t | � } t | j d t � � } g } d } x]| j | � D]L} | t d t | � d � | } t | � } | } | d k r�| r�t | � d k r�t j | d � r�| j | � | | 7} q| | | k r:| r�| j | j | � | � n | | k r| d k rt | | | | d � } | j | d � | d g } n | g } | t | d � } | } q| j | � | | 7} qW| r | j | j | � � q q W| S( Ns %s\s*s ;,R R s i i i����( R t lstripR R t ret compileR1 R2 R t maxt fcret matchR@ RT t extend( R" Rb t restlenR) RX t linest maxlenR t cht cret eolRk t joinlent wslent thist linelent partt curlent partlent onfirstlinet subl( ( s$ /usr/lib64/python2.7/email/header.pyRT � s^ ! % c C s� d } t | � } xf | | k rz | | d d ?} | j | | t � } | j | � } | | k rm | } q | d } q W| j | | t � } | j | | t � } | | f S( Ni i ( R RQ RR RS RU ( RY R# R' t it jt mR` t chunklenR\ R] ( ( s$ /usr/lib64/python2.7/email/header.pyRV � s (" t __doc__t __all__Rw R t email.quoprimimeR t email.base64mimet email.errorsR t email.charsetR Rh R R= R2 R? R4 R. RK Rx t VERBOSEt IGNORECASEt MULTILINER Rz Rm R Rg R R R R RT RV ( ( ( s$ /usr/lib64/python2.7/email/header.pyt <module> s: < � F generator.pyo 0000644 00000024214 15204114631 0007263 0 ustar 00 � { fc @ s� d Z d d g Z d d l Z d d l Z d d l Z d d l Z d d l Z d d l m Z d d l m Z d Z d Z e j d e j � Z d � Z d f d � � YZ d Z d e f d � � YZ e e e j d � � Z d e Z e d � Z d S( s: Classes to generate plain text from a message object tree.t Generatort DecodedGeneratori����N( t StringIO( t Headert _s s ^From c C s< t | t � r8 y t | d � Wq8 t k r4 t SXn t S( Ns us-ascii( t isinstancet strt unicodet UnicodeErrort Truet False( t s( ( s' /usr/lib64/python2.7/email/generator.pyt _is8bitstring s c B s� e Z d Z e d d � Z d � Z e d � Z d � Z d � Z d � Z d � Z d � Z e Z d � Z d � Z d � Z d � Z RS( s� Generates output from a Message object tree. This basic generator writes the message to the given file object as plain text. iN c C s | | _ | | _ | | _ d S( s� Create the generator for message flattening. outfp is the output file-like object for writing the message to. It must have a write() method. Optional mangle_from_ is a flag that, when True (the default), escapes From_ lines in the body of the message by putting a `>' in front of them. Optional maxheaderlen specifies the longest length for a non-continued header. When a header line is longer (in characters, with tabs expanded to 8 spaces) than maxheaderlen, the header will split as defined in the Header class. Set maxheaderlen to zero to disable header wrapping. The default is 78, as recommended (but not required) by RFC 2822. N( t _fpt _mangle_from_t _maxheaderlen( t selft outfpt mangle_from_t maxheaderlen( ( s' /usr/lib64/python2.7/email/generator.pyt __init__* s c C s | j j | � d S( N( R t write( R R ( ( s' /usr/lib64/python2.7/email/generator.pyR ? s c C sU | rD | j � } | s4 d t j t j � � } n | j | IJn | j | � d S( s� Print the message object tree rooted at msg to the output file specified when the Generator instance was created. unixfrom is a flag that forces the printing of a Unix From_ delimiter before the first object in the message tree. If the original message has no From_ delimiter, a `standard' one is crafted. By default, this is False to inhibit the printing of any From_ delimiter. Note that for subobjects, no From_ line is printed. s From nobody N( t get_unixfromt timet ctimeR t _write( R t msgt unixfromt ufrom( ( s' /usr/lib64/python2.7/email/generator.pyt flattenC s c C s | j | | j | j � S( s1 Clone this generator with the exact same options.( t __class__R R ( R t fp( ( s' /usr/lib64/python2.7/email/generator.pyt cloneU s c C s� | j } z! t � | _ } | j | � Wd | | _ Xt | d d � } | d k re | j | � n | | � | j j | j � � d S( Nt _write_headers( R R t _dispatcht getattrt NoneR! R t getvalue( R R t oldfpt sfpt meth( ( s' /usr/lib64/python2.7/email/generator.pyR ] s c C s� | j � } | j � } t j | | f � j d d � } t | d | d � } | d k r� | j d d � } t | d | d � } | d k r� | j } q� n | | � d S( Nt -R t _handle_( t get_content_maintypet get_content_subtypet UNDERSCOREt joint replaceR# R$ t _writeBody( R R t maint subt specificR( t generic( ( s' /usr/lib64/python2.7/email/generator.pyR" x s ! c C s� x� | j � D]� \ } } | j d | I| j d k rI | j | IJq t | t � rn | j | j � IJq t | � r� | j | IJq | j t | d | j d | �j � IJq W| j Jd S( Ns %s:i t maxlinelent header_name( t itemsR R R R t encodeR ( R R t ht v( ( s' /usr/lib64/python2.7/email/generator.pyR! � s "c C sv | j � } | d k r d St | t � sD t d t | � � � n | j rb t j d | � } n | j j | � d S( Ns string payload expected: %ss >From ( t get_payloadR$ R t basestringt TypeErrort typeR t fcreR2 R R ( R R t payload( ( s' /usr/lib64/python2.7/email/generator.pyt _handle_text� s c C s g } | j � } | d k r' g } n> t | t � rJ | j j | � d St | t � se | g } n xL | D]D } t � } | j | � } | j | d t �| j | j � � ql W| j � } | s� t j | � } t | � } | j | � n | j d k r:| j r!t j d | j � } n | j } | j | IJn | j d | IJ| rm| j j | j d � � n x/ | D]' } | j d | IJ| j j | � qtW| j j d | d t � | j d k r| j r�t j d | j � } n | j } | j j | � n d S( NR s >From s --i s --( R; R$ R R< R R t listR R R R t appendR% t get_boundaryt NLR. t _make_boundaryt set_boundaryt preambleR R? R2 t popt epilogue( R R t msgtextst subpartst partR t gt boundaryt alltextRH t body_partRJ ( ( s' /usr/lib64/python2.7/email/generator.pyt _handle_multipart� sH c C s4 | j } z d | _ | j | � Wd | | _ Xd S( Ni ( R RR ( R R t old_maxheaderlen( ( s' /usr/lib64/python2.7/email/generator.pyt _handle_multipart_signed� s c C s� g } x� | j � D]� } t � } | j | � } | j | d t �| j � } | j d � } | r� | d d k r� | j t j | d � � q | j | � q W| j j t j | � � d S( NR s i����t ( R; R R R R R% t splitRC RE R. R R ( R R t blocksRM R RN t textt lines( ( s' /usr/lib64/python2.7/email/generator.pyt _handle_message_delivery_status� s c C sr t � } | j | � } | j � } t | t � r^ | j | j d � d t �| j � } n | j j | � d S( Ni R ( R R R; R RB R R R% R R ( R R R RN R@ ( ( s' /usr/lib64/python2.7/email/generator.pyt _handle_message s ( t __name__t __module__t __doc__R R R R R R R R" R! RA R0 RR RT RZ R[ ( ( ( s' /usr/lib64/python2.7/email/generator.pyR s 9 sD [Non-text (%(type)s) part of message omitted, filename %(filename)s]c B s) e Z d Z e d d d � Z d � Z RS( s� Generates a text representation of a message. Like the Generator base class, except that non-text parts are substituted with a format string representing the part. iN c C s; t j | | | | � | d k r. t | _ n | | _ d S( s� Like Generator.__init__() except that an additional optional argument is allowed. Walks through all subparts of a message. If the subpart is of main type `text', then it prints the decoded payload of the subpart. Otherwise, fmt is a format string that is used instead of the message payload. fmt is expanded with the following keywords (in %(keyword)s format): type : Full MIME type of the non-text part maintype : Main MIME type of the non-text part subtype : Sub-MIME type of the non-text part filename : Filename of the non-text part description: Description associated with the non-text part encoding : Content transfer encoding of the non-text part The default value for fmt is None, meaning [Non-text (%(type)s) part of message omitted, filename %(filename)s] N( R R R$ t _FMTt _fmt( R R R R t fmt( ( s' /usr/lib64/python2.7/email/generator.pyR . s c C s� x� | j � D]� } | j � } | d k rD | | j d t � IJq | d k rS q | | j i | j � d 6| j � d 6| j � d 6| j d � d 6| j d d � d 6| j d d � d 6IJq Wd S( NRX t decodet multipartR> t maintypet subtypes [no filename]t filenames Content-Descriptions [no description]t descriptions Content-Transfer-Encodings [no encoding]t encoding( t walkR+ R; R R` t get_content_typeR, t get_filenamet get( R R RM Rd ( ( s' /usr/lib64/python2.7/email/generator.pyR" J s N( R\ R] R^ R R$ R R" ( ( ( s' /usr/lib64/python2.7/email/generator.pyR ( s i s %%0%ddc C s� t j t j � } d t | d } | d k r4 | S| } d } xa t r� t j d t j | � d t j � } | j | � s� Pn | d t | � } | d 7} qC W| S( Nt =i s ==i s ^--s (--)?$t .i s ===============( t randomt randranget syst maxintR` R$ R t ret compilet escapet MULTILINEt searchR ( RX t tokenRO t bt countert cre( ( s' /usr/lib64/python2.7/email/generator.pyRF d s &( R^ t __all__Rs Rq R Ro t warningst cStringIOR t email.headerR R- RE Rt Rv R? R R R_ R t lent reprRr t _widthR` R$ RF ( ( ( s' /usr/lib64/python2.7/email/generator.pyt <module> s& � 9 iterators.pyc 0000644 00000004476 15204114631 0007305 0 ustar 00 � { fc @ sk d Z d d d g Z d d l Z d d l m Z d � Z e d � Z d d d � Z d d e d � Z d S( s1 Various types of useful iterators and generators.t body_line_iteratort typed_subpart_iteratort walki����N( t StringIOc c sK | V| j � rG x3 | j � D]" } x | j � D] } | Vq1 Wq Wn d S( s� Walk over the message tree, yielding each subpart. The walk is performed in depth-first order. This method is a generator. N( t is_multipartt get_payloadR ( t selft subpartt subsubpart( ( s' /usr/lib64/python2.7/email/iterators.pyR s c c s[ xT | j � D]F } | j d | � } t | t � r x t | � D] } | VqA Wq q Wd S( s� Iterate over the parts, returning string payloads line-by-line. Optional decode (default False) is passed through to .get_payload(). t decodeN( R R t isinstancet basestringR ( t msgR R t payloadt line( ( s' /usr/lib64/python2.7/email/iterators.pyR # s t textc c sV xO | j � D]A } | j � | k r | d k sC | j � | k rN | VqN q q Wd S( s� 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. N( R t get_content_maintypet Nonet get_content_subtype( R t maintypet subtypeR ( ( s' /usr/lib64/python2.7/email/iterators.pyR / s i c C s� | d k r t j } n d | d } | | | j � I| rW | d | j � IJn | J| j � r� x. | j � D] } t | | | d | � qt Wn d S( s A handy debugging aidt i s [%s]i N( R t syst stdoutt get_content_typet get_default_typeR R t _structure( R t fpt levelt include_defaultt tabR ( ( s' /usr/lib64/python2.7/email/iterators.pyR = s ( t __doc__t __all__R t cStringIOR R t FalseR R R R ( ( ( s' /usr/lib64/python2.7/email/iterators.pyt <module> s utils.pyo 0000644 00000022154 15204114631 0006436 0 ustar 00 � { fc @ s d Z d d d d d d d d d d d d d g Z d d l Z d d l Z d d l Z d d l Z d d l Z d d l Z d d l Z d d l Z d d l m Z d d l m Z d d l m Z d d l m Z d d l m Z d d l m Z d d l m Z m Z d Z d Z d Z d Z d Z e j d � Z e j d � Z d � Z! d � Z" d � Z# d! � Z$ d" � Z% e j d# e j& e j' B� Z( d e* e* d$ � Z+ d d% � Z, d& � Z d' � Z d( � Z- d) � Z. d* � Z/ d d d+ � Z0 e j d, � Z1 d- � Z2 d. d/ d0 � Z3 d S(1 s Miscellaneous utilities.t collapse_rfc2231_valuet decode_paramst decode_rfc2231t encode_rfc2231t formataddrt formatdatet getaddressest make_msgidt mktime_tzt parseaddrt parsedatet parsedate_tzt unquotei����N( t quote( t AddressList( R ( R ( R ( t decodestring( t _bencodet _qencodes , t u s t 's [][\\()<>@,:;".]s [][\\()"]c C s | S( N( ( t s( ( s# /usr/lib64/python2.7/email/utils.pyt _identity: s c C s | s | St j | � S( s� Decodes a base64 string. This function is equivalent to base64.decodestring and it's retained only for backward compatibility. It used to remove the last \n of the decoded string, if it had any (see issue 7143). ( t base64R ( R ( ( s# /usr/lib64/python2.7/email/utils.pyt _bdecode> s c C s. t j d t | � } t j d t | � } | S( s- Replace all line-ending characters with \r\n.s (?<!\r)\ns \r(?!\n)( t ret subt CRLF( R ( ( s# /usr/lib64/python2.7/email/utils.pyt fix_eolsK s c C sZ | \ } } | rV d } t j | � r0 d } n t j d | � } d | | | | f S| S( s The inverse of parseaddr(), this takes a 2-tuple of the form (realname, email_address) and returns the string value suitable for an RFC 2822 From, To or Cc header. If the first element of pair is false, then the second element is returned unmodified. R t "s \\\g<0>s %s%s%s <%s>( t specialsret searcht escapesreR ( t pairt namet addresst quotes( ( s# /usr/lib64/python2.7/email/utils.pyR U s c C s" t j | � } t | � } | j S( s7 Return a list of (REALNAME, EMAIL) for each fieldvalue.( t COMMASPACEt joint _AddressListt addresslist( t fieldvaluest allt a( ( s# /usr/lib64/python2.7/email/utils.pyR h s s_ =\? # literal =? (?P<charset>[^?]*?) # non-greedy up to the next ? is the charset \? # literal ? (?P<encoding>[qb]) # either a "q" or a "b", case insensitive \? # literal ? (?P<atom>.*?) # non-greedy up to the next ?= is the atom \?= # literal ?= c C sM | d$ k r t j � } n | r� t j | � } t j rO | d rO t j } n t j } t t | � d � \ } } | d k r� d } n d } d | | | d f } n$ t j | � } | r� d } n d } d d d d d d d d g | d | d d d d d d d d d d d d d g | d d | d | d! | d" | d# | f S(% s� Returns a date string as specified by RFC 2822, e.g.: Fri, 09 Nov 2001 01:08:47 -0000 Optional timeval if given is a floating point time value as accepted by gmtime() and localtime(), otherwise the current time is used. Optional localtime is a flag that when True, interprets timeval, and returns a date relative to the local timezone instead of UTC, properly taking daylight savings time into account. Optional argument usegmt means that the timezone is written out as an ascii string, not numeric one (so "GMT" instead of "+0000"). This is needed for HTTP, and is only used when localtime==False. i����i i t -t +s %s%02d%02di< t GMTs -0000s" %s, %02d %s %04d %02d:%02d:%02d %st Mont Tuet Wedt Thut Frit Satt Suni i t Jant Febt Mart Aprt Mayt Junt Jult Augt Sept Octt Novt Deci i i i N( t Nonet timet localtimet daylightt altzonet timezonet divmodt abst gmtime( t timevalRC t usegmtt nowt offsett hourst minutest signt zone( ( s# /usr/lib64/python2.7/email/utils.pyR | s. ! c C sy t t j � d � } t j � } t j d � } | d k rF d } n d | } t j � } d | | | | | f } | S( s� Returns a string suitable for RFC 2822 compliant Message-ID, e.g: <142480216486.20800.16526388040877946887@nightshade.la.mastaler.com> Optional idstring if given is a string used to strengthen the uniqueness of the message id. id i@ R t .s <%d.%d.%d%s@%s>N( t intRB t ost getpidt randomt getrandbitsRA t sockett getfqdn( t idstringRJ t pidt randintt idhostt msgid( ( s# /usr/lib64/python2.7/email/utils.pyR � s c C s | s d St | � S( N( RA t _parsedate( t data( ( s# /usr/lib64/python2.7/email/utils.pyR � s c C s | s d St | � S( N( RA t _parsedate_tz( R` ( ( s# /usr/lib64/python2.7/email/utils.pyR � s c C s! t | � j } | s d S| d S( s� Parse addr into its constituent realname and email address parts. Return a tuple of realname and email address, unless the parse fails, in which case return a 2-tuple of ('', ''). R i ( R R ( R& R' ( t addrt addrs( ( s# /usr/lib64/python2.7/email/utils.pyR � s c C s� t | � d k r | j d � rS | j d � rS | d d !j d d � j d d � S| j d � r | j d � r | d d !Sn | S( s Remove quotes from a string.i R i����s \\s \s \"t <t >( t lent startswitht endswitht replace( t str( ( s# /usr/lib64/python2.7/email/utils.pyR � s # c C s5 | j t d � } t | � d k r1 d d | f S| S( s# Decode string according to RFC 2231i N( t splitt TICKRf RA ( R t parts( ( s# /usr/lib64/python2.7/email/utils.pyR � s c C sc d d l } | j | d d �} | d k r= | d k r= | S| d k rR d } n d | | | f S( s� Encode string according to RFC 2231. If neither charset nor language is given, then s is returned as-is. If charset is given but not language, the string is encoded using the empty string for language. i����Nt safeR s %s'%s'%s( t urllibR RA ( R t charsett languageRo ( ( s# /usr/lib64/python2.7/email/utils.pyR � s s& ^(?P<name>\w+)\*((?P<num>[0-9]+)\*?)?$c C s | } g } i } | j d � \ } } | j | | f � x� | r| j d � \ } } | j d � rq t } n t } t | � } t j | � } | r� | j d d � \ } } | d k r� t | � } n | j | g � j | | | f � q> | j | d t | � f � q> W| r�x� | j � D]� \ } } g } t } | j � xB | D]: \ } } } | rzt j | � } t } n | j | � qMWt t j | � � } | r�t | � \ } } } | j | | | d | f f � q$| j | d | f � q$Wn | S( s Decode parameters list according to RFC 2231. params is a sequence of 2-tuples containing (param name, string value). i t *R! t nums "%s"N( t popt appendRh t Truet FalseR t rfc2231_continuationt matcht groupRA RS t setdefaultR t itemst sortRo t EMPTYSTRINGR% R ( t paramst new_paramst rfc2231_paramsR! t valuet encodedt moRs t continuationst extendedR Rp Rq ( ( s# /usr/lib64/python2.7/email/utils.pyR sD %! # Ri s us-asciic C su t | t � rg t | d � } | d p, d } y t | | | � SWqq t k rc t | | | � SXn t | � Sd S( Ni i s us-ascii( t isinstancet tupleR t unicodet LookupError( R� t errorst fallback_charsett rawvalRp ( ( s# /usr/lib64/python2.7/email/utils.pyR > s (4 t __doc__t __all__RT R RB R RV RX Ro t warningst email._parseaddrR R R& R R R_ R Ra t quopriR t _qdecodet email.encodersR R R$ R~ t UEMPTYSTRINGR Rl t compileR R R R R R R t VERBOSEt IGNORECASEt ecreRA Rw R R R R R R Rx R R ( ( ( s# /usr/lib64/python2.7/email/utils.pyt <module> sl 5 5 __init__.pyc 0000644 00000005470 15204114631 0007023 0 ustar 00 � { fc @ s� d Z d Z d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d! g Z d" � Z d# � Z d$ d% l Z d& e f d' � � YZ d d d d( d d d d d d d d g Z d) d* d+ d d, d- d. g Z xH e D]@ Z e e j � � Z e e j d/ e <e e j d0 e e � q� Wd$ d% l Z xg e D]_ Z e d1 e j � � Z e e j d2 e <e e j d0 d3 e e � e e j d4 e e � qIWd% S(5 s? A package for parsing, handling, and generating email messages.s 4.0.3t base64MIMEt Charsett Encoderst Errorst Generatort Headert Iteratorst Messaget MIMEAudiot MIMEBaset MIMEImaget MIMEMessaget MIMEMultipartt MIMENonMultipartt MIMETextt Parsert quopriMIMEt Utilst message_from_stringt message_from_filet base64mimet charsett encoderst errorst generatort headert iteratorst messaget mimet parsert quoprimimet utilsc O s& d d l m } | | | � j | � S( sv Parse a string into a Message object model. Optional _class and strict are passed to the Parser constructor. i����( R ( t email.parserR t parsestr( t st argst kwsR ( ( s& /usr/lib64/python2.7/email/__init__.pyR 3 s c O s& d d l m } | | | � j | � S( s� Read a file and parse its contents into a Message object model. Optional _class and strict are passed to the Parser constructor. i����( R ( R R t parse( t fpR# R$ R ( ( s& /usr/lib64/python2.7/email/__init__.pyR < s i����Nt LazyImporterc B s e Z d � Z d � Z RS( c C s d | | _ d S( Ns email.( t __name__( t selft module_name( ( s& /usr/lib64/python2.7/email/__init__.pyt __init__K s c C s= t | j � t j | j } | j j | j � t | | � S( N( t __import__R( t syst modulest __dict__t updatet getattr( R) t namet mod( ( s& /usr/lib64/python2.7/email/__init__.pyt __getattr__N s ( R( t __module__R+ R4 ( ( ( s& /usr/lib64/python2.7/email/__init__.pyR' J s t FeedParsert Audiot Baset Imaget Multipartt NonMultipartt Texts email.t emails mime.s email.MIMEt MIMEs email.mime( t __doc__t __version__t __all__R R R- t objectR' t _LOWERNAMESt _MIMENAMESt _namet lowert importerR. t setattrt email.mimeR= ( ( ( s& /usr/lib64/python2.7/email/__init__.pyt <module> s� parser.pyo 0000644 00000007364 15204114631 0006600 0 ustar 00 � { fc @ s{ d Z d d g Z d d l Z d d l m Z d d l m Z d d l m Z d d d � � YZ d e f d � � YZ d S( s- A parser of RFC 2822 and MIME email messages.t Parsert HeaderParseri����N( t StringIO( t FeedParser( t Messagec B s) e Z d � Z e d � Z e d � Z RS( c O s t | � d k r> d | k r- t d � � n | d | d <n t | � d k r| d | k rk t d � � n | d | d <n t | � d k r� t d � � n d | k r� | d | _ | d =n t | _ d | k r� t j d t d � | d =n | rt d � � n d S( s� 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 preceded 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. i t _classs( Multiple values for keyword arg '_class'i i t stricts( Multiple values for keyword arg 'strict's Too many argumentss- 'strict' argument is deprecated (and ignored)s Unexpected keyword argumentsN( t lent TypeErrorR R t warningst warnt DeprecationWarning( t selft argst kws( ( s$ /usr/lib64/python2.7/email/parser.pyt __init__ s( c C s_ t | j � } | r" | j � n x0 t rT | j d � } | sD Pn | j | � q% W| j � S( s\ 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. i ( R R t _set_headersonlyt Truet readt feedt close( R t fpt headersonlyt feedparsert data( ( s$ /usr/lib64/python2.7/email/parser.pyt parse8 s c C s | j t | � d | �S( s- 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. R ( R R ( R t textR ( ( s$ /usr/lib64/python2.7/email/parser.pyt parsestrJ s ( t __name__t __module__R t FalseR R ( ( ( s$ /usr/lib64/python2.7/email/parser.pyR s & c B s e Z e d � Z e d � Z RS( c C s t j | | t � S( N( R R R ( R R R ( ( s$ /usr/lib64/python2.7/email/parser.pyR W s c C s t j | | t � S( N( R R R ( R R R ( ( s$ /usr/lib64/python2.7/email/parser.pyR Z s ( R R R R R ( ( ( s$ /usr/lib64/python2.7/email/parser.pyR V s ( ( t __doc__t __all__R t cStringIOR t email.feedparserR t email.messageR R R ( ( ( s$ /usr/lib64/python2.7/email/parser.pyt <module> s E quoprimime.pyc 0000644 00000021222 15204114631 0007444 0 ustar 00 � { fc @ s5 d Z d d d d d d d d d d d d d d g Z d d l Z d d l m Z d d l m Z d Z d Z d Z e j d � Z e j d � Z d � Z d � Z d � Z d � Z d d � Z d � Z d � Z d e d! e d" � Z e d! e d# � Z e Z e Z e d$ � Z e Z e Z d% � Z d& � Z d S(' sF Quoted-printable content transfer encoding per RFCs 2045-2047. This module handles the content transfer encoding method defined in RFC 2045 to encode US ASCII-like 8-bit data called `quoted-printable'. It is used to safely encode text that is in a character set similar to the 7-bit US ASCII character set, but that includes some 8-bit characters that are normally not allowed in email bodies or headers. Quoted-printable is very space-inefficient for encoding binary files; use the email.base64mime module for that instead. This module provides an interface to encode and decode both headers and bodies with quoted-printable encoding. RFC 2045 defines a method for including character set information in an `encoded-word' in a header. This method is commonly used for 8-bit real names in To:/From:/Cc: etc. fields, as well as Subject: lines. This module does not do the line wrapping or end-of-line character conversion necessary for proper internationalized headers; it only does dumb encoding and decoding. To deal with the various line wrapping issues, use the email.header module. t body_decodet body_encodet body_quopri_checkt body_quopri_lent decodet decodestringt encodet encodestringt header_decodet header_encodet header_quopri_checkt header_quopri_lent quotet unquotei����N( t hexdigits( t fix_eolss s i s [^-a-zA-Z0-9!*+/ ]s [^ !-<>-~\t]c C s t t j | � � S( sB Return True if the character should be escaped with header quopri.( t boolt hqret match( t c( ( s( /usr/lib64/python2.7/email/quoprimime.pyR ? s c C s t t j | � � S( s@ Return True if the character should be escaped with body quopri.( R t bqreR ( R ( ( s( /usr/lib64/python2.7/email/quoprimime.pyR D s c C sA d } x4 | D], } t j | � r/ | d 7} q | d 7} q W| S( s? Return the length of str when it is encoded with header quopri.i i i ( R R ( t st countR ( ( s( /usr/lib64/python2.7/email/quoprimime.pyR I s c C sA d } x4 | D], } t j | � r/ | d 7} q | d 7} q W| S( s= Return the length of str when it is encoded with body quopri.i i i ( R R ( t strR R ( ( s( /usr/lib64/python2.7/email/quoprimime.pyR T s t c C sj | s | j | j � � nJ t | d � t | � | k rS | d c | | 7<n | j | j � � d S( Ni����( t appendt lstript len( t LR t maxlent extra( ( s( /usr/lib64/python2.7/email/quoprimime.pyt _max_append_ s c C s t t | d d !d � � S( sD Turn a string in the form =AB to the ASCII character with value 0xabi i i ( t chrt int( R ( ( s( /usr/lib64/python2.7/email/quoprimime.pyR h s c C s d t | � S( Ns =%02X( t ord( R ( ( s( /usr/lib64/python2.7/email/quoprimime.pyR m s s iso-8859-1iL c C s� | s | S| s t | � } n g } | d k r: d } n | t | � t d } xi | D]a } | d k r~ t | d | � qY t j | � s� t | | | � qY t | d t | � | � qY W| d } | j g | D] } d | | f ^ q� � S( s� Encode a single header line with quoted-printable (like) encoding. Defined in RFC 2045, this `Q' encoding is similar to quoted-printable, but used specifically for email header fields to allow charsets with mostly 7 bit characters (and some 8 bit) to remain more or less readable in non-RFC 2045 aware mail clients. charset names the character set to use to encode the header. It defaults to iso-8859-1. The resulting string will be in the form: "=?charset?q?I_f=E2rt_in_your_g=E8n=E8ral_dire=E7tion?\n =?charset?q?Silly_=C8nglish_Kn=EEghts?=" with each line wrapped safely at, at most, maxlinelen characters (defaults to 76 characters). If maxlinelen is None, the entire string is encoded in one chunk with no splitting. End-of-line characters (\r, \n, \r\n) will be automatically converted to the canonical email line separator \r\n unless the keep_eols parameter is True (the default is False). Each line of the header will be terminated in the value of eol, which defaults to "\n". Set this to "\r\n" if you are using the result of this function directly in email. i�� i t t _s =%02Xs =?%s?q?%s?=N( R t NoneR t MISC_LENR R R R" t join( t headert charsett keep_eolst maxlinelent eolt quotedt max_encodedR t joinert line( ( s( /usr/lib64/python2.7/email/quoprimime.pyR r s c C sF | s | S| s t | � } n d } d } | j d � } x| D]�} | j t � rc | d } n | d t k r� | d } n | d 7} d } d } t | � } x� t | � D]� } | | } | } t j | � r� t | � } n5 | d | k r| d k r | | 7} n | } q� n t | � t | � | k rO| | d | 7} d } n | | 7} q� W| r�| d k r�| d t | � k r�t | � } t | � t | � | k r�| | d | | 7} q�| | | 7} n | | | d | 7} d } n | | j t � s | | d t k r.| | | 7} n | | 7} d } qA W| S( s� Encode with quoted-printable, wrapping at maxlinelen characters. If binary is False (the default), end-of-line characters will be converted to the canonical email end-of-line sequence \r\n. Otherwise they will be left verbatim. Each line of encoded text will end with eol, which defaults to "\n". Set this to "\r\n" if you will be using the result of this function directly in an email. Each line will be wrapped at, at most, maxlinelen characters (defaults to 76 characters). Long lines will have the `soft linefeed' quoted-printable character "=" appended to them, so the decoded text will be identical to the original text. R i����i i����s t =N( R t splitlinest endswitht CRLFR% R t rangeR R R ( t bodyt binaryR+ R, t encoded_bodyt linenot linesR0 t encoded_linet prevt linelent jR ( ( s( /usr/lib64/python2.7/email/quoprimime.pyR � sV ' c C sx | s | Sd } x5| j � D]'} | j � } | sE | | 7} q n d } t | � } x� | | k rC| | } | d k r� | | 7} | d 7} n� | d | k r� | d 7} qZ nt | d | k r| | d t k r| | d t k r| t | | | d !� 7} | d 7} n | | 7} | d 7} | | k rZ | | 7} qZ qZ Wq W| j | � rt| j | � rt| d } n | S( s_ Decode a quoted-printable string. Lines are separated with eol, which defaults to \n. R i R1 i i i i����( R2 t rstripR R R R3 ( t encodedR, t decodedR0 t it nR ( ( s( /usr/lib64/python2.7/email/quoprimime.pyR s8 8 c C s | j d � } t | � S( sC Turn a match in the form =AB to the ASCII character with value 0xabi ( t groupR ( R R ( ( s( /usr/lib64/python2.7/email/quoprimime.pyt _unquote_matchA s c C s% | j d d � } t j d t | � S( s Decode a string encoded with RFC 2045 MIME header `Q' encoding. This function does not parse a full MIME header value encoded with quoted-printable (like =?iso-8859-1?q?Hello_World?=) -- please use the high level email.header class for that functionality. R$ R# s =[a-fA-F0-9]{2}( t replacet ret subRE ( R ( ( s( /usr/lib64/python2.7/email/quoprimime.pyR H s ( t __doc__t __all__RG t stringR t email.utilsR R4 t NLR& t compileR R R R R R R R R t FalseR R R R R R R RE R ( ( ( s( /usr/lib64/python2.7/email/quoprimime.pyt <module> sN ?S 0
| ver. 1.4 |
Github
|
.
| PHP 8.1.34 | ���֧ߧ֧�ѧ�ڧ� ����ѧߧڧ��: 0.06 |
proxy
|
phpinfo
|
���ѧ����ۧܧ�