Skip to content

Latest commit

 

History

History
166 lines (143 loc) · 6.55 KB

README.md

File metadata and controls

166 lines (143 loc) · 6.55 KB

license status pypi_version pypi_versions

refuse

Synopsis

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:

  • 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

THIS PROJECT HAS ALPHA 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.

Installation

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+https://github.com/pleiszenburgrefuse.git@develop

refuse (theoretically) runs on:

OSAPIarch
levelversion i386x86_64PPCPPC64arm64MIPS
Linuxhigh2 yesyesyesyesyesyes
3 nononononono
low2 yesyesyesyesyesyes
3 nononononono
Mac OS Xhigh2 yesyesyesyes
3 nononono
low2 yesyesyesyes
3 nononono
FreeBSDhigh2 yesyesnononono
3 nononononono
low2 yesyesnononono
3 nononononono
OpenBSDhigh2 yesyesyesyesyesyes
3 nononononono
low2 nononononono
3 nononononono
Windowshigh2 yesyesno
3 nonono
low2 nonono
3 nonono
Windows/Cygwinhigh2 yesyesno
3 nonono
low2 nonono
3 nonono

Porting a project from fusepy to refuse

See documentation.

Miscellaneous