feat!(objectstore): add Azure and GCS backends with provider auto-detection

pyproject.toml

@@ -10,6 +10,8 @@ authors = [
 requires-python = ">=3.11"
 dependencies = [
     "minio~=7.2.16",
+    "azure-storage-blob>=12.20.0",
+    "google-cloud-storage>=2.18.0",
     "setuptools>=83.0",
     "requests>=2.33.0",
     "requests-oauthlib~=2.0.0",
@@ -76,6 +78,8 @@ dev = [
     "django>=4.0",
     "flask>=3.0",
     "a2a-sdk>=0.2.0",
+    "azure-storage-blob>=12.20.0",
+    "google-cloud-storage>=2.18.0",
     "langchain-core>=1.2.7",
     "langgraph>=0.2.0",
     "langchain-community>=0.3.0",

src/sap_cloud_sdk/objectstore/__init__.py

@@ -1,76 +1,47 @@
 """SAP Cloud SDK for Python - Object Store module
 
-The create_client() uses secret resolver to load credentials from mounts/env vars
+``create_client()`` auto-detects the cloud provider from the service binding and
+returns a client implementing the ``ObjectStoreClient`` protocol. Supported
+providers: S3/MinIO, Azure Blob Storage, Google Cloud Storage.
 
 Usage:
     from sap_cloud_sdk.objectstore import create_client
 
     client = create_client("object-store-1")
 """
 
-from typing import Optional
-
+from sap_cloud_sdk.objectstore._factory import create_client
+from sap_cloud_sdk.objectstore._models import ObjectMetadata
+from sap_cloud_sdk.objectstore._protocol import ObjectReader, ObjectStoreClient
+from sap_cloud_sdk.objectstore.config import (
+    AzureConfig,
+    GcsConfig,
+    S3Config,
+)
 from sap_cloud_sdk.objectstore.exceptions import (
-    ObjectStoreError,
     ClientCreationError,
-    ObjectOperationError,
-    ObjectNotFoundError,
+    ConfigError,
     ListObjectsError,
+    ObjectNotFoundError,
+    ObjectOperationError,
+    ObjectStoreError,
 )
-from sap_cloud_sdk.objectstore._models import ObjectStoreBindingData, ObjectMetadata
-from sap_cloud_sdk.objectstore._s3 import ObjectStoreClient
-from sap_cloud_sdk.core.secret_resolver import read_from_mount_and_fallback_to_env_var
-
-
-def create_client(
-    instance: str,
-    *,
-    config: Optional[ObjectStoreBindingData] = None,
-    disable_ssl: bool = False,
-) -> ObjectStoreClient:
-    """Creates an ObjectStoreClient with automatic local/cloud detection.
-    Uses secret resolver to load credentials from mounted secrets or environment variables
-
-    Args:
-        instance: Instance name for cloud mode secret resolution. Must be a non-empty string.
-        config: Optional explicit configuration. If provided, auto-detection is skipped
-                and this configuration is used directly.
-        disable_ssl: Whether to disable SSL/TLS connections. Defaults to False.
-
-    Returns:
-        ObjectStoreClient: Configured client ready for object storage operations.
-
-    Raises:
-        ValueError: If instance parameter is empty or None.
-        ClientCreationError: If client creation fails due to configuration or connection issues.
-    """
-    if not instance or not instance.strip():
-        raise ValueError("instance parameter must be a non-empty string")
-
-    # Cloud mode: with explicit configuration
-    if config is not None:
-        return ObjectStoreClient(config, disable_ssl=disable_ssl)
-
-    # Cloud mode: use secret resolver to load configuration
-    config = ObjectStoreBindingData()
-    read_from_mount_and_fallback_to_env_var(
-        base_volume_mount="/etc/secrets/appfnd",
-        base_var_name="CLOUD_SDK_CFG",
-        module="objectstore",
-        instance=instance,
-        target=config,
-    )
-    return ObjectStoreClient(config, disable_ssl=disable_ssl)
-
 
 __all__ = [
-    # Public user-facing types
+    # Protocol (usable as a type annotation)
+    "ObjectStoreClient",
+    "ObjectReader",
+    # Config types (pass to create_client() to bypass auto-detection)
+    "S3Config",
+    "AzureConfig",
+    "GcsConfig",
+    # Metadata model
     "ObjectMetadata",
-    "ObjectStoreBindingData",
     # Factory function
     "create_client",
     # Exceptions
     "ObjectStoreError",
+    "ConfigError",
     "ClientCreationError",
     "ObjectOperationError",
     "ObjectNotFoundError",