mimetypes --- 映射文件名到 MIME 类型¶

源代码: Lib/mimetypes.py

mimetypes 模块可以在文件名或 URL 和关联到文件扩展名的 MIME 类型之间执行转换。 所提供的转换包括从文件名到 MIME 类型和从 MIME 类型到文件扩展名；后一种转换不支持编码格式。

该模块提供了一个类和一些便捷函数。 这些函数是该模块通常的接口，但某些应用程序可能也会希望使用类。

下列函数提供了此模块的主要接口。 如果此模块尚未被初始化，它们将会调用 init()，如果它们依赖于 init() 所设置的信息的话。

mimetypes.guess_type(url, strict=True)¶

根据 url 给出的文件名、路径或 URL 来猜测文件的类型，URL 可以为字符串或 path-like object。

返回值是一个元组 (type, encoding) 其中 type 在无法猜测（后缀不存在或者未知）时为 None，或者为 'type/subtype' 形式的字符串，可以作为 MIME content-type 标头。

encoding 在无编码格式时为 None，或者为程序所用的编码格式 (例如 compress 或 gzip)。 它可以作为 Content-Encoding 标头，但 不可 作为 Content-Transfer-Encoding 标头。 映射是表格驱动的。 编码格式前缀对大小写敏感；类型前缀会先以大小写敏感方式检测再以大小写不敏感方式检测。

可选的 strict 参数是一个旗标，指明要将已知 MIME 类型限制在 IANA 已注册 的官方类型之内。 当 strict 为 True 时（默认值），则仅支持 IANA 类型；当 strict 为 False 时，则还支持某些附加的非标准但常用的 MIME 类型。

在 3.8 版更改: 增加了 path-like object 作为 url 的支持。

mimetypes.guess_all_extensions(type, strict=True)¶

根据由 type 给出的文件 MIME 类型猜测其扩展名。 返回值是由所有可能的文件扩展名组成的字符串列表，包括开头的点号 ('.')。 这些扩展名不保证能关联到任何特定的数据流，但是将会由 guess_type() 映射到 MIME 类型 type。

可选的 strict 参数具有与 guess_type() 函数一致的含义。

mimetypes.guess_extension(type, strict=True)¶

根据由 type 给出的文件 MIME 类型猜测其扩展名。 返回值是一个表示文件扩展名的字符串，包括开头的点号 ('.')。 该扩展名不保证能关联到任何特定的数据流，但是将会由 guess_type() 映射到 MIME 类型 type。 如果不能猜测出 type 的扩展名，则将返回 None。

可选的 strict 参数具有与 guess_type() 函数一致的含义。

有一些附加函数和数据项可被用于控制此模块的行为。

mimetypes.init(files=None)¶

初始化内部数据结构。 files 如果给出则必须是一个文件名序列，它应当被用于协助默认的类型映射。 如果省略则要使用的文件名会从 knownfiles 中获取； 在 Windows 上，将会载入当前注册表设置。 在 files 或 knownfiles 中指定的每个文件名的优先级将高于在它之前的文件名。 init() 允许被重复调用。

为 files 指定一个空列表将防止应用系统默认选项：将只保留来自内置列表的常用值。

如果 files 为 None 则内部数据结构会完全重建为其初始默认值。 这是一个稳定操作并将在多次调用时产生相同的结果。

在 3.2 版更改: 在之前版本中，Windows 注册表设置会被忽略。

mimetypes.read_mime_types(filename)¶

载入在文件 filename 中给定的类型映射，如果文件存在的话。 返回的类型映射会是一个字典，其中的键值对为文件扩展名包括开头的点号 ('.') 与 'type/subtype' 形式的字符串。 如果文件 filename 不存在或无法被读取，则返回 None。

mimetypes.add_type(type, ext, strict=True)¶

添加一个从 MIME 类型 type 到扩展名 ext 的映射。 当扩展名已知时，新类型将替代旧类型。 当类型已知时，扩展名将被添加到已知扩展名列表。

当 strict 为 True 时（默认值），映射将被添加到官方 MIME 类型，否则添加到非标准类型。

mimetypes.inited¶

指明全局数据结构是否已被初始化的旗标。 这会由 init() 设为 True。

mimetypes.knownfiles¶

通常安装的类型映射文件名列表。 这些文件一般被命名为 mime.types 并会由不同的包安装在不同的位置。

mimetypes.suffix_map¶

将后缀映射到其他后缀的字典。 它被用来允许识别已编码的文件，其编码格式和类型是由相同的扩展名来指明的。 例如，.tgz 扩展名被映射到 .tar.gz 以允许编码格式和类型被分别识别。

mimetypes.encodings_map¶

映射文件扩展名到编码格式类型的字典。

mimetypes.types_map¶

映射文件扩展名到 MIME 类型的字典。

mimetypes.common_types¶

映射文件扩展名到非标准但常见的 MIME 类型的字典。

此模块一个使用示例:

>>> 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'