#! /usr/libexec/platform-python -s
"""Conversions to/from quoted-printable transport encoding as per RFC 1521."""
__all__ = ["encode", "decode", "encodestring", "decodestring"]
HEX = b'0123456789ABCDEF'
from binascii import a2b_qp, b2a_qp
def needsquoting(c, quotetabs, header):
"""Decide whether a particular byte ordinal needs to be quoted.
The 'quotetabs' flag indicates whether embedded tabs and spaces should be
quoted. Note that line-ending tabs and spaces are always encoded, as per
assert isinstance(c, bytes)
# if header, we have to escape _ because _ is used to escape space
return c == ESCAPE or not (b' ' <= c <= b'~')
"""Quote a single character."""
assert isinstance(c, bytes) and len(c)==1
return ESCAPE + bytes((HEX[c//16], HEX[c%16]))
def encode(input, output, quotetabs, header=False):
"""Read 'input', apply quoted-printable encoding, and write to 'output'.
'input' and 'output' are binary file objects. The 'quotetabs' flag
indicates whether embedded tabs and spaces should be quoted. Note that
line-ending tabs and spaces are always encoded, as per RFC 1521.
The 'header' flag indicates whether we are encoding spaces as _ as per RFC
odata = b2a_qp(data, quotetabs=quotetabs, header=header)
def write(s, output=output, lineEnd=b'\n'):
# RFC 1521 requires that the line ending in a space or tab must have
# that trailing character encoded.
if s and s[-1:] in b' \t':
output.write(s[:-1] + quote(s[-1:]) + lineEnd)
output.write(quote(s) + lineEnd)
output.write(s + lineEnd)
# Strip off any readline induced trailing newline
# Calculate the un-length-limited encoded line
if needsquoting(c, quotetabs, header):
# First, write out the previous line
# Now see if we need any soft line breaks because of RFC-imposed
# length limitations. Then do the thisline->prevline dance.
thisline = EMPTYSTRING.join(outline)
while len(thisline) > MAXLINESIZE:
# Don't forget to include the soft line break `=' sign in the
write(thisline[:MAXLINESIZE-1], lineEnd=b'=\n')
thisline = thisline[MAXLINESIZE-1:]
# Write out the current line
# Write out the last line, without a trailing newline
write(prevline, lineEnd=stripped)
def encodestring(s, quotetabs=False, header=False):
return b2a_qp(s, quotetabs=quotetabs, header=header)
encode(infp, outfp, quotetabs, header)
def decode(input, output, header=False):
"""Read 'input', apply quoted-printable decoding, and write to 'output'.
'input' and 'output' are binary file objects.
If 'header' is true, decode underscore as space (per RFC 1522)."""
odata = a2b_qp(data, header=header)
if n > 0 and line[n-1:n] == b'\n':
# Strip trailing whitespace
while n > 0 and line[n-1:n] in b" \t\r":
new = new + b' '; i = i+1
elif i+1 == n and not partial:
elif i+1 < n and line[i+1:i+2] == ESCAPE:
new = new + ESCAPE; i = i+2
elif i+2 < n and ishex(line[i+1:i+2]) and ishex(line[i+2:i+3]):
new = new + bytes((unhex(line[i+1:i+3]),)); i = i+3
else: # Bad escape sequence -- leave it in
output.write(new + b'\n')
def decodestring(s, header=False):
return a2b_qp(s, header=header)
decode(infp, outfp, header=header)
"""Return true if the byte ordinal 'c' is a hexadecimal digit in ASCII."""
assert isinstance(c, bytes)
return b'0' <= c <= b'9' or b'a' <= c <= b'f' or b'A' <= c <= b'F'
"""Get the integer value of a hexadecimal number."""
assert False, "non-hex digit "+repr(c)
bits = bits*16 + (ord(c) - i)
opts, args = getopt.getopt(sys.argv[1:], 'td')
except getopt.error as msg:
print("usage: quopri [-t | -d] [file] ...")
print("-d: decode; default encode")
if o == '-t': tabs = True
if o == '-d': deco = True
print("-t and -d are mutually exclusive")
if not args: args = ['-']
sys.stderr.write("%s: can't open (%s)\n" % (file, msg))
decode(fp, sys.stdout.buffer)
encode(fp, sys.stdout.buffer, tabs)
if __name__ == '__main__':