1:mod:`binhex` --- Encode and decode binhex4 files 2================================================= 3 4.. module:: binhex 5 :synopsis: Encode and decode files in binhex4 format. 6 7 8This module encodes and decodes files in binhex4 format, a format allowing 9representation of Macintosh files in ASCII. On the Macintosh, both forks of a 10file and the finder information are encoded (or decoded), on other platforms 11only the data fork is handled. 12 13.. note:: 14 15 In Python 3.x, special Macintosh support has been removed. 16 17 18The :mod:`binhex` module defines the following functions: 19 20 21.. function:: binhex(input, output) 22 23 Convert a binary file with filename *input* to binhex file *output*. The 24 *output* parameter can either be a filename or a file-like object (any object 25 supporting a :meth:`write` and :meth:`close` method). 26 27 28.. function:: hexbin(input[, output]) 29 30 Decode a binhex file *input*. *input* may be a filename or a file-like object 31 supporting :meth:`read` and :meth:`close` methods. The resulting file is written 32 to a file named *output*, unless the argument is omitted in which case the 33 output filename is read from the binhex file. 34 35The following exception is also defined: 36 37 38.. exception:: Error 39 40 Exception raised when something can't be encoded using the binhex format (for 41 example, a filename is too long to fit in the filename field), or when input is 42 not properly encoded binhex data. 43 44 45.. seealso:: 46 47 Module :mod:`binascii` 48 Support module containing ASCII-to-binary and binary-to-ASCII conversions. 49 50 51.. _binhex-notes: 52 53Notes 54----- 55 56There is an alternative, more powerful interface to the coder and decoder, see 57the source for details. 58 59If you code or decode textfiles on non-Macintosh platforms they will still use 60the old Macintosh newline convention (carriage-return as end of line). 61 62As of this writing, :func:`hexbin` appears to not work in all cases. 63 64