#! /usr/bin/env python
"""Decode MIME message"""
-
from mimedecode_version import __version__, __author__, __copyright__, __license__
-
import sys, os
import email
-try:
- from cStringIO import StringIO
-except ImportError:
- from StringIO import StringIO
-
-
-import socket
-host_name = socket.gethostname()
-
me = os.path.basename(sys.argv[0])
""" % (__version__, __copyright__))
if exit: sys.exit(0)
-
def usage(code=0, errormsg=''):
version(0)
sys.stdout.write("""\
-Usage: %s [-h|--help] [-V|--version] [-cCDP] [-f charset] [-d header] [-p header:param] [-beit mask] [-o output_file] [input_file [output_file]]
+Usage: %s [-h|--help] [-V|--version] [-cCDP] [-H|--host=hostname] [-f charset] [-d header] [-p header:param] [-r header] [-R header:param] [--remove-params=header] [-beit mask] [-o output_file] [input_file [output_file]]
""" % me)
if errormsg:
sys.stderr.write(errormsg + '\n')
sys.exit(code)
-def output(s):
- gopts.outfile.write(s)
-
def output_headers(msg):
unix_from = msg.get_unixfrom()
if unix_from:
def recode(s, charset):
return unicode(s, charset, "replace").encode(gopts.default_encoding, "replace")
-
-def recode2(s, charset):
+def recode_if_needed(s, charset):
if charset and charset.lower() <> gopts.default_encoding:
s = recode(s, charset)
return s
"""Return a decoded string according to RFC 2047.
NOTE: This is almost the same as email.Utils.decode.
"""
- from types import ListType
import email.Header
L = email.Header.decode_header(s)
- if not isinstance(L, ListType):
+ if not isinstance(L, list):
# s wasn't decoded
return s
if charset is None:
rtn.append(atom)
else:
- rtn.append(recode2(atom, charset))
+ rtn.append(recode_if_needed(atom, charset))
rtn.append(' ')
del rtn[-1] # remove the last space
# together into the final string.
return ''.join(rtn)
-
def decode_header(msg, header):
"Decode mail header (if exists) and put it back, if it was encoded"
def _decode_header_param(s):
- return recode2(s[2], s[0])
-
+ return recode_if_needed(s[2], s[0])
def decode_header_param(msg, header, param):
"Decode mail header's parameter (if exists) and put it back, if it was encoded"
if msg.has_key(header):
value = msg.get_param(param, header=header)
if value:
- from types import TupleType
- if isinstance(value, TupleType):
+ if isinstance(value, tuple):
new_value = _decode_header_param(value)
else:
new_value = _decode_header(value)
def decode_headers(msg):
"Decode message headers according to global options"
+ for header in gopts.remove_headers:
+ del msg[header]
+
+ for header in gopts.remove_all_params:
+ value = msg[header]
+ if value is None:
+ continue
+ if ';' not in value:
+ continue
+ del msg[header]
+ msg[header] = value.split(';')[0].strip()
+
+ for header, param in gopts.remove_header_params:
+ msg.del_param(param, header)
+
for header in gopts.decode_headers:
decode_header(msg, header)
msg.set_param("charset", charset, "Content-Type")
-
caps = None # Globally stored mailcap database; initialized only if needed
def decode_body(msg, s):
os.remove(filename)
set_content_type(msg, "text/plain")
- msg["X-MIME-Autoconverted"] = "from %s to text/plain by %s id %s" % (content_type, host_name, command.split()[0])
+ msg["X-MIME-Autoconverted"] = "from %s to text/plain by %s id %s" % (content_type, gopts.host_name, command.split()[0])
return s
save_charset = charset = msg.get_content_charset()
if charset and charset.lower() <> gopts.default_encoding:
- s = recode2(s, charset)
+ s = recode_if_needed(s, charset)
content_type = msg.get_content_type()
set_content_type(msg, content_type, gopts.default_encoding)
- msg["X-MIME-Autoconverted"] = "from %s to %s by %s id %s" % (save_charset, gopts.default_encoding, host_name, me)
+ msg["X-MIME-Autoconverted"] = "from %s to %s by %s id %s" % (save_charset, gopts.default_encoding, gopts.host_name, me)
return s
def totext(msg, instring):
"Convert instring content to text"
- if msg.is_multipart(): # Recursively decode all parts of the multipart message
- newfile = StringIO(str(msg))
- newfile.seek(0)
- decode_file(newfile)
- return
-
# Decode body and recode charset
s = decode_body(msg, instring)
if gopts.recode_charset:
else: # Decode from transfer ecoding to text or binary form
outstring = str(msg.get_payload(decode=1))
set_header(msg, "Content-Transfer-Encoding", "8bit")
- msg["X-MIME-Autoconverted"] = "from %s to 8bit by %s id %s" % (encoding, host_name, me)
+ msg["X-MIME-Autoconverted"] = "from %s to 8bit by %s id %s" % (encoding, gopts.host_name, me)
# Test all mask lists and find what to do with this content type
masks = []
totext(msg, outstring)
-def decode_file(infile):
- "Decode the entire message"
+def decode_multipart(msg):
+ "Decode multipart"
- msg = email.message_from_file(infile)
- boundary = msg.get_boundary()
+ decode_headers(msg)
+ output_headers(msg)
- if msg.is_multipart():
- decode_headers(msg)
- output_headers(msg)
+ if msg.preamble: # Preserve the first part, it is probably not a RFC822-message
+ output(msg.preamble) # Usually it is just a few lines of text (MIME warning)
- if msg.preamble: # Preserve the first part, it is probably not a RFC822-message
- output(msg.preamble) # Usually it is just a few lines of text (MIME warning)
+ boundary = msg.get_boundary()
- for subpart in msg.get_payload():
+ for subpart in msg.get_payload():
+ if boundary:
output("\n--%s\n" % boundary)
- decode_part(subpart)
+ # Recursively decode all parts of the subpart
+ decode_message(subpart)
+
+ if boundary:
output("\n--%s--\n" % boundary)
- if msg.epilogue:
- output(msg.epilogue)
+ if msg.epilogue:
+ output(msg.epilogue)
- else:
- if msg.has_key("Content-Type"): # Simple one-part message - decode it
- decode_part(msg)
- else: # Not a message, just text - copy it literally
- output(str(msg))
+def decode_message(msg):
+ "Decode message"
+
+ if msg.is_multipart():
+ decode_multipart(msg)
+ elif len(msg): # Simple one-part message (there are headers) - decode it
+ decode_part(msg)
+ else: # Not a message, just text - copy it literally
+ output(msg.as_string())
class GlobalOptions:
from m_lib.defenc import default_encoding
recode_charset = 1 # recode charset of message body
- decode_headers = ["From", "Subject"] # A list of headers to decode
+ host_name = None
+
+ # A list of headers to decode
+ decode_headers = ["From", "To", "Cc", "Reply-To", "Mail-Followup-To",
+ "Subject"]
+
+ # A list of headers parameters to decode
decode_header_params = [
("Content-Type", "name"),
("Content-Disposition", "filename"),
- ] # A list of headers' parameters to decode
+ ]
+
+ # A list of headers to remove
+ remove_headers = []
+ # A list of headers parameters to remove
+ remove_header_params = []
+ # A list of headers to be stripped of all parameters
+ remove_all_params = []
totext_mask = [] # A list of content-types to decode
binary_mask = [] # A list to pass through
from getopt import getopt, GetoptError
try:
- options, arguments = getopt(sys.argv[1:], 'hVcCDPf:d:p:b:e:i:t:o:',
- ['help', 'version'])
+ options, arguments = getopt(sys.argv[1:],
+ 'hVcCDPH:f:d:p:r:R:b:e:i:t:o:',
+ ['help', 'version', 'host=', 'remove-params='])
except GetoptError:
usage(1)
for option, value in options:
- if option == '-h':
+ if option in ('-h', '--help'):
usage()
- elif option == '--help':
- usage()
- elif option == '-V':
- version()
- elif option == '--version':
+ elif option in ('-V', '--version'):
version()
elif option == '-c':
gopts.recode_charset = 1
elif option == '-C':
gopts.recode_charset = 0
+ elif option in ('-H', '--host'):
+ gopts.host_name = value
elif option == '-f':
gopts.default_encoding = value
elif option == '-d':
gopts.decode_header_params.append(value.split(':', 1))
elif option == '-P':
gopts.decode_header_params = []
+ elif option == '-r':
+ gopts.remove_headers.append(value)
+ elif option == '-R':
+ gopts.remove_header_params.append(value.split(':', 1))
+ elif option == '--remove-params':
+ gopts.remove_all_params.append(value)
elif option == '-t':
gopts.totext_mask.append(value)
elif option == '-b':
la = len(arguments)
if la == 0:
gopts.input_filename = '-'
- gopts.output_filename = '-'
infile = sys.stdin
- outfile = sys.stdout
+ if gopts.output_filename:
+ outfile = open(gopts.output_filename, 'w')
+ else:
+ gopts.output_filename = '-'
+ outfile = sys.stdout
elif la in (1, 2):
if (arguments[0] == '-'):
gopts.input_filename = '-'
else:
usage(1, 'Too many arguments')
- if (infile is sys.stdin) and (outfile is sys.stdout) and \
- sys.stdin.isatty() and sys.stdout.isatty():
- usage(1, 'Filtering from console to console is forbidden')
+ if (infile is sys.stdin) and sys.stdin.isatty():
+ if (outfile is sys.stdout) and sys.stdout.isatty():
+ usage()
+ usage(1, 'Filtering from console is forbidden')
+
+ if not gopts.host_name:
+ import socket
+ gopts.host_name = socket.gethostname()
gopts.outfile = outfile
- decode_file(infile)
+ output = outfile.write
- infile.close()
- outfile.close()
+ try:
+ decode_message(email.message_from_file(infile))
+ finally:
+ infile.close()
+ outfile.close()