?ohmjdZdZGddeZGddeZGddeZGdd eZd Zy ) z6Contains an abstract base class for protocol messages.z#robinson@google.com (Will Robinson)ceZdZdZy)Errorz Base error type for this module.N__name__ __module__ __qualname____doc__ r cD|j|j|S)zParse serialized protocol buffer data in binary form into this message. Like :func:`MergeFromString()`, except we clear the object first. Raises: message.DecodeError if the input cannot be parsed. )r.r9r7s r ParseFromStringzMessage.ParseFromStrings JJL    ++r c t)aSerializes the protocol message to a binary string. Keyword Args: deterministic (bool): 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: EncodeError: if the message isn't initialized (see :func:`IsInitialized`). rrkwargss r SerializeToStringzMessage.SerializeToString  r c t)aSerializes the protocol message to a binary string. This method is similar to SerializeToString but doesn't check if the message is initialized. Keyword Args: deterministic (bool): If true, requests deterministic serialization of the protobuf, with predictable ordering of map keys. Returns: bytes: A serialized representation of the partial message. rr=s r SerializePartialToStringz Message.SerializePartialToString  r ct)a'Returns a list of (FieldDescriptor, value) tuples for present fields. 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 number. Returns: list[tuple(FieldDescriptor, value)]: field descriptors and values for all fields in the message which are not empty. The values vary by field type. rr%s r ListFieldszMessage.ListFieldsrCr ct)aChecks if a certain field is set for the message. For a oneof group, checks if any field inside is set. Note that if the field_name is not defined in the message descriptor, :exc:`ValueError` will be raised. Args: field_name (str): The name of the field to check for presence. Returns: bool: Whether a value has been set for the named field. Raises: ValueError: if the `field_name` is not a member of this message. rr field_names r HasFieldzMessage.HasField r ct)a^Clears the contents of a given field. Inside a oneof group, clears the field set. If the name neither refers to a defined field or oneof group, :exc:`ValueError` is raised. Args: field_name (str): The name of the field to check for presence. Raises: ValueError: if the `field_name` is not a member of this message. rrGs r ClearFieldzMessage.ClearFields  r ct)aEReturns the name of the field that is set inside a oneof group. If no field is set, returns None. Args: oneof_group (str): the name of the oneof group to check. Returns: str or None: The name of the group that is set, or None. Raises: ValueError: no group with the given name exists r)r oneof_groups r WhichOneofzMessage.WhichOneofr@r ct)aChecks if a certain extension is present for this message. Extensions are retrieved using the :attr:`Extensions` mapping (if present). Args: field_descriptor: The field descriptor for the extension to check. Returns: bool: Whether the extension is present for this message. Raises: KeyError: if the extension is repeated. Similar to repeated fields, there is no separate notion of presence: a "not present" repeated extension is an empty list. rrfield_descriptors r HasExtensionzMessage.HasExtension rJr ct)zClears the contents of a given extension. Args: field_descriptor: The field descriptor for the extension to clear. rrQs r ClearExtensionzMessage.ClearExtension2 r ct)zqReturns the UnknownFieldSet. Returns: UnknownFieldSet: The unknown fields stored in this message. rr%s r UnknownFieldszMessage.UnknownFields:rVr ct)zlClears all fields in the :class:`UnknownFieldSet`. This operation is recursive for nested message. rr%s r DiscardUnknownFieldszMessage.DiscardUnknownFieldsBs r ct)zReturns the serialized size of this message. Recursively calls ByteSize() on all contained messages. Returns: int: The number of bytes required to serialize this message. rr%s r ByteSizezMessage.ByteSizeIr3r ctrr)clsss r FromStringzMessage.FromStringSr r ctrr)rRs r RegisterExtensionzMessage.RegisterExtensionXr r ct)a6Internal 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. r)rmessage_listeners r _SetListenerzMessage._SetListener\s & r c6t|jS)Support the pickle protocol.)r8)dictrBr%s r __getstate__zMessage.__getstate__qs 488: ;;r c|j|d}t|ts|jd}|j |y)rgr8latin1N)__init__ isinstancebytesencoder;)rstater8s r __setstate__zMessage.__setstate__us?MMO|$J j% ($$X.j$r c|j}|jt|d|jfS|}t|j f|jfS)Nr ) DESCRIPTORcontaining_typerri_InternalConstructMessage full_name)rmessage_descriptor containers r __reduce__zMessage.__reduce__s]))1 $ZT..0 00#I % (;(;'=     !!r r)&rrrr __slots__rsrrr"r&r)r+rr/r.r2r5r9r;r?rBrErIrLrOrSrUrXrZr\ classmethodr` staticmethodrbrerirqryr r r rrs)* !)  B , > $  $*<% !r rcVddlm}|jj|S)zConstructs a nested message.)symbol_database)google.protobufrDefault GetSymbol)rvrs r rurus$- 7 " , ,Y 7 99r N) r __author__ Exceptionrr robjectrrur r r rsG= 2 I % % i!fi!X :r