Badwords: add plugin docstring, and fix/standardize some method docstrings.

This commit is contained in:
Daniel Folkinshteyn 2010-09-07 20:27:51 -04:00 committed by Valentin Lorentz
parent 9665c178aa
commit 0e67977cdd

View File

@ -43,6 +43,9 @@ from supybot.i18n import PluginInternationalization, internationalizeDocstring
_ = PluginInternationalization('BadWords') _ = PluginInternationalization('BadWords')
class BadWords(callbacks.Privmsg): class BadWords(callbacks.Privmsg):
"""Maintains a list of words that the bot is not allowed to say.
Can also be used to kick people that say these words, if the bot
has op."""
def __init__(self, irc): def __init__(self, irc):
self.__parent = super(BadWords, self) self.__parent = super(BadWords, self)
self.__parent.__init__(irc) self.__parent.__init__(irc)
@ -68,7 +71,7 @@ class BadWords(callbacks.Privmsg):
def inFilter(self, irc, msg): def inFilter(self, irc, msg):
self.filtering = True self.filtering = True
# We need to check for bad words here rather than in doPrivmsg because # We need to check for bad words here rather than in doPrivmsg because
# messages don't get to doPrivmsg is the user is ignored. # messages don't get to doPrivmsg if the user is ignored.
if msg.command == 'PRIVMSG': if msg.command == 'PRIVMSG':
self.updateRegexp() self.updateRegexp()
s = ircutils.stripFormatting(msg.args[1]) s = ircutils.stripFormatting(msg.args[1])
@ -124,7 +127,7 @@ class BadWords(callbacks.Privmsg):
def add(self, irc, msg, args, words): def add(self, irc, msg, args, words):
"""<word> [<word> ...] """<word> [<word> ...]
Adds all <word>s to the list of words the bot isn't to say. Adds all <word>s to the list of words being censored.
""" """
set = self.words() set = self.words()
set.update(words) set.update(words)
@ -136,7 +139,7 @@ class BadWords(callbacks.Privmsg):
def remove(self, irc, msg, args, words): def remove(self, irc, msg, args, words):
"""<word> [<word> ...] """<word> [<word> ...]
Removes a <word>s from the list of words the bot isn't to say. Removes <word>s from the list of words being censored.
""" """
set = self.words() set = self.words()
for word in words: for word in words: