Meta

• License: MIT License (MIT)
• Author:Adam Hupp
• Tags mime, magic, file
• Requires: Python >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*, !=3.4.*

Classifiers

• Intended Audience
  • Developers
• License
  • OSI Approved :: MIT License
• Programming Language
  • Python
  • Python :: 2.7
  • Python :: 3
  • Python :: 3.5
  • Python :: 3.6
  • Python :: 3.7
  • Python :: 3.8
  • Python :: 3.9
  • Python :: Implementation :: CPython

python-magic

python-magic is a Python interface to the libmagic file typeidentification library. libmagic identifies file types by checkingtheir headers according to a predefined list of file types. Thisfunctionality is exposed to the command line by the Unix commandfile.

Usage

>>>importmagic>>>magic.from_file("testdata/test.pdf")'PDF document, version 1.2'# recommend using at least the first 2048 bytes, as less can produce incorrect identification>>>magic.from_buffer(open("testdata/test.pdf","rb").read(2048))'PDF document, version 1.2'>>>magic.from_file("testdata/test.pdf",mime=True)'application/pdf'

There is also aMagic class that provides more direct control,including overriding the magic database file and turning on characterencoding detection. This is not recommended for general use. Inparticular, it's not safe for sharing across multiple threads andwill 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 2821:32:522008,fromUnix)'

You can also combine the flag options:

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

Installation

The current stable version of python-magic is available on PyPI andcan be installed by runningpip install python-magic.

Other sources:

• PyPI:http://pypi.python.org/pypi/python-magic/
• GitHub:https://github.com/ahupp/python-magic

This module is a simple wrapper around the libmagic C library, andthat must be installed as well:

Debian/Ubuntu

sudo apt-get install libmagic1

Windows

You'll need DLLs for libmagic. @julian-r maintains a pypi package with the DLLs, you can fetch it with:

pip install python-magic-bin

OSX

• When using Homebrew:brew install libmagic
• When using macports:port install file

Troubleshooting

• 'MagicException: could not find any magic files!': someinstallations of libmagic do not correctly point to their magicdatabase file. Try specifying the path to the file explicitly in theconstructor: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 ofpython will fail with this error. Here are 64-bit builds of libmagic for windows:https://github.com/pidydx/libmagicwin64.Newer version can be found here:https://github.com/nscaife/file-windows.

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

Bug Reports

python-magic is a thin layer over the libmagic C library.Historically, most bugs that have been reported against python-magicare actually bugs in libmagic; libmagic bugs can be reported on theirtracker here:https://bugs.astron.com/my_view_page.php. If you're notsure where the bug lies feel free to file an issue on GitHub and I cantriage it.

Running the tests

To run the tests across a variety of linux distributions (depends on Docker):

./test_docker.sh

To run tests locally across all available python versions:

./test/run.py

To run against a specific python version:

LC_ALL=en_US.UTF-8 python3 test/test.py

libmagic python API compatibility

The python bindings shipped with libmagic use a module name that conflicts with this package. To work around this, python-magic includes a compatibility layer for the libmagic API. SeeCOMPAT.md for a guide to libmagic / python-magic compatibility.

Versioning

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

Author

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

You can contact me via mywebsite orGitHub.

License

python-magic is distributed under the MIT license. See the includedLICENSE file for details.

I am providing code in the repository to you under an open source license. Because this is my personal repository, the license you receive to my code is from me and not my employer (Facebook).

Verified details

Maintainers

ahupp

Unverified details

Project links

• Homepage

• Download URL:python-magic-0.4.27.tar.gz
• Upload date: Jun 7, 2022
• Size: 14.7 kB
• Tags: Source
• Uploaded using Trusted Publishing? No
• Uploaded via: twine/3.8.0 colorama/0.4.4 importlib-metadata/4.6.4 keyring/23.5.0 pkginfo/1.8.2 readme-renderer/34.0 requests-toolbelt/0.9.1 requests/2.25.1 rfc3986/1.5.0 tqdm/4.57.0 urllib3/1.26.5 CPython/3.10.4

See more details on using hashes here.

• Download URL:python_magic-0.4.27-py2.py3-none-any.whl
• Upload date: Jun 7, 2022
• Size: 13.8 kB
• Tags: Python 2, Python 3
• Uploaded using Trusted Publishing? No
• Uploaded via: twine/3.8.0 colorama/0.4.4 importlib-metadata/4.6.4 keyring/23.5.0 pkginfo/1.8.2 readme-renderer/34.0 requests-toolbelt/0.9.1 requests/2.25.1 rfc3986/1.5.0 tqdm/4.57.0 urllib3/1.26.5 CPython/3.10.4

See more details on using hashes here.