L SrSSKrSSKrSSKrSSKJr SSKJr /SQr\R\R\R\R\RS\RS\RS\RS 0r\R\\R\\RS \RS \RS \R\0r"S S\R&5r"SS\R&5r"SS\R&5r"SS\R&5r"SS\R&5r"SS\R&5rSrSrSrSrSrSrSr \RB"S 5\"4S!j5r#"S"S#\$5r%g)$ah Services descriptor definitions. Contains message definitions and functions for converting service classes into transmittable message format. Describing an Enum instance, Enum class, Field class or Message class will generate an appropriate descriptor object that describes that class. This message can itself be used to transmit information to clients wishing to know the description of an enum value, enum, field or message without needing to download the source code. This format is also compatible with other, non-Python languages. The descriptors are modeled to be binary compatible with https://github.com/google/protobuf NOTE: The names of types and fields are not always the same between these descriptors and the ones defined in descriptor.proto. This was done in order to make source code files that use these descriptors easier to read. For example, it is not necessary to prefix TYPE to all the values in FieldDescriptor.Variant as is done in descriptor.proto FieldDescriptorProto.Type. Example: class Pixel(messages.Message): x = messages.IntegerField(1, required=True) y = messages.IntegerField(2, required=True) color = messages.BytesField(3) # Describe Pixel class using message descriptor. fields = [] field = FieldDescriptor() field.name = 'x' field.number = 1 field.label = FieldDescriptor.Label.REQUIRED field.variant = FieldDescriptor.Variant.INT64 fields.append(field) field = FieldDescriptor() field.name = 'y' field.number = 2 field.label = FieldDescriptor.Label.REQUIRED field.variant = FieldDescriptor.Variant.INT64 fields.append(field) field = FieldDescriptor() field.name = 'color' field.number = 3 field.label = FieldDescriptor.Label.OPTIONAL field.variant = FieldDescriptor.Variant.BYTES fields.append(field) message = MessageDescriptor() message.name = 'Pixel' message.fields = fields # Describing is the equivalent of building the above message. message == describe_message(Pixel) Public Classes: EnumValueDescriptor: Describes Enum values. EnumDescriptor: Describes Enum classes. FieldDescriptor: Describes field instances. FileDescriptor: Describes a single 'file' unit. FileSet: Describes a collection of file descriptors. MessageDescriptor: Describes Message classes. Public Functions: describe_enum_value: Describe an individual enum-value. describe_enum: Describe an Enum class. describe_field: Describe a Field definition. describe_file: Describe a 'file' unit from a Python module or object. describe_file_set: Describe a file set from a list of modules or objects. describe_message: Describe a Message definition. N)messages)util)EnumDescriptorEnumValueDescriptorFieldDescriptorMessageDescriptorFileDescriptorFileSetDescriptorLibrary describe_enumdescribe_enum_valuedescribe_fielddescribe_message describe_filedescribe_file_setdescribeimport_descriptor_loaderc*U=(a S=(d S$)Ntruefalsevalues 8lib/third_party/apitools/base/protorpclite/descriptor.pyrs):7)Fh)Fc4[R"U5S$Nr)codecs escape_encoders rrrv';';E'B1'ErcU$Nrrs rrrrcB[R"UR5$r#)six text_typenumberrs rrrscmmELL&Arc US:H$)Nrrrs rrrs ')9rc4[R"U5S$r)r escape_decoders rrrr!rcU$r#rrs rrrr$rc\rSrSrSr\R "SSS9r\R"SS\RRS9r Sr g ) rzjEnum value descriptor. Fields: name: Name of enumeration value. number: Number of enumeration value. Trequiredr1variantrN) __name__ __module__ __qualname____firstlineno____doc__r StringFieldname IntegerFieldVariantINT32r(__static_attributes__rrrrrs@   D 1D  " "1,0+3+;+;+A+ACFrrc`\rSrSrSr\R "S5r\R"\ SSS9r Sr g) rzxEnum class descriptor. Fields: name: Name of Enum without any qualification. values: Values defined by Enum class. r/r2TrepeatedrN) r5r6r7r8r9rr:r; MessageFieldrvaluesr?rrrrrs.    "D  " "#6D IFrrcn\rSrSrSr\R r"SS\R5r\R"SSS9r \R"SS\R RS 9r \R"\S \RS 9r\R"\S 5r\R"S 5r\R"S5rSrg)raWField definition descriptor. Enums: Variant: Wire format hint sub-types for field. Label: Values for optional, required and repeated fields. Fields: name: Name of field. number: Number of field. variant: Variant of field. type_name: Type name for message and enum fields. default_value: String representation of default value. c$\rSrSrSrSrSrSrSrg)FieldDescriptor.Labelz Field label.r/r2rN) r5r6r7r8r9OPTIONALREQUIREDREPEATEDr?rrrLabelrIsrrOr/Tr0rKr3)defaultrN)r5r6r7r8r9rr=EnumrOr:r;r<r>r( EnumFieldrLlabelr4 type_name default_valuer?rrrrrs G    D 1D  " "1,0+3+;+;+A+ACF   ua @E  !,G$$Q'I((+Mrrc\rSrSrSr\R "S5r\R"\ SSS9r \R"SSSS9r \R"\ S SS9r S rg ) rzMessage definition descriptor. Fields: name: Name of Message without any qualification. fields: Fields defined for message. message_types: Nested Message classes defined on message. enum_types: Nested Enum classes defined on message. r/r2TrBz7apitools.base.protorpclite.descriptor.MessageDescriptorrKrPrN)r5r6r7r8r9rr:r;rDrfields message_typesr enum_typesr?rrrrrs[    "D  " "?A EF))A1M&&~q4HJrrc\rSrSrSr\R "S5r\R"\ SSS9r \R"\ SSS9r Sr g ) r zDescription of file containing protobuf definitions. Fields: package: Fully qualified name of package that definitions belong to. message_types: Message definitions contained in file. enum_types: Enum definitions contained in file. r2rPTrBrRrN)r5r6r7r8r9rr:packagerDrr]rr^r?rrrr r sD""1%G))*;QNM&&~q4HJrr c<\rSrSrSr\R "\SSS9rSr g)r izFA collection of FileDescriptors. Fields: files: Files in file-set. r/TrBrN) r5r6r7r8r9rrDr filesr?rrrr r s  ! !.!d CErr c[5n[R"UR5UlURUlU$)zBuild descriptor for Enum instance. Args: enum_value: Enum value to provide descriptor for. Returns: Initialized EnumValueDescriptor instance describing the Enum instance. )rr&r'r;r() enum_valueenum_value_descriptors rr r s801!$z!?#-#4#4  rc[5nUR5RS5SUl/n[ UR 55H.nUR U5nUR[U55 M0 U(aX!l U$)zBuild descriptor for Enum class. Args: enum_definition: Enum class to provide descriptor for. Returns: Initialized EnumDescriptor instance describing the Enum class. .) rdefinition_namesplitr;sortednumberslookup_by_numberappendr rE)enum_definitionenum_descriptorrEr(rs rr r s}%&O*::<BB3GKO F0023008 )%014!' rc[5nURUlURUlURUl[ U[ R 5(aURR5Ul [ U[ R5(aURR5Ul URb'[[U5"UR5UlUR(a![R R"UlU$UR&(a![R R(UlU$[R R*UlU$)zBuild descriptor for Field instance. Args: field_definition: Field instance to provide descriptor for. Returns: Initialized FieldDescriptor instance describing the Field instance. )rr;r(r4 isinstancerrVtyperjrXrD message_typerQ_DEFAULT_TO_STRING_MAPrYrCrOrNrWr1rMrL)field_definitionfield_descriptors rrr1s4'(,11.55/77"H$6$677%5%:%:%J%J%L""H$9$9::  ) ) 9 9 ; "+)? ! "*$$4$<$<*>&  !0!6!6!?!?   " "!0!6!6!?!? "1!6!6!?!? rcB[5nUR5RS5SUl[ UR 5SS9nU(a!UVs/sHn[ U5PM snUlURn/nUH(n[X5nUR[U55 M* XQl URn/n UH(n[X5nU R[U55 M* XlU$s snf![a NVf=f![a U$f=f)zBuild descriptor for Message class. Args: message_definition: Message class to provide descriptor for. Returns: Initialized MessageDescriptor instance describing the Message class. rhricUR$r#)r()vs rr"describe_message..cs!((r)key)rrjrkr;rl all_fieldsrr\ __messages__getattrrorr]AttributeError __enums__r r^) message_definitionmessage_descriptorr\fieldnested_messagesmessage_descriptorsr;r nested_enumsenum_descriptorss rrrUs<+,0@@BHH  &113*,F HN$Ou^E%:$O! ?,99!#D.5E  & &'7'> ?$,?( 9)33  D.5E  # #M%$8 9!)9% 5%P         s*C;4 D7 D D  D  DDc"[5n[R"U5UlUR(dSUl/n/n[ [ U55Hn[ X5n[U[5(dM%[U[R5(aUR[U55 M`[U[R5(dMUR[U55 M U(aX!lU(aX1lU$)zBuild a file from a specified Python module. Args: module: Python module to describe. Returns: Initialized FileDescriptor instance describing the module. N)r rget_package_for_modulerarldirrrsrt issubclassrMessagerorrUr r]r^)module descriptorrrr;rs rrrs !J44V> * *e$$ E8== ) )"5)) E4 eX-- . .#E* * x}} - - ' ' rr/cURS5(aUSSnURS5(d3URS5SnU(aU"USSU/5n[U5$[[R "U[ S95$![a N/f=f![RanURSS5n[U5S:aUupg[XaS9n[U[5(aUR=(d /n O-[U[5(aUR=(d /n O/n U Hn U R U:XdMU s sSnA$ Ue![Ra Uef=fUeSnAff=f)aFind objects by importing modules as needed. A definition loader is a function that resolves a definition name to a descriptor. The import finder resolves definitions to their names by importing modules when necessary. Args: definition_name: Name of definition to find. importer: Import function used for importing new modules. Returns: Appropriate descriptor for any describable type located by name. Raises: DefinitionNotFoundError when a name does not refer to either a definition or a module. rhr/Nri)importer) startswithrkr ImportErrorrfind_definition __import__DefinitionNotFoundErrorrsplitlenrrsrrErr\r;) rjrleafrerr split_nameparentchildparent_definition search_list definitions rrrs,!!#&&)!"-  % %c * *$$S)"-  (!/2rD6B ''00:DFG G    + +%++C3 z?Q &MF *$<%/!/@@"3":":"@bK 13DEE"3":":"@bK"$K"-J!%/))#.  #33  # " 7sa B&!B BBE9,%E4 EA+E4 E4 E9E4E/+E4.E//E44E9c\\rSrSrSr\R "S5S\4Sj5rSr Sr Sr g) r ia~A descriptor library is an object that contains known definitions. A descriptor library contains a cache of descriptor objects mapped by definition name. It contains all types of descriptors except for file sets. When a definition name is requested that the library does not know about it can be provided with a descriptor loader which attempt to resolve the missing descriptor. r/Nc0X lU=(d 0Ulg)afConstructor. Args: descriptors: A dictionary or dictionary-like object that can be used to store and cache descriptors by definition name. definition_loader: A function used for resolving missing descriptors. The function takes a definition name as its parameter and returns an appropriate descriptor. It may raise DefinitionNotFoundError. N)%_DescriptorLibrary__descriptor_loader_DescriptorLibrary__descriptors)self descriptorsdescriptor_loaders r__init__DescriptorLibrary.__init__(s$5 (.BrcURU$![a Of=fUR(a!URU5nX RU'U$[R"SU-5e)aPLookup descriptor by name. Get descriptor from library by name. If descriptor is not found will attempt to find via descriptor loader if provided. Args: definition_name: Definition name to find. Returns: Descriptor that describes definition name. Raises: DefinitionNotFoundError if not descriptor exists for definition name. z Could not find definition for %s)rKeyErrorrrr)rrjrs rlookup_descriptor#DescriptorLibrary.lookup_descriptor8sv %%o6 6     # #11/BJ2<   / 222_DF Fs  cURU5n[U[5(a UR$UR S5nUS:agUSUnMQ)aDetermines the package name for any definition. Determine the package that any definition name belongs to. May check parent for package name and will resolve missing descriptors if provided descriptor loader. Args: definition_name: Definition name to find package for. rhrN)rrsr rarfind)rrjrindexs rlookup_package DescriptorLibrary.lookup_packageTs[//@J*n55!)))'--c219"1&5"9r)__descriptor_loader __descriptors) r5r6r7r8r9r positionalrrrrr?rrrr r s5  __Q!#; / /F8:rr )&r9rrr&apitools.base.protorpcliterr__all__r<r' FloatField BooleanField BytesFieldr:rVrvintfloat_DEFAULT_FROM_STRING_MAPrrrrrr r r r rrrrrrrrobjectr rrrrs$M\ /+ 8 3==  F E - A  3  9 E -   C(** C JX%% J',h&&',TI((I&IX%%I"DhD !.!H*Z$N(67A@@FK:K:r