Current File : //usr/lib/python2.7/site-packages/google/protobuf/internal/message_listener.pyc
�
Du�ac @ s< d Z d Z d e f d � � YZ d e f d � � YZ d S( s� Defines a listener interface for observing certain
state transitions on Message objects.
Also defines a null implementation of this interface.
s# robinson@google.com (Will Robinson)t MessageListenerc B s e Z d Z d � Z RS( s Listens for modifications made to a message. Meant to be registered via
Message._SetListener().
Attributes:
dirty: If True, then calling Modified() would be a no-op. This can be
used to avoid these calls entirely in the common case.
c C s
t � d S( s Called every time the message is modified in such a way that the parent
message may need to be updated. This currently means either:
(a) The message was modified for the first time, so the parent message
should henceforth mark the message as present.
(b) The message's cached byte size became dirty -- i.e. the message was
modified for the first time after a previous call to ByteSize().
Therefore the parent should also mark its byte size as dirty.
Note that (a) implies (b), since new objects start out with a client cached
size (zero). However, we document (a) explicitly because it is important.
Modified() will *only* be called in response to one of these two events --
not every time the sub-message is modified.
Note that if the listener's |dirty| attribute is true, then calling
Modified at the moment would be a no-op, so it can be skipped. Performance-
sensitive callers should check this attribute directly before calling since
it will be true most of the time.
N( t NotImplementedError( t self( ( sM /usr/lib/python2.7/site-packages/google/protobuf/internal/message_listener.pyt Modified2 s ( t __name__t
__module__t __doc__R ( ( ( sM /usr/lib/python2.7/site-packages/google/protobuf/internal/message_listener.pyR ( s t NullMessageListenerc B s e Z d Z d � Z RS( s% No-op MessageListener implementation.c C s d S( N( ( R ( ( sM /usr/lib/python2.7/site-packages/google/protobuf/internal/message_listener.pyR M s ( R R R R ( ( ( sM /usr/lib/python2.7/site-packages/google/protobuf/internal/message_listener.pyR I s N( R t
__author__t objectR R ( ( ( sM /usr/lib/python2.7/site-packages/google/protobuf/internal/message_listener.pyt <module># s !
if you don't want to be vaporized in a nuclear explosion, i simply have to become nuclear myself… i am atomic