o  i @sdZddlmZddlmZmZddlmZddlmZz+ddl m Z ddl m Z e Ze jD]\ZZedsEeevrEee e<q3WneyXZzed ed Z[wwd ZddddZGdddZd S)zCloud Firestore module. This module contains utilities for accessing the Google Cloud Firestore databases associated with Firebase apps. This requires the ``google-cloud-firestore`` Python module. ) annotations)OptionalDict)App)_utils) firestore)DEFAULT_DATABASE_zrFailed to import the Cloud Firestore library for Python. Make sure to install the "google-cloud-firestore" module.N _firestoreapp Optional[App] database_id Optional[str]returnfirestore.ClientcCs:|durt|tstd|dt|tt}||S)a,Returns a client that can be used to interact with Google Cloud Firestore. Args: app: An App instance (optional). database_id: The database ID of the Google Cloud Firestore database to be used. Defaults to the default Firestore database ID if not specified or an empty string (optional). Returns: google.cloud.firestore.Firestore: A `Firestore Client`_. Raises: ValueError: If the specified database ID is not a valid string, or if a project ID is not specified either via options, credentials or environment variables, or if the specified project ID is not a valid string. .. _Firestore Client: https://cloud.google.com/python/docs/reference/firestore/latest/ google.cloud.firestore_v1.client.Client Nz database_id "z" must be a string or None.) isinstancestr ValueErrorrget_app_service_FIRESTORE_ATTRIBUTE_FirestoreService get_client)r r fs_servicerx/var/www/snowflake_co_dev_github/snow_flake_back_end_deploy/env/lib/python3.10/site-packages/firebase_admin/firestore.pyclient)s rc@s$eZdZdZdddZdd d Zd S)rz9Service that maintains a collection of firestore clients.r rrNonecCs||_i|_dS)N)_app_clients)selfr rrr__init__Gs z_FirestoreService.__init__r rrcCsV|pt}||jvr&|jj}|jj}|stdtj|||d}||j|<|j|S)zDCreates a client based on the database_id. These clients are cached.zProject ID is required to access Firestore. Either set the projectId option, or use service account credentials. Alternatively, set the GOOGLE_CLOUD_PROJECT environment variable.) credentialsprojectdatabase) rrr credentialget_credential project_idrrClient)rr r!r" fs_clientrrrrKs    z_FirestoreService.get_clientN)r rrr)r rrr)__name__ __module__ __qualname____doc__r rrrrrrDs r)NN)r r r rrr)r, __future__rtypingrrfirebase_adminrr google.cloudr%google.cloud.firestore_v1.base_clientrglobalskeysexisting__dict__itemskeyvalue startswith ImportErrorerrorrrrrrrrs.