= Rastman is a Ruby interface for the Asterisk Manager API

When creating a new Rastman::Manager instance, it connects to an Asterisk server

on the manager port (<tt>5038</tt> by default), sends a login request

and listens to events published by the server. The instance can also

be used to send Manager API requests to the server.

All the Asterisk Manager API commands are accessible. They can be used in two

different ways:

- name of the command in lowercase: the command is sent but Rastman doesn't wait

for the answer (asynchronous).

i.e.: rastman.setvar :variable => "my_time", :value => "12"

- name of the command in lowercase with a bang: the command is sent and Rastman

waits for the answer (synchronous). If the answer contains a value (for Getvar)

then it is returned, else true is returned.

i.e.: value = rastman.getvar! 1, :variable => "extension"

== Source

You can access the source repository using Git version control system

(http://git.or.cz). The Git repository for rastman is hosted at GitHub:

git://github.com/mathieul/rastman.git

== Download

You can download Rastman from the Rubyforge project page: http://rubyforge.org/projects/rastman

== Example

require "rubygems"

require "rastman"

rastman = Rastman::Manager.new("myuser", "secret")

rastman.add_event_hook(:event) { |evt| puts "Event received: [#{evt.inspect}]"

rastman.connect

rastman.events(:eventmask => "user,call")

rastman.ping!

rastman.originate :channel => "SIP/myphone@mydomain.com",

:context => "default", :exten => "voicemail",

:priority => 1

response_timeout = 1

value = rastman.getvar! response_timeout, :channel => "SIP/5060-44d225d0",

:variable => "extension"

rastman.logoff