kiarina-lib-google-cloud-storage 1.5.0__py3-none-any.whl → 1.6.0__py3-none-any.whl

kiarina/lib/google/cloud_storage/_get_blob.py

@@ -7,7 +7,11 @@ from .settings import settings_manager
 
 
 def get_blob(
-    config_key: str | None = None, blob_name: str | None = None, **kwargs: Any
+    blob_name: str | None = None,
+    *,
+    config_key: str | None = None,
+    auth_config_key: str | None = None,
+    **kwargs: Any,
 ) -> storage.Blob:
     settings = settings_manager.get_settings_by_key(config_key)
 
@@ -20,5 +24,5 @@ def get_blob(
     if settings.blob_name_prefix:
         blob_name = f"{settings.blob_name_prefix}/{blob_name}"
 
-    bucket = get_bucket(config_key, **kwargs)
+    bucket = get_bucket(config_key, auth_config_key=auth_config_key, **kwargs)
     return bucket.blob(blob_name)

kiarina/lib/google/cloud_storage/_get_bucket.py

@@ -6,11 +6,16 @@ from ._get_storage_client import get_storage_client
 from .settings import settings_manager
 
 
-def get_bucket(config_key: str | None = None, **kwargs: Any) -> storage.Bucket:
+def get_bucket(
+    config_key: str | None = None,
+    *,
+    auth_config_key: str | None = None,
+    **kwargs: Any,
+) -> storage.Bucket:
     settings = settings_manager.get_settings_by_key(config_key)
 
     if settings.bucket_name is None:
         raise ValueError("bucket_name is not set in the settings")
 
-    client = get_storage_client(config_key, **kwargs)
+    client = get_storage_client(auth_config_key, **kwargs)
     return client.bucket(settings.bucket_name)

kiarina/lib/google/cloud_storage/_get_storage_client.py

@@ -3,10 +3,10 @@ from typing import Any
 from google.cloud import storage  # type: ignore[import-untyped]
 from kiarina.lib.google.auth import get_credentials
 
-from .settings import settings_manager
 
-
-def get_storage_client(config_key: str | None = None, **kwargs: Any) -> storage.Client:
-    settings = settings_manager.get_settings_by_key(config_key)
-    credentials = get_credentials(settings.google_auth_config_key)
+def get_storage_client(
+    auth_config_key: str | None = None,
+    **kwargs: Any,
+) -> storage.Client:
+    credentials = get_credentials(auth_config_key)
     return storage.Client(credentials=credentials, **kwargs)

kiarina/lib/google/cloud_storage/settings.py

@@ -3,8 +3,6 @@ from pydantic_settings_manager import SettingsManager
 
 
 class GoogleCloudStorageSettings(BaseSettings):
-    google_auth_config_key: str | None = None
-
     bucket_name: str | None = None
 
     blob_name_prefix: str | None = None

{kiarina_lib_google_cloud_storage-1.5.0.dist-info → kiarina_lib_google_cloud_storage-1.6.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: kiarina-lib-google-cloud-storage
-Version: 1.5.0
+Version: 1.6.0
 Summary: Google Cloud Storage client library for kiarina namespace
 Project-URL: Homepage, https://github.com/kiarina/kiarina-python
 Project-URL: Repository, https://github.com/kiarina/kiarina-python
@@ -105,7 +105,6 @@ from kiarina.lib.google.cloud_storage import get_blob, settings_manager
 # Configure once (typically in your app initialization)
 settings_manager.user_config = {
     "default": {
-        "google_auth_config_key": "default",
         "bucket_name": "my-app-data",
         "blob_name_prefix": "production/v1"
     }
@@ -126,7 +125,6 @@ content = blob.download_as_text()
 # Set once in your deployment environment
 export KIARINA_LIB_GOOGLE_CLOUD_STORAGE_BUCKET_NAME="my-app-data"
 export KIARINA_LIB_GOOGLE_CLOUD_STORAGE_BLOB_NAME_PREFIX="production/v1"
-export KIARINA_LIB_GOOGLE_CLOUD_STORAGE_GOOGLE_AUTH_CONFIG_KEY="default"
 ```
 
 ```python
@@ -145,23 +143,35 @@ Deploy the same application code to different environments with different config
 
 ```yaml
 # config/production.yaml
+google_auth:
+  default:
+    type: "service_account"
+    service_account_file: "/secrets/prod-sa-key.json"
+
 google_cloud_storage:
   default:
-    google_auth_config_key: "production"
     bucket_name: "prod-us-west1-app-data"
     blob_name_prefix: "v2/production"
 
 # config/staging.yaml
+google_auth:
+  default:
+    type: "service_account"
+    service_account_file: "/secrets/staging-sa-key.json"
+
 google_cloud_storage:
   default:
-    google_auth_config_key: "staging"
     bucket_name: "staging-app-data"
     blob_name_prefix: "v2/staging"
 
 # config/development.yaml
+google_auth:
+  default:
+    type: "user_account"
+    authorized_user_file: "~/.config/gcloud/application_default_credentials.json"
+
 google_cloud_storage:
   default:
-    google_auth_config_key: "development"
     bucket_name: "dev-local-data"
     blob_name_prefix: "v2/dev"
 ```
@@ -193,15 +203,28 @@ Support multiple tenants with isolated storage, without changing application cod
 ```python
 from kiarina.lib.google.cloud_storage import settings_manager, get_blob
 
-# Configure tenant-specific storage
+# Configure tenant-specific storage and authentication
+from kiarina.lib.google.auth import settings_manager as auth_settings_manager
+
+# Authentication configuration (separate from storage)
+auth_settings_manager.user_config = {
+    "tenant_acme": {
+        "type": "service_account",
+        "service_account_file": "/secrets/acme-sa-key.json"
+    },
+    "tenant_globex": {
+        "type": "service_account",
+        "service_account_file": "/secrets/globex-sa-key.json"
+    }
+}
+
+# Storage configuration (separate from authentication)
 settings_manager.user_config = {
     "tenant_acme": {
-        "google_auth_config_key": "tenant_acme",
         "bucket_name": "acme-corp-data",
         "blob_name_prefix": "app-data"
     },
     "tenant_globex": {
-        "google_auth_config_key": "tenant_globex",
         "bucket_name": "globex-data",
         "blob_name_prefix": "app-data"
     }
@@ -211,7 +234,11 @@ settings_manager.user_config = {
 def save_document(tenant_id: str, doc_id: str, content: bytes):
     """Save document for any tenant"""
     config_key = f"tenant_{tenant_id}"
-    blob = get_blob(config_key=config_key, blob_name=f"documents/{doc_id}.pdf")
+    blob = get_blob(
+        blob_name=f"documents/{doc_id}.pdf",
+        config_key=config_key,
+        auth_config_key=config_key
+    )
     blob.upload_from_string(content)
 
 def list_documents(tenant_id: str) -> list[str]:
@@ -219,7 +246,7 @@ def list_documents(tenant_id: str) -> list[str]:
     from kiarina.lib.google.cloud_storage import get_bucket
     
     config_key = f"tenant_{tenant_id}"
-    bucket = get_bucket(config_key=config_key)
+    bucket = get_bucket(config_key=config_key, auth_config_key=config_key)
     
     # Get prefix from settings
     settings = settings_manager.get_settings_by_key(config_key)
@@ -247,7 +274,6 @@ def mock_storage_config():
     """Configure test storage"""
     settings_manager.user_config = {
         "test": {
-            "google_auth_config_key": "test",
             "bucket_name": "test-bucket",
             "blob_name_prefix": f"test-run-{datetime.now().isoformat()}"
         }
@@ -312,13 +338,14 @@ This library uses [pydantic-settings-manager](https://github.com/kiarina/pydanti
 
 | Field | Type | Required | Description |
 |-------|------|----------|-------------|
-| `google_auth_config_key` | `str \| None` | No | Configuration key for kiarina-lib-google-auth |
 | `bucket_name` | `str \| None` | Yes* | Google Cloud Storage bucket name |
 | `blob_name_prefix` | `str \| None` | No | Prefix for blob names (e.g., "production/v1") |
 | `blob_name` | `str \| None` | No | Default blob name (rarely used) |
 
 *Required when using `get_bucket()` or `get_blob()`
 
+**Note:** Authentication is configured separately through `auth_config_key` parameters in the API functions, which reference configurations in [kiarina-lib-google-auth](../kiarina-lib-google-auth/).
+
 ### Configuration Methods
 
 #### 1. Programmatic Configuration
@@ -328,7 +355,6 @@ from kiarina.lib.google.cloud_storage import settings_manager
 
 settings_manager.user_config = {
     "default": {
-        "google_auth_config_key": "default",
         "bucket_name": "my-bucket",
         "blob_name_prefix": "app-data"
     }
@@ -340,11 +366,12 @@ settings_manager.user_config = {
 All settings can be configured via environment variables with the `KIARINA_LIB_GOOGLE_CLOUD_STORAGE_` prefix:
 
 ```bash
-export KIARINA_LIB_GOOGLE_CLOUD_STORAGE_GOOGLE_AUTH_CONFIG_KEY="default"
 export KIARINA_LIB_GOOGLE_CLOUD_STORAGE_BUCKET_NAME="my-bucket"
 export KIARINA_LIB_GOOGLE_CLOUD_STORAGE_BLOB_NAME_PREFIX="app-data"
 ```
 
+**Note:** Authentication is configured separately via `KIARINA_LIB_GOOGLE_AUTH_*` environment variables. See [kiarina-lib-google-auth](../kiarina-lib-google-auth/) for details.
+
 #### 3. Configuration Files (with YAML)
 
 ```python
@@ -360,33 +387,50 @@ settings_manager.user_config = config["google_cloud_storage"]
 
 ### Integration with kiarina-lib-google-auth
 
-This library integrates seamlessly with [kiarina-lib-google-auth](../kiarina-lib-google-auth/) for authentication:
+This library integrates seamlessly with [kiarina-lib-google-auth](../kiarina-lib-google-auth/) for authentication.
+
+**Key Design:** Authentication and storage configurations are **completely separate**, allowing flexible combinations.
 
 ```python
 from kiarina.lib.google.auth import settings_manager as auth_settings_manager
 from kiarina.lib.google.cloud_storage import settings_manager as storage_settings_manager
 
-# Configure authentication
+# Configure authentication (separate)
 auth_settings_manager.user_config = {
     "default": {
         "type": "service_account",
         "service_account_file": "~/service-account-key.json"
+    },
+    "user_auth": {
+        "type": "user_account",
+        "authorized_user_file": "~/.config/gcloud/application_default_credentials.json"
     }
 }
 
-# Configure storage (references auth config)
+# Configure storage (separate)
 storage_settings_manager.user_config = {
     "default": {
-        "google_auth_config_key": "default",  # References auth config above
         "bucket_name": "my-bucket"
+    },
+    "backup": {
+        "bucket_name": "my-backup-bucket"
     }
 }
 
-# Use authenticated storage
+# Use with default authentication
 from kiarina.lib.google.cloud_storage import get_bucket
-bucket = get_bucket()  # Automatically authenticated
+bucket = get_bucket()  # Uses default auth + default storage
+
+# Mix and match configurations
+bucket = get_bucket(config_key="backup", auth_config_key="user_auth")
+# Uses user_auth authentication + backup storage configuration
 ```
 
+**Benefits of Separation:**
+- **Flexibility**: Use same auth with multiple buckets, or multiple auths with same bucket
+- **Clarity**: Clear distinction between "who" (auth) and "where" (storage)
+- **Reusability**: Share authentication across different storage configurations
+
 ## API Reference
 
 ### get_storage_client()
@@ -395,13 +439,13 @@ Get a Google Cloud Storage client with credentials from kiarina-lib-google-auth.
 
 ```python
 def get_storage_client(
-    config_key: str | None = None,
+    auth_config_key: str | None = None,
     **kwargs: Any
 ) -> storage.Client
 ```
 
 **Parameters:**
-- `config_key`: Configuration key to use (default: None uses active key)
+- `auth_config_key`: Configuration key for kiarina-lib-google-auth (default: None uses active key)
 - `**kwargs`: Additional arguments passed to `storage.Client()`
 
 **Returns:**
@@ -410,7 +454,7 @@ def get_storage_client(
 **Example:**
 ```python
 client = get_storage_client()
-client = get_storage_client(config_key="production")
+client = get_storage_client(auth_config_key="production")
 client = get_storage_client(project="my-project")  # Override project
 ```
 
@@ -421,12 +465,15 @@ Get a Google Cloud Storage bucket.
 ```python
 def get_bucket(
     config_key: str | None = None,
+    *,
+    auth_config_key: str | None = None,
     **kwargs: Any
 ) -> storage.Bucket
 ```
 
 **Parameters:**
-- `config_key`: Configuration key to use (default: None uses active key)
+- `config_key`: Configuration key for storage settings (default: None uses active key)
+- `auth_config_key`: Configuration key for authentication (default: None uses active key)
 - `**kwargs`: Additional arguments passed to `get_storage_client()`
 
 **Returns:**
@@ -439,6 +486,7 @@ def get_bucket(
 ```python
 bucket = get_bucket()
 bucket = get_bucket(config_key="production")
+bucket = get_bucket(config_key="production", auth_config_key="prod_auth")
 
 # Use native google-cloud-storage API
 for blob in bucket.list_blobs(prefix="users/"):
@@ -451,15 +499,18 @@ Get a Google Cloud Storage blob.
 
 ```python
 def get_blob(
-    config_key: str | None = None,
     blob_name: str | None = None,
+    *,
+    config_key: str | None = None,
+    auth_config_key: str | None = None,
     **kwargs: Any
 ) -> storage.Blob
 ```
 
 **Parameters:**
-- `config_key`: Configuration key to use (default: None uses active key)
 - `blob_name`: Blob name (default: None uses settings.blob_name)
+- `config_key`: Configuration key for storage settings (default: None uses active key)
+- `auth_config_key`: Configuration key for authentication (default: None uses active key)
 - `**kwargs`: Additional arguments passed to `get_bucket()`
 
 **Returns:**
@@ -478,6 +529,13 @@ blob = get_blob(blob_name="data.json")
 # Actual blob name will be "production/v1/data.json"
 blob = get_blob(blob_name="data.json")
 
+# With custom configurations
+blob = get_blob(
+    blob_name="data.json",
+    config_key="production",
+    auth_config_key="prod_auth"
+)
+
 # Use native google-cloud-storage API
 blob.upload_from_string("content")
 content = blob.download_as_text()

kiarina_lib_google_cloud_storage-1.6.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+kiarina/lib/google/cloud_storage/__init__.py,sha256=q2AdOOOHUj_D-eot8_1-atrIaCKsCg0YatUOdq3kVVE,1184
+kiarina/lib/google/cloud_storage/_get_blob.py,sha256=ymvAwPZmPYC407jmLgc0uCOoo3qGh8B2zssAVkLHX_I,817
+kiarina/lib/google/cloud_storage/_get_bucket.py,sha256=SaGIQqRb9UOJaosGf2pXduAEYscE_T21AHCNTaZtRGo,597
+kiarina/lib/google/cloud_storage/_get_storage_client.py,sha256=lmBR2I9_vcyb0PfsiSz0BPFYBwQ6zVci75cmk9GUN5U,359
+kiarina/lib/google/cloud_storage/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+kiarina/lib/google/cloud_storage/settings.py,sha256=q47sa7CjegzXT2jhIDFbAc1huESQzZ3N1tlcmtKnLGU,334
+kiarina_lib_google_cloud_storage-1.6.0.dist-info/METADATA,sha256=h26xRaiJeWJ_EQqAQQkt4DkruqVtb9pXVUJnT5LbRUk,22959
+kiarina_lib_google_cloud_storage-1.6.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+kiarina_lib_google_cloud_storage-1.6.0.dist-info/RECORD,,

kiarina_lib_google_cloud_storage-1.5.0.dist-info/RECORD

@@ -1,9 +0,0 @@
-kiarina/lib/google/cloud_storage/__init__.py,sha256=q2AdOOOHUj_D-eot8_1-atrIaCKsCg0YatUOdq3kVVE,1184
-kiarina/lib/google/cloud_storage/_get_blob.py,sha256=baZ7msH9xPme3jw0mI9x2NzikapdeSyBqH_6iDdgohI,728
-kiarina/lib/google/cloud_storage/_get_bucket.py,sha256=Y7gX-igAkLoLhxa3cDazTAcNX_X_uUjJRUs93lcRg98,534
-kiarina/lib/google/cloud_storage/_get_storage_client.py,sha256=XTsjQdVN4_tqO1KX-pC4-st7As7mMxeB1XhagzuJLaY,463
-kiarina/lib/google/cloud_storage/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-kiarina/lib/google/cloud_storage/settings.py,sha256=QSY37za-Vi3S7fQLX7AzC5m65QxjxtuYYT9wq08Ee0o,381
-kiarina_lib_google_cloud_storage-1.5.0.dist-info/METADATA,sha256=SCFb0PFxO75UWAhAtGMGVTMb3KvU0N7QPjc_2MdRUuY,20994
-kiarina_lib_google_cloud_storage-1.5.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-kiarina_lib_google_cloud_storage-1.5.0.dist-info/RECORD,,