Installation¶
Dependencies¶
In order to build and run Python-LLFUSE you need the following software:
Linux, FreeBSD, NetBSD or MacOS X system
Python 2.6 or newer (including Python 3.x), installed with development headers
The setuptools Python module, version 1.0 or newer.
When running under Python 2.x, the contextlib2 Python module from PyPi.
the pkg-config tool
the attr library
A C compiler (only for building)
To run the unit tests, you will need
The py.test module, version 3.3.0 or newer
When using Linux, you also need:
Kernel 2.6.9 or newer. Starting with kernel 2.6.26 you will get significantly better write performance, so under Linux you should actually use 2.6.26 or newer whenever possible.
Version 2.9.0 or newer of the FUSE library, including development headers (typically distributions provide them in a libfuse-devel or libfuse-dev package).
In case of FreeBSD and NetBSD you will need:
The FUSE4BSD kernel module.
For OS-X, you need:
the OSXFUSE package.
Stable releases¶
To install a stable Python-LLFUSE release:
Download and unpack the release tarball from https://pypi.python.org/pypi/llfuse/
Run
python setup.py build_ext --inplace
to build the C extensionRun
python -m pytest test/
to run a self-test. If this fails, ask for help on the FUSE mailing list or report a bug in the issue tracker.To install system-wide for all users, run
sudo python setup.py install
. To install into~/.local
, runpython setup.py install --user
.
Development Version¶
If you have checked out the unstable development version from the repository, a bit more effort is required. You need to also have Cython (0.29.21 or newer) and Sphinx (1.1 or newer) installed, and the necessary commands are:
python setup.py build_cython
python setup.py build_ext --inplace
python -m pytest test/
sphinx-build -b html rst doc/html
python setup.py install