mirror of https://github.com/python/cpython.git
952 lines
31 KiB
Python
952 lines
31 KiB
Python
"""RFC-822 message manipulation class.
|
|
|
|
XXX This is only a very rough sketch of a full RFC-822 parser;
|
|
in particular the tokenizing of addresses does not adhere to all the
|
|
quoting rules.
|
|
|
|
Directions for use:
|
|
|
|
To create a Message object: first open a file, e.g.:
|
|
fp = open(file, 'r')
|
|
You can use any other legal way of getting an open file object, e.g. use
|
|
sys.stdin or call os.popen().
|
|
Then pass the open file object to the Message() constructor:
|
|
m = Message(fp)
|
|
|
|
This class can work with any input object that supports a readline
|
|
method. If the input object has seek and tell capability, the
|
|
rewindbody method will work; also illegal lines will be pushed back
|
|
onto the input stream. If the input object lacks seek but has an
|
|
`unread' method that can push back a line of input, Message will use
|
|
that to push back illegal lines. Thus this class can be used to parse
|
|
messages coming from a buffered stream.
|
|
|
|
The optional `seekable' argument is provided as a workaround for
|
|
certain stdio libraries in which tell() discards buffered data before
|
|
discovering that the lseek() system call doesn't work. For maximum
|
|
portability, you should set the seekable argument to zero to prevent
|
|
that initial \code{tell} when passing in an unseekable object such as
|
|
a a file object created from a socket object. If it is 1 on entry --
|
|
which it is by default -- the tell() method of the open file object is
|
|
called once; if this raises an exception, seekable is reset to 0. For
|
|
other nonzero values of seekable, this test is not made.
|
|
|
|
To get the text of a particular header there are several methods:
|
|
str = m.getheader(name)
|
|
str = m.getrawheader(name)
|
|
where name is the name of the header, e.g. 'Subject'.
|
|
The difference is that getheader() strips the leading and trailing
|
|
whitespace, while getrawheader() doesn't. Both functions retain
|
|
embedded whitespace (including newlines) exactly as they are
|
|
specified in the header, and leave the case of the text unchanged.
|
|
|
|
For addresses and address lists there are functions
|
|
realname, mailaddress = m.getaddr(name) and
|
|
list = m.getaddrlist(name)
|
|
where the latter returns a list of (realname, mailaddr) tuples.
|
|
|
|
There is also a method
|
|
time = m.getdate(name)
|
|
which parses a Date-like field and returns a time-compatible tuple,
|
|
i.e. a tuple such as returned by time.localtime() or accepted by
|
|
time.mktime().
|
|
|
|
See the class definition for lower level access methods.
|
|
|
|
There are also some utility functions here.
|
|
"""
|
|
# Cleanup and extensions by Eric S. Raymond <esr@thyrsus.com>
|
|
|
|
import string
|
|
import time
|
|
|
|
|
|
_blanklines = ('\r\n', '\n') # Optimization for islast()
|
|
|
|
|
|
class Message:
|
|
"""Represents a single RFC-822-compliant message."""
|
|
|
|
def __init__(self, fp, seekable = 1):
|
|
"""Initialize the class instance and read the headers."""
|
|
if seekable == 1:
|
|
# Exercise tell() to make sure it works
|
|
# (and then assume seek() works, too)
|
|
try:
|
|
fp.tell()
|
|
except:
|
|
seekable = 0
|
|
else:
|
|
seekable = 1
|
|
self.fp = fp
|
|
self.seekable = seekable
|
|
self.startofheaders = None
|
|
self.startofbody = None
|
|
#
|
|
if self.seekable:
|
|
try:
|
|
self.startofheaders = self.fp.tell()
|
|
except IOError:
|
|
self.seekable = 0
|
|
#
|
|
self.readheaders()
|
|
#
|
|
if self.seekable:
|
|
try:
|
|
self.startofbody = self.fp.tell()
|
|
except IOError:
|
|
self.seekable = 0
|
|
|
|
def rewindbody(self):
|
|
"""Rewind the file to the start of the body (if seekable)."""
|
|
if not self.seekable:
|
|
raise IOError, "unseekable file"
|
|
self.fp.seek(self.startofbody)
|
|
|
|
def readheaders(self):
|
|
"""Read header lines.
|
|
|
|
Read header lines up to the entirely blank line that
|
|
terminates them. The (normally blank) line that ends the
|
|
headers is skipped, but not included in the returned list.
|
|
If a non-header line ends the headers, (which is an error),
|
|
an attempt is made to backspace over it; it is never
|
|
included in the returned list.
|
|
|
|
The variable self.status is set to the empty string if all
|
|
went well, otherwise it is an error message.
|
|
The variable self.headers is a completely uninterpreted list
|
|
of lines contained in the header (so printing them will
|
|
reproduce the header exactly as it appears in the file).
|
|
"""
|
|
self.dict = {}
|
|
self.unixfrom = ''
|
|
self.headers = list = []
|
|
self.status = ''
|
|
headerseen = ""
|
|
firstline = 1
|
|
startofline = unread = tell = None
|
|
if hasattr(self.fp, 'unread'):
|
|
unread = self.fp.unread
|
|
elif self.seekable:
|
|
tell = self.fp.tell
|
|
while 1:
|
|
if tell:
|
|
startofline = tell()
|
|
line = self.fp.readline()
|
|
if not line:
|
|
self.status = 'EOF in headers'
|
|
break
|
|
# Skip unix From name time lines
|
|
if firstline and line[:5] == 'From ':
|
|
self.unixfrom = self.unixfrom + line
|
|
continue
|
|
firstline = 0
|
|
if headerseen and line[0] in ' \t':
|
|
# It's a continuation line.
|
|
list.append(line)
|
|
x = (self.dict[headerseen] + "\n " + string.strip(line))
|
|
self.dict[headerseen] = string.strip(x)
|
|
continue
|
|
elif self.iscomment(line):
|
|
# It's a comment. Ignore it.
|
|
continue
|
|
elif self.islast(line):
|
|
# Note! No pushback here! The delimiter line gets eaten.
|
|
break
|
|
headerseen = self.isheader(line)
|
|
if headerseen:
|
|
# It's a legal header line, save it.
|
|
list.append(line)
|
|
self.dict[headerseen] = string.strip(line[len(headerseen)+2:])
|
|
continue
|
|
else:
|
|
# It's not a header line; throw it back and stop here.
|
|
if not self.dict:
|
|
self.status = 'No headers'
|
|
else:
|
|
self.status = 'Non-header line where header expected'
|
|
# Try to undo the read.
|
|
if unread:
|
|
unread(line)
|
|
elif tell:
|
|
self.fp.seek(startofline)
|
|
else:
|
|
self.status = self.status + '; bad seek'
|
|
break
|
|
|
|
def isheader(self, line):
|
|
"""Determine whether a given line is a legal header.
|
|
|
|
This method should return the header name, suitably canonicalized.
|
|
You may override this method in order to use Message parsing
|
|
on tagged data in RFC822-like formats with special header formats.
|
|
"""
|
|
i = string.find(line, ':')
|
|
if i > 0:
|
|
return string.lower(line[:i])
|
|
else:
|
|
return None
|
|
|
|
def islast(self, line):
|
|
"""Determine whether a line is a legal end of RFC-822 headers.
|
|
|
|
You may override this method if your application wants
|
|
to bend the rules, e.g. to strip trailing whitespace,
|
|
or to recognise MH template separators ('--------').
|
|
For convenience (e.g. for code reading from sockets) a
|
|
line consisting of \r\n also matches.
|
|
"""
|
|
return line in _blanklines
|
|
|
|
def iscomment(self, line):
|
|
"""Determine whether a line should be skipped entirely.
|
|
|
|
You may override this method in order to use Message parsing
|
|
on tagged data in RFC822-like formats that support embedded
|
|
comments or free-text data.
|
|
"""
|
|
return None
|
|
|
|
def getallmatchingheaders(self, name):
|
|
"""Find all header lines matching a given header name.
|
|
|
|
Look through the list of headers and find all lines
|
|
matching a given header name (and their continuation
|
|
lines). A list of the lines is returned, without
|
|
interpretation. If the header does not occur, an
|
|
empty list is returned. If the header occurs multiple
|
|
times, all occurrences are returned. Case is not
|
|
important in the header name.
|
|
"""
|
|
name = string.lower(name) + ':'
|
|
n = len(name)
|
|
list = []
|
|
hit = 0
|
|
for line in self.headers:
|
|
if string.lower(line[:n]) == name:
|
|
hit = 1
|
|
elif line[:1] not in string.whitespace:
|
|
hit = 0
|
|
if hit:
|
|
list.append(line)
|
|
return list
|
|
|
|
def getfirstmatchingheader(self, name):
|
|
"""Get the first header line matching name.
|
|
|
|
This is similar to getallmatchingheaders, but it returns
|
|
only the first matching header (and its continuation
|
|
lines).
|
|
"""
|
|
name = string.lower(name) + ':'
|
|
n = len(name)
|
|
list = []
|
|
hit = 0
|
|
for line in self.headers:
|
|
if hit:
|
|
if line[:1] not in string.whitespace:
|
|
break
|
|
elif string.lower(line[:n]) == name:
|
|
hit = 1
|
|
if hit:
|
|
list.append(line)
|
|
return list
|
|
|
|
def getrawheader(self, name):
|
|
"""A higher-level interface to getfirstmatchingheader().
|
|
|
|
Return a string containing the literal text of the
|
|
header but with the keyword stripped. All leading,
|
|
trailing and embedded whitespace is kept in the
|
|
string, however.
|
|
Return None if the header does not occur.
|
|
"""
|
|
|
|
list = self.getfirstmatchingheader(name)
|
|
if not list:
|
|
return None
|
|
list[0] = list[0][len(name) + 1:]
|
|
return string.joinfields(list, '')
|
|
|
|
def getheader(self, name, default=None):
|
|
"""Get the header value for a name.
|
|
|
|
This is the normal interface: it returns a stripped
|
|
version of the header value for a given header name,
|
|
or None if it doesn't exist. This uses the dictionary
|
|
version which finds the *last* such header.
|
|
"""
|
|
try:
|
|
return self.dict[string.lower(name)]
|
|
except KeyError:
|
|
return default
|
|
get = getheader
|
|
|
|
def getheaders(self, name):
|
|
"""Get all values for a header.
|
|
|
|
This returns a list of values for headers given more than once;
|
|
each value in the result list is stripped in the same way as the
|
|
result of getheader(). If the header is not given, return an
|
|
empty list.
|
|
"""
|
|
result = []
|
|
current = ''
|
|
have_header = 0
|
|
for s in self.getallmatchingheaders(name):
|
|
if s[0] in string.whitespace:
|
|
if current:
|
|
current = "%s\n %s" % (current, string.strip(s))
|
|
else:
|
|
current = string.strip(s)
|
|
else:
|
|
if have_header:
|
|
result.append(current)
|
|
current = string.strip(s[string.find(s, ":") + 1:])
|
|
have_header = 1
|
|
if have_header:
|
|
result.append(current)
|
|
return result
|
|
|
|
def getaddr(self, name):
|
|
"""Get a single address from a header, as a tuple.
|
|
|
|
An example return value:
|
|
('Guido van Rossum', 'guido@cwi.nl')
|
|
"""
|
|
# New, by Ben Escoto
|
|
alist = self.getaddrlist(name)
|
|
if alist:
|
|
return alist[0]
|
|
else:
|
|
return (None, None)
|
|
|
|
def getaddrlist(self, name):
|
|
"""Get a list of addresses from a header.
|
|
|
|
Retrieves a list of addresses from a header, where each address is a
|
|
tuple as returned by getaddr(). Scans all named headers, so it works
|
|
properly with multiple To: or Cc: headers for example.
|
|
|
|
"""
|
|
raw = []
|
|
for h in self.getallmatchingheaders(name):
|
|
if h[0] in ' \t':
|
|
raw.append(h)
|
|
else:
|
|
if raw:
|
|
raw.append(', ')
|
|
i = string.find(h, ':')
|
|
if i > 0:
|
|
addr = h[i+1:]
|
|
raw.append(addr)
|
|
alladdrs = string.join(raw, '')
|
|
a = AddrlistClass(alladdrs)
|
|
return a.getaddrlist()
|
|
|
|
def getdate(self, name):
|
|
"""Retrieve a date field from a header.
|
|
|
|
Retrieves a date field from the named header, returning
|
|
a tuple compatible with time.mktime().
|
|
"""
|
|
try:
|
|
data = self[name]
|
|
except KeyError:
|
|
return None
|
|
return parsedate(data)
|
|
|
|
def getdate_tz(self, name):
|
|
"""Retrieve a date field from a header as a 10-tuple.
|
|
|
|
The first 9 elements make up a tuple compatible with
|
|
time.mktime(), and the 10th is the offset of the poster's
|
|
time zone from GMT/UTC.
|
|
"""
|
|
try:
|
|
data = self[name]
|
|
except KeyError:
|
|
return None
|
|
return parsedate_tz(data)
|
|
|
|
|
|
# Access as a dictionary (only finds *last* header of each type):
|
|
|
|
def __len__(self):
|
|
"""Get the number of headers in a message."""
|
|
return len(self.dict)
|
|
|
|
def __getitem__(self, name):
|
|
"""Get a specific header, as from a dictionary."""
|
|
return self.dict[string.lower(name)]
|
|
|
|
def __setitem__(self, name, value):
|
|
"""Set the value of a header.
|
|
|
|
Note: This is not a perfect inversion of __getitem__, because
|
|
any changed headers get stuck at the end of the raw-headers list
|
|
rather than where the altered header was.
|
|
"""
|
|
del self[name] # Won't fail if it doesn't exist
|
|
self.dict[string.lower(name)] = value
|
|
text = name + ": " + value
|
|
lines = string.split(text, "\n")
|
|
for line in lines:
|
|
self.headers.append(line + "\n")
|
|
|
|
def __delitem__(self, name):
|
|
"""Delete all occurrences of a specific header, if it is present."""
|
|
lowname = string.lower(name)
|
|
if not self.dict.has_key(lowname):
|
|
raise KeyError, name
|
|
del self.dict[lowname]
|
|
name = lowname + ':'
|
|
n = len(name)
|
|
list = []
|
|
hit = 0
|
|
for i in range(len(self.headers)):
|
|
line = self.headers[i]
|
|
if string.lower(line[:n]) == name:
|
|
hit = 1
|
|
elif line[:1] not in string.whitespace:
|
|
hit = 0
|
|
if hit:
|
|
list.append(i)
|
|
list.reverse()
|
|
for i in list:
|
|
del self.headers[i]
|
|
|
|
def has_key(self, name):
|
|
"""Determine whether a message contains the named header."""
|
|
return self.dict.has_key(string.lower(name))
|
|
|
|
def keys(self):
|
|
"""Get all of a message's header field names."""
|
|
return self.dict.keys()
|
|
|
|
def values(self):
|
|
"""Get all of a message's header field values."""
|
|
return self.dict.values()
|
|
|
|
def items(self):
|
|
"""Get all of a message's headers.
|
|
|
|
Returns a list of name, value tuples.
|
|
"""
|
|
return self.dict.items()
|
|
|
|
def __str__(self):
|
|
str = ''
|
|
for hdr in self.headers:
|
|
str = str + hdr
|
|
return str
|
|
|
|
|
|
# Utility functions
|
|
# -----------------
|
|
|
|
# XXX Should fix unquote() and quote() to be really conformant.
|
|
# XXX The inverses of the parse functions may also be useful.
|
|
|
|
|
|
def unquote(str):
|
|
"""Remove quotes from a string."""
|
|
if len(str) > 1:
|
|
if str[0] == '"' and str[-1:] == '"':
|
|
return str[1:-1]
|
|
if str[0] == '<' and str[-1:] == '>':
|
|
return str[1:-1]
|
|
return str
|
|
|
|
|
|
def quote(str):
|
|
"""Add quotes around a string."""
|
|
return '"%s"' % string.join(
|
|
string.split(
|
|
string.join(
|
|
string.split(str, '\\'),
|
|
'\\\\'),
|
|
'"'),
|
|
'\\"')
|
|
|
|
|
|
def parseaddr(address):
|
|
"""Parse an address into a (realname, mailaddr) tuple."""
|
|
a = AddrlistClass(address)
|
|
list = a.getaddrlist()
|
|
if not list:
|
|
return (None, None)
|
|
else:
|
|
return list[0]
|
|
|
|
|
|
class AddrlistClass:
|
|
"""Address parser class by Ben Escoto.
|
|
|
|
To understand what this class does, it helps to have a copy of
|
|
RFC-822 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.atomends = self.specials + self.LWS + self.CR
|
|
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 = 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.
|
|
"""
|
|
ad = self.getaddress()
|
|
if ad:
|
|
return ad + self.getaddrlist()
|
|
else: return []
|
|
|
|
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 = [(string.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 = [(string.join(self.commentlist), addrspec)]
|
|
|
|
elif self.field[self.pos] == ':':
|
|
# address is a group
|
|
returnlist = []
|
|
|
|
fieldlen = len(self.field)
|
|
self.pos = self.pos + 1
|
|
while self.pos < len(self.field):
|
|
self.gotonext()
|
|
if self.pos < fieldlen and self.field[self.pos] == ';':
|
|
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 = [(string.join(plist) + ' (' + \
|
|
string.join(self.commentlist) + ')', routeaddr)]
|
|
else: returnlist = [(string.join(plist), routeaddr)]
|
|
|
|
else:
|
|
if plist:
|
|
returnlist = [(string.join(self.commentlist), plist[0])]
|
|
elif self.field[self.pos] in self.specials:
|
|
self.pos = self.pos + 1
|
|
|
|
self.gotonext()
|
|
if self.pos < len(self.field) and self.field[self.pos] == ',':
|
|
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 = 0
|
|
self.pos = self.pos + 1
|
|
self.gotonext()
|
|
adlist = None
|
|
while self.pos < len(self.field):
|
|
if expectroute:
|
|
self.getdomain()
|
|
expectroute = 0
|
|
elif self.field[self.pos] == '>':
|
|
self.pos = self.pos + 1
|
|
break
|
|
elif self.field[self.pos] == '@':
|
|
self.pos = self.pos + 1
|
|
expectroute = 1
|
|
elif self.field[self.pos] == ':':
|
|
self.pos = self.pos + 1
|
|
expectaddrspec = 1
|
|
else:
|
|
adlist = self.getaddrspec()
|
|
self.pos = self.pos + 1
|
|
break
|
|
self.gotonext()
|
|
|
|
return adlist
|
|
|
|
def getaddrspec(self):
|
|
"""Parse an RFC-822 addr-spec."""
|
|
aslist = []
|
|
|
|
self.gotonext()
|
|
while self.pos < len(self.field):
|
|
if self.field[self.pos] == '.':
|
|
aslist.append('.')
|
|
self.pos = self.pos + 1
|
|
elif self.field[self.pos] == '"':
|
|
aslist.append('"%s"' % 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 string.join(aslist, '')
|
|
|
|
aslist.append('@')
|
|
self.pos = self.pos + 1
|
|
self.gotonext()
|
|
return string.join(aslist, '') + self.getdomain()
|
|
|
|
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 = 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 = self.pos + 1
|
|
sdlist.append('.')
|
|
elif self.field[self.pos] in self.atomends:
|
|
break
|
|
else: sdlist.append(self.getatom())
|
|
return string.join(sdlist, '')
|
|
|
|
def getdelimited(self, beginchar, endchars, allowcomments = 1):
|
|
"""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-822 comments
|
|
are allowed within the parsed fragment.
|
|
"""
|
|
if self.field[self.pos] != beginchar:
|
|
return ''
|
|
|
|
slist = ['']
|
|
quote = 0
|
|
self.pos = self.pos + 1
|
|
while self.pos < len(self.field):
|
|
if quote == 1:
|
|
slist.append(self.field[self.pos])
|
|
quote = 0
|
|
elif self.field[self.pos] in endchars:
|
|
self.pos = self.pos + 1
|
|
break
|
|
elif allowcomments and self.field[self.pos] == '(':
|
|
slist.append(self.getcomment())
|
|
elif self.field[self.pos] == '\\':
|
|
quote = 1
|
|
else:
|
|
slist.append(self.field[self.pos])
|
|
self.pos = self.pos + 1
|
|
|
|
return string.join(slist, '')
|
|
|
|
def getquote(self):
|
|
"""Get a quote-delimited fragment from self's field."""
|
|
return self.getdelimited('"', '"\r', 0)
|
|
|
|
def getcomment(self):
|
|
"""Get a parenthesis-delimited fragment from self's field."""
|
|
return self.getdelimited('(', ')\r', 1)
|
|
|
|
def getdomainliteral(self):
|
|
"""Parse an RFC-822 domain-literal."""
|
|
return self.getdelimited('[', ']\r', 0)
|
|
|
|
def getatom(self):
|
|
"""Parse an RFC-822 atom."""
|
|
atomlist = ['']
|
|
|
|
while self.pos < len(self.field):
|
|
if self.field[self.pos] in self.atomends:
|
|
break
|
|
else: atomlist.append(self.field[self.pos])
|
|
self.pos = self.pos + 1
|
|
|
|
return string.join(atomlist, '')
|
|
|
|
def getphraselist(self):
|
|
"""Parse a sequence of RFC-822 phrases.
|
|
|
|
A phrase is a sequence of words, which are in turn either
|
|
RFC-822 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.LWS:
|
|
self.pos = 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.atomends:
|
|
break
|
|
else: plist.append(self.getatom())
|
|
|
|
return plist
|
|
|
|
class AddressList(AddrlistClass):
|
|
"""An AddressList encapsulates a list of parsed RFC822 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 __str__(self):
|
|
return string.joinfields(map(dump_address_pair, 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 __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 __getitem__(self, index):
|
|
# Make indexing, slices, and 'in' work
|
|
return self.addresslist[index]
|
|
|
|
def dump_address_pair(pair):
|
|
"""Dump a (name, address) pair in a canonicalized form."""
|
|
if pair[0]:
|
|
return '"' + pair[0] + '" <' + pair[1] + '>'
|
|
else:
|
|
return pair[1]
|
|
|
|
# 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 = string.split(data)
|
|
if data[0][-1] in (',', '.') or string.lower(data[0]) in _daynames:
|
|
# There's a dayname here. Skip it
|
|
del data[0]
|
|
if len(data) == 3: # RFC 850 date, deprecated
|
|
stuff = string.split(data[0], '-')
|
|
if len(stuff) == 3:
|
|
data = stuff + data[1:]
|
|
if len(data) == 4:
|
|
s = data[3]
|
|
i = string.find(s, '+')
|
|
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 = string.lower(mm)
|
|
if not mm in _monthnames:
|
|
dd, mm = mm, string.lower(dd)
|
|
if not mm in _monthnames:
|
|
return None
|
|
mm = _monthnames.index(mm)+1
|
|
if mm > 12: mm = mm - 12
|
|
if dd[-1] == ',':
|
|
dd = dd[:-1]
|
|
i = string.find(yy, ':')
|
|
if i > 0:
|
|
yy, tm = tm, yy
|
|
if yy[-1] == ',':
|
|
yy = yy[:-1]
|
|
if yy[0] not in string.digits:
|
|
yy, tz = tz, yy
|
|
if tm[-1] == ',':
|
|
tm = tm[:-1]
|
|
tm = string.splitfields(tm, ':')
|
|
if len(tm) == 2:
|
|
[thh, tmm] = tm
|
|
tss = '0'
|
|
elif len(tm) == 3:
|
|
[thh, tmm, tss] = tm
|
|
else:
|
|
return None
|
|
try:
|
|
yy = string.atoi(yy)
|
|
dd = string.atoi(dd)
|
|
thh = string.atoi(thh)
|
|
tmm = string.atoi(tmm)
|
|
tss = string.atoi(tss)
|
|
except string.atoi_error:
|
|
return None
|
|
tzoffset=None
|
|
tz=string.upper(tz)
|
|
if _timezones.has_key(tz):
|
|
tzoffset=_timezones[tz]
|
|
else:
|
|
try:
|
|
tzoffset=string.atoi(tz)
|
|
except string.atoi_error:
|
|
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)
|
|
tuple = (yy, mm, dd, thh, tmm, tss, 0, 0, 0, tzoffset)
|
|
return tuple
|
|
|
|
|
|
def parsedate(data):
|
|
"""Convert a time string to a time tuple."""
|
|
t=parsedate_tz(data)
|
|
if type(t)==type( () ):
|
|
return t[:9]
|
|
else: return t
|
|
|
|
|
|
def mktime_tz(data):
|
|
"""Turn a 10-tuple as returned by parsedate_tz() into a UTC timestamp."""
|
|
if data[9] is None:
|
|
# No zone info, so localtime is better assumption than GMT
|
|
return time.mktime(data[:8] + (-1,))
|
|
else:
|
|
t = time.mktime(data[:8] + (0,))
|
|
return t - data[9] - time.timezone
|
|
|
|
def formatdate(timeval=None):
|
|
"""Returns time format preferred for Internet standards.
|
|
|
|
Sun, 06 Nov 1994 08:49:37 GMT ; RFC 822, updated by RFC 1123
|
|
"""
|
|
if timeval is None:
|
|
timeval = time.time()
|
|
return "%s" % time.strftime('%a, %d %b %Y %H:%M:%S GMT',
|
|
time.gmtime(timeval))
|
|
|
|
|
|
# When used as script, run a small test program.
|
|
# The first command line argument must be a filename containing one
|
|
# message in RFC-822 format.
|
|
|
|
if __name__ == '__main__':
|
|
import sys, os
|
|
file = os.path.join(os.environ['HOME'], 'Mail/inbox/1')
|
|
if sys.argv[1:]: file = sys.argv[1]
|
|
f = open(file, 'r')
|
|
m = Message(f)
|
|
print 'From:', m.getaddr('from')
|
|
print 'To:', m.getaddrlist('to')
|
|
print 'Subject:', m.getheader('subject')
|
|
print 'Date:', m.getheader('date')
|
|
date = m.getdate_tz('date')
|
|
if date:
|
|
print 'ParsedDate:', time.asctime(date[:-1]),
|
|
hhmmss = date[-1]
|
|
hhmm, ss = divmod(hhmmss, 60)
|
|
hh, mm = divmod(hhmm, 60)
|
|
print "%+03d%02d" % (hh, mm),
|
|
if ss: print ".%02d" % ss,
|
|
print
|
|
else:
|
|
print 'ParsedDate:', None
|
|
m.rewindbody()
|
|
n = 0
|
|
while f.readline():
|
|
n = n + 1
|
|
print 'Lines:', n
|
|
print '-'*70
|
|
print 'len =', len(m)
|
|
if m.has_key('Date'): print 'Date =', m['Date']
|
|
if m.has_key('X-Nonsense'): pass
|
|
print 'keys =', m.keys()
|
|
print 'values =', m.values()
|
|
print 'items =', m.items()
|