Welcome to documentation!#
Introduction#
This should be updated!
pylibmagic v0.5.0#
A lightweight, minimal python package that ships magic
libraries
using automake, CMake, scikit-build, and cibuildwheel.
Why?#
If you use python-magic, you typically get an error like this
>>> import magic
Traceback (most recent call last):
File "<stdin>", line 1, in <module>
File "/Users/kratsg/.pyenv/versions/venv/lib/python3.7/site-packages/magic/__init__.py", line 209, in <module>
libmagic = loader.load_lib()
File "/Users/kratsg/.pyenv/versions/venv/lib/python3.7/site-packages/magic/loader.py", line 49, in load_lib
raise ImportError('failed to find libmagic. Check your installation')
ImportError: failed to find libmagic. Check your installation
which is frustrating because they don’t ship shared lib with their
python distribution. pylibmagic
helps fill in the missing gap by
shipping the required magic
library and adding it to your path, so
you can just do:
>>> import pylibmagic
>>> import magic
and be on your way. pylibmagic
is designed to be very minimal and
lightweight.
Compiling#
$ docker run -it --rm -v $PWD:/home/root -w /home/root ubuntu
# apt install cmake autoconf automake libtool build-essential git python3-dev python3-pip
# cmake -S . -B build
# cmake --build build
Installing#
$ python3 -m pip install pylibmagic
and the libraries are installed at
$ python -c "import pylibmagic; print(pylibmagic.data)"
Releasing#
To release, due to concurrency issues, we need to push the tag after Cirrus CI finishes with the building for pushing to the main branch. So the order is typically:
tbump 0.5.0 --no-tag-push
# wait until Cirrus CI finishes
git push origin v0.5.0
# wait until Cirrus CI finishes
gh release create
See [cirruslabs/cirrus-ci-docs#1167](cirruslabs/cirrus-ci-docs#1167) for more details.