Contents

h1. easy-gtalk-bot

A very easy tool for creating Google Talk bots

h2. It's really easy!

h3. Installation

<code>sudo gem install easy-gtalk-bot</code>

h3. Usage

<pre>
require 'easy-gtalk-bot'

bot = GTalk::Bot.new(:email => "[e-mail]", :password => 'sekrit')
bot.get_online

bot.on_invitation do |inviter|
  puts "I have been invited by #{inviter}. Yay!"

  # do something useful

  bot.accept_invitation(inviter)
  bot.message(inviter, "Hello there! Thanks for invitation!")
end

bot.on_message do |from, text|
  puts "I got message from #{from}: '#{text}'"

  # do something useful

  bot.message from, "I heard that!"
end

# Don't be confused with the name of this method. 
# We actually keep the current (main) thread alive while letting listener thread to do its job.
# So we have no need to set up an any infinite loop.
Thread.stop</pre>

h2. To-do

<code>bot.get_online :invisible => true </code>

<code>bot.set_status :away</code>

<code>GTalk::Account('[e-mail]').available?</code>

<code>bot.contact_list # => Array</code>

<code>bot.in_contact_list?('[e-mail]')</code>


Copyright © 2010 Daniel Vartanov, released under the MIT license

Version data entries

2 entries across 2 versions & 1 rubygems

Version	Path
easy-gtalk-bot-1.0.2	README.textile
easy-gtalk-bot-1.0.1	README.textile