简介
python-magic 是一个基于libmagic 库的Python 封装的文件类型识别库。 libmagic 是一个强大的文件类型识别工具，可以分析文件内容以确定文件的MIME 类型。 python-magic 允许您在Python 脚本中轻松调用此函数。这对于文件处理、上传和下载的文件类型检查或在自动化脚本中使用非常有用。
特点
易于使用：python-magic提供了一个简单的API，可以通过简单的函数调用来获取文件的MIME类型。识别率高：python-magic封装了libmagic文件类型识别库，识别率很高。
工作原理
python-magic 封装了libmagic 文件类型识别库。 libmagic 是一个文件类型识别库，它通过检查文件的幻数来确定文件的类型。幻数是文件开头的特定字节，不同类型的文件有不同的幻数。 libmagic 库包含一个文件类型数据库，用于存储各种文件类型的幻数信息。当调用python-magic 库时，它会读取目标文件的前几个字节，并根据libmagic 库中的文件类型数据库进行检查，以确定文件的类型。
安装
在开始使用python-magic 之前，必须先安装它。 python-magic 可以通过pip 安装。在命令行中运行以下命令：
代码语言：javascript 复制pip install python-magic 如果您使用的是Windows 系统，还必须安装Windows 版本的libmagic。下载后，将libmagic安装目录添加到系统的PATH环境变量中。
在macOS 上，您还可以使用Homebrew 安装libmagic。
代码语言： javascript copy brew install libmagic
如何使用
基本用法
使用python-magic 识别文件类型非常容易。首先，我们需要导入magic 模块。接下来，创建一个magic.Magic 对象。最后，调用对象的from_file() 方法并向其传递识别的文件路径以获取文件类型。
代码语言：JavaScript复制导入魔法
#创造魔法物品
m=magic.magic()
#识别文件类型
文件路径=\’example.txt\’
文件类型=m.from_file(文件路径)
print(file_type) # 输出：ASCII 文本
其他示例
python-magic 还可以在各种场景中使用。让我们看看下面的一些其他例子。
检查未知文件
代码语言：javascript copy file_path=\’unknown_file.bin\’
mime_type=m.from_file(文件路径)
print(f\’这个未知文件的类型是{mime_type}\’)
检查远程文件
如果您有URL，您还可以检查远程文件的类型。
代码语言：JavaScript 复制URL=\’http://example.com/file.zip\’
mime_type=m.from_url(url)
print(f\'{url} 远程文件类型为{mime_type}\’)
识别图片类型
代码语言：javascript copy import magic
m=magic.magic(mime=True)
文件路径=\’example.jpg\’
文件类型=m.from_file(文件路径)
print(file_type) # 输出：image/jpeg
识别多个文件类型
代码语言：javascript copy import magic
m=magic.magic()
file_paths=[\’example.txt\’, \’example.jpg\’, \’example.mp3\’]
关于file_paths:中的file_path
文件类型=m.from_file(文件路径)
print(f\'{file_path}: {file_type}\’)
高级用法
自定义文件类型数据库
python-magic 还提供了高级用法，例如自定义文件类型数据库、设置文件类型识别深度等。以下是自定义文件类型数据库的示例。
代码语言：JavaScript复制导入魔法
#创建一个魔法对象并指定自定义文件类型数据库
m=magic.Magic(magic_file=\’path/to/magic.mgc\’)
#识别文件类型
文件路径=\’example.txt\’
文件类型=m.from_file(文件路径)
print(file_type) # 输出：ASCII 文本在某些情况下，您可能需要识别一些特殊的文件类型，但这些文件类型并未在python-magic 的默认文件类型数据库中定义。此时，您可以自定义文件类型数据库。自定义文件类型数据库是一个文本文件，其中每一行定义一个文件类型。每行的格式为：
代码语言：javascript copy 0 string magic_string magic_description 这行代码是magic文件格式的一部分，用于定义识别文件类型的规则。在魔术文件中，每一行都定义了标识特定文件类型的规则。各部分的含义如下。
0：表示从文件开头（偏移量0）开始。 string：表示要检查的数据是字符串类型。 magic_string：是要搜索的特定字符串，是识别文件类型的关键的幻数。 magic_description：如果文件包含magic_string，magic库将返回此描述，指示文件的类型。例如，对于ZIP 文件识别规则，魔术文件可能包含如下行：
代码语言：javascript Copy 0 string PK\\003\\004 Zip Archive Data 这样你就可以定义一个简单的文件类型数据库custom.magic。这意味着如果文件以字符串PK\\003\\004 开头，则magic 库会将该文件识别为ZIP 存档文件并返回描述性Zip 存档数据。
然后，您可以使用此自定义文件类型数据库来创建magic.Magic 对象。
代码语言：JavaScript复制导入魔法
m=magic.Magic(magic_file=\’custom.magic\’)
文件路径=\’example.zip\’
文件类型=m.from_file(文件路径)
print(file_type) # 输出：ZIP 存档数据
设置文件类型识别的深度
有时您可能需要仅识别文件的开头而不读取整个文件。此时可以设置文件类型识别的深度。
代码语言：JavaScript复制导入魔法
#创建一个魔法对象，并将文件类型识别深度设置为1024字节
m=magic.magic(buffer_size=1024)
文件路径=\’example.txt\’
文件类型=m.from_file(文件路径)
print(file_type) # 输出：ASCII 文本您可以通过设置buffer_size 参数来控制python-magic 读取的文件的字节大小。这提高了文件类型识别速度，尤其是在处理大文件时。
总结
python-magic 是一个功能强大的Python 库，可让您轻松识别文件类型。它易于安装和使用，并提供丰富的API 进行高级定制。无论是需要快速识别文件类型还是需要对不同文件类型进行详细处理，python-magic都是不错的选择。
附录
常见问题解答
Q：我在Windows上安装python-magic时遇到了问题，怎么办？A：确保您安装了Windows 版本的libmagic，并且libmagic 安装目录已添加到系统的PATH 环境变量中。
Q：python-magic可以识别所有的文件类型吗？A：python-magic 可以识别大多数常见的文件类型，但不是所有文件类型。如果遇到无法识别的文件类型，请尝试更新libmagic 的文件类型数据库或自定义文件类型数据库。
Q：如何更新libmagic的文件类型数据库？A：您可以从这里下载最新的libmagic源码，根据官方文档编译并安装。这会更新文件类型数据库。
参考文献
python-magic 官方文档：https://github.com/ahupp/python-magic
原创文章，作者：网络小小，如若转载，请注明出处：https://www.sudun.com/ask/50286.html
