Compare commits

..

6 Commits

Author SHA1 Message Date
ab75d45867
WIP quiet and ban 2021-08-20 14:05:26 +05:30
076a74e601
tabular outline 2021-08-18 17:31:31 +05:30
b81fd05ee0
outline.rst 2021-08-18 17:03:39 +05:30
21d17846ee
maintain a tripsit branch with a discussions text file 2021-08-18 16:26:10 +05:30
bc5b2f4e32
latest build 2021-08-18 16:16:04 +05:30
fc34ba12f0
NFI 2021-08-06 04:38:53 +05:30
4 changed files with 254 additions and 47 deletions

View File

@ -1 +1,3 @@
# EgoServ - Limnoria Plugin
Suite of tools to help Network Operators run their ErgoIRCd nets Suite of tools to help Network Operators run their ErgoIRCd nets

View File

@ -37,14 +37,10 @@ import supybot
from supybot import world from supybot import world
# Use this for the version of this plugin. # Use this for the version of this plugin.
__version__ = "0.1.1" __version__ = ""
# XXX Replace this with an appropriate author or supybot.Author instance. # XXX Replace this with an appropriate author or supybot.Author instance.
if not hasattr(supybot.authors, 'mogad0n'): __author__ = supybot.authors.unknown
supybot.authors.mogad0n =supybot.Author('Pratyush Desai', 'mogad0n',
'pratyushndesai@gmail.com')
__author__ = supybot.authors.mogad0n
# This is a dictionary mapping supybot.Author instances to lists of # This is a dictionary mapping supybot.Author instances to lists of
# contributions. # contributions.

71
outline.rst Normal file
View File

@ -0,0 +1,71 @@
WIP Outline of Commands and Functionality
=========================================
The permissions are inherited in descending order. Tier 1 inherits Tier 2 ...
+-----------+-------------+------------+-------------+----------+
|Commands |Description | Tier | Channel | Status |
| | | | Restrictions| |
+===========+=============+============+=============+==========+
| DEFCON | | Admins/Ops | public | DONE |
+-----------+-------------+------------+-------------+----------+
| SAJOIN | | Admins/Ops | public | DONE |
+-----------+-------------+------------+-------------+----------+
| SANICK | | Admins/Ops | column 3 | DONE |
+-----------+-------------+------------+-------------+----------+
| KILL | | Admins/Ops | public | DONE |
+-----------+-------------+------------+-------------+----------+
| UBAN | | Moderators | public | WIP |
+-----------+-------------+------------+-------------+----------+
| NBAN | | Moderators | public | WIP |
+-----------+-------------+------------+-------------+----------+
| KBAN | | Moderators | public | EXISTS |
+-----------+-------------+------------+-------------+----------+
| SUSTATUS | | Moderators | staff, pm | TBD |
+-----------+-------------+------------+-------------+----------+
| WARN | | Tripsitters| public | TBD |
+-----------+-------------+------------+-------------+----------+
| ADDNOTE | | Tripsitters| staff, pm | TBD |
+-----------+-------------+------------+-------------+----------+
| STATUS | | Tripsitters| staff, pm | TBD |
+-----------+-------------+------------+-------------+----------+
| QUIET | | Tripsitters| | |
+-----------+-------------+------------+-------------+----------+
| NOTES | | Tripsitters| | |
+-----------+-------------+------------+-------------+----------+
Tier 1 : Administrator/Operator only
------------------------------------
1. DEFCON
2. SANICK
3. SAJOIN
4. KILL
5. UBAN - Variations. This can be considered akin to a KLINE in tripbot.
Tier 2 : Moderators
-------------------
1. NBAN - this will behave as current ``nban`` minus the kline aspect
2. KBAN - Single channel bans (exists)
3. WARN
4. SUSTATUS
Tier 3 : Tripsitters
--------------------
1. QUIET - should allow for --all flag to quiet accross channels similar to NBAN
1. This will require the use of the mute extban ``MODE +b #channel m:nick!user@host``
2. Refer to ``@kban`` and ``@iban`` code in the ``Channel`` plugin
2. STATUS
3. ADDNOTE
4. NOTES
---
- All commands targetting a user (infractions) should be logged in a database. sqlite3 for now.
- decide upon the schema for these tables.
- Besides the user permissions, there should be channel restrictions for certain commands.
- Ensure that the bot itself cannot be targetted and is immune

218
plugin.py
View File

@ -28,7 +28,12 @@
### ###
from supybot import utils, plugins, ircutils, callbacks, irclib, ircmsgs, conf, world, log # My Imports
from supybot import utils, plugins, ircutils, callbacks, irclib, ircmsgs,
from supybot import conf, world, log, ircdb, registry, schedule
from supybot.commands import * from supybot.commands import *
try: try:
from supybot.i18n import PluginInternationalization from supybot.i18n import PluginInternationalization
@ -44,6 +49,69 @@ except ImportError:
# filename = conf.supybot.directories.data.dirize("EgoServ.db") # filename = conf.supybot.directories.data.dirize("EgoServ.db")
# Perms Decorator
def ensure_permissions(min_permission_group):
"Ensures user belongs to a least permission group"
def decorator(function):
def wrapper(*args,**kwargs):
print(args)
print(kwargs)
return function(*args, **kwargs)
return wrapper
return decorator
# Taken from plugins.Time.seconds
def getTs(irc, msg, args, state):
"""[<years>y] [<weeks>w] [<days>d] [<hours>h] [<minutes>m] [<seconds>s]
Returns the number of seconds in the number of <years>, <weeks>,
<days>, <hours>, <minutes>, and <seconds> given. An example usage is
"seconds 2h 30m", which would return 9000, which is '3600*2 + 30*60'.
Useful for scheduling events at a given number of seconds in the
future.
"""
# here there is some glitch / ugly hack to allow any('getTs'), with rest('test') after...
# TODO: check that bot can't kill itself with loop
seconds = -1
items = list(args)
for arg in items:
if not (arg and arg[-1] in 'ywdhms'):
try:
n = int(arg)
state.args.append(n)
except:
state.args.append(float(seconds))
raise callbacks.ArgumentError
(s, kind) = arg[:-1], arg[-1]
try:
i = int(s)
except ValueError:
state.args.append(float(seconds))
raise callbacks.ArgumentError
if kind == 'y':
seconds += i*31536000
elif kind == 'w':
seconds += i*604800
elif kind == 'd':
seconds += i*86400
elif kind == 'h':
seconds += i*3600
elif kind == 'm':
seconds += i*60
elif kind == 's':
if i == 0:
i = 1
seconds += i
elif kind == '-':
state.args.append(float(seconds))
raise callbacks.ArgumentError
args.pop(0)
state.args.append(float(seconds))
addConverter('getTs', getTs)
class EgoServ(callbacks.Plugin): class EgoServ(callbacks.Plugin):
"""Suite of tools to help Network Operators run their ErgoIRCd nets""" """Suite of tools to help Network Operators run their ErgoIRCd nets"""
threaded = True threaded = True
@ -100,6 +168,7 @@ class EgoServ(callbacks.Plugin):
# KILL # KILL
@ensure_permissions(5)
@wrap(['nick', optional('something')]) @wrap(['nick', optional('something')])
def kill(self, irc, msg, args, nick, reason): def kill(self, irc, msg, args, nick, reason):
"""<nick> [<reason>] """<nick> [<reason>]
@ -162,48 +231,115 @@ class EgoServ(callbacks.Plugin):
# Channel Administration # Channel Administration
###### ######
# Only Talking to CS isn't enough because def _ban(self, irc, msg, args,
# CS doesn't handle expiring bans mutes channel, optlist, target, getTs, reason, kick):
# Check that they're not trying to make us kickban ourself.
if irc.isNick(target):
bannedNick = target
try:
bannedHostmask = irc.state.nickToHostmask(target)
banmaskstyle = conf.supybot.protocols.irc.banmask
banmask = banmaskstyle.makeBanmask(bannedHostmask, [o[0] for o in optlist])
except KeyError:
## WTF IS THIS
if not conf.supybot.protocols.irc.strictRfc() and \
target.startswith('$'):
# Select the last part, or the whole target:
bannedNick = target.split(':')[-1]
banmask = bannedHostmask = target
else:
irc.error(format(_('I haven\'t seen %s.'), bannedNick), Raise=True)
else:
bannedNick = ircutils.nickFromHostmask(target)
banmask = bannedHostmask = target
if not irc.isNick(bannedNick):
self.log.warning('%q tried to kban a non nick: %q',
msg.prefix, bannedNick)
raise callbacks.ArgumentError
elif bannedNick == irc.nick:
self.log.warning('%q tried to make me kban myself.', msg.prefix)
irc.error(_('I cowardly refuse to kickban myself.'))
return
if not reason:
reason = msg.nick
capability = ircdb.makeChannelCapability(channel, 'op')
# Check (again) that they're not trying to make us kickban ourself.
if ircutils.hostmaskPatternEqual(banmask, irc.prefix):
if ircutils.hostmaskPatternEqual(bannedHostmask, irc.prefix):
self.log.warning('%q tried to make me kban myself.',msg.prefix)
irc.error(_('I cowardly refuse to ban myself.'))
return
else:
self.log.warning('Using exact hostmask since banmask would '
'ban myself.')
banmask = bannedHostmask
# Now, let's actually get to it. Check to make sure they have
# #channel,op and the bannee doesn't have #channel,op; or that the
# bannee and the banner are both the same person.
def doBan():
if irc.state.channels[channel].isOp(bannedNick):
irc.queueMsg(ircmsgs.deop(channel, bannedNick))
irc.queueMsg(ircmsgs.ban(channel, banmask))
if kick:
irc.queueMsg(ircmsgs.kick(channel, bannedNick, reason))
if getTs > 0:
def f():
if channel in irc.state.channels and \
banmask in irc.state.channels[channel].bans:
irc.queueMsg(ircmsgs.unban(channel, banmask))
schedule.addEvent(f, )
if bannedNick == msg.nick:
doBan()
elif ircdb.checkCapability(msg.prefix, capability):
if ircdb.checkCapability(bannedHostmask, capability) and \
not ircdb.checkCapability(msg.prefix, 'owner'):
self.log.warning('%s tried to ban %q, but both have %s',
msg.prefix, bannedHostmask, capability)
irc.error(format(_('%s has %s too, you can\'t ban '
'them.'), bannedNick, capability))
else:
doBan()
else:
self.log.warning('%q attempted kban without %s',
msg.prefix, capability)
irc.errorNoCapability(capability)
def nban(self, irc, msg, args,
bannedNick, getTs, reason):
""" <nick> [<seconds>] [<reason>]
If you have the #channel,op capability, this will kickban <nick>'s banmask from
for
the time period specified. Not specifying the time period it will ban the user
indefinitely. <reason> is optional but recommended.
"""
self._ban(irc, msg, args, bannedNick, reason, True)
nban = wrap(nban,
['haveOp',
('haveHalfop+', _('kick or ban someone')),
'nickInChannel',
optional('', 0),
additional('text')])
# Use mute Extban
# @wrap(['nick', 'channel', optional('expiry', 0), 'something']) @wrap(['nick', 'channel', optional('getTs'), 'something'])
# def mute(self, irc, msg, args, nick, channel, duration, reason): def quiet(self, irc, msg, args, nick, channel, duration, reason="Fuck Knows!"):
# @wrap(['nick', 'channel']) """<nick> [<channel>] [<seconds>] [<reason>]
# def mute(self, irc, msg, args, nick, channel):
# """<nick> [<channel>]
# Issues an extban which mutes the hostmask associated with the Quiets the banmask associated with <nick> for the time period specified
# <nick> <seconds>. If not specified, it will quiet the user indefinitely.
# """ <reason> is optional but recommended! <channel> is only necessary if
# # add --all flag for muting the hostmask/account in all channels the command is not sent in the channel itself.
# # on the current network """
try:
(nick, ident, host) = \
ircutils.splitHostmask(irc.state.nickToHostmask(nick))
except KeyError:
irc.error(format("No such nick"), Raise=True)
# # Seconds needs to be human readable i.e. 5w 3d 2h
# # Do we care about adding quiets/mutes for accounts not online
# # via --host specification or even an --account
# # Fuck 'duration' and 'reason' for now
# # What I'm doing is very filthy
# # Refer to how the core channel plugin deals with this.
# # https://github.com/ProgVal/Limnoria/blob/master/plugins/Channel/plugin.py#L358
# try:
# (nick, ident, host) = ircutils.splitHostmask(irc.state.nickToHostmask(nick))
# except KeyError:
# irc.error(
# "No such nick",
# Raise=True,
# )
# if nick == irc.nick:
# self.log.warning(f'{msg.prefix} tried to make me mute myself.', )
# irc.error(_('No, I would like to preserve my right to speech!'))
# return
# irc.queueMsg()
@wrap(['channel', 'something', many('nick')]) @wrap(['channel', 'something', many('nick')])
def amode(self, irc, msg, args, channel, mode, nicks): def amode(self, irc, msg, args, channel, mode, nicks):
@ -231,19 +367,21 @@ class EgoServ(callbacks.Plugin):
flag = '-a' flag = '-a'
elif mode == 'deop': elif mode == 'deop':
flag = '-o' flag = '-o'
else:
irc.error(f'Supplied mode {mode} is not allowed/valid')
for nick in nicks: for nick in nicks:
irc.queueMsg(msg=ircmsgs.IrcMsg(command='PRIVMSG', irc.queueMsg(msg=ircmsgs.IrcMsg(command='PRIVMSG',
args=('chanserv', f'amode {channel} {flag} {nick}'))) args=('chanserv', f'amode {channel} {flag} {nick}')))
else:
irc.error(f'Supplied mode {mode} is BAD INPUT!')
# Would love to handle responses for when it's not an account, # Would love to handle responses for when it's not an account,
# https://github.com/ergochat/ergo/issues/1515 Waiting for this. # https://github.com/ergochat/ergo/issues/1515 Waiting for this.
irc.replySuccess(f'Setting mode {flag} on given nick(s), if nick(s) weren\'t given the {flag} mode it/they is/are unregistered') irc.replySuccess(f'= Auto {flag} applied to \x02registered\x0F nicks!')
@wrap([many('channel')]) @wrap([many('channel')])
def chanreg(self, irc, msg, args, channels): def chanreg(self, irc, msg, args, channels):
"""[<channel>].. [<channel>..] """[<channel>].. [<channel>..]
Registered the given channel/s by the bot Registered the given channel/s by the bot
""" """