Georg Brandl | 116aa62 | 2007-08-15 14:28:22 +0000 | [diff] [blame] | 1 | :mod:`binhex` --- Encode and decode binhex4 files |
| 2 | ================================================= |
| 3 | |
| 4 | .. module:: binhex |
| 5 | :synopsis: Encode and decode files in binhex4 format. |
| 6 | |
Terry Jan Reedy | fa089b9 | 2016-06-11 15:02:54 -0400 | [diff] [blame] | 7 | **Source code:** :source:`Lib/binhex.py` |
| 8 | |
| 9 | -------------- |
Georg Brandl | 116aa62 | 2007-08-15 14:28:22 +0000 | [diff] [blame] | 10 | |
| 11 | This module encodes and decodes files in binhex4 format, a format allowing |
Benjamin Peterson | 69a07fb | 2008-05-12 22:25:16 +0000 | [diff] [blame] | 12 | representation of Macintosh files in ASCII. Only the data fork is handled. |
Georg Brandl | 116aa62 | 2007-08-15 14:28:22 +0000 | [diff] [blame] | 13 | |
| 14 | The :mod:`binhex` module defines the following functions: |
| 15 | |
| 16 | |
| 17 | .. function:: binhex(input, output) |
| 18 | |
| 19 | Convert a binary file with filename *input* to binhex file *output*. The |
| 20 | *output* parameter can either be a filename or a file-like object (any object |
| 21 | supporting a :meth:`write` and :meth:`close` method). |
| 22 | |
| 23 | |
Georg Brandl | 0d8f073 | 2009-04-05 22:20:44 +0000 | [diff] [blame] | 24 | .. function:: hexbin(input, output) |
Georg Brandl | 116aa62 | 2007-08-15 14:28:22 +0000 | [diff] [blame] | 25 | |
| 26 | Decode a binhex file *input*. *input* may be a filename or a file-like object |
| 27 | supporting :meth:`read` and :meth:`close` methods. The resulting file is written |
Georg Brandl | 0d8f073 | 2009-04-05 22:20:44 +0000 | [diff] [blame] | 28 | to a file named *output*, unless the argument is ``None`` in which case the |
Georg Brandl | 116aa62 | 2007-08-15 14:28:22 +0000 | [diff] [blame] | 29 | output filename is read from the binhex file. |
| 30 | |
| 31 | The following exception is also defined: |
| 32 | |
| 33 | |
| 34 | .. exception:: Error |
| 35 | |
| 36 | Exception raised when something can't be encoded using the binhex format (for |
| 37 | example, a filename is too long to fit in the filename field), or when input is |
| 38 | not properly encoded binhex data. |
| 39 | |
| 40 | |
| 41 | .. seealso:: |
| 42 | |
| 43 | Module :mod:`binascii` |
| 44 | Support module containing ASCII-to-binary and binary-to-ASCII conversions. |
| 45 | |
| 46 | |
| 47 | .. _binhex-notes: |
| 48 | |
| 49 | Notes |
| 50 | ----- |
| 51 | |
| 52 | There is an alternative, more powerful interface to the coder and decoder, see |
| 53 | the source for details. |
| 54 | |
| 55 | If you code or decode textfiles on non-Macintosh platforms they will still use |
Georg Brandl | c575c90 | 2008-09-13 17:46:05 +0000 | [diff] [blame] | 56 | the old Macintosh newline convention (carriage-return as end of line). |
Georg Brandl | 116aa62 | 2007-08-15 14:28:22 +0000 | [diff] [blame] | 57 | |