t.n.n.UsenetClientProtocol(NNTPClient) : class documentation

Part of twisted.news.nntp View Source View In Hierarchy

A client that connects to an NNTP server and asks for articles new since a certain time.
Method __init__ No summary
Method connectionMade Called when a connection is made.
Method articleExists Undocumented
Method gotNewNews Override for notification when getNewNews() action is successful
Method getNewNewsFailed Override for notification when getNewNews() action fails
Method gotArticle Override for notification when fetchArticle() action is completed

Inherited from NNTPClient:

Method gotAllGroups Override for notification when fetchGroups() action is completed
Method getAllGroupsFailed Override for notification when fetchGroups() action fails
Method gotOverview Override for notification when fetchOverview() action is completed
Method getOverviewFailed Override for notification when fetchOverview() action fails
Method gotSubscriptions Override for notification when fetchSubscriptions() action is completed
Method getSubscriptionsFailed Override for notification when fetchSubscriptions() action fails
Method gotGroup Override for notification when fetchGroup() action is completed
Method getGroupFailed Override for notification when fetchGroup() action fails
Method getArticleFailed Override for notification when fetchArticle() action fails
Method gotHead Override for notification when fetchHead() action is completed
Method getHeadFailed Override for notification when fetchHead() action fails
Method gotBody Override for notification when fetchBody() action is completed
Method getBodyFailed Override for notification when fetchBody() action fails
Method postedOk Override for notification when postArticle() action is successful
Method postFailed Override for notification when postArticle() action fails
Method gotXHeader Override for notification when getXHeader() action is successful
Method getXHeaderFailed Override for notification when getXHeader() action fails
Method gotNewGroups Override for notification when getNewGroups() action is successful
Method getNewGroupsFailed Override for notification when getNewGroups() action fails
Method setStreamSuccess Override for notification when setStream() action is successful
Method setStreamFailed Override for notification when setStream() action fails
Method fetchGroups Request a list of all news groups from the server. gotAllGroups() is called on success, getGroupsFailed() on failure
Method fetchOverview Request the overview format from the server. gotOverview() is called on success, getOverviewFailed() on failure
Method fetchSubscriptions Request a list of the groups it is recommended a new user subscribe to. gotSubscriptions() is called on success, getSubscriptionsFailed() on failure
Method fetchGroup Get group information for the specified group from the server. gotGroup() is called on success, getGroupFailed() on failure.
Method fetchHead Get the header for the specified article (or the currently selected article if index is '') from the server. gotHead() is called on success, getHeadFailed() on failure
Method fetchBody Get the body for the specified article (or the currently selected article if index is '') from the server. gotBody() is called on success, getBodyFailed() on failure
Method fetchArticle Get the complete article with the specified index (or the currently selected article if index is '') or Message-ID from the server. gotArticle() is called on success, getArticleFailed() on failure.
Method postArticle No summary
Method fetchNewNews No summary
Method fetchNewGroups No summary
Method fetchXHeader No summary
Method setStream Set the mode to STREAM, suspending the normal "lock-step" mode of communications. setStreamSuccess() is called on success, setStreamFailed() on failure.
Method quit Undocumented
Method lineReceived Override this for when each line is received.
Method _newState Undocumented
Method _endState Undocumented
Method _newLine Undocumented
Method _setResponseCode Undocumented
Method _getResponseCode Undocumented
Method _statePassive Undocumented
Method _passiveError Undocumented
Method _headerInitial Undocumented
Method _stateList Undocumented
Method _stateOverview Undocumented
Method _stateSubscriptions Undocumented
Method _headerGroup Undocumented
Method _stateArticle Undocumented
Method _stateHead Undocumented
Method _stateBody Undocumented
Method _headerPost Undocumented
Method _headerPosted Undocumented
Method _stateXHDR Undocumented
Method _stateNewNews Undocumented
Method _stateNewGroups Undocumented
Method _headerMode Undocumented

Inherited from LineReceiver (via NNTPClient):

Class Variable delimiter The line-ending delimiter to use. By default this is b'\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 rawDataReceived Override this for when raw data is received.
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 NNTPClient, LineReceiver):

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 NNTPClient, LineReceiver, Protocol):

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

Inherited from _PauseableMixin (via NNTPClient, LineReceiver):

Method pauseProducing Undocumented
Method resumeProducing Undocumented
Method stopProducing Undocumented
def __init__(self, groups, date, storage): (source)
Fetch all new articles from the given groups since the given date and dump them into the given storage. groups is a list of group names. date is an integer or floating point representing seconds since the epoch (GMT). storage is any object that implements the NewsStorage interface.
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 articleExists(self, exists, article): (source)
Undocumented
def gotNewNews(self, news): (source)
Override for notification when getNewNews() action is successful
def getNewNewsFailed(self, reason): (source)
Override for notification when getNewNews() action fails
def gotArticle(self, article): (source)
Override for notification when fetchArticle() action is completed
API Documentation for Twisted, generated by pydoctor at 2014-05-12 18:27:00.