3 # Copyright 1994 by Lance Ellinghouse
4 # Cathedral City, California Republic, United States of America.
6 # Permission to use, copy, modify, and distribute this software and its
7 # documentation for any purpose and without fee is hereby granted,
8 # provided that the above copyright notice appear in all copies and that
9 # both that copyright notice and this permission notice appear in
10 # supporting documentation, and that the name of Lance Ellinghouse
11 # not be used in advertising or publicity pertaining to distribution
12 # of the software without specific, written prior permission.
13 # LANCE ELLINGHOUSE DISCLAIMS ALL WARRANTIES WITH REGARD TO
14 # THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND
15 # FITNESS, IN NO EVENT SHALL LANCE ELLINGHOUSE CENTRUM BE LIABLE
16 # FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
17 # WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
18 # ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT
19 # OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
21 # Modified by Jack Jansen, CWI, July 1995:
22 # - Use binascii module to do the actual line-by-line conversion
23 # between ascii and binary. This results in a 1000-fold speedup. The C
24 # version is still 5 times faster, though.
25 # - Arguments more compliant with python standard
27 """Implementation of the UUencode and UUdecode functions.
29 encode(in_file, out_file [,name, mode])
30 decode(in_file [, out_file, mode])
37 __all__ = ["Error", "encode", "decode"]
39 class Error(Exception):
42 def encode(in_file, out_file, name=None, mode=None):
45 # If in_file is a pathname open it and change defaults
49 elif isinstance(in_file, basestring):
51 name = os.path.basename(in_file)
54 mode = os.stat(in_file).st_mode
55 except AttributeError:
57 in_file = open(in_file, 'rb')
59 # Open out_file if it is a pathname
63 elif isinstance(out_file, basestring):
64 out_file = open(out_file, 'w')
66 # Set defaults for name and mode
75 out_file.write('begin %o %s\n' % ((mode&0777),name))
76 data = in_file.read(45)
78 out_file.write(binascii.b2a_uu(data))
79 data = in_file.read(45)
80 out_file.write(' \nend\n')
83 def decode(in_file, out_file=None, mode=None, quiet=0):
84 """Decode uuencoded file"""
86 # Open the input file, if needed.
90 elif isinstance(in_file, basestring):
91 in_file = open(in_file)
93 # Read until a begin is encountered or we've exhausted the file
96 hdr = in_file.readline()
98 raise Error('No valid begin line found in input file')
99 if not hdr.startswith('begin'):
101 hdrfields = hdr.split(' ', 2)
102 if len(hdrfields) == 3 and hdrfields[0] == 'begin':
109 out_file = hdrfields[2].rstrip()
110 if os.path.exists(out_file):
111 raise Error('Cannot overwrite existing file: %s' % out_file)
113 mode = int(hdrfields[1], 8)
115 # Open the output file
119 out_file = sys.stdout
120 elif isinstance(out_file, basestring):
121 fp = open(out_file, 'wb')
123 os.path.chmod(out_file, mode) #@UndefinedVariable
124 except AttributeError:
131 s = in_file.readline()
132 while s and s.strip() != 'end':
134 data = binascii.a2b_uu(s)
135 except binascii.Error, v:
136 # Workaround for broken uuencoders by /Fredrik Lundh
137 nbytes = (((ord(s[0])-32) & 63) * 4 + 5) // 3
138 data = binascii.a2b_uu(s[:nbytes])
140 sys.stderr.write("Warning: %s\n" % v)
142 s = in_file.readline()
144 raise Error('Truncated input file')
149 """uuencode/uudecode main program"""
152 parser = optparse.OptionParser(usage='usage: %prog [-d] [-t] [input [output]]')
153 parser.add_option('-d', '--decode', dest='decode', help='Decode (instead of encode)?', default=False, action='store_true')
154 parser.add_option('-t', '--text', dest='text', help='data is text, encoded format unix-compatible text?', default=False, action='store_true')
156 (options, args) = parser.parse_args()
158 parser.error('incorrect number of arguments')
170 if isinstance(output, basestring):
171 output = open(output, 'w')
173 print sys.argv[0], ': cannot do -t to stdout'
175 decode(input, output)
178 if isinstance(input, basestring):
179 input = open(input, 'r')
181 print sys.argv[0], ': cannot do -t from stdin'
183 encode(input, output)
185 if __name__ == '__main__':