adhearsion-cw 1.0.2.1

data/bin/ahn

@@ -0,0 +1,29 @@
+#!/usr/bin/env ruby
+
+# This is the main executable file.
+
+# Adhearsion, open source collaboration framework
+# Copyright (C) 2006,2007,2008 Jay Phillips
+#
+# This library is free software; you can redistribute it and/or modify it under
+# the terms of the GNU Lesser General Public License as published by the Free
+# Software Foundation; either version 2.1 of the License, or (at your option)
+# any later version.
+#
+# This library is distributed in the hope that it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+# FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
+# details.
+#
+# You should have received a copy of the GNU Lesser General Public License along
+# with this library; if not, write to the Free Software Foundation, Inc.,
+# 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
+
+$:.unshift File.expand_path(File.dirname(__FILE__) + "/../lib")
+
+require 'rubygems'
+require 'bundler/setup'
+require 'adhearsion'
+require 'adhearsion/cli'
+
+Adhearsion::CLI::AhnCommand.execute!

data/bin/ahnctl

@@ -0,0 +1,68 @@
+#!/usr/bin/env ruby
+#
+#  ahnctl - Adhearsion daemon controller
+#
+# Adhearsion, open source collaboration framework
+# Copyright (C) 2006,2007,2008 Jay Phillips
+#
+# This library is free software; you can redistribute it and/or
+# modify it under the terms of the GNU Lesser General Public
+# License as published by the Free Software Foundation; either
+# version 2.1 of the License, or (at your option) any later version.
+#
+# This library is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+# Lesser General Public License for more details.
+#
+# You should have received a copy of the GNU Lesser General Public
+# License along with this library; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
+
+USAGE = "Usage: ahnctl start|stop|restart /path/to/adhearsion/app [--pid-file=/path/to/pid_file.pid]"
+
+# Blow up if the CLI arguments are invalid
+abort USAGE unless (2..3).include?(ARGV.size) && %w[start stop restart].include?(ARGV.first)
+
+# By default, ahnctl will use the version of Adhearsion it was installed with.
+
+pid_file    = ARGV.pop if ARGV.size == 3
+ahn_command = File.expand_path File.dirname(__FILE__) + "/ahn"
+app_dir     = File.expand_path ARGV.last
+
+pid_file_path_regexp = /^--pid-file=(.+)$/
+abort USAGE if pid_file && pid_file !~ pid_file_path_regexp
+
+# If pid_file is not nil, let's extract the path specified.
+pid_file &&= File.expand_path pid_file[pid_file_path_regexp,1]
+
+# If there was no third argument and pid_file is still nil, let's use the default.
+pid_file ||= app_dir + '/adhearsion.pid'
+
+abort "Directory is not an Adhearsion application!" unless File.exists?(app_dir + "/.ahnrc")
+
+def terminate(pid) `kill -s TERM #{pid} 2> /dev/null` end
+def      kill(pid) `kill -s KILL #{pid} 2> /dev/null` end
+
+# Even if we're starting Adhearsion, we need to make sure to clean up after any stale
+# pid files. In effect, start is the same as restart.
+puts "Stopping Adhearsion app at #{app_dir}" if %w[stop restart].include? ARGV.first
+
+if File.exists?(pid_file)
+  # An Adhearsion process may still be running. Let's kill the other one as cleanly as possible
+  pid = File.read(pid_file).to_i
+
+  # Time to spend waiting for Adhearsion to exit
+  waiting_timeout = Time.now + 15
+
+  terminate pid
+  sleep 0.25 until `ps -p #{pid} | sed -e '1d'`.strip.empty? || Time.now > waiting_timeout
+  kill pid
+
+  `rm -f #{pid_file}`
+end
+
+if ['start', 'restart'].include? ARGV.first
+  puts "Starting Adhearsion app at #{app_dir}"
+  `#{ahn_command} start daemon #{app_dir} --pid-file=#{pid_file}`
+end

data/bin/jahn

@@ -0,0 +1,43 @@
+#!/usr/bin/env jruby
+
+# This "jahn" script is "ahn" for JRUBY!
+
+# Adhearsion, open source collaboration framework
+# Copyright (C) 2006,2007,2008 Jay Phillips
+#
+# This library is free software; you can redistribute it and/or modify it under
+# the terms of the GNU Lesser General Public License as published by the Free
+# Software Foundation; either version 2.1 of the License, or (at your option)
+# any later version.
+#
+# This library is distributed in the hope that it will be useful, but WITHOUT
+# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
+# FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
+# details.
+#
+# You should have received a copy of the GNU Lesser General Public License along
+# with this library; if not, write to the Free Software Foundation, Inc.,
+# 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
+
+$:.unshift File.expand_path(File.dirname(__FILE__) + "/../lib")
+
+require 'rubygems'
+require 'bundler/setup'
+require 'adhearsion'
+require 'adhearsion/cli'
+
+# jahn will soon have JRuby-specific behavior such as creating a compiled .jar
+# file from an app.
+# require 'adhearsion/jruby'
+
+abort(<<-MESSAGE) unless RUBY_PLATFORM =~ /java/
+You must use jahn with JRuby! Are you running this script after installing Adhearsion with non-JRuby RubyGems?
+
+If you don't want to install Adhearsion with the JRuby version of RubyGems, try running jahn directly with an absolute path:
+
+#{File.expand_path(__FILE__)} start your_app_name
+
+Note: You must have the jruby executable in your $PATH and $JRUBY_HOME set.
+MESSAGE
+
+Adhearsion::CLI::AhnCommand.execute!

data/examples/asterisk_manager_interface/standalone.rb

@@ -0,0 +1,51 @@
+# This is a file which shows you how to use the Asterisk Manager Interface library in a standalone Ruby script.
+
+PATH_TO_ADHEARSION = File.join(File.dirname(__FILE__), "/../..")
+
+MANAGER_CONNECTION_INFORMATION = {
+  :host     => "10.0.1.97",
+  :username => "jicksta",
+  :password => "roflcopter",
+  :events   => true
+}
+
+require 'rubygems'
+begin
+  require 'adhearsion'
+rescue LoadError
+  begin
+    require File.join(PATH_TO_ADHEARSION, "/lib/adhearsion")
+  rescue LoadError
+    abort "Could not find Adhearsion! Please update the PATH_TO_ADHEARSION constant in this file"
+  end
+end
+
+require 'adhearsion/voip/asterisk/manager_interface'
+
+# If you'd like to see the AMI protocol data, change this to :debug
+Adhearsion::Logging.logging_level = :warn
+
+# This makes addressing the ManagerInterface class a little cleaner
+include Adhearsion::VoIP::Asterisk::Manager
+
+# Let's instantiate a new ManagerInterface object and have it automatically connect using the Hash we defined above.
+interface = ManagerInterface.connect MANAGER_CONNECTION_INFORMATION
+
+# Send an AMI action with our new ManagerInterface object. This will return an Array of SIPPeer events.
+sip_peers = interface.send_action "SIPPeers"
+
+# Pretty-print the SIP peers on the server
+
+if sip_peers.any?
+  sip_peers.each do |peer|
+    # Uncomment the following line to view all the headers for each peer.
+    # p peer.headers
+
+    peer_name   = peer.headers["ObjectName"]
+    peer_status = peer.headers["Status"]
+
+    puts "#{peer_name}: #{peer_status}"
+  end
+else
+  puts "This Asterisk server has no SIP peers!"
+end

data/lib/adhearsion/cli.rb

@@ -0,0 +1,296 @@
+require 'fileutils'
+
+module Adhearsion
+  module CLI
+    module AhnCommand
+      USAGE = <<USAGE
+Usage:
+   ahn create /path/to/directory
+   ahn start [daemon] [/path/to/directory]
+   ahn version|-v|--v|-version|--version
+   ahn help|-h|--h|--help|-help
+
+   ahn  enable component COMPONENT_NAME
+   ahn disable component COMPONENT_NAME
+   ahn  create component COMPONENT_NAME
+USAGE
+      class << self
+
+        def execute!
+          CommandHandler.send(*parse_arguments)
+        rescue CommandHandler::CLIException => error
+          fail_and_print_usage error
+        end
+
+        ##
+        # Provides a small abstraction of Kernel::abort().
+        #
+        def fail_and_print_usage(error)
+          Kernel.abort "#{error.message}\n\n#{USAGE}"
+        end
+
+        def parse_arguments(args=ARGV.clone)
+          action = args.shift
+          case action
+          when /^-?-?h(elp)?$/, nil   then [:help]
+          when /^-?-?v(ersion)?$/     then [:version]
+          when "create"
+            [:create, *args]
+          when 'start'
+            pid_file_regexp = /^--pid-file=(.+)$/
+            if args.size > 3
+              fail_and_print_usage "Too many arguments supplied!" if args.size > 3
+            elsif args.size == 3
+              fail_and_print_usage "Unrecognized final argument #{args.last}" unless args.last =~ pid_file_regexp
+              pid_file = args.pop[pid_file_regexp, 1]
+            else
+              pid_file = nil
+            end
+
+            if args.first == 'daemon' && args.size == 2
+              path   = args.last
+              daemon = true
+            elsif args.size == 1
+              path, daemon = args.first, false
+            else
+              fail_and_print_usage "Invalid format for the start CLI command!"
+            end
+            [:start, path, daemon, pid_file]
+          when '-'
+            [:start, Dir.pwd]
+          when "enable", "disable"
+            if args.size == 1
+              raise CommandHandler::UnknownCommand, "Must supply an argument for what you wish to #{action}"
+            elsif args.size == 2
+              [action, *args]
+            else
+              raise CommandHandler::UnknownCommand, "Too many arguments supplied!"
+            end
+          else
+            [action, *args]
+          end
+        end
+      end
+
+      module CommandHandler
+        class << self
+
+          def create(*args)
+            if args.size.zero?
+              raise CommandHandler::UnknownCommand.new("Must specify something to create!")
+            elsif args.size == 1
+              # We're creating a project
+              path = args.first
+              require 'rubigen'
+              require 'rubigen/scripts/generate'
+              source = RubiGen::PathSource.new(:application,
+                File.join(File.dirname(__FILE__), "../../app_generators"))
+              RubiGen::Base.reset_sources
+              RubiGen::Base.append_sources source
+              RubiGen::Scripts::Generate.new.run([path], :generator => 'ahn')
+            elsif args.size == 2
+              # We're creating a feature (e.g. a component)
+              feature_type, component_name = args
+
+              if feature_type != "component"
+                # At the moment, only components can be created.
+                raise CommandHandler::UnknownCommand.new("Don't know how to create '#{feature_type}'")
+              end
+
+              if component_name !~ /^[a-z][\w_]+$/
+                raise CommandHandler::ComponentError.new("Component name must be lowercase alphanumeric characters " +
+                    "and begin with a character")
+              end
+
+              app_path = PathString.from_application_subdirectory Dir.pwd
+
+              if app_path.nil?
+                new_component_dir = File.join Dir.pwd, component_name
+              else
+                puts "Adhearsion application detected. Creating new component at components/#{component_name}"
+                new_component_dir = File.join app_path, "components", component_name
+              end
+
+              raise ComponentError.new("Component #{component_name} already exists!") if File.exists?(new_component_dir)
+
+              # Everything's good. Let's create the component
+              Dir.mkdir new_component_dir
+
+              # Initial component code file
+              Dir.mkdir File.join(new_component_dir, "lib")
+              fn = File.join("lib", "#{component_name}.rb")
+              puts "- #{fn}: Initial component code file"
+              File.open(File.join(new_component_dir, fn),"w") do |file|
+                file.puts <<-RUBY
+# See http://docs.adhearsion.com for more information on how to write components or
+# look at the examples in newly-created projects.
+                RUBY
+              end
+
+              # Component configuration
+              Dir.mkdir File.join(new_component_dir, "config")
+              fn = File.join("config", "#{component_name}.yml")
+              puts "- #{fn}: Example component configuration YAML"
+              File.open(File.join(new_component_dir, fn),"w") do |file|
+                file.puts '# You can use this file for component-specific configuration.'
+              end
+
+              # Component example gemspec
+              fn = File.join("#{component_name}.gemspec")
+              puts "- #{fn}: Example component gemspec"
+              File.open(File.join(new_component_dir, fn), "w") do |file|
+                file.puts <<-RUBY
+GEM_FILES = %w{
+  #{component_name}.gemspec
+  lib/#{component_name}.rb
+  config/#{component_name}.yml
+}
+
+Gem::Specification.new do |s|
+  s.name = "#{component_name}"
+  s.version = "0.0.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Your Name Here!"]
+
+  s.date = Date.today.to_s
+  s.description = "This Adhearsion component gem has not yet been described."
+  s.email = "noreply@example.com"
+
+  s.files = GEM_FILES
+
+  s.has_rdoc = false
+  s.homepage = "http://adhearsion.com"
+  s.require_paths = ["lib"]
+  s.rubygems_version = "1.2.0"
+  s.summary = "This Adhearsion component gem has no summary."
+
+  s.specification_version = 2
+end
+                RUBY
+              end
+
+              # Component example spec
+              Dir.mkdir File.join(new_component_dir, "spec")
+              fn = File.join("spec", "#{component_name}_spec.rb")
+              puts "- #{fn}: Example component spec"
+              File.open(File.join(new_component_dir, fn), "w") do |file|
+                file.puts <<-RUBY
+require 'rubygems'
+require 'bundler'
+Bundler.setup
+Bundler.require
+
+require 'adhearsion/component_manager/spec_framework'
+
+component_name.upcase = ComponentTester.new("#{component_name}", File.dirname(__FILE__) + "/../..")
+                RUBY
+              end
+              puts "Created blank component '#{component_name}' at #{new_component_dir}"
+            else
+              raise CommandHandler::UnknownCommand.new("Provided too many arguments to 'create'")
+            end
+          end
+
+          def start(path, daemon=false, pid_file=nil)
+            raise PathInvalid, path unless File.exists? path + "/.ahnrc"
+            Adhearsion::Initializer.start path, :daemon => daemon, :pid_file => pid_file
+          end
+
+          def version
+            puts "Adhearsion v#{Adhearsion::VERSION::STRING}"
+          end
+
+          def help
+            puts USAGE
+          end
+
+          def enable(type, name)
+            case type
+              when "component"
+                app_path = PathString.from_application_subdirectory Dir.pwd
+                if app_path
+                  disabled_component_path = File.join app_path, "components", "disabled", name
+                  disabled_components_path = File.join app_path, "components", "disabled"
+                  enabled_component_path  = File.join app_path, "components", name
+                  if File.directory? disabled_component_path
+                    FileUtils.mv disabled_component_path, enabled_component_path
+                    puts "Enabled component #{name}"
+                  elsif File.directory? enabled_component_path
+                    raise ComponentError.new("This component is already enabled.")
+                  elsif !File.directory? disabled_components_path
+                    raise ComponentError.new("There is no components/disabled directory!")
+                  else
+                    raise ComponentError.new("The requested component was not found.")
+                  end
+                else
+                  raise PathInvalid.new(Dir.pwd)
+                end
+              else
+                raise UnknownCommand.new("enable #{type}")
+            end
+          end
+
+          def disable(type, name)
+            case type
+              when "component"
+                app_path = PathString.from_application_subdirectory Dir.pwd
+                if app_path
+                  disabled_dir = File.join app_path, "components", "disabled"
+
+                  disabled_component_path = File.join disabled_dir, name
+                  enabled_component_path  = File.join app_path, "components", name
+
+                  Dir.mkdir disabled_dir unless File.directory?(disabled_dir)
+
+                  if File.directory? enabled_component_path
+                    if File.directory?(disabled_component_path)
+                      raise ComponentError.new("There is already a disabled component at #{disabled_component_path}")
+                    else
+                      FileUtils.mv enabled_component_path, disabled_component_path
+                      puts "Disabled component #{name}"
+                    end
+                  else
+                    raise ComponentError.new("Could not find component #{name} at #{enabled_component_path} !")
+                  end
+                else
+                  raise PathInvalid.new(Dir.pwd)
+                end
+              else
+                raise UnknownCommand.new("disable #{type}")
+            end
+          end
+
+          def method_missing(action, *args)
+            raise UnknownCommand, [action, *args] * " "
+          end
+
+          private
+
+        end
+
+        class CLIException < StandardError; end
+
+        class UnknownCommand < CLIException
+          def initialize(cmd)
+            super "Unknown command: #{cmd}"
+          end
+        end
+
+        class ComponentError < CLIException; end
+
+        class UnknownProject < CLIException
+          def initialize(project)
+            super "Application #{project} does not exist! Have you installed it?"
+          end
+        end
+
+        class PathInvalid < CLIException
+          def initialize(path)
+            super "Directory #{path} does not belong to an Adhearsion project!"
+          end
+        end
+      end
+    end
+  end
+end

data/lib/adhearsion/component_manager/component_tester.rb

@@ -0,0 +1,53 @@
+module ComponentTester
+
+  class << self
+
+    ##
+    #
+    #
+    # @return [Module] an anonymous module which includes the ComponentTester module.
+    #
+    def new(component_name, component_directory)
+      component_directory = File.expand_path component_directory
+      main_file = component_directory + "/#{component_name}/#{component_name}.rb"
+
+      component_manager = Adhearsion::Components::ComponentManager.new(component_directory)
+      component_module  = Adhearsion::Components::ComponentManager::ComponentDefinitionContainer.load_file main_file
+
+      Module.new do
+
+        extend ComponentTester
+
+        (class << self; self; end).send(:define_method, :component_manager)   { component_manager   }
+        (class << self; self; end).send(:define_method, :component_name)      { component_name      }
+        (class << self; self; end).send(:define_method, :component_module)    { component_module    }
+        (class << self; self; end).send(:define_method, :component_directory) { component_directory }
+
+
+        define_method(:component_manager)   { component_manager   }
+        define_method(:component_name)      { component_name      }
+        define_method(:component_module)    { component_module    }
+        define_method(:component_directory) { component_directory }
+
+        def self.const_missing(name)
+          component_module.const_get name
+        end
+
+      end
+    end
+  end
+
+  def helper_method(name)
+    Object.new.extend(component_module).method(name)
+  end
+
+  def config
+    component_manager.configuration_for_component_named component_name
+  end
+
+  def initialize!
+    metadata = component_module.metaclass.send(:instance_variable_get, :@metadata)
+    metadata[:initialization_block].call if metadata && metadata[:initialization_block].kind_of?(Proc)
+  end
+
+end

data/lib/adhearsion/component_manager/spec_framework.rb

@@ -0,0 +1,18 @@
+require 'adhearsion/component_manager/component_tester'
+begin
+  require 'rspec'
+rescue LoadError
+  abort "You do not have the 'rspec' gem installed! You must install it to continue.\n\nsudo gem install rspec\n\n"
+end
+
+module ComponentConfigurationSpecHelper
+  def mock_component_config_with(new_config)
+    Object.send(:remove_const, :COMPONENTS) rescue nil
+    Object.send(:const_set, :COMPONENTS, OpenStruct.new(new_config))
+  end
+end
+
+RSpec.configure do |config|
+  config.mock_with :rspec
+  config.include ComponentConfigurationSpecHelper
+end