Metadata-Version: 2.4
Name: mount-image-sshfs
Version: 0.1.0
Summary: Disk image mounting via SSHFS (cross-platform FUSE)
Author-email: Michael Banucu <michael.banucu@googlemail.com>
License-Expression: GPL-3.0-only
Project-URL: Homepage, https://github.com/MBanucu/mount-image-sshfs
Project-URL: Repository, https://github.com/MBanucu/mount-image-sshfs
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: System :: Filesystems
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# mount-image-sshfs

Disk image mounting via SSHFS (cross-platform FUSE).

[![PyPI version](https://img.shields.io/pypi/v/mount-image-sshfs)](https://pypi.org/project/mount-image-sshfs/)
[![Python](https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-blue)](https://www.python.org/)
[![License](https://img.shields.io/github/license/MBanucu/mount-image-sshfs)](LICENSE)
[![OS](https://img.shields.io/badge/OS-Linux%20%7C%20macOS-blue)](https://github.com/MBanucu/mount-image-sshfs)

[![CI](https://img.shields.io/github/actions/workflow/status/MBanucu/mount-image-sshfs/test.yml?branch=main)](https://github.com/MBanucu/mount-image-sshfs/actions/workflows/test.yml)
[![codecov](https://codecov.io/gh/MBanucu/mount-image-sshfs/branch/main/graph/badge.svg)](https://codecov.io/gh/MBanucu/mount-image-sshfs)

## Quick start

```python
from mount_image_sshfs import mount_image, umount_image

mount_point, _ = mount_image('user@host:/remote/path')
print(f'Mounted at {mount_point}')
umount_image(mount_point, mount_point)
```

## API

- `mount_image(source, fstype=None, options=None)` → `(mount_point, mount_point)`
- `umount_image(mount_point, mount_point=None)`
- `attach_image(path)` — raises `NotImplementedError`
- `detach_image(device)` — raises `NotImplementedError`

Requires `sshfs` installed on the host.

## License

GPL-3.0-only
