1#! /usr/bin/env python
2
3# Copyright 1994 by Lance Ellinghouse
4# Cathedral City, California Republic, United States of America.
5#                        All Rights Reserved
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.
20#
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
26
27"""Implementation of the UUencode and UUdecode functions.
28
29encode(in_file, out_file [,name, mode])
30decode(in_file [, out_file, mode])
31"""
32
33import binascii
34import os
35import sys
36
37__all__ = ["Error", "encode", "decode"]
38
39class Error(Exception):
40    pass
41
42def encode(in_file, out_file, name=None, mode=None):
43    """Uuencode file"""
44    #
45    # If in_file is a pathname open it and change defaults
46    #
47
48    close_in_file = False
49    close_out_file = False
50
51    if in_file == '-':
52        in_file = sys.stdin
53    elif isinstance(in_file, basestring):
54        if name is None:
55            name = os.path.basename(in_file)
56        if mode is None:
57            try:
58                mode = os.stat(in_file).st_mode
59            except AttributeError:
60                pass
61        in_file = open(in_file, 'rb')
62        close_in_file = True
63    #
64    # Open out_file if it is a pathname
65    #
66    if out_file == '-':
67        out_file = sys.stdout
68    elif isinstance(out_file, basestring):
69        out_file = open(out_file, 'w')
70        close_out_file = True
71    #
72    # Set defaults for name and mode
73    #
74    if name is None:
75        name = '-'
76    if mode is None:
77        mode = 0666
78    #
79    # Write the data
80    #
81    out_file.write('begin %o %s\n' % ((mode&0777),name))
82    data = in_file.read(45)
83    while len(data) > 0:
84        out_file.write(binascii.b2a_uu(data))
85        data = in_file.read(45)
86    out_file.write(' \nend\n')
87
88    # Jython and other implementations requires files to be explicitly
89    # closed if we don't want to wait for GC
90    if close_in_file:
91        in_file.close()
92    if close_out_file:
93        out_file.close()
94
95def decode(in_file, out_file=None, mode=None, quiet=0):
96    """Decode uuencoded file"""
97
98    close_in_file = False
99    close_out_file = False
100
101    #
102    # Open the input file, if needed.
103    #
104    if in_file == '-':
105        in_file = sys.stdin
106    elif isinstance(in_file, basestring):
107        close_in_file = True
108        in_file = open(in_file)
109    #
110    # Read until a begin is encountered or we've exhausted the file
111    #
112    while True:
113        hdr = in_file.readline()
114        if not hdr:
115            raise Error('No valid begin line found in input file')
116        if not hdr.startswith('begin'):
117            continue
118        hdrfields = hdr.split(' ', 2)
119        if len(hdrfields) == 3 and hdrfields[0] == 'begin':
120            try:
121                int(hdrfields[1], 8)
122                break
123            except ValueError:
124                pass
125    if out_file is None:
126        out_file = hdrfields[2].rstrip()
127        if os.path.exists(out_file):
128            raise Error('Cannot overwrite existing file: %s' % out_file)
129    if mode is None:
130        mode = int(hdrfields[1], 8)
131    #
132    # Open the output file
133    #
134    opened = False
135    if out_file == '-':
136        out_file = sys.stdout
137    elif isinstance(out_file, basestring):
138        close_out_file = True
139        fp = open(out_file, 'wb')
140        try:
141            os.path.chmod(out_file, mode)
142        except AttributeError:
143            pass
144        out_file = fp
145        opened = True
146    #
147    # Main decoding loop
148    #
149    s = in_file.readline()
150    while s and s.strip() != 'end':
151        try:
152            data = binascii.a2b_uu(s)
153        except binascii.Error, v:
154            # Workaround for broken uuencoders by /Fredrik Lundh
155            nbytes = (((ord(s[0])-32) & 63) * 4 + 5) // 3
156            data = binascii.a2b_uu(s[:nbytes])
157            if not quiet:
158                sys.stderr.write("Warning: %s\n" % v)
159        out_file.write(data)
160        s = in_file.readline()
161    if not s:
162        raise Error('Truncated input file')
163    if opened:
164        out_file.close()
165
166    # Jython and other implementations requires files to be explicitly
167    # closed if we don't want to wait for GC
168    if close_in_file:
169        in_file.close()
170    if close_out_file:
171        out_file.close()
172
173def test():
174    """uuencode/uudecode main program"""
175
176    import optparse
177    parser = optparse.OptionParser(usage='usage: %prog [-d] [-t] [input [output]]')
178    parser.add_option('-d', '--decode', dest='decode', help='Decode (instead of encode)?', default=False, action='store_true')
179    parser.add_option('-t', '--text', dest='text', help='data is text, encoded format unix-compatible text?', default=False, action='store_true')
180
181    (options, args) = parser.parse_args()
182    if len(args) > 2:
183        parser.error('incorrect number of arguments')
184        sys.exit(1)
185
186    input = sys.stdin
187    output = sys.stdout
188    if len(args) > 0:
189        input = args[0]
190    if len(args) > 1:
191        output = args[1]
192
193    if options.decode:
194        if options.text:
195            if isinstance(output, basestring):
196                output = open(output, 'w')
197            else:
198                print sys.argv[0], ': cannot do -t to stdout'
199                sys.exit(1)
200        decode(input, output)
201    else:
202        if options.text:
203            if isinstance(input, basestring):
204                input = open(input, 'r')
205            else:
206                print sys.argv[0], ': cannot do -t from stdin'
207                sys.exit(1)
208        encode(input, output)
209
210if __name__ == '__main__':
211    test()
212