storage-kernel-factory

Dynamic provider factory for Storage Kernel.

The factory normalizes provider aliases and imports provider packages only when a client is requested. It does not force every provider to be installed by applications.

Install

uv add storage-kernel-factory storage-kernel-provider-local-filesystem

Usage

from storage_kernel.contracts import StorageLocation
from storage_kernel.factory import CreateStorageClientConfig, create_storage_client

storage = await create_storage_client(
    CreateStorageClientConfig(
        provider_name="filesystem",
        location=StorageLocation(directory=".storage"),
    )
)

provider_name is mandatory. provider_class optionally accepts a class that follows StorageClientClass; instances are rejected. The created client always receives the shared observability and error-normalization behavior, even when the custom class does not inherit a kernel base class.

Use extras such as storage-kernel-factory[aws-s3] when published packages are available.