Metadata-Version: 2.4
Name: vsmb
Version: 0.1.0
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Rust
Classifier: Typing :: Typed
Requires-Dist: black ; extra == 'dev'
Requires-Dist: maturin ; extra == 'dev'
Requires-Dist: mypy ; extra == 'dev'
Requires-Dist: pytest ; extra == 'dev'
Requires-Dist: ruff ; extra == 'dev'
Requires-Dist: twine ; extra == 'dev'
Requires-Dist: pytest ; extra == 'test'
Provides-Extra: dev
Provides-Extra: test
License-File: LICENSE-APACHE
License-File: LICENSE-MIT
Summary: Low-level VFSI vectorized SMB2/3 client for Python
Keywords: vfsi,smb,smb2,smb3,filesystem,vectorized-io
Home-Page: https://github.com/vmingchen/vnfs
Author-email: Ming Chen <v.mingchen@gmail.com>
License-Expression: MIT OR Apache-2.0
Requires-Python: >=3.9
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
Project-URL: Changelog, https://github.com/vmingchen/vnfs/blob/main/CHANGELOG.md
Project-URL: Documentation, https://github.com/vmingchen/vnfs/tree/main/adapters/vsmb
Project-URL: Homepage, https://github.com/vmingchen/vnfs
Project-URL: Issues, https://github.com/vmingchen/vnfs/issues
Project-URL: Repository, https://github.com/vmingchen/vnfs

# vsmb

`vsmb` is the low-level Python client for the VFSI SMB2/3 backend. It exposes
both scalar operations and vector operations such as `stat_many`, `read_many`,
`write_many`, `open_many`, and descriptor-vector I/O.

```sh
python -m pip install vsmb
```

```python
from vsmb import SmbClient

with SmbClient(
    host="files.example",
    share="data",
    username="user",
    password="secret",
) as client:
    results, errors = client.stat_many(["/a", "/b", "/c"])
```

This package deliberately has no fsspec dependency. Install `vsmbfs` for the
fsspec-compatible filesystem API. Rust applications should use the separate
`vfsi-smb` crate.

