\SrSSKJr SSKJr SSKJr SSKrSSKrSSKrSSKrSSK J r SSK J r SSK J r SS KJr SS KJr S r\4rS rS rSrSr"SS\ R05r"SS\5r"SS\5r"SS\5r"SS\5r"SS\5r\"5r"SS\5r "SS\5r!"S S!\5r"S"r#S#r$S$r%S%r&S&r'S'r(S(r)S)r*S*r+S+r,g),z;Support functions for the handling of named configurations.)absolute_import)division)unicode_literalsN)config) exceptions)properties_file)encoding)filesNONEdefaultz^[a-z][-a-z0-9]*$config_z^config_([a-z][-a-z0-9]*)$c\rSrSrSrSrg)Error+z4Base class for errors handling named configurations.N__name__ __module__ __qualname____firstlineno____doc____static_attributes__r7lib/googlecloudsdk/core/configurations/named_configs.pyrr+srrc,^\rSrSrSrU4SjrSrU=r$)NamedConfigFileAccessError3z1Raise for errors dealing with file access errors.c b>[[U] SRU[ USU555 g)Nz {0}. {1}strerror)superr__init__formatgetattr)selfmessageexc __class__s rr$#NamedConfigFileAccessError.__init__6s. $d4]5I5Ij#.601rrrrrrrr$r __classcell__r*s@rrr3s911rrc,^\rSrSrSrU4SjrSrU=r$)InvalidConfigName;z/Raise to indicate an invalid named config name.cr>[[U] SRUSR [ 555 g)NzInvalid name [{0}] for a configuration. Except for special cases ({1}), configuration names start with a lower case letter and contain only lower case letters a-z, digits 0-9, and hyphens '-'.,)r#r0r$r%join_RESERVED_CONFIG_NAMES)r'bad_namer*s rr$InvalidConfigName.__init__>s1 T+ $VHchh7M.NO Qrrr,r.s@rr0r0;s7QQrr0c,^\rSrSrSrU4SjrSrU=r$)ReadOnlyConfigurationErrorFzAAn exception for when the active config is read-only (e.g. None).cJ>[[U] SRU55 g)Nz0Properties in configuration [{0}] cannot be set.)r#r9r$r%)r' config_namer*s rr$#ReadOnlyConfigurationError.__init__Is" $d4:AA+NPrrr,r.s@rr9r9FsIPPrr9cF\rSrSrSrSrSrSrSrSr \ S5r S r g ) _FlagOverrideStackNa\Class representing a stack of configuration flag values or `None`s. Each time a command line is parsed (the original, and any from commands calling other commands internally), the new value for the --configuration flag is added to the top of the stack (if it is provided). This is used for resolving the currently active configuration. We need to do quick parsing of the args here because things like logging are used before argparse parses the command line and logging needs properties. We scan the command line for the --configuration flag to get the active configuration before any of that starts. c/UlgN_stackr's rr$_FlagOverrideStack.__init__\s DKrcUR5nURRU5 X!:wa[R 5 gg)z(Add a new value to the top of the stack.N) ActiveConfigrDappendActivePropertiesFile Invalidate)r' config_flagold_flags rPush_FlagOverrideStack.Push_s9  "HKK{#%%'rcLUR[RU55 g)zParse the args and add the value that was found to the top of the stack. Args: args: [str], The command line args for this invocation. N)rNr?_FindFlagValue)r'argss r PushFromArgs_FlagOverrideStack.PushFromArgsfs  II //56rc6URR5$)z$Remove the top value from the stack.)rDpoprEs rPop_FlagOverrideStack.Popns ;;?? rcR[UR5HnU(dM Us $ g)z$Get the top most value on the stack.N)reversedrD)r'values rrH_FlagOverrideStack.ActiveConfigrs$$++&  ' rcSnUS-nSnSn[U5H<nXb:XaUn U$URU5(aURSS5upu U$UnM> U$)zParse the given args to find the value of the --configuration flag. Args: args: [str], The arguments from the command line to parse Returns: str, The value of the --configuration flag or None if not found. z--configuration=N)rZ startswithsplit)clsrRflagflag_eq successorrLarg_s rrQ!_FlagOverrideStack._FindFlagValueys~ DSjGIK~     3*  i rrCN) rrrrrr$rNrSrWrH classmethodrQrrrrr?r?Ns4 (7rr?c|\rSrSrSr\S5r\S Sj5r\S5r\S5r \S5r \S5r S r g ) ConfigurationStorezEClass for performing low level operations on configs and their files.c[SS9$)amGets the currently active configuration. There must always be an active configuration. If there isn't this means no configurations have been created yet and this will auto-create a default configuration. If there are legacy user properties, they will be migrated to the newly created configuration. Returns: Configuration, the currently active configuration. T force_create)rHrrrrHConfigurationStore.ActiveConfigs T **rcJ[R"5Rn[R 5nUR n0nU(a[ [[U:H5U['[R"U5nUHHn[R"[U5nU(dM'URS5n[ XU:H5XH'MJ U$![[4aDn U R [ R":wa[%SR'U5U 5eSn A 0$Sn A ff=f)aReturns all the configurations that exist. This determines the currently active configuration so as a side effect it will create the default configuration if no configurations exist. Args: include_none_config: bool, True to include the NONE configuration in the list. This is a reserved configuration that indicates to not use any configuration. It is not explicitly created but is always available. Returns: {str, Configuration}, A map of configuration name to the configuration object. r_z4List of configurations could not be read from: [{0}]N)rPathsnamed_config_directoryrkrHname Configuration_NO_ACTIVE_CONFIG_NAMEoslistdirrematch_CONFIG_FILE_REGEXgroupOSErrorIOErrorerrnoENOENTrr%) include_none_config config_dir active_configactive_config_nameconfigs config_filesfmrtr)s r AllConfigsConfigurationStore.AllConfigss 66J&335M&++G(5 "8>) $ $  A 6+   022  !6+. 00/11  66[R R U5(d[SRU55e[R"URU5 [RSS9 g![Ra*n[SRXR5U5eSnAff=f)aActivates an existing named configuration. Args: config_name: str, The name of the configuration to activate. Raises: NamedConfigError: If the configuration does not exists. NamedConfigFileAccessError: If there a problem manipulating the configuration files. Trz7Cannot activate configuration [{0}], it does not exist.zYFailed to activate configuration [{0}]. Ensure you have the correct permissions on [{1}]N mark_changed)rrrrrrwrrrr%rrnamed_config_activator_pathrrrJrKrs rActivateConfig!ConfigurationStore.ActivateConfig"s;t< LLNE{2I 22  C 6+    ""  + +[:###6    & ))/<<*>    s1!B&&C$:%CC$c*[USS9 [R"5n[X5nU(a>[R R U5(d[SRU55eU[5:Xa[SRU55eU[5:Xa[SRU55e[X5nU(a>[R R U5(a[SRX55e[R"U5n[R"XE5 [R"U5 g![Ra*n[!SRXR"5U5eSnAff=f) apRenames an existing named configuration. Args: config_name: str, The name of the configuration to rename. new_name: str, The new name of the configuration. Raises: NamedConfigError: If the configuration does not exist, or if the configuration with new_name exists. NamedConfigFileAccessError: If there a problem manipulating the configuration files. Trz5Cannot rename configuration [{0}], it does not exist.zLCannot rename configuration [{0}], it is the currently active configuration.zmCannot rename configuration [{0}], it is currently set as the active configuration in your gcloud properties.z8Cannot rename configuration [{0}], [{1}] already exists.zWFailed to rename configuration [{0}]. Ensure you have the correct permissions on [{1}]N)rrrrrrwrrrr%rrrReadFileContentsrrrrr)r<new_namerr new_file_pathcontentsrs r RenameConfigConfigurationStore.RenameConfigCsP8D9 LLNE{2I 22  A 6+   022  !6+. 00/11  66    sAEF(%F  FrNF) rrrrr staticmethodrHrrrrrrrrrrkrksM + +&&P 7 7D%J%JN77@1 1 rrkc0\rSrSrSrSrSrSrSrSr g) ruixz.A class to encapsulate a single configuration.cdXlX l[U[R"55UlgrB)rtrrrrrr)r'rtrs rr$Configuration.__init__{s IN#D&,,.9DNrcUR(d0$[R"UR/5R5$)aGets the properties defined in this configuration. These are the properties literally defined in this file, not the effective properties based on other configs or the environment. Returns: {str, str}, A dictionary of all properties defined in this configuration file. )rrPropertiesFile AllPropertiesrEs r GetPropertiesConfiguration.GetPropertiess1 >> i  ) )4>>*: ; I I KKrcUR(d[UR5e[RR UR5(d$[ SRUR55e[R"URXU5 UR(a[RSS9 gg)aPersists a property to this configuration file. Args: section: str, The section name of the property to set. name: str, The name of the property to set. value: str, The value to set for the given property, or None to unset it. Raises: ReadOnlyConfigurationError: If you are trying to persist properties to the None configuration. NamedConfigError: If the configuration does not exist. z>Cannot set property in configuration [{0}], it does not exist.TrN) rr9rtrwrrrr%rPersistPropertyrrJrK)r'sectionrtr[s rrConfiguration.PersistPropertys >> &tyy 11 77>>$.. ) )  J 6$))  ##DNNG5I ~~%%4%8rc@[RUR5$)z8Mark this configuration as active in the activator file.)rkrrtrEs rActivateConfiguration.Activates  , ,TYY 77r)rrrtN) rrrrrr$rrrrrrrruruxs6: L928rrucb\rSrSrSrSr\R"5r\ S5r \ SSj5r Sr g)rJizEAn interface for loading and caching the active properties from file.Nc[RR5 [R(dO[R "[ R"5R[SS9R/5[l[RR5 [R$![RR5 f=f)zLoads the set of active properties from file. This includes both the installation configuration as well as the currently active configuration file. Returns: properties_file.PropertiesFile, The CloudSDK properties. Frn) rJ_LOCKacquire _PROPERTIESrrrrrinstallation_properties_pathrHrreleaserrrLoadActivePropertiesFile.Loads&&(+ ! - -+:+I+I \\^ 8 8,";$$-I /,0(  ((*  + ++  ((*s A$B22 CcS[lU(a5[R"[R "5R S5 gg)aInvalidate the cached property values. Args: mark_changed: bool, True if we are invalidating because we persisted a change to the installation config, the active configuration, or changed the active configuration. If so, the config sentinel is touched. Nr)rJrrrrrrconfig_sentinel_filers rrKActivePropertiesFile.Invalidates1(,$""6<<>#F#FKrrr) rrrrrr threadingRLockrrrrKrrrrrJrJs>M+ // %,,& L LrrJcR[5nU(d [U5n[US5$)a;Gets the currently active configuration. There must always be an active configuration. If there isn't this means no configurations have been created yet and this will auto-create a default configuration. If there are legacy user properties, they will be migrated to the newly created configuration. Args: force_create: bool, If False and if there are no legacy properties, the new default configuration won't actually be created. We just pretend that it exists, which is sufficient since it is empty. We do this to avoid always creating the configuration when properties are just trying to be read. This should only be set to False when seeing a PropertiesFile object. All other operations must actually create the configuration. Returns: Configuration, the currently active configuration. T)r_CreateDefaultConfigru)ror<s rrHrHs((+,+ &|4K {D ))rcr[R5nU(d [5nU(d [5nU$)a Gets the currently active configuration. It checks (in order): - Flag values - Environment variable values - The value set in the activator file Returns: str, The name of the active configuration or None if no location declares an active configuration. )FLAG_OVERRIDE_STACKrH_ActiveConfigNameFromEnvr)r<s rrrs.$002+ *,K +-K rcj[R"[R[R S5$)zGets the currently active configuration according to the environment. Returns: str, The name of the active configuration or None. N)r GetEncodedValuerwenvironrCLOUDSDK_ACTIVE_CONFIG_NAMErrrrrs(  ! !jj&44d <n[SRU[R"5R5U5eSnAff=f)zGets the name of the user's active named config according to the file. Returns: str, The name of the active configuration or None. FTrzActive configuration name could not be read from: [{0}]. Ensure you have sufficient read permissions on required active configuration in [{1}]N) rrrrrr_IsValidConfigNameMissingFileErrorrrr%rsrwr)r is_invalidr<r)s rrrs  3 3$*C--d3K K = IIdO   $ $    C $  flln;; >%;; < < ;5A l5778$%8%@ $$[D$$U%F%F%8 :    Q $ ((.u/K/K(La QQQsB2CD #%DD zg# This properties file has been superseded by named configurations. # Editing it will have no effect. c2Sn[RRUR5(af[R "UR5nUR [5(aSnU$[R"UR[U-5 U$)aGets the contents of the legacy properties to include in a new config. If the properties have already been imported, this returns nothing. If not, this will return the old properties and mark the old file as deprecated. Args: paths: config.Paths, The instantiated Paths object to use to calculate the location. Returns: str, The contents of the legacy properties file or ''. r) rwrruser_properties_pathrrr`_LEGACY_DEPRECATION_MESSAGEr)rrs rrrs(WW^^E..//**5+E+EFH677h /""5#=#=#>#IK /r)-r __future__rrrrrwryrgooglecloudsdk.corerr"googlecloudsdk.core.configurationsrgooglecloudsdk.core.utilr r rrvr5rrrr{rrrr0r9objectr?rrkrurJrHrrrrrrrrrrrrrsB&' &*>-8 02/2=J  =?u?1!11Q(QPPIIX)*X X v18F18h%L6%LP*:(<D9(& )"Jr