Contents

h1. gtalk-bot

A very easy tool for creating Google Talk bots

h2. It's really easy!

h3. Installation

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

h3. Usage

h4. Getting online

<pre>require 'gtalk-bot'

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

h4. On invitation

<pre>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
</pre>

h4. On message

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

  # do something useful

  bot.message from, "I heard that!"
end</pre>

h4. Going infinite

<pre># 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 © 2011 Brian Scott, released under the MIT license

Version data entries

2 entries across 2 versions & 1 rubygems

Version	Path
gtalk-bot-1.0.1	README.textile
gtalk-bot-1.0.0	README.textile