Metadata-Version: 2.5
Name: storage-kernel-testing
Version: 0.1.0a4
Summary: Testing utilities for Storage Kernel providers.
Project-URL: Homepage, https://storage-kernel.foggia.zip/?code=py
Project-URL: Documentation, https://storage-kernel.foggia.zip/?code=py
Project-URL: Source, https://github.com/brunnofoggia/storage-kernel-py/tree/main/packages/testing
Project-URL: Changelog, https://storage-kernel.foggia.zip/?code=py#changelog
Project-URL: Issues, https://github.com/brunnofoggia/storage-kernel-py/issues
License-Expression: MIT
License-File: LICENSE
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Typing :: Typed
Requires-Python: >=3.12
Requires-Dist: storage-kernel-contracts<0.2.0,>=0.1.0a1
Requires-Dist: storage-kernel-core<0.2.0,>=0.1.0a1
Description-Content-Type: text/markdown

# storage-kernel-testing

Testing utilities for Storage Kernel providers.

This package includes stream helpers and a portable provider contract test helper
that provider packages can reuse in their own suites. The common contract covers
binary, text and stream I/O, upload streams, overwrite protection, existence,
normalized not-found behavior, file information, native copy, directory reads,
content length and deletion. Provider-specific capabilities, security options
and observability remain in each provider's own unit suite.

## Install

```bash
uv add --dev storage-kernel-testing
```

## Usage

```python
from storage_kernel.testing import assert_client_contract

await assert_client_contract(client, namespace="provider-test")
```
