README

This bot is originally created to run Mafia games on freenode. I seperated each
section into modules because some other people wanted a lightweight bot they
could do whatever they wanted to do with. I've spent more time on the framework
building it up for these people instead of the mafia part of the bot itself.

---

Run genconfig.py to set your configuration options.
Run BugBot.py to load up your bot.

---

Use genplugin.py to get a blank plugin file. I don't have command name
conflict resolving yet, so try not to use a command already in use.

The cmds class should contain all your commands as defines

There is regular expression support for snarfing strings directly out of the
chat, these are contained in the regexp class. The format of this is simple:

    def commandName(self,match):
        r'Regular Expression'
        doStuff()

match will contain the result from an re.group(0) function. Usually the matching
string.

The only infrastructure I provide for you to use is outlined below. You will
need to import any modules for anything else you need.

self._parent.
  term -> Prints to the console
  -> term(LEVEL,'TEXT')
    -> Use FUNC, SUB, DBG and ERROR for the LEVEL, 'TEXT' should be obvious.

  send - Sends a message to IRC
  -> send('TEXT',nick=False,channel=False)
    -> 'TEXT' is what you want to send
    -> nick will be prepended to TEXT if given. You can use True to provide the
       callers nick
    -> Channel will default to the current channel unless you specify otherwise

  quote - Sends a raw irc command
  -> quote('TEXT')
    -> 'TEXT' is your command

  notice - sends an irc notice
  -> notice('TEXT','TARGET')
    -> 'TEXT' is the notice content
    -> 'TARGET' can be a person or a channel

  getNick
  getHost
  getUser
  getFullHost
  getChannel
  -> All return what you'd expect

  getMessage
  -> Returns everything after the command

  getArg(argNum)
  ->getArg(num)
    -> num is any integer, it'll return the word at the position after the
        message, starting at one

        command arg1 arg2 arg3
            0    1    2    3