]> jfr.im git - erebus.git/blob - bot.py
move TODOs in code to github issues
[erebus.git] / bot.py
1 #!/usr/bin/python
2
3 # Erebus IRC bot - Author: John Runyon
4 # "Bot" and "BotConnection" classes (handling a specific "arm")
5
6 import socket, sys, time, threading, os, random
7 from collections import deque
8
9 #bots = {'erebus': bot.Bot(nick='Erebus', user='erebus', bind='', server='irc.quakenet.org', port=6667, realname='Erebus')}
10 class Bot(object):
11 def __init__(self, parent, nick, user, bind, authname, authpass, server, port, realname):
12 self.parent = parent
13 self.nick = nick
14 self.permnick = nick
15 self.user = user
16 self.realname = realname
17
18 self.authname = authname
19 self.authpass = authpass
20
21 curs = self.parent.db.cursor()
22 if curs.execute("SELECT chname FROM chans WHERE bot = %s AND active = 1", (self.nick,)):
23 chansres = curs.fetchall()
24 curs.close()
25 self.chans = [self.parent.newchannel(self, row['chname']) for row in chansres]
26 else:
27 self.chans = []
28
29 self.conn = BotConnection(self, bind, server, port)
30
31 self.msgqueue = deque()
32 self.slowmsgqueue = deque()
33 self.makemsgtimer()
34 self.msgtimer.start()
35
36 def __del__(self):
37 curs = self.parent.db.cursor()
38 curs.execute("UPDATE bots SET connected = 0 WHERE nick = %s", (self.nick,))
39 curs.close()
40
41
42 def log(self, *args, **kwargs):
43 self.parent.log(self.nick, *args, **kwargs)
44
45 def connect(self):
46 if self.conn.connect():
47 self.parent.newfd(self, self.conn.socket.fileno())
48
49 def getdata(self):
50 return self.conn.read()
51
52 def _checknick(self): # check if we're using the right nick, try changing
53 if self.nick != self.permnick and self.conn.registered():
54 self.conn.send("NICK %s" % (self.permnick))
55
56 def parse(self, line):
57 self.log('I', line)
58 pieces = line.split()
59
60 # dispatch dict
61 zero = { #things to look for without source
62 'NOTICE': self._gotconnected,
63 'PING': self._gotping,
64 'ERROR': self._goterror,
65 }
66 one = { #things to look for after source
67 '001': self._got001,
68 '376': self._gotRegistered,
69 '422': self._gotRegistered,
70 'PRIVMSG': self._gotprivmsg,
71 '353': self._got353, #NAMES
72 '354': self._got354, #WHO
73 '433': self._got433, #nick in use
74 'JOIN': self._gotjoin,
75 'PART': self._gotpart,
76 'KICK': self._gotkick,
77 'QUIT': self._gotquit,
78 'NICK': self._gotnick,
79 'MODE': self._gotmode,
80 }
81
82 if self.parent.hasnumhook(pieces[1]):
83 hooks = self.parent.getnumhook(pieces[1])
84 for callback in hooks:
85 try:
86 callback(self, line)
87 except Exception:
88 self.__debug_cbexception("numhook", line)
89
90 if pieces[0] in zero:
91 zero[pieces[0]](pieces)
92 elif pieces[1] in one:
93 one[pieces[1]](pieces)
94
95 def _gotconnected(self, pieces):
96 if not self.conn.registered():
97 self.conn.register()
98 def _gotping(self, pieces):
99 self.conn.send("PONG %s" % (pieces[1]))
100 self._checknick()
101 def _goterror(self, pieces):
102 curs = self.parent.db.cursor()
103 curs.execute("UPDATE bots SET connected = 0")
104 curs.close()
105 sys.exit(2)
106 os._exit(2)
107 def _got001(self, pieces):
108 pass # wait until the end of MOTD instead
109 def _gotRegistered(self, pieces):
110 self.conn.registered(True)
111
112 curs = self.parent.db.cursor()
113 curs.execute("UPDATE bots SET connected = 1 WHERE nick = %s", (self.nick,))
114 curs.close()
115
116 self.conn.send("MODE %s +x" % (pieces[2]))
117 if self.authname is not None and self.authpass is not None:
118 self.conn.send("AUTH %s %s" % (self.authname, self.authpass))
119 for c in self.chans:
120 self.join(c.name)
121 def _gotprivmsg(self, pieces):
122 nick = pieces[0].split('!')[0][1:]
123 user = self.parent.user(nick)
124 target = pieces[2]
125 msg = ' '.join(pieces[3:])[1:]
126 self.parsemsg(user, target, msg)
127 def _got353(self, pieces):
128 chan = self.parent.channel(pieces[4])
129 names = pieces[5:]
130 names[0] = names[0][1:] #remove colon
131 for n in names:
132 user = self.parent.user(n.lstrip('@+'))
133 if n[0] == '@':
134 chan.userjoin(user, 'op')
135 elif n[0] == '+':
136 chan.userjoin(user, 'voice')
137 else:
138 chan.userjoin(user)
139 user.join(chan)
140 def _got354(self, pieces):
141 qt = int(pieces[3])
142 if qt < 3:
143 nick, auth = pieces[4:6]
144 chan = None
145 else:
146 chan, nick, auth = pieces[4:7]
147 chan = self.parent.channel(chan)
148 user = self.parent.user(nick)
149 user.authed(auth)
150
151 if chan is not None:
152 user.join(chan)
153 chan.userjoin(user)
154
155 if qt == 2: # triggered by !auth
156 if user.isauthed():
157 if user.glevel > 0:
158 self.msg(nick, "You are now known as #%s (access level: %s)" % (auth, user.glevel))
159 else:
160 self.msg(nick, "You are now known as #%s (not staff)" % (auth))
161 else:
162 self.msg(nick, "I tried, but you're not authed!")
163 def _got433(self, pieces):
164 if not self.conn.registered(): #we're trying to connect
165 newnick = "%s%d" % (self.nick, random.randint(111,999))
166 self.conn.send("NICK %s" % (newnick))
167 self.nick = newnick
168 def _gotjoin(self, pieces):
169 nick = pieces[0].split('!')[0][1:]
170 chan = self.parent.channel(pieces[2])
171
172 if nick == self.nick:
173 self.conn.send("WHO %s c%%cant,3" % (chan))
174 else:
175 user = self.parent.user(nick, justjoined=True)
176 chan.userjoin(user)
177 user.join(chan)
178 def _clientLeft(self, nick, chan):
179 if nick != self.nick:
180 gone = self.parent.user(nick).part(chan)
181 chan.userpart(self.parent.user(nick))
182 if gone:
183 self.parent.user(nick).quit()
184 del self.parent.users[nick.lower()]
185 def _gotpart(self, pieces):
186 nick = pieces[0].split('!')[0][1:]
187 chan = self.parent.channel(pieces[2])
188 self._clientLeft(nick, chan)
189 def _gotkick(self, pieces):
190 nick = pieces[3]
191 chan = self.parent.channel(pieces[2])
192 self._clientLeft(nick, chan)
193 def _gotquit(self, pieces):
194 nick = pieces[0].split('!')[0][1:]
195 if nick != self.nick:
196 for chan in self.parent.user(nick).chans:
197 chan.userpart(self.parent.user(nick))
198 self.parent.user(nick).quit()
199 del self.parent.users[nick.lower()]
200 def _gotnick(self, pieces):
201 oldnick = pieces[0].split('!')[0][1:]
202 newnick = pieces[2][1:]
203 if newnick.lower() != oldnick.lower():
204 self.parent.users[newnick.lower()] = self.parent.users[oldnick.lower()]
205 del self.parent.users[oldnick.lower()]
206 self.parent.users[newnick.lower()].nickchange(newnick)
207 def _gotmode(self, pieces):
208 source = pieces[0].split('!')[0][1:]
209 chan = self.parent.channel(pieces[2])
210 mode = pieces[3]
211 args = pieces[4:]
212
213 adding = True
214 for c in mode:
215 if c == '+':
216 adding = True
217 elif c == '-':
218 adding = False
219 elif c == 'o':
220 if adding:
221 chan.userop(self.parent.user(args.pop(0)))
222 else:
223 chan.userdeop(self.parent.user(args.pop(0)))
224 elif c == 'v':
225 if adding:
226 chan.uservoice(self.parent.user(args.pop(0)))
227 else:
228 chan.userdevoice(self.parent.user(args.pop(0)))
229 else:
230 pass # don't care about other modes
231
232 def __debug_cbexception(self, source, *args, **kwargs):
233 if int(self.parent.cfg.get('debug', 'cbexc', default=0)) == 1:
234 self.conn.send("PRIVMSG %s :%09.3f \ 34\1f!!! CBEXC\1f\ 3 %s" % (self.parent.cfg.get('debug', 'owner'), time.time() % 100000, source))
235 __import__('traceback').print_exc()
236 self.log('!', "CBEXC %s %r %r" % (source, args, kwargs))
237 # print "%09.3f %s [!] CBEXC %s %r %r" % (time.time() % 100000, self.nick, source, args, kwargs)
238
239
240 def parsemsg(self, user, target, msg):
241 if user.glevel <= -2: return # short circuit if user is IGNORED
242 chan = None
243 chanparam = None # was the channel specified as part of the command?
244 if len(msg) == 0:
245 return
246
247 triggerused = msg[0] == self.parent.trigger
248 if triggerused: msg = msg[1:]
249 pieces = msg.split()
250
251 if target == self.nick:
252 if msg[0] == "\001": #ctcp
253 msg = msg.strip("\001")
254 if msg == "VERSION":
255 self.msg(user, "\001VERSION Erebus v%d.%d - http://github.com/zonidjan/erebus" % (self.parent.APIVERSION, self.parent.RELEASE))
256 return
257 if len(pieces) > 1:
258 chanword = pieces[1]
259 if chanword[0] == '#':
260 chanparam = self.parent.channel(chanword)
261
262 if target != self.nick: # message was sent to a channel
263 chan = self.parent.channel(target)
264 try:
265 if msg[0] == '*': # message may be addressed to bot by "*BOTNICK" trigger?
266 if pieces[0][1:].lower() == self.nick.lower():
267 pieces.pop(0) # command actually starts with next word
268 msg = ' '.join(pieces) # command actually starts with next word
269 elif not triggerused:
270 if self.parent.haschanhook(target.lower()):
271 for callback in self.parent.getchanhook(target.lower()):
272 try:
273 cbret = callback(self, user, chan, *pieces)
274 except NotImplementedError:
275 self.msg(user, "Command not implemented.")
276 except:
277 self.msg(user, "Command failed. Code: CBEXC%09.3f" % (time.time() % 100000))
278 self.__debug_cbexception("chanhook", user=user, target=target, msg=msg)
279 return # not to bot, don't process!
280 except IndexError:
281 return # "message" is empty
282
283 cmd = pieces[0].lower()
284 rancmd = False
285 if self.parent.hashook(cmd):
286 for callback in self.parent.gethook(cmd):
287 if chanparam is not None and callback.needchan:
288 chan = chanparam
289 pieces.pop(1)
290 if chan is None and callback.needchan:
291 rancmd = True
292 self.msg(user, "You need to specify a channel for that command.")
293 elif user.glevel >= callback.reqglevel and (not callback.needchan or chan.levelof(user.auth) >= callback.reqclevel):
294 rancmd = True
295 try:
296 cbret = callback(self, user, chan, target, *pieces[1:])
297 except NotImplementedError:
298 self.msg(user, "Command not implemented.")
299 except Exception:
300 self.msg(user, "Command failed. Code: CBEXC%09.3f" % (time.time() % 100000))
301 self.__debug_cbexception("hook", user=user, target=target, msg=msg)
302 except SystemExit as e:
303 curs = self.parent.db.cursor()
304 curs.execute("UPDATE bots SET connected = 0")
305 curs.close()
306 raise e
307 else:
308 rancmd = True
309 self.msg(user, "I don't know that command.")
310 if not rancmd:
311 self.msg(user, "You don't have enough access to run that command.")
312
313 def __debug_nomsg(self, target, msg):
314 if int(self.parent.cfg.get('debug', 'nomsg', default=0)) == 1:
315 self.conn.send("PRIVMSG %s :%09.3f \ 34\1f!!! NOMSG\1f\ 3 %r, %r" % (self.parent.cfg.get('debug', 'owner'), time.time() % 100000, target, msg))
316 self.log('!', "!!! NOMSG")
317 # print "%09.3f %s [!] %s" % (time.time() % 100000, self.nick, "!!! NOMSG")
318 __import__('traceback').print_stack()
319
320 def msg(self, target, msg):
321 cmd = self._formatmsg(target, msg)
322 if self.conn.exceeded or self.conn.bytessent+len(cmd) >= self.conn.recvq:
323 self.msgqueue.append(cmd)
324 else:
325 self.conn.send(cmd)
326 self.conn.exceeded = True
327
328 def slowmsg(self, target, msg):
329 cmd = self._formatmsg(target, msg)
330 if self.conn.exceeded or self.conn.bytessent+len(cmd) >= self.conn.recvq:
331 self.slowmsgqueue.append(cmd)
332 else:
333 self.conn.send(cmd)
334 self.conn.exceeded = True
335
336 def fastmsg(self, target, msg):
337 self.conn.send(self._formatmsg(target, msg))
338 self.conn.exceeded = True
339
340 def _formatmsg(self, target, msg):
341 if target is None or msg is None:
342 return self.__debug_nomsg(target, msg)
343
344 target = str(target)
345
346 if target[0] == '#': command = "PRIVMSG %s :%s" % (target, msg)
347 else: command = "NOTICE %s :%s" % (target, msg)
348
349 return command
350
351 def _popmsg(self):
352 self.makemsgtimer()
353 self.conn.bytessent -= self.conn.recvq/3
354 if self.conn.bytessent < 0: self.conn.bytessent = 0
355 self.conn.exceeded = False
356
357 try:
358 cmd = self.msgqueue.popleft()
359 if not self.conn.exceeded and self.conn.bytessent+len(cmd) < self.conn.recvq:
360 self.conn.send(cmd)
361 self.conn.exceeded = True
362 else: raise IndexError
363 except IndexError:
364 try:
365 cmd = self.slowmsgqueue.popleft()
366 if not self.conn.exceeded and self.conn.bytessent+len(cmd) < self.conn.recvq:
367 self.conn.send(cmd)
368 self.conn.exceeded = True
369 except IndexError:
370 pass
371 self.msgtimer.start()
372
373 def makemsgtimer(self):
374 self.msgtimer = threading.Timer(3, self._popmsg)
375 self.msgtimer.daemon = True
376
377 def join(self, chan):
378 self.conn.send("JOIN %s" % (chan))
379
380 def part(self, chan):
381 self.conn.send("PART %s" % (chan))
382
383 def quit(self, reason="Shutdown"):
384 self.conn.send("QUIT :%s" % (reason))
385
386 def __str__(self): return self.nick
387 def __repr__(self): return "<Bot %r>" % (self.nick)
388
389 class BotConnection(object):
390 def __init__(self, parent, bind, server, port):
391 self.parent = parent
392 self.buffer = ''
393 self.socket = None
394
395 self.bind = bind
396 self.server = server
397 self.port = int(port)
398
399 self.state = 0 # 0=disconnected, 1=registering, 2=connected
400
401 self.bytessent = 0
402 self.recvq = 500
403 self.exceeded = False
404
405 def connect(self):
406 self.socket = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
407 self.socket.bind((self.bind, 0))
408 self.socket.connect((self.server, self.port))
409 return True
410 def register(self):
411 if self.state == 0:
412 self.send("NICK %s" % (self.parent.nick))
413 self.send("USER %s 0 * :%s" % (self.parent.user, self.parent.realname))
414 self.state = 1
415 return True
416
417 def registered(self, done=False):
418 if done: self.state = 2
419 return self.state == 2
420
421 def send(self, line):
422 self.parent.log('O', line)
423 # print "%09.3f %s [O] %s" % (time.time() % 100000, self.parent.nick, line)
424 self.bytessent += len(line)
425 self._write(line)
426
427 def _write(self, line):
428 self.socket.sendall(line+"\r\n")
429
430 def read(self):
431 self.buffer += self.socket.recv(8192)
432 lines = []
433
434 while "\r\n" in self.buffer:
435 pieces = self.buffer.split("\r\n", 1)
436 # self.parent.log('I', pieces[0]) # replaced by statement in Bot.parse()
437 # print "%09.3f %s [I] %s" % (time.time() % 100000, self.parent.nick, pieces[0])
438 lines.append(pieces[0])
439 self.buffer = pieces[1]
440
441 return lines
442
443 def __str__(self): return self.parent.nick
444 def __repr__(self): return "<BotConnection %r (%r)>" % (self.socket.fileno(), self.parent.nick)