Enum CloudStorageConfig 

pub enum CloudStorageConfig {
    S3 {
        bucket: String,
        region: Option<String>,
        endpoint: Option<String>,
        access_key_id: Option<String>,
        secret_access_key: Option<String>,
        session_token: Option<String>,
        virtual_hosted_style: bool,
    },
    Gcs {
        bucket: String,
        service_account_path: Option<String>,
        service_account_key: Option<String>,
    },
    Azure {
        container: String,
        account: String,
        access_key: Option<String>,
        sas_token: Option<String>,
    },
}

Cloud storage backend configuration.

Supports Amazon S3, Google Cloud Storage, and Azure Blob Storage. Each variant contains the credentials and connection parameters for its respective cloud provider.

Examples

// Create S3 configuration from environment variables
let config = CloudStorageConfig::s3_from_env("my-bucket");

// Create explicit S3 configuration for LocalStack testing
let config = CloudStorageConfig::S3 {
    bucket: "test-bucket".to_string(),
    region: Some("us-east-1".to_string()),
    endpoint: Some("http://localhost:4566".to_string()),
    access_key_id: Some("test".to_string()),
    secret_access_key: Some("test".to_string()),
    session_token: None,
    virtual_hosted_style: false,
};

Variants

S3

Amazon S3 storage configuration.

Fields

bucket: String

S3 bucket name.

region: Option<String>

AWS region (e.g., “us-east-1”). Uses AWS_REGION env var if None.

endpoint: Option<String>

Custom endpoint URL for S3-compatible services (MinIO, LocalStack).

access_key_id: Option<String>

AWS access key ID. Uses AWS_ACCESS_KEY_ID env var if None.

secret_access_key: Option<String>

AWS secret access key. Uses AWS_SECRET_ACCESS_KEY env var if None.

session_token: Option<String>

AWS session token for temporary credentials.

virtual_hosted_style: bool

Use virtual-hosted-style requests (bucket.s3.region.amazonaws.com).

Gcs

Google Cloud Storage configuration.

Fields

bucket: String

GCS bucket name.

service_account_path: Option<String>

Path to service account JSON key file.

service_account_key: Option<String>

Service account JSON key content (alternative to path).

Azure

Azure Blob Storage configuration.

Fields

container: String

Azure container name.

account: String

Azure storage account name.

access_key: Option<String>

Azure storage account access key.

sas_token: Option<String>

Azure SAS token for limited access.

Implementations

impl CloudStorageConfig

pub fn s3_from_env(bucket: &str) -> Self

Creates an S3 configuration using environment variables.

Reads credentials from standard AWS environment variables:

• AWS_ACCESS_KEY_ID
• AWS_SECRET_ACCESS_KEY
• AWS_SESSION_TOKEN (optional)
• AWS_REGION or AWS_DEFAULT_REGION
• AWS_ENDPOINT_URL (optional, for S3-compatible services)

pub fn gcs_from_env(bucket: &str) -> Self

Creates a GCS configuration using environment variables.

Reads service account path from GOOGLE_APPLICATION_CREDENTIALS.

pub fn azure_from_env(container: &str) -> Self

Creates an Azure configuration using environment variables.

Reads credentials from Azure environment variables:

• AZURE_STORAGE_ACCOUNT
• AZURE_STORAGE_ACCESS_KEY (optional)
• AZURE_STORAGE_SAS_TOKEN (optional)

Panics

Panics if AZURE_STORAGE_ACCOUNT is not set.

pub fn bucket_name(&self) -> &str

Returns the bucket/container name for this configuration.

pub fn to_url(&self) -> String

Returns a URL-style identifier for this storage location.

Trait Implementations

impl Clone for CloudStorageConfig

fn clone(&self) -> CloudStorageConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for CloudStorageConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.