SrSSKrSSKrSSKrSSKJr /SQr\Rr"SS\5r"SS\5r "S S \ 5r "S S \ 5r "S S\ 5r "SS\5r "SS\5r"SS\5r"SS\5r"SS\5r"SS\5r\"/SQ5r\"/SQ5r\"S/5rSrSrSrS r"S!S"\5r"S#S$\5r"S%S&\R<"\\55r "S'S(\ 5r!"S)S*\5r""S+S,\R<"\"\55r#"S-S.\$5r%"S/S0\5r&"S1S2\R<"\&\55r'"S3S4\'5r("S5S6\'5r)"S7S8\'5r*"S9S:\'5r+"S;S<\'5r,"S=S>\'5r-"S?S@\'5r.\R^"SA5S\04SBj5r1g)CaStand-alone implementation of in memory protocol messages. Public Classes: Enum: Represents an enumerated type. Variant: Hint for wire format to determine how to serialize. Message: Base class for user defined messages. IntegerField: Field for integer values. FloatField: Field for float values. BooleanField: Field for boolean values. BytesField: Field for binary string values. StringField: Field for UTF-8 string values. MessageField: Field for other message type values. EnumField: Field for enumerated type values. Public Exceptions (indentation indications class hierarchy): EnumDefinitionError: Raised when enumeration is incorrectly defined. FieldDefinitionError: Raised when field is incorrectly defined. InvalidVariantError: Raised when variant is not compatible with field type. InvalidDefaultError: Raised when default is not compatiable with field. InvalidNumberError: Raised when field number is out of range or reserved. MessageDefinitionError: Raised when message is incorrectly defined. DuplicateNumberError: Raised when field has duplicate number with another. ValidationError: Raised when a message or field is not valid. DefinitionNotFoundError: Raised when definition not found. N)util)MAX_ENUM_VALUEMAX_FIELD_NUMBERFIRST_RESERVED_FIELD_NUMBERLAST_RESERVED_FIELD_NUMBEREnumField FieldListVariantMessage IntegerField FloatField BooleanField BytesField StringField MessageField EnumFieldfind_definitionError DecodeError EncodeErrorEnumDefinitionErrorFieldDefinitionErrorInvalidVariantErrorInvalidDefaultErrorInvalidNumberErrorMessageDefinitionErrorDuplicateNumberErrorValidationErrorDefinitionNotFoundErrorc\rSrSrSrSrg)r_zEnumeration definition error.N__name__ __module__ __qualname____firstlineno____doc____static_attributes__r#6lib/third_party/apitools/base/protorpclite/messages.pyrr_s'r+rc\rSrSrSrSrg)rczField definition error.r#Nr$r#r+r,rrcs!r+rc\rSrSrSrSrg)rgz"Invalid variant provided to field.r#Nr$r#r+r,rrg,r+rc\rSrSrSrSrg)rkz"Invalid default provided to field.r#Nr$r#r+r,rrkr1r+rc\rSrSrSrSrg)roz!Invalid number provided to field.r#Nr$r#r+r,rros+r+rc\rSrSrSrSrg)rszMessage definition error.r#Nr$r#r+r,rrss#r+rc\rSrSrSrSrg)rwz#Duplicate number assigned to field.r#Nr$r#r+r,rrws-r+rc\rSrSrSrSrg)r {z$Raised when definition is not found.r#Nr$r#r+r,r r {s.r+r c\rSrSrSrSrg)rz/Error found decoding message from encoded form.r#Nr$r#r+r,rrs9r+rc\rSrSrSrSrg)rz"Error found when encoding message.r#Nr$r#r+r,rrr1r+rc\rSrSrSrSrSrg)rz Invalid value for message error.c,[RU5$)z6Prints string with field name if present on exception.)r__str__selfs r,rCValidationError.__str__s}}T""r+r#N)r%r&r'r(r)rCr*r#r+r,rrs *#r+r)r&r)r'r*r()name_message_definition_MessageField__type_EnumField__type_EnumField__resolved_defaultrHii8JiNcF\rSrSrSrSrSrSrSrSr Sr S r S r S r g ) _DefinitionClassa]Base meta-class used for definition meta-classes. The Enum and Message definition classes share some basic functionality. Both of these classes may be contained by a Message definition. After initialization, neither class may have attributes changed except for the protected _message_definition attribute, and that attribute may change only once. Fcj[RXX#5 UR[4:waSUlgg)z Constructor.TN)type__init__ __bases__object_DefinitionClass__initializedclsrGbasesdcts r,rQ_DefinitionClass.__init__s+ c, ==VI % $C  &r+cDUR5$![a gf=f)zGet outer Message definition that contains this definition. Returns: Containing Message definition if definition is contained within one, else None. NrHAttributeErrorrVs r,message_definition#_DefinitionClass.message_definitions( **, ,    cUR(aU[;a[SU-5e[R XU5 g)aOverridden to avoid setting variables after init. Setting attributes on a class must work during the period of initialization to set the enumation value class variables and build the name/number maps. Once __init__ has set the __initialized flag to True prohibits setting any more values on the class. The class is in effect frozen. Args: name: Name of value to set. value: Value to set. zMay not change values: %sN)rT_POST_INIT_ATTRIBUTE_NAMESr\rP __setattr__)rVrGvalues r,rc_DefinitionClass.__setattr__s6   -G!G !>> MyMessage.definition_name() some.alternate.package.MyMessage Returns: Dot-separated fully qualified name of definition. .)outer_definition_namesix text_typer%)rVrns r,definition_name _DefinitionClass.definition_names;0!$ 9 9 ; (==. .0#,,??r+cUR5nU(d [R"UR5$UR 5$)zHelper method for creating outer definition name. Returns: If definition is nested, will return the outer definitions name, else the package name. )r^rget_package_for_moduler&rqrVouter_definitions r,rn&_DefinitionClass.outer_definition_names:113..s~~> >//11r+cUR5nU(d [R"UR5$UR 5$)zyHelper method for creating creating the package of a definition. Returns: Name of package that definition belongs to. )r^rrtr&definition_packagerus r,ry#_DefinitionClass.definition_package s: 113..s~~> >2244r+r#N)r%r&r'r(r)rTrQr^rcrjrqrnryr*r#r+r,rMrMs3M% /&I@: 2 5r+rMcB\rSrSrSrSrSrSrSrSr Sr S r S r g ) _EnumClassiaMeta-class used for defining the Enum base class. Meta-class enables very specific behavior for any defined Enum class. All attributes defined on an Enum sub-class must be integers. Each attribute defined on an Enum sub-class is translated into an instance of that sub-class, with the name of the attribute as its name, and the number provided as its value. It also ensures that only one level of Enum class hierarchy is possible. In other words it is not possible to delcare sub-classes of sub-classes of Enum. This class also defines some functions in order to restrict the behavior of the Enum class and its sub-classes. It is not possible to change the behavior of the Enum class in later classes since any new classes may be defined with only integer values, and no methods. cU[4:XdU[4:Xd[SU-5e0Ul0UlU[4:wGa%UR 5GHupEU[ ;aM[U[R5(d[SU<SU<35eUS:a[SXE4-5eU[:a[S[XE4-5eXPR;a'[SXEURUR4-5e[RU5nURXdU5 X`RUR'X`RUR'[XU5 GM [ RXX#5 g)Nz'Enum type %s may only inherit from Enumz3May only use integers in Enum definitions. Found:  = rz2Must use non-negative enum values. Found: %s = %dz;Must use enum values less than or equal %d. Found: %s = %dz(Value for %s = %d is already defined: %s)rSrr_EnumClass__by_number_EnumClass__by_nameitems_RESERVED_ATTRIBUTE_NAMES isinstancero integer_typesrrG__new__rQnumbersetattrrM)rVrGrWrX attributerdinstances r,rQ_EnumClass.__init__+s{&"ew&6%9D@B B  VI $'IIK  99"%):):;;-#E+,,19-L"*+,,>)-)':;<< OO+-B"3??5+A+F+FGHII ">>#. X%8/7 hmm,3;01K%0N !!#U8r+cH[URR55$)zhIterate over all values of enum. Yields: Enumeration instances of the Enum class in arbitrary order. )iterrvaluesr]s r,__iter___EnumClass.__iter__`s COO**,--r+c6URR5$)zaGet all names for Enum. Returns: An iterator for names of the enumeration in arbitrary order. )rkeysr]s r,names_EnumClass.nameshs }}!!##r+c6URR5$)ziGet all numbers for Enum. Returns: An iterator for all numbers of the enumeration in arbitrary order. )rrr]s r,numbers_EnumClass.numbersps ##%%r+c URU$)znLook up Enum by name. Args: name: Name of enum to find. Returns: Enum sub-class instance of that value. )rris r,lookup_by_name_EnumClass.lookup_by_namexs}}T""r+c URU$)ztLook up Enum by number. Args: number: Number of enum to find. Returns: Enum sub-class instance of that value. )rrVrs r,lookup_by_number_EnumClass.lookup_by_numbersv&&r+c,[UR5$N)lenrr]s r,__len___EnumClass.__len__s3==!!r+r#N) r%r&r'r(r)rQrrrrrrr*r#r+r,r|r|s+"39j.$& # '"r+r|c\rSrSrSr\"S5rSrSSjrSr Sr S r S r S r S rS rSrSrSrSrSrSr\S5r\S5rSrg)riz$Base class for all enumerated types.rGrcd[X5(aU$[U[R5(aURU5$[U[R 5(aUR U5$[SU<SUR<35e![a NZf=f![a N9f=f)aActs as look-up routine after class is initialized. The purpose of overriding __new__ is to provide a way to treat Enum subclasses as casting types, similar to how the int type functions. A program can pass a string or an integer and this method with "convert" that value in to an appropriate Enum instance. Args: index: Name or number to look up. During initialization this is always the name of the new enum value. Raises: TypeError: When an inappropriate index value is passed provided. zNo such value for z in Enum ) rrorrKeyError string_typesrrhr%)rVindexs r,r Enum.__new__s e ! !L eS.. / / ++E22 eS-- . . ))%00 ./ /    s#B$B" BB" B/.B/Nc[[U5S5(ag[RUSU5 [RUSU5 g)zInitialize new Enum instance. Since this should only be called during class initialization any calls that happen after the class is frozen raises an exception. rTNrGr)getattrrPrSrc)rErGrs r,rQ Enum.__init__s= 4:> ? ? 4.462r+c[S5e)NzMay not change enum valuesrgrErGrds r,rcEnum.__setattr__s455r+cUR$r)rGrDs r,rC Enum.__str__s yyr+cUR$rrrDs r,__int__ Enum.__int__s {{r+c`S[U5RURUR4-$)Nz %s(%s, %d))rPr%rGrrDs r,__repr__ Enum.__repr__s&tDz22DIIt{{KKKr+c4URUR44$)z}Enable pickling. Returns: A 2-tuple containing the class and __new__ args to be used for restoring a pickled instance. ) __class__rrDs r, __reduce__Enum.__reduce__s~~ ~--r+c[U[U55(a [URUR5$[$zOrder is by number.)rrPcmprNotImplementedrEothers r,__cmp__ Enum.__cmp__s. eT$Z ( (t{{ELL1 1r+ct[U[U55(aURUR:$[$rrrPrrrs r,__lt__ Enum.__lt__, eT$Z ( (;;- -r+ct[U[U55(aURUR:*$[$rrrs r,__le__ Enum.__le__, eT$Z ( (;;%,,. .r+ct[U[U55(aURUR:H$[$rrrs r,__eq__ Enum.__eq__rr+ct[U[U55(aURUR:g$[$rrrs r,__ne__ Enum.__ne__rr+ct[U[U55(aURUR:$[$rrrs r,__ge__ Enum.__ge__rr+ct[U[U55(aURUR:$[$rrrs r,__gt__ Enum.__gt__rr+c,[UR5$)zHash by number.)hashrrDs r,__hash__ Enum.__hash__ sDKK  r+c8[S[U555$)zMake dictionary version of enumerated class. Dictionary created this way can be used with def_num. Returns: A dict (name) -> number c3P# UHoRUR4v M g7frr).0items r, Enum.to_dict..sCYY ,s$&)dictrr]s r,to_dict Enum.to_dict sCcCCCr+c&[U[4U5$)zqDefine enum class from dictionary. Args: dct: Dictionary of enumerated values for type. name: Name of enum. )rPr)rXrGs r,def_enum Enum.def_enumsD4'3''r+r#r)r%r&r'r(r)set __slots__rrQrcrCrrrrrrrrrrr classmethodr staticmethodrr*r#r+r,rrs.&'I"/H 36L.       !DD((r+rcL\rSrSrSrSrSrSrSrSr Sr S r S r S r S rS rSrSrSrg)r i%aWire format variant. Used by the 'protobuf' wire format to determine how to transmit a single piece of data. May be used by other formats. See: http://code.google.com/apis/protocolbuffers/docs/encoding.html Values: DOUBLE: 64-bit floating point number. FLOAT: 32-bit floating point number. INT64: 64-bit signed integer. UINT64: 64-bit unsigned integer. INT32: 32-bit signed integer. BOOL: Boolean value (True or False). STRING: String of UTF-8 encoded text. MESSAGE: Embedded message as byte string. BYTES: String of 8-bit bytes. UINT32: 32-bit unsigned integer. ENUM: Enum value as integer. SINT32: 32-bit signed integer. Uses "zig-zag" encoding. SINT64: 64-bit signed integer. Uses "zig-zag" encoding.  r#N)r%r&r'r(r)DOUBLEFLOATINT64UINT64INT32BOOLSTRINGMESSAGEBYTESUINT32ENUMSINT32SINT64r*r#r+r,r r %sJ,F E E F E D FG E F D F Fr+r c$\rSrSrSrSrSrSrg) _MessageClassiKaMeta-class used for defining the Message base class. For more details about Message classes, see the Message class docstring. Information contained there may help understanding this class. Meta-class enables very specific behavior for any defined Message class. All attributes defined on an Message sub-class must be field instances, Enum class definitions or other Message class definitions. Each field attribute defined on an Message sub-class is added to the set of field definitions and the attribute is translated in to a slot. It also ensures that only one level of Message class hierarchy is possible. In other words it is not possible to declare sub-classes of sub-classes of Message. This class also defines some functions in order to restrict the behavior of the Message class and its sub-classes. It is not possible to change the behavior of the Message class in later classes since any new classes may be defined with only field, Enums and Messages, and no methods. c60n0n0nU[4:wGajU[4:wa [S5e/n/nUR5GHupU [;aM[ U [ 5(a([U [5(aURU 5 MO[ U [ 5(a1[U [5(aU [LaURU 5 M[ U 5[Ld[ U [5(d[SU <SU <35eU RU;a[SU RU4-5eXl XU 'XU R'GM U(a[U5US'U(a[U5US'XCS'XSS'[R!XX#5$) zCreate new Message class instance. The __new__ method of the _MessageClass type is overridden so as to allow the translation of Field instances to slots. z+Message types may only inherit from Messagez4May only use fields in message definitions. Found: r~z2Field with number %d declared more than once in %s __enums__ __messages___Message__by_number_Message__by_name)rSr rrrrrP issubclassrappendr rrrGsortedrMr) rVrGrWrX by_numberby_name variant_mapenumsmessageskeyfields r,r_MessageClass.__new__cs   VI  ",ACCEH"iik 33eT**z%/F/FLL%ud++"5'22W,OOC(;%'z%/G/G0e%&& <<9,.Lt,-..!  % */%,,'A*F#)%=K &,X&6N#%. !"#*  ''5>>r+cRU[4:waUR5H@n[U[5(dMU[LdM%[ R "U5UlMB UR5Hn[ R "U5UlM [RXX#5 g)z7Initializer required to assign references to new class.N) rSrrrMr weakrefrefrH all_fieldsrQ)rVrGrWrXvrs r,rQ_MessageClass.__init__sx VI ZZ\a!122q7G,3KK,nUR(dMURU;dM([ XR/5 M@ g)aInitialize internal messages state. Args: A message can be initialized via the constructor by passing in keyword arguments corresponding to fields. For example: class Date(Message): day = IntegerField(1) month = IntegerField(2) year = IntegerField(3) Invoking: date = Date(day=6, month=6, year=1911) is the same as doing: date = Date() date.day = 6 date.month = 6 date.year = 1911 N) _Message__tags_Message__unrecognized_fieldsrrraddrrepeatedrG)rEkwargsassignedrGrdrs r,rQMessage.__init__sw2 %'"5!<<>KD D & LL * __&E~~~%**H"<jj"-'r+cURR5Hup[X5nUc9UR(a&[ S[ U5R <SU<35eML[U[5(a[UR[5(a`UR(a,UH$nURU5nUR5 M& MURU5nUR5 MMM g![a1n[US5(d[ U5R UleSnAff=f)zCheck class for initialization status. Check that all required fields are initialized Raises: ValidationError: If message is not initialized. NMessage z is missing required field message_name)rrrrequiredrrPr%rrr message_typer r&value_to_messagecheck_initializedhasattrr,)rErGrrdritem_message_value message_valueerrs r,r0Message.check_initializeds  >>//1KDD'E}>>)d,,d455" "5,77&u'9'97CC >>(-5:5K5K$(6* 2 2 D D F). -2,B,B5,IM);;=D82&'"377+/:+>+>(s(A/D!D D> ,D99D>cFUR5 g![a gf=f)zMGet initialization status. Returns: True if message is valid, else False. TF)r0rrDs r,is_initializedMessage.is_initialized?s,    " " $  s   c6URR5$)zsGet all field definition objects. Ordering is arbitrary. Returns: Iterator over all values in arbitrary order. )rrr]s r,rMessage.all_fieldsLs}}##%%r+c URU$)zvGet field by name. Returns: Field object associated with name. Raises: KeyError if no field found by that name. )rris r, field_by_nameMessage.field_by_nameWs}}T""r+c URU$)z|Get field by number. Returns: Field object associated with number. Raises: KeyError if no field found by that number. )rrs r,field_by_numberMessage.field_by_numbercsv&&r+c[U5nURU5nUR R UR5$![a [SUR<SU<35ef=f)aGet the assigned value of an attribute. Get the underlying value of an attribute. If value has not been set, will not return the default for the field. Args: name: Name of attribute to get. Returns: Value of attribute, None if it has not been set. r+ has no field )rPr<rr\r%r#getrrErGr.rs r,get_assigned_valueMessage.get_assigned_valueosiDz  . ..t4E{{u||,, . %%t"-. . .s A(A+cl[U5nURU5nWR (a$[U/5URUR'gURRURS5 g![a/ XR;a[ SUR <SU<35eNf=f)zReset assigned value for field. Resetting a field will return it to its default value or None. Args: name: Name of field to reset. r+rBN) rPr<rrr\r%r&r r#rpoprDs r,reset Message.resetsDz  2 ..t4E >>(1%(M>OP~r+cj[U[5(d[SU-5eX#4URU'g)a<Set an unrecognized field, used when decoding a message. Args: key: The name or number used to refer to this unknown value. value: The value of the field. variant: Type information needed to interpret the value or re-encode it. Raises: TypeError: If the variant is not an instance of messages.Variant. zVariant type %s is not valid.N)rr rhr$)rErrdrRs r,set_unrecognized_fieldMessage.set_unrecognized_fields4'7++;gEF F*/.""3'r+cXR;dURS5(a[RXU5 g[ SU<S[ U5R <35e)aChange set behavior for messages. Messages may only be assigned values that are fields. Does not try to validate field when set. Args: name: Name of field to assign to. value: Value to assign to field. Raises: AttributeError when trying to assign value that is not a field. _Message__zMay not assign arbitrary value z to message N)r startswithrSrcr\rPr%rs r,rcMessage.__setattr__sP >> !T__\%B%B   t5 1 48$t*:M:M"OP Pr+c PS[U5R/n[UR5SS9HQnURnUR UR5nUcM/UR SU<S[U5<35 MS UR S5 SRU5$)aMake string representation of message. Example: class MyMessage(messages.Message): integer_value = messages.IntegerField(1) string_value = messages.StringField(2) my_message = MyMessage() my_message.integer_value = 42 my_message.string_value = u'A string' print my_message >>> Returns: String representation of message, including the values of all fields and repr of all sub-messages. "Message.__repr__..s!((r+)rz : >) rPr%rrrGrErreprjoin)rEbodyrrrds r,rMessage.__repr__s,T$Z(()DOO- 24E I++EJJ7E  9d5kBC 4 Cwwt}r+cnXLag[U5[U5LagURUR:H$)aLEquality operator. Does field by field comparison with other message. For equality, must be same type and values of all fields must be equal. Messages not required to be initialized for comparison. Does not attempt to determine equality for values that have default values that are not set. In other words: class HasDefault(Message): attr1 = StringField(1, default='default value') message1 = HasDefault() message2 = HasDefault() message2.attr1 = 'default value' message1 != message2 Does not compare unknown values. Args: other: Other message to compare with. TF)rPr#rs r,rMessage.__eq__s2: = :T%[ ({{ell**r+c.URU5(+$)a.Not equals operator. Does field by field comparison with other message. For non-equality, must be different type or any value of a field must be non-equal to the same field in the other instance. Messages not required to be initialized for comparison. Args: other: Other message to compare with. )rrs r,rMessage.__ne__s;;u%%%r+)__tags__unrecognized_fields)NN)r%r&r'r(r)rQr0r7rrr<r?rErIrMrSrVrcrrrr*r#r+r,r r sBH$.L@ && # # ' '-*0(7>B48$9 P(@#+J &r+r cX\rSrSrSrSrSrSr\S5r Sr Sr S r S r S rS rg )r i&a List implementation that validates field values. This list implementation overrides all methods that add values in to a list in order to validate those new elements. Attempting to add or set list values that are not of the correct type will raise ValidationError. cUR(d [S5eXlURRU5 [R X5 g)zConstructor. Args: field_instance: Instance of field that validates the list. sequence: List or tuple to construct list from. z)FieldList may only accept repeated fieldsN)r&r_FieldList__fieldvalidaterLrQ)rEfield_instancesequences r,rQFieldList.__init__0s@&&&;= =%  h' d%r+cURR5nUcURSS4$SXRR4$)aEnable pickling. The assigned field instance can't be pickled if it belongs to a Message definition (message_definition uses a weakref), so the Message class and field number are returned in that case. Returns: A 3-tuple containing: - The field instance, or None if it belongs to a Message class. - The Message class that the field instance belongs to, or None. - The field instance number of the Message class it belongs to, or None. N)rqr^r)rE message_classs r, __getstate__FieldList.__getstate__>sB 779  <<t+ +]LL$7$777r+cNUup#nUcURU5UlgX lg)aEnable unpickling. Args: state: A 3-tuple containing: - The field instance, or None if it belongs to a Message class. - The Message class that the field instance belongs to, or None. - The field instance number of the Message class it belongs to, or None. N)r?rq)rEstatersrwrs r, __setstate__FieldList.__setstate__Rs+16-v  !(88@DL)Lr+cUR$)zField that validates list.)rqrDs r,rFieldList.fieldbs||r+cfURRU5 [RXX#5 g)z"Validate slice assignment to list.N)rqrrrL __setslice__)rEijrts r,rFieldList.__setslice__gs$ h' $1/r+c[U[5(aURRU5 OURR U5 [ R XU5 g)z!Validate item assignment to list.N)rslicerqrrvalidate_elementrL __setitem__rErrds r,rFieldList.__setitem__lsC eU # # LL ! !% ( LL ) )% 0 e,r+c[USS5(aURRU5 [R X5$)z Validate item appending to list.rqN)rrqrrLrrErds r,rFieldList.appendts3 4,d 3 3 LL ) )% 0{{4''r+c[USS5(aURRU5 [R X5$)zValidate extension of list.rqN)rrqrrrLextend)rErts r,rFieldList.extendzs3 4,d 3 3 LL ! !( +{{4**r+cdURRU5 [RXU5$)z Validate item insertion to list.)rqrrLinsertrs r,rFieldList.inserts% %%e,{{4..r+)__fieldN)r%r&r'r(r)rQrxr|propertyrrrrrrr*r#r+r,r r &sC &8(* 0 -( + /r+r c\rSrSrSrSrg) _FieldMetaic^[TS5RU4SjURS/555 [R TXU5 g)N_Field__variant_to_typec3*># UHoT4v M g7frr#)rrRrVs r,r&_FieldMeta.__init__..s7C*AwcN*AsVARIANTS)rupdaterCrPrQrUs` r,rQ_FieldMeta.__init__sD./667C*-''*b*A7C C c4,r+r#N)r%r&r'r(rQr*r#r+r,rrs-r+rc\rSrSrSrSr0r\R"S5SSj5r Sr Sr S r S r S rS rS rSrSr\S5r\S5rSrg)r izDefinition for message field.FrNc B[U[5(aSUs=::a [::dO [SU[4-5e[Us=::a [ ::aO O[SU[[ 4-5eU(aU(a [ S5eUc URnU(aUb [ S5eX@R;a=[SU<S[U5R<S [UR5<35eXl X lX0lX@lUbUR#U5 XPlS Ulg![$abnUR&n[)S U<S U<S U<35e![*a, [)S UR,R<S U<S U<35ef=fSnAff=f)aConstructor. The required and repeated parameters are mutually exclusive. Setting both to True will raise a FieldDefinitionError. Sub-class Attributes: Each sub-class of Field must define the following: VARIANTS: Set of variant types accepted by that field. DEFAULT_VARIANT: Default variant type if not specified in constructor. Args: number: Number of field. Must be unique per message class. required: Whether or not field is required. Mutually exclusive with 'repeated'. repeated: Whether or not field is repeated. Mutually exclusive with 'required'. variant: Wire-format variant hint. default: Default value for field if not found in stream. Raises: InvalidVariantError when invalid variant for field is provided. InvalidDefaultError when invalid default for field is provided. FieldDefinitionError when invalid number provided or mutually exclusive fields are used. InvalidNumberError when the field number is out of range or reserved. rzGInvalid number for field: %s Number must be 1 or greater and %d or lesszATag number %d is a reserved number. Numbers %d to %d are reservedz%Cannot set both repeated and requiredNz%Repeated fields may not have defaultszInvalid variant: z Valid variants for z are z Invalid default value for field rbzInvalid default value for T)rintrrrrrDEFAULT_VARIANTrrrPr%rrr-r&rRvalidate_defaultrrGrr\r_Field__default_Field__initialized)rErr-r&rRdefaultr4rGs r,rQField.__init__sF&#&&a6.M=M.M$=)*+, , '& N4N N$&E&,.I&@&B&BC C &'NO O ?**G +&'NO O -- '%$t*--vdmm/DFG G      9%%g.!!# 9 999D.$('3899 &A-00'3@AAA 9s*D22 F= E  F 6FFFcU[;a[RXU5 gUR(d[RXU5 g[ S5e)zSetter overidden to prevent assignment to fields after creation. Args: name: Name of attribute to set. value: Value to assign. NzField objects are read-only) _POST_INIT_FIELD_ATTRIBUTE_NAMESrSrcrr\rs r,rcField.__setattr__sG 3 3   t5 1 !!   t5 1 !>? ?r+c6UcPUR(a[SUR-5eURR UR S5 gUR(a [ X5nOURU5nX!RUR 'g)uSet value on message. Args: message_instance: Message instance to set value on. value: Value to set on message. Nz(May not assign None to repeated field %s)r&rrGr#rHrr rr)rEmessage_instancerds r,__set__ Field.__set__sx =}}%>JLL!//33DKKF}}!$. e,;@ + +DKK 8r+cxUcU$URRUR5nUc UR$U$r)r#rCrr)rErrwresults r,__get__ Field.__get__s;  #K!0044T[[A ><<  r+c [XR5(d[U[R5(aUR[:Xa [ U5$UcUR (a [ S5eU$URn[ SUR<SU<SU<S[U5<S3 5eU$![aD [ SUR<SURR<SU<S[U5<S3 5ef=f)aValidate single element of field. This is different from validate in that it is used on individual values of repeated fields. Args: value: Value to validate. Returns: The value casted in the expected type. Raises: ValidationError if value is not expected type. zRequired field is missingExpected type z for field z, found z (type )z for ) rrProrfloatr-rrGr\rr%)rErdrGs r,rField.validate_elements%++%!2!233 U8JU|#}==)*EFF!  ?99D*D%e>?? &@)+/99dnn6M6M+0$u++?@@@s < B99ADcUR(dU"U5$[U[[45(aB/nUH8nUcURn[ SU-5eURU"U55 M: U$Ub URn[ SU<SU<35eU$![ a# [ SURR-5ef=f![ a' [ URR<SU<35ef=f)aInternal validation function. Validate an internal value using a function to validate individual elements. Args: value: Value to validate. validate_element: Function to use to validate individual elements. Raises: ValidationError if value is not expected type. z,Repeated values for field %s may not be Nonez&Repeated values for %s may not be NoneField z is repeated. Found: ) r&rrLtuplerGrr\rr%r)rErdrrelementrGs r, __validateField.__validateAs }}#E* *%$//$G :#'99D #2!248!9#::MM"27";< % "K99D *=A5IKK ' .M"1!248NN4K4K!L#MMM&9)//+8999s B; C -C  1C=c8URXR5$)zValidate value assigned to field. Args: value: Value to validate. Returns: the value in casted in the correct type. Raises: ValidationError if value is not expected type. )_Field__validaterrs r,rrField.validatensu&;&;<[U[5(a[R"US5 U$[[U]/U5$![ajnUR n[ SUR <SU<SU<35nUR UlUe![a [ SU<SU<35nUef=fSnAff=f)zkValidate StringField allowing for str and unicode. Raises: ValidationError if a str value is not UTF-8. zUTF-8rz encountered non-UTF-8 string rbz#Field encountered non-UTF-8 string N) rrrorpUnicodeDecodeErrorrGr field_namer\superrr)rErdr4_validation_errorrs r,rStringField.validate_elements eU # # ' eW-  d[U[R5=(d6 U[L=(a' [U[5=(a [ U[5nU(d[ SU-5e[U[R5(aXlSUlOXl[[U]/UUUUS9 g)aConstructor. Args: message_type: Message type for field. Must be subclass of Message. number: Number of field. Must be unique per message class. required: Whether or not field is required. Mutually exclusive to 'repeated'. repeated: Whether or not field is repeated. Mutually exclusive to 'required'. variant: Wire-format variant hint. Raises: FieldDefinitionError when invalid message_type is provided. Invalid message class: %sN)r-r&rR) rrorr rPrr_MessageField__type_namerIrrrQ)rEr.rr-r&rR valid_typers r,rQMessageField.__init__>s*!s/?/?@:#729!,59!,8  &+l:< < lC$4$4 5 5+ DK&K lD*64<4<3: + URn[U[5(a[U[5(aUR(aRU(aJ[U[ [ 45(a/UVs/sH"n[U[5(aU"S0UD6OUPM$ nnO[U[5(aU"S0UD6n[[U]+X5 gs snf)rNr#) rPrrr r&rLrrrrr)rErrdtrrs r,rMessageField.__set__gs II a  :a#9#9}}Ze}==&+-&+)31d(;(;af!fB&+-E4(( E  lD)*:B -s/)C c URck[URUR55nU[La*[ U[ 5(a[U[5(d[SU-5eXlUR$)zMessage type used for field.r) rIrrr^r rrPrr)rEr.s r,rPMessageField.typexst ;; *  $"9"9";=L /|T22|W55*/,>@@&K{{r+cUR$)zUnderlying message type used for serialization. Will always be a sub-class of Message. This is different from type which represents the python value that message_type is mapped to for use by the user. )rPrDs r,r.MessageField.message_typesyyr+c[XR5(d>[SURR<S[ U5R<SU<35eU$)zConvert a message to a value instance. Used by deserializers to convert from underlying messages to value of expected user type. Args: message: A message instance of type self.message_type. Returns: Value of self.message_type. r, got rb)rr.rr%rP)rEmessages r,value_from_messageMessageField.value_from_messagesM'#4#455#0099#G}55&() )r+c[XR5(d>[SURR<S[U5R<SU<35eU$)zConvert a value instance to a message. Used by serializers to convert Python user types to underlying messages for transmission. Args: value: A value of type self.type. Returns: An instance of type self.message_type. rrrb)rrPrr%rs r,r/MessageField.value_to_messagesI%++#yy11#E{33$&' ' r+)__type __type_name)FFN)r%r&r'r(r)rr rrrrrrQrrrPr.rr/r*rrs@r,rr s*X'//*+HooO __Q  &<&[U[R5=(d6 U[L=(a' [U[5=(a [ U[5nU(d[ SU-5e[U[R5(aXlSUlOXl[[U]."U40UD6 g)aConstructor. Args: enum_type: Enum type for field. Must be subclass of Enum. number: Number of field. Must be unique per message class. required: Whether or not field is required. Mutually exclusive to 'repeated'. repeated: Whether or not field is repeated. Mutually exclusive to 'required'. variant: Wire-format variant hint. default: Default value for field if not found in stream. Raises: FieldDefinitionError when invalid enum_type is provided. Invalid enum type: %sN) rrorrrPrr_EnumField__type_namerJrrrQ)rE enum_typerr'rrs r,rQEnumField.__init__s !C,<,<=4 ,3!)T23!)T2  &'>'JK K i!1!1 2 2( DK#K i'9&9r+c>[U[R[R45(a$UR(aUR U5 U$[ [ U]U5$)aValidate default element of Enum field. Enum fields allow for delayed resolution of default values when the type of the field has not been resolved. The default value of a field may be a string or an integer. If the Enum type of the field has been resolved, the default value is validated against that type. Args: value: Value to validate. Raises: ValidationError if value is not expected message type. )rrorrrJrrr)rErdrs r,r"EnumField.validate_default_elementsO ec..0A0AB C C{{ E"LY>uEEr+c URck[URUR55nU[La*[ U[ 5(a[U[5(d[SU-5eXlUR$)zEnum type used for field.r) rJrrr^rrrPrr)rE found_types r,rPEnumField.typest ;; (  $"9"9";=Jd*z400z400*+j8::%K{{r+c>UR$![ac [[U]n[ U[ R[ R45(aURU5nXlURs$f=f)zZDefault for enum field. Will cause resolution of Enum type and unresolved default value. ) rKr\rrrrrorrrP)rEresolved_defaultrs r,rEnumField.default$s} +** * +$Y= *S-=-=-0->->-@AA$(99-=#> &6 #** * +s A*A<;A<)__resolved_defaultrr)r%r&r'r(r)rr rrrrQrrrPrr*rrs@r,rrsX@',,(HllO:@F2  ++r+rrc`^^^TbW[T[R5(d8[T[5(a[ T[ 5(d[ ST-5eURS5mTS(dSmTSSmUUU4SjnU"5n[U[5(a[ U[[ 45(aU$Tc[SU-5e[T[R5(aGTRRS5SSnU(dSmOT"SRU5S S US/5mOt[T[5(a_[ T[ 5(aJTR5nUc5TRRS5SnT"TRS S U/5mOUmGM') aFind definition by name in module-space. The find algorthm will look for definitions by name relative to a message definition or by fully qualfied name. If no definition is found relative to the relative_to parameter it will do the same search against the container of relative_to. If relative_to is a nested Message, it will search its message_definition(). If that message has no message_definition() it will search its module. If relative_to is a module, it will attempt to look for the containing module and search relative to it. If the module is a top-level module, it will look for the a message using a fully qualified name. If no message is found then, the search fails and DefinitionNotFoundError is raised. For example, when looking for any definition 'foo.bar.ADefinition' relative to an actual message definition abc.xyz.SomeMessage: find_definition('foo.bar.ADefinition', SomeMessage) It is like looking for the following fully qualified names: abc.xyz.SomeMessage. foo.bar.ADefinition abc.xyz. foo.bar.ADefinition abc. foo.bar.ADefinition foo.bar.ADefinition When resolving the name relative to Message definitions and modules, the algorithm searches any Messages or sub-modules found in its path. Non-Message values are not searched. A name that begins with '.' is considered to be a fully qualified name. The name is always searched for from the topmost package. For example, assume two message types: abc.xyz.SomeMessage xyz.SomeMessage Searching for '.xyz.SomeMessage' relative to 'abc' will resolve to 'xyz.SomeMessage' and not 'abc.xyz.SomeMessage'. For this kind of name, the relative_to parameter is effectively ignored and always set to None. For more information about package name resolution, please see: http://code.google.com/apis/protocolbuffers/docs/proto.html#packages Args: name: Name of definition to find. May be fully qualified or relative name. relative_to: Search for definition relative to message definition or module. None will cause a fully qualified name search. importer: Import function to use for resolving modules. Returns: Enum or Message class definition associated with name. Raises: DefinitionNotFoundError if no definition is found in any search path. NzBrelative_to must be None, Message definition or module. Found: %srmrrc >TnTHn[XS5nUbUnOhUb[U[R5(aDUcUnOUR<SU<3nUR S5SnT"USS[ U5/5nO g[U[R5(aM[U[5(a[U[[45(aM g U$![a  gf=f)aPerforms a single iteration searching the path from relative_to. This is the function that searches up the path from a relative object. fully.qualified.object . relative.or.nested.Definition ----------------------------> ^ | this part of search --+ Returns: Message or Enum at the end of name_path, else None. Nrmrd) rrtypes ModuleTyper%splitstr ImportErrorrPrr r) next_partnoder module_namefromitemimporter name_path relative_tos r, search_path$find_definition..search_paths D 6I$% %"9e.>.>?? (&* 1:1C1CT&J $#.#4#4S#9"#=$,["b.1(m_%>  i)9)9::"9d33"9wo>>7:'$#$s)C C*)C*z Could not find definition for %sr rd)rr r rPrr rhr rr r%rfr^r&) rGrrrfound module_pathparentlast_module_namers `` @r,rr6s|   {E$4$4 5 5 {D ) ) {G , , ' () ) 3I Q< abM ,\   eT " "z%$'I'IL"-6=??k5+;+;<<"-"6"6"<"r s/(2  + P (%("5"-.--.-,-,$U$.5./e/:%:-%-#e#&Y[$-%$& ' !$"i5ti5Xv"!v"rN(3  j& 1N(f#d#Lf9$f9Ro&c  7o&d ]/]/@--d.C  z6 2d.N 5"  5"%"Jg5gT|+|+~&*Z^-^-r+