t.n.d.NewsShelf(_ModerationMixin) : class documentation

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

Implements interfaces: twisted.news.database.INewsStorage

A NewStorage implementation using Twisted's dirdbm persistence module.
Method __init__
Method initialize Undocumented
Method addGroup Undocumented
Method addSubscription Undocumented
Method addModerator Undocumented
Method listRequest Returns a deferred whose callback will be passed a list of 4-tuples containing (name, max index, min index, flags) for each news group
Method subscriptionRequest Returns a deferred whose callback will be passed the list of recommended subscription groups for new server users
Method getModerator Undocumented
Method notifyModerator Notify a single moderator about an article requiring moderation.
Method postRequest Returns a deferred whose callback will be invoked if 'message' is successfully posted to one or more specified groups and whose errback will be invoked otherwise.
Method overviewRequest Returns a deferred whose callback will be passed the a list of headers describing this server's overview format.
Method xoverRequest No summary
Method xhdrRequest No summary
Method listGroupRequest Returns a deferred whose callback will be passed a two-tuple of (group name, [article indices])
Method groupRequest Returns a deferred whose callback will be passed a five-tuple of (group name, article count, highest index, lowest index, group flags)
Method articleExistsRequest Returns a deferred whose callback will be passed with a true value if a message with the specified Message-ID exists in the database and with a false value otherwise.
Method articleRequest No summary
Method headRequest No summary
Method bodyRequest No summary

Inherited from _ModerationMixin:

Method notifyModerators Send an article to a list of group moderators to be moderated.
def __init__(self, mailhost, path, sender=None): (source)
ParametersmailhostA str giving the mail exchange host which will accept moderation emails from this server. Must accept emails destined for any address specified as a moderator.
senderA str giving the address which will be used as the sender of any moderation email generated by this server.
def initialize(self): (source)
Undocumented
def addGroup(self, name, flags): (source)
Undocumented
def addSubscription(self, name): (source)
Undocumented
def addModerator(self, group, email): (source)
Undocumented
def listRequest(self): (source)
from twisted.news.database.INewsStorage
Returns a deferred whose callback will be passed a list of 4-tuples containing (name, max index, min index, flags) for each news group
def subscriptionRequest(self): (source)
from twisted.news.database.INewsStorage
Returns a deferred whose callback will be passed the list of recommended subscription groups for new server users
def getModerator(self, groups): (source)
Undocumented
def notifyModerator(self, moderator, article): (source)
Notify a single moderator about an article requiring moderation.

notifyModerators should be preferred.

def postRequest(self, message): (source)
from twisted.news.database.INewsStorage
Returns a deferred whose callback will be invoked if 'message' is successfully posted to one or more specified groups and whose errback will be invoked otherwise.
def overviewRequest(self): (source)
from twisted.news.database.INewsStorage
Returns a deferred whose callback will be passed the a list of headers describing this server's overview format.
def xoverRequest(self, group, low, high): (source)
from twisted.news.database.INewsStorage
Returns a deferred whose callback will be passed a list of xover headers for the given group over the given range. If low is None, the range starts at the first article. If high is None, the range ends at the last article.
def xhdrRequest(self, group, low, high, header): (source)
from twisted.news.database.INewsStorage
Returns a deferred whose callback will be passed a list of XHDR data for the given group over the given range. If low is None, the range starts at the first article. If high is None, the range ends at the last article.
def listGroupRequest(self, group): (source)
from twisted.news.database.INewsStorage
Returns a deferred whose callback will be passed a two-tuple of (group name, [article indices])
def groupRequest(self, group): (source)
from twisted.news.database.INewsStorage
Returns a deferred whose callback will be passed a five-tuple of (group name, article count, highest index, lowest index, group flags)
def articleExistsRequest(self, id): (source)
from twisted.news.database.INewsStorage
Returns a deferred whose callback will be passed with a true value if a message with the specified Message-ID exists in the database and with a false value otherwise.
def articleRequest(self, group, index, id=None): (source)
from twisted.news.database.INewsStorage
Returns a deferred whose callback will be passed a file-like object containing the full article text (headers and body) for the article of the specified index in the specified group, and whose errback will be invoked if the article or group does not exist. If id is not None, index is ignored and the article with the given Message-ID will be returned instead, along with its index in the specified group.
def headRequest(self, group, index, id=None): (source)
from twisted.news.database.INewsStorage
Returns a deferred whose callback will be passed the header for the article of the specified index in the specified group, and whose errback will be invoked if the article or group does not exist.
def bodyRequest(self, group, index, id=None): (source)
from twisted.news.database.INewsStorage
Returns a deferred whose callback will be passed the body for the article of the specified index in the specified group, and whose errback will be invoked if the article or group does not exist.
API Documentation for Twisted, generated by pydoctor at 2012-02-14 18:17:43.