- python-magic
- Usage
- Debian/Ubuntu
- Windows
- OSX
- Troubleshooting
- Bug Reports
- Running the tests
- libmagic python API compatibility
- Versioning
- Author
- License
- Saved searches
- Use saved searches to filter your results more quickly
- License
- ahupp/python-magic
- Name already in use
- Sign In Required
- Launching GitHub Desktop
- Launching GitHub Desktop
- Launching Xcode
- Launching Visual Studio Code
- Latest commit
- Git stats
- Files
- README.md
- About
- python-magic
- Usage
- Installation
- Debian/Ubuntu
- Windows
- OSX
- Troubleshooting
- Bug Reports
- Running the tests
- libmagic python API compatibility
- Versioning
- Author
- License
python-magic
python-magic 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
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.
You can also combine the flag options:
The current stable version of python-magic is available on PyPI and can be installed by running pip install python-magic .
This module is a simple wrapper around the libmagic C library, and that 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
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. Newer version can be found here: https://github.com/nscaife/file-windows.
- ‘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.
Bug Reports
python-magic is a thin layer over the libmagic C library. Historically, most bugs that have been reported against python-magic are actually bugs in libmagic; libmagic bugs can be reported on their tracker here: https://bugs.astron.com/my_view_page.php. If you’re not sure where the bug lies feel free to file an issue on GitHub and I can triage it.
Running the tests
To run the tests across a variety of linux distributions (depends on Docker):
To run tests locally across all available python versions:
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. See COMPAT.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 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.
License
python-magic is distributed under the MIT license. See the included LICENSE 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).
Saved searches
Use saved searches to filter your results more quickly
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session. You switched accounts on another tab or window. Reload to refresh your session.
A python wrapper for libmagic
License
ahupp/python-magic
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Name already in use
A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Sign In Required
Please sign in to use Codespaces.
Launching GitHub Desktop
If nothing happens, download GitHub Desktop and try again.
Launching GitHub Desktop
If nothing happens, download GitHub Desktop and try again.
Launching Xcode
If nothing happens, download Xcode and try again.
Launching Visual Studio Code
Your codespace will open once ready.
There was a problem preparing your codespace, please try again.
Latest commit
Git stats
Files
Failed to load latest commit information.
README.md
python-magic 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 .
>>> import magic >>> 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 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'
The current stable version of python-magic is available on PyPI and can be installed by running pip install python-magic .
This module is a simple wrapper around the libmagic C library, and that must be installed as well:
sudo apt-get install libmagic1
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
- ‘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. Newer version can be found here: https://github.com/nscaife/file-windows.
- ‘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.
python-magic is a thin layer over the libmagic C library. Historically, most bugs that have been reported against python-magic are actually bugs in libmagic; libmagic bugs can be reported on their tracker here: https://bugs.astron.com/my_view_page.php. If you’re not sure where the bug lies feel free to file an issue on GitHub and I can triage it.
We use the tox test runner which can be installed with python -m pip install tox .
To run tests locally across all available python versions:
Or to run just against a single version:
To run the tests across a variety of linux distributions (depends on Docker):
./test/run_all_docker_test.sh
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. See COMPAT.md for a guide to libmagic / python-magic compatibility.
Minor version bumps should be backwards compatible. Major bumps are not.
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.
python-magic is distributed under the MIT license. See the included LICENSE 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).
About
A python wrapper for libmagic
python-magic
python-magic 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 magic >>> 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 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'
Installation
The current stable version of python-magic is available on PyPI and can be installed by running pip install python-magic .
This module is a simple wrapper around the libmagic C library, and that 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
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. Newer version can be found here: https://github.com/nscaife/file-windows.
- ‘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.
Bug Reports
python-magic is a thin layer over the libmagic C library. Historically, most bugs that have been reported against python-magic are actually bugs in libmagic; libmagic bugs can be reported on their tracker here: https://bugs.astron.com/my_view_page.php. If you’re not sure where the bug lies feel free to file an issue on GitHub and I can triage it.
Running the tests
We use the tox test runner which can be installed with python -m pip install tox .
To run tests locally across all available python versions:
Or to run just against a single version:
To run the tests across a variety of linux distributions (depends on Docker):
./test/run_all_docker_test.sh
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. See COMPAT.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 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.
License
python-magic is distributed under the MIT license. See the included LICENSE 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).