U ڲg/@sdZddlZddlZddlZddlZddlmZddlmZddl m Z iZ e Z ejjZdZdZdd d d d gZddefd dZddZefddZGdddZGdddZdS)zFirebase Admin SDK for Python.N)DefaultCredentialsError) credentials) __version__z [DEFAULT]ZFIREBASE_CONFIGZdatabaseAuthVariableOverrideZ databaseURLZ httpTimeout projectIdZ storageBucketc Csr|dkrt}t|||}t*|jtkrF|t|j<|W5QRSW5QRX|tkr`tdtd|dS)arInitializes and returns a new App instance. Creates a new App instance using the specified options and the app name. If an instance already exists by the same app name a ValueError is raised. If options are not provided an attempt is made to load the options from the environment. This is done by looking up the ``FIREBASE_CONFIG`` environment variable. If the value of the variable starts with ``"{"``, it is parsed as a JSON object. Otherwise it is treated as a file name and the JSON content is read from the corresponding file. Use this function whenever a new App instance is required. Do not directly invoke the App constructor. Args: credential: A credential object used to initialize the SDK (optional). If none is provided, Google Application Default Credentials are used. options: A dictionary of configuration options (optional). Supported options include ``databaseURL``, ``storageBucket``, ``projectId``, ``databaseAuthVariableOverride``, ``serviceAccountId`` and ``httpTimeout``. If ``httpTimeout`` is not set, the SDK uses a default timeout of 120 seconds. name: Name of the app (optional). Returns: App: A newly initialized instance of App. Raises: ValueError: If the app name is already in use, or any of the provided arguments are invalid. NaJThe default Firebase app already exists. This means you called initialize_app() more than once without providing an app name as the second argument. In most cases you only need to call initialize_app() once. But if you do want to initialize multiple apps, pass a second argument to initialize_app() to give each app a unique name.zFirebase app named "{0}" already exists. This means you called initialize_app() more than once with the same app name as the second argument. Make sure you provide a unique name every time you call initialize_app().) rZApplicationDefaultApp _apps_lockname_apps_DEFAULT_APP_NAME ValueErrorformat) credentialoptionsrappr;/tmp/pip-unpacked-wheel-p0r7i5ii/firebase_admin/__init__.pyinitialize_app#s    rc Cst|tstdt|t4t|j|krPt|j=| W5QRdSW5QRX|jt krltdtd|jdS)zGracefully deletes an App instance. Args: app: The app instance to be deleted. Raises: ValueError: If the app is not initialized. z>Illegal app argument type: "{}". Argument must be of type App.NzqThe default Firebase app is not initialized. Make sure to initialize the default app by calling initialize_app().zFirebase app named "{0}" is not initialized. Make sure to initialize the app by calling initialize_app() with your app name as the second argument.) isinstancerr r typerr getr_cleanupr )rrrr delete_appXs$  rc Csjt|tstdt|t"|tkr>t|W5QRSW5QRX|tkrXtdtd|dS)a%Retrieves an App instance by name. Args: name: Name of the App instance to retrieve (optional). Returns: App: An App instance with the given name. Raises: ValueError: If the specified name is not a string, or if the specified app does not exist. z@Illegal app name argument type: "{}". App name must be a string.zeThe default Firebase app does not exist. Make sure to initialize the SDK by calling initialize_app().zFirebase app named "{0}" does not exist. Make sure to initialize the SDK by calling initialize_app() with your app name as the second argument.N)rstrr r rrr r )rrrrget_appts rc@s*eZdZdZddZd ddZddZdS) _AppOptionsz1A collection of configuration options for an App.cCs6|dkr|}t|ts,tdt|||_dS)NzEIllegal Firebase app options type: {0}. Options must be a dictionary.)_load_from_environmentrdictr r r_options)selfrrrr__init__s z_AppOptions.__init__NcCs|j||S)z2Returns the option identified by the provided key.)rr)rkeydefaultrrrrsz_AppOptions.getc Cstt}|siS|dr"|}nVz"t|d}|}W5QRXWn2tk rv}ztd||W5d}~XYnXzt |}Wn2tk r}ztd||W5d}~XYnXdd| DS)aInvoked when no options are passed to __init__, loads options from FIREBASE_CONFIG. If the value of the FIREBASE_CONFIG environment variable starts with "{" an attempt is made to parse it as a JSON object, otherwise it is assumed to be pointing to a JSON file. {rzUnable to read file {}. {}Nz(JSON string "{0}" is not valid json. {1}cSsi|]\}}|tkr||qSr)_CONFIG_VALID_KEYS).0kvrrr sz6_AppOptions._load_from_environment..) osgetenv_FIREBASE_CONFIG_ENV_VAR startswithopenread Exceptionr r jsonloadsitems)r config_fileZjson_strZ json_fileerrZ json_datarrrrs   ""z"_AppOptions._load_from_environment)N)__name__ __module__ __qualname____doc__rrrrrrrrs rc@sleZdZdZddZeddZeddZedd Z ed d Z ed d Z ddZ ddZ ddZdS)rzThe entry point for Firebase Python SDK. Represents a Firebase app, while holding the configuration and state common to all Firebase APIs. cCsr|rt|tstd|||_t|tjs6td||_t||_ t |_ i|_ t|j dd|_dS)a)Constructs a new App using the provided name and options. Args: name: Name of the application. credential: A credential object. options: A dictionary of configuration options. Raises: ValueError: If an argument is None or invalid. zNIllegal Firebase app name "{0}" provided. App name must be a non-empty string.z_Illegal Firebase credential provided. App must be initialized with a valid credential instance.rFN)rrr r _namerZBase _credentialrr threadingRLock_lock _servicesr_validate_project_idr_project_id_initialized)rrr rrrrrs    z App.__init__cCs$|dk r t|ts td|dS)Nz7Invalid project ID: "{0}". project ID must be a string.)rrr r )cls project_idrrrr?szApp._validate_project_idcCs|jSN)r9rrrrrszApp.namecCs|jSrC)r:rDrrrr szApp.credentialcCs|jSrC)rrDrrrrsz App.optionscCs|js||_d|_|jS)NT)r@_lookup_project_idZ _project_idrDrrrrBs zApp.project_idc Csf|jd}|s6z |jj}Wnttfk r4YnX|sPtjdtjd}t |jd|S)aLooks up the Firebase project ID associated with an App. If a ``projectId`` is specified in app options, it is returned. Then tries to get the project ID from the credential used to initialize the app. If that also fails, attempts to look up the ``GOOGLE_CLOUD_PROJECT`` and ``GCLOUD_PROJECT`` environment variables. Returns: str: A project ID string or None. rZGOOGLE_CLOUD_PROJECTZGCLOUD_PROJECT) rrr:rBAttributeErrorrr)environrr?)rrBrrrrEs   zApp._lookup_project_idc Csv|rt|tstd||jJ|jdkr>td|j||jkrV|||j|<|j|W5QRSQRXdS)a1Returns the service instance identified by the given name. Services are functional entities exposed by the Admin SDK (e.g. auth, database). Each service instance is associated with exactly one App. If the named service instance does not exist yet, _get_service() calls the provided initializer function to create the service instance. The created instance will be cached, so that subsequent calls would always fetch it from the cache. Args: name: Name of the service to retrieve. initializer: A function that can be used to initialize a service for the first time. Returns: object: The specified service instance. Raises: ValueError: If the provided name is invalid, or if the App is already deleted. z>Illegal name argument: "{0}". Name must be a non-empty string.Nz3Service requested from deleted Firebase App: "{0}".)rrr r r=r>r9)rrZ initializerrrr _get_services   zApp._get_servicec CsJ|j:|jD]"}t|drt|jdr|qd|_W5QRXdS)aCleans up any services associated with this App. Checks whether each service contains a close() method, and calls it if available. This is to be called when an App is being deleted, thus ensuring graceful termination of any services started by the App. close__call__N)r=r>valueshasattrrI)rZservicerrrr,s  z App._cleanupN)r5r6r7r8r classmethodr?propertyrr rrBrErHrrrrrrs     r)r8datetimer0r)r;Zgoogle.auth.exceptionsrZfirebase_adminrZfirebase_admin.__about__rr r<rutcnowZ_clockr r+r$rrrrrrrrrs(   5 )