Jabber::Bot

Jabber::Bot makes it simple to create and command your own Jabber bot with little fuss. By adding custom commands powered by regular expressions to your bot's repertoire, you and your new bot will be able to accomplish nearly anything.

Requirements

Installation

The latest version of Jabber::Bot is available via RubyGems:

gem install jabber-bot

Or, you can download it:

Links

Basic Usage

#!/usr/bin/env ruby
require 'rubygems'
require 'jabber/bot'

# Create a public Jabber::Bot
bot = Jabber::Bot.new(
  :jabber_id => 'bot@example.com', 
  :password  => 'password', 
  :master    => 'master@example.com',
  :is_public => true
)

# Give your bot a public command
bot.add_command(
  :syntax      => 'rand',
  :description => 'Produce a random number from 0 to 10',
  :regex       => /^rand$/,
  :is_public   => true
) { rand(10).to_s }

# Give your bot a private command with an alias
bot.add_command(
  :syntax      => 'puts <string>',
  :description => 'Write something to $stdout',
  :regex       => /^puts\s+.+$/,
  :alias       => [ 
      :syntax => 'p <string>', 
      :regex => /^p\s+.+$/
  ]
) do |sender, message|
  puts message
  "'#{message}' written to $stdout"
end

# Bring your new bot to life
bot.connect

Copyright

Copyright © 2007 Brett Stimmerman. All Rights Reserved.
Jabber::Bot is released under the terms of the BSD License