Google Git
Sign in
chromium / external / github.com / python / cpython / refs/tags/3.6 / . / Lib / uu.py
blob: 3a8c31cff06d8f5842db916f5470024c9d7fb333 [file] [log] [blame]
Benjamin Peterson90f5ba52010-03-11 22:53:45[diff] [blame]1#! /usr/bin/env python3
Guido van Rossum105bd981997-07-11 18:39:03[diff] [blame]2
Guido van Rossum85347411994-09-09 11:10:15[diff] [blame]3# Copyright 1994 by Lance Ellinghouse
4# Cathedral City, California Republic, United States of America.
5# All Rights Reserved
Tim Peterse1190062001-01-15 03:34:38[diff] [blame]6# Permission to use, copy, modify, and distribute this software and its
7# documentation for any purpose and without fee is hereby granted,
Guido van Rossum85347411994-09-09 11:10:15[diff] [blame]8# provided that the above copyright notice appear in all copies and that
Tim Peterse1190062001-01-15 03:34:38[diff] [blame]9# both that copyright notice and this permission notice appear in
Guido van Rossum85347411994-09-09 11:10:15[diff] [blame]10# supporting documentation, and that the name of Lance Ellinghouse
Tim Peterse1190062001-01-15 03:34:38[diff] [blame]11# not be used in advertising or publicity pertaining to distribution
Guido van Rossum85347411994-09-09 11:10:15[diff] [blame]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.
Jack Jansen0a2eaac1995-08-07 14:37:38[diff] [blame]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.
Jack Jansen8b745121995-08-30 12:19:30[diff] [blame]25# - Arguments more compliant with python standard
Guido van Rossum85347411994-09-09 11:10:15[diff] [blame]26
Guido van Rossume7b146f2000-02-04 15:28:42[diff] [blame]27"""Implementation of the UUencode and UUdecode functions.
28
29encode(in_file, out_file [,name, mode])
30decode(in_file [, out_file, mode])
31"""
Guido van Rossum85347411994-09-09 11:10:15[diff] [blame]32
Jack Jansen0a2eaac1995-08-07 14:37:38[diff] [blame]33import binascii
Jack Jansen8b745121995-08-30 12:19:30[diff] [blame]34import os
Guido van Rossumfbba3041998-10-22 16:18:25[diff] [blame]35import sys
Guido van Rossum85347411994-09-09 11:10:15[diff] [blame]36
Skip Montanaro40fc1602001-03-01 04:27:19[diff] [blame]37__all__ = ["Error", "encode", "decode"]
38
Fred Drake9b8d8012000-08-17 04:45:13[diff] [blame]39class Error(Exception):
40 pass
Jack Jansen8b745121995-08-30 12:19:30[diff] [blame]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 #
Antoine Pitroubfa34702010-10-30 13:03:56[diff] [blame]47 opened_files = []
48 try:
49 if in_file == '-':
50 in_file = sys.stdin.buffer
51 elif isinstance(in_file, str):
52 if name is None:
53 name = os.path.basename(in_file)
54 if mode is None:
55 try:
56 mode = os.stat(in_file).st_mode
57 except AttributeError:
58 pass
59 in_file = open(in_file, 'rb')
60 opened_files.append(in_file)
61 #
62 # Open out_file if it is a pathname
63 #
64 if out_file == '-':
65 out_file = sys.stdout.buffer
66 elif isinstance(out_file, str):
67 out_file = open(out_file, 'wb')
68 opened_files.append(out_file)
69 #
70 # Set defaults for name and mode
71 #
Fred Drake8152d322000-12-12 23:20:45[diff] [blame]72 if name is None:
Antoine Pitroubfa34702010-10-30 13:03:56[diff] [blame]73 name = '-'
Fred Drake8152d322000-12-12 23:20:45[diff] [blame]74 if mode is None:
Antoine Pitroubfa34702010-10-30 13:03:56[diff] [blame]75 mode = 0o666
Miss Islington (bot)30afc912019-12-02 23:34:31[diff] [blame]76
77 #
78 # Remove newline chars from name
79 #
80 name = name.replace('\n','\\n')
81 name = name.replace('\r','\\r')
82
Antoine Pitroubfa34702010-10-30 13:03:56[diff] [blame]83 #
84 # Write the data
85 #
86 out_file.write(('begin %o %s\n' % ((mode & 0o777), name)).encode("ascii"))
Walter Dörwald91043f32005-11-22 12:58:19[diff] [blame]87 data = in_file.read(45)
Antoine Pitroubfa34702010-10-30 13:03:56[diff] [blame]88 while len(data) > 0:
89 out_file.write(binascii.b2a_uu(data))
90 data = in_file.read(45)
91 out_file.write(b' \nend\n')
92 finally:
93 for f in opened_files:
94 f.close()
Guido van Rossum85347411994-09-09 11:10:15[diff] [blame]95
Guido van Rossum85347411994-09-09 11:10:15[diff] [blame]96
Georg Brandlfe991052009-09-16 15:54:04[diff] [blame]97def decode(in_file, out_file=None, mode=None, quiet=False):
Jack Jansen8b745121995-08-30 12:19:30[diff] [blame]98 """Decode uuencoded file"""
99 #
100 # Open the input file, if needed.
101 #
Antoine Pitrouf5698262010-10-31 16:04:14[diff] [blame]102 opened_files = []
Jack Jansen8b745121995-08-30 12:19:30[diff] [blame]103 if in_file == '-':
Guido van Rossum34d19282007-08-09 01:03:29[diff] [blame]104 in_file = sys.stdin.buffer
Guido van Rossum3172c5d2007-10-16 18:12:55[diff] [blame]105 elif isinstance(in_file, str):
Guido van Rossum34d19282007-08-09 01:03:29[diff] [blame]106 in_file = open(in_file, 'rb')
Antoine Pitrouf5698262010-10-31 16:04:14[diff] [blame]107 opened_files.append(in_file)
108
109 try:
110 #
111 # Read until a begin is encountered or we've exhausted the file
112 #
113 while True:
114 hdr = in_file.readline()
115 if not hdr:
116 raise Error('No valid begin line found in input file')
117 if not hdr.startswith(b'begin'):
118 continue
119 hdrfields = hdr.split(b' ', 2)
120 if len(hdrfields) == 3 and hdrfields[0] == b'begin':
121 try:
122 int(hdrfields[1], 8)
123 break
124 except ValueError:
125 pass
126 if out_file is None:
127 # If the filename isn't ASCII, what's up with that?!?
128 out_file = hdrfields[2].rstrip(b' \t\r\n\f').decode("ascii")
129 if os.path.exists(out_file):
130 raise Error('Cannot overwrite existing file: %s' % out_file)
131 if mode is None:
132 mode = int(hdrfields[1], 8)
133 #
134 # Open the output file
135 #
136 if out_file == '-':
137 out_file = sys.stdout.buffer
138 elif isinstance(out_file, str):
139 fp = open(out_file, 'wb')
Guido van Rossum45e2fbc1998-03-26 21:13:24[diff] [blame]140 try:
Antoine Pitrouf5698262010-10-31 16:04:14[diff] [blame]141 os.path.chmod(out_file, mode)
142 except AttributeError:
Guido van Rossum45e2fbc1998-03-26 21:13:24[diff] [blame]143 pass
Antoine Pitrouf5698262010-10-31 16:04:14[diff] [blame]144 out_file = fp
145 opened_files.append(out_file)
146 #
147 # Main decoding loop
148 #
Guido van Rossum44941011999-01-05 18:02:24[diff] [blame]149 s = in_file.readline()
Antoine Pitrouf5698262010-10-31 16:04:14[diff] [blame]150 while s and s.strip(b' \t\r\n\f') != b'end':
151 try:
152 data = binascii.a2b_uu(s)
153 except binascii.Error as v:
154 # Workaround for broken uuencoders by /Fredrik Lundh
155 nbytes = (((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 finally:
164 for f in opened_files:
165 f.close()
Guido van Rossum85347411994-09-09 11:10:15[diff] [blame]166
167def test():
Jack Jansen8b745121995-08-30 12:19:30[diff] [blame]168 """uuencode/uudecode main program"""
Jack Jansen8b745121995-08-30 12:19:30[diff] [blame]169
Walter Dörwaldd331b432005-11-22 14:12:21[diff] [blame]170 import optparse
171 parser = optparse.OptionParser(usage='usage: %prog [-d] [-t] [input [output]]')
172 parser.add_option('-d', '--decode', dest='decode', help='Decode (instead of encode)?', default=False, action='store_true')
173 parser.add_option('-t', '--text', dest='text', help='data is text, encoded format unix-compatible text?', default=False, action='store_true')
174
175 (options, args) = parser.parse_args()
176 if len(args) > 2:
Thomas Wouters49fd7fa2006-04-21 10:40:58[diff] [blame]177 parser.error('incorrect number of arguments')
Guido van Rossum45e2fbc1998-03-26 21:13:24[diff] [blame]178 sys.exit(1)
Tim Peterse1190062001-01-15 03:34:38[diff] [blame]179
Guido van Rossum34d19282007-08-09 01:03:29[diff] [blame]180 # Use the binary streams underlying stdin/stdout
181 input = sys.stdin.buffer
182 output = sys.stdout.buffer
Jack Jansen8b745121995-08-30 12:19:30[diff] [blame]183 if len(args) > 0:
Guido van Rossum45e2fbc1998-03-26 21:13:24[diff] [blame]184 input = args[0]
Jack Jansen8b745121995-08-30 12:19:30[diff] [blame]185 if len(args) > 1:
Guido van Rossum45e2fbc1998-03-26 21:13:24[diff] [blame]186 output = args[1]
Jack Jansen8b745121995-08-30 12:19:30[diff] [blame]187
Walter Dörwaldd331b432005-11-22 14:12:21[diff] [blame]188 if options.decode:
189 if options.text:
Guido van Rossum3172c5d2007-10-16 18:12:55[diff] [blame]190 if isinstance(output, str):
Guido van Rossum34d19282007-08-09 01:03:29[diff] [blame]191 output = open(output, 'wb')
Guido van Rossum45e2fbc1998-03-26 21:13:24[diff] [blame]192 else:
Guido van Rossumbe19ed72007-02-09 05:37:30[diff] [blame]193 print(sys.argv[0], ': cannot do -t to stdout')
Guido van Rossum45e2fbc1998-03-26 21:13:24[diff] [blame]194 sys.exit(1)
195 decode(input, output)
Guido van Rossum85347411994-09-09 11:10:15[diff] [blame]196 else:
Walter Dörwaldd331b432005-11-22 14:12:21[diff] [blame]197 if options.text:
Guido van Rossum3172c5d2007-10-16 18:12:55[diff] [blame]198 if isinstance(input, str):
Guido van Rossum34d19282007-08-09 01:03:29[diff] [blame]199 input = open(input, 'rb')
Guido van Rossum45e2fbc1998-03-26 21:13:24[diff] [blame]200 else:
Guido van Rossumbe19ed72007-02-09 05:37:30[diff] [blame]201 print(sys.argv[0], ': cannot do -t from stdin')
Guido van Rossum45e2fbc1998-03-26 21:13:24[diff] [blame]202 sys.exit(1)
203 encode(input, output)
Guido van Rossum85347411994-09-09 11:10:15[diff] [blame]204
205if __name__ == '__main__':
206 test()