mfusepy 0.0.1

Ctypes bindings for the high-level API in libfuse 2 and 3

mfusepy

Installation

pip install mfusepy

About this fork

This is a fork of fusepy because it did not see any development for over 6 years. Refuse was an attempt to fork fusepy, but it has not seen any development for over 4 years. Among lots of metadata changes, it contains two bugfixes to the high-level API, which I have redone in this fork. See also the discussion in this issue. I intend to maintain this fork as long as I maintain ratarmount, which is now over 5 years old.

The main motivations for forking are:

• FUSE 3 support. Based on the libfuse changelog, the amount of breaking changes should be fairly small. It should be possible to simply update these ten or so changed structs and functions in the existing fusepy.
• Translation layer performance. In benchmarks for a simple find call for listing all files, some callbacks such as readdir turned out to be significantly limited by converting Python dictionaries to ctype structs. The idea would be to expose the ctype structs to the fusepy caller.
  • Much of the performance was lost trying to populate the stat struct even though only the mode member is used by the kernel FUSE API.

The prefix m in the name stands for anything you want it to: "multi" because multiple libfuse versions are supported, "modded", "modern", or "Maximilian".

fusepy

fusepy is a Python module that provides a simple interface to FUSE_ and MacFUSE_. It's just one file and is implemented using ctypes.

fusepy requires FUSE 2.6 (or later) and runs on:

• Linux (i386, x86_64, PPC, arm64, MIPS)
• Mac OS X (Intel, PowerPC)
• FreeBSD (i386, amd64)

Examples

See some examples of how you can use fusepy:

---------------------------------+----------------------------- memory | A simple memory filesystem loopback | A loopback filesystem context | Sample usage of fuse_get_context() sftp | A simple SFTP filesystem (requires paramiko)

Platforms

While FUSE is (at least in the Unix world) a Kernel feature, several user space libraries exist for easy access. libfuse acts as the reference implementation.

• libfuse (Linux, FreeBSD) (fuse.h 2 3)
• libfuse (OpenBSD) (fuse.h 2)
• librefuse (NetBSD) through PUFFS (fuse.h 2)
• FUSE for macOS (OSX) (fuse.h 2)
• MacFUSE (OSX), no longer maintained
• WinFsp (Windows) (fuse.h 2 3)
• Dokany (Windows) (fuse.h 2)
• Dokan (Windows), no longer maintained