w SrSSKrSSKrSSKrSSKrSSKrSSKJr SSKJr SSKJ r SSK J r \R"SSS /5r \R"S S S /5r"S S\5r"SS\R"S/SQ55r0r0r0r0rSrSrSrSrSrS:SjrSrSrSrS;SjrSr Sr!S;Sjr"Sr#S r$S!r%S"r&"S#S$\ RN5r(S%r)S&r*S'r+S(r,S)r-S*r.S+r/S,r0S-r1\"\.\/5"\Rd5 0r30r4S:S.jr5S:S/jr6SS8r?S>S9jr@g)?z@Common code for converting proto to other formats, such as JSON.N) message_types)messages) protojson) exceptions_Codecencoderdecoder CodecResultvaluecompletec$\rSrSrSrSrSrSrSrg)EdgeType$z'The type of transition made by an edge.N) __name__ __module__ __qualname____firstlineno____doc__SCALARREPEATEDMAP__static_attributes__r3lib/third_party/apitools/base/py/encoding_helper.pyrr$s1 FH Crrc"\rSrSrSrSrSrSrg) ProtoEdge+aA description of a one-level transition from a message to a value. Protobuf messages can be arbitrarily nested as fields can be defined with any "message" type. This nesting property means that there are often many levels of proto messages within a single message instance. This class can unambiguously describe a single step from a message to some nested value. Properties: type_: EdgeType, The type of transition represented by this edge. field: str, The name of the message-typed field. index: Any, Additional data needed to make the transition. The semantics of the "index" property change based on the value of "type_": SCALAR: ignored. REPEATED: a numeric index into "field"'s list. MAP: a key into "field"'s mapping. rcUR[R:Xa UR$SR URUR 5$)Nz{}[{}])type_rrfieldformatindex)selfs r__str__ProtoEdge.__str__?s5 :: (:: ??4::tzz: :rN)rrrrr __slots__r(rrrrr r +s I;rr )r#r$r&c^U4SjnU$)z;Register field_name as a container for unrecognized fields.c>T[U'U$N)_UNRECOGNIZED_FIELD_MAPPINGS)cls field_names rRegister'MapUnrecognizedFields..RegisterOs,6$S) rr)r0r1s` rMapUnrecognizedFieldsr3Ms Orc^^UU4SjnU$)z9Register a custom encoder/decoder for this message class.c*>[TTS9[U'U$N)rr )r_CUSTOM_MESSAGE_CODECS)r/r rs rr1,RegisterCustomMessageCodec..RegisterWs&,Wg&Ns# rrrr r1s`` rRegisterCustomMessageCodecr:Us Orc^^UU4SjnU$)z1Register a custom encoder/decoder for this field.c*>[TTS9[U'U$r6)r_CUSTOM_FIELD_CODECS)r$r rs rr1*RegisterCustomFieldCodec..Register_s&,Wg&NU# rrr9s`` rRegisterCustomFieldCodecr?]s Orc^^UU4SjnU$)z>Register a custom encoder/decoder for all fields of this type.c*>[TTS9[U'U$r6)r_FIELD_TYPE_CODECS) field_typer rs rr1(RegisterFieldTypeCodec..Registergs)/W*.:&rrr9s`` rRegisterFieldTypeCodecrEes Orc>[[U5[U55$)zMake a deep copy of a message.) JsonToMessagetype MessageToJsonmessages rCopyProtoMessagerLns g g(> ??rc`[R5RU5n[X U5$)z"Convert the given message to JSON.)_ProtoJsonApiToolsGetencode_message_IncludeFields)rKinclude_fieldsresults rrIrIss(  # # % 4 4W =F &> ::rcH[R5RX5$)z9Convert the given JSON to a message of type message_type.)rNrOdecode_message) message_typerKs rrGrGys  ! ! # 2 2< IIrcB[U[R"U55$)z?Convert the given dictionary to a message of type message_type.rGjsondumps)drVs r DictToMessager\s tzz!} 55rc@[R"[U55$)z*Convert the given message to a dictionary.rYloadsrIrJs r MessageToDictr` ::mG, --rcUR5nU(a [U5n/nUH#upVURURXVS95 M% U"US9$)z>Convert the given dictionary to an AdditionalProperty message.keyr )additionalProperties)itemssortedappendAdditionalProperty) propertiesadditional_property_type sort_itemsrfmap_rdr s rDictToAdditionalPropertyMessagerns_    Eu  D  ,??@" # $ >>rcB[U[R"U55$)zAConvert the given python value to a message of type message_type.rX)rVr s rPyValueToMessagerps tzz%'8 99rc@[R"[U55$)z,Convert the given message to a python value.r^rJs rMessageToPyValuerrrarc ^^^ TRSS5nSn[U[5(aSSnUH2nU(aUSSUS---- nU[U4SU0U"T5D6S -- nM4 U(a USSU--- nUS - nU$[U[R 5(a[ U5RS -nTRS 5(dURS -U-n[UR5Vs/sHowRPM sn5nUHgn URU 5nU(aUSSUS---- n[XR5n XWRS-[U 4SU0U"T5D6-S -- nMi U(a USSU--- nUS- nU$[U[R5(a*TRS5(a[!U5S:aUSSn[U["R"5(a"U U4SjS["R$5m ["R""UR&UR(UR*UR,UR.UR0UR2T "UR$R5S555n[7U5$s snf)aReturn a repr-style string for a protorpc message. protorpc.Message.__repr__ does not return anything that could be considered python code. Adding this function lets us print a protorpc message in such a way that it could be pasted into code later, and used to compare against other things. Args: msg: protorpc.Message, the message to be repr'd. multiline: bool, True if the returned string should have each field assignment on its own line. **kwargs: {str:str}, Additional flags for how to format the string. Known **kwargs: shortstrings: bool, True if all string values should be truncated at 100 characters, since when mocking the contents typically don't matter except for IDs, and IDs are usually less than 100 characters. no_modules: bool, True if the long module name should not be printed with each type. Returns: str, A string of valid python (assuming the right imports have been made) that recreates the message passed into this function. indentrcL[U5nURSS5S-US'U$)Nrtr)dictget)kwargss r IndentKwargs#MessageToRepr..IndentKwargss*f!::h2Q6x r[  rv multiline,]( no_modules.=) shortstringsdNc8>^\rSrSrUU4SjrU4SjrSrU=r$)$MessageToRepr..SpecialTZInfoc.>[TU]5 Xlgr-)super__init__offset)r'r SpecialTZInfo __class__s rr-MessageToRepr..SpecialTZInfo.__init__smT35$ rct>S[UR5-S-nTRS5(dSU-nU$)NzTimeZoneOffset(rrz apitools.base.protorpclite.util.)reprrrx)r'srys r__repr__-MessageToRepr..SpecialTZInfo.__repr__s9%T[[(99C?zz,//:Q>Ar)r)rrrrrrr __classcell__)rrrys@rrrs %  rr)rx isinstancelist MessageToReprrMessagerHrrrg all_fieldsname field_by_namegetattrsix string_typeslendatetimetzinfoyearmonthdayhourminutesecond microsecond utcoffsetr) msgrryrtrzritemr$namesrr rs ` @rrrs<ZZ! $F #t DTC6A:... C )C-9&-ACEHI IA  f $ $A S#x''(( I   $zz,''$q(A0@A0@u 0@ABD%%d+ETC6A:...C,E c!M%D!*%D.:6.B%DDFIJ JA   f $ $A S#s''(( ::n % %#c(S.ds)C#x(())  HOO  HHcii#((CJJ OO]3::+?+?+BCE 9GBs6J*chUH+nU[U5;a[SU-5e[X5nM- U$)Nz no field "%s")dirKeyErrorr)rK field_pathr$s r _GetFieldrs9 G $?U23 3') NrcNUSSHnURU05nM X US'g)N) setdefault)dictblobrr r$s r _SetFieldrs0CR&&ub1!$Z^rc ~UcU$[R"U5nUHRn[XRS55nSn[ U[ 5(a/n[X4RS5U5 MT [R"U5$![ a( [R"SU<S[U5<35ef=f)z0Add the requested fields to the encoded message.NrzNo field named z in message of type ) rYr_rsplitrrrrInvalidDataErrorrHrrZ)encoded_messagerKrRrSr0r nullvalues rrQrQ s ZZ (F$  0g'7'7'<=EI%&& &**3/;% ::f   0--W /0 0 0s 3B  2B<c[[RU5US5[[R[ U55US5/nUVs/sH o3cMUPM sn$s snfr-)rr=rxrBrH)r$attrrSxs r_GetFieldCodecsrsW$((/t<"&&tE{3T4@F /v!Av // /s A!A!cd^\rSrSrSrSr\S5rU4SjrU4Sjr U4Sjr U4Sjr S r U=r $) rNi$z&JSON encoder used by apitools clients.NcLURc U"5UlUR$r-) _INSTANCE)r/s rrO_ProtoJsonApiTools.Get)s == ECM}}rc>U[;a[URU5$[X5n[[U]X5n[ X25n[X25n[X25$r-) r7r _DecodeCustomFieldNamesrrNrU_ProcessUnknownEnums_ProcessUnknownMessages_DecodeUnknownFields)r'rVrrSrs rrU!_ProtoJsonApiTools.decode_message/sd 1 1)%go6 7(G)4? "%f>(A#F<[US5H,nU"X5nURnUR(dM*Us $ [U[R 5(a2UR UR[R"U55nU$[U[R5(a3[URUS9=(d Un[[U]?X5nU$[[U]?X5nU$![R a& [U["R$5(deSnU$f=f)zDecode the given JSON value. Args: field: a messages.Field for the field we're decoding. value: a python value we'd like to decode. Returns: A value suitable for assignment to field. r  json_nameN)rr r rr MessageFieldrUrVrYrZ EnumFieldGetCustomJsonEnumMappingrHrrN decode_field DecodeErrorrr)r'r$r r rS field_valuers rr_ProtoJsonApiTools.decode_field:s*'ui8GU*FLLE 9 eX22 3 3--""DJJu$57Kx11 2 2, e-605  ##&;;@.H "D77<*D '' #!%)9)9::"  #s C666D0/D0c>^[U[R5(aSSRU4SjU55-$[ U5[ ;a![ [ U5R U5$[U5n[[T]+U5n[X5n[R"[R"U5SS9$)Nz[%s]z, c3F># UHnTRU5v M g7fr-)rP).0rr's r 4_ProtoJsonApiTools.encode_message..]s&'9071(,':':1'='=07s!T) sort_keys)rr FieldListjoinrHr7r_EncodeUnknownFieldsrrNrP_EncodeCustomFieldNamesrYrZr_)r'rKrSrs` rrP!_ProtoJsonApiTools.encode_message[s gx11 2 2TYY'907'99: : =2 2)$w-8@@I I&w/)4?H(9zz$**V,==rc>[US5H,nU"X5nURnUR(dM*Us $ [U[R 5(azUR (aBUVs/sH4n[URURS9=(d URPM6 nnO[URURS9nU(aU$[U[R5(aD[U[R5(d%[R"URU55n[ ["U]KX5$s snf)zEncode the given value as JSON. Args: field: a messages.Field for the field we're encoding. value: a value for field. Returns: A python value suitable for json.dumps. r python_name)rr r rrrrepeatedrrHrrr DateTimeFieldrYr_rPrrN encode_field)r'r$r rrSeremapped_valuers rr_ProtoJsonApiTools.encode_fieldis'ui8GU*FLLE 9 eX// 0 0~~GL"NGL!#;JJAFF#4#>78vv#>GL"N":JJEJJ"8%% uh33 4 4um&A&ABBJJt2259:E';EII"Ns2;E r)rrrrrr classmethodrOrUrrPrrr)rs@rrNrN$s90I =B >JJrrNc[R[U55nUcU$URU5n[ U[ R 5(d[R"S5eURn[ UR[ R 5(a"[U[R"U5U5nO [X5n[XU5 [US05 U$)z;Rewrite unknown fields in message into message.destination.z>Unrecognized fields must be mapped to a compound message type._Message__unrecognized_fields)r.rxrHrrrrrInvalidDataFromServerErrorrVr _DecodeUnknownMessagesrYr__DecodeUnrecognizedFieldssetattr)rKr destination pair_field pair_type new_valuess rrrs.224=AK&&{3J j("7"7 8 833  ''I)//8#8#899+ TZZ0)= /wB  G*- G4b9 NrcnURRn/nUR5Vs/sHoURPM nn[R "U5HTupxXv;aM [ X85n URR(a [U 5n U"XyS9n URU 5 MV U$s snf)z>AFGf..t4FGF--e4F V 77H s!A AA A A10A1c[R"[U55nSn[ X#S9$![a UnSnNf=f)z+Decode the urlsafe base64 value into bytes.TFr)rurlsafe_b64decoderrr ) unused_fieldr rSr s r_SafeDecodeBytesr!sH))#e*5 V 77 s !,==c,U(dU$[R"[R"U55nUR 5Hn[ U[ R5(dM$URU;dM6URUR5nUR(a$[U5[X#R5:wdUbMURURX#R[ RR5 M U$)a:Add unknown enum values from encoded_message as unknown fields. ProtoRPC diverges from the usual protocol buffer behavior here and doesn't allow unknown fields. Throwing on unknown fields makes it impossible to let servers add new enum values and stay compatible with older clients, which isn't reasonable for us. We simply store unrecognized enum values as unknown fields, and all is well. Args: message: Proto message we've decoded thus far. encoded_message: JSON string we're decoding. Returns: message, with any unknown enums stored as unrecognized fields. )rYr_r ensure_strrrrrrget_assigned_valuerrrVariantENUM)rKrdecoded_messager$r s rrrs jj!@AO##% uh00 1 1 o-..uzz:ECJ#ojj6Q2R$RM..JJ ;X=M=M=R=RT & NrcU(dU$[R"[R"U55nUR 5Vs/sHo3R PM sn[ UR55-nUR5Vs/sH nX4;dM UPM nnUH0nURXbU[RR5 M2 U$s snfs snf)aStore any remaining unknown fields as strings. ProtoRPC currently ignores unknown values for which no type can be determined (and logs a "No variant found" message). For the purposes of reserializing, this is quite harmful (since it throws away information). Here we simply add those as unknown fields of type string (so that they can easily be reserialized). Args: message: Proto message we've decoded thus far. encoded_message: JSON string we're decoding. Returns: message, with any remaining unrecognized fields saved. ) rYr_rr#rrrrkeysrrr%STRING)rKrr'rmessage_fieldsmissing_fieldsr0s rrrs jj!@AO&-&8&8&:;&:ff&:;d'')?++N!0!5!5!72!7A0!7N2$ &&z:3N'/'7'7'>'> @% N<2sC CCc$[U[R5(d[R"SU-5eXR 5;a[R "SU<SU<35e[RU05n[SXU5 X$U'g)aAdd a custom wire encoding for a given enum value. This is primarily used in generated code, to handle enum values which happen to be Python keywords. Args: enum_type: (messages.Enum) An enum type python_name: (basestring) Python name for this value. json_name: (basestring) JSON name to be used on the wire. package: (NoneType, optional) No effect, exists for legacy compatibility. z.Cannot set JSON enum mapping for non-enum "%s"z Enum value z not a value for type enumN) issubclassrEnumrTypecheckErrorrr_JSON_ENUM_MAPPINGSr_CheckForExistingMappings) enum_typerrpackagefield_mappingss rAddCustomJsonEnumMappingr7Es i / /'' [U[R5(d[R"SU-5eUR U5n[RU05n[SXU5 X%U'g![ a [R"SU<SU<35ef=f)aAdd a custom wire encoding for a given message field. This is primarily used in generated code, to handle enum values which happen to be Python keywords. Args: message_type: (messages.Message) A message type python_name: (basestring) Python name for this value. json_name: (basestring) JSON name to be used on the wire. package: (NoneType, optional) No effect, exists for legacy compatibility. z2Cannot set JSON field mapping for non-message "%s"zField z not recognized for type r$N) r/rrrr1rrr_JSON_FIELD_MAPPINGSrr3)rVrrr5rr6s rAddCustomJsonFieldMappingr:]s lH$4$4 5 5'' !- ./ /,  & &{ 3 *44\2FNg|)L"+; ,))\ +, ,,s A33)Bc"[USX[S9$)z=Return the appropriate remapping for the given enum, or None.r.rrmappings)_FetchRemappingr2)r4rrs rrrys 9f'2$7 99rc"[USX[S9$)z>Return the appropriate remapping for the given field, or None.r$r<)r>r9)rVrrs rGetCustomJsonFieldMappingr@s <'2$8 ::rcU(a U(a[R"SU-5eU(d"U(d"SU<S35eURU05nU(a\U(aURU5$U(a=U[UR 55;a UVs/sHnXVU:XdM UPM snS$gs snf)z>Common code for fetching a key or value from a remapping dict.z>Cannot specify both python_name and json_name for %s remappingz1Must specify either python_name or json_name for z remappingrN)rrrxrvalues) type_name mapping_typerrr=field_remappingsks rr>r>sy)) !- ./ / 9))    ||Ir2 #'' 4 4 D!1!8!8!:;;#3=#3a+.);#3==>@@ =s * C:Cc US:Xa[nO US:Xa[nW"XS9nUb(XS:wa#[R"SU<SU<SU<S35eU"XS 9nUb)XR:wa#[R"SU<SU<SU<S35egg) z5Validate that no mappings exist for the given values.r$r.rNzCannot add mapping for z "z", already mapped to ""r)r@rrr)rDrVrrgetter remappings rr3r3sw*  )|=I!7))k9 67 7|9I!9))i 45 5":rc"[[R[U505R 55nU(aQ[ R "U5nUHupEXA;dM URU5X5'M! [ R"U5nU$r-) rr9rxrHrfrYr_poprZ)rKrrErrrs rrrsu044T']BG"UW& =1 &6 "K++8+<+<[+I ('7 =1 rc[RU05nU(ah[R"U5n[ UR 55HupEXS;dM UR U5X4'M! [R"U5nU$r-)r9rxrYr_rrfrLrZ)rVrrEr'rrs rrrsr+// bA**_5&*+;+A+A+C&D "K+/>/B/B9/M,'E**_5 rc^SSKJm U4SjnU"U5(d [S5e[UTR5(a UR n[UTR 5(a URnU$)z1Convert the provided list-as-JsonValue to a list.r) extra_typesc>[UTR5(ag[UTR5(aUR(agg)z6Return True if msg is a repeated value as a JsonValue.TF)r JsonArray JsonValue array_value)rrOs r_IsRepeatedJsonValue,_AsMessageList.._IsRepeatedJsonValues8 c;00 1 1 c;00 1 1coorz"invalid argument to _AsMessageList)apitools.base.pyrO ValueErrorrrRrSrQentries)rrTrOs @rrrsc -  $ $=>>#{,,--oo#{,,--kk JrcURUR5n[U[R5(dgUR S5nUR $![a gf=f)z3Returns whether the "field" is actually a map-type.Fre)r$rrrrrrr)rKr$r additional_propertiess r_IsMapr[se  & &uzz 2E eX-- . .. % 3 34J K%--- sA A'&A'c## [X5(deURUR5nURS5nUHnURUR4v M g7f)z/Yields the (key, value) pair of the map values.reN)r[r$rrdr )rKr$ map_messagerZkv_pairs r _MapItemsr_s[ ' ! !! !,,UZZ8K':: (kk7==(()sA#A%c# # [U[R5(dgUR5nU(aX4v gUR 5GH8nUR UR 5nUR(aZ[U5HIupV[[RUR U5n[XaU4-5nUH upX4v M MK M[X5(aZ[X5HIup[[RUR U 5n [XaU 4-5nUH upX4v M MK M[[R UR S5n [XAU 4-5nUH upX4v M GM; g7f)aYields the locations of unrecognized fields within "message". If a sub-message is found to have unrecognized fields, that sub-message will not be searched any further. We prune the search of the sub-message because we assume it is malformed and further checks will not yield productive errors. Args: message: The Message instance to search. _edges: Internal arg for passing state. Yields: (edges_to_message, field_names): edges_to_message: List[ProtoEdge], The edges (relative to "message") describing the path to the sub-message where the unrecognized fields were found. field_names: List[Str], The names of the field(s) that were unrecognized in the sub-message. N)rrrrrr$rr enumerater rrUnrecognizedFieldIterr[r_rr)rK_edges field_namesr$r ir repeated_edgeiter_ryrdmap_edge scalar_edges rrbrbsL( gx// 0 0113K!!##%**5::6 >>$U+ )(*;*;UZZ K -dm=M4MN#FQ$J$, G # #&w6 $X\\5::sC-dh[4HI#FQ$J$7 $HOOUZZFK)%;.1HIEd  #&sF Fr-)F)NN)NNN)r)Arr collectionsrrYrapitools.base.protorpcliterrrrVr namedtuplerr objectrr r.r7r=rBr3r:r?rErLrIrGr\r`rnrprrrrrrQrrrNrrrr rrr!rr BytesFieldr2r9r7r:rr@r>r3rrrr[r_rbrrrrps"G  4/0'   9i*@ A$$]Wj4IJ  v ; &&{'BD;8 "@ ; J 6 . 05 ?: . Xv% &0`J,,`JH2  4N 0 88<:')9:8;N;NO &*,2'+,89:JN!,5& 2 .)1r