mimetypes モジュールは、ファイル名あるいは URL と、ファイル名拡張子に 関連付けられた MIME 型とを変換します。ファイル名から MIME 型へと、 MIME 型からファイル名拡張子への変換が提供されます; 後者の変換では符号化方式はサポートされていません。
このモジュールは、一つのクラスと多くの便利な関数を提供します。 これらの関数がこのモジュールへの標準のインターフェースですが、 アプリケーションによっては、そのクラスにも関係するかもしれません。
以下で説明されている関数は、このモジュールへの主要なインターフェースを 提供します。たとえモジュールが初期化されていなくても、もしこれらの関数が、 init() がセットアップする情報に依存していれば、これらの関数は、 init() を呼びます。
filename[, strict]) |
(type,
encoding)
です、ここで typeは、
もし型が(拡張子がないあるいは未定義のため)推定できない場合は、
None
を、あるいは、
MIME content-type: ヘッダ に利用できる、'type/subtype'
の形の文字列です。
encoding は、符合化方式がない場合は None
を、あるいは、
符号化に使われるプログラムの名前
(たとえば、compress あるいは gzip)です。
符号化方式は Content-Encoding:ヘッダとして
使うのに適しており、
Content-Transfer-Encoding: ヘッダには適していません。
マッピングはテーブルドリブンです。符号化方式のサフィックスは大/小文字を区別します;
データ型サフィックスは、最初大/小文字を区別して試し、
それから大/小文字を区別せずに試します。
省略可能な strictは、既知の MIME 型のリストとして認識されるものが、 IANAとして登録された 正式な型のみに限定されるかどうかを指定するフラグです。 strict が true (デフォール)の時は、IANA 型のみがサポートされます; strict が false のときは、いくつかの追加の、非標準ではあるが、一般的に 使用される MIME 型も認識されます。
type[, strict]) |
省略可能な strict は guess_type() 関数のものと同じ意味を持ちます。
type[, strict]) |
None
が返されます。
省略可能な strict は guess_type() 関数のものと同じ意味を持ちます。
モジュールの動作を制御するために、いくつかの追加の関数とデータ項目が 利用できます。
[files]) |
filename) |
'type/subtype'
の形の文字列にマッピングする辞書として返されます。
もしファイル filename が存在しないか、読み込めなければ、
None
が返されます。
type, ext[, strict]) |
strictがある時は、そのマッピングは正式なMIME型に、 そうでなければ、非標準のMIME型に追加されます。
MimeTypes クラスは、1つ以上のMIME-型 データベースを 必要とするアプリケーションに役に立つでしょう。
[filenames]) |
省略可能な filenamesパラメータは、追加のファイルを、デフォールト データベースの"トップに"ロードさせるのに使うことができます。
バージョン 2.2 で 新たに追加 された仕様です。
モジュールの使用例:
>>> import mimetypes >>> mimetypes.init() >>> mimetypes.knownfiles ['/etc/mime.types', '/etc/httpd/mime.types', ... ] >>> mimetypes.suffix_map['.tgz'] '.tar.gz' >>> mimetypes.encodings_map['.gz'] 'gzip' >>> mimetypes.types_map['.tgz'] 'application/x-tar-gz'