adhearsion-cw 1.0.2.1

Sign up to get free protection for your applications and to get access to all the features.
Files changed (118) hide show
  1. data/CHANGELOG +109 -0
  2. data/EVENTS +11 -0
  3. data/Gemfile +3 -0
  4. data/LICENSE +456 -0
  5. data/Rakefile +134 -0
  6. data/adhearsion.gemspec +174 -0
  7. data/app_generators/ahn/USAGE +5 -0
  8. data/app_generators/ahn/ahn_generator.rb +97 -0
  9. data/app_generators/ahn/templates/.ahnrc +34 -0
  10. data/app_generators/ahn/templates/Gemfile +7 -0
  11. data/app_generators/ahn/templates/README +8 -0
  12. data/app_generators/ahn/templates/Rakefile +27 -0
  13. data/app_generators/ahn/templates/components/ami_remote/ami_remote.rb +15 -0
  14. data/app_generators/ahn/templates/components/disabled/HOW_TO_ENABLE +7 -0
  15. data/app_generators/ahn/templates/components/disabled/restful_rpc/README.markdown +11 -0
  16. data/app_generators/ahn/templates/components/disabled/restful_rpc/example-client.rb +48 -0
  17. data/app_generators/ahn/templates/components/disabled/restful_rpc/restful_rpc.rb +91 -0
  18. data/app_generators/ahn/templates/components/disabled/restful_rpc/restful_rpc.yml +34 -0
  19. data/app_generators/ahn/templates/components/disabled/restful_rpc/spec/restful_rpc_spec.rb +251 -0
  20. data/app_generators/ahn/templates/components/disabled/sandbox/sandbox.rb +104 -0
  21. data/app_generators/ahn/templates/components/disabled/sandbox/sandbox.yml +2 -0
  22. data/app_generators/ahn/templates/components/disabled/stomp_gateway/README.markdown +47 -0
  23. data/app_generators/ahn/templates/components/disabled/stomp_gateway/stomp_gateway.rb +34 -0
  24. data/app_generators/ahn/templates/components/disabled/stomp_gateway/stomp_gateway.yml +12 -0
  25. data/app_generators/ahn/templates/components/disabled/xmpp_gateway/README.markdown +3 -0
  26. data/app_generators/ahn/templates/components/disabled/xmpp_gateway/xmpp_gateway.rb +11 -0
  27. data/app_generators/ahn/templates/components/disabled/xmpp_gateway/xmpp_gateway.yml +0 -0
  28. data/app_generators/ahn/templates/components/simon_game/simon_game.rb +56 -0
  29. data/app_generators/ahn/templates/config/startup.rb +74 -0
  30. data/app_generators/ahn/templates/dialplan.rb +3 -0
  31. data/app_generators/ahn/templates/events.rb +32 -0
  32. data/bin/ahn +29 -0
  33. data/bin/ahnctl +68 -0
  34. data/bin/jahn +43 -0
  35. data/examples/asterisk_manager_interface/standalone.rb +51 -0
  36. data/lib/adhearsion/cli.rb +296 -0
  37. data/lib/adhearsion/component_manager/component_tester.rb +53 -0
  38. data/lib/adhearsion/component_manager/spec_framework.rb +18 -0
  39. data/lib/adhearsion/component_manager.rb +272 -0
  40. data/lib/adhearsion/events_support.rb +84 -0
  41. data/lib/adhearsion/foundation/all.rb +15 -0
  42. data/lib/adhearsion/foundation/blank_slate.rb +3 -0
  43. data/lib/adhearsion/foundation/custom_daemonizer.rb +45 -0
  44. data/lib/adhearsion/foundation/event_socket.rb +205 -0
  45. data/lib/adhearsion/foundation/future_resource.rb +36 -0
  46. data/lib/adhearsion/foundation/metaprogramming.rb +17 -0
  47. data/lib/adhearsion/foundation/numeric.rb +13 -0
  48. data/lib/adhearsion/foundation/pseudo_guid.rb +10 -0
  49. data/lib/adhearsion/foundation/relationship_properties.rb +42 -0
  50. data/lib/adhearsion/foundation/string.rb +26 -0
  51. data/lib/adhearsion/foundation/synchronized_hash.rb +96 -0
  52. data/lib/adhearsion/foundation/thread_safety.rb +7 -0
  53. data/lib/adhearsion/host_definitions.rb +67 -0
  54. data/lib/adhearsion/initializer/asterisk.rb +87 -0
  55. data/lib/adhearsion/initializer/configuration.rb +321 -0
  56. data/lib/adhearsion/initializer/database.rb +60 -0
  57. data/lib/adhearsion/initializer/drb.rb +31 -0
  58. data/lib/adhearsion/initializer/freeswitch.rb +22 -0
  59. data/lib/adhearsion/initializer/ldap.rb +57 -0
  60. data/lib/adhearsion/initializer/rails.rb +41 -0
  61. data/lib/adhearsion/initializer/xmpp.rb +42 -0
  62. data/lib/adhearsion/initializer.rb +394 -0
  63. data/lib/adhearsion/logging.rb +92 -0
  64. data/lib/adhearsion/tasks/components.rb +32 -0
  65. data/lib/adhearsion/tasks/database.rb +5 -0
  66. data/lib/adhearsion/tasks/deprecations.rb +59 -0
  67. data/lib/adhearsion/tasks/generating.rb +20 -0
  68. data/lib/adhearsion/tasks/lint.rb +4 -0
  69. data/lib/adhearsion/tasks/testing.rb +37 -0
  70. data/lib/adhearsion/tasks.rb +17 -0
  71. data/lib/adhearsion/version.rb +35 -0
  72. data/lib/adhearsion/voip/asterisk/agi_server.rb +115 -0
  73. data/lib/adhearsion/voip/asterisk/commands.rb +1581 -0
  74. data/lib/adhearsion/voip/asterisk/config_generators/agents.conf.rb +140 -0
  75. data/lib/adhearsion/voip/asterisk/config_generators/config_generator.rb +102 -0
  76. data/lib/adhearsion/voip/asterisk/config_generators/queues.conf.rb +250 -0
  77. data/lib/adhearsion/voip/asterisk/config_generators/voicemail.conf.rb +240 -0
  78. data/lib/adhearsion/voip/asterisk/config_manager.rb +71 -0
  79. data/lib/adhearsion/voip/asterisk/manager_interface/ami_lexer.rb +1681 -0
  80. data/lib/adhearsion/voip/asterisk/manager_interface/ami_lexer.rl.rb +341 -0
  81. data/lib/adhearsion/voip/asterisk/manager_interface/ami_messages.rb +78 -0
  82. data/lib/adhearsion/voip/asterisk/manager_interface/ami_protocol_lexer_machine.rl +87 -0
  83. data/lib/adhearsion/voip/asterisk/manager_interface.rb +705 -0
  84. data/lib/adhearsion/voip/asterisk/special_dial_plan_managers.rb +80 -0
  85. data/lib/adhearsion/voip/asterisk/super_manager.rb +19 -0
  86. data/lib/adhearsion/voip/asterisk.rb +4 -0
  87. data/lib/adhearsion/voip/call.rb +498 -0
  88. data/lib/adhearsion/voip/call_routing.rb +64 -0
  89. data/lib/adhearsion/voip/commands.rb +9 -0
  90. data/lib/adhearsion/voip/constants.rb +39 -0
  91. data/lib/adhearsion/voip/conveniences.rb +18 -0
  92. data/lib/adhearsion/voip/dial_plan.rb +250 -0
  93. data/lib/adhearsion/voip/dsl/dialing_dsl/dialing_dsl_monkey_patches.rb +37 -0
  94. data/lib/adhearsion/voip/dsl/dialing_dsl.rb +151 -0
  95. data/lib/adhearsion/voip/dsl/dialplan/control_passing_exception.rb +27 -0
  96. data/lib/adhearsion/voip/dsl/dialplan/dispatcher.rb +124 -0
  97. data/lib/adhearsion/voip/dsl/dialplan/parser.rb +69 -0
  98. data/lib/adhearsion/voip/dsl/dialplan/thread_mixin.rb +16 -0
  99. data/lib/adhearsion/voip/dsl/numerical_string.rb +128 -0
  100. data/lib/adhearsion/voip/freeswitch/basic_connection_manager.rb +48 -0
  101. data/lib/adhearsion/voip/freeswitch/event_handler.rb +58 -0
  102. data/lib/adhearsion/voip/freeswitch/freeswitch_dialplan_command_factory.rb +129 -0
  103. data/lib/adhearsion/voip/freeswitch/inbound_connection_manager.rb +38 -0
  104. data/lib/adhearsion/voip/freeswitch/oes_server.rb +195 -0
  105. data/lib/adhearsion/voip/menu_state_machine/calculated_match.rb +80 -0
  106. data/lib/adhearsion/voip/menu_state_machine/matchers.rb +123 -0
  107. data/lib/adhearsion/voip/menu_state_machine/menu_builder.rb +57 -0
  108. data/lib/adhearsion/voip/menu_state_machine/menu_class.rb +149 -0
  109. data/lib/adhearsion/xmpp/connection.rb +61 -0
  110. data/lib/adhearsion.rb +46 -0
  111. data/lib/theatre/README.markdown +64 -0
  112. data/lib/theatre/callback_definition_loader.rb +84 -0
  113. data/lib/theatre/guid.rb +23 -0
  114. data/lib/theatre/invocation.rb +121 -0
  115. data/lib/theatre/namespace_manager.rb +153 -0
  116. data/lib/theatre/version.rb +2 -0
  117. data/lib/theatre.rb +151 -0
  118. metadata +323 -0
@@ -0,0 +1,92 @@
1
+ require 'log4r'
2
+
3
+ module Adhearsion
4
+ module Logging
5
+
6
+ @@logging_level_lock = Mutex.new
7
+
8
+ class << self
9
+
10
+ def silence!
11
+ self.logging_level = :fatal
12
+ end
13
+
14
+ def unsilence!
15
+ self.logging_level = :info
16
+ end
17
+
18
+ def logging_level=(new_logging_level)
19
+ new_logging_level = Log4r.const_get(new_logging_level.to_s.upcase)
20
+ @@logging_level_lock.synchronize do
21
+ @@logging_level = new_logging_level
22
+ Log4r::Logger.each_logger do |logger|
23
+ logger.level = new_logging_level
24
+ end
25
+ end
26
+ end
27
+
28
+ def logging_level
29
+ @@logging_level_lock.synchronize do
30
+ return @@logging_level ||= Log4r::INFO
31
+ end
32
+ end
33
+ end
34
+
35
+ class AdhearsionLogger < Log4r::Logger
36
+
37
+ @@outputters = [Log4r::Outputter.stdout]
38
+
39
+ class << self
40
+ def outputters
41
+ @@outputters
42
+ end
43
+
44
+ def outputters=(other)
45
+ @@outputters = other
46
+ end
47
+ end
48
+
49
+ def initialize(*args)
50
+ super
51
+ redefine_outputters
52
+ end
53
+
54
+ def redefine_outputters
55
+ self.outputters = @@outputters
56
+ end
57
+
58
+ def method_missing(logger_name, *args, &block)
59
+ define_logging_method(logger_name, self.class.new(logger_name.to_s))
60
+ send(logger_name, *args, &block)
61
+ end
62
+
63
+ private
64
+
65
+ def define_logging_method(name, logger)
66
+ # Can't use Module#define_method() because blocks in Ruby 1.8.x can't
67
+ # have their own block arguments.
68
+ self.class.class_eval(<<-CODE, __FILE__, __LINE__)
69
+ def #{name}(*args, &block)
70
+ logger = Log4r::Logger['#{name}']
71
+ if args.any? || block_given?
72
+ logger.info(*args, &block)
73
+ else
74
+ logger
75
+ end
76
+ end
77
+ CODE
78
+ end
79
+ end
80
+
81
+ DefaultAdhearsionLogger = AdhearsionLogger.new 'ahn'
82
+
83
+ end
84
+ end
85
+
86
+ def ahn_log(*args)
87
+ if args.any?
88
+ Adhearsion::Logging::DefaultAdhearsionLogger.info(*args)
89
+ else
90
+ Adhearsion::Logging::DefaultAdhearsionLogger
91
+ end
92
+ end
@@ -0,0 +1,32 @@
1
+ namespace:components do
2
+ desc "Install component configuration from templates"
3
+ task :genconfig do
4
+ init = Adhearsion::Initializer.new(Rake.original_dir)
5
+ init.bootstrap_rc
6
+ init.load_all_init_files
7
+ Adhearsion::AHN_CONFIG.components_to_load.each do |component|
8
+ spec = Gem.searcher.find(component)
9
+ if spec.nil?
10
+ abort "ERROR: Required gem component #{component} not found."
11
+ end
12
+
13
+ yml = File.join(spec.full_gem_path, 'config', "#{component}.yml")
14
+ target = File.join(AHN_ROOT, 'config', 'components', "#{component}.yml")
15
+ Dir.mkdir(File.dirname(target)) if !File.exists?(File.dirname(target))
16
+ if File.exists?(target)
17
+ puts "Skipping existing configuration for component #{component}"
18
+ next
19
+ end
20
+ if File.exists?(yml)
21
+ begin
22
+ FileUtils.cp(yml, target)
23
+ puts "Installed default configuration for component #{component}"
24
+ rescue => e
25
+ abort "Error copying configuration for component #{component}: #{e.message}"
26
+ end
27
+ else
28
+ puts "No template configuration found for component #{component}"
29
+ end
30
+ end
31
+ end
32
+ end
@@ -0,0 +1,5 @@
1
+ task:migrate do
2
+ require 'active_record'
3
+ %w.db/migrate db/ahn..each
4
+ ActiveRecord::Migrator.migrate 'db/migrate', ENV['VERSION'] ? ENV['VERSION'].to_i : nil
5
+ end
@@ -0,0 +1,59 @@
1
+ namespace :deprecations do
2
+ desc <<-DESC
3
+ Older versions of Adhearsion had an .ahnrc "paths" section similar to the following...
4
+
5
+ paths:
6
+ models:
7
+ directory: models
8
+ pattern: *.rb
9
+
10
+ This has been deprecated. The new format is this:
11
+
12
+ paths:
13
+ models: {models,gui/app/models}/*.rb
14
+
15
+ This Rake task will fix your .ahnrc if you have
16
+ DESC
17
+ task :fix_ahnrc_path_format do
18
+ puts "\nThis will remove all comments from your .ahnrc file. A backup will be created as .ahnrc.backup."
19
+ puts "If you wish to do this manually to preserve your comments, simply overwrite .ahnrc with .ahnrc.backup"
20
+ puts "and apply the change manually."
21
+ puts
22
+
23
+ require 'fileutils'
24
+ require 'yaml'
25
+
26
+ ahnrc_file = File.expand_path(".ahnrc")
27
+
28
+ FileUtils.cp ahnrc_file, ahnrc_file + ".backup"
29
+ ahnrc_contents = YAML.load_file ahnrc_file
30
+
31
+ abort '.ahnrc does not have a "paths" section!' unless ahnrc_contents.has_key? "paths"
32
+
33
+ paths = ahnrc_contents["paths"]
34
+ paths.clone.each_pair do |key,value|
35
+ if value.kind_of?(Hash)
36
+ if value.has_key?("directory") || value.has_key?("pattern")
37
+ directory, pattern = value.values_at "directory", "pattern"
38
+ new_path = "#{directory}/#{pattern}"
39
+
40
+ puts "!!! CHANGING KEY #{key.inspect}!"
41
+ puts "!!! NEW: #{new_path.inspect}"
42
+ puts "!!! OLD:\n#{{key => value}.to_yaml.sub("---", "")}\n\n"
43
+
44
+ paths[key] = new_path
45
+ end
46
+ end
47
+ end
48
+
49
+ ahnrc_contents["paths"] = paths
50
+ new_yaml = ahnrc_contents.to_yaml.gsub("--- \n", "")
51
+
52
+ puts "New .ahnrc file:\n" + ("#" * 25) + "\n"
53
+ puts new_yaml
54
+ puts '#' * 25
55
+
56
+ File.open(ahnrc_file, "w") { |file| file.puts new_yaml }
57
+ puts "Wrote to .ahnrc. Done!"
58
+ end
59
+ end
@@ -0,0 +1,20 @@
1
+ namespace:create do
2
+
3
+ task:war do
4
+ # Hmm, this will is a tough one
5
+ end
6
+
7
+ task:rails_plugin do
8
+
9
+ end
10
+
11
+ task:migration do
12
+ name = ARGV.shift
13
+ end
14
+ end
15
+
16
+ namespace:delete do
17
+ task:migration do
18
+ # Take arg.underscore and remove it
19
+ end
20
+ end
@@ -0,0 +1,4 @@
1
+ task :sanity do
2
+ puts "Performing many checks on your Adhearsion application!"
3
+ # TODO: Anything that should be brought to the user's attention should be placed here!
4
+ end
@@ -0,0 +1,37 @@
1
+ namespace:test do
2
+ desc "Run tests for a component specified by COMPONENT=<component_name>. If no component is specified, tests will be executed for all components"
3
+ task :component do
4
+ component = ENV['COMPONENT']
5
+ components_to_test = component.nil? ? all_component_directories : [full_path_for(component)]
6
+ components_to_test.each do |component_name|
7
+ setup_and_execute(component_name)
8
+ end
9
+ end
10
+
11
+ private
12
+
13
+ def setup_and_execute(component_path)
14
+ task = create_test_task_for(component_path)
15
+ Rake::Task[task.name].execute
16
+ end
17
+
18
+ def create_test_task_for(component_path)
19
+ Rake::TestTask.new(task_name_for(component_path)) do |t|
20
+ t.libs = ["lib", "test"].map{|subdir| File.join(component_path, subdir)}
21
+ t.test_files = FileList["#{component_path}/test/test_*.rb"]
22
+ t.verbose = true
23
+ end
24
+ end
25
+
26
+ def task_name_for(component_path)
27
+ "test_#{component_path.split(/\//).last}"
28
+ end
29
+
30
+ def all_component_directories
31
+ Dir['components/*']
32
+ end
33
+
34
+ def full_path_for(component)
35
+ component =~ /^components\// ? component : File.join("components", component)
36
+ end
37
+ end
@@ -0,0 +1,17 @@
1
+ require 'rake/testtask'
2
+ require 'adhearsion'
3
+ require 'adhearsion/tasks/components'
4
+ require 'adhearsion/tasks/database'
5
+ require 'adhearsion/tasks/testing'
6
+ require 'adhearsion/tasks/generating'
7
+ require 'adhearsion/tasks/lint'
8
+ require 'adhearsion/tasks/deprecations'
9
+
10
+ namespace :adhearsion do
11
+ desc "Dump useful information about this application's adhearsion environment"
12
+ task :about do
13
+ puts "Adhearsion version: #{Adhearsion::VERSION::STRING}"
14
+ end
15
+ end
16
+
17
+ task :default => "adhearsion:about"
@@ -0,0 +1,35 @@
1
+ module Adhearsion #:nodoc:
2
+ module VERSION #:nodoc:
3
+ MAJOR = 1 unless defined? MAJOR
4
+ MINOR = 0 unless defined? MINOR
5
+ TINY = 2 unless defined? TINY
6
+ NANO = 1 unless defined? NANO
7
+
8
+ STRING = [MAJOR, MINOR, TINY, NANO].join('.') unless defined? STRING
9
+ end
10
+
11
+ class PkgVersion
12
+ include Comparable
13
+
14
+ attr_reader :major, :minor, :revision, :build
15
+
16
+ def initialize(version="")
17
+ @major, @minor, @revision, @build = version.split(".").map(&:to_i)
18
+ end
19
+
20
+ def <=>(other)
21
+ return @major <=> other.major if ((@major <=> other.major) != 0)
22
+ return @minor <=> other.minor if ((@minor <=> other.minor) != 0)
23
+ return @revision <=> other.revision if ((@revision <=> other.revision) != 0)
24
+ return @build <=> other.build if ((@build <=> other.build) != 0)
25
+ end
26
+
27
+ def self.sort
28
+ self.sort!{|a,b| a <=> b}
29
+ end
30
+
31
+ def to_s
32
+ @major.to_s + "." + @minor.to_s + "." + @revision.to_s + "." + @build.to_s
33
+ end
34
+ end
35
+ end
@@ -0,0 +1,115 @@
1
+ require 'gserver'
2
+ module Adhearsion
3
+ module VoIP
4
+ module Asterisk
5
+ module AGI
6
+ class Server
7
+
8
+ class RubyServer < GServer
9
+
10
+ def initialize(port, host)
11
+ super(port, host, (1.0/0.0)) # (1.0/0.0) == Infinity
12
+ end
13
+
14
+ def disconnecting(port)
15
+ @call.deliver_message :cancel if !@call.nil?
16
+ super(port)
17
+ end
18
+
19
+ def serve(io)
20
+ begin
21
+ call = Adhearsion.receive_call_from(io)
22
+ rescue EOFError
23
+ # We didn't get the initial headers we were expecting
24
+ return
25
+ end
26
+
27
+ Events.trigger_immediately([:asterisk, :before_call], call)
28
+ ahn_log.agi.debug "Handling call with variables #{call.variables.inspect}"
29
+
30
+ return DialPlan::ConfirmationManager.handle(call) if DialPlan::ConfirmationManager.confirmation_call?(call)
31
+
32
+ # This is what happens 99.9% of the time.
33
+
34
+ DialPlan::Manager.handle call
35
+ rescue Hangup
36
+ ahn_log.agi "HANGUP event for call with uniqueid #{call.variables[:uniqueid].inspect} and channel #{call.variables[:channel].inspect}"
37
+ Events.trigger_immediately([:asterisk, :after_call], call)
38
+ call.hangup!
39
+ rescue DialPlan::Manager::NoContextError => e
40
+ ahn_log.agi e.message
41
+ call.hangup!
42
+ rescue FailedExtensionCallException => failed_call
43
+ begin
44
+ ahn_log.agi "Received \"failed\" meta-call with :failed_reason => #{failed_call.call.failed_reason.inspect}. Executing Executing /asterisk/failed_call event callbacks."
45
+ Events.trigger [:asterisk, :failed_call], failed_call.call
46
+ call.hangup!
47
+ rescue => e
48
+ ahn_log.agi.error e
49
+ end
50
+ rescue HungupExtensionCallException => hungup_call
51
+ begin
52
+ ahn_log.agi "Received \"h\" meta-call. Executing /asterisk/hungup_call event callbacks."
53
+ Events.trigger [:asterisk, :hungup_call], hungup_call.call
54
+ call.hangup!
55
+ rescue => e
56
+ ahn_log.agi.error e
57
+ end
58
+ rescue UselessCallException
59
+ ahn_log.agi "Ignoring meta-AGI request"
60
+ call.hangup!
61
+ # TBD: (may have more hooks than what Jay has defined in hooks.rb)
62
+ rescue => e
63
+ ahn_log.agi.error "#{e.class}: #{e.message}"
64
+ ahn_log.agi.error e.backtrace.join("\n\t")
65
+ ensure
66
+ Adhearsion.remove_inactive_call call rescue nil
67
+ end
68
+
69
+ end
70
+
71
+ DEFAULT_OPTIONS = { :server_class => RubyServer, :port => 4573, :host => "0.0.0.0" } unless defined? DEFAULT_OPTIONS
72
+ attr_reader :host, :port, :server_class, :server
73
+
74
+ def initialize(options = {})
75
+ options = DEFAULT_OPTIONS.merge options
76
+ @host, @port, @server_class = options.values_at(:host, :port, :server_class)
77
+ @server = server_class.new(port, host)
78
+ end
79
+
80
+ def start
81
+ server.audit = true
82
+ server.start
83
+ end
84
+
85
+ def graceful_shutdown
86
+ if @shutting_down
87
+ server.stop
88
+ return
89
+ end
90
+
91
+ @shutting_down = true
92
+
93
+ while server.connections > 0
94
+ sleep 0.2
95
+ end
96
+
97
+ server.stop
98
+ end
99
+
100
+ def shutdown
101
+ server.shutdown
102
+ end
103
+
104
+ def stop
105
+ server.stop
106
+ end
107
+
108
+ def join
109
+ server.join
110
+ end
111
+ end
112
+ end
113
+ end
114
+ end
115
+ end