~2SrSSKJr SSKJr SSKJr /SQrSSKrSSKrSSKrSSK r SSK r SSK J r Sr "S S \5r"S S \5r\"\ 5rS rSr\S:Xa\"5 gg)aA mechanism for library configuration. Whenever App Engine library code needs a user-configurable value, it should use the following protocol: 1. Pick a prefix unique to the library module, for example: `mylib`. 2. Call `lib_config.register(prefix, mapping)` with that prefix as the first argument and a dict mapping suffixes to default functions as the second. 3. The `register()` function returns a configuration handle that is unique to this prefix. The configuration handle object has attributes that correspond to each of the suffixes given in the mapping. Call these functions to access the user's configuration value. If the user didn't configure a function, the default function from the mapping is called instead. 4. Document the function name and its signature and semantics. Users that want to provide configuration values should create a module named `appengine_config.py` in the top-level directory of their application and define functions as documented by various App Engine library components in that module. To change the configuration, edit the file and re-deploy the application. When using the SDK, no redeployment is required; the development server will pick up the changes the next time it handles a request. Third party libraries can also use this mechanism. For casual use, calling the `register()` method with a unique prefix is acceptable. For more complex libraries, however, you should instantiate a new `LibConfigRegistry` instance that uses a different module name. Example `appengine_config.py` file:: from somewhere import MyMiddleWareClass def mylib_add_middleware(app): app = MyMiddleWareClass(app) return app Example library use:: from google.appengine.api import lib_config config_handle = lib_config.register( 'mylib', {'add_middleware': lambda app: app}) def add_middleware(app): return config_handle.add_middleware(app) )absolute_import)print_function)unicode_literals)DEFAULT_MODNAMELibConfigRegistry ConfigHandleregistermainN)encodingappengine_configcV\rSrSrSrSrSr\R4Sjr Sr Sr Sr S r g ) r]z3A registry containing library configuration values.c`Xl0UlSUl[R"5Ulg)zConstructor. Args: modname: The module name to be imported. Note: the actual import of this module is deferred until the first time a configuration value is requested through attribute access on a ConfigHandle instance. N)_modname_registrations_module threadingRLock_lock)selfmodnames .lib/googlecloudsdk/appengine/api/lib_config.py__init__LibConfigRegistry.__init__`s&MDDL"DJctURS5(dUS- nURR5 URR U5nUc[ X5nX0RU'URR 5 URU5 U$!URR 5 f=f)aRegisters a set of configuration names. Args: prefix: A shared prefix for the configuration names being registered. If the prefix doesn't end in `_`, that character is appended. mapping: A dict that maps suffix strings to default values. Returns: A `ConfigHandle` instance. You can re-register the same prefix: the mappings are merged, and for duplicate suffixes, the most recent registration is used. _)endswithracquirergetrrelease_update_defaults)rprefixmappinghandles rr LibConfigRegistry.registeros ??3   mfJJ""&&v.f f+&,F# jj G$ M jjs 7BB7cURR5 URbRUR[RR UR 5LaURR5 gU"UR 5 [RUR UlURR5 g![an[U5SRUR 5SRUR 54;ae[5UlUR[RUR 'SnANSnAff=f!URR5 f=f)aTries to import the configuration module if it is not already imported. This function always sets `self._module` to a value that is not `None`; either the imported module (if it was imported successfully) or a placeholder `object()` instance (if an `ImportError` was raised) is used. Other exceptions are not caught. When a placeholder instance is used, the instance is also put in `sys.modules`. This usage allows us to detect when `sys.modules` was changed (as `dev_appserver.py` does when it notices source code changes) and retries the `import_module` in that case, while skipping it (for speed) if nothing has changed. Args: import_func: Used for dependency injection. NzNo module named {}z(import of {} halted; None in sys.modules) rrrsysmodulesr rr! ImportErrorstrformatobject)r import_funcerrs r initializeLibConfigRegistry.initializes " JJ ,, " ,,#++//$--8 8 jj 2DMM"{{4==1  jj2 s8 ' ' 6 6 = =dmm LN N x %)\\ DMM"2 jjs7AE<C "E EA:EEEEE8cURR5 URcURR5 gSUl[ UR R 55nURR5 UHnUR5 M g!URR5 f=f)zDrops the imported configuration module. If the configuration module has not been imported, no operation occurs, and the next operation takes place. N)rrrr!listrvalues _clear_cache)rhandlesr%s rresetLibConfigRegistry.resets  JJ    jjdlT((//12g jj  jjs B#*B##B?c## URR5 [URSS5nU(dURR 5 g[ UR 55nURR 5 [U5nUH%upVURU5(dMXTSU4v M' g!URR 5 f=f7f)aGenerates `(key, value)` pairs from the config module matching prefix. Args: prefix: A prefix string ending in `_`, for example: `mylib_`. Yields: `(key, value)` pairs, where `key` is the configuration name with the prefix removed, and `value` is the corresponding value. __dict__N) rrgetattrrr!r3itemslen startswith)rr#r$r<nskipkeyvalues r_pairsLibConfigRegistry._pairss JJ j$7g  jj7==?#e jj KE    &k5   jjs.C!CC!C1AC!5 C!CC!c`UR5 /nURR5 [URS5(d[ SUR -5 OpUR(d[ SUR -5 OF[ SUR -5 [ S5 [URR55nURR5 [U5Hup#UR5 M g!URR5 f=f)z5Prints information about all registrations to stdout.r:zModule %s.py does not exist.zNo registrations for %s.py.zRegistrations in %s.py:(----------------------------------------N) r0rrhasattrrprintrrr3r<r!sorted_dump)rr6rr%s rrILibConfigRegistry._dumpsOOGJJ  T\\: . . ,t}}<="" +dmm;< '$--78 f t**0023 jjG_  lln% jjs B$DD-)rrrrN)__name__ __module__ __qualname____firstlineno____doc__rr importlib import_moduler0r7rBrI__static_attributes__rrrr]s/; #6$-#:#:#J&!.rrc@\rSrSrSrSrSrSrSrSr Sr S r S r g ) rzA set of configuration for a single library module or package. Public attributes of instances of this class are configuration values. Attributes are dynamically computed (in `__getattr__()`) and cached as regular instance attributes. FcURS5(deXl0Ul0UlX l[ R "5Ulg)zConstructor. Args: prefix: A shared prefix for the configuration names being registered. It must end in `_`. This requirement is enforced by `LibConfigRegistry`. registry: A `LibConfigRegistry` instance. rN)r_prefix _defaults _overrides _registryrrr)rr#registrys rrConfigHandle.__init__s? ??3   LDNDON"DJrcURR5 UR5HAup#URS5(aUR S5(aM3X0R U'MC UR (aUR5 URR5 g!URR5 f=f)zaUpdates the default mappings. Args: mapping: A dict mapping suffix strings to default values. __N) rrr<r>rrX _initialized_update_configsr!)rr$r@rAs rr"ConfigHandle._update_defaultss  JJ *# >>$  CLL$6$6 #s(     jjdjjs A6B--C cURR5 UR(aUR5 URR 5 URR UR5HHupXR;a&[R"SURU-5 M:X RU'MJ SUlURR5 g!URR5 f=f)zUpdates the configuration values. This clears the cached values, initializes the registry, and loads the configuration values from the config module. z!Configuration "%s" not recognizedTN) rrr_r5rZr0rBrWrXloggingwarnrYr!)rr@rAs rr`ConfigHandle._update_configss  JJ     nn!--dll;*# nn $ ,,:DLL3cURR5 UR(dUR5 XR;aURUnO*XR ;aUR UnO [ U5e[XU5 UURR5 $!URR5 f=f)aFDynamic attribute access. Args: suffix: The attribute name. Returns: A configuration values. Raises: AttributeError: If the suffix is not a registered suffix. The first time an attribute is referenced, this method is invoked. The value returned is taken either from the config module or from the registered default. ) rrr_r`rYrXrisetattrr!)rsuffixrAs r __getattr__ConfigHandle.__getattr__Os  JJ      ?? "' ^^ #v&V$$ dE"  jjdjjs A7B..C )rXr_rrYrWrZN) rKrLrMrNrOr_rr"r`r5rIrqrRrSrrrrs,,# "( *rrc,[RX5$)a7Register a set of configurations with the default config module. Args: prefix: A shared prefix for the configuration names being registered. If the prefix doesn't end in `_`, that character is appended. mapping: A dict mapping suffix strings to default values. Returns: A `ConfigHandle` instance. )_default_registryr )r#r$s rr r ts  # #F 44rc [R"[RSS5R S5(dSSKJn UR5(d}UR5cK[S5 [SUR[R"[RS S555 g[S 5 [5 [S 5 g[S 5 [5 [R5 g) a7Dumps the configuration, using a CGI-style request handler. Put this in your `app.yaml` file to enable (you can pick any URL):: - url: /lib_config script: $PYTHON_LIB/google/appengine/api/lib_config.py Note: Unless you are using the SDK, you must be an administrator to use this function. SERVER_SOFTWAREDevrusersNz Status: 302z Location: PATH_INFOz Status: 403 ForbiddenzContent-type: text/plain) r GetEncodedValueosenvironr>googlecloudsdk.appengine.apirzis_current_user_adminget_current_userrGcreate_login_urlrtrIrys rr r s  ! !"**"3R 99CE9J K2  & & ( (    ! ) m k511(2J2J JJ R3)* +   m  k "#'r__main__)rO __future__rrr__all__rPrcr~r(rgooglecloudsdk.core.utilr rr-rrrtr r rKrSrrrs /b'%'  -% MM`@6@H&o6 5B z&r