Metadata-Version: 2.4
Name: vsmbfs
Version: 0.1.0
Summary: VFSI fsspec filesystem backed by the vectorized vsmb client
Author-email: Ming Chen <v.mingchen@gmail.com>
License-Expression: MIT OR Apache-2.0
Project-URL: Homepage, https://github.com/vmingchen/vnfs
Project-URL: Documentation, https://github.com/vmingchen/vnfs/tree/main/adapters/vsmbfs
Project-URL: Repository, https://github.com/vmingchen/vnfs
Project-URL: Issues, https://github.com/vmingchen/vnfs/issues
Project-URL: Changelog, https://github.com/vmingchen/vnfs/blob/main/CHANGELOG.md
Keywords: vfsi,fsspec,smb,smb2,smb3,filesystem,vectorized-io
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Typing :: Typed
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: fsspec>=2024.12.0
Requires-Dist: vfsi-fsspec<0.2,>=0.1
Requires-Dist: vsmb<0.2,>=0.1
Provides-Extra: test
Requires-Dist: pytest; extra == "test"
Provides-Extra: dev
Requires-Dist: black; extra == "dev"
Requires-Dist: build; extra == "dev"
Requires-Dist: mypy; extra == "dev"
Requires-Dist: pytest; extra == "dev"
Requires-Dist: ruff; extra == "dev"
Requires-Dist: twine; extra == "dev"

# vsmbfs

`vsmbfs` is the fsspec adapter for the low-level `vsmb` vector SMB2/3 client.

```sh
python -m pip install vsmbfs
```

```python
import fsspec
import vsmbfs

fs = fsspec.filesystem(
    "vsmbfs",
    host="files.example",
    share="data",
    username="user",
    password="secret",
)
print(fs.ls("/"))
```

Bulk fsspec operations and coordinated `open_files` buffering use VFSI vector
operations so independent SMB requests can be issued in bounded batches.
