Installation

Dependencies

In order to build and run pyfuse3 you need the following software:

  • Linux kernel 3.9 or newer.
  • Version 3.3.0 or newer of the libfuse library, including development headers (typically distributions provide them in a libfuse3-devel or libfuse3-dev package).
  • Python 3.5 or newer installed with development headers
  • The Trio Python module, version 0.7 or newer.
  • The setuptools Python module, version 1.0 or newer.
  • the pkg-config tool
  • the attr library
  • A C compiler (only for building)

To run the unit tests, you will need

  • The py.test Python module, version 3.3.0 or newer

Stable releases

To install a stable pyfuse3 release:

  1. Download and unpack the release tarball from https://pypi.python.org/pypi/pyfuse3/
  2. Run python3 setup.py build_ext --inplace to build the C extension
  3. Run python3 -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.
  4. To install system-wide for all users, run sudo python setup.py install. To install into ~/.local, run python3 setup.py install --user.

Development Version

If you have checked out the unstable development version, a bit more effort is required. You need to also have Cython (0.28.1 or newer) and Sphinx (1.1 or newer) installed, and the necessary commands are:

python3 setup.py build_cython
python3 setup.py build_ext --inplace
python3 -m pytest test/
python3 setup.py build_sphinx
python3 setup.py install