mtrudel-adhearsion 0.8.3

data/lib/adhearsion/initializer/asterisk.rb

@@ -0,0 +1,81 @@
+require 'adhearsion/voip/asterisk'
+module Adhearsion
+  class Initializer
+    
+    class AsteriskInitializer
+      
+      cattr_accessor :config, :agi_server, :ami_client
+      class << self
+        
+        def start
+          self.config     = AHN_CONFIG.asterisk
+          self.agi_server = initialize_agi
+          self.ami_client = VoIP::Asterisk.manager_interface = initialize_ami if config.ami_enabled?
+          join_server_thread_after_initialized
+        end
+
+        def stop
+          agi_server.stop
+          ami_client.disconnect! if ami_client
+        end
+
+        private
+
+        def initialize_agi
+          VoIP::Asterisk::AGI::Server.new :host => config.listening_host,
+                                          :port => config.listening_port
+        end
+        
+        def initialize_ami
+          options = ami_options
+          start_ami_after_initialized
+          returning VoIP::Asterisk::Manager::ManagerInterface.new(options) do
+            class << VoIP::Asterisk
+              if respond_to?(:manager_interface)
+                ahn_log.warn "Asterisk.manager_interface already initialized?"
+              else
+                def manager_interface
+                  # ahn_log.ami.warn "Warning! This Asterisk.manager_interface() notation is for Adhearsion version 0.8.0 only. Subsequent versions of Adhearsion will use a feature called SuperManager. Migrating to use SuperManager will be very simple. See http://docs.adhearsion.com/AMI for more information."
+                  Adhearsion::Initializer::AsteriskInitializer.ami_client
+                end
+              end
+            end
+          end
+        end
+        
+        def ami_options
+          %w(host port username password events).inject({}) do |options, property|
+            options[property.to_sym] = config.ami.send property
+            options
+          end
+        end
+        
+        def join_server_thread_after_initialized
+          Events.register_callback(:after_initialized) do
+            begin
+              agi_server.start
+            rescue => e
+              ahn_log.fatal "Failed to start AGI server! #{e.inspect}"
+              abort
+            end
+          end
+          IMPORTANT_THREADS << agi_server
+        end
+        
+        def start_ami_after_initialized
+          Events.register_callback(:after_initialized) do
+            begin
+              self.ami_client.connect!
+            rescue Errno::ECONNREFUSED
+              ahn_log.ami.error "Connection refused when connecting to AMI! Please check your configuration."
+            rescue => e
+              ahn_log.ami.error "Error connecting to AMI! #{e.inspect}"
+            end
+          end
+        end
+
+      end
+    end
+    
+  end
+end

data/lib/adhearsion/initializer/configuration.rb

@@ -0,0 +1,254 @@
+module Adhearsion
+  class Configuration
+    module ConfigurationEntryPoint
+      def add_configuration_for(name)
+        configuration_class_name = "#{name}Configuration"
+        lowercased_name          = name.to_s.underscore
+
+        class_eval(<<-EVAL, __FILE__, __LINE__)
+          def enable_#{lowercased_name}(configuration_options = {})
+            @#{lowercased_name}_configuration = #{configuration_class_name}.new(configuration_options)
+          end
+
+          def #{lowercased_name}
+            @#{lowercased_name}_configuration
+          end
+
+          def #{lowercased_name}_enabled?
+            !#{lowercased_name}.nil?
+          end
+        EVAL
+      end
+    end
+    extend ConfigurationEntryPoint
+    
+    class << self
+      def configure(&block)
+        if Adhearsion.const_defined?(:AHN_CONFIG)
+          yield AHN_CONFIG if block_given?
+        else
+          Adhearsion.const_set(:AHN_CONFIG, new(&block))
+        end
+      end
+    end
+    
+    attr_accessor :automatically_answer_incoming_calls
+    attr_accessor :end_call_on_hangup
+    attr_accessor :end_call_on_error
+    
+    def initialize
+      @automatically_answer_incoming_calls = true
+      @end_call_on_hangup                  = true
+      @end_call_on_error                   = true
+      yield self if block_given?
+    end
+    
+    def ahnrc
+      @ahnrc
+    end
+    
+    ##
+    # Load the contents of an .ahnrc file into this Configuration.
+    #
+    # @param [String, Hash] ahnrc String of YAML .ahnrc data or a Hash of the pre-loaded YAML data structure
+    #
+    def ahnrc=(new_ahnrc)
+      case new_ahnrc
+        when Hash
+          @raw_ahnrc = new_ahnrc.to_yaml.freeze
+          @ahnrc = new_ahnrc.clone.freeze
+        when String
+          @raw_ahnrc = new_ahnrc.clone.freeze
+          @ahnrc = YAML.load(new_ahnrc).freeze
+      end
+    end
+    
+    def logging(options)
+      Adhearsion::Logging.logging_level = options[:level]
+    end
+    
+    ##
+    # Adhearsion's .ahnrc file is used to define paths to certain parts of the framework. For example, the name dialplan.rb
+    # is actually specified in .ahnrc. This file can actually be just a filename, a filename with a glob (.e.g "*.rb"), an
+    # Array of filenames or even an Array of globs.
+    #
+    # @param [String,Array] String segments which convey the nesting of Hash keys through .ahnrc
+    # @raise [RuntimeError] If ahnrc has not been set yet with #ahnrc=()
+    # @raise [NameError] If the path through the ahnrc is invalid
+    #
+    def files_from_setting(*path_through_config)
+      raise RuntimeError, "No ahnrc has been set yet!" unless @ahnrc
+      queried_nested_setting = path_through_config.flatten.inject(@ahnrc) do |hash,key_name|
+        if hash.kind_of?(Hash) && hash.has_key?(key_name)
+          hash[key_name]
+        else
+          raise NameError, "Paths #{path_through_config.inspect} not found in .ahnrc!"
+        end
+      end
+      raise NameError, "Paths #{path_through_config.inspect} not found in .ahnrc!" unless queried_nested_setting
+      queried_nested_setting = Array queried_nested_setting
+      queried_nested_setting.map { |filename| files_from_glob(filename) }.flatten.uniq
+    end
+    
+    private
+    
+    def files_from_glob(glob)
+      Dir.glob "#{AHN_ROOT}/#{glob}"
+    end
+    
+    class AbstractConfiguration
+      extend ConfigurationEntryPoint
+      
+      class << self
+        private
+          def abstract_method!
+            raise "Must be implemented in subclasses"
+          end
+      end
+      
+      def initialize(overrides = {})
+        overrides.each_pair do |attribute, value|
+          send("#{attribute}=", value)
+        end
+      end
+    end
+    
+    # Abstract superclass for AsteriskConfiguration and FreeSwitchConfiguration.
+    class TelephonyPlatformConfiguration < AbstractConfiguration
+      attr_accessor :listening_port
+      attr_accessor :listening_host
+      
+      class << self
+        def default_listening_port
+          abstract_method!
+        end
+        
+        def default_listening_host
+          '0.0.0.0'
+        end
+      end
+        
+      def initialize(overrides = {})
+        @listening_port = self.class.default_listening_port
+        @listening_host = self.class.default_listening_host
+        super
+      end
+    end
+    
+    class AsteriskConfiguration < TelephonyPlatformConfiguration
+      class << self
+        attr_accessor :speech_engine
+        
+        def default_listening_port
+          4573
+        end
+      end
+      
+      class AMIConfiguration < AbstractConfiguration
+        attr_accessor :port, :username, :password, :events, :host
+        
+        class << self
+          def default_port
+            5038
+          end
+
+          def default_events
+            false
+          end
+          
+          def default_host
+            'localhost'
+          end
+        end
+        
+        def initialize(overrides = {})
+          self.host   = self.class.default_host
+          self.port   = self.class.default_port
+          self.events = self.class.default_events
+          super
+        end
+      end
+      add_configuration_for :AMI
+    end
+    add_configuration_for :Asterisk
+    
+    class FreeswitchConfiguration < TelephonyPlatformConfiguration
+      class << self
+        def default_listening_port
+          4572
+        end
+      end
+    end
+    add_configuration_for :Freeswitch
+    
+    class DatabaseConfiguration < AbstractConfiguration
+      attr_accessor :connection_options, :orm
+      def initialize(options)
+        @orm                = options.delete(:orm) || :active_record # TODO: ORM is a misnomer
+        @connection_options = options
+      end
+    end
+    add_configuration_for :Database
+    
+    class DrbConfiguration < AbstractConfiguration
+      attr_accessor :port
+      attr_accessor :host
+      attr_accessor :acl
+
+      # ACL = Access Control List
+
+      class << self
+        def default_port
+          9050
+        end
+        
+        def default_host
+          'localhost'
+        end
+      end
+      
+      def initialize(overrides = {})
+        self.port = overrides[:port] || self.class.default_port
+        self.host = overrides[:host] || self.class.default_host
+        self.acl  = overrides[:raw_acl]
+        
+        unless acl
+          self.acl = []
+          overrides[ :deny].to_a.each { |ip| acl << 'deny' << ip }
+          overrides[:allow].to_a.each { |ip| acl << 'allow' << ip }
+          acl.concat %w[allow 127.0.0.1] if acl.empty?
+        end
+      end
+    end
+    add_configuration_for :Drb
+    
+    class RailsConfiguration < AbstractConfiguration
+      
+      SUPPORTED_RAILS_ENVIRONMENTS = [:development, :test, :production]
+      
+      attr_accessor :rails_root, :environment
+      def initialize(options)
+        path_to_rails, environment = check_options options
+        @rails_root = File.expand_path(path_to_rails)
+        @environment = environment.to_sym
+        raise ArgumentError, "Unrecognized environment type #@environment. Supported: " +
+          SUPPORTED_RAILS_ENVIRONMENTS.to_sentence unless SUPPORTED_RAILS_ENVIRONMENTS.include?(@environment)
+      end
+    
+      private
+      
+      def check_options(options)
+        options = options.clone
+        path    = options.delete :path
+        env     = options.delete :env
+        raise ArgumentError, "Unrecognied argument(s) #{options.keys.to_sentence} in Rails initializer!" unless options.size.zero?
+        raise ArgumentError, "Must supply an :env argument to the Rails initializer!" unless env
+        raise ArgumentError, "Must supply an :path argument to the Rails initializer!" unless path
+        [path, env]
+      end
+    
+    end
+    add_configuration_for :Rails
+    
+  end
+end

data/lib/adhearsion/initializer/database.rb

@@ -0,0 +1,50 @@
+# TODO: Have all of the initializer modules required and then traverse the subclasses, asking them if they're enabled. If they are enabled, then they should do their initialization stuff. Is this really necessary to develop this entirely new system when the components system exists?
+
+module Adhearsion
+  class Initializer
+    
+    class DatabaseInitializer
+      
+      class << self
+
+        def start
+          require_dependencies
+          require_models
+          @@config = Adhearsion::AHN_CONFIG.database
+          # You may need to uncomment the following line for older versions of ActiveRecord
+          # ActiveRecord::Base.allow_concurrency = true
+          establish_connection
+          create_call_hook_for_connection_cleanup
+        end
+
+        def stop
+          ActiveRecord::Base.remove_connection
+        end
+
+        private
+
+        def create_call_hook_for_connection_cleanup
+          Events.register_callback([:asterisk, :before_call]) do
+            ActiveRecord::Base.verify_active_connections!
+          end
+        end
+
+        def require_dependencies
+          require 'active_record'
+        end
+
+        def require_models
+          AHN_CONFIG.files_from_setting("paths", "models").each do |model|
+            load model
+          end
+        end
+        
+        def establish_connection
+          ActiveRecord::Base.establish_connection @@config.connection_options
+        end
+
+      end
+    end
+    
+  end
+end

data/lib/adhearsion/initializer/drb.rb

@@ -0,0 +1,31 @@
+require 'drb'
+require 'drb/acl'
+require 'thread'
+
+module Adhearsion
+  class Initializer
+
+    class DrbInitializer
+
+      class << self
+        
+        def start
+          config = Adhearsion::AHN_CONFIG.drb
+          DRb.install_acl ACL.new(config.acl) if config.acl
+          
+          drb_door = Object.new
+          Components.component_manager.extend_object_with(drb_door, :rpc)
+          
+          DRb.start_service "druby://#{config.host}:#{config.port}", drb_door
+          
+          ahn_log "Starting DRb on #{config.host}:#{config.port}"
+        end
+        
+        def stop
+          DRb.stop_service
+        end
+        
+      end
+    end
+  end
+end

data/lib/adhearsion/initializer/freeswitch.rb

@@ -0,0 +1,22 @@
+# THIS FREESWITCH LIBRARY HASN'T BEEN INTEGRATED INTO THE REFACTORED 0.8.0 YET.
+# WHAT EXISTS HERE IS OLD, MUST BE CHANGED, AND DOES NOT EVEN GET LOADED AT THE MOMENT.
+require "adhearsion/voip/freeswitch/oes_server"
+require "adhearsion/voip/freeswitch/event_handler"
+require "adhearsion/voip/freeswitch/inbound_connection_manager"
+require "adhearsion/voip/dsl/dialplan/control_passing_exception"
+
+oes_enabled = Adhearsion::Configuration.core.voip.freeswitch.oes && Adhearsion::Configuration.core.voip.freeswitch.oes.port
+                
+
+if oes_enabled
+
+  port = Adhearsion::Configuration.core.voip.freeswitch.oes.port
+  host = Adhearsion::Configuration.core.voip.freeswitch.oes.host
+
+  server = Adhearsion::VoIP::FreeSwitch::OesServer.new port, host
+
+  Events.register_callback(:after_initialized) { server.start }
+  Events.register_callback(:shutdown) { server.stop }
+  IMPORTANT_THREADS << server
+
+end

data/lib/adhearsion/initializer/rails.rb

@@ -0,0 +1,41 @@
+require 'adhearsion/voip/asterisk'
+
+module Adhearsion
+  class Initializer    
+    class RailsInitializer
+      
+      cattr_accessor :rails_root, :config, :environment
+      class << self
+        
+        def start
+          ahn_config       = Adhearsion::AHN_CONFIG
+          self.config      = ahn_config.rails
+          self.rails_root  = config.rails_root 
+          self.environment = config.environment
+          raise "You cannot enable the database and Rails at the same time!" if ahn_config.database_enabled?
+          raise "Error loading Rails environment in #{rails_root.inspect}. "  +
+                "It's not a directory!" unless File.directory?(rails_root)
+          load_rails
+          if defined? ActiveRecord
+            # You may need to uncomment the following line for older versions of ActiveRecord
+            # ActiveRecord::Base.allow_concurrency = true
+            Events.register_callback([:asterisk, :before_call]) do
+              ActiveRecord::Base.verify_active_connections!
+            end
+          end
+        end
+        
+        private
+        
+        def load_rails
+          environment_file = File.expand_path(rails_root + "/config/environment.rb")
+          raise "There is no config/environment.rb file!" unless File.exists?(environment_file)
+          ENV['RAILS_ENV'] = environment.to_s
+          require environment_file
+        end
+        
+      end
+      
+    end
+  end
+end