Encoders.py 2.48 KB
Newer Older
1
# Copyright (C) 2001,2002 Python Software Foundation
2 3 4 5 6 7 8 9
# Author: barry@zope.com (Barry Warsaw)

"""Module containing encoding functions for Image.Image and Text.Text.
"""

import base64


10

11
# Helpers
12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35
try:
    from quopri import encodestring as _encodestring

    def _qencode(s):
        enc = _encodestring(s, quotetabs=1)
        # Must encode spaces, which quopri.encodestring() doesn't do
        return enc.replace(' ', '=20')
except ImportError:
    # Python 2.1 doesn't have quopri.encodestring()
    from cStringIO import StringIO
    import quopri as _quopri

    def _qencode(s):
        if not s:
            return s
        hasnewline = (s[-1] == '\n')
        infp = StringIO(s)
        outfp = StringIO()
        _quopri.encode(infp, outfp, quotetabs=1)
        # Python 2.x's encode() doesn't encode spaces even when quotetabs==1
        value = outfp.getvalue().replace(' ', '=20')
        if not hasnewline and value[-1] == '\n':
            return value[:-1]
        return value
36

Barry Warsaw's avatar
Barry Warsaw committed
37

38 39 40 41 42 43 44 45 46 47 48 49
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


50

51 52 53 54 55 56 57 58 59 60 61
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'


62

63 64 65 66 67 68 69 70 71 72 73
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'


74

75 76 77
def encode_7or8bit(msg):
    """Set the Content-Transfer-Encoding: header to 7bit or 8bit."""
    orig = msg.get_payload()
78 79 80 81
    if orig is None:
        # There's no payload.  For backwards compatibility we use 7bit
        msg['Content-Transfer-Encoding'] = '7bit'
        return
82 83 84 85 86 87 88 89 90 91
    # 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'


92

93 94
def encode_noop(msg):
    """Do nothing."""