【Python】binhexモジュールでbinhex4ファイルをエンコード・デコードする方法

Pythonのbinhexモジュールとは

binhexモジュールは、ファイルをbinhex4形式でエンコード・デコードするためのPython標準ライブラリです。binhex4形式は、MacintoshのファイルをASCIIテキストとして表現するために用いられた形式で、バイナリデータをテキストベースで安全に扱えるようにしたものです。なお、このモジュールが処理できるのはデータフォークのみで、リソースフォークは対象外となっています。

binhexモジュールの主な関数

binhexモジュールには、以下の2つの関数が定義されています。

binhex.binhex(input, output)

inputで指定したバイナリファイルをbinhex形式にエンコードし、outputへ書き出します。outputにはファイル名の文字列、またはwrite()メソッドとclose()メソッドを持つファイルライクオブジェクトを指定できます。

binhex.hexbin(input, output)

inputで指定したbinhexファイルをデコードします。inputにはファイル名、またはread()メソッドとclose()メソッドを持つファイルライクオブジェクトを指定可能です。outputにファイル名を渡すとその名前で結果が保存され、Noneを指定した場合はbinhexファイル内に記録された出力ファイル名が自動的に使用されます。

エンコードのサンプルコード

テキストファイル「file.txt」をbinhex4形式の「test.hqx」に変換する例です。

import binhex

infile = 'file.txt'
binhex.binhex(infile, 'test.hqx')

実行後、「test.hqx」には次のようなBinHex 4.0形式のテキストが出力されます。

(This file must be converted with BinHex 4.0)

:#'CTE'8ZG(Kd!&4&@&3rN!3!N!8G!*!%Ql&6D@e`E'8JDA-JBQ9dG'9b)(4SB@i
JBfpYF'aPH-bk!!!:

デコードのサンプルコード

binhex形式の「test.hqx」を元のファイルに戻す例です。デコードにはhexbin()関数を使用します。

import binhex

infile = 'test.hqx'
binhex.hexbin(infile, 'test.txt')

利用時の注意点

binhexモジュールはPython 3.9で非推奨（Deprecated）となり、Python 3.13で標準ライブラリから削除されました。そのため、最新のPython環境ではそのまま利用できません。Macintosh固有のレガシーなフォーマットであり、現在の開発で使われることはほとんどありませんが、過去のアーカイブデータを扱う際などに知っておくと役立ちます。