SvnBot

   A commit notification bot

   SvnBot is intended to be a small, simple, IRC bot that sends out a
   message when a commit is made to a repository.

   Other projects exist that cover similar functionality:

     * The CIA Open Source Notification System[1] tracks project
       activities and presents some statistics about projects. It has
       the ability to provide notification via an IRC bot.

     * whippingboy[2] is an IRC bot (thought to be a Supybot[3] with an
       RSS plugin) that polls the timeline for projects using Trac,
       notifying on any new changes, including commits to the
       repository.

   The main reasons for creating yet another bot were for its
   simplicity, and as a personal programming exercise.


Requirements

   SvnBot is written in Python, and uses the Twisted API:

     * Python (>=2.2), from http://python.org/
     * Twisted 1.3, from http://twistedmatrix.com/
       (untested in Twisted 2)


Downloading

   There is no convenient package to download yet. Instead, make sure
   you have Subversion[4] installed and grab the latest development
   version from the repository:

 svn checkout \
     http://svn.sward.vm.bytemark.co.uk/repos/misc/svnbot/trunk svnbot


Configuration and Usage

   There are no configuration files yet. Just edit svnbot.py to change
   the IRC server and channel, and run with:

 twistd -oy svnbot.py


License

   Svnbot is free software; you can redistribute it and/or modify it
   under the terms of version 2 of the GNU General Public License[5] as
   published by the Free Software Foundation.[6]

   Svnbot is distributed in the hope that it will be useful, but WITHOUT
   ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
   FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public
   License[5] for more details.

   You should have received a copy of the GNU General Public License[5]
   along with Svnbot; if not, write to the Free Software Foundation,
   Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA


References

   1. http://cia.navi.cx/
   2. http://whippingboy.homeunix.org/
   3. http://supybot.com/
   4. http://subversion.tigris.org/
   5. http://www.fsf.org/licensing/licenses/gpl.html
   6. http://www.fsf.org/