rastman 0.1.4 → 0.1.5

data/CHANGELOG

@@ -0,0 +1,15 @@
+*0.1.5* (February 8th, 2008)
+
+* fix the return value of ping! so it returns true in case of success [Franz Schwartau]
+
+* add the getvar and getvar! commands [Franz Schwartau]
+
+* allow to pass multiple variables to originate using a Hash [Franz Schwartau]
+  i.e.: rastman.originate([...], :variable => {"var1" => "val1", "var2" => "val2"})
+
+
+*0.1.4* (June 28th, 2007)
+
+* make it work for Asterisk 1.0.x
+
+* fix a problem when the event content contains multi-lines

data/README

@@ -5,27 +5,28 @@
 # and listens to events published by the server. The instance can also
 # be used to send Manager API requests to the server.
 #
-# == 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")
+# == Download
 #
-# rastman.ping
+# You can download Rastman from the Rubyforge project page: http://rubyforge.org/projects/rastman
 #
-# rastman.originate :channel => "SIP/myphone@mydomain.com",
-#										:context => "default", :exten => "voicemail",
-#									  :priority => 1
-#
-# rastman.logoff
-#
-#
-#  Created by Mathieul on 2007-02-08.
-#  Copyright (c) 2007. All rights reserved.
+# == 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
+#     
+#     rastman.logoff
+#

data/lib/rastman.rb

@@ -87,7 +87,7 @@ module Rastman
 
     COMMANDS = [:login, :logoff, :events, :originate, :originate!, :redirect,
       :redirect!, :hangup, :hangup!, :ping, :ping!, :setvar, :setvar!,
-      :command, :command!]
+      :command, :command!, :getvar, :getvar!]
     WAIT_FOR_ANSWER = 0.1
 
     # Returns a Rastman::Manager object. The login and pwd parameters
@@ -140,6 +140,11 @@ module Rastman
       @conn.close
       $rnlog.debug("Rastman::Manager#disconnect: closed connection")
     end
+    
+    # Returns the connection object.
+    def connection
+      @conn
+    end
 
     # Adds (or replaces) a block to be executed when the specified event occurs:
     # * <tt>:event</tt>:      an event was received
@@ -226,8 +231,14 @@ module Rastman
       end
       @conn_lock.synchronize do
         action.each do |key, value|
-          $rnlog.debug("Rastman::Manager#send_action: write (#{key.to_s}: #{value}\\r\\n)")
-          @conn.write("#{key.to_s}: #{value}\r\n")
+          name = key.to_s
+          $rnlog.debug("Rastman::Manager#send_action: write (#{name}: #{value}\\r\\n)")
+          case value
+          when Hash
+            value.each { |k, v| @conn.write("#{name}: #{k.to_s}=#{v}\r\n") }
+          else
+            @conn.write("#{name}: #{value}\r\n")
+          end
         end
         $rnlog.debug("Rastman::Manager#send_action: write (\\r\\n)")
         @conn.write("\r\n")
@@ -242,11 +253,15 @@ module Rastman
             answer << {}
           end
         end
-        result = answer.first[:response] == "Success" ? true : false rescue false
+        success = case action[:action]
+        when "ping" then "Pong"
+        else "Success"
+        end
+        result = answer.first[:response] == success rescue false
       end
       return result
     rescue Exception => ex
-      $rnlog.info("Rastman::Manager#send_action: exception caught (connection probably closed already): #{ex}")
+      $rnlog.warn("Rastman::Manager#send_action: exception caught (connection probably closed already): #{ex}")
     end
 
     def method_missing(meth, *args, &block) # :nodoc:

metadata

@@ -1,41 +1,36 @@
 --- !ruby/object:Gem::Specification 
-rubygems_version: 0.9.2
-specification_version: 1
 name: rastman
 version: !ruby/object:Gem::Version 
-  version: 0.1.4
-date: 2007-06-28 00:00:00 -07:00
-summary: Asterisk Manager API interface for Ruby
-require_paths: 
-- lib
-email: mathieul@zlaj.org
-homepage: http://rastman.rubyforge.org/
-rubyforge_project: 
-description: Asterisk Manager API interface for Ruby
-autorequire: 
-default_executable: 
-bindir: bin
-has_rdoc: true
-required_ruby_version: !ruby/object:Gem::Version::Requirement 
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      version: 1.8.4
-  version: 
+  version: 0.1.5
 platform: ruby
-signing_key: 
-cert_chain: 
-post_install_message: 
 authors: 
 - Mathieu Lajugie
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-02-08 00:00:00 -08:00
+default_executable: 
+dependencies: []
+
+description: Asterisk Manager API interface for Ruby
+email: mathieul@zlaj.org
+executables: 
+- rastman_mkcalls.rb
+extensions: []
+
+extra_rdoc_files: 
+- README
 files: 
 - MIT-LICENSE
 - README
 - TODO
+- CHANGELOG
 - bin/rastman_mkcalls.rb
 - lib/rastman.rb
-test_files: []
-
+has_rdoc: true
+homepage: http://rastman.rubyforge.org/
+post_install_message: 
 rdoc_options: 
 - --quiet
 - --title
@@ -46,13 +41,26 @@ rdoc_options:
 - --main
 - README
 - --inline-source
-extra_rdoc_files: 
-- README
-executables: 
-- rastman_mkcalls.rb
-extensions: []
-
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: 1.8.4
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
 requirements: []
 
-dependencies: []
+rubyforge_project: 
+rubygems_version: 1.0.1
+signing_key: 
+specification_version: 2
+summary: Asterisk Manager API interface for Ruby
+test_files: []