t.w.p.m.MSNEventBase(LineReceiver) : class documentation

Part of twisted.words.protocols.msn View Source View In Hierarchy

Known subclasses: twisted.words.protocols.msn.DispatchClient, twisted.words.protocols.msn.NotificationClient, twisted.words.protocols.msn.SwitchboardClient

This class provides support for handling / dispatching events and is the base class of the three main client protocols (DispatchClient, NotificationClient, SwitchboardClient)
Method __init__ Undocumented
Method connectionLost Called when the connection is shut down.
Method connectionMade Called when a connection is made.
Method checkMessage process received messages to check for file invitations and typing notifications and other control type messages
Method lineReceived Override this for when each line is received.
Method rawDataReceived Override this for when raw data is received.
Method handle_MSG Undocumented
Method handle_UNKNOWN implement me in subclasses if you want to handle unknown events
Method gotMessage called when we receive a message - override in notification and switchboard clients
Method gotBadLine called when a handler notifies me that this line is broken
Method gotError called when the server sends an error which is not in response to a sent command (ie. it has no matching transaction ID)
Method _fireCallback Fire the callback for the given id if one exists and return 1, else return false
Method _nextTransactionID return a usable transaction ID
Method _createIDMapping return a unique transaction ID that is mapped internally to a deferred .. also store arbitrary data if it is needed

Inherited from LineReceiver:

Class Variable delimiter The line-ending delimiter to use. By default this is '\r\n'.
Class Variable MAX_LENGTH The maximum length of a line to allow (If a sent line is longer than this, the connection is dropped). Default is 16384.
Method clearLineBuffer Clear buffered data.
Method dataReceived Protocol.dataReceived. Translates bytes into lines, and calls lineReceived (or rawDataReceived, depending on mode.)
Method setLineMode Sets the line-mode of this receiver.
Method setRawMode Sets the raw mode of this receiver. Further data received will be sent to rawDataReceived rather than lineReceived.
Method sendLine Sends a line to the other end of the connection.
Method lineLengthExceeded Called when the maximum line length has been reached. Override if it needs to be dealt with in some special way.

Inherited from Protocol (via LineReceiver):

Method logPrefix Return a prefix matching the class name, to identify log messages related to this protocol instance.

Inherited from BaseProtocol (via LineReceiver, Protocol):

Method makeConnection Make a connection to a transport and a server.

Inherited from _PauseableMixin (via LineReceiver):

Method pauseProducing Undocumented
Method resumeProducing Undocumented
Method stopProducing Undocumented
def __init__(self): (source)
Undocumented
def connectionLost(self, reason): (source)
Called when the connection is shut down.

Clear any circular references here, and any external references to this Protocol. The connection has been closed.

def connectionMade(self): (source)
Called when a connection is made.

This may be considered the initializer of the protocol, because it is called when the connection is completed. For clients, this is called once the connection to the server has been established; for servers, this is called after an accept() call stops blocking and a socket has been received. If you need to send any greeting or initial message, do it here.

def _fireCallback(self, id, *args): (source)
Fire the callback for the given id if one exists and return 1, else return false
def _nextTransactionID(self): (source)
return a usable transaction ID
def _createIDMapping(self, data=None): (source)
return a unique transaction ID that is mapped internally to a deferred .. also store arbitrary data if it is needed
def checkMessage(self, message): (source)
process received messages to check for file invitations and typing notifications and other control type messages
def lineReceived(self, line): (source)
Override this for when each line is received.
ParameterslineThe line which was received with the delimiter removed. (type: str)
def rawDataReceived(self, data): (source)
Override this for when raw data is received.
def handle_MSG(self, params): (source)
Undocumented
def handle_UNKNOWN(self, cmd, params): (source)
implement me in subclasses if you want to handle unknown events
def gotMessage(self, message): (source)
called when we receive a message - override in notification and switchboard clients
def gotBadLine(self, line, why): (source)
called when a handler notifies me that this line is broken
def gotError(self, errorCode): (source)
called when the server sends an error which is not in response to a sent command (ie. it has no matching transaction ID)
API Documentation for Twisted, generated by pydoctor at 2012-09-01 11:44:56.