magicfile (python-magic的一个CFFI分支)

magicfile 是一个用于libmagic文件类型识别库的Python接口。libmagic通过检查其头部并根据预定义的文件类型列表来识别文件类型。该功能通过Unix命令 file 在命令行中公开。

用法

>>> import magicfile as magic
>>> magic.from_file("testdata/test.pdf")
'PDF document, version 1.2'
>>> magic.from_buffer(open("testdata/test.pdf").read(1024))
'PDF document, version 1.2'
>>> magic.from_file("testdata/test.pdf", mime=True)
'application/pdf'

还有一个提供更多直接控制的 Magic 类，包括覆盖魔法数据库文件和启用字符编码检测。这不建议一般使用。特别是，它不安全地在多个线程之间共享，并且如果尝试这样做将会失败。

>>> f = magic.Magic(uncompress=True)
>>> f.from_file('testdata/test.gz')
'ASCII text (gzip compressed data, was "test", last modified: Sat Jun 28
21:32:52 2008, from Unix)'

您还可以组合标志选项

>>> f = magic.Magic(mime=True, uncompress=True)
>>> f.from_file('testdata/test.gz')
'text/plain'

版本控制

小版本升级应该是向后兼容的。主要升级则不是。

名称冲突

不幸的是，有两个库使用了模块名称 magic。它们都已经存在很长时间了。如果您使用此模块并且在使用类似 open 的方法时遇到错误，您的代码期望使用另一个。希望有一天这些将被协调。

安装

magicfile 的当前稳定版本可在 PyPI 上找到，可以通过运行 pip install magicfile 进行安装。

其他来源

• pypi: http://pypi.python.org/pypi/magicfile/
• github: https://github.com/messense/magicfile

故障排除

• 'MagicException: could not find any magic files!': some installations of libmagic do not correctly point to their magic database file. Try specifying the path to the file explicitly in the constructor: magic.Magic(magic_file="path_to_magic_file").

• 'WindowsError: [Error 193] %1 is not a valid Win32 application': Attempting to run the 32-bit libmagic DLL in a 64-bit build of python will fail with this error. Here are 64-bit builds of libmagic for windows: https://github.com/pidydx/libmagicwin64

• 'WindowsError: exception: access violation writing 0x00000000 ' This may indicate you are mixing Windows Python and Cygwin Python. Make sure your libmagic and python builds are consistent.

作者

由 Adam Hupp 于 2001 年为从未启动的项目编写。最初使用 SWIG 进行 C 库绑定，但后来改为使用 ctypes，因为那时 ctypes 已成为 Python 标准库的一部分。

您可以通过我的网站或github联系我。

贡献者

感谢以下在 github 上提交特性和错误修复的各位。

• Amit Sethi
• bigben87
• fallgesetz
• FlaPer87
• lukenowak
• NicolasDelaby
• sacha@ssl.co.uk
• SimpleSeb
• tehmaze

许可证

magicfile 采用 MIT 许可证发布。有关详细信息，请参阅包含的 LICENSE 文件。