18.6. mimetools — MIMEメッセージを解析するためのツール—Pythonドキュメント
提供:Dev Guides
< PythonPython/docs/2.7/library/mimetools
18.6。 mimetools —MIMEメッセージを解析するためのツール
バージョン2.3以降非推奨: email パッケージを mimetools モジュールよりも優先して使用する必要があります。 このモジュールは、下位互換性を維持するためにのみ存在し、3.xで削除されました。
このモジュールは、 rfc822 モジュールの Message クラスのサブクラスと、MIMEマルチパートまたはエンコードされたメッセージの操作に役立ついくつかのユーティリティ関数を定義します。
次の項目を定義します。
- class mimetools.Message(fp[, seekable])
- Message クラスの新しいインスタンスを返します。 これは rfc822.Message クラスのサブクラスであり、いくつかの追加メソッドがあります(以下を参照)。 seekable 引数は、 rfc822.Message の場合と同じ意味です。
- mimetools.choose_boundary()
- パーツ境界として使用できる可能性が高い一意の文字列を返します。 文字列の形式は
'hostipaddr.uid.pid.timestamp.random'
です。
- mimetools.decode(input, output, encoding)
- オープンファイルオブジェクト入力から許可されたMIME エンコーディングを使用してエンコードされたデータを読み取り、デコードされたデータをオープンファイルオブジェクト出力に書き込みます。 エンコーディングの有効な値には、
'base64'
、'quoted-printable'
、'uuencode'
、'x-uuencode'
、'uue'
、 [ X102X]、'7bit'
、および'8bit'
。'7bit'
または'8bit'
でエンコードされたメッセージをデコードしても効果はありません。 入力は単に出力にコピーされます。
- mimetools.encode(input, output, encoding)
- 開いているファイルオブジェクト入力からデータを読み取り、許可されたMIME エンコーディングを使用してエンコードしてファイルオブジェクト出力を開きます。 encoding の有効な値は、 decode()の場合と同じです。
- mimetools.copyliteral(input, output)
- 開いているファイル入力からEOFまで行を読み取り、開いているファイル出力に書き込みます。
- mimetools.copybinary(input, output)
- 開いているファイル入力からEOFまでブロックを読み取り、開いているファイル出力に書き込みます。 ブロックサイズは現在8192に固定されています。
も参照してください
- モジュールメール
- 包括的な電子メール処理パッケージ。 mimetools モジュールに取って代わります。
- モジュール rfc822
- mimetools.Message の基本クラスを提供します。
- モジュールマルチファイル
- MIMEデータなどの個別の部分を含むファイルの読み取りのサポート。
- http://faqs.cs.uu.nl/na-dir/mail/mime-faq/.html
- MIMEのよくある質問のドキュメント。 MIMEの概要については、このドキュメントのパート1の質問1.1に対する回答を参照してください。
18.6.1。 メッセージオブジェクトの追加メソッド
Message クラスは、 rfc822.Message メソッドに加えて、次のメソッドを定義します。
- Message.getplist()
- Content-Type ヘッダーのパラメーターリストを返します。 これは文字列のリストです。
key=value
の形式のパラメーターの場合、 key は小文字に変換されますが、 value は変換されません。 たとえば、メッセージにヘッダーContent-type: text/html; spam=1; Spam=2; Spam
が含まれている場合、 getplist()はPythonリスト['spam=1', 'spam=2', 'Spam']
を返します。
- Message.getparam(name)
- 指定された名前の
name=value
形式の最初のパラメーター( getplist()によって返される)の値を返します。 value が '<
…>
'または '"
…"
'の形式の引用符で囲まれている場合、これらは削除されます。
- Message.getencoding()
- Content-Transfer-Encoding メッセージヘッダーで指定されたエンコーディングを返します。 そのようなヘッダーが存在しない場合は、
'7bit'
を返します。 エンコーディングは小文字に変換されます。
- Message.gettype()
- Content-Type ヘッダーで指定されているメッセージタイプ(
type/subtype
の形式)を返します。 そのようなヘッダーが存在しない場合は、'text/plain'
を返します。 タイプは小文字に変換されます。
- Message.getmaintype()
- Content-Type ヘッダーで指定されているメインタイプを返します。 そのようなヘッダーが存在しない場合は、
'text'
を返します。 メインタイプは小文字に変換されます。
- Message.getsubtype()
- Content-Type ヘッダーで指定されているサブタイプを返します。 そのようなヘッダーが存在しない場合は、
'plain'
を返します。 サブタイプは小文字に変換されます。