AsteriskRuby 1.0.0

data/lib/AGIResponse.rb

@@ -0,0 +1,160 @@
+=begin rdoc
+  Copyright (c) 2007, Vonage Holdings
+
+  All rights reserved.
+
+  Redistribution and use in source and binary forms, with or without
+  modification, are permitted provided that the following conditions are met:
+
+        * Redistributions of source code must retain the above copyright
+  notice, this list of conditions and the following disclaimer.
+        * Redistributions in binary form must reproduce the above copyright
+  notice, this list of conditions and the following disclaimer in the
+  documentation and/or other materials provided with the distribution.
+        * Neither the name of Vonage Holdings nor the names of its       
+  contributors may be used to endorse or promote products derived from this
+  software without specific prior written permission.
+
+  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+  AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+  IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+  ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+  LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+  CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+  SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+  INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+  CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+  POSSIBILITY OF SUCH DAMAGE.
+
+  Author: Michael Komitee <mkomitee@gmail.com>
+=end
+#AGIResponse implements a simple response object which stores Asterisk's native result, and provided data, to be evaluated in various ways.
+
+#AGIResponse implements a simple response object which stores Asterisk's native result, and provided data, to be evaluated in various ways.
+class AGIResponse
+  attr_accessor :native, :data, :success
+  def initialize
+    @native  = nil
+    @data    = nil
+    @success = false
+  end
+#Allows the response object to be evaluated as a string, returning the data.
+  def to_s
+      return @data.to_s
+  end
+  alias_method :to_str, :to_s
+
+#Allows the response object to be evaluated as an integer, returning the data if it can be evaluated as such
+  def to_i
+    if @data.respond_to?(:to_i)
+      return @data.to_i
+    else
+      return nil
+    end
+  end
+
+#Allows the response object to be compared with a regular expression, if possible
+  def =~(regexp)
+    return unless regexp.instance_of?(Regexp)
+    if @data.respond_to?(:to_s)
+      return @data.to_s =~ regexp
+    else
+      return nil
+    end
+  end
+
+#Allows the object to be compared for equality.
+  def ==(string)
+      @data == string
+  end
+  
+#Can check the response object to see if the associated command was successful.
+  def success?
+    @success
+  end
+
+#Check to see if the object is nil returns whether the data is nil
+  def nil?
+    @data.nil?
+  end
+
+#Allow addition for numbers (Integer, Float, Fixnum)
+  def +(rvalue)
+    values = coerce(rvalue)
+    return ( values[1] + values[0])
+  end
+
+#Allow subtraction for numbers (Integer, Float, Fixnum)
+  def -(rvalue)
+    values = coerce(rvalue)
+    return ( values[1] - values[0])
+  end
+  
+#Allow multiplication of numbers (Integer, Float, Fixnum)
+  def *(rvalue)
+    values = coerce(rvalue)
+    return ( values[1] * values[0])
+  end
+
+#Allow division of numbers (Integer, Float, Fixnum)
+  def /(rvalue)
+    values = coerce(rvalue)
+    return ( values[1] / values[0])
+  end
+  
+#Allow exponentiation of numbers (Integer, Float, Fixnum)
+  def **(rvalue)
+    values = coerce(rvalue)
+    return ( values[1] ** values[0])
+  end
+
+#Allow modulus of numbers (Integer, Float, Fixnum)
+  def %(rvalue)
+    values = coerce(rvalue)
+    return ( values[1] % values[0])
+  end
+
+
+  private
+  def coerce(other)
+    if Integer === other
+      [other, Integer(@data)]
+    elsif Float === other
+      [other, Float(@data)]
+    elsif Fixnum === other
+      [other, Fixnum(@data)]
+    end
+  end
+  
+end
+
+=begin
+  Copyright (c) 2007, Vonage Holdings
+
+  All rights reserved.
+
+  Redistribution and use in source and binary forms, with or without
+  modification, are permitted provided that the following conditions are met:
+
+        * Redistributions of source code must retain the above copyright
+  notice, this list of conditions and the following disclaimer.
+        * Redistributions in binary form must reproduce the above copyright
+  notice, this list of conditions and the following disclaimer in the
+  documentation and/or other materials provided with the distribution.
+        * Neither the name of Vonage Holdings nor the names of its       
+  contributors may be used to endorse or promote products derived from this
+  software without specific prior written permission.
+
+  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+  AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+  IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+  ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+  LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+  CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+  SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+  INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+  CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+  POSSIBILITY OF SUCH DAMAGE.
+=end

data/lib/AGIRoute.rb

@@ -0,0 +1,72 @@
+=begin rdoc
+  Copyright (c) 2007, Vonage Holdings
+
+  All rights reserved.
+
+  Redistribution and use in source and binary forms, with or without
+  modification, are permitted provided that the following conditions are met:
+
+        * Redistributions of source code must retain the above copyright
+  notice, this list of conditions and the following disclaimer.
+        * Redistributions in binary form must reproduce the above copyright
+  notice, this list of conditions and the following disclaimer in the
+  documentation and/or other materials provided with the distribution.
+        * Neither the name of Vonage Holdings nor the names of its       
+  contributors may be used to endorse or promote products derived from this
+  software without specific prior written permission.
+
+  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+  AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+  IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+  ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+  LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+  CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+  SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+  INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+  CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+  POSSIBILITY OF SUCH DAMAGE.
+
+  Author: Michael Komitee <mkomitee@gmail.com>
+The AGIRoute class is meant to be subclassed and have various methods added which will work like rails controller actions, being called by the router when agi requests to certain similarly named uri's occur. For example, an asterisk request to the agi with a url of agi://server:port/TestRoutes/test/?foo=bar would execute the test action in the TestRoutes agi route subclass.
+=end
+
+#The AGIRoute class is meant to be subclassed and have various methods added which will work like rails controller actions, being called by the router when agi requests to certain similarly named uri's occur. For example, an asterisk request to the agi with a url of agi://server:port/TestRoutes/test/?foo=bar would execute the test action in the TestRoutes agi route subclass.
+class AGIRoute
+  attr_reader :agi, :params, :request
+  def initialize(data)
+    @agi      = data[:agi]
+    @params   = data[:params]
+    @request  = data[:request]
+  end
+end
+
+=begin
+  Copyright (c) 2007, Vonage Holdings
+
+  All rights reserved.
+
+  Redistribution and use in source and binary forms, with or without
+  modification, are permitted provided that the following conditions are met:
+
+        * Redistributions of source code must retain the above copyright
+  notice, this list of conditions and the following disclaimer.
+        * Redistributions in binary form must reproduce the above copyright
+  notice, this list of conditions and the following disclaimer in the
+  documentation and/or other materials provided with the distribution.
+        * Neither the name of Vonage Holdings nor the names of its       
+  contributors may be used to endorse or promote products derived from this
+  software without specific prior written permission.
+
+  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+  AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+  IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+  ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+  LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+  CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+  SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+  INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+  CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+  POSSIBILITY OF SUCH DAMAGE.
+=end

data/lib/AGIRouter.rb

@@ -0,0 +1,153 @@
+=begin rdoc
+  Copyright (c) 2007, Vonage Holdings
+
+  All rights reserved.
+
+  Redistribution and use in source and binary forms, with or without
+  modification, are permitted provided that the following conditions are met:
+
+        * Redistributions of source code must retain the above copyright
+  notice, this list of conditions and the following disclaimer.
+        * Redistributions in binary form must reproduce the above copyright
+  notice, this list of conditions and the following disclaimer in the
+  documentation and/or other materials provided with the distribution.
+        * Neither the name of Vonage Holdings nor the names of its       
+  contributors may be used to endorse or promote products derived from this
+  software without specific prior written permission.
+
+  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+  AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+  IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+  ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+  LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+  CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+  SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+  INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+  CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+  POSSIBILITY OF SUCH DAMAGE.
+
+  Author: Michael Komitee <mkomitee@gmail.com>
+The AGIRouter is used to route clients to the proper AGIRoute method. It parses the URI presented to the AGIServer by asterisk in the request channel parameter, and if the AGIRoute object responds to the requested method/route, it calls it.
+=end
+
+#The AGIRouter is used to route clients to the proper AGIRoute method. It parses the URI presented to the AGIServer by asterisk in the request channel parameter, and if the AGIRoute object responds to the requested method/route, it calls it.
+require 'logger'
+require 'uri'
+require 'AGIRoute'
+
+#The AGIRouter is used to route clients to the proper AGIRoute method. It parses the URI presented to the AGIServer by asterisk in the request channel parameter, and if the AGIRoute object responds to the requested method/route, it calls it.
+class AGIRouter
+  #Logger for the AGIRouter class
+  @@logger = Logger.new(STDERR)
+  
+  #Takes the request URI, and parses it into the requested method, a supplied id, and supplied options.
+  def initialize(candidate_uri)
+    @uri  = URI.parse(candidate_uri)
+    @controller, @method, @id = parse_path(@uri.path)
+    @options = parse_query(@uri.query)
+  end
+  
+  #Can be used to reset the AGIRouter classes logger object.
+  def AGIRouter.logger(logger)
+    @@logger = logger
+  end
+  
+  #Takes an agi, and an optional parameters hash, and attempts to route to the requested method. If the method does not exist or is private, uses the agi to change the channel extension to invalid and the priority to 1.
+  def route(agi, params=nil)
+    request = { :uri        => @uri, 
+                :controller => @controller, 
+                :method     => @method,
+                :id         => @id,
+                :options    => @options
+              }
+              
+    if controller = get_controller(@controller)
+      if check_controller(controller)
+        if check_route(controller, @method)
+          @@logger.info{"AGIRouter Routing Request to #{@controller} #{@method} by #{@uri}"}
+          controller.new({:agi => agi, :params => params, :request => request}).method(@method).call()
+        else
+          @@logger.warn{"AGIRouter was asked to route a call to controller with unroutable method #{@controller} #{@method}"}      
+          agi.set_extension('i')
+          agi.set_priority('1')
+        end
+      else
+        @@logger.warn{"AGIRouter was asked to route a call to an invalid controller #{@controller}"}      
+        agi.set_extension('i')
+        agi.set_priority('1')
+      end
+    else
+      @@logger.warn{"AGIRouter was asked to route a call to a nonexistant controller #{@controller}"}      
+      agi.set_extension('i')
+      agi.set_priority('1')
+    end
+  end
+
+  private
+  def parse_path(uri_path)
+    return nil if uri_path.nil?
+    result = uri_path.split('/')[1,3]
+  end
+  def parse_query(uri_query)
+    return nil if uri_query.nil?
+    options = {}
+    tuples = uri_query.split('&')
+    tuples.each { |tuple| pair = tuple.split('='); options[pair[0]] = pair[1]}
+    return options
+  end
+  
+  def get_controller(requested_controller)
+    begin
+      return Module.const_get(requested_controller)
+    rescue NameError
+      # NameError when requested_controller doesn't exist as a class
+      return nil
+    end
+  end
+  
+  def check_controller(candidate_controller)
+    while candidate_controller = candidate_controller.superclass do
+      return true if candidate_controller == AGIRoute
+    end
+    return nil    
+  end
+  
+  def check_route(controller, requested_method)
+    if controller.public_method_defined?(requested_method)
+      return true
+    else
+      return false
+    end
+  end
+end
+
+=begin
+  Copyright (c) 2007, Vonage Holdings
+
+  All rights reserved.
+
+  Redistribution and use in source and binary forms, with or without
+  modification, are permitted provided that the following conditions are met:
+
+        * Redistributions of source code must retain the above copyright
+  notice, this list of conditions and the following disclaimer.
+        * Redistributions in binary form must reproduce the above copyright
+  notice, this list of conditions and the following disclaimer in the
+  documentation and/or other materials provided with the distribution.
+        * Neither the name of Vonage Holdings nor the names of its       
+  contributors may be used to endorse or promote products derived from this
+  software without specific prior written permission.
+
+  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+  AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+  IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+  ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+  LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+  CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+  SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+  INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+  CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+  POSSIBILITY OF SUCH DAMAGE.
+=end

data/lib/AGISelection.rb

@@ -0,0 +1,155 @@
+=begin rdoc
+  Copyright (c) 2007, Vonage Holdings
+
+  All rights reserved.
+
+  Redistribution and use in source and binary forms, with or without
+  modification, are permitted provided that the following conditions are met:
+
+        * Redistributions of source code must retain the above copyright
+  notice, this list of conditions and the following disclaimer.
+        * Redistributions in binary form must reproduce the above copyright
+  notice, this list of conditions and the following disclaimer in the
+  documentation and/or other materials provided with the distribution.
+        * Neither the name of Vonage Holdings nor the names of its       
+  contributors may be used to endorse or promote products derived from this
+  software without specific prior written permission.
+
+  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+  AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+  IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+  ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+  LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+  CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+  SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+  INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+  CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+  POSSIBILITY OF SUCH DAMAGE.
+
+  Author: Michael Komitee <mkomitee@gmail.com>
+
+AGISelection can be used to get a string of digits from an asterisk channel. You configure it similarly to an AGIMenu, but it takes a max_digits paramater and only accepts a single audio file. AGIMenu only accepts a single dtmf digit, whereas AGISelection can accept multiple digits. It would be used to have a user input a PIN or a telephone number or something similar.
+
+  agi = AGI.new()
+  yaml_hash = {:audio => 'tt-monkeys', :max_digits => 4}
+  foo = AGISelection.new(yaml_hash)
+  foo.read(:agi => AGI.new())
+
+=end
+
+#AGISelection implements the AGI function get_data via an externally configurable YAML file
+require 'yaml'
+require 'AGI'
+#AGISelection implements the AGI function get_data via an externally configurable YAML file
+class AGISelection
+  @@sounds_dir = nil
+# :audio The name of the file that you wish to play
+  attr_accessor :audio 
+  attr_reader :params
+#Creates an AGISelection Object based on the provided YAML Hash.
+#* :audio The name of the file that you wish to play
+#* :default_timeout set to 600 seconds. This can be overridden by passing a :timeout paramerter in your YAML hash
+#* :max_digits no maximum (nil) by default
+  def initialize(input=nil)
+    @audio = nil
+    @default_timeout = 600
+    @max_digits = nil
+    @params = input
+    configure(input)
+  end
+
+#Configure all the basic variables that AGISelection needs
+#* :audio The name of the file that you wish to play
+#* :default_timeout set to 600 seconds. This can be overridden by passing a :timeout paramerter in your YAML hash
+#* :max_digits no maximum (nil) by default
+  def configure(input)
+    if input.respond_to?('read')
+      config = YAML::load(input)
+    elsif input.respond_to?(:to_hash)
+      config = input
+      elsif input.respond_to?(:to_s) and File.exists?(input.to_s) and File.readable?(input.to_s)
+      config = File.open( input.to_s ) { |f| YAML::load( f ) }
+    end
+    if config.respond_to?(:to_hash)
+      @params = config
+      @audio = config[:audio]
+      @default_timeout = config[:timeout] || @default_timeout
+      @max_digits = config[:max_digits] || @max_digits
+    end
+  end
+  
+#Read returns the result of executing agi.get_data()
+#You must pass an AGI object as a parameter in your YAML hash
+#For example:
+# require 'AGI'
+# require 'AGISelection'
+#
+# agi = AGI.new({})
+# # Initialize the AGI or bad things will happen
+# agi.init()
+# yaml_hash = {:audio => 'tt-monkeys', :max_digits => 4}
+# foo = AGISelection.new(yaml_hash)
+# # Override the Audio file from the YAML hash
+# foo.audio = 'somethingelse'
+# foo.read(:agi => agi)
+  def read(conf={:timeout => @default_timeout, :max_digits => @max_digits})
+    if !conf[:agi].respond_to?(:get_data)
+      raise ArgumentError, "agi required, must be an AsteriskAGI"
+    elsif @audio.nil?
+      raise ArgumentError, "You must supply an audio file"
+    end
+    conf[:timeout] = @default_timeout unless conf.has_key?(:timeout)
+    conf[:max_digits] = @max_digits unless conf.has_key?(:max_digits)
+    agi = conf[:agi]
+    if @@sounds_dir then
+      audio = @@sounds_dir + '/' + @audio
+    else
+      audio = @audio
+    end
+    begin
+      result = agi.get_data(audio, conf[:timeout], conf[:max_digits])
+    rescue AGITimeoutError
+      nil
+    end
+  end
+  
+  alias :execute :read
+  alias :get :read
+  alias :get_data :read
+  
+  def AGISelection.sounds_dir=(sounds_dir)
+    @@sounds_dir = sounds_dir
+  end
+end
+
+
+=begin
+  Copyright (c) 2007, Vonage Holdings
+
+  All rights reserved.
+
+  Redistribution and use in source and binary forms, with or without
+  modification, are permitted provided that the following conditions are met:
+
+        * Redistributions of source code must retain the above copyright
+  notice, this list of conditions and the following disclaimer.
+        * Redistributions in binary form must reproduce the above copyright
+  notice, this list of conditions and the following disclaimer in the
+  documentation and/or other materials provided with the distribution.
+        * Neither the name of Vonage Holdings nor the names of its       
+  contributors may be used to endorse or promote products derived from this
+  software without specific prior written permission.
+
+  THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+  AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+  IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+  ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+  LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+  CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+  SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+  INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+  CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+  ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+  POSSIBILITY OF SUCH DAMAGE.
+=end