mtrudel-adhearsion 0.8.3

Sign up to get free protection for your applications and to get access to all the features.
Files changed (110) hide show
  1. data/CHANGELOG +26 -0
  2. data/EVENTS +11 -0
  3. data/LICENSE +456 -0
  4. data/Rakefile +127 -0
  5. data/adhearsion.gemspec +149 -0
  6. data/app_generators/ahn/USAGE +5 -0
  7. data/app_generators/ahn/ahn_generator.rb +91 -0
  8. data/app_generators/ahn/templates/.ahnrc +34 -0
  9. data/app_generators/ahn/templates/README +8 -0
  10. data/app_generators/ahn/templates/Rakefile +25 -0
  11. data/app_generators/ahn/templates/components/ami_remote/ami_remote.rb +15 -0
  12. data/app_generators/ahn/templates/components/disabled/HOW_TO_ENABLE +7 -0
  13. data/app_generators/ahn/templates/components/disabled/restful_rpc/README.markdown +11 -0
  14. data/app_generators/ahn/templates/components/disabled/restful_rpc/example-client.rb +48 -0
  15. data/app_generators/ahn/templates/components/disabled/restful_rpc/restful_rpc.rb +87 -0
  16. data/app_generators/ahn/templates/components/disabled/restful_rpc/restful_rpc.yml +34 -0
  17. data/app_generators/ahn/templates/components/disabled/restful_rpc/spec/restful_rpc_spec.rb +263 -0
  18. data/app_generators/ahn/templates/components/disabled/sandbox/sandbox.rb +104 -0
  19. data/app_generators/ahn/templates/components/disabled/sandbox/sandbox.yml +2 -0
  20. data/app_generators/ahn/templates/components/disabled/stomp_gateway/README.markdown +47 -0
  21. data/app_generators/ahn/templates/components/disabled/stomp_gateway/stomp_gateway.rb +34 -0
  22. data/app_generators/ahn/templates/components/disabled/stomp_gateway/stomp_gateway.yml +12 -0
  23. data/app_generators/ahn/templates/components/simon_game/simon_game.rb +56 -0
  24. data/app_generators/ahn/templates/config/startup.rb +50 -0
  25. data/app_generators/ahn/templates/dialplan.rb +3 -0
  26. data/app_generators/ahn/templates/events.rb +32 -0
  27. data/bin/ahn +28 -0
  28. data/bin/ahnctl +68 -0
  29. data/bin/jahn +42 -0
  30. data/examples/asterisk_manager_interface/standalone.rb +51 -0
  31. data/lib/adhearsion.rb +37 -0
  32. data/lib/adhearsion/cli.rb +223 -0
  33. data/lib/adhearsion/component_manager.rb +207 -0
  34. data/lib/adhearsion/component_manager/component_tester.rb +55 -0
  35. data/lib/adhearsion/component_manager/spec_framework.rb +24 -0
  36. data/lib/adhearsion/events_support.rb +84 -0
  37. data/lib/adhearsion/foundation/all.rb +9 -0
  38. data/lib/adhearsion/foundation/blank_slate.rb +5 -0
  39. data/lib/adhearsion/foundation/custom_daemonizer.rb +45 -0
  40. data/lib/adhearsion/foundation/event_socket.rb +203 -0
  41. data/lib/adhearsion/foundation/future_resource.rb +36 -0
  42. data/lib/adhearsion/foundation/global.rb +1 -0
  43. data/lib/adhearsion/foundation/metaprogramming.rb +17 -0
  44. data/lib/adhearsion/foundation/numeric.rb +13 -0
  45. data/lib/adhearsion/foundation/pseudo_guid.rb +10 -0
  46. data/lib/adhearsion/foundation/relationship_properties.rb +42 -0
  47. data/lib/adhearsion/foundation/string.rb +26 -0
  48. data/lib/adhearsion/foundation/synchronized_hash.rb +96 -0
  49. data/lib/adhearsion/foundation/thread_safety.rb +7 -0
  50. data/lib/adhearsion/host_definitions.rb +67 -0
  51. data/lib/adhearsion/initializer.rb +373 -0
  52. data/lib/adhearsion/initializer/asterisk.rb +81 -0
  53. data/lib/adhearsion/initializer/configuration.rb +254 -0
  54. data/lib/adhearsion/initializer/database.rb +50 -0
  55. data/lib/adhearsion/initializer/drb.rb +31 -0
  56. data/lib/adhearsion/initializer/freeswitch.rb +22 -0
  57. data/lib/adhearsion/initializer/rails.rb +41 -0
  58. data/lib/adhearsion/logging.rb +92 -0
  59. data/lib/adhearsion/tasks.rb +16 -0
  60. data/lib/adhearsion/tasks/database.rb +5 -0
  61. data/lib/adhearsion/tasks/deprecations.rb +59 -0
  62. data/lib/adhearsion/tasks/generating.rb +20 -0
  63. data/lib/adhearsion/tasks/lint.rb +4 -0
  64. data/lib/adhearsion/tasks/testing.rb +37 -0
  65. data/lib/adhearsion/version.rb +9 -0
  66. data/lib/adhearsion/voip/asterisk.rb +4 -0
  67. data/lib/adhearsion/voip/asterisk/agi_server.rb +84 -0
  68. data/lib/adhearsion/voip/asterisk/commands.rb +1314 -0
  69. data/lib/adhearsion/voip/asterisk/config_generators/agents.conf.rb +140 -0
  70. data/lib/adhearsion/voip/asterisk/config_generators/config_generator.rb +101 -0
  71. data/lib/adhearsion/voip/asterisk/config_generators/queues.conf.rb +250 -0
  72. data/lib/adhearsion/voip/asterisk/config_generators/voicemail.conf.rb +240 -0
  73. data/lib/adhearsion/voip/asterisk/config_manager.rb +71 -0
  74. data/lib/adhearsion/voip/asterisk/manager_interface.rb +597 -0
  75. data/lib/adhearsion/voip/asterisk/manager_interface/ami_lexer.rb +1589 -0
  76. data/lib/adhearsion/voip/asterisk/manager_interface/ami_lexer.rl.rb +286 -0
  77. data/lib/adhearsion/voip/asterisk/manager_interface/ami_messages.rb +78 -0
  78. data/lib/adhearsion/voip/asterisk/manager_interface/ami_protocol_lexer_machine.rl +87 -0
  79. data/lib/adhearsion/voip/asterisk/special_dial_plan_managers.rb +80 -0
  80. data/lib/adhearsion/voip/asterisk/super_manager.rb +19 -0
  81. data/lib/adhearsion/voip/call.rb +453 -0
  82. data/lib/adhearsion/voip/call_routing.rb +64 -0
  83. data/lib/adhearsion/voip/commands.rb +9 -0
  84. data/lib/adhearsion/voip/constants.rb +39 -0
  85. data/lib/adhearsion/voip/conveniences.rb +18 -0
  86. data/lib/adhearsion/voip/dial_plan.rb +218 -0
  87. data/lib/adhearsion/voip/dsl/dialing_dsl.rb +151 -0
  88. data/lib/adhearsion/voip/dsl/dialing_dsl/dialing_dsl_monkey_patches.rb +37 -0
  89. data/lib/adhearsion/voip/dsl/dialplan/control_passing_exception.rb +27 -0
  90. data/lib/adhearsion/voip/dsl/dialplan/dispatcher.rb +124 -0
  91. data/lib/adhearsion/voip/dsl/dialplan/parser.rb +71 -0
  92. data/lib/adhearsion/voip/dsl/dialplan/thread_mixin.rb +16 -0
  93. data/lib/adhearsion/voip/dsl/numerical_string.rb +117 -0
  94. data/lib/adhearsion/voip/freeswitch/basic_connection_manager.rb +48 -0
  95. data/lib/adhearsion/voip/freeswitch/event_handler.rb +58 -0
  96. data/lib/adhearsion/voip/freeswitch/freeswitch_dialplan_command_factory.rb +129 -0
  97. data/lib/adhearsion/voip/freeswitch/inbound_connection_manager.rb +38 -0
  98. data/lib/adhearsion/voip/freeswitch/oes_server.rb +195 -0
  99. data/lib/adhearsion/voip/menu_state_machine/calculated_match.rb +80 -0
  100. data/lib/adhearsion/voip/menu_state_machine/matchers.rb +123 -0
  101. data/lib/adhearsion/voip/menu_state_machine/menu_builder.rb +58 -0
  102. data/lib/adhearsion/voip/menu_state_machine/menu_class.rb +149 -0
  103. data/lib/theatre.rb +151 -0
  104. data/lib/theatre/README.markdown +64 -0
  105. data/lib/theatre/callback_definition_loader.rb +84 -0
  106. data/lib/theatre/guid.rb +23 -0
  107. data/lib/theatre/invocation.rb +121 -0
  108. data/lib/theatre/namespace_manager.rb +153 -0
  109. data/lib/theatre/version.rb +2 -0
  110. metadata +182 -0
@@ -0,0 +1,42 @@
1
+ #!/usr/bin/env jruby
2
+
3
+ # This "jahn" script is "ahn" for JRUBY!
4
+
5
+ # Adhearsion, open source collaboration framework
6
+ # Copyright (C) 2006,2007,2008 Jay Phillips
7
+ #
8
+ # This library is free software; you can redistribute it and/or modify it under
9
+ # the terms of the GNU Lesser General Public License as published by the Free
10
+ # Software Foundation; either version 2.1 of the License, or (at your option)
11
+ # any later version.
12
+ #
13
+ # This library is distributed in the hope that it will be useful, but WITHOUT
14
+ # ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
15
+ # FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more
16
+ # details.
17
+ #
18
+ # You should have received a copy of the GNU Lesser General Public License along
19
+ # with this library; if not, write to the Free Software Foundation, Inc.,
20
+ # 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
21
+
22
+ $:.unshift File.expand_path(File.dirname(__FILE__) + "/../lib")
23
+
24
+ require 'rubygems'
25
+ require 'adhearsion'
26
+ require 'adhearsion/cli'
27
+
28
+ # jahn will soon have JRuby-specific behavior such as creating a compiled .jar
29
+ # file from an app.
30
+ # require 'adhearsion/jruby'
31
+
32
+ abort(<<-MESSAGE) unless RUBY_PLATFORM =~ /java/
33
+ You must use jahn with JRuby! Are you running this script after installing Adhearsion with non-JRuby RubyGems?
34
+
35
+ If you don't want to install Adhearsion with the JRuby version of RubyGems, try running jahn directly with an absolute path:
36
+
37
+ #{File.expand_path(__FILE__)} start your_app_name
38
+
39
+ Note: You must have the jruby executable in your $PATH and $JRUBY_HOME set.
40
+ MESSAGE
41
+
42
+ Adhearsion::CLI::AhnCommand.execute!
@@ -0,0 +1,51 @@
1
+ # This is a file which shows you how to use the Asterisk Manager Interface library in a standalone Ruby script.
2
+
3
+ PATH_TO_ADHEARSION = File.join(File.dirname(__FILE__), "/../..")
4
+
5
+ MANAGER_CONNECTION_INFORMATION = {
6
+ :host => "10.0.1.97",
7
+ :username => "jicksta",
8
+ :password => "roflcopter",
9
+ :events => true
10
+ }
11
+
12
+ require 'rubygems'
13
+ begin
14
+ require 'adhearsion'
15
+ rescue LoadError
16
+ begin
17
+ require File.join(PATH_TO_ADHEARSION, "/lib/adhearsion")
18
+ rescue LoadError
19
+ abort "Could not find Adhearsion! Please update the PATH_TO_ADHEARSION constant in this file"
20
+ end
21
+ end
22
+
23
+ require 'adhearsion/voip/asterisk/manager_interface'
24
+
25
+ # If you'd like to see the AMI protocol data, change this to :debug
26
+ Adhearsion::Logging.logging_level = :warn
27
+
28
+ # This makes addressing the ManagerInterface class a little cleaner
29
+ include Adhearsion::VoIP::Asterisk::Manager
30
+
31
+ # Let's instantiate a new ManagerInterface object and have it automatically connect using the Hash we defined above.
32
+ interface = ManagerInterface.connect MANAGER_CONNECTION_INFORMATION
33
+
34
+ # Send an AMI action with our new ManagerInterface object. This will return an Array of SIPPeer events.
35
+ sip_peers = interface.send_action "SIPPeers"
36
+
37
+ # Pretty-print the SIP peers on the server
38
+
39
+ if sip_peers.any?
40
+ sip_peers.each do |peer|
41
+ # Uncomment the following line to view all the headers for each peer.
42
+ # p peer.headers
43
+
44
+ peer_name = peer.headers["ObjectName"]
45
+ peer_status = peer.headers["Status"]
46
+
47
+ puts "#{peer_name}: #{peer_status}"
48
+ end
49
+ else
50
+ puts "This Asterisk server has no SIP peers!"
51
+ end
@@ -0,0 +1,37 @@
1
+ # Check the Ruby version
2
+ STDERR.puts "WARNING: You are running Adhearsion in an unsupported
3
+ version of Ruby (Ruby #{RUBY_VERSION} #{RUBY_RELEASE_DATE})!
4
+ Please upgrade to at least Ruby v1.8.5." if RUBY_VERSION < "1.8.5"
5
+
6
+ $: << File.expand_path(File.dirname(__FILE__))
7
+
8
+ require 'rubygems'
9
+
10
+ require 'adhearsion/version'
11
+ require 'adhearsion/voip/call'
12
+ require 'adhearsion/voip/dial_plan'
13
+ require 'adhearsion/voip/asterisk/special_dial_plan_managers'
14
+ require 'adhearsion/foundation/all'
15
+ require 'adhearsion/events_support'
16
+ require 'adhearsion/logging'
17
+ require 'adhearsion/component_manager'
18
+ require 'adhearsion/initializer/configuration'
19
+ require 'adhearsion/initializer'
20
+ require 'adhearsion/voip/dsl/numerical_string'
21
+ require 'adhearsion/voip/dsl/dialplan/parser'
22
+ require 'adhearsion/voip/commands'
23
+ require 'adhearsion/voip/asterisk/commands'
24
+ require 'adhearsion/voip/dsl/dialing_dsl'
25
+ require 'adhearsion/voip/call_routing'
26
+
27
+ module Adhearsion
28
+ # Sets up the Gem require path.
29
+ AHN_INSTALL_DIR = File.expand_path(File.dirname(__FILE__) + "/..")
30
+ AHN_CONFIG = Configuration.new
31
+
32
+ ##
33
+ # This Array holds all the Threads whose life matters. Adhearsion will not exit until all of these have died.
34
+ #
35
+ IMPORTANT_THREADS = []
36
+
37
+ end
@@ -0,0 +1,223 @@
1
+ require 'fileutils'
2
+
3
+ module Adhearsion
4
+ module CLI
5
+ module AhnCommand
6
+ USAGE = <<USAGE
7
+ Usage:
8
+ ahn create /path/to/directory
9
+ ahn start [daemon] [/path/to/directory]
10
+ ahn version|-v|--v|-version|--version
11
+ ahn help|-h|--h|--help|-help
12
+
13
+ ahn enable component COMPONENT_NAME
14
+ ahn disable component COMPONENT_NAME
15
+ ahn create component COMPONENT_NAME
16
+ USAGE
17
+
18
+ def self.execute!
19
+ CommandHandler.send(*parse_arguments)
20
+ rescue CommandHandler::CLIException => error
21
+ fail_and_print_usage error
22
+ end
23
+
24
+ ##
25
+ # Provides a small abstraction of Kernel::abort().
26
+ #
27
+ def self.fail_and_print_usage(error)
28
+ Kernel.abort "#{error.message}\n\n#{USAGE}"
29
+ end
30
+
31
+ def self.parse_arguments(args=ARGV.clone)
32
+ action = args.shift
33
+ case action
34
+ when /^-?-?h(elp)?$/, nil then [:help]
35
+ when /^-?-?v(ersion)?$/ then [:version]
36
+ when "create"
37
+ [:create, *args]
38
+ when 'start'
39
+ pid_file_regexp = /^--pid-file=(.+)$/
40
+ if args.size > 3
41
+ fail_and_print_usage "Too many arguments supplied!" if args.size > 3
42
+ elsif args.size == 3
43
+ fail_and_print_usage "Unrecognized final argument #{args.last}" unless args.last =~ pid_file_regexp
44
+ pid_file = args.pop[pid_file_regexp, 1]
45
+ else
46
+ pid_file = nil
47
+ end
48
+
49
+ if args.first == 'daemon' && args.size == 2
50
+ path = args.last
51
+ daemon = true
52
+ elsif args.size == 1
53
+ path, daemon = args.first, false
54
+ else
55
+ fail_and_print_usage "Invalid format for the start CLI command!"
56
+ end
57
+ [:start, path, daemon, pid_file]
58
+ when '-'
59
+ [:start, Dir.pwd]
60
+ when "enable", "disable"
61
+ if args.size == 1
62
+ raise CommandHandler::UnknownCommand, "Must supply an argument for what you wish to #{action}"
63
+ elsif args.size == 2
64
+ [action, *args]
65
+ else
66
+ raise CommandHandler::UnknownCommand, "Too many arguments supplied!"
67
+ end
68
+ else
69
+ [action, *args]
70
+ end
71
+ end
72
+
73
+ module CommandHandler
74
+ class << self
75
+
76
+ def create(*args)
77
+ if args.size.zero?
78
+ raise CommandHandler::UnknownCommand.new("Must specify something to create!")
79
+ elsif args.size == 1
80
+ # We're creating a project
81
+ path = args.first
82
+ require 'rubigen'
83
+ require 'rubigen/scripts/generate'
84
+ source = RubiGen::PathSource.new(:application,
85
+ File.join(File.dirname(__FILE__), "../../app_generators"))
86
+ RubiGen::Base.reset_sources
87
+ RubiGen::Base.append_sources source
88
+ RubiGen::Scripts::Generate.new.run([path], :generator => 'ahn')
89
+ elsif args.size == 2
90
+ # We're creating a feature (e.g. a component)
91
+ feature_type, component_name = args
92
+
93
+ if feature_type != "component"
94
+ # At the moment, only components can be created.
95
+ raise CommandHandler::UnknownCommand.new("Don't know how to create '#{feature_type}'")
96
+ end
97
+
98
+ if component_name !~ /^[a-z][\w_]+$/
99
+ raise CommandHandler::ComponentError.new("Component name must be lowercase alphanumeric characters " +
100
+ "and begin with a character")
101
+ end
102
+
103
+ app_path = PathString.from_application_subdirectory Dir.pwd
104
+
105
+ raise PathInvalid.new(Dir.pwd) if app_path.nil?
106
+
107
+ new_component_dir = app_path + "/components/#{component_name}"
108
+ raise ComponentError.new("Component #{component_name} already exists!") if File.exists?(new_component_dir)
109
+
110
+ # Everything's good. Let's create the component
111
+ Dir.mkdir new_component_dir
112
+ File.open(new_component_dir + "/#{component_name}.rb","w") do |file|
113
+ file.puts <<-RUBY
114
+ # See http://docs.adhearsion.com for more information on how to write components or
115
+ # look at the examples in newly-created projects.
116
+ RUBY
117
+ end
118
+ File.open(new_component_dir + "/#{component_name}.yml","w") do |file|
119
+ file.puts '# You can use this file for component-specific configuration.'
120
+ end
121
+ puts "Created blank component '#{component_name}' at components/#{component_name}"
122
+ else
123
+ raise CommandHandler::UnknownCommand.new("Provided too many arguments to 'create'")
124
+ end
125
+ end
126
+
127
+ def start(path, daemon=false, pid_file=nil)
128
+ raise PathInvalid, path unless File.exists? path + "/.ahnrc"
129
+ Adhearsion::Initializer.start path, :daemon => daemon, :pid_file => pid_file
130
+ end
131
+
132
+ def version
133
+ puts "Adhearsion v#{Adhearsion::VERSION::STRING}"
134
+ end
135
+
136
+ def help
137
+ puts USAGE
138
+ end
139
+
140
+ def enable(type, name)
141
+ case type
142
+ when "component"
143
+ app_path = PathString.from_application_subdirectory Dir.pwd
144
+ if app_path
145
+ disabled_component_path = File.join app_path, "components", "disabled", name
146
+ enabled_component_path = File.join app_path, "components", name
147
+ if File.directory? disabled_component_path
148
+ FileUtils.mv disabled_component_path, enabled_component_path
149
+ puts "Enabled component #{name}"
150
+ else
151
+ raise ComponentError.new("There is no components/disabled directory!")
152
+ end
153
+ else
154
+ raise PathInvalid.new(Dir.pwd)
155
+ end
156
+ else
157
+ raise UnknownCommand.new("enable #{type}")
158
+ end
159
+ end
160
+
161
+ def disable(type, name)
162
+ case type
163
+ when "component"
164
+ app_path = PathString.from_application_subdirectory Dir.pwd
165
+ if app_path
166
+ disabled_dir = File.join app_path, "components", "disabled"
167
+
168
+ disabled_component_path = File.join disabled_dir, name
169
+ enabled_component_path = File.join app_path, "components", name
170
+
171
+ Dir.mkdir disabled_dir unless File.directory?(disabled_dir)
172
+
173
+ if File.directory? enabled_component_path
174
+ if File.directory?(disabled_component_path)
175
+ raise ComponentError.new("There is already a disabled component at #{disabled_component_path}")
176
+ else
177
+ FileUtils.mv enabled_component_path, disabled_component_path
178
+ puts "Disabled component #{name}"
179
+ end
180
+ else
181
+ raise ComponentError.new("Could not find component #{name} at #{enabled_component_path} !")
182
+ end
183
+ else
184
+ raise PathInvalid.new(Dir.pwd)
185
+ end
186
+ else
187
+ raise UnknownCommand.new("disable #{type}")
188
+ end
189
+ end
190
+
191
+ def method_missing(action, *args)
192
+ raise UnknownCommand, [action, *args] * " "
193
+ end
194
+
195
+ private
196
+
197
+ end
198
+
199
+ class CLIException < Exception; end
200
+
201
+ class UnknownCommand < CLIException
202
+ def initialize(cmd)
203
+ super "Unknown command: #{cmd}"
204
+ end
205
+ end
206
+
207
+ class ComponentError < CLIException; end
208
+
209
+ class UnknownProject < CLIException
210
+ def initialize(project)
211
+ super "Application #{project} does not exist! Have you installed it?"
212
+ end
213
+ end
214
+
215
+ class PathInvalid < CLIException
216
+ def initialize(path)
217
+ super "Directory #{path} does not belong to an Adhearsion project!"
218
+ end
219
+ end
220
+ end
221
+ end
222
+ end
223
+ end
@@ -0,0 +1,207 @@
1
+ module Adhearsion
2
+ module Components
3
+
4
+ mattr_accessor :component_manager
5
+
6
+ class ConfigurationError < Exception; end
7
+
8
+ class ComponentManager
9
+
10
+ class << self
11
+
12
+ def scopes_valid?(*scopes)
13
+ unrecognized_scopes = (scopes.flatten - SCOPE_NAMES).map(&:inspect)
14
+ raise ArgumentError, "Unrecognized scopes #{unrecognized_scopes.to_sentence}" if unrecognized_scopes.any?
15
+ true
16
+ end
17
+
18
+ end
19
+
20
+ SCOPE_NAMES = [:dialplan, :events, :generators, :rpc, :global]
21
+
22
+ attr_reader :scopes, :lazy_config_loader
23
+ def initialize(path_to_container_directory)
24
+ @path_to_container_directory = path_to_container_directory
25
+ @scopes = SCOPE_NAMES.inject({}) do |scopes, name|
26
+ scopes[name] = Module.new
27
+ scopes
28
+ end
29
+ @lazy_config_loader = LazyConfigLoader.new(self)
30
+ end
31
+
32
+ ##
33
+ # Includes the anonymous Module created for the :global scope in Object, making its methods globally accessible.
34
+ #
35
+ def globalize_global_scope!
36
+ Object.send :include, @scopes[:global]
37
+ end
38
+
39
+ def load_components
40
+ components = Dir.glob(File.join(@path_to_container_directory + "/*")).select do |path|
41
+ File.directory?(path)
42
+ end
43
+ components.map! { |path| File.basename path }
44
+ components.each do |component|
45
+ next if component == "disabled"
46
+ component_file = File.join(@path_to_container_directory, component, component + ".rb")
47
+ if File.exists? component_file
48
+ load_file component_file
49
+ else
50
+ ahn_log.warn "Component directory does not contain a matching .rb file! Was expecting #{component_file.inspect}"
51
+ end
52
+ end
53
+
54
+ end
55
+
56
+ ##
57
+ # Loads the configuration file for a given component name.
58
+ #
59
+ # @return [Hash] The loaded YAML for the given component name. An empty Hash if no YAML file exists.
60
+ #
61
+ def configuration_for_component_named(component_name)
62
+ component_dir = File.join(@path_to_container_directory, component_name)
63
+ config_file = File.join component_dir, "#{component_name}.yml"
64
+ if File.exists?(config_file)
65
+ YAML.load_file config_file
66
+ else
67
+ return {}
68
+ end
69
+ end
70
+
71
+ def extend_object_with(object, *scopes)
72
+ raise ArgumentError, "Must supply at least one scope!" if scopes.empty?
73
+
74
+ self.class.scopes_valid? scopes
75
+
76
+ scopes.each do |scope|
77
+ methods = @scopes[scope]
78
+ if object.kind_of?(Module)
79
+ object.send :include, methods
80
+ else
81
+ object.extend methods
82
+ end
83
+ end
84
+ object
85
+ end
86
+
87
+ def load_code(code)
88
+ load_container ComponentDefinitionContainer.load_code(code)
89
+ end
90
+
91
+ def load_file(filename)
92
+ load_container ComponentDefinitionContainer.load_file(filename)
93
+ end
94
+
95
+ protected
96
+
97
+ def load_container(container)
98
+ container.constants.each do |constant_name|
99
+ constant_value = container.const_get(constant_name)
100
+ Object.const_set(constant_name, constant_value)
101
+ end
102
+ metadata = container.metaclass.send(:instance_variable_get, :@metadata)
103
+ metadata[:initialization_block].call if metadata[:initialization_block]
104
+
105
+ self.class.scopes_valid? metadata[:scopes].keys
106
+
107
+ metadata[:scopes].each_pair do |scope, method_definition_blocks|
108
+ method_definition_blocks.each do |method_definition_block|
109
+ @scopes[scope].module_eval(&method_definition_block)
110
+ end
111
+ end
112
+ container
113
+ end
114
+
115
+ class ComponentDefinitionContainer < Module
116
+
117
+ class << self
118
+ def load_code(code)
119
+ returning(new) do |instance|
120
+ instance.module_eval code
121
+ end
122
+ end
123
+
124
+ def load_file(filename)
125
+ returning(new) do |instance|
126
+ instance.module_eval File.read(filename), filename
127
+ end
128
+ end
129
+ end
130
+
131
+ def initialize(&block)
132
+ # Hide our instance variables in the singleton class
133
+ metadata = {}
134
+ metaclass.send(:instance_variable_set, :@metadata, metadata)
135
+
136
+ metadata[:scopes] = ComponentManager::SCOPE_NAMES.inject({}) do |scopes, name|
137
+ scopes[name] = []
138
+ scopes
139
+ end
140
+
141
+ super
142
+
143
+ meta_def(:initialize) { raise "This object has already been instantiated. Are you sure you didn't mean initialization()?" }
144
+ end
145
+
146
+ def methods_for(*scopes, &block)
147
+ raise ArgumentError if scopes.empty?
148
+
149
+ ComponentManager.scopes_valid? scopes
150
+
151
+ metadata = metaclass.send(:instance_variable_get, :@metadata)
152
+ scopes.each { |scope| metadata[:scopes][scope] << block }
153
+ end
154
+
155
+ def initialization(&block)
156
+ # Raise an exception if the initialization block has already been set
157
+ metadata = metaclass.send(:instance_variable_get, :@metadata)
158
+ if metadata[:initialization_block]
159
+ raise "You should only have one initialization() block!"
160
+ else
161
+ metadata[:initialization_block] = block
162
+ end
163
+ end
164
+ alias initialisation initialization
165
+
166
+ protected
167
+
168
+ class << self
169
+ def self.method_added(method_name)
170
+ @methods ||= []
171
+ @methods << method_name
172
+ end
173
+ end
174
+
175
+ end
176
+
177
+ class ComponentMethodDefinitionContainer < Module
178
+ class << self
179
+ def method_added(method_name)
180
+ @methods ||= []
181
+ @methods << method_name
182
+ end
183
+ end
184
+
185
+ attr_reader :scopes
186
+ def initialize(*scopes, &block)
187
+ @scopes = []
188
+ super(&block)
189
+ end
190
+
191
+ end
192
+
193
+ class LazyConfigLoader
194
+ def initialize(component_manager)
195
+ @component_manager = component_manager
196
+ end
197
+
198
+ def method_missing(component_name)
199
+ config = @component_manager.configuration_for_component_named(component_name.to_s)
200
+ (class << self; self; end).send(:define_method, component_name) { config }
201
+ config
202
+ end
203
+ end
204
+
205
+ end
206
+ end
207
+ end