modules/trivia.py

   1 # Erebus IRC bot - Author: Erebus Team
   2 # trivia module
   3 # This file is released into the public domain; see http://unlicense.org/
   4
   5 # module info
   6 modinfo = {
   7         'author': 'Erebus Team',
   8         'license': 'public domain',
   9         'compatible': [1], # compatible module API versions
  10         'depends': [], # other modules required to work properly?
  11 }
  12
  13 # preamble
  14 import modlib
  15 lib = modlib.modlib(__name__)
  16 def modstart(parent, *args, **kwargs):
  17         state.gotParent(parent)
  18         lib.hookchan(state.db['chan'])(trivia_checkanswer) # we need parent for this. so it goes here.
  19         return lib.modstart(parent, *args, **kwargs)
  20 def modstop(*args, **kwargs):
  21         global state
  22         try:
  23                 stop()
  24                 state.closeshop()
  25                 del state
  26         except Exception: pass
  27         return lib.modstop(*args, **kwargs)
  28
  29 # module code
  30 import json, random, threading, re, time, datetime
  31
  32 try:
  33         import twitter
  34 except: pass # doesn't matter if we don't have twitter, updating the status just will fall through the try-except if so...
  35
  36 def findnth(haystack, needle, n): #http://stackoverflow.com/a/1884151
  37         parts = haystack.split(needle, n+1)
  38         if len(parts)<=n+1:
  39                 return -1
  40         return len(haystack)-len(parts[-1])-len(needle)
  41
  42 def person(num): return state.db['users'][state.db['ranks'][num]]['realnick']
  43 def pts(num): return str(state.db['users'][state.db['ranks'][num]]['points'])
  44 def country(num, default="??"): return lib.mod('userinfo').get(person(num), 'country', default=default)
  45
  46 class TriviaState(object):
  47         def __init__(self, parent=None, pointvote=False):
  48                 if parent is not None:
  49                         self.gotParent(parent, pointvote)
  50
  51         def gotParent(self, parent, pointvote=False):
  52                 self.parent = parent
  53                 self.questionfile = self.parent.cfg.get('trivia', 'jsonpath', default="./modules/trivia.json")
  54                 self.db = json.load(open(self.questionfile, "r"))
  55                 self.chan = self.db['chan']
  56                 self.curq = None
  57                 self.nextq = None
  58                 self.nextquestiontimer = None
  59                 self.steptimer = None
  60                 self.hintstr = None
  61                 self.hintanswer = None
  62                 self.hintsgiven = 0
  63                 self.revealpossibilities = None
  64                 self.gameover = False
  65                 self.missedquestions = 0
  66
  67                 if 'starttime' not in self.db or self.db['starttime'] is None:
  68                         self.db['starttime'] = time.time()
  69
  70                 if pointvote:
  71                         self.getchan().msg("Vote for the next round target points! Options: %s. Vote using !vote <choice>" % (', '.join([str(x) for x in self.db['targetoptions']])))
  72                         self.getchan().msg("You have %s seconds." % (self.db['votetimer']))
  73                         self.voteamounts = dict([(x, 0) for x in self.db['targetoptions']]) # make a dict {pointsoptionA: 0, pointsoptionB: 0, ...}
  74                         self.pointvote = threading.Timer(self.db['votetimer'], self.endPointVote)
  75                         self.pointvote.start()
  76                 else:
  77                         self.pointvote = None
  78
  79         def __del__(self):
  80                 self.closeshop()
  81         def closeshop(self):
  82                 if threading is not None and threading._Timer is not None:
  83                         if isinstance(self.steptimer, threading._Timer):
  84                                 self.steptimer.cancel()
  85                         if isinstance(self.nextquestiontimer, threading._Timer):
  86                                 self.nextquestiontimer.cancel()
  87                                 self.nextquestiontimer = None
  88                 if json is not None and json.dump is not None:
  89                         json.dump(self.db, open(self.questionfile, "w"))#, indent=4, separators=(',', ': '))
  90
  91         def getchan(self):
  92                 return self.parent.channel(self.chan)
  93         def getbot(self):
  94                 return self.getchan().bot
  95
  96         def nexthint(self, hintnum):
  97                 answer = self.hintanswer
  98
  99                 if self.hintstr is None or self.revealpossibilities is None or self.reveal is None:
 100                         self.hintstr = list(re.sub(r'[a-zA-Z0-9]', '*', answer))
 101                         self.revealpossibilities = range(''.join(self.hintstr).count('*'))
 102                         self.reveal = int(''.join(self.hintstr).count('*') * (7/24.0))
 103
 104                 for i in range(self.reveal):
 105                         revealcount = random.choice(self.revealpossibilities)
 106                         revealloc = findnth(''.join(self.hintstr), '*', revealcount)
 107                         self.revealpossibilities.remove(revealcount)
 108                         self.hintstr[revealloc] = answer[revealloc]
 109                 self.parent.channel(self.chan).bot.msg(self.chan, "\00304,01Here's a hint: %s" % (''.join(self.hintstr)))
 110
 111                 self.hintsgiven += 1
 112
 113                 if hintnum < self.db['hintnum']:
 114                         self.steptimer = threading.Timer(self.db['hinttimer'], self.nexthint, args=[hintnum+1])
 115                         self.steptimer.start()
 116                 else:
 117                         self.steptimer = threading.Timer(self.db['hinttimer'], self.nextquestion, args=[True])
 118                         self.steptimer.start()
 119
 120         def doGameOver(self):
 121                 msg = self.getchan().msg
 122                 winner = person(0)
 123                 try:
 124                         msg("\00312THE GAME IS OVER!!!")
 125                         msg("THE WINNER IS: %s (%s)" % (person(0), pts(0)))
 126                         msg("2ND PLACE: %s (%s)" % (person(1), pts(1)))
 127                         msg("3RD PLACE: %s (%s)" % (person(2), pts(2)))
 128                         [msg("%dth place: %s (%s)" % (i+1, person(i), pts(i))) for i in range(3,10)]
 129                 except IndexError: pass
 130                 except Exception as e: msg("DERP! %r" % (e))
 131
 132                 if self.db['hofpath'] is not None and self.db['hofpath'] != '':
 133                         self.writeHof()
 134
 135                 self.db['users'] = {}
 136                 self.db['ranks'] = []
 137                 stop()
 138                 self.closeshop()
 139
 140                 try:
 141                         t = twitter.Twitter(auth=twitter.OAuth(self.getbot().parent.cfg.get('trivia', 'token'),
 142                                 self.getbot().parent.cfg.get('trivia', 'token_sec'),
 143                                 self.getbot().parent.cfg.get('trivia', 'con'),
 144                                 self.getbot().parent.cfg.get('trivia', 'con_sec')))
 145                         t.statuses.update(status="Round is over! The winner was %s" % (winner))
 146                 except: pass #don't care if errors happen updating twitter.
 147
 148                 self.__init__(self.parent, True)
 149
 150         def writeHof(self):
 151                 def person(num):
 152                         try: return self.db['users'][self.db['ranks'][num]]['realnick']
 153                         except: return "none"
 154                 def pts(num):
 155                         try: return str(self.db['users'][self.db['ranks'][num]]['points'])
 156                         except: return 0
 157
 158                 try:
 159                         f = open(self.db['hofpath'], 'rb+')
 160                         for i in range(self.db['hoflines']): #skip this many lines
 161                                 f.readline()
 162                         insertpos = f.tell()
 163                         fcontents = f.read()
 164                         f.seek(insertpos)
 165                         f.write((self.db['hofformat']+"\n") % {
 166                                 'date': time.strftime("%F", time.gmtime()),
 167                                 'duration': str(datetime.timedelta(seconds=time.time()-self.db['starttime'])),
 168                                 'targetscore': self.db['target'],
 169                                 'firstperson': person(0),
 170                                 'firstscore': pts(0),
 171                                 'secondperson': person(1),
 172                                 'secondscore': pts(1),
 173                                 'thirdperson': person(2),
 174                                 'thirdscore': pts(2),
 175                         })
 176                         f.write(fcontents)
 177                         return True
 178                 except Exception as e:
 179                         raise e
 180                         return False
 181                 finally:
 182                         f.close()
 183
 184         def endPointVote(self):
 185                 self.getchan().msg("Voting has ended!")
 186                 votelist = sorted(self.voteamounts.items(), key=lambda item: item[1]) #sort into list of tuples: [(option, number_of_votes), ...]
 187                 for i in range(len(votelist)-1):
 188                         item = votelist[i]
 189                         self.getchan().msg("%s place: %s (%s votes)" % (len(votelist)-i, item[0], item[1]))
 190                 self.getchan().msg("Aaaaand! The next round will be to \002%s\002 points! (%s votes)" % (votelist[-1][0], votelist[-1][1]))
 191
 192                 self.db['target'] = votelist[-1][0]
 193                 self.pointvote = None
 194
 195                 self.nextquestion() #start the game!
 196
 197         def nextquestion(self, qskipped=False, iteration=0, skipwait=False):
 198                 self.curq = None
 199                 if self.gameover == True:
 200                         return self.doGameOver()
 201                 if qskipped:
 202                         self.getchan().msg("\00304Fail! The correct answer was: %s" % (self.hintanswer))
 203                         self.missedquestions += 1
 204                 else:
 205                         self.missedquestions = 0
 206                         if 'topicformat' in self.db and self.db['topicformat'] is not None:
 207                                 self.getbot().conn.send("TOPIC %s" % (self.db['chan']))
 208
 209                 if isinstance(self.steptimer, threading._Timer):
 210                         self.steptimer.cancel()
 211                 if isinstance(self.nextquestiontimer, threading._Timer):
 212                         self.nextquestiontimer.cancel()
 213                         self.nextquestiontimer = None
 214
 215                 self.hintstr = None
 216                 self.hintsgiven = 0
 217                 self.revealpossibilities = None
 218                 self.reveal = None
 219
 220                 if self.missedquestions > self.db['maxmissedquestions']:
 221                         stop()
 222                         self.getbot().msg(self.getchan(), "%d questions unanswered! Stopping the game.")
 223
 224                 if skipwait:
 225                         self._nextquestion(iteration)
 226                 else:
 227                         self.nextquestiontimer = threading.Timer(self.db['questionpause'], self._nextquestion, args=[iteration])
 228                         self.nextquestiontimer.start()
 229
 230         def _nextquestion(self, iteration):
 231                 if self.nextq is not None:
 232                         nextqid = None
 233                         nextq = self.nextq
 234                         self.nextq = None
 235                 else:
 236                         nextqid = random.randrange(0, len(self.db['questions']))
 237                         nextq = self.db['questions'][nextqid]
 238
 239                 if nextq[0][0] == "!":
 240                         nextqid = None
 241                         nextq = specialQuestion(nextq)
 242
 243                 if len(nextq) > 2 and nextq[2] - time.time() < 7*24*60*60 and iteration < 10:
 244                         return self._nextquestion(iteration=iteration+1) #short-circuit to pick another question
 245                 if len(nextq) > 2:
 246                         nextq[2] = time.time()
 247                 else:
 248                         nextq.append(time.time())
 249
 250                 nextq[1] = nextq[1].lower()
 251
 252                 qtext = "\00304,01Next up: "
 253                 if nextqid is not None:
 254                         qtext += "(%d) " % (nextqid)
 255                 qary = nextq[0].split(None)
 256                 for qword in qary:
 257                         qtext += "\00304,01"+qword+"\00301,01"+chr(random.randrange(0x61,0x7A)) #a-z
 258                 self.getbot().msg(self.chan, qtext)
 259
 260                 self.curq = nextq
 261
 262                 if isinstance(self.curq[1], basestring): self.hintanswer = self.curq[1]
 263                 else: self.hintanswer = random.choice(self.curq[1])
 264
 265                 self.steptimer = threading.Timer(self.db['hinttimer'], self.nexthint, args=[1])
 266                 self.steptimer.start()
 267
 268         def checkanswer(self, answer):
 269                 if self.curq is None:
 270                         return False
 271                 elif isinstance(self.curq[1], basestring):
 272                         return answer.lower() == self.curq[1]
 273                 else: # assume it's a list or something.
 274                         return answer.lower() in self.curq[1]
 275
 276         def addpoint(self, user_obj, count=1):
 277                 user_nick = str(user_obj)
 278                 user = user_nick.lower() # save this separately as we use both
 279                 if user in self.db['users']:
 280                         self.db['users'][user]['points'] += count
 281                 else:
 282                         self.db['users'][user] = {'points': count, 'realnick': user_nick, 'rank': len(self.db['ranks'])}
 283                         self.db['ranks'].append(user)
 284
 285                 self.db['ranks'].sort(key=lambda nick: self.db['users'][nick]['points'], reverse=True) #re-sort ranks, rather than dealing with anything more efficient
 286                 for i in range(0, len(self.db['ranks'])):
 287                         nick = self.db['ranks'][i]
 288                         self.db['users'][nick]['rank'] = i
 289
 290                 if self.db['users'][user]['points'] >= self.db['target']:
 291                         self.gameover = True
 292
 293                 return self.db['users'][user]['points']
 294
 295         def points(self, user):
 296                 user = str(user).lower()
 297                 if user in self.db['users']:
 298                         return self.db['users'][user]['points']
 299                 else:
 300                         return 0
 301
 302         def rank(self, user):
 303                 user = str(user).lower()
 304                 if user in self.db['users']:
 305                         return self.db['users'][user]['rank']+1
 306                 else:
 307                         return len(self.db['users'])+1
 308
 309         def targetuser(self, user):
 310                 if len(self.db['ranks']) == 0: return "no one is ranked!"
 311
 312                 user = str(user).lower()
 313                 if user in self.db['users']:
 314                         rank = self.db['users'][user]['rank']
 315                         if rank == 0:
 316                                 return "you're in the lead!"
 317                         else:
 318                                 return self.db['ranks'][rank-1]
 319                 else:
 320                         return self.db['ranks'][-1]
 321         def targetpoints(self, user):
 322                 if len(self.db['ranks']) == 0: return 0
 323
 324                 user = str(user).lower()
 325                 if user in self.db['users']:
 326                         rank = self.db['users'][user]['rank']
 327                         if rank == 0:
 328                                 return "N/A"
 329                         else:
 330                                 return self.db['users'][self.db['ranks'][rank-1]]['points']
 331                 else:
 332                         return self.db['users'][self.db['ranks'][-1]]['points']
 333
 334 state = TriviaState()
 335
 336 # we have to hook this in modstart, since we don't know the channel until then.
 337 def trivia_checkanswer(bot, user, chan, *args):
 338         line = ' '.join([str(arg) for arg in args])
 339         if state.checkanswer(line):
 340                 state.curq = None
 341                 bot.msg(chan, "\00312%s\003 has it! The answer was \00312%s\003. New score: %d. Rank: %d. Target: %s (%s)." % (user, line, state.addpoint(user), state.rank(user), state.targetuser(user), state.targetpoints(user)))
 342                 if state.hintsgiven == 0:
 343                         bot.msg(chan, "\00312%s\003 got an extra point for getting it before the hints! New score: %d." % (user, state.addpoint(user)))
 344                 state.nextquestion()
 345
 346 @lib.hook('points', needchan=False)
 347 def cmd_points(bot, user, chan, realtarget, *args):
 348         if chan is not None and realtarget == chan.name: replyto = chan
 349         else: replyto = user
 350
 351         if len(args) != 0: who = args[0]
 352         else: who = user
 353
 354         bot.msg(replyto, "%s has %d points." % (who, state.points(who)))
 355
 356 @lib.hook('give', glevel=lib.STAFF, needchan=False)
 357 @lib.argsGE(1)
 358 def cmd_give(bot, user, chan, realtarget, *args):
 359         whoto = args[0]
 360         if len(args) > 1:
 361                 numpoints = int(args[1])
 362         else:
 363                 numpoints = 1
 364         balance = state.addpoint(whoto, numpoints)
 365
 366         bot.msg(chan, "%s gave %s %d points. New balance: %d" % (user, whoto, numpoints, balance))
 367
 368 @lib.hook('setnextid', glevel=1, needchan=False)
 369 def cmd_setnextid(bot, user, chan, realtarget, *args):
 370         try:
 371                 qid = int(args[0])
 372                 state.nextq = state.db['questions'][qid]
 373                 bot.msg(user, "Done. Next question is: %s" % (state.nextq[0]))
 374         except Exception as e:
 375                 bot.msg(user, "Error: %s" % (e))
 376
 377 @lib.hook('setnext', glevel=lib.STAFF, needchan=False)
 378 @lib.argsGE(1)
 379 def cmd_setnext(bot, user, chan, realtarget, *args):
 380         line = ' '.join([str(arg) for arg in args])
 381         linepieces = line.split('*')
 382         if len(linepieces) < 2:
 383                 bot.msg(user, "Error: need <question>*<answer>")
 384                 return
 385         question = linepieces[0].strip()
 386         answer = linepieces[1].strip()
 387         state.nextq = [question, answer]
 388         bot.msg(user, "Done.")
 389
 390 @lib.hook('skip', glevel=1, needchan=False)
 391 def cmd_skip(bot, user, chan, realtarget, *args):
 392         state.nextquestion(qskipped=True, skipwait=True)
 393
 394 @lib.hook('start', needchan=False)
 395 def cmd_start(bot, user, chan, realtarget, *args):
 396         if chan is not None and realtarget == chan.name: replyto = chan
 397         else: replyto = user
 398
 399         if state.curq is None and state.pointvote is None and state.nextquestiontimer is None:
 400                 state.nextquestion(skipwait=True)
 401         elif state.pointvote is not None:
 402                 bot.msg(replyto, "There's a vote in progress!")
 403         else:
 404                 bot.msg(replyto, "Game is already started!")
 405
 406 @lib.hook('stop', glevel=1, needchan=False)
 407 def cmd_stop(bot, user, chan, realtarget, *args):
 408         if stop():
 409                 bot.msg(state.chan, "Game stopped by %s" % (user))
 410         else:
 411                 bot.msg(user, "Game isn't running.")
 412
 413 def stop():
 414         try:
 415                 if state.curq is not None:
 416                         state.curq = None
 417                         try:
 418                                 state.steptimer.cancel()
 419                         except Exception as e:
 420                                 print "!!! steptimer.cancel(): %s %r" % (e,e)
 421                         try:
 422                                 state.nextquestiontimer.cancel()
 423                                 state.nextquestiontimer = None
 424                         except Exception as e:
 425                                 print "!!! nextquestiontimer.cancel(): %s %r" % (e,e)
 426                         return True
 427                 else:
 428                         return False
 429         except NameError:
 430                 pass
 431
 432 @lib.hook('badq', needchan=False)
 433 @lib.argsGE(2)
 434 def cmd_badq(bot, user, chan, realtarget, *args):
 435         qid = int(args[0])
 436         reason = ' '.join(args[1:])
 437         state.db['badqs'].append([qid, reason])
 438         bot.msg(user, "Reported bad question #%d" % (qid))
 439
 440 @lib.hook('badqs', glevel=lib.STAFF, needchan=False)
 441 def cmd_badqs(bot, user, chan, realtarget, *args):
 442         if len(state.db['badqs']) == 0:
 443                 bot.msg(user, "No reports.")
 444
 445         for i in range(len(state.db['badqs'])):
 446                 try:
 447                         report = state.db['badqs'][i]
 448                         bot.msg(user, "Report #%d: Q%d: %s" % (i, report[0], report[1]))
 449                         question = state.db['questions'][int(report[0])]
 450                         bot.msg(user, "- Question is: %s" % (question[0]))
 451                         bot.msg(user, "- Answer is: %s" % (question[1]))
 452                 except Exception as e:
 453                         bot.msg(user, "- Exception: %r" % (e))
 454
 455 @lib.hook('clearbadqs', glevel=lib.STAFF, needchan=False)
 456 def cmd_clearbadqs(bot, user, chan, realtarget, *args):
 457         state.db['badqs'] = []
 458         bot.msg(user, "Cleared reports.")
 459
 460 @lib.hook('delbadq', glevel=lib.STAFF, needchan=False)
 461 @lib.argsEQ(1)
 462 def cmd_delbadq(bot, user, chan, realtarget, *args):
 463         qid = int(args[0])
 464         del state.db['badqs'][qid]
 465         bot.msg(user, "Removed report #%d" % (qid))
 466
 467 @lib.hook('rank', needchan=False)
 468 def cmd_rank(bot, user, chan, realtarget, *args):
 469         if chan is not None and realtarget == chan.name: replyto = chan
 470         else: replyto = user
 471
 472         if len(args) != 0: who = args[0]
 473         else: who = user
 474
 475         bot.msg(replyto, "%s is in %d place (%s points). Target is: %s (%s points)." % (who, state.rank(who), state.points(who), state.targetuser(who), state.targetpoints(who)))
 476
 477 @lib.hook('top10', needchan=False)
 478 def cmd_top10(bot, user, chan, realtarget, *args):
 479         if len(state.db['ranks']) == 0:
 480                 return bot.msg(state.db['chan'], "No one is ranked!")
 481
 482         max = len(state.db['ranks'])
 483         if max > 10:
 484                 max = 10
 485         replylist = ', '.join(["%s (%s) %s" % (person(x), country(x, "unknown"), pts(x)) for x in range(max)])
 486         bot.msg(state.db['chan'], "Top %d: %s" % (max, replylist))
 487
 488 @lib.hook('settarget', glevel=lib.ADMIN, needchan=False)
 489 def cmd_settarget(bot, user, chan, realtarget, *args):
 490         try:
 491                 state.db['target'] = int(args[0])
 492                 bot.msg(state.db['chan'], "Target has been changed to %s points!" % (state.db['target']))
 493
 494                 if state.pointvote is not None:
 495                         state.pointvote.cancel()
 496                         state.pointvote = None
 497                         bot.msg(state.db['chan'], "Vote has been cancelled!")
 498         except Exception as e:
 499                 print e
 500                 bot.msg(user, "Failed to set target.")
 501
 502 @lib.hook('vote', needchan=False)
 503 def cmd_vote(bot, user, chan, realtarget, *args):
 504         if state.pointvote is not None:
 505                 if int(args[0]) in state.voteamounts:
 506                         state.voteamounts[int(args[0])] += 1
 507                         bot.msg(user, "Your vote has been recorded.")
 508                 else:
 509                         bot.msg(user, "Sorry - that's not an option!")
 510         else:
 511                 bot.msg(user, "There's no vote in progress.")
 512
 513 @lib.hook('maxmissed', glevel=lib.ADMIN, needchan=False)
 514 def cmd_maxmissed(bot, user, chan, realtarget, *args):
 515         try:
 516                 state.db['maxmissedquestions'] = int(args[0])
 517                 bot.msg(state.db['chan'], "Max missed questions before round ends has been changed to %s." % (state.db['maxmissedquestions']))
 518         except:
 519                 bot.msg(user, "Failed to set maxmissed.")
 520
 521 @lib.hook('hinttimer', glevel=lib.ADMIN, needchan=False)
 522 def cmd_hinttimer(bot, user, chan, realtarget, *args):
 523         try:
 524                 state.db['hinttimer'] = float(args[0])
 525                 bot.msg(state.db['chan'], "Time between hints has been changed to %s." % (state.db['hinttimer']))
 526         except:
 527                 bot.msg(user, "Failed to set hint timer.")
 528
 529 @lib.hook('hintnum', glevel=lib.ADMIN, needchan=False)
 530 def cmd_hintnum(bot, user, chan, realtarget, *args):
 531         try:
 532                 state.db['hintnum'] = int(args[0])
 533                 bot.msg(state.db['chan'], "Max number of hints has been changed to %s." % (state.db['hintnum']))
 534         except:
 535                 bot.msg(user, "Failed to set hintnum.")
 536
 537 @lib.hook('questionpause', glevel=lib.ADMIN, needchan=False)
 538 def cmd_questionpause(bot, user, chan, realtarget, *args):
 539         try:
 540                 state.db['questionpause'] = float(args[0])
 541                 bot.msg(state.db['chan'], "Pause between questions has been changed to %s." % (state.db['questionpause']))
 542         except:
 543                 bot.msg(user, "Failed to set questionpause.")
 544
 545 @lib.hook('findq', glevel=1, needchan=False)
 546 def cmd_findquestion(bot, user, chan, realtarget, *args):
 547         matches = [str(i) for i in range(len(state.db['questions'])) if state.db['questions'][i][0] == ' '.join(args)] #TODO looser equality check
 548         if len(matches) > 1:
 549                 bot.msg(user, "Multiple matches: %s" % (', '.join(matches)))
 550         elif len(matches) == 1:
 551                 bot.msg(user, "One match: %s" % (matches[0]))
 552         else:
 553                 bot.msg(user, "No match.")
 554
 555 @lib.hook('delq', glevel=lib.STAFF, needchan=False)
 556 @lib.hook('deleteq', glevel=lib.STAFF, needchan=False)
 557 def cmd_deletequestion(bot, user, chan, realtarget, *args):
 558         try:
 559                 backup = state.db['questions'][int(args[0])]
 560                 del state.db['questions'][int(args[0])]
 561                 bot.msg(user, "Deleted %s*%s" % (backup[0], backup[1]))
 562         except:
 563                 bot.msg(user, "Couldn't delete that question.")
 564
 565 @lib.hook('addq', glevel=lib.STAFF, needchan=False)
 566 def cmd_addquestion(bot, user, chan, realtarget, *args):
 567         line = ' '.join([str(arg) for arg in args])
 568         linepieces = line.split('*')
 569         if len(linepieces) < 2:
 570                 bot.msg(user, "Error: need <question>*<answer>")
 571                 return
 572         question = linepieces[0].strip()
 573         answer = linepieces[1].strip()
 574         state.db['questions'].append([question, answer])
 575         bot.msg(user, "Done. Question is #%s" % (len(state.db['questions'])-1))
 576
 577
 578 @lib.hook('triviahelp', needchan=False)
 579 def cmd_triviahelp(bot, user, chan, realtarget, *args):
 580         bot.msg(user,             "START")
 581         bot.msg(user,             "TOP10")
 582         bot.msg(user,             "POINTS        [<user>]")
 583         bot.msg(user,             "RANK          [<user>]")
 584         bot.msg(user,             "BADQ          <id> <reason>")
 585         if user.glevel >= 1:
 586                 bot.msg(user,         "SKIP                            (>=KNOWN)")
 587                 bot.msg(user,         "STOP                            (>=KNOWN)")
 588                 bot.msg(user,         "FINDQ         <question>        (>=KNOWN)")
 589                 if user.glevel >= lib.STAFF:
 590                         bot.msg(user,     "GIVE          <user> [<points>] (>=STAFF)")
 591                         bot.msg(user,     "SETNEXT       <q>*<a>           (>=STAFF)")
 592                         bot.msg(user,     "ADDQ          <q>*<a>           (>=STAFF)")
 593                         bot.msg(user,     "DELETEQ       <q>*<a>           (>=STAFF)  [aka DELQ]")
 594                         bot.msg(user,     "BADQS                           (>=STAFF)")
 595                         bot.msg(user,     "CLEARBADQS                      (>=STAFF)")
 596                         bot.msg(user,     "DELBADQ       <reportid>        (>=STAFF)")
 597                         if user.glevel >= lib.ADMIN:
 598                                 bot.msg(user, "SETTARGET     <points>          (>=ADMIN)")
 599                                 bot.msg(user, "MAXMISSED     <questions>       (>=ADMIN)")
 600                                 bot.msg(user, "HINTTIMER     <float seconds>   (>=ADMIN)")
 601                                 bot.msg(user, "HINTNUM       <hints>           (>=ADMIN)")
 602                                 bot.msg(user, "QUESTIONPAUSE <float seconds>   (>=ADMIN)")
 603
 604 @lib.hooknum(417)
 605 def num_417(bot, textline):
 606         bot.msg(state.db['chan'], "Whoops, it looks like that question didn't quite go through! (E:417). Let's try another...")
 607         state.nextquestion(qskipped=False, skipwait=True)
 608
 609 @lib.hooknum(332)
 610 def num_TOPIC(bot, textline):
 611         pieces = textline.split(None, 4)
 612         chan = pieces[3]
 613         if chan != state.db['chan']:
 614                 return
 615         gottopic = pieces[4][1:]
 616
 617         formatted = state.db['topicformat'] % {
 618                 'chan': state.db['chan'],
 619                 'top1': "%s (%s)" % (person(0), pts(0)),
 620                 'top3': '/'.join([
 621                         "%s (%s)" % (person(x), pts(x))
 622                         for x in range(3) if x < len(state.db['ranks'])
 623                 ]),
 624                 'top3c': ' '.join([
 625                         "%s (%s, %s)" % (person(x), pts(x), country(x))
 626                         for x in range(3) if x < len(state.db['ranks'])
 627                 ]),
 628                 'top10': ' '.join([
 629                         "%s (%s)" % (person(x), pts(x))
 630                         for x in range(10) if x < len(state.db['ranks'])
 631                 ]),
 632                 'top10c': ' '.join([
 633                         "%s (%s, %s)" % (person(x), pts(x), country(x))
 634                         for x in range(10) if x < len(state.db['ranks'])
 635                 ]),
 636                 'target': state.db['target'],
 637         }
 638         if gottopic != formatted:
 639                 state.getbot().conn.send("TOPIC %s :%s" % (state.db['chan'], formatted))
 640
 641
 642 def specialQuestion(oldq):
 643         newq = [oldq[0], oldq[1]]
 644         qtype = oldq[0].upper()
 645
 646         if qtype == "!MONTH":
 647                 newq[0] = "What month is it currently (in UTC)?"
 648                 newq[1] = time.strftime("%B", time.gmtime()).lower()
 649         elif qtype == "!MATH+":
 650                 randnum1 = random.randrange(0, 11)
 651                 randnum2 = random.randrange(0, 11)
 652                 newq[0] = "What is %d + %d?" % (randnum1, randnum2)
 653                 newq[1] = spellout(randnum1+randnum2)
 654         return newq
 655
 656 def spellout(num):
 657         return [
 658                 "zero", "one", "two", "three", "four", "five", "six", "seven", "eight",
 659                 "nine", "ten", "eleven", "twelve", "thirteen", "fourteen", "fifteen",
 660                 "sixteen", "seventeen", "eighteen", "nineteen", "twenty"
 661         ][num]