U ڲg @sfdZzddlmZWnek r0edYnXddlmZdZd ejddd ZGd d d Z dS) zFirebase Cloud Storage module. This module contains utilities for accessing Google Cloud Storage buckets associated with Firebase apps. This requires the ``google-cloud-storage`` Python module. )storageznFailed to import the Cloud Storage library for Python. Make sure to install the "google-cloud-storage" module.)_utilsZ_storageN)returncCst|ttj}||S)aoReturns a handle to a Google Cloud Storage bucket. If the name argument is not provided, uses the 'storageBucket' option specified when initializing the App. If that is also not available raises an error. This function does not make any RPC calls. Args: name: Name of a cloud storage bucket (optional). app: An App instance (optional). Returns: google.cloud.storage.Bucket: A handle to the specified bucket. Raises: ValueError: If a bucket name is not specified either via options or method arguments, or if the specified bucket name is not a valid string. )rZget_app_service_STORAGE_ATTRIBUTE_StorageClientfrom_appbucket)nameappclientr :/tmp/pip-unpacked-wheel-p0r7i5ii/firebase_admin/storage.pyr!src@s.eZdZdZddZeddZd ddZdS) rz-Holds a Google Cloud Storage client instance.cCstj||d|_||_dS)N) credentialsproject)rZClient_client_default_bucket)selfrrdefault_bucketr r r __init__:sz_StorageClient.__init__cCs$|j}|jd}t||j|S)NZ storageBucket)Z credentialget_credentialoptionsgetrZ project_id)clsr rrr r r r>s  z_StorageClient.from_appNcCsJ|dk r |n|j}|dkr"td|r0t|ts>td||j|S)z7Returns a handle to the specified Cloud Storage Bucket.NzStorage bucket name not specified. Specify the bucket name via the "storageBucket" option when initializing the App, or specify the bucket name explicitly when calling the storage.bucket() function.zKInvalid storage bucket name: "{0}". Bucket name must be a non-empty string.)r ValueError isinstancestrformatrr)rr Z bucket_namer r r rFsz_StorageClient.bucket)N)__name__ __module__ __qualname____doc__r classmethodrrr r r r r7s  r)NN) r Z google.cloudr ImportErrorZfirebase_adminrrZBucketrrr r r r s