Google Cloud Storage

forze[gcs] implements object storage on Google Cloud Storage — the same storage contracts as S3, on GCS buckets.

Install¶

uv add 'forze[gcs]'

Needs GCS (or fake-gcs-server via STORAGE_EMULATOR_HOST).

The client¶

from forze_gcs import GCSClient

gcs = GCSClient()

RoutedGCSClient (with GCSRoutingCredentials) resolves per-tenant projects/credentials.

Wire it¶

Each storage route names a bucket, keyed by StorageSpec.name:

from forze.application.execution import DepsRegistry, LifecyclePlan
from forze_gcs import GCSClient, GCSDepsModule, GCSStorageConfig, gcs_lifecycle_step

deps = DepsRegistry.from_modules(
    GCSDepsModule(client=gcs, storages={"assets": GCSStorageConfig(bucket="my-assets")}),
)
lifecycle = LifecyclePlan.from_steps(gcs_lifecycle_step(project_id="my-project"))

What it provides¶

Notes¶

• You provision buckets, IAM, and lifecycle rules. Forze only does query/command (with content-type detection).
• Credentials default to Application Default Credentials; pass service_file for an explicit key, or RoutedGCSClient for per-tenant projects.
• With tenant_aware, object keys are prefixed per tenant.