Ѯh`6dZddlZddlZddlZddlZddlZddlmZddlmZddlmZdZ dZ d dZ d d Z d d Z d d Zd!d Zd!d ZdZdZdZdZGddZGddZGddZGddeZGddeZGddZGddZy)"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_managementc@tj|ttSN)rget_app_service_PROJECT_MANAGEMENT_ATTRIBUTE_ProjectManagementServiceapps s/home/www/academy-backend.kofcorporation.com/venv/lib/python3.12/site-packages/firebase_admin/project_management.py_get_project_management_servicer#s  ! !#'DF_ ``c.t|t|S)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 s r android_appr's V-LS-Q RRrc.t|t|S)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)IOSApprrs rios_appr4s )H)M NNrc4t|jS)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 s rrrAs +3 / A A CCrc4t|jS)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 s rrrNs +3 / = = ??rc8t|j||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 s rr r Zs +3 / B B >y, WWrcF|t|tr|St|d)Nz must be a string. isinstancestr ValueErrorobj field_names r_check_is_string_or_noner.vs( {jc*  |#56 77rcFt|tr|r|St|d)Nz must be a non-empty string.r'r+s r_check_is_nonempty_stringr0|s&#s  |#?@ AArc |yt||Sr)r0r+s r!_check_is_nonempty_string_or_noner2s { $S* 55rc&|t|d|S)Nz cannot be None.)r*r+s r_check_not_noner4s {J<'7899 JrcJeZdZdZdZedZdZdZdZ dZ dZ d Z y ) 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. c ||_||_yr_app_id_serviceselfrrs r__init__zAndroidApp.__init__  rc|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. r8r;s rrzAndroidApp.app_id||rcL|jj|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. )r9get_android_app_metadatar8r@s r get_metadatazAndroidApp.get_metadatas}}55dllCCrcN|jj|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. )r9set_android_app_display_namer8r;new_display_names rset_display_namezAndroidApp.set_display_names }}99$,,HXYYrcL|jj|jS)zFRetrieves the configuration artifact associated with this Android app.)r9get_android_app_configr8r@s r get_configzAndroidApp.get_configs}}33DLLAArcL|jj|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. )r9get_sha_certificatesr8r@s rrNzAndroidApp.get_sha_certificates}}11$,,??rcN|jj|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.) )r9add_sha_certificater8)r;certificate_to_adds rrQzAndroidApp.add_sha_certificates }}00?QRRrc8|jj|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.) )r9delete_sha_certificate)r;certificate_to_deletes rrTz!AndroidApp.delete_sha_certificates}}334IJJrN) __name__ __module__ __qualname____doc__r<propertyrrDrIrLrNrQrTrrrrsD  D ZB @ S Krrc8eZdZdZdZedZdZdZdZ y)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. c ||_||_yrr7r:s rr<zIOSApp.__init__r=rc|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@s rrz IOSApp.app_idrArcL|jj|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. )r9get_ios_app_metadatar8r@s rrDzIOSApp.get_metadatarOrcN|jj|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. )r9set_ios_app_display_namer8rGs rrIzIOSApp.set_display_names }}55dllDTUUrcL|jj|jS)zBRetrieves the configuration artifact associated with this iOS app.)r9get_ios_app_configr8r@s rrLzIOSApp.get_config#s}}// ==rN) rVrWrXrYr<rZrrDrIrLr[rrrrs1  @ V>rrcLeZdZdZdZedZedZedZdZ y) _AppMetadataz9Detailed information about a Firebase Android or iOS app.ct|d|_t|d|_t|d|_t|d|_y)Nnamerr" project_id)r0_namer8r. _display_name _project_id)r;rhrr"ris rr<z_AppMetadata.__init__+s>/tV< 0B 5lNS4ZNrc|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@s rrz_AppMetadata.app_id3s ||rc|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.)rkr@s rr"z_AppMetadata.display_name;s !!!rc|jS)zPThe permanent, globally unique, user-assigned ID of the parent Firebase project.)rlr@s rriz_AppMetadata.project_idBsrct|t|sy|j|jk(xrO|j|jk(xr4|j|jk(xr|j |j k(SNF)r(typerjrr"rir;others r__eq__z_AppMetadata.__eq__Gsp%d, ekk)`dkkU\\.I`!!U%7%77`<@OOuO_O_<_ arN) rVrWrXrYr<rZrr"rirur[rrrfrf(sMCO""   arrfcHeZdZdZfdZedZfdZdZdZ xZ S)AndroidAppMetadataz;Android-specific information about an Android Firebase app.cLt|||||t|d|_y)3Clients should not instantiate this class directly.r!N)superr<r0 _package_name)r;r!rhrr"ri __class__s rr<zAndroidAppMetadata.__init__Ss% v|Z@6|^Trc|jS)zTThe canonical package name of this Android app as it would appear in the Play Store.)r{r@s rr!zAndroidAppMetadata.package_nameXs!!!rcXt||xr|j|jk(Sr)rzrur!r;rtr|s rruzAndroidAppMetadata.__eq__]s-u%8!!U%7%77 9rc&|j| Srrurss r__ne__zAndroidAppMetadata.__ne__a;;u%%%rct|j|j|j|j|j fSr)hashrjrr"rir!r@s r__hash__zAndroidAppMetadata.__hash__ds7 ZZd&7&7$J[J[ \^ ^r) rVrWrXrYr<rZr!rurr __classcell__r|s@rrwrwPs0EU ""9&^rrwcHeZdZdZfdZedZfdZdZdZ xZ S)IOSAppMetadataz3iOS-specific information about an iOS Firebase app.cLt|||||t|d|_y)ryr%N)rzr<r0 _bundle_id)r;r%rhrr"rir|s rr<zIOSAppMetadata.__init__ls$ v|Z@3I{Krc|jS)zOThe canonical bundle ID of this iOS app as it would appear in the iOS AppStore.)rr@s rr%zIOSAppMetadata.bundle_idqsrcXt||xr|j|jk(Sr)rzrur%rs rruzIOSAppMetadata.__eq__vs$w~e$J5??)JJrc&|j| Srrrss rrzIOSAppMetadata.__ne__yrrct|j|j|j|j|j fSr)rrjrr"rir%r@s rrzIOSAppMetadata.__hash__|s1TZZd.?.?RVR`R`abbr) rVrWrXrYr<rZr%rurrrrs@rrris1=L K&crrceZdZdZdZdZejdZejdZ ddZ e dZ e d Z e d Zd Zd Zd Zy)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}$NcTt|dt|d||_|j|_t j j|rt j|_ yt jj|rt j|_ ytd)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_hashrhzHThe supplied certificate hash is neither a valid SHA-1 nor SHA_256 hash.N) r0r2rjlower _sha_hashr _SHA_1_REmatchr _cert_type _SHA_256_RErr*)r;rrhs rr<zSHACertificate.__init__s "(J7)$7 !)  # # ) )( 3,22DO  ' ' - -h 7,44DOZ\ \rc|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. )rjr@s rrhzSHACertificate.nameszzrc|jS)zbReturns the certificate hash. Returns: string: The certificate hash. )rr@s rrzSHACertificate.sha_hashs~~rc|jS)zReturns the type of the SHA certificate encoded in the hash. Returns: string: One of 'SHA_1' or 'SHA_256'. )rr@s r cert_typezSHACertificate.cert_typesrct|tsy|j|jk(xr4|j|jk(xr|j|jk(Srq)r(rrhrrrss rruzSHACertificate.__eq__sM%0 UZZ'2DMMU^^,K2%//1 3rc&|j| Srrrss rrzSHACertificate.__ne__rrcZt|j|j|jfSr)rrhrrr@s rrzSHACertificate.__hash__s TYY t~~>??rr)rVrWrXrYrrrecompilerrr<rZrhrrrurrr[rrrrsS EG ./I"**01K\03 &@rrceZdZdZdZdZdZdZdZdZ dZ d Z d Z d Z d Zd ZdZdZdZdZdZdZdZd"dZd"dZdZdZdZdZdZdZdZdZ d"d Z!d"d!Z"y)#r zNProvides methods for interacting with the Firebase Project Management Service.zhttps://firebase.googleapis.comdg?g? androidApps packageNameiosAppsbundleIdcJ|j}|s td||_dtj}|j j dtj}tj|jjtjd|i||_y)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)rir*rlfirebase_admin __version__optionsgetrDEFAULT_TIMEOUT_SECONDSJsonHttpClientrget_credentialr BASE_URL_client)r;r riversion_headerrs rr<z"_ProjectManagementService.__init__s^^ AB B&()C)C(DE++//-1U1UV#22~~446.77'8  rcl|jtjtjt|SN)platform_resource_nameidentifier_namemetadata_classr)_get_app_metadatar ANDROID_APPS_RESOURCE_NAMEANDROID_APP_IDENTIFIER_NAMErwr;rs rrCz2_ProjectManagementService.get_android_app_metadatas2%%#<#W#W5QQ- & rcl|jtjtjt|Sr)rr IOS_APPS_RESOURCE_NAMEIOS_APP_IDENTIFIER_NAMErrs rr`z._ProjectManagementService.get_ios_app_metadatas2%%#<#S#S5MM) & rct|dd|d|}|jd|}||||d|d|jdxsd|d  S) z;Retrieves detailed information about an Android or iOS app.r/v1beta1/projects/-//rrhappId displayNameN projectId)rhrr"ri)r0 _make_requestr)r;rrrrpathresponses rrz+_ProjectManagementService._get_app_metadatasp!&(3%&<%=QvhG%%eT2 _ %&!G$!m4< , . .rcH|j||tjyN)rrHr)_set_display_namer rr;rrHs rrFz6_ProjectManagementService.set_android_app_display_names% -#<#W#W  YrcH|j||tjyr)rr rrs rrbz2_ProjectManagementService.set_ios_app_display_names% -#<#S#S  UrcFd|d|d}d|i}|jd||y)z/Sets the display name of an Android or iOS app.rrz?updateMask=displayNamerpatchjsonN)r)r;rrHrr request_bodys rrz+_ProjectManagementService._set_display_names9%&<%=QvhF]^%'78  7D|Lists all the Android or iOS apps within the Firebase project./v1beta1/projects/rz ?pageSize=rappsc38K|]}|dyw)rrNr[).0r rr;s r z7_ProjectManagementService._list_apps..*sZcYc'lDIIZs nextPageTokenz ?pageToken=z &pageSize=)rlr MAXIMUM_LIST_APPS_PAGE_SIZErrextend)r;rrrr apps_listrnext_page_tokens` ` rrz$_ProjectManagementService._list_appss!!1!1 2!4J3K:(DDE G %%eT2 <<'D   ZUYZ Z&ll?;O" %T%5%5$6a8N7Oo.6RRSU  ))%6HrNcn|jtjtj||tSN)rr identifierr"r) _create_appr rrr)r;r!r"s rr z,_ProjectManagementService.create_android_app7s5#<#W#W5QQ#%  " "rcn|jtjtj||tSr)rr rrr)r;r%r"s rr$z(_ProjectManagementService.create_ios_app?s5#<#S#S5MM %   rct|dd|jd|}||i}|r||d<|jd||}|d} |j| } || d| S) zCreates an Android or iOS app.r"rrrpostrrhrr)r.rlr_poll_app_creation) r;rrrr"rrrroperation_name poll_responses rrz%_ProjectManagementService._create_appGs !~>#D$4$4#5Q7M6NO'4 *6L '%%fd%F!&)//?  g 6EErcttjD]}ttj|}|tj z}t j|d|}|jd|\}}|jd}|ss|jd} | r| cStjd|tjd)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) r;rcurrent_attempt delay_factorwait_time_secondsrrrrrs rrz,_ProjectManagementService._poll_app_creationYs$%>%W%WX 1O)II?\L ,/H/d/d d  JJ( ).)*D+/+B+B5$+O (M= $$V,D(,,Z8#O --Q"/11 1 ../KLLrcD|jtj|SN)rr)_get_app_configr rrs rrKz0_ProjectManagementService.get_android_app_configms&###<#W#W$ rcD|jtj|Sr)rr rrs rrdz,_ProjectManagementService.get_ios_app_configrs(###<#S#S\b$d drcd|d|d}|jd|}tj|djdS)Nrrz/configrconfigFileContentszutf-8)encoding)rbase64standard_b64decodedecode)r;rrrrs rrz)_ProjectManagementService._get_app_configvsR%&<%=QvhgN%%eT2((2F)GHOOY`Oaarcd|d}|jd|}|jdxsg}|Dcgc]}t|d|dc}Scc}w)N /v1beta1/projects/-/androidApps//shar certificatesshaHashrh)rrh)rrr)r;rrr cert_listcerts rrNz._ProjectManagementService.get_sha_certificates}sY1&>%%eT2LL06B XabPTYd6lKbbbsAcd|d}t|dj}|j}||d}|jd||y)NrrrR)rcertTyperr)r4rrr)r;rrRrrrrs rrQz-_ProjectManagementService.add_sha_certificatesN1&>"#57KLUU&00 #+C  64l;rc^t|dj}d|}|jd|y)NrUz /v1beta1/delete)r4rhr)r;rUrhrs rrTz0_ProjectManagementService.delete_sha_certificates246MNSS4&! 8T*rc2|j|||\}}|Sr)r)r;methodurlrbody_s rrz'_ProjectManagementService._make_requests))&#t<a rc |jj|||S#tjj$r}t j |d}~wwxYw)N)rrr)rbody_and_responserequestsrRequestExceptionr#handle_platform_error_from_requests)r;rrrerrors rrz,_ProjectManagementService._body_and_responsesS D<<11St1T T""33 D<r&s  %'!!6a S O D @ _ X8 B 6  _K_KD5>5>p$a$aP^^2c\c.G@G@TMDMDr