Skip to main content

Simple cross-plattform ctypes bindings for libfuse / FUSE for macOS / WinFsp

Project description

license status pypi_version pypi_versions



refuse is a Python module implemented using ctypes that provides a simple cross-platform interface to:

refuse originated as a fork of fusepy. This fork will break with its origins in (at least) the following aspects:

  • [x] Dropping Python 2 support
  • [ ] Dropping the monolithic single-file-design
  • [ ] Adding libfuse3 support
  • [ ] Marking libfuse2 support as deprecated
  • [ ] A test suite

If you have a pending pull request against fusepy that you would like to see included into refuse please open an issue here.

If you want to contribute to refuse, please have a look at the contributing guidelines.

Project status


The high level API has been tested through LoggedFS-python with pjdfstest and fsx on x86_64 Linux only, but not in all possible modes of operation. The low level API is completely untested at this point.


refuse requires libfuse 2.8 or 2.9 (highly recommended), FUSE for macOS or WinFsp. The master branch of its git repository is always kept at the latest preview release. It should be "sort of stable" (still ALPHA). Development happens in the develop branch.

You can install the preview releases from PyPI:

pip install refuse

You can alternatively also install the current HEAD, most likely very unstable:

pip install git+

refuse (theoretically) runs on:

Porting a project from fusepy to refuse

See documentation.


Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for refuse, version 0.0.4
Filename, size File type Python version Upload date Hashes
Filename, size refuse-0.0.4-py3-none-any.whl (24.5 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size refuse-0.0.4.tar.gz (22.2 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page