mirror of
https://github.com/python/cpython.git
synced 2025-08-18 07:41:05 +00:00
3885314b11
svn+ssh://pythondev@svn.python.org/python/trunk ........ r72007 | georg.brandl | 2009-04-27 17:09:25 +0200 (Mo, 27 Apr 2009) | 1 line #5856: fix typo s in traceback example. ........ r72008 | georg.brandl | 2009-04-27 17:10:44 +0200 (Mo, 27 Apr 2009) | 1 line Remove ".. warning::" markup that doesnt contain warnings for users, rather todo items. ........ r72009 | georg.brandl | 2009-04-27 17:29:09 +0200 (Mo, 27 Apr 2009) | 3 lines Demote warnings to notices where appropriate, following the goal that as few "red box" warnings should clutter the docs as possible. Part 1: stuff that gets merged to Py3k. ........ r72010 | georg.brandl | 2009-04-27 17:29:26 +0200 (Mo, 27 Apr 2009) | 2 lines Demote warnings to notices, part 2: stuff that is 2.x-only. ........ r72036 | georg.brandl | 2009-04-27 19:04:23 +0200 (Mo, 27 Apr 2009) | 1 line #5848: small unittest doc patch. ........ r72037 | georg.brandl | 2009-04-27 19:09:53 +0200 (Mo, 27 Apr 2009) | 1 line #5840: dont claim we dont support TLS. ........
63 lines
1.9 KiB
ReStructuredText
63 lines
1.9 KiB
ReStructuredText
:mod:`binhex` --- Encode and decode binhex4 files
|
|
=================================================
|
|
|
|
.. module:: binhex
|
|
:synopsis: Encode and decode files in binhex4 format.
|
|
|
|
|
|
This module encodes and decodes files in binhex4 format, a format allowing
|
|
representation of Macintosh files in ASCII. On the Macintosh, both forks of a
|
|
file and the finder information are encoded (or decoded), on other platforms
|
|
only the data fork is handled.
|
|
|
|
.. note::
|
|
|
|
In Python 3.x, special Macintosh support has been removed.
|
|
|
|
|
|
The :mod:`binhex` module defines the following functions:
|
|
|
|
|
|
.. function:: binhex(input, output)
|
|
|
|
Convert a binary file with filename *input* to binhex file *output*. The
|
|
*output* parameter can either be a filename or a file-like object (any object
|
|
supporting a :meth:`write` and :meth:`close` method).
|
|
|
|
|
|
.. function:: hexbin(input[, output])
|
|
|
|
Decode a binhex file *input*. *input* may be a filename or a file-like object
|
|
supporting :meth:`read` and :meth:`close` methods. The resulting file is written
|
|
to a file named *output*, unless the argument is omitted in which case the
|
|
output filename is read from the binhex file.
|
|
|
|
The following exception is also defined:
|
|
|
|
|
|
.. exception:: Error
|
|
|
|
Exception raised when something can't be encoded using the binhex format (for
|
|
example, a filename is too long to fit in the filename field), or when input is
|
|
not properly encoded binhex data.
|
|
|
|
|
|
.. seealso::
|
|
|
|
Module :mod:`binascii`
|
|
Support module containing ASCII-to-binary and binary-to-ASCII conversions.
|
|
|
|
|
|
.. _binhex-notes:
|
|
|
|
Notes
|
|
-----
|
|
|
|
There is an alternative, more powerful interface to the coder and decoder, see
|
|
the source for details.
|
|
|
|
If you code or decode textfiles on non-Macintosh platforms they will still use
|
|
the old Macintosh newline convention (carriage-return as end of line).
|
|
|
|
As of this writing, :func:`hexbin` appears to not work in all cases.
|
|
|