Class t.p.b.LineReceiver(protocol.Protocol, _PauseableMixin):

Part of twisted.protocols.basic View Source View In Hierarchy

Known subclasses: twisted.conch.scripts.cftp.StdioClient, twisted.conch.telnet.StatefulTelnetProtocol, twisted.mail.imap4.IMAP4Client, twisted.mail.imap4.IMAP4Server, twisted.mail.smtp.SMTPClient, twisted.news.nntp.NNTPClient, twisted.news.nntp.NNTPServer, twisted.protocols.dict.DictClient, twisted.protocols.finger.Finger, twisted.protocols.ftp.FTP, twisted.protocols.ftp.FTPClientBasic, twisted.protocols.ftp.FTPFileListProtocol, twisted.protocols.ftp.FTPOverflowProtocol, twisted.protocols.gps.nmea.NMEAReceiver, twisted.protocols.memcache.MemCacheProtocol, twisted.protocols.postfix.PostfixTCPMapServer, twisted.protocols.sip.MessagesParser, twisted.runner.procmon.LineLogger, twisted.web.http.HTTPChannel, twisted.web.http.HTTPClient, twisted.web.woven.flashconduit.FlashConduit, twisted.web2.channel.http.HTTPChannel, twisted.web2.client.http.HTTPClientProtocol, twisted.web2.twscgi.SCGIClientProtocol, twisted.words.protocols.irc.DccChat, twisted.words.protocols.irc.IRCClient, twisted.words.protocols.msn.FileReceive, twisted.words.protocols.msn.FileSend, twisted.words.protocols.msn.MSNEventBase (hide last 26 again) ... and 26 more

A protocol that receives lines and/or raw data, depending on mode.

In line mode, each line that's received becomes a callback to lineReceived. In raw data mode, each chunk of raw data becomes a callback to rawDataReceived. The setLineMode and setRawMode methods switch between the two modes.

This is useful for line-oriented protocols such as IRC, HTTP, POP, etc.
Class VariablesdelimiterThe line-ending delimiter to use. By default this is '\r\n'.
MAX_LENGTHThe maximum length of a line to allow (If a sent line is longer than this, the connection is dropped). Default is 16384.

Split Table into Classes Show Methods in One Table

Line # Kind Name Docs
207 Method clearLineBuffer Clear buffered data.
211 Method dataReceived Protocol.dataReceived.
241 Method setLineMode Sets the line-mode of this receiver.
256 Method setRawMode Sets the raw mode of this receiver.
263 Method rawDataReceived Override this for when raw data is received.
268 Method lineReceived Override this for when each line is received.
273 Method sendLine Sends a line to the other end of the connection.
278 Method lineLengthExceeded Called when the maximum line length has been reached.

Inherited from Protocol:

Line # Kind Name Docs
384 Method connectionLost Called when the connection is shut down.

Inherited from BaseProtocol (via Protocol):

Line # Kind Name Docs
341 Method makeConnection Make a connection to a transport and a server.
351 Method connectionMade Called when a connection is made.

Inherited from _PauseableMixin:

Line # Kind Name Docs
172 Method pauseProducing Undocumented
176 Method resumeProducing Undocumented
181 Method stopProducing Undocumented
Line # Kind Name Docs
207 Method clearLineBuffer Clear buffered data.
384 Method connectionLost Called when the connection is shut down.
351 Method connectionMade Called when a connection is made.
211 Method dataReceived Protocol.dataReceived.
278 Method lineLengthExceeded Called when the maximum line length has been reached.
268 Method lineReceived Override this for when each line is received.
341 Method makeConnection Make a connection to a transport and a server.
172 Method pauseProducing Undocumented
263 Method rawDataReceived Override this for when raw data is received.
176 Method resumeProducing Undocumented
273 Method sendLine Sends a line to the other end of the connection.
241 Method setLineMode Sets the line-mode of this receiver.
256 Method setRawMode Sets the raw mode of this receiver.
181 Method stopProducing Undocumented
def clearLineBuffer(self): (source)
Clear buffered data.
def dataReceived(self, data): (source)
Protocol.dataReceived. Translates bytes into lines, and calls lineReceived (or rawDataReceived, depending on mode.)
def setLineMode(self, extra=''): (source)

Sets the line-mode of this receiver.

If you are calling this from a rawDataReceived callback, you can pass in extra unhandled data, and that data will be parsed for lines. Further data received will be sent to lineReceived rather than rawDataReceived.

Do not pass extra data if calling this function from within a lineReceived callback.
def setRawMode(self): (source)
Sets the raw mode of this receiver. Further data received will be sent to rawDataReceived rather than lineReceived.
def rawDataReceived(self, data): (source)
Override this for when raw data is received.
def lineReceived(self, line): (source)
Override this for when each line is received.
def sendLine(self, line): (source)
Sends a line to the other end of the connection.
def lineLengthExceeded(self, line): (source)

Called when the maximum line length has been reached. Override if it needs to be dealt with in some special way.

The argument 'line' contains the remainder of the buffer, starting with (at least some part) of the line which is too long. This may be more than one line, or may be only the initial portion of the line.
API Documentation for Twisted, generated by pydoctor at 2008-10-26 16:12:37.