tropo-rest 0.0.1 → 0.1.0

data/LICENSE

@@ -0,0 +1,19 @@
+Copyright (C) 2011 by Ben Langfeld
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,39 @@
+TropoREST
+--------
+
+TropoREST provides a wrapper for the Tropo REST API and also for Troplets.
+
+Installation
+============
+    gem install tropo-rest
+
+Library
+=======
+
+    require 'tropo-rest'
+    TropoREST.tokens = {tropo: {voice: 'your_voice_token', messaging: 'your_messaging_token'}, troplets: {voice: 'your_troplets_voice_token', messaging: 'your_troplets_messaging_token'}}
+
+    TropoREST.originate some_options_hash
+
+Check out the [YARD documentation](http://rdoc.info/github/benlangfeld/tropo-rest/master/frames) for more
+
+Console
+=======
+
+TropoREST comes with a basic console for testing purposes. You can launch it via the `tropo-rest` binary and you will be asked for your application tokens. You can alternatively provide them as arguments in the order tropo\_voice, tropo\_messaging, troplets\_voice, troplets\_messaging.
+
+
+Note on Patches/Pull Requests
+-----------------------------
+
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a future version unintentionally.
+* Commit, do not mess with rakefile, version, or history.
+  * If you want to have your own version, that is fine but bump version in a commit by itself so I can ignore when I pull
+* Send me a pull request. Bonus points for topic branches.
+
+Copyright
+---------
+
+Copyright (c) 2011 Ben Langfeld. MIT licence (see LICENSE for details).

data/lib/tropo-rest.rb

@@ -1,23 +1,35 @@
-require 'json'
-require 'httparty'
-require 'logger'
-require 'singleton'
+%w{active_support/core_ext/class/attribute_accessors active_support/core_ext/object/blank json httparty logger}.each { |l| require l }
 
 module TropoREST
-  class API
-    include HTTParty
-    include Singleton
-
-    attr_writer :logger
+  class << self
+    def logger=(logger)
+      [API, Troplets].each do |endpoint|
+        endpoint.send :logger=, logger
+      end
+    end
 
-    def initialize
-      @logger = Logger.new STDOUT
-      @logger.level = Logger::WARN
+    def tokens=(tokens)
+      [[:tropo, API], [:troplets, Troplets]].each do |type, target|
+        if token = tokens[type]
+          if token.is_a? String
+            target.voice_token = token
+          elsif token.is_a? Hash
+            target.voice_token = token[:voice]
+            target.messaging_token = token[:messaging]
+          end
+        end
+      end
     end
 
-    def token=(token)
-      self.class.default_params token: token
+    def method_missing(method_name, *args, &block)
+      API.send method_name, *args, &block
     end
+  end
+
+  class API
+    include HTTParty
+
+    cattr_accessor :logger, :voice_token, :messaging_token
 
     base_uri 'https://api.tropo.com'
     SESSION_URI = '/1.0/sessions'
@@ -25,22 +37,52 @@ module TropoREST
     format :json
     headers 'Accept' => 'application/json', 'content-type' => 'application/json'
 
-    def originate(options = {})
-      @logger.debug "Originating Tropo call with parameters #{options}"
-      resp = self.class.post SESSION_URI, body: options
-      @logger.debug "Tropo origination responded with: #{resp.inspect}"
-      resp
-    end
+    self.logger = Logger.new STDOUT
+    self.logger.level = Logger::DEBUG
+    debug_output self.logger
+
+    class << self
+      def originate(options = {})
+        logger.info "Originating Tropo call with parameters #{options}"
+        resp = request SESSION_URI, options
+        logger.info "Tropo origination responded with: #{resp.inspect}"
+        resp
+      end
+
+      def fire_event(event_name, session_id)
+        logger.info "Firing event #{event_name} into Tropo session #{session_id}"
+        resp = request "#{SESSION_URI}/#{session_id}/signals", value: event_name
+        logger.info "Tropo event trigger responded with: #{resp.inspect}"
+        resp
+      end
 
-    def fire_event(event_name, session_id)
-      @logger.debug "Firing event #{event_name} into Tropo session #{session_id}"
-      resp = self.class.post "#{SESSION_URI}/#{session_id}/signals", body: { value: event_name }
-      @logger.debug "Tropo event trigger responded with: #{resp.inspect}"
-      resp
+      def request(target, body, type = nil)
+        options = options_with_token body, type
+        logger.debug "Making request to #{target} with #{options.inspect}"
+        post target, body: options.to_json
+      end
+
+      def options_with_token(options, type = :voice)
+        token = case type
+        when :messaging then messaging_token
+        else voice_token
+        end
+        options.merge! token: token
+      end
     end
   end
 
-  def self.method_missing(method_name, *args, &block)
-    API.instance.send method_name, *args, &block
+  class Troplets < API
+    base_uri 'http://troplets.tropo.com'
+
+    class << self
+      def say(to, message, options = {})
+        logger.debug "Using Troplets to say #{message} to #{to}"
+        options.merge! to: to, message: message
+        resp = request '/say', options, options[:channel] == :voice ? :voice : :messaging
+        logger.debug "Troplet#say responded with: #{resp.inspect}"
+        resp
+      end
+    end
   end
 end

data/lib/tropo-rest/cli.rb

@@ -1,11 +1,29 @@
-require 'pry'
-require 'tropo-rest'
+%w{pry tropo-rest}.each { |l| require l }
 
 module TropoREST
   class CLI
     def self.start
-      print "Enter your Tropo app token for this session: "
-      TropoREST.token = gets
+      puts "Setting up your session..."
+
+      tokens = {tropo: {voice: ARGV[0], messaging: ARGV[1]}, troplets: {voice: ARGV[2], messaging: ARGV[3]}}
+      unless tokens[:tropo][:voice].present?
+        print "Enter your Tropo voice token: "
+        tokens[:tropo][:voice] = gets
+      end
+      unless tokens[:tropo][:messaging].present?
+        print "Enter your Tropo messaging token: "
+        tokens[:tropo][:messaging] = gets
+      end
+      unless tokens[:troplets][:voice].present?
+        print "Enter your Troplets voice token: "
+        tokens[:troplets][:voice] = gets
+      end
+      unless tokens[:troplets][:messaging].present?
+        print "Enter your Troplets messaging token: "
+        tokens[:troplets][:messaging] = gets
+      end
+
+      TropoREST.tokens = tokens
       pry
     end
   end

data/lib/tropo-rest/version.rb

@@ -1,3 +1,3 @@
 module TropoREST
-  VERSION = "0.0.1"
+  VERSION = "0.1.0"
 end

data/tropo-rest.gemspec

@@ -20,6 +20,7 @@ Gem::Specification.new do |s|
 
   s.add_dependency 'httparty'
   s.add_dependency 'pry'
+  s.add_dependency 'activesupport'
 
   s.add_development_dependency 'rspec'
   s.add_development_dependency 'yard'

metadata

@@ -4,9 +4,9 @@ version: !ruby/object:Gem::Version
   prerelease: false
   segments: 
   - 0
-  - 0
   - 1
-  version: 0.0.1
+  - 0
+  version: 0.1.0
 platform: ruby
 authors: 
 - Ben Langfeld
@@ -14,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-05-11 00:00:00 +01:00
+date: 2011-05-12 00:00:00 +01:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -44,7 +44,7 @@ dependencies:
   type: :runtime
   version_requirements: *id002
 - !ruby/object:Gem::Dependency 
-  name: rspec
+  name: activesupport
   prerelease: false
   requirement: &id003 !ruby/object:Gem::Requirement 
     none: false
@@ -54,10 +54,10 @@ dependencies:
         segments: 
         - 0
         version: "0"
-  type: :development
+  type: :runtime
   version_requirements: *id003
 - !ruby/object:Gem::Dependency 
-  name: yard
+  name: rspec
   prerelease: false
   requirement: &id004 !ruby/object:Gem::Requirement 
     none: false
@@ -69,6 +69,19 @@ dependencies:
         version: "0"
   type: :development
   version_requirements: *id004
+- !ruby/object:Gem::Dependency 
+  name: yard
+  prerelease: false
+  requirement: &id005 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id005
 description: 
 email: 
 - ben@langfeld.me
@@ -82,6 +95,8 @@ files:
 - .gitignore
 - .rspec
 - Gemfile
+- LICENSE
+- README.md
 - Rakefile
 - bin/tropo-rest
 - lib/tropo-rest.rb