Jabber::Bot
Jabber::Bot makes it simple to create and command your own Jabber bot with little fuss. Bots are created by defining custom commands powered by regular expressions.
Requirements
- Ruby 1.8.4+
- Jabber::Simple 0.8.7+
Installation
The latest version of Jabber::Bot is available via RubyGems:
gem install jabber-bot
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
Articles