adhearsion 1.2.6 → 2.0.0.alpha1

data/lib/adhearsion/foundation/future_resource.rb

@@ -1,36 +0,0 @@
-require "thread"
-
-class FutureResource
-
-  def initialize
-    @resource_lock          = Monitor.new
-    @resource_value_blocker = @resource_lock.new_cond
-  end
-
-  def set_yet?
-    @resource_lock.synchronize { defined? @resource }
-  end
-
-  def resource
-    @resource_lock.synchronize do
-      @resource_value_blocker.wait unless defined? @resource
-      @resource
-    end
-  end
-
-  def resource=(resource)
-    @resource_lock.synchronize do
-      raise ResourceAlreadySetException if defined? @resource
-      @resource = resource
-      @resource_value_blocker.broadcast
-      @resource_value_blocker = nil # Don't really need it anymore.
-    end
-  end
-
-  class ResourceAlreadySetException < StandardError
-    def initialize
-      super "Cannot set this resource twice!"
-    end
-  end
-
-end

data/lib/adhearsion/foundation/metaprogramming.rb

@@ -1,17 +0,0 @@
-class Object
-  def metaclass
-    class << self
-      self
-    end
-  end
-
-  def meta_eval(&block)
-    metaclass.instance_eval &block
-  end
-
-  def meta_def(name, &block)
-    meta_eval do
-      define_method name, &block
-    end
-  end
-end

data/lib/adhearsion/foundation/numeric.rb

@@ -1,13 +0,0 @@
-class Numeric
-
-  def digit()
-    ahn_log.deprecation 'Please do not use Fixnum#digit() and Fixnum#digits() in the future! These will be deprecated soon'
-    self
-  end
-
-  def digits()
-    ahn_log.deprecation 'Please do not use Fixnum#digit() and Fixnum#digits() in the future! These will be deprecated soon'
-    self
-  end
-
-end

data/lib/adhearsion/foundation/pseudo_guid.rb

@@ -1,10 +0,0 @@
-module PseudoGuidGenerator
-  ##
-  # Generates a new 128-bit Globally Unique Identifier. It is a "pseudo" in that it does not adhere to the RFC which mandates
-  # that a certain section be reserved for a fragment of the NIC MAC address.
-  def new_guid(separator="-")
-    [8,4,4,4,12].map { |segment_length| String.random(segment_length) }.join(separator)
-  end
-end
-
-include PseudoGuidGenerator

data/lib/adhearsion/foundation/relationship_properties.rb

@@ -1,42 +0,0 @@
-class Module
-
-  ##
-  # In OOP, relationships between classes should be treated as *properties* of those classes. Often, in a complex OO
-  # architecture, you'll end up with many relationships that intermingle in monolithic ways, blunting the effectiveness of
-  # subclassing.
-  #
-  # For example, say you have an Automobile class which, in its constructor, instantiates a new Battery class and performs
-  # some operations on it such as calling an install() method. Let's also assume the Automobile class exposes a repair()
-  # method which uses a class-level method of Battery to diagnose your own instance of Battery. If the result of the
-  # diagnosis shows that the Battery is bad, the Automobile will instantiate a new Battery object and replace the old battery
-  # with the new one.
-  #
-  # Now, what if you wish to create a new Automobile derived from existing technology: a HybridAutomobile subclass. For this
-  # particular HybridAutomobile class, let's simply say the only difference between it and its parent is which kind of
-  # Battery it uses -- it requires its own special subclass of Battery. With Automobile's current implementation, its
-  # references to which Battery it instantiates and uses are embedded in the immutable method defintions. This
-  # HybridAutomobile needs to override which Battery its superclass' methods use and nothing else.
-  #
-  # For this reason, the Battery class which Automobile uses is semantically a property which others may want to override.
-  # In OOP theory, we define overridable properties in the form of methods and override those methods in the subclasses.
-  #
-  # This method exposes one method which creates human-readable semantics to defining these relationships as properties. It's
-  # used as follows:
-  #
-  # class Automobile
-  #   relationship :battery => Battery
-  #   relationship :chassis => Chassis
-  #   # Other properties and instance methods here....
-  # end
-  #
-  # class HybridAutomobile < Automobile
-  #   relationship :battery => HybridBattery
-  # end
-  #
-  def relationships(relationship_mapping)
-    relationship_mapping.each_pair do |class_name, class_object|
-      define_method(class_name) { class_object }
-    end
-  end
-
-end

data/lib/adhearsion/foundation/string.rb

@@ -1,26 +0,0 @@
-class String
-
-  def unindent
-    gsub(/^\s*/,'')
-  end
-
-  def unindent!
-    gsub!(/^\s*/,'')
-  end
-
-  def self.random_char
-    case random_digit = rand(62)
-      when  0...10 then random_digit.to_s
-      when 10...36 then (random_digit + 55).chr
-      when 36...62 then (random_digit + 61).chr
-    end
-  end
-
-  def self.random(length_of_string=8)
-    Array.new(length_of_string) { random_char }.join
-  end
-
-  def nameify() downcase.gsub(/[^\w]/, '') end
-  def nameify!() replace nameify end
-
-end

data/lib/adhearsion/generators/app/templates/.ahnrc

@@ -1,34 +0,0 @@
-# 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/lib/adhearsion/generators/app/templates/README

@@ -1,8 +0,0 @@
-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/lib/adhearsion/generators/app/templates/components/ami_remote/ami_remote.rb

@@ -1,15 +0,0 @@
-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/lib/adhearsion/generators/app/templates/components/disabled/HOW_TO_ENABLE

@@ -1,7 +0,0 @@
-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/lib/adhearsion/generators/app/templates/components/disabled/stomp_gateway/README.markdown

@@ -1,47 +0,0 @@
-What is Stomp?
-==============
-
-Stomp is a very simple message-queue protocol with which two separate systems can communicate. Because the protocol is so simple, there are many Stomp server implementations from which you can choose. Some of these include
-
- - ActiveMQ (http://activemq.com)
- - Ruby "stompserver" gem (gem install stompserver)
- - RabbitMQ (http://rabbitmq.com)
-
-If you wish to get up and running with a development environment, the Ruby stompserver gem is a fantastic starting point. For a critical production system, ActiveMQ should probably be used but it bears the cumbersome paradigm of many "enterprisey" Java applications.
-
-How does it work?
-=================
-
-Stomp is used when certain processes have defined responsibilities. For example, your Adhearsion application's responsibility is to communicate with your Asterisk machine. Other processes (e.g. a Rails web application) will probably need to instruct Adhearsion to do something. Instructions may include
-
- - Start a new call between two given phone numbers
- - Have a particular call do something based on a new event
- - Hangup a call
-
-Below is a diagram which should give you a better idea of how it works.
-
-    Process  Process  Process (e.g. Rails)
-         \      |      /
-          \     |     /
-           Stomp Server       (e.g. ActiveMQ)
-                |
-                |
-             Process          (e.g. Adhearsion)
-
-Note: Adhearsion could also be the sender of messages through the Stomp server which are consumed by a number of handlers.
-
-Setting up a Ruby Stomp server
-==============================
-
-Install the pure-Ruby Stomp server by doing "gem install stompserver". This will add the "stompserver" command to your system. When running it without any parameters, it starts without requiring authentication. If you're wanting to get a quick experiment running, I recommend simply doing that.
-
-Open the `stomp_gateway.yml` file in the stomp_gateway component folder. Comment out the four settings at the top of the file named "user", "pass", "host" and "port" by prepending a "#" to their line. This will cause the component to choose defaults for those properties. The component's defaults will match the expected credentials for the experimental stompserver you're already running on your computer.
-
-You also need specify a subscription name in
-
-    events.stomp.start_call.each do |event|
-      # The "event" variable holds a Stomp::Message object.
-      name = event.headers
-    end
-
-You a

data/lib/adhearsion/generators/app/templates/components/disabled/stomp_gateway/stomp_gateway.rb

@@ -1,34 +0,0 @@
-require 'stomp'
-
-# TODO: Recover from a disconnect!
-
-initialization do
-  user = COMPONENTS.stomp_gateway[:user] || ""
-  pass = COMPONENTS.stomp_gateway[:pass] || ""
-  host = COMPONENTS.stomp_gateway[:host] || "localhost"
-  port = COMPONENTS.stomp_gateway[:port] || 61613
-
-  ::StompGatewayConnection = Stomp::Client.open(user, pass, host, port)
-
-  subscriptions = COMPONENTS.stomp_gateway["subscriptions"]
-
-  ahn_log.stomp_gateway "Connection established. Subscriptions: #{subscriptions.inspect}"
-
-  Events.register_namespace_name "/stomp"
-
-  subscriptions.each do |subscription|
-    Events.register_namespace_name "/stomp/#{subscription}"
-    ::StompGatewayConnection.subscribe subscription do |event|
-      Adhearsion::Events.trigger ["stomp", subscription], event
-    end
-  end
-
-end
-
-methods_for :global do
-  def send_stomp(destination, message, headers={})
-    ::StompGatewayConnection.send(destination, message, headers)
-  end
-end
-
-# In the future, I may add a methods_for(:events) method which allows synchronous messaging.

data/lib/adhearsion/generators/app/templates/components/disabled/stomp_gateway/stomp_gateway.yml

@@ -1,12 +0,0 @@
-# Comment out any of these properties to use a default.
-
-user: stomp_user
-pass: secret_password
-host: localhost
-port: 61613
-
-### Add your list of subscriptions below that this gateway should proxy to events.rb
-
-# subscriptions:
-#   - start_call
-#   - hungup_call

data/lib/adhearsion/generators/app/templates/components/disabled/xmpp_gateway/README.markdown

@@ -1,3 +0,0 @@
-In order to use this component, you must have an XMPP connection enabled in config/startup.rb. It is recommended this be done as an XMPP component rather than a standard client.
-
-You can use all elements of the Blather DSL scoped to XMPP::Connection

data/lib/adhearsion/generators/app/templates/components/disabled/xmpp_gateway/xmpp_gateway.rb

@@ -1,11 +0,0 @@
-initialization do
-  
-  XMPP::Connection.message :body do |m|
-    XMPP::Connection.say m.from, "You said: #{m.body}"
-  end
-  
-  XMPP::Connection.subscription :request? do |s|
-    XMPP::Connection.write_to_stream s.approve!
-  end
-
-end

data/lib/adhearsion/generators/app/templates/config/startup.rb

@@ -1,81 +0,0 @@
-require File.join(File.dirname(__FILE__), 'environment')
-
-Adhearsion::Configuration.configure do |config|
-
-  # Components to load from the system.
-  # All components that are activated in components/ will be automatically
-  # loaded and made available.
-  # This configuration option allows you to load components provided by gems.
-  # List the gem names here:
-  # config.add_component "ahn_test_component"
-
-  # Log configuration
-  # :level : Supported levels (in increasing severity) -- :debug < :info < :warn < :error < :fatal
-  # :outputters : An array of log outputters to use. The default is to log to stdout and log/adhearsion.log
-  # :formatters : An array of log formatters to apply to the outputters in use
-  # :formatter : A log formatter to apply to all active outputters
-  config.logging :level => :info
-
-  # Whether incoming calls be automatically answered. Defaults to true.
-  # config.automatically_answer_incoming_calls = false
-
-  # Whether the other end hanging up should end the call immediately. Defaults to true.
-  # config.end_call_on_hangup = false
-
-  # Whether to end the call immediately if an unrescued exception is caught. Defaults to true.
-  # config.end_call_on_error = false
-
-  # NOTE: Pay special attention to the argument_delimiter field below:
-  # For Asterisk <= 1.4, use "|" (default)
-  # For Asterisk >= 1.6, use ","
-  # The delimiter can also be specified in Asterisk's asterisk.conf.
-  # This setting applies only to AGI.  The AMI delimiter is auto-detected.
-  # NB: The AMI user should have write access in order to execute actions, and AMI connections will fail otherwise.
-  config.enable_asterisk :argument_delimiter => '|'
-  # config.asterisk.enable_ami :host => "127.0.0.1", :username => "admin", :password => "password", :events => true
-
-  # Adhearsion supports two possible speech engines with Asterisk: UniMRCP and Cepstral.
-  # Uncomment one of the below if you have it available.
-  # config.asterisk.speech_engine = :cepstral
-  # config.asterisk.speech_engine = :unimrcp
-
-  # config.enable_drb
-
-  # Streamlined Rails integration! The first argument should be a relative or absolute path to
-  # the Rails app folder with which you're integrating. The second argument must be one of the
-  # the following: :development, :production, or :test.
-
-  # config.enable_rails :path => 'gui', :env => :development
-
-  # Note: You CANNOT do enable_rails and enable_database at the same time. When you enable Rails,
-  # it will automatically connect to same database Rails does and load the Rails app's models.
-
-  # Configure a database to use ActiveRecord-backed models. See ActiveRecord::Base.establish_connection
-  # for the appropriate settings here.
-  # You can also override the default log destination by supplying an alternate
-  # logging object with :logger.  The default is ahn_log.db.
-  # config.enable_database :adapter  => 'mysql',
-  #                        :username => 'joe',
-  #                        :password => 'secret',
-  #                        :host     => 'db.example.org'
-
-  # Configure an LDAP connection using ActiveLdap.  See ActiveLdap::Base.establish_connect
-  # for the appropriate settings here.
-  # config.enable_ldap :host => 'ldap.dataspill.org',
-  #                    :port => 389,
-  #                    :base => 'dc=dataspill,dc=org',
-  #                    :logger => ahn_log.ldap,
-  #                    :bind_dn => "uid=drewry,ou=People,dc=dataspill,dc=org",
-  #                    :password => 'password12345',
-  #                    :allow_anonymous => false,
-  #                    :try_sasl => false
-
-  # Configure XMPP call controller
-  # config.enable_xmpp :jid => 'active-calls.xmpp.example.com',
-  #                    :password => 'passwd',
-  #                    :server => 'xmpp.example.com',
-  #                    :port => 5347
-
-end
-
-Adhearsion::Initializer.start_from_init_file(__FILE__, File.dirname(__FILE__) + "/..")

data/lib/adhearsion/generators/app/templates/dialplan.rb

@@ -1,3 +0,0 @@
-adhearsion {
-  simon_game
-}

data/lib/adhearsion/generators/app/templates/events.rb

@@ -1,33 +0,0 @@
-##
-# In this file you can define callbacks for different aspects of the framework. Below is an example:
-##
-#
-# events.asterisk.before_call.each do |call|
-#   # This simply logs the extension for all calls going through this Adhearsion app.
-#   extension = call.variables[:extension]
-#   ahn_log "Got a new call with extension #{extension}"
-# end
-#
-##
-# Asterisk Manager Interface example:
-#
-# events.asterisk.manager_interface.each do |event|
-#   ahn_log.events event.inspect
-# end
-#
-# This assumes you gave :events => true to the config.asterisk.enable_ami method in config/startup.rb
-#
-##
-# Here is a list of the events included by default:
-#
-# - events.exception
-# - events.asterisk.manager_interface
-# - events.after_initialized
-# - events.shutdown
-# - events.asterisk.before_call
-# - events.asterisk.failed_call
-# - events.asterisk.hungup_call
-#
-#
-# Note: events are mostly for components to register and expose to you.
-##