#! /usr/bin/env python



"""Mimification and unmimification of mail messages.



Decode quoted-printable parts of a mail message or encode using

quoted-printable.



Usage:

        mimify(input, output)

        unmimify(input, output, decode_base64 = 0)

to encode and decode respectively.  Input and output may be the name

of a file or an open file object.  Only a readline() method is used

on the input file, only a write() method is used on the output file.

When using file names, the input and output file names may be the

same.



Interactive usage:

        mimify.py -e [infile [outfile]]

        mimify.py -d [infile [outfile]]

to encode and decode respectively.  Infile defaults to standard

input and outfile to standard output.

"""



# Configure

MAXLEN = 200    # if lines longer than this, encode as quoted-printable

CHARSET = 'ISO-8859-1'  # default charset for non-US-ASCII mail

QUOTE = '> '            # string replies are quoted with

# End configure



import re



import warnings

warnings.warn("the mimify module is deprecated; use the email package instead",

                DeprecationWarning, 2)



__all__ = ["mimify","unmimify","mime_encode_header","mime_decode_header"]



qp = re.compile('^content-transfer-encoding:\\s*quoted-printable', re.I)

base64_re = re.compile('^content-transfer-encoding:\\s*base64', re.I)

mp = re.compile('^content-type:.*multipart/.*boundary="?([^;"\n]*)', re.I|re.S)

chrset = re.compile('^(content-type:.*charset=")(us-ascii|iso-8859-[0-9]+)(".*)', re.I|re.S)

he = re.compile('^-*\n')

mime_code = re.compile('=([0-9a-f][0-9a-f])', re.I)

mime_head = re.compile('=\\?iso-8859-1\\?q\\?([^? \t\n]+)\\?=', re.I)

repl = re.compile('^subject:\\s+re: ', re.I)



class File:

    """A simple fake file object that knows about limited read-ahead and

    boundaries.  The only supported method is readline()."""



    def __init__(self, file, boundary):

        self.file = file

        self.boundary = boundary

        self.peek = None



    def readline(self):

        if self.peek is not None:

            return ''

        line = self.file.readline()

        if not line:

            return line

        if self.boundary:

            if line == self.boundary + '\n':

                self.peek = line

                return ''

            if line == self.boundary + '--\n':

                self.peek = line

                return ''

        return line



class HeaderFile:

    def __init__(self, file):

        self.file = file

        self.peek = None



    def readline(self):

        if self.peek is not None:

            line = self.peek

            self.peek = None

        else:

            line = self.file.readline()

        if not line:

            return line

        if he.match(line):

            return line

        while 1:

            self.peek = self.file.readline()

            if len(self.peek) == 0 or \

               (self.peek[0] != ' ' and self.peek[0] != '\t'):

                return line

            line = line + self.peek

            self.peek = None



def mime_decode(line):

    """Decode a single line of quoted-printable text to 8bit."""

    newline = ''

    pos = 0

    while 1:

        res = mime_code.search(line, pos)

        if res is None:

            break

        newline = newline + line[pos:res.start(0)] + \

                  chr(int(res.group(1), 16))

        pos = res.end(0)

    return newline + line[pos:]



def mime_decode_header(line):

    """Decode a header line to 8bit."""

    newline = ''

    pos = 0

    while 1:

        res = mime_head.search(line, pos)

        if res is None:

            break

        match = res.group(1)

        # convert underscores to spaces (before =XX conversion!)

        match = ' '.join(match.split('_'))

        newline = newline + line[pos:res.start(0)] + mime_decode(match)

        pos = res.end(0)

    return newline + line[pos:]



def unmimify_part(ifile, ofile, decode_base64 = 0):

    """Convert a quoted-printable part of a MIME mail message to 8bit."""

    multipart = None

    quoted_printable = 0

    is_base64 = 0

    is_repl = 0

    if ifile.boundary and ifile.boundary[:2] == QUOTE:

        prefix = QUOTE

    else:

        prefix = ''



    # read header

    hfile = HeaderFile(ifile)

    while 1:

        line = hfile.readline()

        if not line:

            return

        if prefix and line[:len(prefix)] == prefix:

            line = line[len(prefix):]

            pref = prefix

        else:

            pref = ''

        line = mime_decode_header(line)

        if qp.match(line):

            quoted_printable = 1

            continue        # skip this header

        if decode_base64 and base64_re.match(line):

            is_base64 = 1

            continue

        ofile.write(pref + line)

        if not prefix and repl.match(line):

            # we're dealing with a reply message

            is_repl = 1

        mp_res = mp.match(line)

        if mp_res:

            multipart = '--' + mp_res.group(1)

        if he.match(line):

            break

    if is_repl and (quoted_printable or multipart):

        is_repl = 0



    # read body

    while 1:

        line = ifile.readline()

        if not line:

            return

        line = re.sub(mime_head, '\\1', line)

        if prefix and line[:len(prefix)] == prefix:

            line = line[len(prefix):]

            pref = prefix

        else:

            pref = ''

##              if is_repl and len(line) >= 4 and line[:4] == QUOTE+'--' and line[-3:] != '--\n':

##                      multipart = line[:-1]

        while multipart:

            if line == multipart + '--\n':

                ofile.write(pref + line)

                multipart = None

                line = None

                break

            if line == multipart + '\n':

                ofile.write(pref + line)

                nifile = File(ifile, multipart)

                unmimify_part(nifile, ofile, decode_base64)

                line = nifile.peek

                if not line:

                    # premature end of file

                    break

                continue

            # not a boundary between parts

            break

        if line and quoted_printable:

            while line[-2:] == '=\n':

                line = line[:-2]

                newline = ifile.readline()

                if newline[:len(QUOTE)] == QUOTE:

                    newline = newline[len(QUOTE):]

                line = line + newline

            line = mime_decode(line)

        if line and is_base64 and not pref:

            import base64

            line = base64.decodestring(line)

        if line:

            ofile.write(pref + line)



def unmimify(infile, outfile, decode_base64 = 0):

    """Convert quoted-printable parts of a MIME mail message to 8bit."""

    if type(infile) == type(''):

        ifile = open(infile)

        if type(outfile) == type('') and infile == outfile:

            import os

            d, f = os.path.split(infile)

            os.rename(infile, os.path.join(d, ',' + f))

    else:

        ifile = infile

    if type(outfile) == type(''):

        ofile = open(outfile, 'w')

    else:

        ofile = outfile

    nifile = File(ifile, None)

    unmimify_part(nifile, ofile, decode_base64)

    ofile.flush()



mime_char = re.compile('[=\177-\377]') # quote these chars in body

mime_header_char = re.compile('[=?\177-\377]') # quote these in header



def mime_encode(line, header):

    """Code a single line as quoted-printable.

    If header is set, quote some extra characters."""

    if header:

        reg = mime_header_char

    else:

        reg = mime_char

    newline = ''

    pos = 0

    if len(line) >= 5 and line[:5] == 'From ':

        # quote 'From ' at the start of a line for stupid mailers

        newline = ('=%02x' % ord('F')).upper()

        pos = 1

    while 1:

        res = reg.search(line, pos)

        if res is None:

            break

        newline = newline + line[pos:res.start(0)] + \

                  ('=%02x' % ord(res.group(0))).upper()

        pos = res.end(0)

    line = newline + line[pos:]



    newline = ''

    while len(line) >= 75:

        i = 73

        while line[i] == '=' or line[i-1] == '=':

            i = i - 1

        i = i + 1

        newline = newline + line[:i] + '=\n'

        line = line[i:]

    return newline + line



mime_header = re.compile('([ \t(]|^)([-a-zA-Z0-9_+]*[\177-\377][-a-zA-Z0-9_+\177-\377]*)(?=[ \t)]|\n)')



def mime_encode_header(line):

    """Code a single header line as quoted-printable."""

    newline = ''

    pos = 0

    while 1:

        res = mime_header.search(line, pos)

        if res is None:

            break

        newline = '%s%s%s=?%s?Q?%s?=' % \

                  (newline, line[pos:res.start(0)], res.group(1),

                   CHARSET, mime_encode(res.group(2), 1))

        pos = res.end(0)

    return newline + line[pos:]



mv = re.compile('^mime-version:', re.I)

cte = re.compile('^content-transfer-encoding:', re.I)

iso_char = re.compile('[\177-\377]')



def mimify_part(ifile, ofile, is_mime):

    """Convert an 8bit part of a MIME mail message to quoted-printable."""

    has_cte = is_qp = is_base64 = 0

    multipart = None

    must_quote_body = must_quote_header = has_iso_chars = 0



    header = []

    header_end = ''

    message = []

    message_end = ''

    # read header

    hfile = HeaderFile(ifile)

    while 1:

        line = hfile.readline()

        if not line:

            break

        if not must_quote_header and iso_char.search(line):

            must_quote_header = 1

        if mv.match(line):

            is_mime = 1

        if cte.match(line):

            has_cte = 1

            if qp.match(line):

                is_qp = 1

            elif base64_re.match(line):

                is_base64 = 1

        mp_res = mp.match(line)

        if mp_res:

            multipart = '--' + mp_res.group(1)

        if he.match(line):

            header_end = line

            break

        header.append(line)



    # read body

    while 1:

        line = ifile.readline()

        if not line:

            break

        if multipart:

            if line == multipart + '--\n':

                message_end = line

                break

            if line == multipart + '\n':

                message_end = line

                break

        if is_base64:

            message.append(line)

            continue

        if is_qp:

            while line[-2:] == '=\n':

                line = line[:-2]

                newline = ifile.readline()

                if newline[:len(QUOTE)] == QUOTE:

                    newline = newline[len(QUOTE):]

                line = line + newline

            line = mime_decode(line)

        message.append(line)

        if not has_iso_chars:

            if iso_char.search(line):

                has_iso_chars = must_quote_body = 1

        if not must_quote_body:

            if len(line) > MAXLEN:

                must_quote_body = 1



    # convert and output header and body

    for line in header:

        if must_quote_header:

            line = mime_encode_header(line)

        chrset_res = chrset.match(line)

        if chrset_res:

            if has_iso_chars:

                # change us-ascii into iso-8859-1

                if chrset_res.group(2).lower() == 'us-ascii':

                    line = '%s%s%s' % (chrset_res.group(1),

                                       CHARSET,

                                       chrset_res.group(3))

            else:

                # change iso-8859-* into us-ascii

                line = '%sus-ascii%s' % chrset_res.group(1, 3)

        if has_cte and cte.match(line):

            line = 'Content-Transfer-Encoding: '

            if is_base64:

                line = line + 'base64\n'

            elif must_quote_body:

                line = line + 'quoted-printable\n'

            else:

                line = line + '7bit\n'

        ofile.write(line)

    if (must_quote_header or must_quote_body) and not is_mime:

        ofile.write('Mime-Version: 1.0\n')

        ofile.write('Content-Type: text/plain; ')

        if has_iso_chars:

            ofile.write('charset="%s"\n' % CHARSET)

        else:

            ofile.write('charset="us-ascii"\n')

    if must_quote_body and not has_cte:

        ofile.write('Content-Transfer-Encoding: quoted-printable\n')

    ofile.write(header_end)



    for line in message:

        if must_quote_body:

            line = mime_encode(line, 0)

        ofile.write(line)

    ofile.write(message_end)



    line = message_end

    while multipart:

        if line == multipart + '--\n':

            # read bit after the end of the last part

            while 1:

                line = ifile.readline()

                if not line:

                    return

                if must_quote_body:

                    line = mime_encode(line, 0)

                ofile.write(line)

        if line == multipart + '\n':

            nifile = File(ifile, multipart)

            mimify_part(nifile, ofile, 1)

            line = nifile.peek

            if not line:

                # premature end of file

                break

            ofile.write(line)

            continue

        # unexpectedly no multipart separator--copy rest of file

        while 1:

            line = ifile.readline()

            if not line:

                return

            if must_quote_body:

                line = mime_encode(line, 0)

            ofile.write(line)



def mimify(infile, outfile):

    """Convert 8bit parts of a MIME mail message to quoted-printable."""

    if type(infile) == type(''):

        ifile = open(infile)

        if type(outfile) == type('') and infile == outfile:

            import os

            d, f = os.path.split(infile)

            os.rename(infile, os.path.join(d, ',' + f))

    else:

        ifile = infile

    if type(outfile) == type(''):

        ofile = open(outfile, 'w')

    else:

        ofile = outfile

    nifile = File(ifile, None)

    mimify_part(nifile, ofile, 0)

    ofile.flush()



import sys

if __name__ == '__main__' or (len(sys.argv) > 0 and sys.argv[0] == 'mimify'):

    import getopt

    usage = 'Usage: mimify [-l len] -[ed] [infile [outfile]]'



    decode_base64 = 0

    opts, args = getopt.getopt(sys.argv[1:], 'l:edb')

    if len(args) not in (0, 1, 2):

        print usage

        sys.exit(1)

    if (('-e', '') in opts) == (('-d', '') in opts) or \

       ((('-b', '') in opts) and (('-d', '') not in opts)):

        print usage

        sys.exit(1)

    for o, a in opts:

        if o == '-e':

            encode = mimify

        elif o == '-d':

            encode = unmimify

        elif o == '-l':

            try:

                MAXLEN = int(a)

            except (ValueError, OverflowError):

                print usage

                sys.exit(1)

        elif o == '-b':

            decode_base64 = 1

    if len(args) == 0:

        encode_args = (sys.stdin, sys.stdout)

    elif len(args) == 1:

        encode_args = (args[0], sys.stdout)

    else:

        encode_args = (args[0], args[1])

    if decode_base64:

        encode_args = encode_args + (decode_base64,)

    encode(*encode_args)

