]> jfr.im git - erebus.git/blobdiff - modlib.py
use surrogateescape instead of backslashreplace so bad utf8 will get passed through
[erebus.git] / modlib.py
index 06276184ef27876a3c338adb94a0d3e2f473db8f..b36c153287f4979c107a8768c60b91536949ec15 100644 (file)
--- a/modlib.py
+++ b/modlib.py
@@ -33,7 +33,7 @@ class modlib(object):
        KNOWN   =   1
        AUTHED  =   0 # Users which have are known to be authed
        ANYONE  =  -1 # non-authed users have glevel set to -1
-       IGNORED =  -2 # The default reqglevel is ANYONE, so any commands will be ignored from IGNORED users unless the command reglevel=-2
+       IGNORED =  -2 # If the user is IGNORED, no hooks or chanhooks will fire for their messages. numhooks can still be fired.
        glevs   = {
                'OWNER': OWNER,
                'MANAGER': MANAGER,
@@ -170,7 +170,7 @@ class modlib(object):
                        return func
                return realhook
 
-       def bind(self, bindto):
+       def bind(self, bindto, data=None):
                """Used as a decorator on a class which implements getdata and parse methods.
                        See modules/sockets.py for an example.
                        Takes an arg like:
@@ -191,39 +191,36 @@ class modlib(object):
                        bindto = bindto[4:]
                if len(bindto) > 4 and bindto[0:4] == 'tcp:':
                        bindto = bindto[4:]
-               print(repr(bindto), ':' in bindto)
                if ':' in bindto:
-                       print(bindto)
                        pieces = bindto.rsplit(':', 1)
                        host = pieces[0]
                        bindto = pieces[1]
-                       print(pieces,host,bindto)
                port = int(bindto)
-               return self._hooksocket(af, ty, (host, port))
-
-       def bind_tcp(self, host, port):
-               return self._hooksocket(socket.AF_INET, socket.SOCK_STREAM, (host, port))
-       def bind_udp(self, host, port):
-               return self._hooksocket(socket.AF_INET, socket.SOCK_DGRAM, (host, port))
-       def bind_unix(self, path):
-               return self._hooksocket(socket.AF_UNIX, socket.SOCK_STREAM, path)
-       def _hooksocket(self, af, ty, address):
+               return self._hooksocket(af, ty, (host, port), data)
+
+       def bind_tcp(self, host, port, data=None):
+               return self._hooksocket(socket.AF_INET, socket.SOCK_STREAM, (host, port), data)
+       def bind_udp(self, host, port, data=None):
+               return self._hooksocket(socket.AF_INET, socket.SOCK_DGRAM, (host, port), data)
+       def bind_unix(self, path, data=None):
+               return self._hooksocket(socket.AF_UNIX, socket.SOCK_STREAM, path, data)
+       def _hooksocket(self, af, ty, address, data):
                def realhook(cls):
                        if not (hasattr(cls, 'getdata') and callable(cls.getdata)):
                                # Check early that the object implements getdata.
                                # If getdata ever returns a non-empty list, then a parse method must also exist, but we don't check that.
                                raise Exception('Attempted to hook a socket without a class to process data')
-                       self.sockhooks.append((af, ty, address, cls))
+                       self.sockhooks.append((af, ty, address, cls, data))
                        if self.parent is not None:
-                               self._create_socket(af, ty, address, cls)
+                               self._create_socket(af, ty, address, cls, data)
                        return cls
                return realhook
-       def _create_socket(self, af, ty, address, cls):
+       def _create_socket(self, af, ty, address, cls, data):
                ty = ty | socket.SOCK_NONBLOCK
                sock = socket.socket(af, ty)
                sock.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
                sock.bind(address)
-               obj = _ListenSocket(self, sock, cls)
+               obj = _ListenSocket(self, sock, cls, data)
                self.sockets.append((sock,obj))
                sock.listen(5)
                self.parent.newfd(obj, sock.fileno())
@@ -237,11 +234,53 @@ class modlib(object):
                else:
                        return error('unknown parent')
 
+
+       def flags(self, *flags):
+               """Parses out "flags" to a command, like `MODUNLOAD -AUTOLOAD somemodule`
+               @lib.hook()
+               @lib.flags('autoload', 'force')
+               def baz(bot, user, chan, realtarget, flags, *args)
+
+               Note the added `flags` argument, which will be a dict - in this case `{'autounload':true,'force':false}`."""
+               def realhook(func):
+                       func.flags = [f.lower() for f in flags]
+
+                       @wraps(func)
+                       def parseargs(bot, user, chan, realtarget, *_args):
+                               args = list(_args) # we need a copy, also need a list, iterate over _args-tuple, mutate args-list
+                               found_flags = {f: False for f in flags}
+                               for arg in _args:
+                                       if arg[0] == "-" and len(arg) > 1:
+                                               found_prefix = None
+                                               possible_flag = arg[1:].lower()
+                                               for f in flags:
+                                                       if possible_flag == f: # Exact match?
+                                                               found_flags[possible_flag] = True
+                                                               args.remove(arg)
+                                                               found_prefix = None
+                                                               break
+                                                       elif f.find(possible_flag) == 0: # Is the current word a prefix of a flag?
+                                                               if found_prefix is not None: # Is it also a prefix of another flag?
+                                                                       return 'Error: %s is a prefix of multiple flags (%s, %s).' % (possible_flag, found_prefix[1], f)
+                                                               else:
+                                                                       found_prefix = (arg,f)
+                                               if found_prefix is not None: # found (only one) prefix
+                                                       found_flags[found_prefix[1]] = True
+                                                       args.remove(found_prefix[0])
+                               return func(bot, user, chan, realtarget, found_flags, *args)
+
+                       return parseargs
+               return realhook
+
+
        def argsEQ(self, num):
                def realhook(func):
                        @wraps(func)
                        def checkargs(bot, user, chan, realtarget, *args):
-                               if len(args) == num:
+                               adjuster = 0
+                               if hasattr(checkargs, 'flags'):
+                                       adjuster = 1
+                               if len(args)-adjuster == num:
                                        return func(bot, user, chan, realtarget, *args)
                                else:
                                        bot.msg(user, self.WRONGARGS)
@@ -252,7 +291,10 @@ class modlib(object):
                def realhook(func):
                        @wraps(func)
                        def checkargs(bot, user, chan, realtarget, *args):
-                               if len(args) >= num:
+                               adjuster = 0
+                               if hasattr(checkargs, 'flags'):
+                                       adjuster = 1
+                               if len(args)-adjuster >= num:
                                        return func(bot, user, chan, realtarget, *args)
                                else:
                                        bot.msg(user, self.WRONGARGS)
@@ -281,11 +323,12 @@ class modlib(object):
                return realhook
 
 class _ListenSocket(object):
-       def __init__(self, lib, sock, cls):
+       def __init__(self, lib, sock, cls, data):
                self.clients = []
                self.lib = lib
                self.sock = sock
                self.cls = cls
+               self.data = data
 
        def _make_closer(self, obj, client):
                def close():
@@ -302,7 +345,7 @@ class _ListenSocket(object):
 
        def getdata(self):
                client, addr = self.sock.accept()
-               obj = self.cls(client)
+               obj = self.cls(client, self.data)
                obj.close = self._make_closer(obj, client)
                self.lib.parent.log(repr(self), '?', 'New connection #%d from %s' % (client.fileno(), addr))
                self.clients.append((client,obj))