aboutsummaryrefslogtreecommitdiffstats
path: root/contrib/tools/python3/src/Lib/email/encoders.py
blob: b2642579ae4ddab00c2ee0b232905ce1b970f189 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
# 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', 
    ] 
 
 
from base64 import encodebytes as _bencode 
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(b' ', b'=20') 
 
 
def encode_base64(msg): 
    """Encode the message's payload in Base64. 
 
    Also, add an appropriate Content-Transfer-Encoding header. 
    """ 
    orig = msg.get_payload(decode=True) 
    encdata = str(_bencode(orig), 'ascii') 
    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(decode=True) 
    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(decode=True) 
    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 decoding from ASCII succeeds, 
    # we know the data must be 7bit, otherwise treat it as 8bit. 
    try: 
        orig.decode('ascii') 
    except UnicodeError: 
        msg['Content-Transfer-Encoding'] = '8bit' 
    else: 
        msg['Content-Transfer-Encoding'] = '7bit' 
 
 
 
def encode_noop(msg): 
    """Do nothing."""