Go to file
Jeremy Fincher 5e39dbafa7 Added inkedmn's weather command. 2003-03-13 07:12:47 +00:00
docs Initial revision 2003-03-12 06:26:59 +00:00
examples Initial revision 2003-03-12 06:26:59 +00:00
others Initial revision 2003-03-12 06:26:59 +00:00
plugins Added inkedmn's weather command. 2003-03-13 07:12:47 +00:00
sandbox Initial revision 2003-03-12 06:26:59 +00:00
scripts Initial revision 2003-03-12 06:26:59 +00:00
src Initial revision 2003-03-12 06:26:59 +00:00
tools Initial revision 2003-03-12 06:26:59 +00:00
.cvsignore Initial revision 2003-03-12 06:26:59 +00:00
ACKS Initial revision 2003-03-12 06:26:59 +00:00
BUGS Initial revision 2003-03-12 06:26:59 +00:00
CHANGELOG Initial revision 2003-03-12 06:26:59 +00:00
LICENSE Initial revision 2003-03-12 06:26:59 +00:00
README Initial revision 2003-03-12 06:26:59 +00:00
TODO Initial revision 2003-03-12 06:26:59 +00:00

README

EVERYONE:
---------
Read LICENSE.  It's a 2-clause BSD license, but you should read it anyway.


PROGRAMMERS:
------------
Read OVERVIEW to see what the modules are used for.  Read EXAMPLE to see some
examples of callbacks and command written for the bot.  Read STYLE if you ever
wish to contribute.

All contributions need to assign the copyright to Jeremiah Fincher for
licensing and modification purposes.  I'll probably change the modules to fit
STYLE if they don't already fit.  (Of course, that doesn't mean 'all
modifications'; only if you want your code to be included in the *standard
distribution* of Supybot do you need to assign to me the copyright.  If you
don't mind distributing your modifications or additions elsewhere, by all means
keep the copyright.)

Use PyChecker.  Believe me, it makes things better.


USERS:
------
Read conf.py to see what kind of configuration options you have available.  In
order to actually connect to a server on the internet, you'll want to modify
the "drivers" option, changing the server "localhost" to the appropriate value.
You'll probably also want to change the channels that are joined by modifying
the configuration for the "callbacks.ChannelJoiner" callback.  This should all
be done in a separate file, as per the example in sample.conf.

To run the bot, do it from this directory, like this:

src/bot.py

If you have your own configuration file (the bot will still use conf.py as its
set of defaults, but will override it with whatever it finds in your file) use:

src/bot.py -c yourconfig.py

I've included slightly patched versions of asyncore and asynchat so they don't
make PyChecker complain, and use some newer features (mostly {}.iter*) of 2.2.