*SrSSKJr SSKrSSKJr SrSrSrSr "S S \ 5r "S S \ 5r "S S\ 5r "SS\ 5r"SS\ 5rg)aPCollection of classes for converting and transforming an input dictionary. Conversions are defined statically using subclasses of SchemaField (Message, Value, RepeatedField) which transform a source dictionary input to the target schema. The source dictionary is expected to be parsed from a JSON representation. Only fields listed in the schema will be converted (i.e. an allowlist). A SchemaField is a recursive structure and employs the visitor pattern to convert an input structure. # Schema to use for transformation SAMPLE_SCHEMA = Message( foo=Value(target_name='bar'), list_of_things=RepeatedField(target_name='bar_list_of_things', element=Value())) # Input dictionary: input_dict = { 'foo': '1234', 'list_of_things': [1, 4, 5], 'some_other_field': "hello" } # To convert: result = SAMPLE_SCHEMA.ConvertValue(input_dict) # The resulting dictionary will be: { 'bar': '1234', 'bar_list_of_things': [1, 4, 5] } Note that both fields were renamed according to the rules in the schema. Fields not listed in the schema will not be copied. In this example, "some_other_field" was not copied. If further transformation is required on the value itself, a converter can be specified, which is simply a function which takes an input value and transforms it according to whatever logic it wants. For example, to convert a string value to an integer value, one could construct a schema as follows: CONVERTER_SCHEMA = Message( foo=Value(target_name='bar', converter=int)) Using the above input dictionary, the result would be: { 'bar': 1234 } )absolute_importN) converterscUR5RS5nUSSRSUSS55-$)zFConvert underscores to lower camel case (e.g. 'foo_bar' --> 'fooBar')._rc3@# UHoR5v M g7fN) capitalize).0parts =lib/googlecloudsdk/appengine/admin/tools/conversion/schema.py -UnderscoreToLowerCamelCase..NsD)$OO--)sN)lowersplitjoin)textpartss r UnderscoreToLowerCamelCaserKs< **,  S !% qBGGD%)DD DDcd[X5(d [SU<S[U5<SU<35eg)Nz Expected a z , but got for value ) isinstance ValueErrortype) source_value expected_types r ValidateTyperQs5 L 0 0 4A484F4@ B CC 1rcJ[X5(a[SU<SU<35eg)NzDid not expect r)rr)rnon_expected_types r ValidateNotTyper"Ys) 00 ,=|L NN1rc^^[T5[T5-nU(aI[UU4SjU55nU(a,UU4SjnUHn[R"U"U55 M! TR5nUR T5 U$)agAttempts to merge the given dictionaries. Warns if a key exists with different values in both dictionaries. In this case, the new_dict value trumps the previous value. Args: old_dict: Existing dictionary. new_dict: New dictionary. Returns: Result of merging the two dictionaries. Raises: ValueError: If the keys in each dictionary are not unique. c3D># UHnTUTU:wdMUv M g7fr )r keynew_dictold_dicts r r(MergeDictionaryValues..qs(>+3&smx}<3+s  c2>SRUTUTUS9$)NzB'{key}' has conflicting values '{old}' and '{new}'. Using '{new}'.)r&oldnew)format)r&r'r(s r FormatKey(MergeDictionaryValues..FormatKeyts,#$*Fs/7}/7}%+%> >r)setloggingwarningcopyupdate)r(r' common_keysconflicting_keysr.conflicting_keyresults`` r MergeDictionaryValuesr9_sr H H -+>+>>> ./ /23. ==?&-- -rc4\rSrSrSrS SjrSrSrSrSr g) SchemaFielda_Transformation strategy from input dictionary to an output dictionary. Each subclass defines a different strategy for how an input value is converted to an output value. ConvertValue() makes a copy of the input with the proper transformations applied. Additionally, constraints about the input structure are validated while doing the transformation. NcXlX lg)zConstructor. Args: target_name: New field name to use when creating an output dictionary. If None is specified, then the original name is used. converter: A function which performs a transformation on the value of the field. N) target_name converter)selfr>r?s r __init__SchemaField.__init__s#NrcFURU5nURU5$)a&Convert an input value using the given schema and converter. This method is not meant to be overwritten. Update _VisitInternal to change the behavior. Args: value: Input value. Returns: Output which has been transformed using the given schema for renaming and converter, if specified. )_VisitInternal_PerformConversion)r@valuer8s r ConvertValueSchemaField.ConvertValues%  'F  " "6 **rc[5e)aShuffles the input value using the renames specified in the schema. Only structural changes are made (e.g. renaming keys, copying lists, etc.). Subclasses are expected to override this. Args: value: Input value. Returns: Output which has been transformed using the given schema. )NotImplementedErrorr@rFs r rDSchemaField._VisitInternals   rcJUR(aURU5$U$)z8Transforms the result value if a converter is specified.)r?)r@r8s r rESchemaField._PerformConversions%)^^4>>& !??r)r?r>NN) __name__ __module__ __qualname____firstlineno____doc__rArGrDrE__static_attributes__r%rr r;r;s +  @rr;c6^\rSrSrSrSU4SjjrSrSrU=r$)MessagezyA message has a collection of fields which should be converted. Expected input type: Dictionary Output type: Dictionary c p>[[U] X5 X0lUR(d [ S5eg)aConstructor. Args: target_name: New field name to use when creating an output dictionary. If None is specified, then the original name is used. converter: A function which performs a transformation on the value of the field. **kwargs: Kwargs where the keys are names of the fields and values are FieldSchemas for each child field. Raises: ValueError: If the message has no child fields specified. zMessage must contain fieldsN)superrWrAfieldsr)r@r>r?kwargs __class__s r rAMessage.__init__s1 '4!+9K ;; 4 55 rc[U[5 0nURR5Hup4X1;aM XnUR=(d Un[ U5nUR U5nXb;aXrU'ML[X&[5(a'[U[5(a[X&U5X&'M[SU-5e U$)z@Convert each child field and put the result in a new dictionary.zTarget key "%s" already exists.) rdictr[itemsr>rrGrr9r)r@rFr8 source_key field_schemar target_key result_values r rDMessage._VisitInternals F$(KK$5$5$7  &l++9zj-j9j!..|[[U] X5 X0lX@lg)aConstructor. Args: target_name: New field name to use when creating an output dictionary. If None is specified, then the original name is used. converter: A function which performs a transformation on the value of the field. key_converter: A function which performs a transformation on the keys. value_converter: A function which performs a transformation on the values. N)rZrqrA key_convertervalue_converter)r@r>r?rtrur]s r rA Map.__init__s  #tk5&*rc[U[5 0nUR5HMup4UR(aURU5nUR(aUR U5nXBU'MO U$r )rr`rartru)r@rFr8r& dict_values r rDMap._VisitInternalsc F ;;=    %  ))*5 Sk ) Mr)rtru) rPrQrRrSrTr ToJsonStringrArDrUrhris@r rqrqs0 "&'44)66+"  rrqc6^\rSrSrSrSU4SjjrSrSrU=r$) RepeatedFieldi!zRepresents a list of nested elements. Each item in the list is copied. The type of each element in the list is specified in the constructor. Expected input type: List Output type: List c>[[U] X5 X0lUR(d [ S5e[ UR[ 5(a [ S5eg)aConstructor. Args: target_name: New field name to use when creating an output dictionary. If None is specified, then the original name is used. converter: A function which performs a transformation on the value of the field. element: A SchemaField element defining the type of every element in the list. The input structure is expected to be homogenous. Raises: ValueError: If an element has not been specified or if the element type is incompatible with a repeated field. z%Element required for a repeated fieldzRepeated maps are not supportedN)rZr|rAelementrrrq)r@r>r?r~r]s r rARepeatedField.__init__*sN -' ?L << > ??$,,$$ 8 99%rc[U[5 /nUH-nURURR U55 M/ U$r )rrnappendr~rG)r@rFr8items r rDRepeatedField._VisitInternalBs; F mmDLL--d34 Mr)r~)NNNrgris@r r|r|!s:0rr|)rT __future__rr1/googlecloudsdk.appengine.admin.tools.conversionrrrr"r9objectr;rWrkrqr|r%rr rso2h'F E CN B5@&5@p1k1h K  "+"J&K&r