adhearsion-cw 1.0.2.1

data/Rakefile

@@ -0,0 +1,134 @@
+# -*- ruby -*-
+ENV['RUBY_FLAGS'] = "-I#{%w(lib ext bin test).join(File::PATH_SEPARATOR)}"
+
+require 'rubygems'
+require 'bundler'
+Bundler::GemHelper.install_tasks
+require 'rake/testtask'
+require 'date'
+
+begin
+  gem 'rspec', '>= 2.3.0'
+  require 'rspec/core/rake_task'
+rescue LoadError
+  abort "You must install RSpec: sudo gem install rspec"
+end
+
+begin
+  require 'yard'
+  YARD::Rake::YardocTask.new do |t|
+    t.files = ['lib/**/*.rb'] + %w[README.markdown TODO.markdown LICENSE]
+  end
+rescue LoadError
+  STDERR.puts "\nCould not require() YARD! Install with 'gem install yard' to get the 'yardoc' task\n\n"
+end
+
+require 'adhearsion/version'
+
+AHN_TESTS     = ['spec/**/test_*.rb']
+#AHN_TESTS     = ['spec/test_ahn_command.rb']
+GEMSPEC       = eval File.read("adhearsion.gemspec")
+RAGEL_FILES   = %w[lib/adhearsion/voip/asterisk/manager_interface/ami_lexer.rl.rb]
+THEATRE_TESTS = 'theatre-spec/**/*_spec.rb'
+
+begin
+  require 'rcov/rcovtask'
+  Rcov::RcovTask.new do |t|
+    t.test_files = Dir[*AHN_TESTS]
+    t.output_dir = 'coverage'
+    t.verbose = true
+    t.rcov_opts.concat %w[--sort coverage --sort-reverse -x gems -x /var --no-validator-links]
+  end
+rescue LoadError
+  STDERR.puts "Could not load rcov tasks -- rcov does not appear to be installed. Continuing anyway."
+end
+
+task :gem => :build
+
+# YARD::Rake::YardocTask.new do |t|
+#   t.files   = ['lib/**/*.rb']   # optional
+#   # t.options = ['--any', '--extra', '--opts'] # optional
+# end
+
+#Rake::TestTask.new('spec') do |t|
+#  t.libs << File.dirname(__FILE__)
+#  t.verbose = true
+#  t.pattern = AHN_TESTS
+#end
+
+RSpec::Core::RakeTask.new(:spec) do |t|
+  t.pattern = AHN_TESTS
+end
+
+task :default => :spec
+
+desc "Check Ragel version"
+task :check_ragel_version do
+  ragel_version_match = `ragel --version`.match(/(\d)\.(\d)+/)
+  abort "Could not get Ragel version! Is it installed? You must have at least version 6.3" unless ragel_version_match
+  big, small = ragel_version_match.captures.map { |n| n.to_i }
+  if big < 6 || (big == 6 && small < 3)
+    abort "Please upgrade Ragel! You're on version #{ragel_version_match[0]} and must be on 6.3 or later"
+  end
+  if (big == 6 && small < 7)
+    puts "WARNING: A change to Ruby since 1.9 affects the Ragel generated code."
+    puts "WARNING: You MUST be using Ragel version 6.7 or have patched it using"
+    puts "WARNING: the patch found at:"
+    puts "WARNING: http://www.mail-archive.com/ragel-users@complang.org/msg00440.html"
+  end
+end
+
+desc "Used to regenerate the AMI source code files. Note: requires Ragel 6.3 or later be installed on your system"
+task :ragel => :check_ragel_version do
+  RAGEL_FILES.each do |ragel_file|
+    ruby_file = ragel_file.sub(".rl.rb", ".rb")
+    puts `ragel -n -R #{ragel_file} -o #{ruby_file} 2>&1`
+    raise "Failed generating code from Ragel file #{ragel_file}" if $?.to_i.nonzero?
+  end
+end
+
+desc "Generates a GraphVis document showing the Ragel state machine"
+task :visualize_ragel => :check_ragel_version do
+  RAGEL_FILES.each do |ragel_file|
+    base_name = File.basename ragel_file, ".rl.rb"
+    puts "ragel -V #{ragel_file} -o #{base_name}.dot 2>&1"
+    puts `ragel -V #{ragel_file} -o #{base_name}.dot 2>&1`
+    raise "Failed generating code from Ragel file #{ragel_file}" if $?.to_i.nonzero?
+  end
+end
+
+desc "Run all RSpecs for Theatre"
+RSpec::Core::RakeTask.new(:theatre_specs) do |t|
+  t.pattern = FileList[THEATRE_TESTS]
+end
+
+desc "Compares Adhearsion's files with those listed in adhearsion.gemspec"
+task :check_gemspec_files do
+  files_from_gemspec    = ADHEARSION_FILES
+  files_from_filesystem = Dir.glob(File.dirname(__FILE__) + "/**/*").map do |filename|
+    filename[0...Dir.pwd.length] == Dir.pwd ? filename[(Dir.pwd.length+1)..-1] : filename
+  end
+  files_from_filesystem.reject! { |f| File.directory? f }
+
+  puts
+  puts 'Pipe this command to "grep -v \'spec/\' | grep -v test" to ignore test files'
+  puts
+  puts '##########################################'
+  puts '## Files on filesystem not in the gemspec:'
+  puts '##########################################'
+  puts((files_from_filesystem - files_from_gemspec).map { |f| "  " + f })
+
+  puts '##########################################'
+  puts '## Files in gemspec not in the filesystem:'
+  puts '##########################################'
+  puts((files_from_gemspec - files_from_filesystem).map { |f| "  " + f })
+end
+
+desc "Test that the .gemspec file executes"
+task :debug_gem do
+  require 'rubygems/specification'
+  gemspec = File.read('adhearsion.gemspec')
+  spec = nil
+  Thread.new { spec = eval("$SAFE = 3\n#{gemspec}") }.join
+  puts "SUCCESS: Gemspec runs at the $SAFE level 3."
+end

data/adhearsion.gemspec

@@ -0,0 +1,174 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "adhearsion/version"
+
+Gem::Specification.new do |s|
+  s.name = "adhearsion-cw"
+  s.version = Adhearsion::VERSION::STRING
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Dawid Pogorzelski"]
+
+  s.date = Date.today.to_s
+  s.description = "Adhearsion-cw is an open-source telephony development framework. This is a fork from the original Adhearsion project http://adhearsion.com"
+  s.email = "dawid.pogorzelski@mybushido.com"
+  s.executables = ["ahn", "ahnctl", "jahn"]
+
+  s.files = %w{
+    adhearsion.gemspec
+    app_generators/ahn/ahn_generator.rb
+    app_generators/ahn/templates/.ahnrc
+    app_generators/ahn/templates/components/ami_remote/ami_remote.rb
+    app_generators/ahn/templates/components/disabled/HOW_TO_ENABLE
+    app_generators/ahn/templates/components/disabled/stomp_gateway/stomp_gateway.yml
+    app_generators/ahn/templates/components/disabled/stomp_gateway/README.markdown
+    app_generators/ahn/templates/components/disabled/stomp_gateway/stomp_gateway.rb
+    app_generators/ahn/templates/components/disabled/sandbox/sandbox.rb
+    app_generators/ahn/templates/components/disabled/sandbox/sandbox.yml
+    app_generators/ahn/templates/components/disabled/restful_rpc/restful_rpc.yml
+    app_generators/ahn/templates/components/disabled/restful_rpc/example-client.rb
+    app_generators/ahn/templates/components/disabled/restful_rpc/README.markdown
+    app_generators/ahn/templates/components/disabled/restful_rpc/restful_rpc.rb
+    app_generators/ahn/templates/components/disabled/restful_rpc/spec/restful_rpc_spec.rb
+    app_generators/ahn/templates/components/disabled/xmpp_gateway/xmpp_gateway.rb
+    app_generators/ahn/templates/components/disabled/xmpp_gateway/xmpp_gateway.yml
+    app_generators/ahn/templates/components/disabled/xmpp_gateway/README.markdown
+    app_generators/ahn/templates/components/simon_game/simon_game.rb
+    app_generators/ahn/templates/config/startup.rb
+    app_generators/ahn/templates/dialplan.rb
+    app_generators/ahn/templates/events.rb
+    app_generators/ahn/templates/Rakefile
+    app_generators/ahn/templates/Gemfile
+    app_generators/ahn/templates/README
+    app_generators/ahn/USAGE
+    bin/ahn
+    bin/ahnctl
+    bin/jahn
+    CHANGELOG
+    EVENTS
+    examples/asterisk_manager_interface/standalone.rb
+    lib/adhearsion.rb
+    lib/adhearsion/cli.rb
+    lib/adhearsion/component_manager.rb
+    lib/adhearsion/component_manager/component_tester.rb
+    lib/adhearsion/component_manager/spec_framework.rb
+    lib/adhearsion/events_support.rb
+    lib/adhearsion/foundation/all.rb
+    lib/adhearsion/foundation/blank_slate.rb
+    lib/adhearsion/foundation/custom_daemonizer.rb
+    lib/adhearsion/foundation/event_socket.rb
+    lib/adhearsion/foundation/future_resource.rb
+    lib/adhearsion/foundation/metaprogramming.rb
+    lib/adhearsion/foundation/numeric.rb
+    lib/adhearsion/foundation/pseudo_guid.rb
+    lib/adhearsion/foundation/relationship_properties.rb
+    lib/adhearsion/foundation/string.rb
+    lib/adhearsion/foundation/synchronized_hash.rb
+    lib/adhearsion/foundation/thread_safety.rb
+    lib/adhearsion/host_definitions.rb
+    lib/adhearsion/initializer.rb
+    lib/adhearsion/initializer/asterisk.rb
+    lib/adhearsion/initializer/configuration.rb
+    lib/adhearsion/initializer/database.rb
+    lib/adhearsion/initializer/ldap.rb
+    lib/adhearsion/initializer/drb.rb
+    lib/adhearsion/initializer/freeswitch.rb
+    lib/adhearsion/initializer/rails.rb
+    lib/adhearsion/initializer/xmpp.rb
+    lib/adhearsion/logging.rb
+    lib/adhearsion/tasks.rb
+    lib/adhearsion/tasks/components.rb
+    lib/adhearsion/tasks/database.rb
+    lib/adhearsion/tasks/deprecations.rb
+    lib/adhearsion/tasks/generating.rb
+    lib/adhearsion/tasks/lint.rb
+    lib/adhearsion/tasks/testing.rb
+    lib/adhearsion/version.rb
+    lib/adhearsion/voip/asterisk.rb
+    lib/adhearsion/voip/asterisk/agi_server.rb
+    lib/adhearsion/voip/asterisk/commands.rb
+    lib/adhearsion/voip/asterisk/config_generators/agents.conf.rb
+    lib/adhearsion/voip/asterisk/config_generators/config_generator.rb
+    lib/adhearsion/voip/asterisk/config_generators/queues.conf.rb
+    lib/adhearsion/voip/asterisk/config_generators/voicemail.conf.rb
+    lib/adhearsion/voip/asterisk/config_manager.rb
+    lib/adhearsion/voip/asterisk/manager_interface.rb
+    lib/adhearsion/voip/asterisk/manager_interface/ami_lexer.rb
+    lib/adhearsion/voip/asterisk/manager_interface/ami_lexer.rl.rb
+    lib/adhearsion/voip/asterisk/manager_interface/ami_messages.rb
+    lib/adhearsion/voip/asterisk/manager_interface/ami_protocol_lexer_machine.rl
+    lib/adhearsion/voip/asterisk/special_dial_plan_managers.rb
+    lib/adhearsion/voip/asterisk/super_manager.rb
+    lib/adhearsion/voip/call.rb
+    lib/adhearsion/voip/call_routing.rb
+    lib/adhearsion/voip/commands.rb
+    lib/adhearsion/voip/constants.rb
+    lib/adhearsion/voip/conveniences.rb
+    lib/adhearsion/voip/dial_plan.rb
+    lib/adhearsion/voip/dsl/dialing_dsl.rb
+    lib/adhearsion/voip/dsl/dialing_dsl/dialing_dsl_monkey_patches.rb
+    lib/adhearsion/voip/dsl/dialplan/control_passing_exception.rb
+    lib/adhearsion/voip/dsl/dialplan/dispatcher.rb
+    lib/adhearsion/voip/dsl/dialplan/parser.rb
+    lib/adhearsion/voip/dsl/dialplan/thread_mixin.rb
+    lib/adhearsion/voip/dsl/numerical_string.rb
+    lib/adhearsion/voip/freeswitch/basic_connection_manager.rb
+    lib/adhearsion/voip/freeswitch/event_handler.rb
+    lib/adhearsion/voip/freeswitch/freeswitch_dialplan_command_factory.rb
+    lib/adhearsion/voip/freeswitch/inbound_connection_manager.rb
+    lib/adhearsion/voip/freeswitch/oes_server.rb
+    lib/adhearsion/voip/menu_state_machine/calculated_match.rb
+    lib/adhearsion/voip/menu_state_machine/matchers.rb
+    lib/adhearsion/voip/menu_state_machine/menu_builder.rb
+    lib/adhearsion/voip/menu_state_machine/menu_class.rb
+    lib/adhearsion/xmpp/connection.rb
+    lib/theatre.rb
+    lib/theatre/callback_definition_loader.rb
+    lib/theatre/guid.rb
+    lib/theatre/invocation.rb
+    lib/theatre/namespace_manager.rb
+    lib/theatre/README.markdown
+    lib/theatre/version.rb
+    LICENSE
+    Rakefile
+    Gemfile
+  }
+
+  s.has_rdoc = true
+  s.homepage = "https://github.com/dawid999/adhearsion-cw"
+  s.require_paths = ["lib"]
+  s.rubyforge_project = "adhearsion"
+  s.rubygems_version = "1.2.0"
+  s.summary = "Adhearsion-cw, open-source telephony development framework. This is a fork from the original Adhearsion project http://adhearsion.com"
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 2
+
+    if current_version >= 3 then
+      # Runtime dependencies
+      s.add_runtime_dependency("bundler", [">= 1.0.10"])
+      s.add_runtime_dependency("log4r", [">= 1.0.5"])
+      s.add_runtime_dependency("activesupport", [">= 2.1.0"])
+      # i18n is only strictly a dependency for ActiveSupport >= 3.0.0
+      # Since it doesn't conflict with <3.0.0 we'll require it to be
+      # on the safe side.
+      s.add_runtime_dependency("i18n")
+      s.add_runtime_dependency("rubigen", [">= 1.5.6"])
+
+      # Development dependencies
+      s.add_development_dependency('rubigen', [">= 1.5.6"])
+      s.add_development_dependency('rspec', [">= 2.4.0"])
+      s.add_development_dependency('flexmock')
+      s.add_development_dependency('activerecord')
+    else
+      s.add_dependency("bundler", [">= 1.0.10"])
+      s.add_dependency("log4r", [">= 1.0.5"])
+      s.add_dependency("activesupport", [">= 2.1.0"])
+    end
+  else
+    s.add_dependency("bundler", [">= 1.0.10"])
+    s.add_dependency("log4r", [">= 1.0.5"])
+    s.add_dependency("activesupport", [">= 2.1.0"])
+  end
+end

data/app_generators/ahn/USAGE

@@ -0,0 +1,5 @@
+Description:
+
+
+Usage:
+

data/app_generators/ahn/ahn_generator.rb

@@ -0,0 +1,97 @@
+class AhnGenerator < RubiGen::Base
+
+  DEFAULT_SHEBANG = File.join(Config::CONFIG['bindir'],
+                              Config::CONFIG['ruby_install_name'])
+
+  default_options :author => nil
+
+  attr_reader :name, :component
+
+  def initialize(runtime_args, runtime_options = {})
+    super
+    usage if args.empty?
+    @destination_root = File.expand_path(args.shift)
+    @name = base_name
+    @component = 'simon_game'
+    extract_options
+  end
+
+  def manifest
+    record do |m|
+      # Ensure appropriate folder(s) exists
+      m.directory ''
+      BASEDIRS.each { |path| m.directory path }
+
+      m.file  *[".ahnrc"]*2
+
+      m.file  *["components/simon_game/simon_game.rb"]*2
+      m.file  *["components/ami_remote/ami_remote.rb"]*2
+
+      m.file  *["components/disabled/xmpp_gateway/xmpp_gateway.rb"]*2
+      m.file  *["components/disabled/xmpp_gateway/xmpp_gateway.yml"]*2
+      m.file  *["components/disabled/xmpp_gateway/README.markdown"]*2
+
+      m.file  *["components/disabled/stomp_gateway/stomp_gateway.rb"]*2
+      m.file  *["components/disabled/stomp_gateway/stomp_gateway.yml"]*2
+      m.file  *["components/disabled/stomp_gateway/README.markdown"]*2
+
+      m.file  *["components/disabled/restful_rpc/restful_rpc.rb"]*2
+      m.file  *["components/disabled/restful_rpc/restful_rpc.yml"]*2
+      m.file  *["components/disabled/restful_rpc/README.markdown"]*2
+      m.file  *["components/disabled/restful_rpc/example-client.rb"]*2
+      m.file  *["components/disabled/restful_rpc/spec/restful_rpc_spec.rb"]*2
+
+      m.file  *["components/disabled/sandbox/sandbox.yml"]*2
+      m.file  *["components/disabled/sandbox/sandbox.rb"]*2
+
+      m.file  *["config/startup.rb"]*2
+      m.file  *["dialplan.rb"]*2
+      m.file  *["events.rb"]*2
+      m.file  *["README"]*2
+      m.file  *["Rakefile"]*2
+      m.file  *["Gemfile"]*2
+
+      # m.dependency "install_rubigen_scripts", [destination_root, 'ahn', 'adhearsion', 'test_spec'],
+      #   :shebang => options[:shebang], :collision => :force
+    end
+  end
+
+  protected
+    def banner
+      <<-EOS
+Creates a ...
+
+USAGE: #{spec.name} name"
+EOS
+    end
+
+    def add_options!(opts)
+      opts.separator ''
+      opts.separator 'Options:'
+      # For each option below, place the default
+      # at the top of the file next to "default_options"
+      # opts.on("-a", "--author=\"Your Name\"", String,
+      #         "Some comment about this option",
+      #         "Default: none") { |options[:author]| }
+      opts.on("-v", "--version", "Show the #{File.basename($0)} version number and quit.")
+    end
+
+    def extract_options
+      # for each option, extract it into a local variable (and create an "attr_reader :author" at the top)
+      # Templates can access these value via the attr_reader-generated methods, but not the
+      # raw instance variable value.
+      # @author = options[:author]
+    end
+
+    # Installation skeleton.  Intermediate directories are automatically
+    # created so don't sweat their absence here.
+    BASEDIRS = %w(
+      components/simon_game
+      components/disabled/stomp_gateway
+      components/disabled/xmpp_gateway
+      components/disabled/sandbox
+      components/ami_remote
+      components/disabled/restful_rpc/spec
+      config
+    )
+end

data/app_generators/ahn/templates/.ahnrc

@@ -0,0 +1,34 @@
+# Adhearsion Runtime Configuration.
+
+# You can use the "gems" section to force Adhearsion to load a particular version of a gem.
+# This is useful when a component require()s a gem, but you don't want it to use the latest one installed on the system.
+# For example, if a component require()s activerecord, sucking in the latest on the system, and then you enable a Rails app
+# which wants a particular version of activerecord, RubyGems will raise an error saying "you cannot activate two versions of
+# the same gem". Note: specifying the version, source and require names is optional, but you must include a : after the gem name to make it a YAML key/value pair (with a nil value).
+gems:
+#  twitter:
+#  hpricot:
+#  rack:
+#    # require() one library when initializing:
+#    require: rack
+#  memcache-client:
+#    version >= 1.5.2
+#    require:
+#      # require() an Array of libraries when initializing:
+#      - memcache
+#      - memcache_util
+#  activerecord:
+#    version: >= 2.1.0
+#  aasm:
+#    source: http://gems.github.com
+
+paths:
+
+  # All paths are relative to this file's directory
+  init: config/startup.rb
+
+  dialplan: dialplan.rb
+
+  events: events.rb
+
+  models: models/*.rb

data/app_generators/ahn/templates/Gemfile

@@ -0,0 +1,7 @@
+source "http://rubygems.org"
+
+gem "rake"
+gem "rubigen", ">= 1.0.6"
+gem "log4r", ">= 1.0.5"
+gem "activesupport", ">= 2.1.0"
+gem "adhearsion", ">= 1.0.1"

data/app_generators/ahn/templates/README

@@ -0,0 +1,8 @@
+Start your new app with "ahn start /path/to/your/app"
+
+If you wish to use Adhearsion to control Asterisk's dialplan,
+change the contexts you wish to be affected in your
+/etc/asterisk/extensions.conf file to the following:
+
+[your_context_name]
+exten => _X.,1,AGI(agi://1.2.3.4) ; This IP here

data/app_generators/ahn/templates/Rakefile

@@ -0,0 +1,27 @@
+# This file is for the "rake" tool which automates project-related tasks. If you need to automate things, you can create
+# a new Rake task here. See http://rake.rubyforge.org for more info.
+require 'rubygems'
+require 'bundler'
+Bundler.setup
+Bundler.require
+
+begin
+  require 'adhearsion/tasks'
+rescue LoadError
+  STDERR.puts "\nCannot load Adhearsion! Not all Rake tasks will be loaded!\n\n"
+end
+
+desc "Writes a .gitignore file that ignores certain SCM annoyances such as log files"
+task :gitignore do
+  ignore_file = "#{Dir.pwd}/.gitignore"
+  if File.exists? ignore_file
+    STDERR.puts "File #{ignore_file} already exists!"
+  else
+    File.open ignore_file, 'w' do |file|
+      # Add other files to the Array below
+      %w[ log ].each do |pattern|
+        file.puts pattern
+      end
+    end
+  end
+end

data/app_generators/ahn/templates/components/ami_remote/ami_remote.rb

@@ -0,0 +1,15 @@
+methods_for :rpc do
+
+  # Simply create proxy methods for the high-level AMI methods
+
+  [:send_action, :introduce, :originate, :call_into_context, :call_and_exec, :ping].each do |method_name|
+    define_method(method_name) do |*args|
+      if VoIP::Asterisk.manager_interface
+        VoIP::Asterisk.manager_interface.send(method_name, *args)
+      else
+        ahn_log.ami_remote.error "AMI has not been enabled in startup.rb!"
+      end
+    end
+  end
+
+end

data/app_generators/ahn/templates/components/disabled/HOW_TO_ENABLE

@@ -0,0 +1,7 @@
+Type "ahn enable component COMPONENT_NAME_FROM_DISABLED_FOLDER
+
+For example:
+
+~/Desktop $ ahn create myapp
+~/Desktop $ cd myapp
+~/Desktop/myapp $ ahn enable component stomp_gateway

data/app_generators/ahn/templates/components/disabled/restful_rpc/README.markdown

@@ -0,0 +1,11 @@
+Adhearsion RESTful RPC Component
+================================
+
+This is a component for people want to integrate their telephony systems with non-Ruby systems. When enabled, this component
+will start up a HTTP server within the Adhearsion process and accept POST requests to invoke Ruby methods shared in the
+`methods_for(:rpc)` context.
+
+Protocol Notes
+--------------
+
+When POSTing your data to.

data/app_generators/ahn/templates/components/disabled/restful_rpc/example-client.rb

@@ -0,0 +1,48 @@
+require 'rubygems'
+require 'rest_client'
+require 'json'
+
+# You must have the "rest-client" and "json" gems installed for this file to work.
+
+class RESTfulAdhearsion
+
+  DEFAULT_OPTIONS = {
+    # Note: :user and :password are non-existent by default
+    :host => "localhost",
+    :port => "5000",
+    :path_nesting => "/"
+  }
+
+  def initialize(options={})
+    @options = DEFAULT_OPTIONS.merge options
+
+    @path_nesting = @options.delete :path_nesting
+    @host = @options.delete :host
+    @port = @options.delete :port
+
+    @url_beginning = "http://#{@host}:#{@port}#{@path_nesting}"
+  end
+
+  def method_missing(method_name, *args)
+    JSON.parse RestClient::Resource.new(@url_beginning + method_name.to_s, @options).post(args.to_json)
+  end
+
+end
+
+Adhearsion = RESTfulAdhearsion.new :host => "localhost", :port => 5000, :user => "jicksta", :password => "roflcopterz"
+
+# ### Sample component code. Try doing "ahn create component testing123" and pasting this code in.
+#
+# methods_for :rpc do
+#   def i_like_hashes(options={})
+#     options.has_key?(:foo)
+#   end
+#   def i_like_arrays(*args)
+#     args.reverse
+#   end
+# end
+
+# Note: everything returned will be wrapped in an Array
+
+p Adhearsion.i_like_hashes(:foo => "bar")
+p Adhearsion.i_like_arrays(1,2,3,4,5)

data/app_generators/ahn/templates/components/disabled/restful_rpc/restful_rpc.rb

@@ -0,0 +1,91 @@
+begin
+  require 'rack'
+  require 'json'
+rescue LoadError
+  abort "ERROR: restful_rpc requires the 'rack' and 'json' gems"
+end
+
+# Don't you love regular expressions? Matches only 0-255 octets. Recognizes "*" as an octet wildcard.
+VALID_IP_ADDRESS = /^(?:(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?|\*)\.){3}(?:25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?|\*)$/
+
+def ip_allowed?(ip)
+  raise ArgumentError, "#{ip.inspect} is not a valid IP address!" unless ip.kind_of?(String) && ip =~ VALID_IP_ADDRESS
+
+  octets = ip.split "."
+
+  case COMPONENTS.restful_rpc["access"]
+    when "everyone"
+      true
+    when "whitelist"
+      whitelist = COMPONENTS.restful_rpc["whitelist"]
+      !! whitelist.find do |pattern|
+        pattern_octets = pattern.split "."
+        # Traverse both arrays in parallel
+        octets.zip(pattern_octets).map do |octet, octet_pattern|
+          octet_pattern == "*" ? true : (octet == octet_pattern)
+        end == [true, true, true, true]
+      end
+    when "blacklist"
+      blacklist = COMPONENTS.restful_rpc["blacklist"]
+      ! blacklist.find do |pattern|
+        pattern_octets = pattern.split "."
+        # Traverse both arrays in parallel
+        octets.zip(pattern_octets).map do |octet, octet_pattern|
+          octet_pattern == "*" ? true : (octet == octet_pattern)
+        end == [true, true, true, true]
+      end
+    else
+      raise Adhearsion::Components::ConfigurationError, 'Unrecognized "access" configuration value!'
+  end
+end
+
+RESTFUL_API_HANDLER = lambda do |env|
+  json = env["rack.input"].read
+
+  # Return "Bad Request" HTTP error if the client forgot
+  return [400, {}, "You must POST a valid JSON object!"] if json.blank?
+
+  json = JSON.parse json
+
+  nesting = COMPONENTS.restful_rpc["path_nesting"]
+  path = env["PATH_INFO"]
+
+  return [404, {}, "This resource does not respond to #{path.inspect}"] unless path[0...nesting.size] == nesting
+
+  path = path[nesting.size..-1]
+
+  return [404, {"Content-Type" => "application/json"}, "You cannot nest method names!"] if path.include?("/")
+
+  rpc_object = Adhearsion::Components.component_manager.extend_object_with(Object.new, :rpc)
+
+  # TODO: set the content-type and other HTTP headers
+  response_object = rpc_object.send(path, *json)
+  [200, {"Content-Type" => "application/json"}, response_object.to_json]
+
+end
+
+initialization do
+  config = COMPONENTS.restful_rpc
+
+  api = RESTFUL_API_HANDLER
+
+  port            = config["port"] || 5000
+  authentication  = config["authentication"]
+  show_exceptions = config["show_exceptions"]
+  handler         = Rack::Handler.const_get(config["handler"] || "Mongrel")
+
+  if authentication
+    api = Rack::Auth::Basic.new(api) do |username, password|
+      authentication[username] == password
+    end
+    api.realm = "Adhearsion API"
+  end
+
+  if show_exceptions
+    api = Rack::ShowStatus.new(Rack::ShowExceptions.new(api))
+  end
+
+  Thread.new do
+    handler.run api, :Port => port
+  end
+end