twisted.protocols.basic.IntNStringReceiver(protocol.Protocol, _PauseableMixin) class documentation

Part of twisted.protocols.basic (View In Hierarchy)

Known subclasses: twisted.protocols.basic.Int16StringReceiver, twisted.protocols.basic.Int32StringReceiver, twisted.protocols.basic.Int8StringReceiver

Generic class for length prefixed protocols.

Instance Variable structFormat format used for struct packing/unpacking. Define it in subclass. (type: str)
Instance Variable prefixLength length of the prefix, in bytes. Define it in subclass, using struct.calcsize(structFormat) (type: int)
Method stringReceived Override this for notification when each complete string is received.
Method lengthLimitExceeded Callback invoked when a length prefix greater than MAX_LENGTH is received. The default implementation disconnects the transport. Override this.
Method dataReceived Convert int prefixed strings into calls to stringReceived.
Method sendString Send a prefixed string to the other end of the connection.
Instance Variable _unprocessed bytes received, but not yet broken up into messages / sent to stringReceived. _compatibilityOffset must be updated when this value is updated so that the recvd attribute can be generated correctly. (type: bytes)
Instance Variable _compatibilityOffset the offset within _unprocessed to the next message to be parsed. (used to generate the recvd attribute) (type: int)

Inherited from Protocol:

Method logPrefix Return a prefix matching the class name, to identify log messages related to this protocol instance.
Method connectionLost Called when the connection is shut down.

Inherited from BaseProtocol (via Protocol):

Method makeConnection Make a connection to a transport and a server.
Method connectionMade Called when a connection is made.

Inherited from _PauseableMixin:

Method pauseProducing Undocumented
Method resumeProducing Undocumented
Method stopProducing Undocumented
_unprocessed =
bytes received, but not yet broken up into messages / sent to stringReceived. _compatibilityOffset must be updated when this value is updated so that the recvd attribute can be generated correctly. (type: bytes)
structFormat =
format used for struct packing/unpacking. Define it in subclass. (type: str)
prefixLength =
length of the prefix, in bytes. Define it in subclass, using struct.calcsize(structFormat) (type: int)
_compatibilityOffset =
the offset within _unprocessed to the next message to be parsed. (used to generate the recvd attribute) (type: int)
def stringReceived(self, string):

Override this for notification when each complete string is received.

ParametersstringThe complete string which was received with all framing (length prefix, etc) removed. (type: bytes)
def lengthLimitExceeded(self, length):
overridden in twisted.protocols.amp.BinaryBoxProtocol

Callback invoked when a length prefix greater than MAX_LENGTH is received. The default implementation disconnects the transport. Override this.

ParameterslengthThe length prefix which was received. (type: int)
def dataReceived(self, data):
from twisted.internet.interfaces.IProtocol
overrides twisted.internet.protocol.Protocol.dataReceived
overridden in twisted.protocols.amp.BinaryBoxProtocol

Convert int prefixed strings into calls to stringReceived.

def sendString(self, string):

Send a prefixed string to the other end of the connection.

ParametersstringThe string to send. The necessary framing (length prefix, etc) will be added. (type: bytes)
API Documentation for twisted, generated by pydoctor at 2020-03-25 17:34:30.