storage-kernel-core

Shared Storage Kernel implementation: portable path handling, directory selection, stream helpers, observability and provider error normalization.

This distribution belongs to the Storage Kernel package family. It sits between storage-kernel-contracts and the provider distributions.

Install it when you build a provider or reuse the kernel helpers directly. If you only need to type a storage client or catch storage errors, depend on storage-kernel-contracts alone.

Install

pip install storage-kernel-core storage-kernel-contracts

Usage

from storage_kernel.contracts import StoragePathNotFoundError
from storage_kernel.core import normalize_storage_path, normalize_storage_provider_error

key = normalize_storage_path("./reports//2026.csv")

try:
    read_object(key)
except Exception as error:
    raise normalize_storage_provider_error(error, "aws-s3", key) from error

What it provides

Error normalization

Not-found and permission failures are normalized, because a caller must branch on them without knowing which provider is behind the contract. Every other failure keeps the provider message and gains provider, path and code, with the original exception preserved in cause and in the exception chain.

An exception that already is a StorageKernelError keeps its class and instance. Only the context it is missing is filled in.

License

MIT