Skip to main content

File type identification using libmagic

Project description

magicfile (A CFFI fork of python-magic)

PyPI version

magicfile is a python interface to the libmagic file type identification library. libmagic identifies file types by checking their headers according to a predefined list of file types. This functionality is exposed to the command line by the Unix command file.

Usage

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

There is also a Magic class that provides more direct control, including overriding the magic database file and turning on character encoding detection. This is not recommended for general use. In particular, it's not safe for sharing across multiple threads and will fail throw if this is attempted.

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

You can also combine the flag options:

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

Versioning

Minor version bumps should be backwards compatible. Major bumps are not.

Name Conflict

There are, sadly, two libraries which use the module name magic. Both have been around for quite a while.If you are using this module and get an error using a method like open, your code is expecting the other one. Hopefully one day these will be reconciled.

Installation

The current stable version of magicfile is available on pypi and can be installed by running pip install magicfile.

Other sources:

Troubleshooting

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

Author

Written by Adam Hupp in 2001 for a project that never got off the ground. It originally used SWIG for the C library bindings, but switched to ctypes once that was part of the python standard library.

You can contact me via my website or github.

Contributors

Thanks to these folks on github who submitted features and bugfixes.

License

magicfile is distributed under the MIT license. See the included LICENSE file for details.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for magicfile, version 0.4.21
Filename, size File type Python version Upload date Hashes
Filename, size magicfile-0.4.21-cp34-cp34m-manylinux1_x86_64.whl (503.1 kB) File type Wheel Python version cp34 Upload date Hashes View hashes
Filename, size magicfile-0.4.21-cp35-cp35m-manylinux1_x86_64.whl (503.1 kB) File type Wheel Python version cp35 Upload date Hashes View hashes
Filename, size magicfile-0.4.21-cp36-cp36m-macosx_10_11_x86_64.whl (340.6 kB) File type Wheel Python version cp36 Upload date Hashes View hashes
Filename, size magicfile-0.4.21-cp36-cp36m-manylinux1_x86_64.whl (503.1 kB) File type Wheel Python version cp36 Upload date Hashes View hashes
Filename, size magicfile-0.4.21-cp37-cp37m-macosx_10_11_x86_64.whl (340.6 kB) File type Wheel Python version cp37 Upload date Hashes View hashes
Filename, size magicfile-0.4.21-cp37-cp37m-manylinux1_x86_64.whl (503.1 kB) File type Wheel Python version cp37 Upload date Hashes View hashes
Filename, size magicfile-0.4.21-cp38-cp38-macosx_10_15_x86_64.whl (341.5 kB) File type Wheel Python version cp38 Upload date Hashes View hashes
Filename, size magicfile-0.4.21-cp38-cp38-manylinux1_x86_64.whl (503.4 kB) File type Wheel Python version cp38 Upload date Hashes View hashes
Filename, size magicfile-0.4.21.tar.gz (256.0 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page