U ڲga@s"dZddlZddlZddlZddlZddlZddlmZddlmZddlmZdZ ddZ d+d d Z d,d d Z d-d dZ d.ddZd/ddZd0ddZddZddZddZddZGdddZGdd d ZGd!d"d"ZGd#d$d$eZGd%d&d&eZGd'd(d(ZGd)d*d*ZdS)1zFirebase Project Management module. This module enables management of resources in Firebase projects, such as Android and iOS apps. N) exceptions) _http_client)_utilsZ_project_managementcCst|ttSN)rZget_app_service_PROJECT_MANAGEMENT_ATTRIBUTE_ProjectManagementServiceappr E/tmp/pip-unpacked-wheel-p0r7i5ii/firebase_admin/project_management.py_get_project_management_service#sr cCst|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) AndroidAppr rr r r r android_app's rcCst|t|dS)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 )IOSAppr rr r r ios_app4s rcCs 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. )r list_android_appsrr r r rAs rcCs t|S)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_appsrr r r rNs rcCst|||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. )r create_android_app) package_name display_namer r r r rZs rcCst|||S)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. )r create_ios_app) bundle_idrr r r r rhs rcCs(|dkst|tr|Std|dS)Nz{0} must be a string. isinstancestr ValueErrorformatobj field_namer r r _check_is_string_or_nonevsr$cCs$t|tr|r|Std|dS)Nz{0} must be a non-empty string.rr!r r r _check_is_nonempty_string|sr%cCs|dkr dSt||Sr)r%r!r r r !_check_is_nonempty_string_or_nonesr&cCs|dkrtd||S)Nz{0} cannot be None.)rr 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. cCs||_||_dSr_app_id_serviceselfrrr r r __init__szAndroidApp.__init__cCs|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. r)r,r r r rs zAndroidApp.app_idcCs|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. )r*get_android_app_metadatar)r/r r r get_metadatas zAndroidApp.get_metadatacCs|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. )r*set_android_app_display_namer)r,new_display_namer r r set_display_names zAndroidApp.set_display_namecCs|j|jS)zFRetrieves the configuration artifact associated with this Android app.)r*get_android_app_configr)r/r r r get_configszAndroidApp.get_configcCs|j|jS)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. )r*get_sha_certificatesr)r/r r r r8s zAndroidApp.get_sha_certificatescCs|j|j|S)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.) )r*add_sha_certificater))r,certificate_to_addr r r r9s zAndroidApp.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.) )r*delete_sha_certificate)r,certificate_to_deleter r r r;s z!AndroidApp.delete_sha_certificateN) __name__ __module__ __qualname____doc__r-propertyrr1r5r7r8r9r;r 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. cCs||_||_dSrr(r+r r r r-szIOSApp.__init__cCs|jS)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. r.r/r r r rs z IOSApp.app_idcCs|j|jS)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. )r*get_ios_app_metadatar)r/r r r r1s zIOSApp.get_metadatacCs|j|j|S)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. )r*set_ios_app_display_namer)r3r r r r5s zIOSApp.set_display_namecCs|j|jS)zBRetrieves the configuration artifact associated with this iOS app.)r*get_ios_app_configr)r/r r r r7#szIOSApp.get_configN) r=r>r?r@r-rArr1r5r7r 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%_namer)r$ _display_name _project_id)r,rFrrrGr r r r-+s   z_AppMetadata.__init__cCs|jS)zThe globally unique, Firebase-assigned identifier of this Android or iOS app. This ID is unique even across apps of different platforms. r.r/r r r r3sz_AppMetadata.app_idcCs|jS)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.)rIr/r r r r;sz_AppMetadata.display_namecCs|jS)zPThe permanent, globally unique, user-assigned ID of the parent Firebase project.)rJr/r r r rGBsz_AppMetadata.project_idcCsBt|t|sdS|j|jko@|j|jko@|j|jko@|j|jkSNF)rtyperHrrrGr,otherr r r __eq__Gs  z_AppMetadata.__eq__N) r=r>r?r@r-rArrrGrOr r r r rE(s   rEcsHeZdZdZfddZeddZfddZdd Zd d Z Z S) AndroidAppMetadataz;Android-specific information about an Android Firebase app.cs&tt|||||t|d|_dS)3Clients should not instantiate this class directly.rN)superrPr-r% _package_name)r,rrFrrrG __class__r r r-SszAndroidAppMetadata.__init__cCs|jS)zTThe canonical package name of this Android app as it would appear in the Play Store.)rSr/r r r rXszAndroidAppMetadata.package_namecstt||o|j|jkSr)rRrPrOrrMrTr r rO]s zAndroidAppMetadata.__eq__cCs || SrrOrMr r r __ne__aszAndroidAppMetadata.__ne__cCst|j|j|j|j|jfSr)hashrHrrrGrr/r r r __hash__dszAndroidAppMetadata.__hash__) r=r>r?r@r-rArrOrWrY __classcell__r r rTr rPPs   rPcsHeZdZdZfddZeddZfddZdd Zd d Z Z S) IOSAppMetadataz3iOS-specific information about an iOS Firebase app.cs&tt|||||t|d|_dS)rQrN)rRr[r-r% _bundle_id)r,rrFrrrGrTr r r-lszIOSAppMetadata.__init__cCs|jS)zOThe canonical bundle ID of this iOS app as it would appear in the iOS AppStore.)r\r/r r r rqszIOSAppMetadata.bundle_idcstt||o|j|jkSr)rRr[rOrrMrTr r rOvszIOSAppMetadata.__eq__cCs || SrrVrMr r r rWyszIOSAppMetadata.__ne__cCst|j|j|j|j|jfSr)rXrHrrrGrr/r r r rY|szIOSAppMetadata.__hash__) r=r>r?r@r-rArrOrWrYrZr r rTr r[is   r[c@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|r:tj|_ ntj |rPtj |_ nt ddS)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_hashrFzHThe supplied certificate hash is neither a valid SHA-1 nor SHA_256 hash.N) r%r&rHlower _sha_hashr] _SHA_1_REmatchr^ _cert_type _SHA_256_REr_r)r,r`rFr r r r-s       zSHACertificate.__init__cCs|jS)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. )rHr/r r r rFszSHACertificate.namecCs|jS)zbReturns the certificate hash. Returns: string: The certificate hash. )rbr/r r r r`szSHACertificate.sha_hashcCs|jS)zReturns the type of the SHA certificate encoded in the hash. Returns: string: One of 'SHA_1' or 'SHA_256'. )rer/r r r cert_typeszSHACertificate.cert_typecCs2t|tsdS|j|jko0|j|jko0|j|jkSrK)rr]rFr`rgrMr r r rOs   zSHACertificate.__eq__cCs || SrrVrMr r r rWszSHACertificate.__ne__cCst|j|j|jfSr)rXrFr`rgr/r r r rYszSHACertificate.__hash__)N)r=r>r?r@r^r_recompilercrfr-rArFr`rgrOrWrYr r r r r]s      r]c@seZdZdZdZdZdZdZdZdZ dZ d Z d Z d d Z d dZddZddZddZddZddZddZddZddZd8d d!Zd9d"d#Zd$d%Zd&d'Zd(d)Zd*d+Zd,d-Zd.d/Zd0d1Zd2d3Z d:d4d5Z!d;d6d7Z"dS)Lists all the Android or iOS apps within the Firebase project.z&/v1beta1/projects/{0}/{1}?pageSize={2}rtappsc3s|]}|ddVqdS)rr Nr ).0r rr,r r +sz7_ProjectManagementService._list_apps..Z nextPageTokenz4/v1beta1/projects/{0}/{1}?pageToken={2}&pageSize={3})r rJrMAXIMUM_LIST_APPS_PAGE_SIZErrtextend)r,ryrrrZ apps_listrZnext_page_tokenr rr rs,   z$_ProjectManagementService._list_appsNcCs|jtjtj||tdSN)ryrz identifierrr) _create_apprr}r~r)r,rrr r r r8sz,_ProjectManagementService.create_android_appcCs|jtjtj||tdSr)rrrrr)r,rrr r r r@sz(_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}rpostrrFrr )r$r rJr_poll_app_creation) r,ryrzrrrrrroperation_name poll_responser r r rHs  z%_ProjectManagementService._create_appc CsttjD]p}ttj|}|tj}t|d|}| d|\}}| d}|r | d} | rl| St j d|dq t ddS) zVPolls the Long-Running Operation repeatedly until it is done with exponential backoff.z/v1/{0}rtdonerz;Polling finished, but the operation terminated in an error.) http_responsezPolling deadline exceeded.N)rangerMAXIMUM_POLLING_ATTEMPTSpowPOLL_EXPONENTIAL_BACKOFF_FACTORPOLL_BASE_WAIT_TIME_SECONDStimesleepr _body_and_responsertrZ UnknownErrorZDeadlineExceededError) r,rZcurrent_attemptZ delay_factorZwait_time_secondsrrrrrr r r rZs&     z,_ProjectManagementService._poll_app_creationcCs|jtj|dSN)ryr)_get_app_configrr}rr r r r6nsz0_ProjectManagementService.get_android_app_configcCs|jtj|dSr)rrrrr r r rDssz,_ProjectManagementService.get_ios_app_configcCs.d||}|d|}t|djddS)Nz"/v1beta1/projects/-/{0}/{1}/configrtZconfigFileContentszutf-8)encoding)r rbase64standard_b64decodedecode)r,ryrrrr r r rws  z)_ProjectManagementService._get_app_configcCs2d|}|d|}|dp"g}dd|DS)N'/v1beta1/projects/-/androidApps/{0}/shartZ certificatescSs g|]}t|d|ddqS)shaHashrF)r`rF)r])rcertr r r szB_ProjectManagementService.get_sha_certificates..)r rrt)r,rrrZ cert_listr r r r8~s  z._ProjectManagementService.get_sha_certificatescCs:d|}t|dj}|j}||d}|jd||ddS)Nrr:)rZcertTyperr)r r'r`rgr)r,rr:rr`rgrr r r r9s    z-_ProjectManagementService.add_sha_certificatecCs&t|dj}d|}|d|dS)Nr<z /v1beta1/{0}delete)r'rFr r)r,r<rFrr r r r;s  z0_ProjectManagementService.delete_sha_certificatecCs||||\}}|Sr)r)r,methodurlrbody_r r r rsz'_ProjectManagementService._make_requestc CsJz|jj|||dWStjjk rD}zt|W5d}~XYnXdS)N)rrr)rwZbody_and_responserequestsrRequestExceptionrZ#handle_platform_error_from_requests)r,rrrerrorr r r rsz,_ProjectManagementService._body_and_response)N)N)N)N)#r=r>r?r@rvrrrrr}r~rrr-r0rBr|r2rCrrrrrrrrr6rDrr8r9r;rrr r r r rs@    r)N)N)N)N)NN)NN)r@rrhrrrqrrrrr rrrrrrr$r%r&r'rrrErPr[r]rr r r r s6     b8(J