Skip to main content

FUSE File System for accessing remote servers

A FUSE file system for mounting remote file servers as local directories. Currently, we support Microsoft SharePoint sites.

Installation

pip install remote-fuse

Configuration

The following environment variables need to be set:

  • TENANT_ID: Azure AD tenant ID
  • CLIENT_ID: Azure AD client/application ID
  • CLIENT_SECRET: Azure AD client secret
  • SITE_ID: SharePoint site ID

Running

# Mount remote cloud storage
remote-fuse <mounting-point>
# Optionally, add `--site-id <site-id>` to override SITE_ID.

# Unmount when finished
fusermount -uqz <mount-point>

Development

# Install dependencies
python3.10 -m venv .venv
source .venv/bin/activate

# Install dependencies
pip install -e .

# For development/testing
pip install -e ".[test]"

Requirements

  • Python 3.10 or newer
  • Linux with FUSE 2. On Ubuntu, install fuse, libfuse-dev, and pkg-config before installing this package. Native mounting on macOS is not supported.

Usage

# Mount SharePoint site as local directory
python src/commands/fuse_sharepoint.py <mount-point> [--site-id optional]

# Unmount SharePoint site when finished
fusermount -uqz <mount-point>

# Run tests
pytest

Offline regression tests run without credentials. SharePoint integration tests need all four environment variables; mounted tests also need /dev/fuse and fusermount. Tests skip when these requirements are missing. Integration tests create and remove uniquely named folders on the configured site.

The fuse-sharepoint command remains available as an alias for remote-fuse.

With uv, use uv sync --locked --all-extras and uv run --locked pytest. The .python-version file selects Python 3.10.

Overview of the project

  • src/remote_fuse/core.py: Implements Fuse interface and by invoking API calls to remote service
  • src/remote_fuse/sharepoint.py: Implements the interface to present SharePoint as a local filesystem
  • src/commands/fuse_sharepoint.py: Mounts SharePoint site as local directory

python-fuse documentation

Currently, python-fuse only supports Linux. There is no easy way to stop the process once started, it doesn't react to signals, however, it will stop if you unmount it. https://github.com/libfuse/python-fuse/blob/master/README.new_fusepy_api.rst

Metadata

Release files for remote-fuse 0.1.7

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for remote-fuse 0.1.7
File Size Uploaded Provenance Actions
remote_fuse-0.1.7.tar.gz 20.1 kB Without provenance Details for remote_fuse-0.1.7.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for remote-fuse 0.1.7
File Interpreter ABI Platform Actions
remote_fuse-0.1.7-py3-none-any.whl Python 3 none any Details for remote_fuse-0.1.7-py3-none-any.whl

Total release size: 36.9 kB

Release files / remote_fuse-0.1.7.tar.gz

Download URL remote_fuse-0.1.7.tar.gz
Size 20.1 kB
Tags Source
SHA-256 checksum
How to use checksums
08cbf4706de386b7be8a5457bcf922ff6512e039d2991cfef9f82135b63ccb9b
BLAKE2b-256 checksum
How to use checksums
cd161c82294d2d5a66f834d108e327260597d5a67c119602eae20ff6d950fc21
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.5 {"installer":{"name":"uv","version":"0.13.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / remote_fuse-0.1.7-py3-none-any.whl

Download URL remote_fuse-0.1.7-py3-none-any.whl
Size 16.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
96449c6532c40ae00855dada570ceb673fdc8a5e34add17070d71ec2ed0126a7
BLAKE2b-256 checksum
How to use checksums
3f17db348c874d3f9fd10610e82bf4aba894e292bffb1adeb27a7fcd72b16bdc
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.13.5 {"installer":{"name":"uv","version":"0.13.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for remote-fuse 0.1.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page