



	advanced \| search help

Reference

ActivePython 2.4

Python Documentation

Library Reference

12. Internet Data Handling

12.1 formatter -- Generic output formatting

12.2 email -- An email and MIME handling package

12.3 mailcap -- Mailcap file handling.

12.4 mailbox -- Read various mailbox formats

12.5 mhlib -- Access to MH mailboxes

12.6 mimetools -- Tools for parsing MIME messages

12.7 mimetypes -- Map filenames to MIME types

12.8 MimeWriter -- Generic MIME file writer

12.9 mimify -- MIME processing of mail messages

12.10 multifile -- Support for files containing distinct parts

12.11 rfc822 -- Parse RFC 2822 mail headers

12.12 base64 -- RFC 3548: Base16, Base32, Base64 Data Encodings

12.13 binascii -- Convert between binary and ASCII

12.14 binhex -- Encode and decode binhex4 files

12.15 quopri -- Encode and decode MIME quoted-printable data

12.16 uu -- Encode and decode uuencode files

12.17 xdrlib -- Encode and decode XDR data

12.18 netrc -- netrc file processing

12.19 robotparser -- Parser for robots.txt

12.20 csv -- CSV File Reading and Writing

MyASPN >> Reference >> ActivePython 2.4 >> Python Documentation >> Library Reference >> 12. Internet Data Handling

ActivePython 2.4 documentation

12.16 `uu` -- Encode and decode uuencode files

This module encodes and decodes files in uuencode format, allowing arbitrary binary data to be transferred over ASCII-only connections. Wherever a file argument is expected, the methods accept a file-like object. For backwards compatibility, a string containing a pathname is also accepted, and the corresponding file will be opened for reading and writing; the pathname '-' is understood to mean the standard input or output. However, this interface is deprecated; it's better for the caller to open the file itself, and be sure that, when required, the mode is 'rb' or 'wb' on Windows.

This code was contributed by Lance Ellinghouse, and modified by Jack Jansen.

The uu module defines the following functions:

encode( in_file, out_file[, name[, mode]]): Uuencode file in_file into file out_file. The uuencoded file will have the header specifying name and mode as the defaults for the results of decoding the file. The default defaults are taken from in_file, or '-' and 0666 respectively.

decode( in_file[, out_file[, mode[, quiet]]]): This call decodes uuencoded file in_file placing the result on file out_file. If out_file is a pathname, mode is used to set the permission bits if the file must be created. Defaults for out_file and mode are taken from the uuencode header. However, if the file specified in the header already exists, a uu.Error is raised.
decode() may print a warning to standard error if the input was produced by an incorrect uuencoder and Python could recover from that error. Setting quiet to a true value silences this warning.

exception Error( ): Subclass of Exception, this can be raised by uu.decode() under various situations, such as described above, but also including a badly formatted header, or truncated input file.