o Fha@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 Z/var/www/html/loop/nvenv/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 |Std|)Nz{0} must be a string. isinstancestr ValueErrorformatobj field_namer r r _check_is_string_or_nonevsr+cCs t|tr |r |Std|)Nz{0} 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 td||S)Nz{0} cannot be None.)r&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. r1r4r 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. )r2get_android_app_metadatar1r9r 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. )r2set_android_app_display_namer1r4new_display_namer r r set_display_name zAndroidApp.set_display_namecCr;)zFRetrieves the configuration artifact associated with this Android app.)r2get_android_app_configr1r9r 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. )r2get_sha_certificatesr1r9r r r rHr>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.) )r2add_sha_certificater1)r4certificate_to_addr r r rIrDzAndroidApp.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.) )r2delete_sha_certificate)r4certificate_to_deleter r r rKs z!AndroidApp.delete_sha_certificateN) __name__ __module__ __qualname____doc__r5propertyrr=rCrFrHrIrKr 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/rr0r3r r r r5r6zIOSApp.__init__cCr7)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. r8r9r r r rr:z 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. )r2get_ios_app_metadatar1r9r 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. )r2set_ios_app_display_namer1rAr r r rCrDzIOSApp.set_display_namecCr;)zBRetrieves the configuration artifact associated with this iOS app.)r2get_ios_app_configr1r9r r r rF#rGzIOSApp.get_configN) rMrNrOrPr5rQrr=rCrFr 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,_namer1r+ _display_name _project_id)r4rVrrrWr r r r5+s   z_AppMetadata.__init__cCr7)zThe globally unique, Firebase-assigned identifier of this Android or iOS app. This ID is unique even across apps of different platforms. r8r9r r r r3sz_AppMetadata.app_idcCr7)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.)rYr9r r r r;sz_AppMetadata.display_namecCr7)zPThe permanent, globally unique, user-assigned ID of the parent Firebase project.)rZr9r r r rWBz_AppMetadata.project_idcCsBt|t|s dS|j|jko |j|jko |j|jko |j|jkSNF)r$typerXrrrWr4otherr r r __eq__Gs  z_AppMetadata.__eq__N) rMrNrOrPr5rQrrrWr`r r r r rU(s    rUcHeZdZdZfddZeddZfddZdd Zd d Z Z S) AndroidAppMetadataz;Android-specific information about an Android Firebase app.c&tt|||||t|d|_dS)3Clients should not instantiate this class directly.rN)superrbr5r, _package_name)r4rrVrrrW __class__r r r5SzAndroidAppMetadata.__init__cCr7)zTThe canonical package name of this Android app as it would appear in the Play Store.)rfr9r r r rXr[zAndroidAppMetadata.package_namectt||o |j|jkSr)rerbr`rr^rgr r r`]s zAndroidAppMetadata.__eq__cC || Srr`r^r r r __ne__a zAndroidAppMetadata.__ne__cCt|j|j|j|j|jfSr)hashrXrrrWrr9r r r __hash__dszAndroidAppMetadata.__hash__) rMrNrOrPr5rQrr`rmrq __classcell__r r rgr rbPs   rbcra) IOSAppMetadataz3iOS-specific information about an iOS Firebase app.crc)rdr"N)rersr5r, _bundle_id)r4r"rVrrrWrgr r r5lrizIOSAppMetadata.__init__cCr7)zOThe canonical bundle ID of this iOS app as it would appear in the iOS AppStore.)rtr9r r r r"qr[zIOSAppMetadata.bundle_idcrjr)rersr`r"r^rgr r r`vzIOSAppMetadata.__eq__cCrkrrlr^r r r rmyrnzIOSAppMetadata.__ne__cCror)rprXrrrWr"r9r r r rq|ruzIOSAppMetadata.__hash__) rMrNrOrPr5rQr"r`rmrqrrr r rgr rsis   rsc@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_hashrVzHThe supplied certificate hash is neither a valid SHA-1 nor SHA_256 hash.N) r,r-rXlower _sha_hashrv _SHA_1_REmatchrw _cert_type _SHA_256_RErxr&)r4ryrVr r r r5s      zSHACertificate.__init__cCr7)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. )rXr9r r r rVszSHACertificate.namecCr7)zbReturns the certificate hash. Returns: string: The certificate hash. )r{r9r r r ryzSHACertificate.sha_hashcCr7)zReturns the type of the SHA certificate encoded in the hash. Returns: string: One of 'SHA_1' or 'SHA_256'. )r~r9r r r cert_typerzSHACertificate.cert_typecCs2t|tsdS|j|jko|j|jko|j|jkSr\)r$rvrVryrr^r r r r`s  zSHACertificate.__eq__cCrkrrlr^r r r rmrnzSHACertificate.__ne__cCst|j|j|jfSr)rprVryrr9r r r rqszSHACertificate.__hash__r)rMrNrOrPrwrxrecompiler|rr5rQrVryrr`rmrqr r r r rvs        rvc@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 jd|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.zPython/Admin/{0} httpTimeoutzX-Client-Version) credentialbase_urlheaderstimeout)rWr&rZr'firebase_admin __version__optionsgetrDEFAULT_TIMEOUT_SECONDSJsonHttpClientrget_credentialr BASE_URL_client)r4r rWversion_headerrr r r r5s  z"_ProjectManagementService.__init__cC|jtjtjt|dSN)platform_resource_nameidentifier_namemetadata_classr)_get_app_metadatar ANDROID_APPS_RESOURCE_NAMEANDROID_APP_IDENTIFIER_NAMErbr4rr r r r< z2_ProjectManagementService.get_android_app_metadatacCrr)rr IOS_APPS_RESOURCE_NAMEIOS_APP_IDENTIFIER_NAMErsrr r r rRrz._ProjectManagementService.get_ios_app_metadatacCsNt|dd||}|d|}||||d|d|dp!d|dd S) z;Retrieves detailed information about an Android or iOS app.rz/v1beta1/projects/-/{0}/{1}rrVappId displayNameN projectId)rVrrrW)r,r' _make_requestr)r4rrrrpathresponser r r rs    z+_ProjectManagementService._get_app_metadatacC|j||tjddSN)rrBr)_set_display_namer rr4rrBr r r r@  z6_ProjectManagementService.set_android_app_display_namecCrr)rr rrr r r rSrz2_ProjectManagementService.set_ios_app_display_namecCs(d||}d|i}|jd||ddS)z/Sets the display name of an Android or iOS app.z2/v1beta1/projects/-/{0}/{1}?updateMask=displayNamerpatchjsonN)r'r)r4rrBrr request_bodyr r r rs z+_ProjectManagementService._set_display_namecC|jtjtdSN)r app_class) _list_appsr rrr9r r r rz+_ProjectManagementService.list_android_appscCrr)rr rrr9r r r rrz'_ProjectManagementService.list_ios_appscsdj|tj}d|}g} |d}|s |S|fdd|D|d}|s3 |Sdj||tj}d|}q) z>Lists all the Android or iOS apps within the Firebase project.z&/v1beta1/projects/{0}/{1}?pageSize={2}rTappsc3s |] }|ddVqdS)rrNr ).0r rr4r r +sz7_ProjectManagementService._list_apps.. nextPageTokenz4/v1beta1/projects/{0}/{1}?pageToken={2}&pageSize={3})r'rZr MAXIMUM_LIST_APPS_PAGE_SIZErrextend)r4rrrr apps_listrnext_page_tokenr rr rs2     z$_ProjectManagementService._list_appsNcC|jtjtj||tdSN)rr identifierrr) _create_appr rrr)r4rrr r r r8z,_ProjectManagementService.create_android_appcCrr)rr rrr)r4r"rr r r r!@rz(_ProjectManagementService.create_ios_appc Cs^t|dd|j|}||i}|r||d<|jd||d}|d} || } || d|dS) zCreates an Android or iOS app.rz/v1beta1/projects/{0}/{1}rpostrrVrr)r+r'rZr_poll_app_creation) r4rrrrrrrroperation_name poll_responser r r rHs  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/{0}rdonerz;Polling finished, but the operation terminated in an error.) http_responsezPolling deadline exceeded.)ranger MAXIMUM_POLLING_ATTEMPTSpowPOLL_EXPONENTIAL_BACKOFF_FACTORPOLL_BASE_WAIT_TIME_SECONDStimesleepr'_body_and_responserr UnknownErrorDeadlineExceededError) r4rcurrent_attempt delay_factorwait_time_secondsrrrrrr r r rZs&      z,_ProjectManagementService._poll_app_creationcC|jtj|dSN)rr)_get_app_configr rrr r r rEnrz0_ProjectManagementService.get_android_app_configcCrr)rr rrr r r rTssz,_ProjectManagementService.get_ios_app_configcCs.d||}|d|}t|djddS)Nz"/v1beta1/projects/-/{0}/{1}/configrconfigFileContentszutf-8)encoding)r'rbase64standard_b64decodedecode)r4rrrrr r r rws  z)_ProjectManagementService._get_app_configcCs2d|}|d|}|dpg}dd|DS)N'/v1beta1/projects/-/androidApps/{0}/shar certificatescSs g|] }t|d|ddqS)shaHashrV)ryrV)rv)rcertr r r s zB_ProjectManagementService.get_sha_certificates..)r'rr)r4rrr cert_listr r r rH~s  z._ProjectManagementService.get_sha_certificatescCs:d|}t|dj}|j}||d}|jd||ddS)NrrJ)rcertTyperr)r'r.ryrr)r4rrJrryrrr r r rIs   z-_ProjectManagementService.add_sha_certificatecCs&t|dj}d|}|d|dS)NrLz /v1beta1/{0}delete)r.rVr'r)r4rLrVrr r r rKs  z0_ProjectManagementService.delete_sha_certificatecCs||||\}}|Sr)r)r4methodurlrbody_r r r rsz'_ProjectManagementService._make_requestc Cs<z |jj|||dWStjjy}zt|d}~ww)N)rrr)rbody_and_responserequestsrRequestExceptionr#handle_platform_error_from_requests)r4rrrerrorr r r rs  z,_ProjectManagementService._body_and_responser)#rMrNrOrPrrrrrrrrrr5r<rRrr@rSrrrrrr!rrrErTrrHrIrKrrr r r r r sB    r r)NN)rPrrrrrrrrrrrrrrrr!r+r,r-r.rrrUrbrsrvr r r r r s8     b8(J