adhearsion-asterisk 1.1.1 → 1.2.0

data/CHANGELOG.md

@@ -1,3 +1,8 @@
+# develop
+
+# v1.2.0
+  * Feature: Added helper to execute AMI actions easily
+
 # v1.1.1
   * Fix error in header name for #agi_context
 

data/README.md

@@ -52,45 +52,59 @@ Examples
 
 
 ```ruby
-vm {
-  voicemail "8000"
-}
-
-echotest {
-  play 'demo-echotest'
-  execute 'Echo'
-  play 'demo-echodone'
-}
-
-saytime {
-  t = Time.now
-  date = t.to_date
-  date_format = 'ABdY'
-  execute "SayUnixTime", t.to_i, date_format
-  play_time date, :format => date_format
-}
-
-callqueue {
-  case extension
-  when 5001
-    queue 'sales'
-  when 5002
-    queue 'support'
+class Voicemail < Adhearsion::CallController
+  def run
+    voicemail "8000"
   end
-}
+end
+
+class EchoTest < Adhearsion::CallController
+  def run
+    play 'demo-echotest'
+    execute 'Echo'
+    play 'demo-echodone'
+  end
+end
+
+class SayTime < Adhearsion::CallController
+  def run
+    t = Time.now
+    date = t.to_date
+    date_format = 'ABdY'
+    execute "SayUnixTime", t.to_i, date_format
+    play_time date, :format => date_format
+  end
+end
+
+class CallQueue < Adhearsion::CallController
+  def run
+    case variables[:x_agi_extension]
+    when 5001
+      queue 'sales'
+    when 5002
+      queue 'support'
+    end
+  end
+end
 
-salesagent {
-  queue('sales').join!
-}
+class SalesAgent < Adhearsion::CallController
+  def run
+    queue('sales').join!
+  end
+end
 
-supportagent {
-  queue('support').join!
-}
+class SupportAgent < Adhearsion::CallController
+  def run
+    queue('support').join!
+  end
+end
 
-operator {
-  enable_feature :blind_transfer
-  dial extension, :options => "Tt"
-}
+class Operator < Adhearsion::CallController
+  def run
+    enable_feature :blind_transfer
+    dial extension, :options => "Tt"
+  end
+end
 
 
 ```

data/lib/adhearsion/asterisk.rb

@@ -10,5 +10,26 @@ module Adhearsion
     extend ActiveSupport::Autoload
 
     autoload :QueueProxy
+
+    #
+    # Execute an AMI action synchronously
+    #
+    # @param [String] name the name of the action to execute
+    # @param [Hash<String => Object>] options options to pass to the action
+    #
+    # @yield [Punchblock::Event::Asterisk::AMI::Event] block to handle each event resulting from the action
+    #
+    # @return [Punchblock::Event::Complete] action complete event
+    #
+    # @example Execute a CoreShowChannels action, handling each channel event:
+    #
+    #   Adhearsion::Asterisk.execute_ami_action('CoreShowChannels') { |channel| puts channel.inspect }
+    #
+    def self.execute_ami_action(name, options = {}, &block)
+      component = Punchblock::Component::Asterisk::AMI::Action.new :name => name, :params => options
+      component.register_event_handler(Punchblock::Event::Asterisk::AMI::Event, &block) if block
+      Adhearsion::PunchblockPlugin.execute_component component
+      component.complete_event
+    end
   end
 end

data/lib/adhearsion/asterisk/version.rb

@@ -1,5 +1,5 @@
 module Adhearsion
   module Asterisk
-    VERSION = "1.1.1"
+    VERSION = "1.2.0"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: adhearsion-asterisk
 version: !ruby/object:Gem::Version
-  version: 1.1.1
+  version: 1.2.0
   prerelease: 
 platform: ruby
 authors:
@@ -10,7 +10,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-04-22 00:00:00.000000000 Z
+date: 2012-04-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: adhearsion
@@ -280,7 +280,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -599135187931532102
+      hash: -1875001914852062926
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
@@ -289,10 +289,10 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -599135187931532102
+      hash: -1875001914852062926
 requirements: []
 rubyforge_project: adhearsion-asterisk
-rubygems_version: 1.8.23
+rubygems_version: 1.8.21
 signing_key: 
 specification_version: 3
 summary: Asterisk specific features for Adhearsion
@@ -310,4 +310,3 @@ test_files:
 - spec/has_agi_context.rb
 - spec/spec_helper.rb
 - spec/support/the_following_code.rb
-has_rdoc: