storage-kernel-provider-gcp-storage

GCP Cloud Storage provider for Storage Kernel.

This provider maps StorageLocation.bucket to a Cloud Storage bucket and StorageLocation.prefix to an object-name namespace.

Install

uv add storage-kernel-contracts storage-kernel-provider-gcp-storage

Usage

from storage_kernel.contracts import StorageClientOptions, StorageLocation, StoragePath
from storage_kernel.provider_gcp_storage import (
    GcpStorageProviderOptions,
    create_gcp_storage_client,
)

storage = create_gcp_storage_client(
    StorageClientOptions(location=StorageLocation(bucket="my-bucket", prefix="prod")),
    GcpStorageProviderOptions(project_id="my-project"),
)

await storage.send_content(StoragePath("docs/readme.txt"), "Hello")

The provider uses google-cloud-storage behind the provider boundary. When credentials and client are omitted, authentication follows Google Application Default Credentials. An injected client is caller-owned and may be used for custom SDK configuration or tests.

Provider Options

Capabilities

• full binary and text reads/writes
• blob read streams
• resumable writable upload streams
• prefix-based directory listing and recursive deletion
• same-provider native copy
• Cloud Storage signed URLs
• public URLs through public_base_url or the blob public URL

Provider SDK errors are normalized into Storage Kernel errors such as path not found, permission denied and provider error.