X-Git-Url: https://jfr.im/git/erebus.git/blobdiff_plain/586997a7668236c42527b70e4da93edcf4fa4af4..9ea2be4344cbb89721f724ab4ecd1ea1edb33043:/modlib.py

diff --git a/modlib.py b/modlib.py
index 7e9a742..30e0785 100644
--- a/modlib.py
+++ b/modlib.py
@@ -10,23 +10,24 @@ class error(object):
 	def __repr__(self):
 		return '<modlib.error %r>' % self.errormsg
 	def __str__(self):
-		return self.errormsg
+		return str(self.errormsg)
 
 class modlib(object):
 	# default (global) access levels
-	MANAGER = 100
-	ADMIN = 75
-	STAFF = 50
-	AUTHED = 0
-	ANYONE = -1
+	OWNER   = 100
+	MANAGER =  99
+	ADMIN   =  75
+	STAFF   =  50
+	AUTHED  =   0
+	ANYONE  =  -1
 
 	# (channel) access levels
-	OWNER = 5
-	MASTER = 4
-	OP = 3
-	VOICE = 2
-	KNOWN = 1
-	PUBLIC = 0 #anyone (use glevel to control auth-needed)
+	OWNER   =   5
+	MASTER  =   4
+	OP      =   3
+	VOICE   =   2
+	KNOWN   =   1
+	PUBLIC  =   0 #anyone (use glevel to control auth-needed)
 
 	# messages
 	WRONGARGS = "Wrong number of arguments."
@@ -34,6 +35,7 @@ class modlib(object):
 	def __init__(self, name):
 		self.hooks = {}
 		self.numhooks = {}
+		self.chanhooks = {}
 		self.parent = None
 
 		self.name = name
@@ -44,34 +46,60 @@ class modlib(object):
 			self.parent.hook(cmd, func)
 		for num, func in self.numhooks.iteritems():
 			self.parent.hooknum(num, func)
+		for chan, func in self.chanhooks.iteritems():
+			self.parent.hookchan(chan, func)
 		return True
 	def modstop(self, parent):
 		for cmd, func in self.hooks.iteritems():
 			self.parent.unhook(cmd, func)
 		for num, func in self.numhooks.iteritems():
 			self.parent.unhooknum(num, func)
+		for chan, func in self.chanhooks.iteritems():
+			self.parent.unhookchan(chan, func)
 		return True
 
 	def hooknum(self, num):
 		def realhook(func):
-			self.numhooks[num] = func
+			self.numhooks[str(num)] = func
 			if self.parent is not None:
-				self.parent.hooknum(num, func)
+				self.parent.hooknum(str(num), func)
 			return func
 		return realhook
 
-	def hook(self, cmd, needchan=True, glevel=ANYONE, clevel=PUBLIC):
+	def hookchan(self, chan, glevel=ANYONE, clevel=PUBLIC):
 		def realhook(func):
+			self.chanhooks[chan] = func
+			if self.parent is not None:
+				self.parent.hookchan(chan, func)
+			return func
+		return realhook
+
+	def hook(self, cmd=None, needchan=True, glevel=ANYONE, clevel=PUBLIC):
+		_cmd = cmd #save this since it gets wiped out...
+		def realhook(func):
+			cmd = _cmd #...and restore it
+			if cmd is None:
+				cmd = func.__name__ # default to function name
+
 			func.needchan = needchan
 			func.reqglevel = glevel
 			func.reqclevel = clevel
 
-			self.hooks[cmd] = func
-			if self.parent is not None:
-				self.parent.hook(cmd, func)
+			if isinstance(cmd, basestring):
+				cmd = (cmd,)
+			for c in cmd:
+				self.hooks[c] = func
+				if self.parent is not None:
+					self.parent.hook(c, func)
 			return func
 		return realhook
 
+	def mod(self, modname):
+		if self.parent is not None:
+			return self.parent.module(modname)
+		else:
+			return error('unknown parent')
+
 	def argsEQ(self, num):
 		def realhook(func):
 			def checkargs(bot, user, chan, realtarget, *args):
@@ -79,6 +107,7 @@ class modlib(object):
 					return func(bot, user, chan, realtarget, *args)
 				else:
 					bot.msg(user, self.WRONGARGS)
+			checkargs.__name__ = func.__name__
 			return checkargs
 		return realhook
 
@@ -89,5 +118,22 @@ class modlib(object):
 					return func(bot, user, chan, realtarget, *args)
 				else:
 					bot.msg(user, self.WRONGARGS)
+			checkargs.__name__ = func.__name__
 			return checkargs
 		return realhook
+
+	def help(self, *args, **kwargs):
+		"""help(syntax, shorthelp, longhelp, more lines longhelp, cmd=...?)
+		Example:
+		help("<user> <pass>", "login")
+			^ Help will only be one line. Command name determined based on function name.
+		help("<user> <level>", "add a user", cmd=("adduser", "useradd"))
+			^ Help will be listed under ADDUSER; USERADD will say "alias for adduser"
+		help(None, "do stuff", "This command is really complicated.")
+			^ Command takes no args. Short description (in overall HELP listing) is "do stuff".
+			Long description (HELP <command>) will say "<command> - do stuff", newline, "This command is really complicated."
+		"""
+		try:
+			self.mod('help').reghelp(*args, **kwargs)
+		except:
+			pass