poezio/plugins/regex_admin.py

81 lines
1.7 KiB
Python
Raw Normal View History

2013-05-09 00:17:17 +00:00
"""
This plugins adds a :term:`/rkick` and a :term:`/rban` command,
in order to kick/ban according to a regex on a nick.
Installation
------------
You only have to load the plugin:
``/load regex_admin``
Commands
--------
Those commands take a regular expression (as defined in the
`re module documentation`_) as a parameter.
For roles
~~~~~~~~~
.. glossary::
:sorted:
/rkick
Kick a participant using a regex.
/rban
Ban a participant using a regex.
.. _re module documentation: http://docs.python.org/3/library/re.html
"""
from plugin import BasePlugin
from tabs import MucTab
import re
class Plugin(BasePlugin):
def init(self):
self.api.add_tab_command(MucTab, 'rkick',
self.command_rkick,
usage='<regex>',
help='Kick occupants of a room according to a regex',
short='Regex Kick')
self.api.add_tab_command(MucTab, 'rban',
self.command_rban,
usage='<regex>',
help='Ban occupants of a room according to a regex',
short='Regex Ban')
def return_users(self, users, regex):
try:
reg = re.compile(regex)
except:
return []
ret = []
for user in users:
if reg.match(user.nick):
ret.append(user)
return ret
def command_rban(self, regex):
tab = self.api.current_tab()
users = self.return_users(tab.users, regex)
for user in users:
tab.command_ban(user.nick)
def command_rkick(self, regex):
tab = self.api.current_tab()
users = self.return_users(tab.users, regex)
for user in users:
tab.command_kick(user.nick)