U
|
£ý°dRº ã @ s d Z dZddlZddlZddlmZ dZe ¡ dkrTddlZddl Z ddl
|
m Z dZG d d
|
d
|
e Z G d d d e ZerG d d deZneZG dd deZe ¡ Zdd Zde_e ZG dd dedZG dd deZG dd deZG dd d eZG d d d eZ G d d d eZ G d!d" d"eZ G d#d$ d$eZ G d%d& d&eZ G d'd( d(eZ!d)d* Z"d+d, Z#d-d. Z$d/d0 Z%d4d2d3Z&dS )5zDescriptors essentially contain exactly the information found in a .proto
|
file, in types that make this information accessible in Python.
|
z#robinson@google.com (Will Robinson)é N)Úapi_implementationFÚcpp)Ú_messageTc @ s e Zd ZdZdS )ÚErrorzBase error for this module.N©Ú__name__Ú
|
__module__Ú __qualname__Ú__doc__© r r úQd:\z\workplace\vscode\pyvenv\venv\Lib\site-packages\google/protobuf/descriptor.pyr 3 s r c @ s e Zd ZdZdS )ÚTypeTransformationErrorzHError transforming between python proto type and corresponding C++ type.Nr r r r r r 7 s r c s e Zd Z fddZ ZS )ÚDescriptorMetaclassc s( t t| |¡rdS t|| jr$dS dS )NTF)Úsuperr Ú__instancecheck__Ú
|
isinstanceÚ_C_DESCRIPTOR_CLASS)ÚclsÚobj©Ú __class__r r r A s
|
z%DescriptorMetaclass.__instancecheck__)r r r r Ú __classcell__r r r r r @ s r c @ s( e Zd ZdZdd Zdd Zdd ZdS ) Ú_Lockz>Wrapper class of threading.Lock(), which is allowed by 'with'.c C s t | ¡}t ¡ |_|S ©N)ÚobjectÚ__new__Ú threadingÚLockÚ_lock)r Úselfr r r r O s
|
|
z _Lock.__new__c C s | j ¡ d S r )r Úacquire©r r r r Ú __enter__T s z_Lock.__enter__c C s | j ¡ d S r )r Úrelease)r Úexc_typeÚ exc_valueÚexc_tbr r r Ú__exit__W s z_Lock.__exit__N)r r r r
|
r r" r' r r r r r L s r c C s0 t jdkr,t jd8 _tjd| tdd d S )Nr é z±Call to deprecated create function %s(). Note: Create unlinked descriptors is going to go away. Please use get/find descriptors from generated code or query the descriptor_pool.é )ÚcategoryÚ
|
stacklevel)Ú _DeprecatedÚcountÚwarningsÚwarnÚDeprecationWarning©Únamer r r r, ^ s
|
ý ûr, éd c @ s0 e Zd ZdZerdZdd Zdd Zdd Zd S )
|
ÚDescriptorBaseaï Descriptors base class.
|
|
This class is the base of all descriptor classes. It provides common options
|
related functionality.
|
|
Attributes:
|
has_options: True if the descriptor has non-default options. Usually it
|
is not necessary to read this -- just call GetOptions() which will
|
happily return the default instance. However, it's sometimes useful
|
for efficiency, and also useful inside the protobuf implementation to
|
avoid some bootstrapping issues.
|
r c C s( || _ || _|| _|dk p |dk | _dS )zÏInitialize the descriptor given its options message and the name of the
|
class of the options message. The name of the class is required in case
|
the options message is None and has to be created.
|
N)Ú_optionsÚ_options_class_nameÚ_serialized_optionsÚ has_options)r ÚoptionsÚserialized_optionsÚoptions_class_namer r r Ú__init__
s zDescriptorBase.__init__c C s || _ || _|dk | _dS )zSets the descriptor's options
|
|
This function is used in generated proto2 files to update descriptor
|
options. It must not be used outside proto2.
|
N)r5 r6 r8 )r r9 r; r r r Ú _SetOptions s zDescriptorBase._SetOptionsc
|
C s | j r | j S ddlm} zt|| j}W n" tk
|
rJ td| j Y nX t8 | jdkrf| | _ nt | | j| _ | j W 5 Q R £ S Q R X dS )zRetrieves descriptor options.
|
|
This method returns the options set or creates the default options for the
|
descriptor.
|
r ©Údescriptor_pb2z Unknown options class name %s!N)
|
r5 Úgoogle.protobufr? Úgetattrr6 ÚAttributeErrorÚ RuntimeErrorr r7 Ú _ParseOptions)r r? Z options_classr r r Ú
|
GetOptions s$ ÿÿ
|
|
ÿzDescriptorBase.GetOptionsN) r r r r
|
Ú_USE_C_DESCRIPTORSr r< r= rE r r r r r4 q s r4 )Ú metaclassc s* e Zd ZdZd fdd Zdd Z ZS )Ú_NestedDescriptorBasez0Common class for descriptors that can be nested.Nc
|
|
s< t t| || |¡ || _|| _|| _|| _|| _|| _dS )a Constructor.
|
|
Args:
|
options: Protocol message options or None
|
to use default message options.
|
options_class_name (str): The class name of the above options.
|
name (str): Name of this protocol message type.
|
full_name (str): Fully-qualified name of this protocol message type,
|
which will include protocol "package" name and the name of any
|
enclosing types.
|
file (FileDescriptor): Reference to file info.
|
containing_type: if provided, this is a nested descriptor, with this
|
descriptor as parent, otherwise None.
|
serialized_start: The start index (inclusive) in block in the
|
file.serialized_pb that describes this descriptor.
|
serialized_end: The end index (exclusive) in block in the
|
file.serialized_pb that describes this descriptor.
|
serialized_options: Protocol message serialized options or None.
|
N) r rH r< r2 Ú full_nameÚfileÚcontaining_typeÚ_serialized_startÚ_serialized_end)
|
r r9 r; r2 rI rJ rK Úserialized_startÚserialized_endr: r r r r< » s
|
ÿz _NestedDescriptorBase.__init__c C sF | j dk r:| jdk r:| jdk r:| | j j| j| j
¡ ntddS )zåCopies this to the matching proto in descriptor_pb2.
|
|
Args:
|
proto: An empty proto instance from descriptor_pb2.
|
|
Raises:
|
Error: If self couldn't be serialized, due to to few constructor
|
arguments.
|
Nz*Descriptor does not contain serialization.)rJ rL rM ÚParseFromStringÚ serialized_pbr ©r Úprotor r r Ú CopyToProtoÞ s
|
|
ÿþ
|
ÿ
|
z!_NestedDescriptorBase.CopyToProto)NNN)r r r r
|
r< rT r r r r r rH ¸ s þ#rH c sV e Zd ZdZer ejZdddZd fdd Z e
|
dd Z d
|
d Z fd d Z ZS )Ú
|
Descriptora= Descriptor for a protocol message type.
|
|
Attributes:
|
name (str): Name of this protocol message type.
|
full_name (str): Fully-qualified name of this protocol message type,
|
which will include protocol "package" name and the name of any
|
enclosing types.
|
containing_type (Descriptor): Reference to the descriptor of the type
|
containing us, or None if this is top-level.
|
fields (list[FieldDescriptor]): Field descriptors for all fields in
|
this type.
|
fields_by_number (dict(int, FieldDescriptor)): Same
|
:class:`FieldDescriptor` objects as in :attr:`fields`, but indexed
|
by "number" attribute in each FieldDescriptor.
|
fields_by_name (dict(str, FieldDescriptor)): Same
|
:class:`FieldDescriptor` objects as in :attr:`fields`, but indexed by
|
"name" attribute in each :class:`FieldDescriptor`.
|
nested_types (list[Descriptor]): Descriptor references
|
for all protocol message types nested within this one.
|
nested_types_by_name (dict(str, Descriptor)): Same Descriptor
|
objects as in :attr:`nested_types`, but indexed by "name" attribute
|
in each Descriptor.
|
enum_types (list[EnumDescriptor]): :class:`EnumDescriptor` references
|
for all enums contained within this type.
|
enum_types_by_name (dict(str, EnumDescriptor)): Same
|
:class:`EnumDescriptor` objects as in :attr:`enum_types`, but
|
indexed by "name" attribute in each EnumDescriptor.
|
enum_values_by_name (dict(str, EnumValueDescriptor)): Dict mapping
|
from enum value name to :class:`EnumValueDescriptor` for that value.
|
extensions (list[FieldDescriptor]): All extensions defined directly
|
within this message type (NOT within a nested type).
|
extensions_by_name (dict(str, FieldDescriptor)): Same FieldDescriptor
|
objects as :attr:`extensions`, but indexed by "name" attribute of each
|
FieldDescriptor.
|
is_extendable (bool): Does this type define any extension ranges?
|
oneofs (list[OneofDescriptor]): The list of descriptors for oneof fields
|
in this message.
|
oneofs_by_name (dict(str, OneofDescriptor)): Same objects as in
|
:attr:`oneofs`, but indexed by "name" attribute.
|
file (FileDescriptor): Reference to file descriptor.
|
|
NTc C s t j ¡ t j |¡S r )r ÚMessageÚ _CheckCalledFromGeneratedFileÚ default_poolZFindMessageTypeByName)r r2 rI ÚfilenamerK ÚfieldsÚ nested_typesÚ
|
enum_typesÚ
|
extensionsr9 r: Ú is_extendableÚextension_rangesÚoneofsrJ rN rO ÚsyntaxÚ
|
create_keyr r r r ! s
|
zDescriptor.__new__c sh |t k rtd tt| j| d|||||||
|
d || _| jD ]
|
}| |_q>tdd |D | _tdd |D | _ d| _
|
|| _ |D ]
|
}| |_qtdd |D | _ || _ | j D ]
|
}| |_q®td d |D | _td
|
d |D | _|| _| jD ]
|
}| |_qîtd d |D | _| | _| | _| dk r(| ng | _td d | jD | _| jD ] }| |_qJ|p`d | _dS )zäArguments to __init__() are as described in the description
|
of Descriptor fields above.
|
|
Note that filename is an obsolete argument, that is not used anymore.
|
Please use file.name to access this as an attribute.
|
rU ZMessageOptions©rN rO r: c s s | ]}|j |fV qd S r ©Únumber©Ú.0Úfr r r Ú <genexpr>W s z&Descriptor.__init__.<locals>.<genexpr>c s s | ]}|j |fV qd S r r1 rf r r r ri X s Nc s s | ]}|j |fV qd S r r1 ©rg Útr r r ri ^ s c s s | ]}|j |fV qd S r r1 rj r r r ri c s c s s$ | ] }|j D ]}|j|fV q qd S r )Úvaluesr2 )rg rk Úvr r r ri d s c s s | ]}|j |fV qd S r r1 rf r r r ri j s c s s | ]}|j |fV qd S r r1 )rg Úor r r ri n s Úproto2)Ú_internal_create_keyr, r rU r< rZ rK ÚdictZfields_by_numberZfields_by_nameÚ_fields_by_camelcase_namer[ Znested_types_by_namer\ Úenum_types_by_nameZenum_values_by_namer] Úextension_scopeÚextensions_by_namer^ r_ r` Zoneofs_by_namera )r r2 rI rY rK rZ r[ r\ r] r9 r: r^ r_ r` rJ rN rO ra rb ÚfieldÚ nested_typeÚ enum_typeÚ extensionZoneofr r r r< ; sR
|
ý
|
|
|
ÿ
|
|
|
|
zDescriptor.__init__c C s& | j dkr tdd | jD | _ | j S )zrSame FieldDescriptor objects as in :attr:`fields`, but indexed by
|
:attr:`FieldDescriptor.camelcase_name`.
|
Nc s s | ]}|j |fV qd S r )Úcamelcase_namerf r r r ri y s z6Descriptor.fields_by_camelcase_name.<locals>.<genexpr>)rr rq rZ r! r r r Úfields_by_camelcase_names s
|
|
ÿ
|
z#Descriptor.fields_by_camelcase_namec C s | j | j| jS )as Returns the string name of an enum value.
|
|
This is just a small helper method to simplify a common operation.
|
|
Args:
|
enum: string name of the Enum.
|
value: int, value of the enum.
|
|
Returns:
|
string name of the enum value.
|
|
Raises:
|
KeyError if either the Enum doesn't exist or the value is not a valid
|
value for the enum.
|
)rs Úvalues_by_numberr2 )r ÚenumÚvaluer r r Ú EnumValueName} s zDescriptor.EnumValueNamec s t t| |¡ dS )zvCopies this to a descriptor_pb2.DescriptorProto.
|
|
Args:
|
proto: An empty descriptor_pb2.DescriptorProto.
|
N)r rU rT rR r r r rT s zDescriptor.CopyToProto)NNNNNNNNNNTNNNNNNN)
|
NNTNNNNNNN)r r r r
|
rF r rU r r r< Úpropertyr{ r rT r r r r r rU ñ sJ + í
|
û8
|
rU c $ s< e Zd ZdZdZdZdZdZdZdZ dZ
|
d Z d
|
Z d Z d Zd ZdZdZdZdZdZdZdZdZdZdZdZdZdZ dZ d Z d
|
Z d Z d Z!eeee ee eeeeeeeee eeeeeeeeee
|
eee e e e e ee e e iZ"dZ#dZ$dZ%dZ&dZ'dZ(dZ)e*re+j,Z-d#ddZ.d$ fdd Z/e0d d Z1e0d d Z2e3d!d" Z4 Z5S )%ÚFieldDescriptora+ Descriptor for a single field in a .proto file.
|
|
Attributes:
|
name (str): Name of this field, exactly as it appears in .proto.
|
full_name (str): Name of this field, including containing scope. This is
|
particularly relevant for extensions.
|
index (int): Dense, 0-indexed index giving the order that this
|
field textually appears within its message in the .proto file.
|
number (int): Tag number declared for this field in the .proto file.
|
|
type (int): (One of the TYPE_* constants below) Declared type.
|
cpp_type (int): (One of the CPPTYPE_* constants below) C++ type used to
|
represent this field.
|
|
label (int): (One of the LABEL_* constants below) Tells whether this
|
field is optional, required, or repeated.
|
has_default_value (bool): True if this field has a default value defined,
|
otherwise false.
|
default_value (Varies): Default value of this field. Only
|
meaningful for non-repeated scalar fields. Repeated fields
|
should always set this to [], and non-repeated composite
|
fields should always set this to None.
|
|
containing_type (Descriptor): Descriptor of the protocol message
|
type that contains this field. Set by the Descriptor constructor
|
if we're passed into one.
|
Somewhat confusingly, for extension fields, this is the
|
descriptor of the EXTENDED message, not the descriptor
|
of the message containing this field. (See is_extension and
|
extension_scope below).
|
message_type (Descriptor): If a composite field, a descriptor
|
of the message type contained in this field. Otherwise, this is None.
|
enum_type (EnumDescriptor): If this field contains an enum, a
|
descriptor of that enum. Otherwise, this is None.
|
|
is_extension: True iff this describes an extension field.
|
extension_scope (Descriptor): Only meaningful if is_extension is True.
|
Gives the message that immediately contains this extension field.
|
Will be None iff we're a top-level (file-level) extension field.
|
|
options (descriptor_pb2.FieldOptions): Protocol message field options or
|
None to use default field options.
|
|
containing_oneof (OneofDescriptor): If the field is a member of a oneof
|
union, contains its descriptor. Otherwise, None.
|
|
file (FileDescriptor): Reference to file descriptor.
|
r( é r) é é é é é é é
|
é é é é é é é é iÿÿÿ i8J i N NTc C s* t j ¡ | rt j |¡S t j |¡S d S r )r rV rW rX ÚFindExtensionByNameÚFindFieldByName)r r2 rI Úindexre ÚtypeÚcpp_typeÚlabelÚ default_valueÚ message_typerx rK Ú is_extensionrt r9 r: Úhas_default_valueÚcontaining_oneofÚ json_namerJ rb r r r r & s
|
zFieldDescriptor.__new__c sÞ |t k rtd tt| ||d¡ || _|| _|| _d| _|dkrPt || _
|
n|| _
|
|| _ || _ || _ || _|| _|| _|| _| | _| | _|
|
| _| | _| | _|| _t ¡ dkrÔ| rÄtj |¡| _ qÚtj |¡| _ nd| _ dS )a The arguments are as described in the description of FieldDescriptor
|
attributes above.
|
|
Note that containing_type may be None, and may be set later if necessary
|
(to deal with circular references between message types, for example).
|
Likewise for extension_scope.
|
r Z FieldOptionsNr ) rp r, r r r< r2 rI rJ Ú_camelcase_nameÚ _ToJsonNamer r re r r r r r rK r rx r rt r r ÚTyper rX r Z _cdescriptorr )r r2 rI r re r r r r r rx rK r rt r9 r: r r r rJ rb r r r r< 2 s@
|
ÿ zFieldDescriptor.__init__c C s | j dkrt| j| _ | j S )zRCamelcase name of this field.
|
|
Returns:
|
str: the name in CamelCase.
|
N)r Ú _ToCamelCaser2 r! r r r rz a s
|
z FieldDescriptor.camelcase_namec C sh | j tjkrdS | jtjks"| jr&dS t| jdr>| jjdkS t| j drV| j jdkS t
|
d| j dS )z¦Whether the field distinguishes between unpopulated and default values.
|
|
Raises:
|
RuntimeError: singular field that is not linked with message nor file.
|
FTra ro zZhas_presence is not ready to use because field %s is not linked with message type nor fileN) r r ÚLABEL_REPEATEDr ÚCPPTYPE_MESSAGEr ÚhasattrrJ ra r rC rI r! r r r Ú has_presencel s ÿ ÿÿz FieldDescriptor.has_presencec C s2 z t j| W S tk
|
r, td| Y nX dS )aï Converts from a Python proto type to a C++ Proto Type.
|
|
The Python ProtocolBuffer classes specify both the 'Python' datatype and the
|
'C++' datatype - and they're not the same. This helper method should
|
translate from one to another.
|
|
Args:
|
proto_type: the Python proto type (descriptor.FieldDescriptor.TYPE_*)
|
Returns:
|
int: descriptor.FieldDescriptor.CPPTYPE_*, the C++ type.
|
Raises:
|
TypeTransformationError: when the Python proto type isn't known.
|
zUnknown proto_type: %sN)r Ú _PYTHON_TO_CPP_PROTO_TYPE_MAPÚKeyErrorr )Z
|
proto_typer r r ÚProtoTypeToCppProtoType s z'FieldDescriptor.ProtoTypeToCppProtoType)NNTNNNN)NNTNNNN)6r r r r
|
Z TYPE_DOUBLEZ
|
TYPE_FLOATZ
|
TYPE_INT64Z TYPE_UINT64Z
|
TYPE_INT32Z TYPE_FIXED64Z TYPE_FIXED32Z TYPE_BOOLZ TYPE_STRINGZ
|
TYPE_GROUPZ TYPE_MESSAGEZ
|
TYPE_BYTESZ TYPE_UINT32Z TYPE_ENUMZ TYPE_SFIXED32Z TYPE_SFIXED64Z TYPE_SINT32Z TYPE_SINT64ZMAX_TYPEZ CPPTYPE_INT32Z CPPTYPE_INT64ZCPPTYPE_UINT32ZCPPTYPE_UINT64ZCPPTYPE_DOUBLEZ CPPTYPE_FLOATZ CPPTYPE_BOOLZ CPPTYPE_ENUMZCPPTYPE_STRINGr£ Z MAX_CPPTYPEr¦ ZLABEL_OPTIONALZLABEL_REQUIREDr¢ Z MAX_LABELZMAX_FIELD_NUMBERZFIRST_RESERVED_FIELD_NUMBERZLAST_RESERVED_FIELD_NUMBERrF r r r r r< r rz r¥ Ú staticmethodr¨ r r r r r r ¤ sÆ 5 î û
|
û/
|
|
|
r c sB e Zd ZdZer ejZd ddZd
|
fdd Z fddZ
|
Z S ) ÚEnumDescriptoraÓ Descriptor for an enum defined in a .proto file.
|
|
Attributes:
|
name (str): Name of the enum type.
|
full_name (str): Full name of the type, including package name
|
and any enclosing type(s).
|
|
values (list[EnumValueDescriptor]): List of the values
|
in this enum.
|
values_by_name (dict(str, EnumValueDescriptor)): Same as :attr:`values`,
|
but indexed by the "name" field of each EnumValueDescriptor.
|
values_by_number (dict(int, EnumValueDescriptor)): Same as :attr:`values`,
|
but indexed by the "number" field of each EnumValueDescriptor.
|
containing_type (Descriptor): Descriptor of the immediate containing
|
type of this enum, or None if this is an enum defined at the
|
top level in a .proto file. Set by Descriptor's constructor
|
if we're passed into one.
|
file (FileDescriptor): Reference to file descriptor.
|
options (descriptor_pb2.EnumOptions): Enum options message or
|
None to use default enum options.
|
Nc C s t j ¡ t j |¡S r )r rV rW rX ZFindEnumTypeByName) r r2 rI rY rl rK r9 r: rJ rN rO rb r r r r ° s
|
zEnumDescriptor.__new__c sz | t k rtd tt| j|d||||| |
|
|d || _| jD ]
|
} | | _q>tdd |D | _tdd t |D | _
|
dS )zÇArguments are as described in the attribute description above.
|
|
Note that filename is an obsolete argument, that is not used anymore.
|
Please use file.name to access this as an attribute.
|
rª Z EnumOptionsrc c s s | ]}|j |fV qd S r r1 ©rg rm r r r ri Ë s z*EnumDescriptor.__init__.<locals>.<genexpr>c s s | ]}|j |fV qd S r rd r« r r r ri Í s N) rp r, r rª r< rl r rq Zvalues_by_nameÚreversedr| ) r r2 rI rY rl rK r9 r: rJ rN rO rb r~ r r r r< · s$
|
ý
|
zEnumDescriptor.__init__c s t t| |¡ dS )zCopies this to a descriptor_pb2.EnumDescriptorProto.
|
|
Args:
|
proto (descriptor_pb2.EnumDescriptorProto): An empty descriptor proto.
|
N)r rª rT rR r r r rT Ï s zEnumDescriptor.CopyToProto)NNNNNNN)NNNNNNN) r r r r
|
rF r rª r r r< rT r r r r r rª s( ý
|
ýrª c s6 e Zd ZdZer ejZdddZd fdd Z Z
|
S ) ÚEnumValueDescriptoraL Descriptor for a single value within an enum.
|
|
Attributes:
|
name (str): Name of this value.
|
index (int): Dense, 0-indexed index giving the order that this
|
value appears textually within its enum in the .proto file.
|
number (int): Actual number assigned to this enum value.
|
type (EnumDescriptor): :class:`EnumDescriptor` to which this value
|
belongs. Set by :class:`EnumDescriptor`'s constructor if we're
|
passed into one.
|
options (descriptor_pb2.EnumValueOptions): Enum value options message or
|
None to use default enum value options options.
|
Nc C s t j ¡ d S r )r rV rW )r r2 r re r r9 r: rb r r r r ì s
|
zEnumValueDescriptor.__new__c s@ |t k rtd tt| ||d¡ || _|| _|| _|| _dS )ú>Arguments are as described in the attribute description above.r ZEnumValueOptionsN) rp r, r r r< r2 r re r )r r2 r re r r9 r: rb r r r r< ö s
|
ÿz EnumValueDescriptor.__init__)NNNN)NNNN) r r r r
|
rF r r r r r< r r r r r r Ù s þ
|
þr c s6 e Zd ZdZer ejZdddZd fdd Z Z
|
S ) ÚOneofDescriptora' Descriptor for a oneof field.
|
|
Attributes:
|
name (str): Name of the oneof field.
|
full_name (str): Full name of the oneof field, including package name.
|
index (int): 0-based index giving the order of the oneof field inside
|
its containing type.
|
containing_type (Descriptor): :class:`Descriptor` of the protocol message
|
type that contains this field. Set by the :class:`Descriptor` constructor
|
if we're passed into one.
|
fields (list[FieldDescriptor]): The list of field descriptors this
|
oneof can contain.
|
Nc C s t j ¡ t j |¡S r )r rV rW rX ZFindOneofByName) r r2 rI r rK rZ r9 r: rb r r r r s
|
zOneofDescriptor.__new__c sF |t k rtd tt| ||d¡ || _|| _|| _|| _|| _ dS )r® r¯ Z OneofOptionsN)
|
rp r, r r¯ r< r2 rI r rK rZ ) r r2 rI r rK rZ r9 r: rb r r r r< s
|
ÿzOneofDescriptor.__init__)NNN)NNN) r r r r
|
rF r r¯ r r r< r r r r r r¯ s þ
|
þr¯ c
|
sJ e Zd ZdZer ejZd ddZd fdd Z dd Z
|
fd d
|
Z Z S ) ÚServiceDescriptoraÑ Descriptor for a service.
|
|
Attributes:
|
name (str): Name of the service.
|
full_name (str): Full name of the service, including package name.
|
index (int): 0-indexed index giving the order that this services
|
definition appears within the .proto file.
|
methods (list[MethodDescriptor]): List of methods provided by this
|
service.
|
methods_by_name (dict(str, MethodDescriptor)): Same
|
:class:`MethodDescriptor` objects as in :attr:`methods_by_name`, but
|
indexed by "name" attribute in each :class:`MethodDescriptor`.
|
options (descriptor_pb2.ServiceOptions): Service options message or
|
None to use default service options.
|
file (FileDescriptor): Reference to file info.
|
Nc C s t j ¡ t j |¡S r )r rV rW rX ZFindServiceByName) r r2 rI r Úmethodsr9 r: rJ rN rO rb r r r r C s
|
zServiceDescriptor.__new__c sh |
|
t k rtd tt| j|d|||d || |d || _|| _tdd |D | _| jD ]
|
} | | _ qXd S )Nr° ZServiceOptionsrc c s s | ]}|j |fV qd S r r1 )rg Úmr r r ri ^ s z-ServiceDescriptor.__init__.<locals>.<genexpr>)
|
rp r, r r° r< r r± rq Úmethods_by_nameÚcontaining_service) r r2 rI r r± r9 r: rJ rN rO rb Úmethodr r r r< R s$
|
ý
|
zServiceDescriptor.__init__c C s | j |d¡S )zÚSearches for the specified method, and returns its descriptor.
|
|
Args:
|
name (str): Name of the method.
|
Returns:
|
MethodDescriptor or None: the descriptor for the requested method, if
|
found.
|
N)r³ Úget)r r2 r r r ÚFindMethodByNamec s z"ServiceDescriptor.FindMethodByNamec s t t| |¡ dS )zCopies this to a descriptor_pb2.ServiceDescriptorProto.
|
|
Args:
|
proto (descriptor_pb2.ServiceDescriptorProto): An empty descriptor proto.
|
N)r r° rT rR r r r rT n s z ServiceDescriptor.CopyToProto)
|
NNNNNNNNNN)NNNNNN) r r r r
|
rF r r° r r r< r· rT r r r r r r° - s. õ
|
þ r° c s> e Zd ZdZer ejZd
|
ddZd fdd Z dd Z
|
Z S ) ÚMethodDescriptoraô Descriptor for a method in a service.
|
|
Attributes:
|
name (str): Name of the method within the service.
|
full_name (str): Full name of method.
|
index (int): 0-indexed index of the method inside the service.
|
containing_service (ServiceDescriptor): The service that contains this
|
method.
|
input_type (Descriptor): The descriptor of the message that this method
|
accepts.
|
output_type (Descriptor): The descriptor of the message that this method
|
returns.
|
client_streaming (bool): Whether this method uses client streaming.
|
server_streaming (bool): Whether this method uses server streaming.
|
options (descriptor_pb2.MethodOptions or None): Method options message, or
|
None to use default method options.
|
FNc C s t j ¡ t j |¡S r )r rV rW rX r· ) r r2 rI r r´ Ú
|
input_typeÚ output_typeÚclient_streamingÚserver_streamingr9 r: rb r r r r s
|
zMethodDescriptor.__new__c sX | t k rtd tt| | |
|
d¡ || _|| _|| _|| _|| _ || _
|
|| _ || _ dS )z²The arguments are as described in the description of MethodDescriptor
|
attributes above.
|
|
Note that containing_service may be None, and may be set later if necessary.
|
r¸ Z MethodOptionsN) rp r, r r¸ r< r2 rI r r´ r¹ rº r» r¼ ) r r2 rI r r´ r¹ rº r» r¼ r9 r: rb r r r r< s
|
ÿzMethodDescriptor.__init__c C sJ | j dk r>ddlm} | ¡ }| j |¡ | |j| j ¡ ntddS )zýCopies this to a descriptor_pb2.MethodDescriptorProto.
|
|
Args:
|
proto (descriptor_pb2.MethodDescriptorProto): An empty descriptor proto.
|
|
Raises:
|
Error: If self couldn't be serialized, due to too few constructor
|
arguments.
|
Nr r> z&Descriptor does not contain a service.) r´ r@ r? ZServiceDescriptorProtorT ZCopyFromrµ r r )r rS r? Z service_protor r r rT ½ s
|
|
z MethodDescriptor.CopyToProto)FFNNN)FFNNN) r r r r
|
rF r r¸ r r r< rT r r r r r r¸ x s õ
|
õ r¸ c sB e Zd ZdZer$ejZd fdd Zd
|
fdd Z dd Z
|
Z S ) ÚFileDescriptoraÖ Descriptor for a file. Mimics the descriptor_pb2.FileDescriptorProto.
|
|
Note that :attr:`enum_types_by_name`, :attr:`extensions_by_name`, and
|
:attr:`dependencies` fields are only set by the
|
:py:mod:`google.protobuf.message_factory` module, and not by the generated
|
proto code.
|
|
Attributes:
|
name (str): Name of file, relative to root of source tree.
|
package (str): Name of the package
|
syntax (str): string indicating syntax of the file (can be "proto2" or
|
"proto3")
|
serialized_pb (bytes): Byte string of serialized
|
:class:`descriptor_pb2.FileDescriptorProto`.
|
dependencies (list[FileDescriptor]): List of other :class:`FileDescriptor`
|
objects this :class:`FileDescriptor` depends on.
|
public_dependencies (list[FileDescriptor]): A subset of
|
:attr:`dependencies`, which were declared as "public".
|
message_types_by_name (dict(str, Descriptor)): Mapping from message names
|
to their :class:`Descriptor`.
|
enum_types_by_name (dict(str, EnumDescriptor)): Mapping from enum names to
|
their :class:`EnumDescriptor`.
|
extensions_by_name (dict(str, FieldDescriptor)): Mapping from extension
|
names declared at file scope to their :class:`FieldDescriptor`.
|
services_by_name (dict(str, ServiceDescriptor)): Mapping from services'
|
names to their :class:`ServiceDescriptor`.
|
pool (DescriptorPool): The pool this descriptor belongs to. When not
|
passed to the constructor, the global default pool is used.
|
Nc s^ |dkr:zt j |¡W S tk
|
r6 td| Y qZX n |rJt j |¡S tt| | ¡S d S )Nó z'Please link in cpp generated lib for %s) r rX ÚFindFileByNamer§ rC ZAddSerializedFiler r½ r ) r r2 Úpackager9 r: rQ Ú dependenciesÚpublic_dependenciesra Úpoolrb r r r r ò s zFileDescriptor.__new__c s |
|
t k rtd tt| ||d¡ | dkr@ddlm} | ¡ } | | _i | _ || _
|
|| _ |p^d| _ || _ i | _i | _i | _|pg | _|pg | _dS )z Constructor.r½ Z FileOptionsNr )Údescriptor_poolro )rp r, r r½ r< r@ rÄ ZDefaultrà Úmessage_types_by_namer2 rÀ ra rQ rs ru Zservices_by_namerÁ r ) r r2 rÀ r9 r: rQ rÁ r ra rà rb rÄ r r r r< s*
|
ÿ
|
|
zFileDescriptor.__init__c C s | | j¡ dS )z~Copies this to a descriptor_pb2.FileDescriptorProto.
|
|
Args:
|
proto: An empty descriptor_pb2.FileDescriptorProto.
|
N)rP rQ rR r r r rT s zFileDescriptor.CopyToProto)NNNNNNNN)NNNNNNNN) r r r r
|
rF r r½ r r r< rT r r r r r r½ Ð s, ý ýr½ c C s | |¡ | S )zParses serialized options.
|
|
This helper function is used to parse serialized options in generated
|
proto2 files. It must not be used outside proto2.
|
)rP )ÚmessageÚstringr r r rD ( s
|
rD c C sn d}g }| D ]6}|dkr"|rBd}q |r:| | ¡ ¡ d}q ||7 }q |rd|d ¡ rd|d ¡ |d< d |¡S )z+Converts name to camel-case and returns it.FÚ_Tr Ú )ÚappendÚupperÚisupperÚlowerÚjoin©r2 Zcapitalize_nextÚresultÚcr r r r¡ 2 s
|
r¡ c C s | d¡r| jS dS dS )zCReturns the value of the field `options`, or None if it is not set.r9 N)ÚHasFieldr9 )Zdescriptor_protor r r Ú_OptionsOrNoneG s
|
rÓ c C sJ d}g }| D ]2}|dkr d}q |r6| | ¡ ¡ d}q ||7 }q d |¡S )z*Converts name to Json name and returns it.FrÈ TrÉ )rÊ rË rÎ rÏ r r r r O s
|
r rÉ c C sr t ¡ dkr¦|r¦ddlm} | ¡ }|j ¡ | ¡ t t
|
d¡¡ d¡}|rrt
|
j | dd¡|d ¡|_||_n
|
|d |_tj |¡ tj |j¡}tr¦|j| j S | jg}|r¾| d|¡ i } | jD ]B}
|
d ||
|
jg ¡} t|
|
j| d d
|
d t|
|
j D t d } | | | < qÈi } | j D ]6}d ||jg ¡} t |d |¡d |d}|| | < qg }| j D ]Ü}d ||jg ¡} d } d }|j!r|j!}nd }| "d¡rä|j#}d ||| $d¡d d
g ¡}|| krÒ| | }n|| krä| | } t%|j| |j&d |j&|j't% (|j'¡|j)d || d d d t*|d |t d}| +|¡ qXd |¡}t,| j|d d |t-| .¡ t-| .¡ g t*| t d
|
S )a Make a protobuf Descriptor given a DescriptorProto protobuf.
|
|
Handles nested descriptors. Note that this is limited to the scope of defining
|
a message inside of another message. Composite fields can currently only be
|
resolved if the message is defined in the same scope as the field.
|
|
Args:
|
desc_proto: The descriptor_pb2.DescriptorProto protobuf message.
|
package: Optional package name for the new message Descriptor (string).
|
build_file_if_cpp: Update the C++ descriptor pool if api matches.
|
Set to False on recursion, so no duplicates are created.
|
syntax: The syntax/semantics that should be used. Set to "proto3" to get
|
proto3 field presence semantics.
|
Returns:
|
A Descriptor for protobuf messages.
|
r r r> r ÚasciiÚ.ú/z.protoNc S s$ g | ] \}}t |j||jtd qS )©rb )r r2 re rp )rg ÚiiZenum_valr r r Ú
|
<listcomp> s þ ÿz"MakeDescriptor.<locals>.<listcomp>r× F)rÀ Úbuild_file_if_cppra Ú type_namer( )r9 r r rb )r9 rb )/r r r@ r? ZFileDescriptorProtor ÚaddZ MergeFromÚbinasciiÚhexlifyÚosÚurandomÚdecodeÚpathrÎ Úreplacer2 rÀ r rX ZAddr¿ rF rÅ Úinsertrx rª Ú enumerater~ rp rw ÚMakeDescriptorrv r rÒ rÛ Úrfindr re r r¨ r rÓ rÊ rU Úlistrl )Z
|
desc_protorÀ rÚ ra r? Zfile_descriptor_protoZ
|
proto_namerÐ Zfull_message_namer\ Z
|
enum_protorI Z enum_descr[ Z nested_protoZ nested_descrZ Z field_protor rÛ Zfull_type_namerv Z desc_namer r r ræ ` sª ÿ
|
|
ýû
|
|
ý
|
ÿ
|
|
|
|
ú
|
|
|
ýræ )rÉ TN)'r
|
Ú
|
__author__r r. Zgoogle.protobuf.internalr rF r rÝ rß Zgoogle.protobuf.pyextr Ú Exceptionr r r r r r r r r, r- rp r4 rH rU r rª r r¯ r° r¸ r½ rD r¡ rÓ r ræ r r r r Ú<module> sN G9 4 rD,(KXX
|
ÿ
|
