* Setting up the bot
D'bolla is a no bullshit extensible IRC/Slack bot written for Python 3.5 using
asyncio.

** Install dependencies:

#+BEGIN_SRC bash
    pip install websockets
#+END_SRC

** Configure
Copy dbolla.conf.example to dbolla.conf and edit this file. You can
specify multiples of the same connection by prefixing the config section with
'slack:' or 'irc:' followed by a unique name for this connection.

** Running
Simply run the command:

#+BEGIN_SRC bash
    ./bin/dbolla -c /path/to/my/dbolla.conf
#+END_SRC

* Writing a Plugin
* Writing a Connection
To write a new connection protocol you must inherit from
~warmachine.connections.base.Connection~. This class defines an interface you
must implement to support the plugins.
** ~__config_prefix__~
This global is used to decide which connection to use when it is found in the
config file. E.g. IRC uses ~'irc'~ and Slack uses ~'slack'~. It should be
defined somewhere near the top of your file.
** ~connect()~
D'bolla uses python 3's asyncio to manage multiple connections concurrently thus
you should use ~asyncio.open_connection~ to create your connection. Once you
have successfully connected you must set ~self.status~ to
~warmachine.connections.base.CONNECTED~. This indicates the connection is ready
to use.
** ~read()~
This method is constantly checked in a loop by the ~Bot~ class. When a message
is returned it is passed into the ~recv_msg~ method in all loaded plugins. This
return value should be formatted in the following format:

#+BEGIN_SRC python
{
    'sender': 'sender nickname',
    'channel': '#channel_name or None for private messages',
    'message': 'The message that was received',
}
#+END_SRC
** ~say(message, destination)~
This method is used by plugins to send a message to a channel or user.
** ~id~
This should return a unique id used to identify this particular connection. This
is used by plugins when saving state. As an example, the IRC connection uses
something like this:

#+BEGIN_SRC python
@property
@warmachine.utils.decorators.memoize
def id(self):
    from hashlib import md5

    value = '{}-{}'.format(self.host, self.nick)
    return md5(value.encode()).hexdigest()
#+END_SRC
** ~get_users_by_channel(channel)~
This method should return a list of all users (including the bot) for the
connection.