o z@shdZddlmZddlmZddlmZddlZddlZddlZddlm Z ddl m Z ddl m Z dd l mZdd l mZdd lmZdd lmZdd lmZddlmZddlZeZGdddeZGdddeZddZGdddeZ GdddeZ!ddZ"ddZ#ddZ$dd Z%d!d"Z&d#d$Z'd%d&Z(Gd'd(d(ej)Z*d)Z+d*d+Z,d,d-Z-d.d/Z.ej/j0j1j2ej/j0j1j2ej/j0j1j2d0Z3dzd2d3Z4Gd4d5d5eZ5Gd6d7d7eZ6Gd8d9d9eZ7Gd:d;d;eZ8dd?Z:d@Z;dAdBZd|dHdIZ?d}dJdKZ@d~dLdMZAdNdOZBdPdQZCd~dRdSZDdTdUZEdVdWZFdXdYZGdZd[ZHd\d]ZId^d_ZJd`daZK  C 1ddbdcZLd~dddeZMdfdgZNdhdiZOddkdlZPdmdnZQdodpZRejSrbeTneUZVe jWjXeYe jWjZeYe jWj[eVe jWj\eVe jWj]eVe jWj^eUe jWj_eUe jWj`eUe jWjaejbe jWjcede jWjeejfe jWjgeRe jWjhdi ZiddrdsZjd~dtduZkdvdwZlGdxdydyeZmdS)z?Utilities for generating and parsing arguments from API fields.)absolute_import)division)unicode_literalsN)messages)encoding) extra_types) arg_parsers)base)util) properties)resource_property) http_encodingc@seZdZdZdS)ErrorzBase exception for this module.N)__name__ __module__ __qualname____doc__rrK/tmp/google-cloud-sdk/lib/googlecloudsdk/command_lib/util/apis/arg_utils.pyr*src eZdZdZfddZZS)UnknownFieldErrorz>The referenced field could not be found in the message object.c s6tt|d|t|ddd|DdS)Nz6sz-UnknownFieldError.__init__..)superr__init__format_GetFullClassNamejoin all_fields)self field_namemessage __class__rrr2s zUnknownFieldError.__init__rrrrr __classcell__rrr'rr/rcCs2t|tr d|j|jSdt|jt|jS)Nz{}.{}) isinstancetyper rr)objrrrr!9s r!cr)InvalidFieldPathErrorzCThe referenced field path could not be found in the message object.cs"tt|d|t||dS)Nz7Invalid field path [{}] for message [{}]. Details: [{}])rr/rr r!)r$ field_pathr&reasonr'rrrBs zInvalidFieldPathError.__init__r)rrr'rr/?r+r/cr)ArgumentGenerationErrorzGGeneric error when we can't auto generate an argument for an api field.cstt|d||dS)Nz.Failed to generate argument for field [{}]: {})rr2rr )r$r%r1r'rrrKs z ArgumentGenerationError.__init__r)rrr'rr2Hr+r2cCs6|d}|ddD]}t||j}q t||dS)aExtract the field object from the message using a dotted field path. If the field does not exist, an error is logged. Args: message: The apitools message to dig into. field_path: str, The dotted path of attributes and sub-attributes. Returns: The Field object. .N)split _GetFieldr-)r&r0fieldsrrrrGetFieldFromMessageQs r8c Cs0|}|d}t|D]\}}td|}|r"|\}}t|}nd}z||}Wnty;t||t ||w|rK|j sJt||d |n|j r_|t |dkr_t||d |t ||}|rt|rt|t |krr||nd}|s|t |dkrt|tjr|}q t||d ||jjq |S)acExtract the value of the field given a dotted field path. If the field_path does not exist, an error is logged. Args: message: The apitools message to dig into. field_path: str, The dotted path of attributes and sub-attributes. Raises: InvalidFieldPathError: When the path is invalid. Returns: The value or if not set, None. r3z(.+)\[(\d+)\]$Nz5Index cannot be specified for non-repeated field [{}]z3Index needs to be specified for repeated field [{}]z'[{}] is not a valid field on field [{}])r5 enumeraterematchgroupsint field_by_nameKeyErrorr/rrepeatedr lengetattrr,r MessageFieldr-r) r&r0 root_messager7ir index_foundindexfieldrrrGetFieldValueFromMessagecsP         rJcCs|dur t||SdSr)rPyValueToMessage) field_typevaluerrrEncodeToMessages rNc Cs|d}|ddD])}t||}t||j}|s,t||}|r&|g}t||||r2|dn|}q t||dj}t|trGt||}t|t rft |D]\}} t|tret| |set|| ||<qPt||d|dS)zSets the given field in the message object. Args: message: A constructed apitools message object to inject the value into. field_path: str, The dotted path of attributes and sub-attributes. value: The value to set. r3Nr4r) r5rCr6rAr-setattrr,dictrNlistr:) r&r0rMr7r sub_message is_repeatedrLrFitemrrrSetFieldInMessages&       rUcCsP|sdS|}|d}|ddD] }t||d}|sdSq||ddS)zResets the given field in the message object. Args: message: A constructed apitools message object to inject the value into. field_path: str, The dotted path of attributes and sub-attributes. Nr3r4)r5rCreset)r&r0rRr7rrrrResetFieldInMessages  rWcCs|ddS)zGets the child field name from the api field. If api field path is multiple levels deep, return the last field name. i.e. 'x.y.z' would return 'z' Args: api_field: str, full api field path Returns: str, child api field r3r4) rpartition) api_fieldrrrGetChildFieldNames rZcCs&z||WStyt||wr)r?r@r)r&r%rrrr6s    r6c@s eZdZdZdZdZdZdZdS) FieldTypemapr&rIjson json_valueN)rrrMAPMESSAGEFIELDJSON JSON_VALUErrrrr[s r[additionalPropertiescCs2|jtkr|Szt|jtWStyYdSwr)rADDITIONAL_PROPSr8r-rrIrrr_GetAdditionalPropsFields  rgcCs |jtjkSr)r-r JsonValuerfrrr_IsJSONValueTypes ricCstt|tjs tjSt|}|ot|tjo|j}|r t|jdnd}|r+t |r+tj S|r0tj St |r7tj Stj S)zDetermines whether the apitools field is a map, message, or field. Args: field: messages.Field, apitools field instance Returns: FieldType based on the apitools field type and the type of fields it contains. rMN)r,rrDr[rargrAr8r-rirbr_rcr`)rIadditional_props_fieldis_map value_fieldrrr GetFieldTypes&   rm)project projectId projectsIdFcCsZ|dr |dd}|dd}t||d}|s|r|}|s+|r+t|dd}|S)z+Gets the given argument from the namespace.--N-_cSsdSrrrrrr6z"GetFromNamespace..) startswithreplacerCDEFAULT_PARAMSget) namespacearg_namefallback use_defaultsnormalized_arg_namerMrrrGetFromNamespace-s    rc@ eZdZdZddZddZdS)FileTypezz#GenerateChoices..cSg|]}t|qSrEnumNameToChoicerrrrr z#GenerateChoices..) variantchoicesanyvaluessortedkeysrVariantENUMr-names)rI attributesrr choice_maprrrGenerateChoicess   rcCs&|jdurdd|jD}|r|SdS)NcSsg|]}|jr|jqSr)hiddenrrrrrrz)GenerateHiddenChoices..r)rhidden_choicesrrrGenerateHiddenChoicess r store_truecCs|tkp|tjkSr) STORE_TRUErStoreTrueFalseAction)actionrrr_IsStoreBoolActionsrTc Cs|jrt|jtr|j|}n|r|jnd}|jpt|d}|j}|tkr-|r-|s-t }d}|o8|j o8|j du}t|t sCt|t r`|rRt |jdt|j|||}||}||fS|r|rt|t}t|tj} |ss| r|rt |jdt|j||r|}||}||fS| s||krtj|t||t|d}||fSt|trt |jdt|j||krt |jd|||fS)a-Generates the type and action for a flag. Translates the yaml type (or deault apitools type) to python type. If the type is for a repeated field, then a function that turns the input into an apitools message is returned. Args: field: apitools field object flag is associated with attributes: yaml_arg_schema.Argument, data about flag being generated fix_bools: bool, whether to update flags to store_true action Raises: ArgumentGenerationError: user cannot specify action for repeated field ArgumentGenerationError: cannot use a dictionary on a non-repeating field ArgumentGenerationError: append action can only be used for repeated fields Returns: (str) -> Any, a type or function that returns input into correct type action, flag action used with a given type NappendFzJType {0} cannot be used with a custom action. Remove action {1} from spec.) element_typerrz-Type {0} can only be used on repeated fields.z6{0} custom action can only be used on repeated fields.)r-r,rrrTYPESrzrboolrrArrr2rr rrrrArgListrr) rIr fix_bools flag_typerr append_actionrAis_repeatable_message is_arg_listrrrGenerateFlagTypesf           rcCsL|r|}nt|tjrd}n t|tjr|}nd}|r$t|ddSdS)zGets the metavar for specific flag. Args: specified_metavar: str, metavar that is specified by user. flag_type: (str)->None, type function of the flag. flag_name: str, name of the flag Returns: str | None, the flag's metavar Nrsrt)r,rArgDictrr ConvertToAngrySnakeCaserx)specified_metavarr flag_namemetavarrrr GetMetavars   rc Cst|||\}}t|tjrd}d}n t||}t|}|r+|s+|s+|js+t|jd|j }t j |j r5|nd||j s=|nd|pAd|j |j|jd} |jtkrU|j| jd<t|sxt|j||} | rg| | jd<|| jd<|| jd <|rx|| jd <|j s|j| jd <| S) a&Generates a flag for a single field in a message. Args: field: The apitools field object. attributes: yaml_arg_schema.Argument, The attributes to use to generate the arg. fix_bools: True to generate boolean flags as switches that take a value or False to just generate them as regular string flags. category: The help category to put the flag in. Raises: ArgumentGenerationError: When an argument could not be generated from the API field. Returns: calliope.base.Argument, The generated argument. NzqThe field is of an unknown type. You can specify a type function or a processor to manually handle this argument.rqr)categoryr completerhelprdefaultrr-rrrequired)rr,rrrr processorr2rr|r Argument is_positionalrrrr UNSPECIFIEDkwargsrrrr) rIrrrrrrrrargrrrr GenerateFlags@          rcs|jo|du}|r||}nMdr=|jtjjkr#|j}ng}t| |r8fdd|D}nt |}|jtjjkr[|j|rTfdd|D}nt |d}|jrh|sht |t sh|g}|S)a@Coverts the parsed value into something to insert into a request message. If a processor is registered, that is called on the value. If a choices mapping was provided, each value is mapped back into its original value. If the field is an enum, the value will be looked up by name and the Enum type constructed. Args: field: The apitools field object. value: The parsed value. This must be a scalar for scalar fields and a list for repeated fields. repeated: bool, Set to False if this arg was forced to be singular even though the API field it corresponds to is repeated. processor: A function to process the value before putting it into the message. choices: {str: str} A mapping of argument value, to enum API enum value. Returns: The value to insert into the message. FNcsg|]}t|qSr) _MapChoicervrrrrsrz ConvertValue..csg|] }t|dqS) valid_choices) ChoiceToEnumr)trrrrysr)rArrrrrr-rCheckValidEnumNamesrrrr,rQ)rIrMrArr arg_repeated api_namesr)rrrr ConvertValueOs*   rcCs$|dur |d|}n|}t|S)Nrs) format_utilFlagNameFormat)r| flag_prefixrrrr GetFlagNames rcCsFg}t|D]\}}|t|ks|||kr|S|||q|S)z0Gets the long common sub list between two lists.)r:rBr) longest_arrarrnew_arrrFlongest_substr_segrrr_GetCommonPrefixsrcCsB|sdS|dd}|D] }|d}t||}q d|p dS)a<Gets shared parent of api_fields. For a list of fields, find the common parent between them or None. For example, ['a.b.c', 'a.b.d'] would return 'a.b' Args: api_fields: [list], list of api fields that we need to find parent Returns: str | None, shared common parent or None if one is not found Nrr3)r5rr") api_fieldslongest_parentrIsubstrrrrGetSharedParents   rcCs|rt|dnd}g}|D]7}|r||std||||dd}|o-|d}|r:|r:d||f}n|p=|}|rE||q|S)aGets first child for api_fields. For a list of fields, supply the full api_field up through the first child. For example: ['a.b.c', 'a.b.d.e.f'] with shared parent 'a.b' returns children ['a.b.c', 'a.b.d'] Args: api_fields: [str], list of api fields to get children from shared_parent: str | None, the shared parent between all api fields Returns: [str], list of the children api_fields r9rz*Invalid parent: {} does not start with {}.Nr3)rBrw ValueErrorr r5r"r)r shared_parent start_index child_fieldsrYchildren first_childrIrrr_GetFirstChildFieldss   rcCs|D] }||r dSqdS)aGet api fields of arguments when at least one is specified. Args: specified_fields: List[str], list of api fields that have been specified. message_field: str, message field we are determining if specified Returns: bool, whether the message field is specified. TF)rw)specified_fields message_fieldspecified_fieldrrr_IsMessageFieldSpecifieds  rcCs(g}|D] }||r||jq|S)aMGet api fields of arguments when at least arg is specified in namespace. Args: arguments: List[yaml_arg_schema.YAMLArgument], list of arguments we want to see if they are specified. namespace: The parsed command line argument namespace. Returns: List[str] of api_fields that are specified in the namespace. )IsApiFieldSpecifiedextendr) argumentsr{rrrrr_GetSpecifiedApiFieldsInGroups    rcCsR|jr||s dSt|j|jd}t|j|}|D] }t||s&t||qdS)aJClears message fields associated with this mutex ArgGroup. Clearing fields is necessary when using read_modify_update. This prevents more than one field in a mutex group from being sent in a request message. Apitools does not contain information on which fields are mutually exclusive. Therefore, we use the api_fields in the argument group to determine which fields should be mutually exclusive. Args: message: The api message that needs to have fields cleared namespace: The parsed command line argument namespace. arg_group: yaml_arg_schema.ArgGroup, arg N)r) mutexrrrparent_api_fieldrrrrW)r&r{ arg_groupfirst_child_fieldsrrYrrrClearUnspecifiedMutexFieldss  rcCs t|tjr |}|||Sr)r,six string_typeslowerrz)rrMrrrrs  rcCs0t|tr|r |S|r|dSdS|r|gS|S)Nr)r,rQ)rpluralrrr _ListValues rcCs:g}g}|D]}||j|d||q||fS)N)parent_collection)rParentName)refsrparentsrrefrrr _ParseParents(s r cCs |r|n|}t|||Sr) RelativeNamerrC)r pdefault_relative_name default_valrrr _GetParam2s rc s|pi}|}d}t|tsd}|g}|r6|r6|r6|jj|jjkr6t||jj\}}t||t ||d}|r=|r=|j ng} | D]| g} | sUfdd|D} t|t | |qA| D] \} } t|| t | |qcdS)amSet fields in message corresponding to a resource. Args: refs: googlecloudsdk.core.resources.Resource or list, the resource reference. method: the API method. message: apitools Message object. message_resource_map: {str: str}, A mapping of API method parameter name to resource ref attribute, if any request_id_field: str, the name that the ID of the resource arg takes if the API method params and the resource params don't match. use_relative_name: Used ref.RelativeName() if True, otherwise ref.Name(). is_primary_resource: Determines if we should use method.params. TFcsg|]}t|qSr)r)rr r use_relative_namerrrarz,ParseResourceIntoMessage..N) copyr,rQresource_argument_collectiondetailed_paramsrequest_collectionr  full_namerUrparamspopitems) rmethodr&message_resource_maprequest_id_fieldris_primary_resourcerrrrmessage_field_name ref_paramrrrParseResourceIntoMessage7s0   r cCs<|pi}t|D]\}}t||}t||t||q dS)zSet fields in message corresponding to a dict of static field values. Args: message: the Apitools message. static_fields: dict of fields to values. N)r iteritemsr8rUr)r& static_fieldsr0rMrIrrrParseStaticFieldsIntoMessageis  r#c Cst|t|kr |S|j}||j}|jt|krA|}|D]}z|jt|kr6|d|j7}Wn Wq"ty@Yq"wt||||S)a;Sets fields in message based on an existing message. This function is used for get-modify-update pattern. The request type of update requests would be either the same as the response type of get requests or one field inside the request would be the same as the get response. For example: 1) update.request_type_name = ServiceAccount get.response_type_name = ServiceAccount 2) update.request_type_name = updateInstanceRequest updateInstanceRequest.instance = Instance get.response_type_name = Instance If the existing message has the same type as the message to be sent for the request, then return the existing message instead. If they are different, find the field in the message which has the same type as existing_message, then assign exsiting message to that field. Args: message: the apitools message to construct a new request. existing_message: the exsting apitools message returned from server. method: APIMethod, the method to generate request for. Returns: A modified apitools message to be send to the method. r3)r- request_fieldr? message_typer#rAttributeErrorrU)r&existing_messagerr0rInested_message nested_fieldrrrParseExistingMessageIntoMessagews"    r*cs:r fdd|D}ng}|rtdd|dS)zDEnsures the api_name given in the spec matches a value from the API.cs*g|]}|vstt|vs|qSr)ChoiceToEnumNamer text_typerrrrrs z'CheckValidEnumNames..z {} is/are not valid enum values.rN)rArgumentTypeErrorr r")rchoices_values bad_choicesrr-rrsrchoicec Cst|durdSt|}|pdd|D}z||WSty9tdj|t|dddt |Ddw) z6Converts the typed choice into an apitools Enum value.NcSrrrrnrrrrrz ChoiceToEnum..z;Invalid {item}: {selection}. Valid choices are: [{values}].rcss|]}|VqdSrrrrrrrszChoiceToEnum..)rT selectionr) r+rlookup_by_namer@rr.r rr"r)r1 enum_type item_typerrrrrrs"  rcC|ddS)zDConverts a typeable choice to the string representation of the Enum.rsrt)rxupper)r1rrrr+r+cCr8)z:Converts the name of an Enum value into a typeable choice.rtrs)rxrrrrrrr:rFieldscCsi}d}td||jpdtj}|s|S|j|dD]/}td|}|r:|d}|d ||<q!|rP| }|rP| |d}|d|||<q!|S)a6Gets the help text for the fields in the request message. Args: message: The apitools message. section: str, The section to extract help data from. Fields is the default, may also be Values to extract enum data, for example. Returns: {str: str}, A mapping of field name to help text. Nz ^\s+{}:.*$z^\s+(\w+): (.*)$r9rr ) r;searchr r MULTILINEend splitlinesr<groupstriprz)r&section field_helps current_fieldr<line to_append current_textrrr FieldHelpDocss&      rJcs|durg}||vr iS||t|}i}|D]O}d||ji}|j|d<|jtjj krE|j j |d<t |j |d}|rD||d<n |j|d<|jtjj kret|j dfdd |j D|d <|||j<q||S) aGets the recursive representation of a message as a dictionary. Args: message: The apitools message. definitions: A list of message definitions already encountered. Returns: {str: object}, A recursive mapping of field name to its data. N descriptionrAr-) definitionsr7Valuescsi|]}||qSr)rzr2 enum_helprrr1sz+GetRecursiveMessageSpec..r)rrJr#rzrrArrrr`r-rGetRecursiveMessageSpecrrr)r&rLrEdatarI field_datar7rrNrrPs2         rPcCs|o |dp |dS)z@Determines if the given field is output only based on help text.z [Output Only]z @OutputOnly)rwendswith)rrrr IsOutputField9s rTc@seZdZdZdZ          dddZddZd d Zd d Zd dZ ddZ e ddZ e ddZ e ddZe ddZe ddZe ddZe ddZdS) ChoiceEnumMappera<Utility class for mapping apitools Enum messages to argparse choice args. Dynamically builds a base.Argument from an enum message. Derives choice values from supplied enum or an optional custom_mapping dict (see below). Class Attributes: choices: Either a list of strings [str] specifying the commandline choice values or an ordered dict of choice value to choice help string mappings {str -> str} enum: underlying enum whos values map to supplied choices. choice_arg: base.Argument object choice_mappings: Mapping of argparse choice value strings to enum values. custom_mappings: Optional dict mapping enum values to a custom argparse choice value. To maintain compatiblity with base.ChoiceAgrument(), dict can be either: {str-> str} - Enum String value to choice argument value i.e. {'MY_MUCH_LONGER_ENUM_VALUE':'short-arg'} OR {str -> (str, str)} - Enum string value to tuple of (choice argument value, choice help string) i.e. {'MY_MUCH_LONGER_ENUM_VALUE':('short-arg','My short arg help text.')} zcustom_mappings must be a dict of enum string values to argparse argument choices. Choices must be either a string or a string tuple of (choice, choice_help_text): [{}]NFc Cst|tjs td|||_||_||_| |_| dur(t | s(t d| | |_ |j|_ | tj||j|||||| | | d |_dS)aInitialize ChoiceEnumMapper. Args: arg_name: str, The name of the argparse argument to create message_enum: apitools.Enum, the enum to map custom_mappings: See Above. help_str: string, pass through for base.Argument, see base.ChoiceArgument(). required: boolean,string, pass through for base.Argument, see base.ChoiceArgument(). action: string or argparse.Action, string, pass through for base.Argument, see base.ChoiceArgument(). metavar: string, string, pass through for base.Argument, see base.ChoiceArgument().. dest: string, string, pass through for base.Argument, see base.ChoiceArgument(). default: string, string, pass through for base.Argument, see base.ChoiceArgument(). hidden: boolean, pass through for base.Argument, see base.ChoiceArgument(). hidden_choices: list, pass through for base.Argument, see base.ChoiceArgument(). include_filter: callable, function of type string->bool used to filter enum values from message_enum that should be included in choices. If include_filter returns True for a particular enum value, it will be included otherwise it will be excluded. This is ignored if custom_mappings is specified. Raises: ValueError: If no enum is given, mappings are incomplete TypeError: If invalid values are passed for base.Argument or custom_mapping zInvalid Message Enum: [{}]Nz-include_filter must be callable received [{}])help_strrrrdestrrr)r,r _EnumClassrr _arg_name_enum_custom_mappings_hidden_choicescallable TypeError_filter_filtered_enum_ValidateAndParseMappingsr ChoiceArgumentr _choice_arg) r$r| message_enumcustom_mappingsrVrrrrWrrrinclude_filterrrrr]s2 / zChoiceEnumMapper.__init__c s6jrNtjtstjjtddjD}tj|}|r8t dd jd |z Wn<tt fyM Yn.wt jr^fddjD_ddjD_ddtjD_tj_jrtjjst d d jd jd Sd S) aVValidates and parses choice to enum mappings. Validates and parses choice to enum mappings including any custom mappings. Raises: ValueError: custom_mappings does not contain correct number of mapped values. TypeError: custom_mappings is incorrect type or contains incorrect types for mapped values. cSsg|]}|jqSrrrxrrrrsz>ChoiceEnumMapper._ValidateAndParseMappings..zScustom_mappings [{}] may only contain mappings for enum values. invalid values:[{}]rcsg|] }|jr|qSr)r_r)rerrrrs  cSsi|]}t|j|qSr)rrrgrrrrs z>ChoiceEnumMapper._ValidateAndParseMappings..cSsi|]\}}|j|qSrr)rrhyrrrrsz2hidden_choices [{}] must be subset of choices [{}]N)r[r,rPr^_CUSTOM_MAPPING_ERRORr setrZrrr"_ParseCustomMappingsFromTuples_ParseCustomMappingsFromStringsr]r_r`_choice_to_enumrr!_enum_to_choicer_choicesr\ issuperset)r$ enum_stringsdiffrrrrasN       z*ChoiceEnumMapper._ValidateAndParseMappingscCs\i|_i|_t|_tt|jD]\}\}}| ||j|<||j|<||j|<qdS)a Parses choice to enum mappings from custom_mapping with tuples. Parses choice mappings from dict mapping Enum strings to a tuple of choice values and choice help {str -> (str, str)} mapping. Raises: TypeError - Custom choices are not not valid (str,str) tuples. N) rorp collections OrderedDictrqrrr!r[rZ)r$ enum_stringr1rVrrrrms     z/ChoiceEnumMapper._ParseCustomMappingsFromTuplescCsli|_g|_tt|jD]!\}}t|tjs!t|j |j| ||j|<|j |q|j|_ dS)zParses choice to enum mappings from custom_mapping with strings. Parses choice mappings from dict mapping Enum strings to choice values {str -> str} mapping. Raises: TypeError - Custom choices are not strings N)rorqrrr!r[r,rr^rkr rZrrp)r$rw choice_stringrrrrns     z0ChoiceEnumMapper._ParseCustomMappingsFromStringscCs|jt|S)z2Converts an enum value to a choice argument value.)rprzrr,)r$ enum_valuerrrGetChoiceForEnumsz!ChoiceEnumMapper.GetChoiceForEnumcCs |j|S)z1Converts a mapped string choice value to an enum.)rorz)r$ choice_valuerrrGetEnumForChoices z!ChoiceEnumMapper.GetEnumForChoicecC|jSr)rqrrrrrzChoiceEnumMapper.choicescCr}r)rZrrrrenum r~zChoiceEnumMapper.enumcCr}r)r`rrrr filtered_enum r~zChoiceEnumMapper.filtered_enumcCr}r)rcrrrr choice_argr~zChoiceEnumMapper.choice_argcCr}r)rorrrrchoice_mappingsr~z ChoiceEnumMapper.choice_mappingscCr}r)r[rrrrrer~z ChoiceEnumMapper.custom_mappingscCr}r)r_rrrrrfr~zChoiceEnumMapper.include_filter) NNFNNNNFNN)rrrrrkrrarmrnrzr|propertyrrrrrrerfrrrrrU@sB H1      rU)NF)T)TN)NNNr)NNTF)r1N)r;)nr __future__rrrrurr;apitools.base.protorpcliterapitools.base.pyrrgooglecloudsdk.callioperr googlecloudsdk.calliope.conceptsr rgooglecloudsdk.corer googlecloudsdk.core.resourcer googlecloudsdk.core.utilr robjectr Exceptionrrr!r/r2r8rJrNrUrWrZr6Enumr[rergrirmVALUEScorernGetryrrrrrrrrrrrrrrrrrrrrrrr rr r#r*rrr+rPY2longr> _LONG_TYPErDOUBLEfloatFLOATINT64UINT64SINT64INT32UINT32SINT32STRINGr,BOOLrBYTESEncoderr`rrJrPrTrUrrrrs               <  "       N  = 5  &"   24     $'