l,SrSSKJr SSKJr SSKJr SSKJr SSKrSSKJr SSKJ r SS K J r "S S \ 5r S rS rSrSrSSjrSrSrSrSrSrSrg)aUtilities for updating primitive repeated args. This code: from googlecloudsdk.command_lib.util import repeated class UpdateFoo(base.UpdateCommand) @staticmethod def Args(parser): # add "foo" resource arg repeated.AddPrimitiveArgs( parser, 'foo', 'baz-bars', 'baz bars', additional_help='The baz bars allow you to do a thing.') def Run(self, args): client = foos_api.Client() foo_ref = args.CONCEPTS.foo.Parse() foo_result = repeated.CachedResult.FromFunc(client.Get, foo_ref) new_baz_bars = repeated.ParsePrimitiveArgs( args, 'baz_bars', foo_result.GetAttrThunk('bazBars')) if new_baz_bars is not None: pass # code to update the baz_bars Makes a command that works like so: $ cli-tool foos update --set-baz-bars qux,quux [...] $ cli-tool foos update --help [...] These flags modify the member baz bars of this foo. The baz bars allow you to do a thing. At most one of these can be specified: --add-baz-bars=[BAZ_BAR,...] Append the given values to the current baz bars. --clear-baz-bars Empty the current baz bars. --remove-baz-bars=[BAZ_BAR,...] Remove the given values from the current baz bars. --set-baz-bars=[BAZ_BAR,...] Completely replace the current access levels with the given values. [...] )absolute_import)division)print_function)unicode_literalsN) arg_parsers)base)mapc>\rSrSrSrSr\S5rSrS Sjr Sr g) CachedResultNzMemoizer for a function call.cXlSUlgN)thunk_result)selfrs 4lib/googlecloudsdk/command_lib/util/args/repeated.py__init__CachedResult.__init__QsJDLcBU"[R"U/UQ70UD65$r) functoolspartial)clsfuncargskwargss rFromFuncCachedResult.FromFuncUs" y  777 88rc^URcUR5UlUR$)z-Get the result of the function call (cached).rr)rs rGetCachedResult.GetYs# ||ZZ\dl <<rNc4^^^T(aUUU4Sj$UU4Sj$)atReturns a thunk that gets the given attribute of the result of Get(). Examples: >>> class A(object): ... b = [1, 2, 3] >>> CachedResult([A()].pop).GetAttrThunk('b')() [1, 2, 3] >>> CachedResult([A()].pop).GetAttrThunk('b', lambda x: x+1) [2, 3, 4] Args: attr: str, the name of the attribute. Attribute should be iterable. transform: func, one-arg function that, if given, will be applied to every member of the attribute (which must be iterable) before returning it. Returns: zero-arg function which, when called, returns the attribute (possibly transformed) of the result (which is cached). c ^>[[T[TR5T555$r)listr getattrr!)attrr transformsr+CachedResult.GetAttrThunk..vsT#iT)BCDrc8>[TR5T5$r)r&r!)r'rsrr)r*xsWTXXZ.r)rr'r(s```r GetAttrThunkCachedResult.GetAttrThunk_s, DD ..rr r) __name__ __module__ __qualname____firstlineno____doc__r classmethodrr!r-__static_attributes__r,rrr r Ns(%99 /rr cURSS5n[[USU-5U5n[[USU-5U5n[USU-5n[[USU-S5U5n[XVXxU5$)a"Parse the modification to the given repeated resource name field. To be used in combination with AddPrimitiveArgs. This variant assumes the repeated field contains resource names and will use the given resource_parser to convert the arguments to relative names. Args: args: argparse.Namespace of parsed arguments arg_name: string, the (plural) suffix of the argument (snake_case). current_value_thunk: zero-arg function that returns the current value of the attribute to be updated. Will be called lazily if required. resource_parser: one-arg function that returns a resource reference that corresponds to the resource name list to be updated. Raises: ValueError: if more than one arg is set. Returns: List of str: the new value for the field, or None if no change is required. -_remove_add_clear_set_N)replace_ConvertValuesToRelativeNamesr&_ModifyCurrentValue) rarg_namecurrent_value_thunkresource_parserunderscored_nameremoveaddclearr<s rParseResourceNameArgsrG{s*%%c3/ ( dI 001? D&% dF--. A# $#33 4% & dF--t4o G$ V%7J KKrchU(a%UVs/sHo!"U5R5PM nnU$s snfr) RelativeName)namesrBnames rr>r>s2 >C Ded_T " / / 1eE D , Es/cURSS5n[USU-5n[USU-5n[USU-5n[USU-S5n[XEXgU5$)aParse the modification to the given repeated field. To be used in combination with AddPrimitiveArgs; see module docstring. Args: args: argparse.Namespace of parsed arguments arg_name: string, the (plural) suffix of the argument (snake_case). current_value_thunk: zero-arg function that returns the current value of the attribute to be updated. Will be called lazily if required. Raises: ValueError: if more than one arg is set. Returns: List of str: the new value for the field, or None if no change is required. r7r8r9r:r;r<N)r=r&r?)rr@rArCrDrErFr<s rParsePrimitiveArgsrMsq$%%c3/ 4%55 6&f//0# $#33 4% v 00$ 7$ V%7J KKrc .[[[XX#455S:a [S5eUb!U"5nUVs/sH ofU;dM UPM nnO6Ub$U"5nXQVs/sH ofU;dM UPM sn-nOU(a/$UbU$gXu:waU$gs snfs snf)aPPerforms the modification of the current value based on the args. Args: remove: list[str], items to be removed from the current value. add: list[str], items to be added to the current value. clear: bool, whether or not to clear the current value. set_: list[str], items to replace the current value. current_value_thunk: zero-arg function that returns the current value of the attribute to be updated. Will be called lazily if required. Raises: ValueError: if more than one arg is set. Returns: List of str: the new value for the field, or None if no change is required. zAt most one arg can be set.N)sumr bool ValueError)rDrErFr<rA current_valuex new_values rr?r?s" TF- ./!3 2 33 ')M)=Mqf_MI=I ')MC JCqM3IC JJI I  K   >!Ks B B  B*Bc lUn U(a!SRX5n U(aU SU-- n OUn URU 5n U=(d UR5n[X%X5[ X%X5[ X)5/n U(aU R [X%X55 U Hn U RU 5 M g)aAdd arguments for updating a field to the given parser. Adds `--{add,remove,set,clear-` arguments. Args: parser: calliope.parser_extensions.ArgumentInterceptor, the parser to add arguments to. resource_name: str, the (singular) name of the resource being modified (in whatever format you'd like it to appear in help text). arg_name: str, the (plural) argument suffix to use (hyphen-case). property_name: str, the description of the property being modified (plural; in whatever format you'd like it to appear in help text) additional_help: str, additional help text describing the property. metavar: str, the name of the metavar to use (if different from arg_name.upper()). is_dict_args: boolean, True when the primitive args are dict args. auto_group_help: bool, True to generate a summary help. include_set: bool, True to include the (deprecated) set argument. z,These flags modify the member {} of this {}. N) formatadd_mutually_exclusive_groupupper _GetAppendArg _GetRemoveArg _GetClearArgappend _GetSetArg AddToParser)parser resource_namer@ property_nameadditional_helpmetavar is_dict_argsauto_group_help include_setproperties_name group_helpgrouprargs rAddPrimitiveArgsrms8"/?FF(JC/))j J  - -j 9%  'x~~''HEHE8- $ KK 8oLM cOOErc SRU5nSRU5nSRU5nSRU5n[R"U(aUOU[U5U[ XuU5S9$)Nz--add-{}z*Append the given values to the current {}.z --update-{}z3Update the given key-value pairs in the current {}.typerehelprXrArgument _GetArgType _GetArgHelp)r@re prop_namerf list_name list_help dict_name dict_helps rr[r[sr)):AA)L)""8,)CJJ) iY | $ y\ :  <rMr?rmr[r\r_r]rtrur,rrrs0d'%'/(*/6*/ZLD L6$V&(!"'%)!%.b << <6J2r