asterisk-ajam 0.0.1

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    ZTg2MWYzN2QwNzg3ZjViMmMxYzFlNGNjZmM1Y2JmZTY4ZGI2MGEyNw==
+  data.tar.gz: !binary |-
+    ZTVmY2E0OTdlNzVhNDBmNDFjZjkwMmQ4NTRkN2U5NDBjZGMxOGU0ZQ==
+!binary "U0hBNTEy":
+  metadata.gz: !binary |-
+    MDViOGI3OTU3NTVkMTE5ZjY0NDcxMzc3N2FiYTA0NjZkMWI0ZTZmZGQwYjBk
+    ZWJhYTQzMzc5MmRiMzkwOWYxMWYzOGFiZjE4MDc1MmUwMjYxYzcwYWI3ZDg4
+    YjcwNjU5NzQzZWVlYTIyNmZiZDdiMGFjZmI5NTM2NDcyZGZkZjE=
+  data.tar.gz: !binary |-
+    ZDJiMmZiNTkxMWVlZDdhZjUxODM1NzRmOGI0OThmOGJjNzFkZGUzY2QzZjE0
+    NjlmNDY2NzQ3Y2UzMGM3MjJjZDMyNDI1NDYwYTcxZTg0MTc1MmU1NzIwNTc3
+    MjlhZjcxNDM5OTY5MjA0OTk2NzE1NGRlNDc1ODA2NDU2M2ZkNGM=

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/.travis.yml

@@ -0,0 +1,3 @@
+language: ruby
+rvm:
+  - 1.9.3

data/Gemfile

@@ -0,0 +1,6 @@
+source 'https://rubygems.org'
+
+gem 'simplecov', :require => false, :group => :test
+gem 'coveralls', :require => false
+# Specify your gem's dependencies in asterisk-ajam.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Stas Kobzar
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,128 @@
+# Asterisk::AJAM
+[![Build Status](https://travis-ci.org/staskobzar/asterisk-ajam.png?branch=master)](https://travis-ci.org/staskobzar/asterisk-ajam)
+[![Coverage Status](https://coveralls.io/repos/staskobzar/asterisk-ajam/badge.png?branch=master)](https://coveralls.io/r/staskobzar/asterisk-ajam?branch=master)
+
+* * * 
+This is a very simple library that allows to comunicate with [Asterisk PBX](http://www.asterisk.org/) using [Asterisk Management Interface (AMI) actions](https://wiki.asterisk.org/wiki/display/AST/Asterisk+11+AMI+Actions). 
+Library communicates with AMI through HTTP(s) protocol. HTTP interface is provided by Asterisk PBX and called [AJAM](https://wiki.asterisk.org/wiki/pages/viewpage.action?pageId=4817256)
+
+This library does not provide events interface to AMI. It only sends actions/commands and read responses back. If you need real AMI interface please, check [Adhearsion framework](http://adhearsion.com/) which is very powerful and provides a lot of functionality.
+
+This library can use HTTTP Authentication username/password for AJAM servers behind proxy protected with basic access authentication scheme and HTTPS (SSL).
+
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'asterisk-ajam'
+
+And then execute:
+
+    $ bundle install
+
+Or install it yourself as:
+
+    $ gem install asterisk-ajam
+
+## Usage
+
+You can check file [example/ajam.rb](https://github.com/staskobzar/asterisk-ajam/blob/master/example/ajam.rb) for some examples (comes with source).
+
+Simple example:
+```ruby
+require 'asterisk/ajam'
+ajam = Asterisk::AJAM.connect :uri => 'http://127.0.0.1:8088/mxml',
+                              :ami_user => 'admin',
+                              :ami_password => 'passw0rd'
+if ajam.connected?
+	ajam.command 'dialplan reload'
+    res = ajam.action_sippeers
+    res.list.each {|peer| puts peer['objectname']}
+end
+```
+
+List of argument options for ```Asterisk::AJAM.connect```:
+
+* ```:uri``` URI of AJAM server. See [Asterisk documentation](https://wiki.asterisk.org/wiki/pages/viewpage.action?pageId=4817256)  which explains how to configure AJAM server.
+* ```:ami_user```  AMI user username
+* ```:ami_password``` AMI user password
+* ```:proxy_user``` proxy username for HTTP Authentication
+* ```:proxy_pass``` proxy password for HTTP Authentication
+
+If URI scheme is "https" then library enables SSL use. Please, note that current version does not enable verify mode of Net::HTTPS ruby library so it will accept any SSL certiificates without verifications.
+
+```Asterisk::AJAM.connect``` returns ```Asterisk::AJAM::Session``` class which provides several useful methods:
+
+```connected?``` returns true if successfully logged in AMI
+
+```command``` send command to AMI and read response. Example:
+```ruby
+ajam.command "dialplan reload"
+ajam.command "core restart when convenient"
+```
+
+```action_NAME``` sends action to AMI. NAME must be replaced with AMI action name (see: [Asterisk documentation](https://wiki.asterisk.org/wiki/display/AST/Asterisk+11+AMI+Actions)). Accepts hash as an argument. Example:
+```ruby
+ajam.action_agents # no arguments
+ajam.action_mailboxcount mailbox: "5555@default"
+ajam.action_originate :channel => 'Local/local-chan@from-pstn',
+    				  :application => 'MusicOnHold',
+    				  :callerid => 'John Doe <5555555>'
+```
+
+Actions and Commands return ```Asterisk::AJAM::Response``` class with several methods where response data can be found:
+
+* list
+* attribute
+* data
+
+```ruby
+res = ajam.action_meetmelist
+pp res.list
+pp res.attribute
+pp res.data
+```
+
+## Using Apache proxy tutorial
+As an additional security measure Apache proxy with HTTP Authentication can be used. Here is an example of Apache Virtual Host configuration as Proxy to AJAM server
+
+```
+Listen 8888
+NameVirtualHost *:8888
+<VirtualHost *:8888>
+  <Proxy *>
+    Order deny,allow
+    Allow from all
+    AuthName "AJAM"
+    AuthType Basic
+    AuthUserFile /etc/httpd/.htpasswd
+    require valid-user
+  </Proxy>
+  ProxyPass / http://ajamhost.com:8088/
+  ProxyPassReverse / http://ajamhost.com:8088/
+</VirtualHost>
+```
+
+Generate password file:
+```
+htpasswd -b -c /etc/httpd/.htpasswd admin passw0rd
+```
+
+Connect to proxy:
+```ruby
+ajam = Asterisk::AJAM.connect :uri => 'http://ajamproxy.com:8888/mxml',
+                              :ami_user => 'admin',
+                              :ami_password => 'amp111',
+                              :proxy_user => 'admin',
+                              :proxy_pass => 'passw0rd'
+```
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request
+

data/Rakefile

@@ -0,0 +1,26 @@
+require "bundler/gem_tasks"
+require 'rspec/core/rake_task'
+require 'rdoc/task'
+
+RSpec::Core::RakeTask.new(:spec) do |t|
+  t.rspec_opts = "--color"
+end
+
+RSpec::Core::RakeTask.new(:spec_doc) do |t|
+  t.rspec_opts = "--color --format doc"
+end
+
+RSpec::Core::RakeTask.new(:spec_html) do |t|
+  t.rspec_opts = "--format html -o spec/reports/index.html"
+end
+
+Rake::RDocTask.new do |rd|
+  rd.main = "README.md"
+  rd.rdoc_files.include("README.md","lib/**/*.rb")
+  rd.title = 'Asterisk::AJAM: Ruby module for interacting with Asterisk management interface (AMI) via HTTP'
+  rd.rdoc_dir = "doc"
+  rd.options << '--line-numbers'
+  rd.options << '--all'
+end
+
+task :default => :spec

data/asterisk-ajam.gemspec

@@ -0,0 +1,26 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'asterisk/ajam/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "asterisk-ajam"
+  spec.version       = Asterisk::AJAM::VERSION
+  spec.authors       = ["Stas Kobzar"]
+  spec.email         = ["stas@modulis.ca"]
+  spec.description   = %q{Ruby module for interacting with Asterisk management interface (AMI) via HTTP}
+  spec.summary       = %q{AMI via HTTP}
+  spec.homepage      = "https://github.com/staskobzar/asterisk-ajam"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "rdoc"
+  spec.add_development_dependency "rspec"
+  #spec.add_development_dependency "fakeweb"
+  spec.add_runtime_dependency "libxml-ruby"
+end

data/example/ajam.rb

@@ -0,0 +1,31 @@
+#!/usr/bin/env ruby
+require 'asterisk/ajam'
+require 'pp'
+ajam = Asterisk::AJAM.connect :uri => 'http://127.0.0.1:8088/mxml',
+                              :ami_user => 'admin',
+                              :ami_password => 'amp111',
+                              :proxy_user => 'admin',
+                              :proxy_pass => 'admin'
+
+pp ajam.connected?
+# actions
+res = ajam.action_sippeers
+pp res.list
+
+ajam = Asterisk::AJAM.connect :uri => 'https://127.0.0.1:9443/mxml',
+                              :ami_user => 'admin',
+                              :ami_password => 'amp111',
+                              :use_ssl => true
+res = ajam.action_corestatus
+pp res.attribute
+pp res.list
+
+res = ajam.action_sipshowpeer peer: '5555'
+pp res.attribute
+
+# commands
+res = ajam.command 'sip show peer 5555'
+pp res.data
+
+res = ajam.command 'dialplan reload'
+pp res.data

data/lib/asterisk/ajam/response.rb

@@ -0,0 +1,113 @@
+require 'libxml'
+
+#
+# = asterisk/ajam/response.rb
+#
+module Asterisk
+  module AJAM
+    # Exception raised when HTTP response body is invalid
+    class InvalidHTTPBody < StandardError;end #:nodoc:
+
+    #
+    # Generic class to process and store responses from 
+    # Asterisk AJAM server. Stores data from HTTP response
+    # and xml document received from Asterisk server
+    #
+    class Response
+
+      # HTTP response code
+      attr_reader :code
+
+      # AJAM session id
+      attr_reader :session_id
+
+      # Response eventlist from action (for example: sip peers)
+      attr_reader :list
+
+      # Response attributes
+      attr_reader :attribute
+
+      # Creates new Response class instance. Sets instance 
+      # variables from HTTP Response (like code). Parses body.
+      def initialize(http)
+        raise ArgumentError,
+          "Expected Net::HTTP::Response. Got #{http.class}" unless http.is_a?(Net::HTTPResponse)
+        @attribute = []
+        @list = []
+        @code = http.code.to_i
+        return unless httpok?
+        parse_body http.body
+        set_session_id http
+      end
+
+      # HTTP request status
+      def httpok?
+        @code.eql? 200
+      end
+
+      # Is AJAM action/command successful
+      def success?
+        @success
+      end
+
+      # opaque_data from command response
+      def data
+        @data || @nodes
+      end
+
+      private
+        # Parses HTTP response body.
+        # Body should by xml string. Otherwise will raise
+        # exception InvalidHTTPBody
+        def parse_body xml
+          set_nodes xml
+          verify_response
+          set_eventlist
+        end
+
+        # parse xml body and set result to internal variable for farther processing
+        def set_nodes xml
+          raise InvalidHTTPBody,
+            "Empty response body" if xml.to_s.empty?
+          src = LibXML::XML::Parser.string(xml).parse
+          @nodes = src.root.find('response/generic').to_a
+        end
+
+        # 
+        # Check if AJAM response is successfull and set internal variable
+        # @success
+        def verify_response
+          node = @nodes.shift
+          @success = ['success', 'follows'].include? node[:response].to_s.downcase
+          @attribute = node.attributes.to_h
+
+          set_command_data
+        end
+
+        # extract mansession_id from cookies
+        def set_session_id(http)
+          if /mansession_id=(['"])([^\1]+)\1/ =~ http['Set-Cookie']
+            @session_id = $2
+          end
+        end
+
+        # for reponses that contain eventlist of values set it to 
+        # internal attributes
+        def set_eventlist
+          return unless @attribute['eventlist'].to_s.downcase.eql? 'start'
+          @nodes.each do |node|
+            next if node['eventlist'].eql? 'Complete'
+            @list << node.attributes.to_h
+          end
+        end
+
+        def set_command_data
+          if @attribute.has_key?('opaque_data')
+            @data = @attribute['opaque_data']
+            @attribute.delete 'opaque_data'
+          end
+        end
+
+    end
+  end
+end

data/lib/asterisk/ajam/session.rb

@@ -0,0 +1,158 @@
+require 'net/https' # this will also include net/http and uri
+#
+# = asterisk/ajam/session.rb
+#
+module Asterisk
+  module AJAM
+    #
+    # == Session class for Asterisk AJAM 
+    # Used to controll connection to Astersik AJAM via HTTP protocol
+    #
+    
+    # Session errors
+    # This class extends StandardError and raises when problem with
+    # AJAM URL found, for ex: missing scheme or hostname
+    # TODO: should be also used for HTTPS connections
+    class InvalidURI < StandardError; end #:nodoc:
+
+    # This class extends StandardError and raises when problems
+    # with loggin AJAM server found or when missing importent
+    # parameters like username or password.
+    class InvalidAMILogin < StandardError; end #:nodoc:
+
+    # Class extends StandardError and is raised when trying to
+    # send command to not AJAM server where not logged in
+    class NotLoggedIn < StandardError; end #:nodoc:
+
+    # This class establish connection to AJAM server using TCP connection
+    # and HTTP protocol. 
+    class Session
+
+      # Asterisk AJAM server URI
+      # URI class instance
+      attr_accessor :uri
+
+      # AMI user name
+      attr_accessor :ami_user
+
+      # AMI password
+      attr_accessor :ami_password
+
+      # http access user
+      attr_accessor :proxy_user
+
+      # http access password
+      attr_accessor :proxy_pass
+
+      # Create new Asterisk AJAM session without initializing 
+      # TCP network connection
+      def initialize(options={})
+        self.uri        = options[:uri]
+        @ami_user       = options[:ami_user]
+        @ami_password   = options[:ami_password]
+        @proxy_pass     = options[:proxy_pass]
+        @proxy_user     = options[:proxy_user]
+        @use_ssl        = options[:use_ssl]
+      end
+
+      # login action. Also stores session identificator for 
+      # sending many actions within same session
+      def login
+        ami_user_valid?
+        ami_pass_valid?
+        send_action :login, username: @ami_user, secret: @ami_password
+        self
+      end
+
+      # send AMI command
+      def command(command)
+        action_command command: command
+      end
+
+      # Verify if session esteblished connection and set session id
+      def connected?
+        /^[0-9a-z]{8}$/.match(@response.session_id).is_a? MatchData
+      end
+
+      private
+        # handling action_ methods
+        def method_missing(method, *args)
+          method = method.id2name
+          raise NoMethodError,
+            "Undefined method #{method}" unless /^action_\w+$/.match(method)
+          raise NotLoggedIn, "Not logged in" unless connected?
+          send_action method.sub(/^action_/,'').to_sym, *args
+        end
+
+        # send action to Asterisk AJAM server
+        def send_action(action, params={})
+          set_params Hash[action: action].merge params
+          @response = http_send_action
+        end
+
+        # Send HTTP request to AJAM server using "#uri"
+        def http_send_action
+          http = http_inst
+          req  = http_post
+          Response.new http.request req
+        end
+
+        # create new Net::HTTP instance
+        def http_inst
+          http = Net::HTTP.new(@uri.host, @uri.port)
+          if @uri.scheme.downcase.eql? 'https'
+            http.use_ssl = true
+            http.verify_mode = OpenSSL::SSL::VERIFY_NONE
+          end
+          http
+        end
+
+        # create new Net::HTTP::Post instance
+        def http_post
+          req  = Net::HTTP::Post.new @uri.request_uri, request_headers
+          req.set_form_data params
+          req.basic_auth @proxy_user, @proxy_pass if @proxy_pass && @proxy_user
+          req
+        end
+
+        # Post parameters
+        def params
+          @params
+        end
+
+        # set AJAM POST parameters
+        def set_params(params)
+          @params = params
+        end
+
+        # verifies if AMI username is set and not empty
+        def ami_user_valid?
+          raise InvalidAMILogin,
+            "Missing AMI username" if @ami_user.to_s.empty?
+        end
+
+        # verifies if AMI password (secret) is set and not empty
+        def ami_pass_valid?
+          raise InvalidAMILogin,
+            "Missing AMI user pass" if @ami_password.to_s.empty?
+        end
+
+        # setup AJAM URI
+        def uri=(uri)
+          @uri = URI.parse uri
+          raise InvalidURI,
+            "No AJAM URI given" unless @uri
+          raise InvalidURI,
+            "Unsupported uri.scheme" unless %w/http https/.include? @uri.scheme
+        end
+
+        # initialize request headers for Net::HTTPRequest class
+        def request_headers
+          return nil unless @response
+          Hash[
+            'Cookie' => %Q!mansession_id="#{@response.session_id}"!
+          ]
+        end
+    end
+  end
+end

data/lib/asterisk/ajam/version.rb

@@ -0,0 +1,5 @@
+module Asterisk
+  module AJAM
+    VERSION = "0.0.1"
+  end
+end

data/lib/asterisk/ajam.rb

@@ -0,0 +1,12 @@
+require 'asterisk/ajam/version'
+require 'asterisk/ajam/session'
+require 'asterisk/ajam/response'
+
+module Asterisk
+
+  module AJAM
+    def self.connect(options)
+      Session.new(options).login
+    end
+  end
+end

data/spec/asterisk/ajam/response_spec.rb

@@ -0,0 +1,103 @@
+require 'spec_helper'
+
+module Asterisk
+  module AJAM
+    describe Response do
+      # stub successful login
+      let(:res_login_ok) do
+        http = get_simple_httpok
+        http.stub(:body => get_body_success_login)
+        http
+      end
+      # stub failed login
+      let(:res_login_fail) do
+        http = get_simple_httpok
+        http.stub(:body => get_body_failed_login)
+        http
+      end
+
+      #new
+      describe "#new" do
+        it "raises error if parameter is not Net::HTTPResponse instance" do
+          expect{
+            Response.new nil
+          }.to raise_error(ArgumentError)
+        end
+
+        it "raises error if empty response body" do
+          http = get_simple_httpok
+          http.stub(:body => '')
+          expect{
+            Response.new http
+          }.to raise_error(InvalidHTTPBody)
+        end
+
+        it "raises error if invalid xml response body" do
+          http = get_simple_httpok
+          http.stub(:body => '<a>this is not xml')
+          expect{
+            Response.new http
+          }.to raise_error(LibXML::XML::Error)
+        end
+
+        it "set session id" do
+          sid = "df901b5f"
+          res = res_login_ok
+          res.stub(:[]).with('Set-Cookie').and_return(%Q[mansession_id="#{sid}"; Version=1; Max-Age=60])
+          response = Response.new res
+          response.session_id.should eql(sid)
+        end
+      end
+
+      #httpok?
+      describe "#httpok?" do
+        it "returns true if successfully received response from AJAM" do
+          res = Response.new res_login_ok
+          res.should be_httpok
+        end
+        it "returns false if response from AJAM anything but 200 OK" do
+          res = Response.new get_http_unauth
+          res.should_not be_httpok
+        end
+      end
+
+      #success?
+      describe "#success?" do
+        it "returns true if AJAM response is successful" do
+          res = Response.new res_login_ok
+          res.should be_success
+        end
+        it "returns false if AJAM response id error" do
+          res = Response.new res_login_fail
+          res.should_not be_success
+        end
+      end
+
+      describe "actions" do
+        it "set recieved response list to class attributes" do
+          http = get_simple_httpok
+          http.stub(:body => get_body_sippeers)
+          res = Response.new http
+          res.list.first.should include('event' => 'PeerEntry', 'objectname' => '5555')
+          res.list.last.should include('objectname' => '8903')
+        end
+
+        it "when response has single result then it stored in :response" do
+          http = get_simple_httpok
+          http.stub(:body => get_body_corestatus)
+          res = Response.new http
+          res.attribute['corestartuptime'].should eql('17:13:00')
+        end
+      end
+
+      describe "#command" do
+        it "set data variable with response from AJAM" do
+          http = get_simple_httpok
+          http.stub(:body => cmd_body_dialplan_reload)
+          res = Response.new http
+          res.data.should match(/Dialplan reloaded/)
+        end
+      end
+    end
+  end
+end

data/spec/asterisk/ajam/session_spec.rb

@@ -0,0 +1,109 @@
+require 'spec_helper'
+
+module Asterisk
+  module AJAM
+    describe Session do
+      let(:uri_http){'http://ajam.asterisk.com:8088/mxml'}
+      let(:manses_id){"84d22b60"}
+      let(:http) do
+        http = get_simple_httpok
+        http.stub(:body => get_body_success_login)
+        http.stub(:[]).with('Set-Cookie').and_return(%Q|mansession_id="#{manses_id}"; Version=1; Max-Age=60|)
+        http
+      end
+      subject{Session.new uri: uri_http, ami_user: 'admin', ami_password: 'passw0rd'}
+      before(:each, :logginok => true) do
+        Net::HTTP.stub(:new).and_return(double('Net::HTTP', :request => http, :use_ssl= => true))
+      end
+
+      describe "#new" do
+        it "set AJAM uri" do
+          URI.stub(:parse => URI(uri_http))
+          URI.should_receive(:parse).with(uri_http)
+          Session.new uri: uri_http
+        end
+
+        it "raises error if URI missing " do
+          expect{
+            Session.new
+          }.to raise_error(URI::InvalidURIError)
+        end
+
+        it "raises error if scheme is not http or https" do
+          uri = "ftp://127.0.0.1/path"
+          expect{
+            Session.new uri: uri
+          }.to raise_error(InvalidURI)
+        end
+      end
+
+      describe "#login", :logginok => true do
+        it "raises InvalidAMILogin if empty AMI username" do
+          subject.ami_user = nil
+          expect{
+            subject.login
+          }.to raise_error(InvalidAMILogin)
+        end
+
+        it "raises InvalidAMILogin if empty AMI password" do
+          subject.ami_password = nil
+          expect{
+            subject.login
+          }.to raise_error(InvalidAMILogin)
+        end
+
+        it "should return Session class instance on success" , :mock_login => true do
+          response = subject.login
+          response.should be_kind_of Session
+        end
+
+      end
+
+      describe "#connected?", :logginok => true do
+        it "returns true when successfuly logged in", :mock_login => true do
+          subject.login
+          subject.should be_connected
+        end
+      end
+
+      describe "action methods" do
+        before(:each) {subject.stub(:connected?).and_return(true)}
+        it "when call action without parameters then expects send_action with action name" do
+          subject.should_receive(:send_action).once.with(:sippeers)
+          subject.action_sippeers
+        end
+
+        it "when call action with parameters then expects send_action with hash" do
+          params = Hash[family: 'user', key: 'extension', val: '5555']
+          subject.should_receive(:send_action).with(:dbput, params)
+          subject.action_dbput params
+        end
+
+        it "uses cookies when sending action", :logginok => true do
+          subject.login
+          Net::HTTP::Post.should_receive(:new).
+            with(anything(),hash_including("Cookie"=>%Q!mansession_id="#{manses_id}"!)).
+            and_return(double('Net::HTTPResponse', :set_form_data => true))
+          subject.action_corestatus
+        end
+      end
+
+      describe "#command" do
+        before(:each) {subject.stub(:connected?).and_return(true)}
+        it "sends command to action method" do
+          http = get_simple_httpok
+          http.stub(:body => cmd_body_sip_show_peers)
+          http.stub(:[]).and_return(%Q|mansession_id="#{manses_id}"; Version=1; Max-Age=60|)
+          http.stub(:set_form_data).with(anything())
+          http.stub(:use_ssl=)
+          http.stub(:request => http)
+          Net::HTTP.stub(:new => http)
+          Net::HTTP::Post.stub(:new).and_return(double('Net::HTTP::Post', :set_form_data => true))
+          res = subject.command 'sip show peers'
+          res.data.should match(/88888\s+\(Unspecified\)/)
+        end
+      end
+
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,83 @@
+require 'simplecov'
+require 'coveralls'
+Coveralls.wear!
+SimpleCov.formatter = SimpleCov::Formatter::MultiFormatter[
+  SimpleCov::Formatter::HTMLFormatter,
+  Coveralls::SimpleCov::Formatter
+]
+SimpleCov.start do
+  add_filter "spec/"
+end
+require 'asterisk/ajam'
+
+# this fixture create valid HTTPOK response 
+def get_simple_httpok
+  Net::HTTPOK.new 1.1, 200, 'OK'
+end
+
+def get_http_unauth
+  Net::HTTPUnauthorized.new 1.1, 401, 'Unauthorized request'
+end
+
+def get_body_success_login
+  %q{<ajax-response>
+<response type='object' id='unknown'><generic response='Success' message='Authentication accepted' /></response>
+</ajax-response>
+  }
+end
+
+def get_body_failed_login
+  %q{
+<ajax-response>
+<response type='object' id='unknown'><generic response='Error' message='Authentication failed' /></response>
+</ajax-response>
+  }
+end
+
+def get_body_sippeers
+  %q{<ajax-response>
+<response type='object' id='unknown'><generic response='Success' actionid='321321321' eventlist='start' message='Peer status list will follow' /></response>
+<response type='object' id='unknown'><generic event='PeerEntry' actionid='321321321' channeltype='SIP' objectname='5555' chanobjecttype='peer' ipaddress='-none-' ipport='0' dynamic='yes' forcerport='no' videosupport='no' textsupport='no' acl='yes' status='UNKNOWN' realtimedevice='no' /></response>
+<response type='object' id='unknown'><generic event='PeerEntry' actionid='321321321' channeltype='SIP' objectname='8734' chanobjecttype='peer' ipaddress='-none-' ipport='0' dynamic='yes' forcerport='yes' videosupport='no' textsupport='no' acl='yes' status='UNKNOWN' realtimedevice='no' /></response>
+<response type='object' id='unknown'><generic event='PeerEntry' actionid='321321321' channeltype='SIP' objectname='8801' chanobjecttype='peer' ipaddress='-none-' ipport='0' dynamic='yes' forcerport='yes' videosupport='no' textsupport='no' acl='yes' status='UNKNOWN' realtimedevice='no' /></response>
+<response type='object' id='unknown'><generic event='PeerEntry' actionid='321321321' channeltype='SIP' objectname='8803' chanobjecttype='peer' ipaddress='-none-' ipport='0' dynamic='yes' forcerport='yes' videosupport='no' textsupport='no' acl='yes' status='UNKNOWN' realtimedevice='no' /></response>
+<response type='object' id='unknown'><generic event='PeerEntry' actionid='321321321' channeltype='SIP' objectname='88888' chanobjecttype='peer' ipaddress='-none-' ipport='0' dynamic='yes' forcerport='yes' videosupport='no' textsupport='no' acl='yes' status='UNKNOWN' realtimedevice='no' /></response>
+<response type='object' id='unknown'><generic event='PeerEntry' actionid='321321321' channeltype='SIP' objectname='8901' chanobjecttype='peer' ipaddress='-none-' ipport='0' dynamic='yes' forcerport='yes' videosupport='no' textsupport='no' acl='yes' status='UNKNOWN' realtimedevice='no' /></response>
+<response type='object' id='unknown'><generic event='PeerEntry' actionid='321321321' channeltype='SIP' objectname='8902' chanobjecttype='peer' ipaddress='-none-' ipport='0' dynamic='yes' forcerport='yes' videosupport='no' textsupport='no' acl='yes' status='UNKNOWN' realtimedevice='no' /></response>
+<response type='object' id='unknown'><generic event='PeerEntry' actionid='321321321' channeltype='SIP' objectname='8903' chanobjecttype='peer' ipaddress='-none-' ipport='0' dynamic='yes' forcerport='yes' videosupport='no' textsupport='no' acl='yes' status='UNKNOWN' realtimedevice='no' /></response>
+<response type='object' id='unknown'><generic event='PeerlistComplete' eventlist='Complete' listitems='8' actionid='321321321' /></response>
+</ajax-response>
+  }
+end
+
+def get_body_corestatus
+  %q{<ajax-response>
+<response type='object' id='unknown'><generic response='Success' corestartupdate='2013-05-25' corestartuptime='17:13:00' corereloaddate='2013-05-25' corereloadtime='17:13:00' corecurrentcalls='0' /></response>
+</ajax-response>
+  }
+end
+
+def cmd_body_dialplan_reload
+  %q{<ajax-response>
+<response type='object' id='unknown'><generic response='Follows' privilege='Command' opaque_data='Dialplan reloaded.
+--END COMMAND--' /></response>
+</ajax-response>
+  }
+end
+
+def cmd_body_sip_show_peers
+  %q{<ajax-response>
+<response type='object' id='unknown'><generic response='Follows' privilege='Command' opaque_data='Name/username              Host                                    Dyn Forcerport ACL Port     Status
+5555                       (Unspecified)                            D              A  0        UNKNOWN
+8734                       (Unspecified)                            D   N          A  0        UNKNOWN
+8801                       (Unspecified)                            D   N          A  0        UNKNOWN
+8803                       (Unspecified)                            D   N          A  0        UNKNOWN
+88888                      (Unspecified)                            D   N          A  0        UNKNOWN
+8901                       (Unspecified)                            D   N          A  0        UNKNOWN
+8902                       (Unspecified)                            D   N          A  0        UNKNOWN
+8903                       (Unspecified)                            D   N          A  0        UNKNOWN
+8 sip peers [Monitored: 0 online, 8 offline Unmonitored: 0 online, 0 offline]
+--END COMMAND--' /></response>
+</ajax-response>
+  }
+end

metadata

@@ -0,0 +1,133 @@
+--- !ruby/object:Gem::Specification
+name: asterisk-ajam
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Stas Kobzar
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-06-05 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: libxml-ruby
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Ruby module for interacting with Asterisk management interface (AMI)
+  via HTTP
+email:
+- stas@modulis.ca
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .travis.yml
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- asterisk-ajam.gemspec
+- example/ajam.rb
+- lib/asterisk/ajam.rb
+- lib/asterisk/ajam/response.rb
+- lib/asterisk/ajam/session.rb
+- lib/asterisk/ajam/version.rb
+- spec/asterisk/ajam/response_spec.rb
+- spec/asterisk/ajam/session_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/staskobzar/asterisk-ajam
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.3
+signing_key: 
+specification_version: 4
+summary: AMI via HTTP
+test_files:
+- spec/asterisk/ajam/response_spec.rb
+- spec/asterisk/ajam/session_spec.rb
+- spec/spec_helper.rb