o  i`@s"dZddlZddlZddlZddlZddlZddlmZddlmZddlmZdZ ddZ d+d d Z d+d d Z d+d dZ d+ddZd,ddZd,ddZddZddZddZddZGdddZGdd d ZGd!d"d"ZGd#d$d$eZGd%d&d&eZGd'd(d(ZGd)d*d*ZdS)-zFirebase Project Management module. This module enables management of resources in Firebase projects, such as Android and iOS apps. N) exceptions) _http_client)_utils_project_managementcCst|ttSN)rget_app_service_PROJECT_MANAGEMENT_ATTRIBUTE_ProjectManagementServiceappr /var/www/snowflake_co_dev_github/snow_flake_back_end_deploy/env/lib/python3.10/site-packages/firebase_admin/project_management.py_get_project_management_service#srcCt|t|dS)zObtains a reference to an Android app in the associated Firebase project. Args: app_id: The app ID that identifies this Android app. app: An App instance (optional). Returns: AndroidApp: An ``AndroidApp`` instance. app_idservice) AndroidApprrr r r r android_app' rcCr)zObtains a reference to an iOS app in the associated Firebase project. Args: app_id: The app ID that identifies this iOS app. app: An App instance (optional). Returns: IOSApp: An ``IOSApp`` instance. r)IOSApprrr r r ios_app4rrcC t|S)zLists all Android apps in the associated Firebase project. Args: app: An App instance (optional). Returns: list: a list of ``AndroidApp`` instances referring to each Android app in the Firebase project. )rlist_android_appsr r r r rAs rcCr)zLists all iOS apps in the associated Firebase project. Args: app: An App instance (optional). Returns: list: a list of ``IOSApp`` instances referring to each iOS app in the Firebase project. )r list_ios_appsr r r r rNs rcCt|||S)alCreates a new Android app in the associated Firebase project. Args: package_name: The package name of the Android app to be created. display_name: A nickname for this Android app (optional). app: An App instance (optional). Returns: AndroidApp: An ``AndroidApp`` instance that is a reference to the newly created app. )rcreate_android_app) package_name display_namer r r r rZ rcCr)aRCreates a new iOS app in the associated Firebase project. Args: bundle_id: The bundle ID of the iOS app to be created. display_name: A nickname for this iOS app (optional). app: An App instance (optional). Returns: IOSApp: An ``IOSApp`` instance that is a reference to the newly created app. )rcreate_ios_app) bundle_idrr r r r r!hr r!cCs$|dus t|tr |St|d)Nz must be a string. isinstancestr ValueErrorobj field_namer r r _check_is_string_or_nonevsr*cCs t|tr |r |St|d)Nz must be a non-empty string.r#r'r r r _check_is_nonempty_string|sr+cCs|durdSt||Sr)r+r'r r r !_check_is_nonempty_string_or_nones r,cCs|dur t|d|S)Nz cannot be None.)r&r'r r r _check_not_nonesr-c@sTeZdZdZddZeddZddZdd Zd d Z d d Z ddZ ddZ dS)ra!A reference to an Android app within a Firebase project. Note: Unless otherwise specified, all methods defined in this class make an RPC. Please use the module-level function ``android_app(app_id)`` to obtain instances of this class instead of instantiating it directly. cC||_||_dSr_app_id_serviceselfrrr r r __init__ zAndroidApp.__init__cC|jS)zReturns the app ID of the Android app to which this instance refers. Note: This method does not make an RPC. Returns: string: The app ID of the Android app to which this instance refers. r0r3r r r r zAndroidApp.app_idcC|j|jS)a&Retrieves detailed information about this Android app. Returns: AndroidAppMetadata: An ``AndroidAppMetadata`` instance. Raises: FirebaseError: If an error occurs while communicating with the Firebase Project Management Service. )r1get_android_app_metadatar0r8r r r get_metadata zAndroidApp.get_metadatacC|j|j|S)ahUpdates the display name attribute of this Android app to the one given. Args: new_display_name: The new display name for this Android app. Returns: NoneType: None. Raises: FirebaseError: If an error occurs while communicating with the Firebase Project Management Service. )r1set_android_app_display_namer0r3new_display_namer r r set_display_name zAndroidApp.set_display_namecCr:)zFRetrieves the configuration artifact associated with this Android app.)r1get_android_app_configr0r8r r r get_configzAndroidApp.get_configcCr:)a5Retrieves the entire list of SHA certificates associated with this Android app. Returns: list: A list of ``SHACertificate`` instances. Raises: FirebaseError: If an error occurs while communicating with the Firebase Project Management Service. )r1get_sha_certificatesr0r8r r r rGr=zAndroidApp.get_sha_certificatescCr>)awAdds a SHA certificate to this Android app. Args: certificate_to_add: The SHA certificate to add. Returns: NoneType: None. Raises: FirebaseError: If an error occurs while communicating with the Firebase Project Management Service. (For example, if the certificate_to_add already exists.) )r1add_sha_certificater0)r3certificate_to_addr r r rHrCzAndroidApp.add_sha_certificatecCs |j|S)aRemoves a SHA certificate from this Android app. Args: certificate_to_delete: The SHA certificate to delete. Returns: NoneType: None. Raises: FirebaseError: If an error occurs while communicating with the Firebase Project Management Service. (For example, if the certificate_to_delete is not found.) )r1delete_sha_certificate)r3certificate_to_deleter r r rJs z!AndroidApp.delete_sha_certificateN) __name__ __module__ __qualname____doc__r4propertyrr<rBrErGrHrJr r r r rs    rc@s<eZdZdZddZeddZddZdd Zd d Z d S) raA reference to an iOS app within a Firebase project. Note: Unless otherwise specified, all methods defined in this class make an RPC. Please use the module-level function ``ios_app(app_id)`` to obtain instances of this class instead of instantiating it directly. cCr.rr/r2r r r r4r5zIOSApp.__init__cCr6)zReturns the app ID of the iOS app to which this instance refers. Note: This method does not make an RPC. Returns: string: The app ID of the iOS app to which this instance refers. r7r8r r r rr9z IOSApp.app_idcCr:)aRetrieves detailed information about this iOS app. Returns: IOSAppMetadata: An ``IOSAppMetadata`` instance. Raises: FirebaseError: If an error occurs while communicating with the Firebase Project Management Service. )r1get_ios_app_metadatar0r8r r r r<r=zIOSApp.get_metadatacCr>)a`Updates the display name attribute of this iOS app to the one given. Args: new_display_name: The new display name for this iOS app. Returns: NoneType: None. Raises: FirebaseError: If an error occurs while communicating with the Firebase Project Management Service. )r1set_ios_app_display_namer0r@r r r rBrCzIOSApp.set_display_namecCr:)zBRetrieves the configuration artifact associated with this iOS app.)r1get_ios_app_configr0r8r r r rE#rFzIOSApp.get_configN) rLrMrNrOr4rPrr<rBrEr r r r rs   rc@sDeZdZdZddZeddZeddZedd Zd d Z d S) _AppMetadataz9Detailed information about a Firebase Android or iOS app.cCs4t|d|_t|d|_t|d|_t|d|_dS)Nnamerr project_id)r+_namer0r* _display_name _project_id)r3rUrrrVr r r r4+s   z_AppMetadata.__init__cCr6)zThe globally unique, Firebase-assigned identifier of this Android or iOS app. This ID is unique even across apps of different platforms. r7r8r r r r3sz_AppMetadata.app_idcCr6)zThe user-assigned display name of this Android or iOS app. Note that the display name can be None if it has never been set by the user.)rXr8r r r r;sz_AppMetadata.display_namecCr6)zPThe permanent, globally unique, user-assigned ID of the parent Firebase project.)rYr8r r r rVBz_AppMetadata.project_idcCsBt|t|s dS|j|jko |j|jko |j|jko |j|jkSNF)r$typerWrrrVr3otherr r r __eq__Gs  z_AppMetadata.__eq__N) rLrMrNrOr4rPrrrVr_r r r r rT(s    rTcHeZdZdZfddZeddZfddZdd Zd d Z Z S) AndroidAppMetadataz;Android-specific information about an Android Firebase app.c"t||||t|d|_dS)3Clients should not instantiate this class directly.rN)superr4r+ _package_name)r3rrUrrrV __class__r r r4SzAndroidAppMetadata.__init__cCr6)zTThe canonical package name of this Android app as it would appear in the Play Store.)rer8r r r rXrZzAndroidAppMetadata.package_namect|o |j|jkSr)rdr_rr]rfr r r_]s  zAndroidAppMetadata.__eq__cC || Srr_r]r r r __ne__a zAndroidAppMetadata.__ne__cCt|j|j|j|j|jfSr)hashrWrrrVrr8r r r __hash__dszAndroidAppMetadata.__hash__) rLrMrNrOr4rPrr_rlrp __classcell__r r rfr raPs   racr`) IOSAppMetadataz3iOS-specific information about an iOS Firebase app.crb)rcr"N)rdr4r+ _bundle_id)r3r"rUrrrVrfr r r4lrhzIOSAppMetadata.__init__cCr6)zOThe canonical bundle ID of this iOS app as it would appear in the iOS AppStore.)rsr8r r r r"qrZzIOSAppMetadata.bundle_idcrir)rdr_r"r]rfr r r_vszIOSAppMetadata.__eq__cCrjrrkr]r r r rlyrmzIOSAppMetadata.__ne__cCrnr)rorWrrrVr"r8r r r rp|szIOSAppMetadata.__hash__) rLrMrNrOr4rPr"r_rlrprqr r rfr rris   rrc@sreZdZdZdZdZedZedZ dddZ e d d Z e d d Z e d dZddZddZddZdS)SHACertificatezIRepresents a SHA-1 or SHA-256 certificate associated with an Android app.SHA_1SHA_256z^[0-9A-Fa-f]{40}$z^[0-9A-Fa-f]{64}$NcCs\t|dt|d||_||_tj|rtj|_ dStj |r*tj |_ dSt d)aCreates a new SHACertificate instance. Args: sha_hash: A string; the certificate hash for the Android app. name: The fully qualified resource name of this certificate; note that this field should be omitted if the instance is being constructed for the purpose of calling the add_sha_certificate() method on an ``AndroidApp``. Raises: ValueError: If the sha_hash is not a valid SHA-1 or SHA-256 certificate hash. sha_hashrUzHThe supplied certificate hash is neither a valid SHA-1 nor SHA_256 hash.N) r+r,rWlower _sha_hashrt _SHA_1_REmatchru _cert_type _SHA_256_RErvr&)r3rwrUr r r r4s      zSHACertificate.__init__cCr6)zReturns the fully qualified resource name of this certificate, if known. Returns: string: The fully qualified resource name of this certificate, if known; otherwise, the empty string. )rWr8r r r rUszSHACertificate.namecCr6)zbReturns the certificate hash. Returns: string: The certificate hash. )ryr8r r r rwzSHACertificate.sha_hashcCr6)zReturns the type of the SHA certificate encoded in the hash. Returns: string: One of 'SHA_1' or 'SHA_256'. )r|r8r r r cert_typer~zSHACertificate.cert_typecCs2t|tsdS|j|jko|j|jko|j|jkSr[)r$rtrUrwrr]r r r r_s  zSHACertificate.__eq__cCrjrrkr]r r r rlrmzSHACertificate.__ne__cCst|j|j|jfSr)rorUrwrr8r r r rpszSHACertificate.__hash__r)rLrMrNrOrurvrecompilerzr}r4rPrUrwrr_rlrpr r r r rts        rtc@seZdZdZdZdZdZdZdZdZ dZ d Z d Z d d Z d dZddZddZddZddZddZddZddZddZd8d d!Zd8d"d#Zd$d%Zd&d'Zd(d)Zd*d+Zd,d-Zd.d/Zd0d1Zd2d3Z d8d4d5Z!d8d6d7Z"dS)9r zNProvides methods for interacting with the Firebase Project Management Service.zhttps://firebase.googleapis.comdg?g? androidApps packageNameiosAppsbundleIdcCsX|j}|s td||_dtj}|jdtj}tj |j t j d|i|d|_dS)NzProject ID is required to access the Firebase Project Management Service. Either set the projectId option, or use service account credentials. Alternatively, set the GOOGLE_CLOUD_PROJECT environment variable.z Python/Admin/ httpTimeoutzX-Client-Version) credentialbase_urlheaderstimeout)rVr&rYfirebase_admin __version__optionsgetrDEFAULT_TIMEOUT_SECONDSJsonHttpClientrget_credentialr BASE_URL_client)r3r rVversion_headerrr r r r4s  z"_ProjectManagementService.__init__cC|jtjtjt|dSN)platform_resource_nameidentifier_namemetadata_classr)_get_app_metadatar ANDROID_APPS_RESOURCE_NAMEANDROID_APP_IDENTIFIER_NAMErar3rr r r r; z2_ProjectManagementService.get_android_app_metadatacCrr)rr IOS_APPS_RESOURCE_NAMEIOS_APP_IDENTIFIER_NAMErrrr r r rQrz._ProjectManagementService.get_ios_app_metadatacCsRt|dd|d|}|d|}||||d|d|dp#d|d d S) z;Retrieves detailed information about an Android or iOS app.r/v1beta1/projects/-//rrUappId displayNameN projectId)rUrrrV)r+ _make_requestr)r3rrrrpathresponser r r rs   z+_ProjectManagementService._get_app_metadatacC|j||tjddSN)rrAr)_set_display_namer rr3rrAr r r r?  z6_ProjectManagementService.set_android_app_display_namecCrr)rr rrr r r rRrz2_ProjectManagementService.set_ios_app_display_namecCs.d|d|d}d|i}|jd||ddS)z/Sets the display name of an Android or iOS app.rrz?updateMask=displayNamerpatchjsonN)r)r3rrArr request_bodyr r r rsz+_ProjectManagementService._set_display_namecC|jtjtdSN)r app_class) _list_appsr rrr8r r r rz+_ProjectManagementService.list_android_appscCrr)rr rrr8r r r rrz'_ProjectManagementService.list_ios_appscsdjd|dtj}d|}g} |d}|s |S|fdd|D|d }|s7 |Sdjd|d |d tj}d|}q) z>Lists all the Android or iOS apps within the Firebase project./v1beta1/projects/rz ?pageSize=rTappsc3s |] }|ddVqdS)rrNr ).0r rr3r r *sz7_ProjectManagementService._list_apps.. nextPageTokenz ?pageToken=z &pageSize=)rYr MAXIMUM_LIST_APPS_PAGE_SIZErrextend)r3rrrr apps_listrnext_page_tokenr rr rs0     z$_ProjectManagementService._list_appsNcC|jtjtj||tdSN)rr identifierrr) _create_appr rrr)r3rrr r r r7z,_ProjectManagementService.create_android_appcCrr)rr rrr)r3r"rr r r r!?rz(_ProjectManagementService.create_ios_appc Csbt|dd|jd|}||i}|r||d<|jd||d}|d} || } || d|d S) zCreates an Android or iOS app.rrrrpostrrUrr)r*rYr_poll_app_creation) r3rrrrrrrroperation_name poll_responser r r rGs  z%_ProjectManagementService._create_appc CsttjD]8}ttj|}|tj}t|d|}|d|\}}| d}|r=| d} | r6| St j d|dqt d)zVPolls the Long-Running Operation repeatedly until it is done with exponential backoff.z/v1/rdonerz;Polling finished, but the operation terminated in an error.) http_responsezPolling deadline exceeded.) ranger MAXIMUM_POLLING_ATTEMPTSpowPOLL_EXPONENTIAL_BACKOFF_FACTORPOLL_BASE_WAIT_TIME_SECONDStimesleep_body_and_responserr UnknownErrorDeadlineExceededError) r3rcurrent_attempt delay_factorwait_time_secondsrrrrrr r r rYs&      z,_ProjectManagementService._poll_app_creationcC|jtj|dSN)rr)_get_app_configr rrr r r rDmrz0_ProjectManagementService.get_android_app_configcCrr)rr rrr r r rSrsz,_ProjectManagementService.get_ios_app_configcCs4d|d|d}|d|}t|djddS)Nrrz/configrconfigFileContentszutf-8)encoding)rbase64standard_b64decodedecode)r3rrrrr r r rvs z)_ProjectManagementService._get_app_configcCs4d|d}|d|}|dpg}dd|DS)N /v1beta1/projects/-/androidApps//shar certificatescSs g|] }t|d|ddqS)shaHashrU)rwrU)rt)rcertr r r s zB_ProjectManagementService.get_sha_certificates..)rr)r3rrr cert_listr r r rG}s  z._ProjectManagementService.get_sha_certificatescCs<d|d}t|dj}|j}||d}|jd||ddS)NrrrI)rcertTyperr)r-rwrr)r3rrIrrwrrr r r rHs   z-_ProjectManagementService.add_sha_certificatecCs&t|dj}d|}|d|dS)NrKz /v1beta1/delete)r-rUr)r3rKrUrr r r rJs  z0_ProjectManagementService.delete_sha_certificatecCs||||\}}|Sr)r)r3methodurlrbody_r r r rsz'_ProjectManagementService._make_requestc Cs<z |jj|||dWStjjy}zt|d}~ww)N)rrr)rbody_and_responserequestsrRequestExceptionr#handle_platform_error_from_requests)r3rrrerrorr r r rs  z,_ProjectManagementService._body_and_responser)#rLrMrNrOrrrrrrrrrr4r;rQrr?rRrrrrrr!rrrDrSrrGrHrJrrr r r r r sB    r r)NN)rOrrrrrrrrrrrrrrrr!r*r+r,r-rrrTrarrrtr r r r r s8     b8(J