Ruben

Description

Ruben is an IRC chat bot written in Ruby. He is inspired, in part, by Hubot, his CoffeeScript brother from another mother.

Dependencies

Ruby 1.9.3+
Rake 10.0.4 (for running tests, if that's your jam)
RSpec 2.13.0 (see above)

Installation

Version 1.1.0 is available from RubyGems; you can get your version of Ruben by typing

$ gem install ruben

Getting Started

Ruben comes with a bin/ruben executable, so you can run him with

$ ruben <server> <port> <channel> <nick>

Ruben takes a server name, port number, channel name, and nick as command line arguments. For example, if you type:

$ ruben irc.freenode.net 6667 test_chan ruben_

You should see:

$ >> USER ruben 0 * :Ruben
$ >> NICK ruben_
$ >> JOIN #test_chan

...

You can get Ruben's usage information by typing ruben -h or ruben --help.

Adding Scripts

You can extend Ruben's functionality by adding scripts to /scripts. Each script should be a .rb file that instantiates a new Listener object, like so:

thing_to_do lambda do
  # Arcane magicks go here
end

Listener.new(/Regexp/, thing_to_do)

Ruben's listeners hear every incoming IRC message. If a listener's Regexp matches the inbound message, Ruben will call the associated lambda.

ericqweinstein / ruben