summaryrefslogtreecommitdiffstats
path: root/Doc/library
diff options
context:
space:
mode:
authorVictor Stinner <vstinner@python.org>2021-09-02 10:10:08 (GMT)
committerGitHub <noreply@github.com>2021-09-02 10:10:08 (GMT)
commita8066087054417885db0a2dbdce2ddb2ac498247 (patch)
tree9715670a690514e50d8439085787181157a56ef0 /Doc/library
parentd589a7e7eb56196c05337d37417479375878b127 (diff)
downloadcpython-a8066087054417885db0a2dbdce2ddb2ac498247.zip
cpython-a8066087054417885db0a2dbdce2ddb2ac498247.tar.gz
cpython-a8066087054417885db0a2dbdce2ddb2ac498247.tar.bz2
bpo-45085: Remove the binhex module (GH-28117)
The binhex module, deprecated in Python 3.9, is now removed. The following binascii functions, deprecated in Python 3.9, are now also removed: * a2b_hqx(), b2a_hqx(); * rlecode_hqx(), rledecode_hqx(). The binascii.crc_hqx() function remains available.
Diffstat (limited to 'Doc/library')
-rw-r--r--Doc/library/binascii.rst47
-rw-r--r--Doc/library/binhex.rst59
-rw-r--r--Doc/library/netdata.rst1
3 files changed, 2 insertions, 105 deletions
diff --git a/Doc/library/binascii.rst b/Doc/library/binascii.rst
index fd5df69..62d7efe 100644
--- a/Doc/library/binascii.rst
+++ b/Doc/library/binascii.rst
@@ -8,14 +8,13 @@
.. index::
module: uu
module: base64
- module: binhex
--------------
The :mod:`binascii` module contains a number of methods to convert between
binary and various ASCII-encoded binary representations. Normally, you will not
-use these functions directly but use wrapper modules like :mod:`uu`,
-:mod:`base64`, or :mod:`binhex` instead. The :mod:`binascii` module contains
+use these functions directly but use wrapper modules like :mod:`uu` or
+:mod:`base64` instead. The :mod:`binascii` module contains
low-level functions written in C for greater speed that are used by the
higher-level modules.
@@ -98,45 +97,6 @@ The :mod:`binascii` module defines the following functions:
stream.
-.. function:: a2b_hqx(string)
-
- Convert binhex4 formatted ASCII data to binary, without doing RLE-decompression.
- The string should contain a complete number of binary bytes, or (in case of the
- last portion of the binhex4 data) have the remaining bits zero.
-
- .. deprecated:: 3.9
-
-
-.. function:: rledecode_hqx(data)
-
- Perform RLE-decompression on the data, as per the binhex4 standard. The
- algorithm uses ``0x90`` after a byte as a repeat indicator, followed by a count.
- A count of ``0`` specifies a byte value of ``0x90``. The routine returns the
- decompressed data, unless data input data ends in an orphaned repeat indicator,
- in which case the :exc:`Incomplete` exception is raised.
-
- .. versionchanged:: 3.2
- Accept only bytestring or bytearray objects as input.
-
- .. deprecated:: 3.9
-
-
-.. function:: rlecode_hqx(data)
-
- Perform binhex4 style RLE-compression on *data* and return the result.
-
- .. deprecated:: 3.9
-
-
-.. function:: b2a_hqx(data)
-
- Perform hexbin4 binary-to-ASCII translation and return the resulting string. The
- argument should already be RLE-coded, and have a length divisible by 3 (except
- possibly the last fragment).
-
- .. deprecated:: 3.9
-
-
.. function:: crc_hqx(data, value)
Compute a 16-bit CRC value of *data*, starting with *value* as the
@@ -222,9 +182,6 @@ The :mod:`binascii` module defines the following functions:
Support for RFC compliant base64-style encoding in base 16, 32, 64,
and 85.
- Module :mod:`binhex`
- Support for the binhex format used on the Macintosh.
-
Module :mod:`uu`
Support for UU encoding used on Unix.
diff --git a/Doc/library/binhex.rst b/Doc/library/binhex.rst
deleted file mode 100644
index 7de6a66..0000000
--- a/Doc/library/binhex.rst
+++ /dev/null
@@ -1,59 +0,0 @@
-:mod:`binhex` --- Encode and decode binhex4 files
-=================================================
-
-.. module:: binhex
- :synopsis: Encode and decode files in binhex4 format.
-
-**Source code:** :source:`Lib/binhex.py`
-
-.. deprecated:: 3.9
-
---------------
-
-This module encodes and decodes files in binhex4 format, a format allowing
-representation of Macintosh files in ASCII. Only the data fork is handled.
-
-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 ``None`` 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).
-
diff --git a/Doc/library/netdata.rst b/Doc/library/netdata.rst
index e76280f..16f43a6 100644
--- a/Doc/library/netdata.rst
+++ b/Doc/library/netdata.rst
@@ -17,7 +17,6 @@ on the internet.
mailbox.rst
mimetypes.rst
base64.rst
- binhex.rst
binascii.rst
quopri.rst
uu.rst