2003-03-12 07:26:59 +01:00
|
|
|
So here's a general *programming* introduction to what the different modules do
|
|
|
|
|
and what services they provide. It is, however, only an introduction. Read
|
|
|
|
|
the modules themselves for a much more detailed explanation :)
|
|
|
|
|
|
|
|
|
|
fix.py: Just some stuff that needs to be done to make the bot work in some
|
|
|
|
|
older versions of Python (like 2.2 :))
|
|
|
|
|
|
|
|
|
|
cdb.py: A constant database library, translated from C (and my O'Caml version)
|
|
|
|
|
More information available at http://cr.yp.to/cdb.html .
|
|
|
|
|
|
|
|
|
|
ansi.py: Contains different ANSI color sequences.
|
|
|
|
|
Mostly used by the debug module.
|
|
|
|
|
|
|
|
|
|
debug.py: Functions for handling bugs and errors in a consistent manner
|
|
|
|
|
throughout the bot.
|
|
|
|
|
|
|
|
|
|
conf.py: The configuration file for the bot -- it sets a lot of variables that
|
|
|
|
|
other modules check for when they have questions about what they need
|
|
|
|
|
to do.
|
|
|
|
|
|
|
|
|
|
world.py: Just a dropping off place for some globals that need to be shared
|
|
|
|
|
among all the modules. It's obviously not used *a lot*, but some
|
|
|
|
|
things seem to fit better here than anywhere else.
|
|
|
|
|
|
|
|
|
|
bot.py: The topmost module, the one that runs the bot. It's also probably the
|
|
|
|
|
'dirtiest' module right now, but I'll add proper command line parsing
|
|
|
|
|
and clean it up a bit later.
|
|
|
|
|
|
|
|
|
|
privmsgs.py: The privmsg commands that are included by default in the bot.
|
|
|
|
|
It's probably most useful from a programming standpoint simply so
|
|
|
|
|
a new programmer can see what commands look like.
|
|
|
|
|
|
2003-03-25 09:06:04 +01:00
|
|
|
callbacks.py: A few basic callbacks providing significant functionality.
|
|
|
|
|
You'll likely be inheriting from Privmsg quite a bit.
|
2003-03-12 07:26:59 +01:00
|
|
|
|
|
|
|
|
ircdb.py: The users and channels databases are here, as well as the
|
|
|
|
|
IrcUser and IrcChannel classes. Look here when you want to
|
|
|
|
|
restrict a command to only certain users.
|
|
|
|
|
|
|
|
|
|
irclib.py: Provides the most important class in the irclib, Irc. It represents
|
|
|
|
|
a connection to an IRC server, but it's entirely separate from the
|
|
|
|
|
network implementation. It's connected to the network (or whatever
|
|
|
|
|
else drives it) by a "driver" module which uses its feedMsg/takeMsg
|
|
|
|
|
functions.
|
|
|
|
|
|
|
|
|
|
drivers.py: The baseclass (IrcDriver) for various drivers to drive irclib.Irc
|
|
|
|
|
classes. Also, the driving mechanism.
|
|
|
|
|
|
|
|
|
|
asyncoreDrivers.py: The asyncore-based drivers for use with the bot.
|
|
|
|
|
|
|
|
|
|
ircmsgs.py: The IrcMsg class (get to know it :)) and various functions for
|
|
|
|
|
making the creation of IrcMsgs easier.
|
|
|
|
|
|
|
|
|
|
ircutils.py: Various utility functions for Irc -- read the module to see what
|
|
|
|
|
goodies are there :)
|
|
|
|
|
|
|
|
|
|
schedule.py: A schedule driver (which is automatically registered with the
|
|
|
|
|
drivers module) to run things at a particular time, or at
|
|
|
|
|
specified periods of time.
|
