18.8. MimeWriter —汎用MIMEファイルライター—Pythonドキュメント

18.8。 MimeWriter —汎用MIMEファイルライター

バージョン2.3以降非推奨： email パッケージを MimeWriter モジュールよりも優先して使用する必要があります。 このモジュールは、下位互換性を維持するためにのみ存在します。

このモジュールは、クラス MimeWriter を定義します。 MimeWriter クラスは、MIMEマルチパートファイルを作成するための基本的なフォーマッターを実装します。 出力ファイルを探し回ったり、大量のバッファスペースを使用したりすることはありません。 最終ファイルで発生する順序でパーツを書き出す必要があります。 MimeWriter は、追加したヘッダーをバッファリングするため、ヘッダーの順序を並べ替えることができます。

class MimeWriter.MimeWriter(fp)

MimeWriter クラスの新しいインスタンスを返します。 渡される唯一の引数 fp は、書き込みに使用されるファイルオブジェクトです。 StringIO オブジェクトも使用できることに注意してください。

18.8.1。 MimeWriterオブジェクト

MimeWriter インスタンスには次のメソッドがあります。

MimeWriter.addheader(key, value[, prefix])

MIMEメッセージにヘッダー行を追加します。 key はヘッダーの名前であり、 value は明らかにヘッダーの値を提供します。 オプションの引数 prefix は、ヘッダーが挿入される場所を決定します。 0は最後に追加することを意味し、1は最初に挿入することを意味します。 デフォルトは追加です。

MimeWriter.flushheaders()

これまでに蓄積されたすべてのヘッダーが書き出されます（そして忘れられます）。 これは、体の部分がまったく必要ない場合に便利です。 タイプ message / rfc822 のサブパーツの場合、ヘッダーのような情報を格納するために（誤って）使用されます。

MimeWriter.startbody(ctype[, plist[, prefix]])

メッセージの本文への書き込みに使用できるファイルのようなオブジェクトを返します。 content-typeは、提供された ctype に設定され、オプションのパラメーター plist は、content-type宣言の追加パラメーターを提供します。 prefix は、 addheader（）と同じように機能しますが、デフォルトでは先頭に挿入されます。

MimeWriter.startmultipartbody(subtype[, boundary[, plist[, prefix]]])

メッセージの本文への書き込みに使用できるファイルのようなオブジェクトを返します。 さらに、このメソッドはマルチパートコードを初期化します。ここで、サブタイプはマルチパートサブタイプを提供し、境界はユーザー定義の境界仕様を提供し、 plist はオプションを提供しますサブタイプのパラメーター。 prefix は、 startbody（）と同じように機能します。 サブパーツは、 nextpart（）を使用して作成する必要があります。

MimeWriter.nextpart()

マルチパートメッセージの個々のパートを表す MimeWriter の新しいインスタンスを返します。 これは、パーツを作成するためだけでなく、再帰的に複雑なマルチパートメッセージを作成するためにも使用できます。 nextpart（）を使用する前に、まず startmultipartbody（）でメッセージを初期化する必要があります。

MimeWriter.lastpart()

これは、マルチパートメッセージの最後の部分を指定するために使用され、マルチパートメッセージを書き込む場合は常にを使用する必要があります。