Skip to content

Latest commit

 

History

History
78 lines (55 loc) · 3.44 KB

README.textile

File metadata and controls

78 lines (55 loc) · 3.44 KB

JIBOT: A Ruby IRC Bot For #joiito

Version 2.0 (Today, 2008)

Authors James Cox ([email protected])…
Copyright Copyright © 2008 + The #joiito IRC Channel + James Cox
License Distributed under the same terms as Ruby. The system heavily relies on Autumn, an irc framework: http://github.com/riscfuture.
Portions of this code are copyright ©2004 David Heinemeier Hansson; please see libs/inheritable_attributes.rb for more information.

About Autumn

Autumn is a full-featured framework on top of which IRC bots (called “leaves”)
can be quickly and easily built. It features a very Ruby-like approach to
bot-writing, a complete framework for loading and daemonizing your bots,
multiple environment contexts, a database-backed model, and painless logging
support.

Requirements

Autumn requires RubyGems and the Daemons and Facets*
gems. Install RubyGems then run sudo gem install daemons facets in a command
line in order to run Autumn.

Jibot requires the ruby-sqlite3: sudo port install rb-sqlite3 the sqlite gem:
sudo gem install -v 0.9.2 do_sqlite3 and the Datamapper
gem: sudo gem install -v 0.9.2 install dm-core dm-ar-finders .

One person’s install notes on OS/X Leopard:

On a fairly stock leopard system it was also necessary to add a few steps… this which in which ssh-keygen creates the .ssl folder and public key to provide the github website.

Then to make logging in easier by adding the login to the keychain:
$ /usr/bin/ssh-add -K

To install git follow

Or just use the precompiled one from

Configured git:
Macintosh:~ myhomedir$ git config —global user.name ‘Firstname Lastname’
Macintosh:~ myhomedir$ git config —global user.email ‘[email protected]

Created a spot and got a clone:
Macintosh:~ myhomedir$ cd src
Macintosh:src myhomedir$ git clone git://github.com/imajes/jibot.git

RubyGems was already installed on Leopard so I ran the sudo gem install daemons facets above.
Before I could run the sudo port install rb-sqlite3 however it was necessary to install macports

Then continue by running Macintosh:~ myhomedir$ sudo /opt/local/bin/port install rb-sqlite3
and it took awhile to come back… updated a lot of packages.

Extlib was missing so this was necessary: Macintosh:~ myhomedir$ sudo gem install -v 0.9.2 extlib
Successfully installed extlib-0.9.2
1 gem installed

Then following the advice in README.autumn – had to modify jibot/config/global.yml to point to testing season instead of production.

Modify jibot/config/seasons/testing/stems.yml to point to a different nick and channel to avoid stepping on the other jibots.

Had to manually create a log file in the jibot directory before rake would work.

Macintosh:jibot myhomedir$ mkdir log
Macintosh:jibot myhomedir$ rake db:migrate
(in /Users/myhomedir/src/jibot)
rake aborted!
Usage: DB=[Database config name] rake db:migrate
/Users/myhomedir/src/jibot/rakefile:82
(See full trace by running task with —trace)
Macintosh:jibot myhomedir$ script/server
Loading Autumn 3.0 (7-4-08)
Freenode (Stem): Connecting to chat.freenode.net:6667…

Hacking JIBOT

You should peruse README.autumn first, to get a feel for how it’s structured.
Then, feel free to hack on a leaf (or create your own) to add or augment bot
functionality.