?~SrSSKJr SSKJr SSKJr SSKrSSKr"SS\5r"SS \5r "S S \5r g) zBA module that provides parsing utilities for each command example.)absolute_import)division)unicode_literalsNcZ\rSrSrSrSrSrSSjrSSjrSr S r S r SS jr S r S rg)CommandStringParseraeObject which builds and returns all metadata about string and flags. Attributes: command_node: calliope._CommandCommon, The command object that has access to argparse. command_parser: The argparse object for command_node. example_string: The most recently parsed example command string. example_metadata: The metadata gotten from example_string. cFXlURRUlgN) command_node_parsercommand_parser)selfr s 5lib/googlecloudsdk/core/util/command_string_parser.py__init__CommandStringParser.__init__%s$++33DcXl[5UlURU5nU(dgURR USS9nUR 5nUR5HupV[X5S5n[U[5(aURXuU5 M:[U[R5(aURXuU5 MmURXuU5 M UR$)zGets relevant metadata from an example command string. Args: example_command_string: The example command string to be parsed. Returns: An ExampleCommandMetadata object containing the relevant metadata or None if there was a parsing error. NT) raise_error)example_stringExampleCommandMetadataexample_metadataget_parse_argsr parse_argsGetSpecifiedArgsDictitemsgetattr isinstancelist parse_list collections OrderedDict parse_dict parse_others)rexample_command_string parse_inputmetadatafilteredkeyvalue tmp_values rparseCommandStringParser.parse)s124D%%&<=K  ""--kt-LH,,.Hnn& (.i It $ $  . i!8!8 9 9  . )%0'   rNcl[UR55nUSnUSnURX45n URR [ US5U 5n URR SU 5n X:a[UR5n [ US5n URRXU 5n U [U 5-S- nURXS-nU(aSRX%S9OUn[X/UX5nURRU5 U(aURS-$g)aGets metadata from an example command string for a simple dict-type arg. It updates the already existing ExampleCommandMetadata object of the example string with the metadata. Args: dict_arg: The dictionary-type argument to collect metadata about. key: The name of the argument's attribute in the example string's namespace. value: The actual input representing the flag/argument in the example string (e.g --zone, --shielded-secure-boot). prev_stop: Optional. The index in the example string the flag was last seen. count: Optional. The number of times the flag has been seen in the example string. Returns: The index in the example string where parsing stopped if the argument is specified multiple times. r-- {key}_{count}r(countN)rrget_start_searchrindexstrfindlenrfindformatArgumentMetadataradd_arg_metadata stop_index)rdict_argr(r) prev_stopr3 dict_list first_pair last_pair start_search start_index next_start last_valuelast_value_startr= arg_valuescope arg_metadatas rr"CommandStringParser.parse_dictJs.*X^^%&I1J" I((:L%%++C 1 ,> MK$$))$  Mk&&++D+>j  "jB&6,,- x|$j,,22:3=?#c*o5q8j%%kQ,?i>Co$$$:e&ce&02l ,,\: &&** rc URRU5n[US[R5(GatUS:XGa<[ U5S:Ga,[ USR55n[ USR55nUSSnUSSnURU5n URR[U5U 5n URRSU 5n X:a[ UR5n URR[U5U U 5[ [U55-S- n URXS-n [X-X*U 5nURRU5 gSn[!U5HnUUnUR#UX#UUS-5nM! gSn[!U5HnUUnUR%UX#UUS-5nM! g)aGets metadata from an example command string for nested list arguments. This is a helper function for parse_list(). It updates the already existing ExampleCommandMetadata object of the example string with the metadata. Args: list_arg: The list-type argument to collect metadata about. key: The name of the argument's attribute in the example string's namespace. value: The actual input representing the flag/argument in the example string (e.g --zone, --shielded-secure-boot). rr0r.r/N)rr3rr r!r8rrr4r5r6r7r9r;rr<ranger"r)rrNr(r) flag_count first_dict last_dictstartstoprCrDrEr=rHrJr?ivals rrM%CommandStringParser.parse_nested_lists$$**51J(1+{6677 qS]Q.(1+++-. "++-. 1 a }Q,,U3 ))//E LI ((--dK@  $3t7J7J3Kj))//D <0:<#d)n%'() '' qLA '(24  ..|<  z"A #ooc3y!A#F)# iZ !qkOOCY!D !rc [U[5(dURU5nURR [ U5U5nUS:XaUR X5nURR[ U5U5n[X!X%U[[ U55-S- 5nURRU5 gg)aGets metadata from an example string for non list-type/dict-type args. It updates the already existing ExampleCommandMetadata object of the example string with the metadata. Args: other_arg: The non list-type and non dict-type argument to collect metadata about. key: The name of the argument's attribute in the example string's namespace. value: The actual input representing the flag/argument in the example string (e.g --zone, --shielded-secure-boot). r.r0N) rboolr4rr7r6get_enum_valuer5r;r8rr<)r other_argr(r)rCrDrJs rr# CommandStringParser.parse_otherss" i & &**51l'',,S^\Jk  '' @ ''--c)nlKk%cc&1CI4G&G!&KMl ,,\: 'rc4URUSn[U[5(aTUR5UR 5UR SS5UR SS5/nUH nXS;dM UnM [U5U;aUR 5nURS5nUS:waUSURS5OURS5n[U5S:a"SRUS S5R 5OUSR 5nU$) aNGets the input value of an enum argument in the example string. This is a helper function for parse_others(). Args: enum_value: The namespace value of the argument in question. prev_stop: The index in the example string where parsing stopped. Returns: The actual input in the example string representing the argument's value. N-_z --r.= r0) rrr6lowerupperreplacestripr7splitr8join)r enum_valuer?unparsed_stringpossible_versionsversionarg_endarg_lists rr\"CommandStringParser.get_enum_values)))*5O*c""%++-z/?/?/A%--c37%--c379''  %*' :o-'--/o$$U+g:AR-/(7+11#6&,,S17:(ma6GCHHXab\*002RL&&( rcbU(a(URRX5[U5-nO'URRU5[U5-nUS:XaRURRR SS5nURRU5nU[U5-S-nU$)aGets the position to begin searching for an argument's value. This is a helper function for all the parse functions aside from parse(). Args: namespace_name: The value of the argument in namespace's specified_args dictionary. ('INSTANCE_NAMES:1', '--zone', etc) prev_stop: Optional. For recurring flags, where the flag was last seen. Returns: The index in the example string to begin searching. r.rar`r0)rr7r8r namerg)rnamespace_namer?rC command_namecommand_name_starts rr4$CommandStringParser.get_start_search#s"))..~I.)*l))..~>.)*l r&&++33C=l..33LA'#l*;;Q>l rcURRRSS5nURU5nUS:XagU[ U5-S-n[ R "XS5nU$)zGets a list of arguments in a string. (Note: It assumes '$' is not included in the string) Args: string: The string in question. Returns: A list of the arguments from the string. rar`r.Nr0)r rsrgr7r8shlexri)rstringrurvcommand_name_stop args_lists rr"CommandStringParser.get_parse_argsDso$$))11#s;L\2R +S->>A F#567I r)r r rr)rN)r)__name__ __module__ __qualname____firstlineno____doc__rr+r"rrMr#r\r4r__static_attributes__rrrrs;4!B,)\2+h3Ej;<"HBrrc<\rSrSrSrSrSrSrSrSr Sr S r g ) ri]zEncapsulates metadata about entire example command string. Attributes: argument_metadatas: A list containing the metadata for each argument in an example command string. c/Ulgr _argument_metadatasrs rrExampleCommandMetadata.__init__es !Drc:URRU5 g)zvAdds an argument's metadata to comprehensive metadata list. Args: arg_metadata: The argument metadata to be added. N)rappend)rrJs rr<'ExampleCommandMetadata.add_arg_metadatahs  ##L1rc,[URSS9$)z:Returns the metadata for an entire example command string.cUR$r r=xs r?ExampleCommandMetadata.get_argument_metadatas..rs!,,rr()sortedrrs rget_argument_metadatas-ExampleCommandMetadata.get_argument_metadatasps $**0F GGrc[U[5(au[URSS9n[URSS9n[ U5[ U5:wag[ [ UR55HnX$X4:wdM g gg)NcUR$r rrs rr/ExampleCommandMetadata.__eq__..ws rrcUR$r rrs rrrxs1<rsB I&' @&@F -:V-:`%"v%"r