# Copyright 1994 by Lance Ellinghouse
# Cathedral City, California Republic, United States of America.
# Permission to use, copy, modify, and distribute this software and its
# documentation for any purpose and without fee is hereby granted,
# provided that the above copyright notice appear in all copies and that
# both that copyright notice and this permission notice appear in
# supporting documentation, and that the name of Lance Ellinghouse
# not be used in advertising or publicity pertaining to distribution
# of the software without specific, written prior permission.
# LANCE ELLINGHOUSE DISCLAIMS ALL WARRANTIES WITH REGARD TO
# THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
# FITNESS, IN NO EVENT SHALL LANCE ELLINGHOUSE CENTRUM BE LIABLE
# FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
# WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
# ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
# OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
# Modified by Jack Jansen, CWI, July 1995:
# - Use binascii module to do the actual line-by-line conversion
# between ascii and binary. This results in a 1000-fold speedup. The C
# version is still 5 times faster, though.
# - Arguments more compliant with python standard
"""Implementation of the UUencode and UUdecode functions.
encode(in_file, out_file [,name, mode], *, backtick=False)
decode(in_file [, out_file, mode, quiet])
__all__ = ["Error", "encode", "decode"]
def encode(in_file, out_file, name=None, mode=None, *, backtick=False):
# If in_file is a pathname open it and change defaults
in_file = sys.stdin.buffer
elif isinstance(in_file, str):
name = os.path.basename(in_file)
mode = os.stat(in_file).st_mode
in_file = open(in_file, 'rb')
opened_files.append(in_file)
# Open out_file if it is a pathname
out_file = sys.stdout.buffer
elif isinstance(out_file, str):
out_file = open(out_file, 'wb')
opened_files.append(out_file)
# Set defaults for name and mode
# Remove newline chars from name
name = name.replace('\n','\\n')
name = name.replace('\r','\\r')
out_file.write(('begin %o %s\n' % ((mode & 0o777), name)).encode("ascii"))
out_file.write(binascii.b2a_uu(data, backtick=backtick))
out_file.write(b'`\nend\n')
out_file.write(b' \nend\n')
def decode(in_file, out_file=None, mode=None, quiet=False):
"""Decode uuencoded file"""
# Open the input file, if needed.
in_file = sys.stdin.buffer
elif isinstance(in_file, str):
in_file = open(in_file, 'rb')
opened_files.append(in_file)
# Read until a begin is encountered or we've exhausted the file
raise Error('No valid begin line found in input file')
if not hdr.startswith(b'begin'):
hdrfields = hdr.split(b' ', 2)
if len(hdrfields) == 3 and hdrfields[0] == b'begin':
# If the filename isn't ASCII, what's up with that?!?
out_file = hdrfields[2].rstrip(b' \t\r\n\f').decode("ascii")
if os.path.exists(out_file):
raise Error(f'Cannot overwrite existing file: {out_file}')
if (out_file.startswith(os.sep) or
f'..{os.sep}' in out_file or (
(out_file.startswith(os.altsep) or
f'..{os.altsep}' in out_file))
raise Error(f'Refusing to write to {out_file} due to directory traversal')
mode = int(hdrfields[1], 8)
out_file = sys.stdout.buffer
elif isinstance(out_file, str):
fp = open(out_file, 'wb')
opened_files.append(out_file)
while s and s.strip(b' \t\r\n\f') != b'end':
data = binascii.a2b_uu(s)
except binascii.Error as v:
# Workaround for broken uuencoders by /Fredrik Lundh
nbytes = (((s[0]-32) & 63) * 4 + 5) // 3
data = binascii.a2b_uu(s[:nbytes])
sys.stderr.write("Warning: %s\n" % v)
raise Error('Truncated input file')
"""uuencode/uudecode main program"""
parser = optparse.OptionParser(usage='usage: %prog [-d] [-t] [input [output]]')
parser.add_option('-d', '--decode', dest='decode', help='Decode (instead of encode)?', default=False, action='store_true')
parser.add_option('-t', '--text', dest='text', help='data is text, encoded format unix-compatible text?', default=False, action='store_true')
(options, args) = parser.parse_args()
parser.error('incorrect number of arguments')
# Use the binary streams underlying stdin/stdout
output = sys.stdout.buffer
if isinstance(output, str):
output = open(output, 'wb')
print(sys.argv[0], ': cannot do -t to stdout')
if isinstance(input, str):
input = open(input, 'rb')
print(sys.argv[0], ': cannot do -t from stdin')
if __name__ == '__main__':