�
Du�ac @ sh d Z d Z d e f d � � YZ d e f d � � YZ d e f d � � YZ d e f d � � YZ d
S( s6 Contains an abstract base class for protocol messages.s# robinson@google.com (Will Robinson)t Errorc B s e Z RS( ( t __name__t
__module__( ( ( s; /usr/lib/python2.7/site-packages/google/protobuf/message.pyR ' s t DecodeErrorc B s e Z RS( ( R R ( ( ( s; /usr/lib/python2.7/site-packages/google/protobuf/message.pyR ( s t EncodeErrorc B s e Z RS( ( R R ( ( ( s; /usr/lib/python2.7/site-packages/google/protobuf/message.pyR ) s t Messagec B s e Z d Z g Z d Z d d � Z d � Z d � Z d � Z d � Z
d � Z d � Z d � Z
d � Z d
� Z d � Z d � Z d
� Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z RS( sU Abstract base class for protocol messages.
Protocol message classes are almost always generated by the protocol
compiler. These generated types subclass Message and implement the methods
shown below.
TODO(robinson): Link to an HTML document here.
TODO(robinson): Document that instances of this class will also
have an Extensions attribute with __getitem__ and __setitem__.
Again, not sure how to best convey this.
TODO(robinson): Document that the class must also have a static
RegisterExtension(extension_field) method.
Not sure how to best express at this point.
c C s t | � � } | j | � | S( N( t typet MergeFrom( t selft memot clone( ( s; /usr/lib/python2.7/site-packages/google/protobuf/message.pyt __deepcopy__E s
c C s
t � d S( s9 Recursively compares two messages by value and structure.N( t NotImplementedError( R t other_msg( ( s; /usr/lib/python2.7/site-packages/google/protobuf/message.pyt __eq__J s c C s | | k S( N( ( R R
( ( s; /usr/lib/python2.7/site-packages/google/protobuf/message.pyt __ne__N s c C s t d � � d S( Ns unhashable object( t TypeError( R ( ( s; /usr/lib/python2.7/site-packages/google/protobuf/message.pyt __hash__R s c C s
t � d S( s7 Outputs a human-readable representation of the message.N( R ( R ( ( s; /usr/lib/python2.7/site-packages/google/protobuf/message.pyt __str__U s c C s
t � d S( s7 Outputs a human-readable representation of the message.N( R ( R ( ( s; /usr/lib/python2.7/site-packages/google/protobuf/message.pyt __unicode__Y s c C s
t � d S( s� Merges the contents of the specified message into current message.
This method merges the contents of the specified message into the current
message. Singular fields that are set in the specified message overwrite
the corresponding fields in the current message. Repeated fields are
appended. Singular sub-messages and groups are recursively merged.
Args:
other_msg: Message to merge into the current message.
N( R ( R R
( ( s; /usr/lib/python2.7/site-packages/google/protobuf/message.pyR ] s c C s+ | | k r d S| j � | j | � d S( s� Copies the content of the specified message into the current message.
The method clears the current message and then merges the specified
message using MergeFrom.
Args:
other_msg: Message to copy into the current one.
N( t ClearR ( R R
( ( s; /usr/lib/python2.7/site-packages/google/protobuf/message.pyt CopyFromj s
c C s
t � d S( s, Clears all data that was set in the message.N( R ( R ( ( s; /usr/lib/python2.7/site-packages/google/protobuf/message.pyR x s c C s
t � d S( s Mark this as present in the parent.
This normally happens automatically when you assign a field of a
sub-message, but sometimes you want to make the sub-message
present while keeping it empty. If you find yourself using this,
you may want to reconsider your design.N( R ( R ( ( s; /usr/lib/python2.7/site-packages/google/protobuf/message.pyt SetInParent| s c C s
t � d S( s� Checks if the message is initialized.
Returns:
The method returns True if the message is initialized (i.e. all of its
required fields are set).
N( R ( R ( ( s; /usr/lib/python2.7/site-packages/google/protobuf/message.pyt
IsInitialized� s c C s
t � d S( sZ Merges serialized protocol buffer data into this message.
When we find a field in |serialized| that is already present
in this message:
- If it's a "repeated" field, we append to the end of our list.
- Else, if it's a scalar, we overwrite our field.
- Else, (it's a nonrepeated composite), we recursively merge
into the existing composite.
TODO(robinson): Document handling of unknown fields.
Args:
serialized: Any object that allows us to call buffer(serialized)
to access a string of bytes using the buffer interface.
TODO(robinson): When we switch to a helper, this will return None.
Returns:
The number of bytes read from |serialized|.
For non-group messages, this will always be len(serialized),
but for messages which are actually groups, this will
generally be less than len(serialized), since we must
stop when we reach an END_GROUP tag. Note that if
we *do* stop because of an END_GROUP tag, the number
of bytes returned does not include the bytes
for the END_GROUP tag information.
N( R ( R t
serialized( ( s; /usr/lib/python2.7/site-packages/google/protobuf/message.pyt MergeFromString� s c C s | j � | j | � d S( s� Parse serialized protocol buffer data into this message.
Like MergeFromString(), except we clear the object first and
do not return the value that MergeFromString returns.
N( R R ( R R ( ( s; /usr/lib/python2.7/site-packages/google/protobuf/message.pyt ParseFromString� s
c K s
t � d S( s Serializes the protocol message to a binary string.
Arguments:
**kwargs: Keyword arguments to the serialize method, accepts
the following keyword args:
deterministic: If true, requests deterministic serialization of the
protobuf, with predictable ordering of map keys.
Returns:
A binary string representation of the message if all of the required
fields in the message are set (i.e. the message is initialized).
Raises:
message.EncodeError if the message isn't initialized.
N( R ( R t kwargs( ( s; /usr/lib/python2.7/site-packages/google/protobuf/message.pyt SerializeToString� s c K s
t � d S( s� Serializes the protocol message to a binary string.
This method is similar to SerializeToString but doesn't check if the
message is initialized.
Arguments:
**kwargs: Keyword arguments to the serialize method, accepts
the following keyword args:
deterministic: If true, requests deterministic serialization of the
protobuf, with predictable ordering of map keys.
Returns:
A string representation of the partial message.
N( R ( R R ( ( s; /usr/lib/python2.7/site-packages/google/protobuf/message.pyt SerializePartialToString� s c C s
t � d S( s� Returns a list of (FieldDescriptor, value) tuples for all
fields in the message which are not empty. A message field is
non-empty if HasField() would return true. A singular primitive field
is non-empty if HasField() would return true in proto2 or it is non zero
in proto3. A repeated field is non-empty if it contains at least one
element. The fields are ordered by field numberN( R ( R ( ( s; /usr/lib/python2.7/site-packages/google/protobuf/message.pyt
ListFields� s c C s
t � d S( s� Checks if a certain field is set for the message, or if any field inside
a oneof group is set. Note that if the field_name is not defined in the
message descriptor, ValueError will be raised.N( R ( R t
field_name( ( s; /usr/lib/python2.7/site-packages/google/protobuf/message.pyt HasField� s c C s
t � d S( s� Clears the contents of a given field, or the field set inside a oneof
group. If the name neither refers to a defined field or oneof group,
ValueError is raised.N( R ( R R ( ( s; /usr/lib/python2.7/site-packages/google/protobuf/message.pyt
ClearField� s c C s
t � d S( s� Returns the name of the field that is set inside a oneof group, or
None if no field is set. If no group with the given name exists, ValueError
will be raised.N( R ( R t oneof_group( ( s; /usr/lib/python2.7/site-packages/google/protobuf/message.pyt
WhichOneof s c C s
t � d S( N( R ( R t extension_handle( ( s; /usr/lib/python2.7/site-packages/google/protobuf/message.pyt HasExtension s c C s
t � d S( N( R ( R R$ ( ( s; /usr/lib/python2.7/site-packages/google/protobuf/message.pyt ClearExtension s c C s
t � d S( N( R ( R ( ( s; /usr/lib/python2.7/site-packages/google/protobuf/message.pyt DiscardUnknownFields s c C s
t � d S( sm Returns the serialized size of this message.
Recursively calls ByteSize() on all contained messages.
N( R ( R ( ( s; /usr/lib/python2.7/site-packages/google/protobuf/message.pyt ByteSize s c C s
t � d S( s6 Internal method used by the protocol message implementation.
Clients should not call this directly.
Sets a listener that this message will call on certain state transitions.
The purpose of this method is to register back-edges from children to
parents at runtime, for the purpose of setting "has" bits and
byte-size-dirty bits in the parent and ancestor objects whenever a child or
descendant object is modified.
If the client wants to disconnect this Message from the object tree, she
explicitly sets callback to None.
If message_listener is None, unregisters any existing listener. Otherwise,
message_listener must implement the MessageListener interface in
internal/message_listener.py, and we discard any listener registered
via a previous _SetListener() call.
N( R ( R t message_listener( ( s; /usr/lib/python2.7/site-packages/google/protobuf/message.pyt _SetListener s c C s t d | j � � S( s Support the pickle protocol.R ( t dictR ( R ( ( s; /usr/lib/python2.7/site-packages/google/protobuf/message.pyt __getstate__- s c C s | j � | j | d � d S( s Support the pickle protocol.R N( t __init__R ( R t state( ( s; /usr/lib/python2.7/site-packages/google/protobuf/message.pyt __setstate__1 s
N( R R t __doc__t __slots__t Nonet
DESCRIPTORR R R R R R R R R R R R R R R R R R! R# R% R& R' R( R* R, R/ ( ( ( s; /usr/lib/python2.7/site-packages/google/protobuf/message.pyR , s:
! N( R0 t
__author__t ExceptionR R R t objectR ( ( ( s; /usr/lib/python2.7/site-packages/google/protobuf/message.pyt <module># s
| Name | Type | Size | Permission | Actions |
|---|---|---|---|---|
| compiler | Folder | 0755 |
|
|
| internal | Folder | 0755 |
|
|
| pyext | Folder | 0755 |
|
|
| util | Folder | 0755 |
|
|
| __init__.py | File | 1.85 KB | 0644 |
|
| __init__.pyc | File | 409 B | 0644 |
|
| __init__.pyo | File | 409 B | 0644 |
|
| any_pb2.py | File | 2.62 KB | 0644 |
|
| any_pb2.pyc | File | 2.76 KB | 0644 |
|
| any_pb2.pyo | File | 2.76 KB | 0644 |
|
| any_test_pb2.py | File | 3.13 KB | 0644 |
|
| any_test_pb2.pyc | File | 2.92 KB | 0644 |
|
| any_test_pb2.pyo | File | 2.92 KB | 0644 |
|
| api_pb2.py | File | 10.64 KB | 0644 |
|
| api_pb2.pyc | File | 6.63 KB | 0644 |
|
| api_pb2.pyo | File | 6.63 KB | 0644 |
|
| descriptor.py | File | 38.68 KB | 0644 |
|
| descriptor.pyc | File | 36.17 KB | 0644 |
|
| descriptor.pyo | File | 36.17 KB | 0644 |
|
| descriptor_database.py | File | 5.79 KB | 0644 |
|
| descriptor_database.pyc | File | 4.87 KB | 0644 |
|
| descriptor_database.pyo | File | 4.87 KB | 0644 |
|
| descriptor_pb2.py | File | 87.13 KB | 0644 |
|
| descriptor_pb2.pyc | File | 42.32 KB | 0644 |
|
| descriptor_pb2.pyo | File | 42.32 KB | 0644 |
|
| descriptor_pool.py | File | 35.23 KB | 0644 |
|
| descriptor_pool.pyc | File | 29.59 KB | 0644 |
|
| descriptor_pool.pyo | File | 29.56 KB | 0644 |
|
| duration_pb2.py | File | 2.71 KB | 0644 |
|
| duration_pb2.pyc | File | 2.79 KB | 0644 |
|
| duration_pb2.pyo | File | 2.79 KB | 0644 |
|
| empty_pb2.py | File | 1.91 KB | 0644 |
|
| empty_pb2.pyc | File | 2.2 KB | 0644 |
|
| empty_pb2.pyo | File | 2.2 KB | 0644 |
|
| field_mask_pb2.py | File | 2.37 KB | 0644 |
|
| field_mask_pb2.pyc | File | 2.65 KB | 0644 |
|
| field_mask_pb2.pyo | File | 2.65 KB | 0644 |
|
| json_format.py | File | 28.52 KB | 0644 |
|
| json_format.pyc | File | 24.21 KB | 0644 |
|
| json_format.pyo | File | 24.21 KB | 0644 |
|
| map_proto2_unittest_pb2.py | File | 54.59 KB | 0644 |
|
| map_proto2_unittest_pb2.pyc | File | 25.53 KB | 0644 |
|
| map_proto2_unittest_pb2.pyo | File | 25.53 KB | 0644 |
|
| map_unittest_pb2.py | File | 124.44 KB | 0644 |
|
| map_unittest_pb2.pyc | File | 54.63 KB | 0644 |
|
| map_unittest_pb2.pyo | File | 54.63 KB | 0644 |
|
| message.py | File | 11.19 KB | 0644 |
|
| message.pyc | File | 12.11 KB | 0644 |
|
| message.pyo | File | 12.11 KB | 0644 |
|
| message_factory.py | File | 6.13 KB | 0644 |
|
| message_factory.pyc | File | 4.58 KB | 0644 |
|
| message_factory.pyo | File | 4.58 KB | 0644 |
|
| proto_builder.py | File | 5.08 KB | 0644 |
|
| proto_builder.pyc | File | 3.29 KB | 0644 |
|
| proto_builder.pyo | File | 3.29 KB | 0644 |
|
| reflection.py | File | 4.46 KB | 0644 |
|
| reflection.pyc | File | 2.98 KB | 0644 |
|
| reflection.pyo | File | 2.98 KB | 0644 |
|
| service.py | File | 8.93 KB | 0644 |
|
| service.pyc | File | 9.4 KB | 0644 |
|
| service.pyo | File | 9.4 KB | 0644 |
|
| service_reflection.py | File | 10.76 KB | 0644 |
|
| service_reflection.pyc | File | 11.05 KB | 0644 |
|
| service_reflection.pyo | File | 11.05 KB | 0644 |
|
| source_context_pb2.py | File | 2.48 KB | 0644 |
|
| source_context_pb2.pyc | File | 2.77 KB | 0644 |
|
| source_context_pb2.pyo | File | 2.77 KB | 0644 |
|
| struct_pb2.py | File | 10.64 KB | 0644 |
|
| struct_pb2.pyc | File | 6.69 KB | 0644 |
|
| struct_pb2.pyo | File | 6.69 KB | 0644 |
|
| symbol_database.py | File | 6.27 KB | 0644 |
|
| symbol_database.pyc | File | 5.98 KB | 0644 |
|
| symbol_database.pyo | File | 5.98 KB | 0644 |
|
| test_messages_proto2_pb2.py | File | 105.2 KB | 0644 |
|
| test_messages_proto2_pb2.pyc | File | 51.3 KB | 0644 |
|
| test_messages_proto2_pb2.pyo | File | 51.3 KB | 0644 |
|
| test_messages_proto3_pb2.py | File | 115.05 KB | 0644 |
|
| test_messages_proto3_pb2.pyc | File | 57.01 KB | 0644 |
|
| test_messages_proto3_pb2.pyo | File | 57.01 KB | 0644 |
|
| text_encoding.py | File | 4.51 KB | 0644 |
|
| text_encoding.pyc | File | 3.26 KB | 0644 |
|
| text_encoding.pyo | File | 3.26 KB | 0644 |
|
| text_format.py | File | 49.69 KB | 0644 |
|
| text_format.pyc | File | 46.59 KB | 0644 |
|
| text_format.pyo | File | 46.56 KB | 0644 |
|
| timestamp_pb2.py | File | 2.73 KB | 0644 |
|
| timestamp_pb2.pyc | File | 2.81 KB | 0644 |
|
| timestamp_pb2.pyo | File | 2.81 KB | 0644 |
|
| type_pb2.py | File | 21.35 KB | 0644 |
|
| type_pb2.pyc | File | 11.96 KB | 0644 |
|
| type_pb2.pyo | File | 11.96 KB | 0644 |
|
| unittest_arena_pb2.py | File | 4.4 KB | 0644 |
|
| unittest_arena_pb2.pyc | File | 3.64 KB | 0644 |
|
| unittest_arena_pb2.pyo | File | 3.64 KB | 0644 |
|
| unittest_custom_options_pb2.py | File | 88.18 KB | 0644 |
|
| unittest_custom_options_pb2.pyc | File | 40.64 KB | 0644 |
|
| unittest_custom_options_pb2.pyo | File | 40.64 KB | 0644 |
|
| unittest_import_pb2.py | File | 4.49 KB | 0644 |
|
| unittest_import_pb2.pyc | File | 3.99 KB | 0644 |
|
| unittest_import_pb2.pyo | File | 3.99 KB | 0644 |
|
| unittest_import_public_pb2.py | File | 2.29 KB | 0644 |
|
| unittest_import_public_pb2.pyc | File | 2.56 KB | 0644 |
|
| unittest_import_public_pb2.pyo | File | 2.56 KB | 0644 |
|
| unittest_mset_pb2.py | File | 9.73 KB | 0644 |
|
| unittest_mset_pb2.pyc | File | 5.98 KB | 0644 |
|
| unittest_mset_pb2.pyo | File | 5.98 KB | 0644 |
|
| unittest_mset_wire_format_pb2.py | File | 3.76 KB | 0644 |
|
| unittest_mset_wire_format_pb2.pyc | File | 3.27 KB | 0644 |
|
| unittest_mset_wire_format_pb2.pyo | File | 3.27 KB | 0644 |
|
| unittest_no_arena_import_pb2.py | File | 2.18 KB | 0644 |
|
| unittest_no_arena_import_pb2.pyc | File | 2.43 KB | 0644 |
|
| unittest_no_arena_import_pb2.pyo | File | 2.43 KB | 0644 |
|
| unittest_no_arena_pb2.py | File | 51.17 KB | 0644 |
|
| unittest_no_arena_pb2.pyc | File | 27.36 KB | 0644 |
|
| unittest_no_arena_pb2.pyo | File | 27.36 KB | 0644 |
|
| unittest_no_generic_services_pb2.py | File | 4.15 KB | 0644 |
|
| unittest_no_generic_services_pb2.pyc | File | 4.02 KB | 0644 |
|
| unittest_no_generic_services_pb2.pyo | File | 4.02 KB | 0644 |
|
| unittest_pb2.py | File | 335.22 KB | 0644 |
|
| unittest_pb2.pyc | File | 159.03 KB | 0644 |
|
| unittest_pb2.pyo | File | 159.03 KB | 0644 |
|
| unittest_proto3_arena_pb2.py | File | 59.16 KB | 0644 |
|
| unittest_proto3_arena_pb2.pyc | File | 29.43 KB | 0644 |
|
| unittest_proto3_arena_pb2.pyo | File | 29.43 KB | 0644 |
|
| wrappers_pb2.py | File | 11.26 KB | 0644 |
|
| wrappers_pb2.pyc | File | 6.49 KB | 0644 |
|
| wrappers_pb2.pyo | File | 6.49 KB | 0644 |
|