creatary-sdk 1.3.0

data/.gitignore

@@ -0,0 +1,4 @@
+pkg
+Gemfile.lock
+coverage
+

data/Gemfile

@@ -0,0 +1,3 @@
+source 'http://rubygems.org'
+
+gemspec

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Nokia Siemens Networks
+
+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.mkd

@@ -0,0 +1,66 @@
+The Creatary Ruby gem
+====================================
+A Ruby wrapper for the Creatary REST APIs
+
+Installation
+------------
+	gem install creatary-sdk
+	
+Documentation
+-------------
+<https://creatary.com>
+
+How to Use
+----------
+If you are using rails then:
+
+1. Add the creatary-sdk gem to your Gemfile
+
+```ruby
+	gem 'creatary-sdk'
+```
+
+2. Create a creatary.yml file in config with following contents:
+
+```yaml
+	development: &defaults
+		consumer_key:     # the consumer key generated in telcoassetmarketplace.com for you application
+		consumer_secret:  # the consumer secret generated in telcoassetmarketplace.com for you application
+		consumer_handler: # the of the class that implements the Creatary handler logic
+	test:
+		<<: *defaults
+	production:
+		<<: *defaults
+```
+		
+3. Add following route to your routes.rb
+
+```ruby
+	match '/creatary/(:string)' => Creatary::API 	# you can replace 'creatary' with any other namespace
+```
+	
+4. Implement the Creatary handler logic (e.g.: creatary_handler.rb in helpers)
+
+```ruby
+	class CreataryHandler
+	  def authorized(user, session)
+		# should return the URL to which Creatary should redirect
+	  end
+
+	  def denied(session)
+		# should return the URL to which Creatary should redirect
+	  end
+	
+	  def receive_sms(from_user, to_app, body)
+	  end
+	  
+	end
+```	
+
+5. The routes exposed by the gem in your rails application are:
+
+```ruby
+	/creatary/authorize
+	/creatary/receive_sms		# use this one (complement to form absolute path) as SMS URL when registering your application in telcoassetmarketplace.com
+	/creatary/oauth_callback  # use this one (complement to form absolute path) as OAUTH callback URL when registering your application in telcoassetmarketplace.com
+```

data/Rakefile

@@ -0,0 +1,40 @@
+begin
+  require "bundler"
+  Bundler.setup
+rescue LoadError
+  $stderr.puts "You need to have Bundler installed to be able build this gem."
+end
+
+gemspec = eval(File.read(Dir["*.gemspec"].first))
+
+
+desc "Validate the gemspec"
+task :gemspec do
+  gemspec.validate
+end
+
+desc "Build gem locally"
+task :build => :gemspec do
+  system "gem build #{gemspec.name}.gemspec"
+  FileUtils.mkdir_p "pkg"
+  FileUtils.mv "#{gemspec.name}-#{gemspec.version}.gem", "pkg"
+end
+
+desc "Install gem locally"
+task :install => :build do
+  system "gem install pkg/#{gemspec.name}-#{gemspec.version}"
+end
+
+desc "Clean automatically generated files"
+task :clean do
+  FileUtils.rm_rf "pkg"
+end
+
+require 'spec/rake/spectask'
+
+Spec::Rake::SpecTask.new(:spec) do |t|
+  t.spec_files = Dir.glob('spec/**/*_spec.rb')
+end
+
+desc "Run tests"
+task :default => :spec

data/creatary-sdk.gemspec

@@ -0,0 +1,45 @@
+# coding: UTF-8
+require File.expand_path('../lib/creatary/version', __FILE__)
+
+Gem::Specification.new do |s|
+  s.add_runtime_dependency('sinatra', '~> 1.2.1')
+  s.add_runtime_dependency('json', '~> 1.5')
+  s.add_runtime_dependency('oauth', '~> 0.4.3')
+  
+  s.add_development_dependency('rake', '= 0.9.2')
+  s.add_development_dependency('rspec', '= 1.3.2')
+  s.add_development_dependency('rack-test', "~> 0.6.1")
+  s.add_development_dependency('mocha', '~> 0.9.0')
+  s.add_development_dependency('webmock', '~> 1.7.0')
+  s.add_development_dependency('simplecov', '~> 0.5.0')
+    
+  s.name = "creatary-sdk"
+  s.version = Creatary::VERSION.dup
+  s.platform = Gem::Platform::RUBY
+  s.authors = ["Carlos Manzanares"]
+  s.email = ["developers@creatary.com"]
+  s.homepage = "https://github.com/creatary/creatary-ruby-sdk"
+  s.description = %q{The Ruby gem for the Creatary REST APIs}
+  s.summary = "Creatary Ruby gem"
+  s.rubyforge_project = s.name
+
+  s.required_rubygems_version = Gem::Requirement.new('>= 1.3.6') if s.respond_to? :required_rubygems_version=
+  
+  s.require_path = 'lib'
+  s.executables = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.files = `git ls-files`.split("\n")
+  s.test_files = `git ls-files -- {test,spec,features}/*`.split("\n")  
+
+  s.post_install_message =<<eos
+********************************************************************************
+
+  Visit our community pages for up-to-date information on 
+  Creatary:
+      https://creatary.com/
+  Notice that in order to use this gem you will also need to register as a 
+  developer in Creatary:
+      https://telcoassetmarketplace.com
+
+********************************************************************************  
+eos
+end

data/lib/creatary.rb

@@ -0,0 +1,17 @@
+require 'creatary/railtie' if defined? ::Rails::Railtie
+require 'creatary/configuration'
+require 'creatary/api'
+
+module Creatary
+  extend Configuration
+
+  # If in rails environment then we use the rails default logger
+  # otherwise we create one that points to the standard output
+  LOGGER = 
+    if defined? Rails 
+      Rails.logger
+    else 
+      Logger.new(STDOUT)
+    end
+
+end

data/lib/creatary/api.rb

@@ -0,0 +1,74 @@
+require 'sinatra'
+require 'oauth'
+require 'creatary/error'
+require 'creatary/user'
+
+module Creatary
+  # Wrapper for the Creatary REST API
+  #
+  # @note All methods have been separated into modules and follow the same grouping used in {https://creatary.com the Creatary API Documentation}.
+  # @see http://creatary.com
+  class API < Sinatra::Base
+    # Require api method modules after initializing the API class in
+    # order to avoid a superclass mismatch error, allowing those modules to be
+    # API-namespaced.
+    require 'creatary/api/oauth'
+    require 'creatary/api/sms'
+    require 'creatary/api/location'
+    require 'creatary/api/charging'
+    
+    # Dispatches the request to the Creatary handler configured by 
+    # this gem client
+    def dispatch_to_handler(method, *args)
+      if Creatary.consumer_handler.nil?
+        LOGGER.error 'Application has not configured the Creatary consumer_handler'
+        raise InvalidConsumerHandler.new 'Application has not configured the Creatary consumer_handler'
+      end
+      
+      if Creatary.consumer_handler.respond_to?(method)
+        begin
+          return Creatary.consumer_handler.send(method, *args)
+        rescue Creatary::Error => error
+          LOGGER.error 'Application has suffered an internal error: ' + error.message + ', ' + error.body
+          raise error
+        end
+      end
+      
+    end
+    
+    # Dispatches the request to the Creatary REST API
+    def self.dispatch_to_server(http_method, endpoint, user, payload='')
+      consumer = create_oauth_consumer
+      access_token = OAuth::AccessToken.new(consumer, user.access_token, user.token_secret)
+
+      if (http_method == :get)
+        response = access_token.send(http_method, endpoint, {'Content-Type' => 'application/json'})
+      else
+        response = access_token.send(http_method, endpoint, payload, {'Content-Type' => 'application/json'})
+      end
+      
+      if response.class == Net::HTTPOK
+        return response.body
+      elsif response.class == Net::HTTPUnauthorized
+        LOGGER.error 'Request not authorized ' + response.message + ', ' + response.body
+        raise RequestNotAuthorized.new(response.message, response.body)
+      elsif response.class == Net::HTTPBadRequest
+        if response.body.include? 'consumer_key_unknown'
+          LOGGER.error 'Configured Creatary consumer_key is not valid: ' + response.message + ', ' + response.body
+          raise InvalidConsumerKey.new(response.message, response.body)
+        elsif response.body.include? 'signature_invalid'
+          LOGGER.error 'Configured Creatary consumer_secret is not valid: ' + response.message + ', ' + response.body
+          raise InvalidConsumerSecret.new(response.message, response.body)
+        else
+          raise UnexpectedError.new(response.message, response.body)
+        end
+      elsif response.class == Net::HTTPServiceUnavailable
+        LOGGER.error 'Creatary service ' + endpoint + ' not available'
+        raise ServiceUnavailable.new(response.message, response.body)
+      else
+        raise UnexpectedError.new(response.message, response.body)
+      end
+    end
+    
+  end
+end

data/lib/creatary/api/charging.rb

@@ -0,0 +1,36 @@
+require 'json'
+require 'creatary/user'
+require 'creatary/error'
+
+# Charging part of the Creatary REST API
+module Creatary
+  class API
+    # Requests for charging or payment to the subscriber account in the operator billing system by amount.
+    #
+    # @return [Hash] 
+    #   {"status"=>{"code"=>0, "message"=>"Request was handled succesfully"}}
+    def self.charge_by_amount(user, amount)
+      begin
+        payload = JSON.generate({'method' => 'AMOUNT', 'amount' => amount.to_s})
+        response = dispatch_to_server(:post, '/api/1/charge/request', user, payload)
+        JSON.parse response
+      rescue Creatary::ServiceUnavailable
+        raise Creatary::ServiceUnavailable.new 'The charging service is not available. If you are using the service on a persona, i.e.: through the sandbox, then remember to set the balance of that persona'
+      end
+    end
+    
+    # Requests for charging or payment to the subscriber account in the operator billing system byt charging code.
+    #
+    # @return [Hash] 
+    #   {"status"=>{"code"=>0, "message"=>"Request was handled succesfully"}}
+    def self.charge_by_code(user, code)
+      begin
+        payload = JSON.generate({'method' => 'CODE', 'charging_code' => code.to_s})
+        response = dispatch_to_server(:post, '/api/1/charge/request', user, payload)
+        JSON.parse response
+      rescue Creatary::ServiceUnavailable
+        raise Creatary::ServiceUnavailable.new 'The charging service is not available. If you are using the service on a persona, i.e.: through the sandbox, then remember to set the balance of that persona'
+      end
+    end
+  end
+end

data/lib/creatary/api/location.rb

@@ -0,0 +1,26 @@
+require 'json'
+require 'creatary/user'
+require 'creatary/error'
+
+# SMS part of the Creatary REST API
+module Creatary
+  class API
+    # Find the location (coordinates) of a user
+    #
+    # @return [Hash] 
+    #   {"body"=>
+    #    {"latitude"=>51.618,
+    #     "timestamp"=>1302185772456,
+    #     "accuracy"=>100,
+    #     "longitude"=>23.9063},
+    #   "status"=>{"code"=>0, "message"=>"Request was handled succesfully"}}
+    def self.getcoord(user)
+      begin
+        response = dispatch_to_server(:get, '/api/1/location/getcoord', user)
+        JSON.parse response
+      rescue Creatary::ServiceUnavailable
+        raise Creatary::ServiceUnavailable.new 'The location service is not available. If you are using the service on a persona, i.e.: through the sandbox, then remember to set the location of the persona'
+      end
+    end
+  end
+end

data/lib/creatary/api/oauth.rb

@@ -0,0 +1,55 @@
+require 'sinatra'
+require 'oauth'
+require 'creatary/error'
+require 'creatary/user'
+
+# OAUTH part of the Creatary REST API
+module Creatary
+  class API
+    enable :sessions
+    
+    # Authorizes a user of Creatary to use your application
+    # After the OAUTH flow is finished then the configured consumer_handler.authorized(user, session)
+    # or consumer_handler.denied(session) are invoked
+    get '/*/authorize' do
+      consumer = Creatary::API.create_oauth_consumer
+      request_token = consumer.get_request_token
+      session[:request_token] = request_token
+      
+      oauth_callback_url = url('/' + Creatary.callback_path + '/oauth_callback')
+      redirect request_token.authorize_url(:oauth_callback => oauth_callback_url)
+    end
+    
+    # OAUTH callback for Creatary
+    # @private
+    get '/*/oauth_callback' do
+      if params[:denied].nil?
+        consumer = Creatary::API.create_oauth_consumer
+        request_token = session[:request_token]
+        verifier = params[:oauth_verifier]
+        access_token = request_token.get_access_token(:oauth_verifier => verifier)
+        user = User.new(access_token.token, access_token.secret)
+        redirect url(dispatch_to_handler('authorized', user, session))
+      else
+        redirect url(dispatch_to_handler('denied', session))
+      end
+    end
+    
+    private
+    def self.create_oauth_consumer
+      if Creatary.consumer_key.nil? or Creatary.consumer_secret.nil?
+        raise OAuthConsumerAttributesMissing.new
+      end
+      
+      OAuth::Consumer.new(Creatary.consumer_key, Creatary.consumer_secret,
+        {
+          :site => Creatary.site,
+          :request_token_path => Creatary.request_token_path,
+          :access_token_path => Creatary.access_token_path,  
+          :authorize_path => Creatary.authorize_path, 
+          :scheme => Creatary.oauth_scheme,
+          :http_method => Creatary.oauth_http_method
+        })
+    end
+  end
+end

data/lib/creatary/api/sms.rb

@@ -0,0 +1,47 @@
+require 'sinatra'
+require 'oauth'
+require 'json'
+require 'creatary/user'
+
+# SMS part of the Creatary REST API
+module Creatary
+  class API
+    # URL handler for receiving SMS
+    # After receiving an SMS, the configured 
+    # consumer_handler.receive_sms(from_user, to_app, body)
+    # is invoked
+    #
+    # @private
+    post "/*/receive_sms" do
+      request.body.rewind # in case someone already read it
+      
+      data = JSON.parse request.body.read
+
+      access_token = data["access_token"]
+      token_secret = data["token_secret"]
+      from_user = User.new(access_token, token_secret)
+      to_app = data["to"]
+      body = data["body"]
+      transaction_id = data["transaction_id"]
+
+      begin
+        dispatch_to_handler('receive_sms', from_user, to_app, body, transaction_id)
+        response.status = 200
+        return ''
+      rescue Error => error
+        response.status = 500
+        return error.message
+      end
+    end
+    
+    # Sends an SMS
+    def self.send_sms(from_app, to_user, body, transaction_id = nil)
+      payload = {'body' => body, 'from' => from_app}
+      if transaction_id
+        payload["transaction_id"] = transaction_id
+      end
+      response = dispatch_to_server(:post, '/api/1/sms/send', to_user, JSON.generate(payload))
+      JSON.parse response
+    end
+  end
+end

data/lib/creatary/configuration.rb

@@ -0,0 +1,83 @@
+module Creatary
+  # Defines constants and methods related to configuration
+  module Configuration
+    # An array of valid keys in the options hash when configuring a {Creatary::API}
+    VALID_OPTIONS_KEYS = [
+      :consumer_key,
+      :consumer_secret,
+      :consumer_handler,
+      :site,
+      :request_token_path,
+      :access_token_path,
+      :authorize_path,
+      :oauth_scheme,
+      :oauth_http_method,
+      :callback_path].freeze
+
+    # @private
+    attr_accessor *VALID_OPTIONS_KEYS
+      
+    def consumer_handler=(consumer_handler)
+      if consumer_handler.class == String
+        begin
+          @consumer_handler = Object.const_get(consumer_handler).new
+        rescue NameError => error
+          LOGGER.error 'Application has provided an invalid Creatary consumer_handler: ' + Creatary.consumer_handler
+          raise InvalidConsumerHandler.new 'Application has provided an invalid Creatary consumer_handler: ' + Creatary.consumer_handler
+        end
+      else
+        @consumer_handler = consumer_handler
+      end
+    end
+    
+    def consumer_handler
+      @consumer_handler
+    end
+    
+    # When this module is extended, set all configuration options to their default values
+    def self.extended(base)
+      base.reset
+    end
+    
+    # Convenience method to allow configuration options to be set in a block
+    def configure
+      yield self
+    end
+    
+    def configure(config)
+      unless config.empty?
+        self.consumer_key       = config['consumer_key']        if config['consumer_key']
+        self.consumer_secret    = config['consumer_secret']     if config['consumer_secret']
+        self.consumer_handler   = config['consumer_handler']    if config['consumer_handler']
+        self.site               = config['site']                if config['site']
+        self.request_token_path = config['request_token_path']  if config['request_token_path']
+        self.access_token_path  = config['access_token_path']   if config['access_token_path']
+        self.authorize_path     = config['authorize_path']      if config['authorize_path']
+        self.oauth_scheme       = config['oauth_scheme']        if config['oauth_scheme']
+        self.oauth_http_method  = config['oauth_http_method']   if config['oauth_http_method']
+        self.callback_path      = config['callback_path']       if config['callback_path']
+      end
+    end
+    
+    # Create a hash of options and their values
+    def options
+      Hash[VALID_OPTIONS_KEYS.map {|key| [key, send(key)] }]
+    end
+
+    # Reset all configuration options to defaults
+    def reset
+      self.consumer_key       = nil
+      self.consumer_secret    = nil
+      self.consumer_handler   = nil
+      self.site               = 'https://telcoassetmarketplace.com'
+      self.request_token_path = '/api/1/oauth/request_token'
+      self.access_token_path  = '/api/1/oauth/access_token'
+      self.authorize_path     = '/web/authorize'
+      self.oauth_scheme       = :query_string
+      self.oauth_http_method  = :get
+      self.callback_path      = 'creatary'
+      self
+    end
+  end  
+end
+    

data/lib/creatary/error.rb

@@ -0,0 +1,40 @@
+module Creatary
+  # Custom error class for rescuing from all Creatary errors
+  class Error < StandardError
+    attr_reader :body
+
+    def initialize(message, body = '')
+      @body = body
+      super message
+    end
+  end
+  
+  # Raised when client tries to use any of the API methods that require OAUTH
+  # without configuring the consumer_key or consumer_secret
+  class OAuthConsumerAttributesMissing < Error
+    def initialize
+      super 'consumer_key or consumer_secret not configured'
+    end
+  end
+  
+  # Raised when client tries to use any of the API methods without user authorization
+  class RequestNotAuthorized < Error; end  
+
+  # Raised when client performs a wrong OAUTH interaction (this is a super-class)
+  class OAuthError < Error; end
+
+  # Raised when client is using an invalid consumer_key
+  class InvalidConsumerKey < OAuthError; end
+  
+  # Raised when client is using an invalid consumer_secret
+  class InvalidConsumerSecret < OAuthError; end
+  
+  # Raised when client is using an invalid consumer_handler
+  class InvalidConsumerHandler < Error; end
+
+  class UnexpectedError < Error; end  
+  
+  # Raised when one of the Creatary services is not available
+  class ServiceUnavailable < Error; end
+end
+  

data/lib/creatary/railtie.rb

@@ -0,0 +1,30 @@
+require 'rails'
+
+module Creatary
+  class CreataryRailtie < Rails::Railtie
+    initializer "creatary.boot" do
+      configure_with_yaml
+    end
+    
+    private
+    
+    # Attempts to load the Creatary configuration from config/creatary.yml
+    # in a rails 3 application.
+    # Besides using a creatary.yml, developers can also configure directly Creatary settings, e.g.:
+    # Creatary.consumer_key = 'h42woy35tl08o44l'
+    def configure_with_yaml
+      cfg = load_config(Rails.root.join('config', 'creatary.yml')).freeze
+      Creatary.configure(cfg)
+    end
+    
+    def load_config(yaml_file)
+      return {} unless File.exist?(yaml_file)
+      cfg = YAML::load(File.open(yaml_file))
+      if defined? Rails
+        cfg = cfg[Rails.env]
+      end
+      cfg
+    end
+    
+  end
+end

data/lib/creatary/user.rb

@@ -0,0 +1,16 @@
+module Creatary
+  # Represents an end-user of Creatary (a subscriber)
+  class User
+    attr_accessor :access_token
+    attr_accessor :token_secret
+    
+    def initialize(access_token, token_secret)
+      @access_token = access_token
+      @token_secret = token_secret
+    end
+    
+    def ==(another_user)
+        self.access_token == another_user.access_token and self.token_secret == another_user.token_secret
+    end
+  end
+end

data/lib/creatary/version.rb

@@ -0,0 +1,4 @@
+module Creatary
+  # The version of the gem
+  VERSION = '1.3.0'.freeze unless defined?(::Creatary::VERSION)
+end

data/spec/fixtures/getcoord_success.json

@@ -0,0 +1,11 @@
+{
+  "status": {
+    "code":0,
+    "message":"Message sent successfully"
+	}, "body": {
+		"latitude":10.0,
+    	"longitude":-20.0, 
+    	"accuracy":10, 
+    	"timestamp":1288747339000
+ 	}
+}

data/spec/fixtures/send_sms_success.json

@@ -0,0 +1,6 @@
+{
+  "status": {
+    "code":0,
+    "message":"Message sent successfully"
+  }
+}

data/spec/location_get_spec.rb

@@ -0,0 +1,46 @@
+require 'spec_helper'
+require 'creatary/api'
+require 'creatary/user'
+require 'rack/test'
+require 'json'
+require 'webmock/rspec'
+
+describe Creatary::API, "#getcoord" do
+  include WebMock::API
+  include OAuthSettings
+  
+  it "sends location request to platform" do
+    #given
+    Creatary.expects(:consumer_key).twice().returns(ConsumerKey)
+    Creatary.expects(:consumer_secret).twice().returns(ConsumerSecret)
+    Creatary.expects(:site).returns(Site)
+    Creatary.expects(:request_token_path).returns('/api/1/oauth/request_token')
+    Creatary.expects(:access_token_path).returns('/api/1/oauth/access_token')
+    Creatary.expects(:authorize_path).returns('/web/authorize')
+    Creatary.expects(:oauth_scheme).returns(:query_string)
+    Creatary.expects(:oauth_http_method).returns(:get)
+    http_stub = stub_request(:get, /.*\/api\/1\/location\/getcoord.*/).with { |request| assert_query(request.uri, OAuthParams) }.to_return(:body => load_fixture("getcoord_success.json"))
+                  
+    #when
+    body = Creatary::API.getcoord(Creatary::User.new(AccessToken, AccessSecret))
+    
+    #then
+    http_stub.should have_been_requested.times(1)
+    body["status"]["code"].should == 0
+    body["status"]["message"].should == "Message sent successfully"
+  end
+    
+  def load_fixture(fixture)
+    IO.read("spec/fixtures/#{fixture}")
+  end
+  
+  def assert_query(uri, params)
+    uri_params = uri.query_values
+    params.each do |key, value| 
+      if not value.match(uri_params[key])
+        return false
+      end
+    end
+    return true
+  end
+end

data/spec/sms_receive_spec.rb

@@ -0,0 +1,68 @@
+require 'spec_helper'
+require 'creatary/api'
+require 'creatary/user'
+require 'rack/test'
+require 'mocha'
+require 'json'
+
+describe Creatary::API, "when receiving sms" do
+  include Rack::Test::Methods
+
+  def app
+    Creatary::API
+  end
+  
+  before(:all) do
+    logger = stub('logger')
+    logger.stubs(:error)
+    Creatary.const_set(:LOGGER, logger)
+  end
+  
+  it "should pass request to creatary sms handler and render success" do
+    #given
+    handler = stub('consumer_handler')
+    handler.expects(:respond_to?).with('receive_sms').returns(true)
+    handler.expects(:send).with('receive_sms', Creatary::User.new('token', 'secret'), 'to_app', 'message', nil)
+    Creatary.expects(:consumer_handler).times(3).returns(handler)
+    #when
+    post '/creatary/receive_sms', JSON.generate({ 'body' => 'message', 'to' => 'to_app', 'from' => 'from_user' ,'access_token' => 'token', 'token_secret' => 'secret'})
+    #then
+    last_response.should be_ok
+  end
+  
+  it "should pass request with transaction to creatary sms handler and render success" do
+    #given
+    handler = stub('consumer_handler')
+    handler.expects(:respond_to?).with('receive_sms').returns(true)
+    handler.expects(:send).with('receive_sms', Creatary::User.new('token', 'secret'), 'to_app', 'message', 'tran_id')
+    Creatary.expects(:consumer_handler).times(3).returns(handler)
+    #when
+    post '/creatary/receive_sms', JSON.generate({ 'body' => 'message', 'to' => 'to_app', 'from' => 'from_user','transaction_id' => 'tran_id','access_token' => 'token', 'token_secret' => 'secret'})
+    #then
+    last_response.should be_ok
+  end
+  
+  it "should pass request to creatary sms handler and render error on unexpected error" do
+    #given
+    handler = stub('consumer_handler')
+    handler.expects(:respond_to?).with('receive_sms').returns(true)
+    handler.stubs(:send).raises(Creatary::UnexpectedError.new("Cannot handle"))
+    Creatary.expects(:consumer_handler).times(3).returns(handler)
+    #when
+    post '/creatary/receive_sms', JSON.generate({ 'body' => 'message', 'to' => 'to_app', 'from' => 'from_user','transaction_id' => 'tran_id','access_token' => 'token', 'token_secret' => 'secret'})
+    #then
+    last_response.should be_server_error
+    last_response.body.should == "Cannot handle"
+  end
+  
+  it "should pass request to creatary sms handler and render error on missing consumer_handler" do
+    #given
+    handler = stub('consumer_handler')
+    Creatary.expects(:consumer_handler).times(1).returns(nil)
+    #when
+    post '/creatary/receive_sms', JSON.generate({ 'body' => 'message', 'to' => 'to_app', 'from' => 'from_user','transaction_id' => 'tran_id','access_token' => 'token', 'token_secret' => 'secret'})
+    #then
+    last_response.should be_server_error
+    last_response.body.should == "Application has not configured the Creatary consumer_handler"
+  end
+end

data/spec/sms_send_spec.rb

@@ -0,0 +1,71 @@
+require 'spec_helper'
+require 'creatary/api'
+require 'creatary/user'
+require 'rack/test'
+require 'json'
+require 'webmock/rspec'
+
+describe Creatary::API, "when sending sms" do
+  include WebMock::API
+  include OAuthSettings
+  
+  it "should successfully send the request to platform" do
+    #given
+    Creatary.expects(:consumer_key).twice().returns(ConsumerKey)
+    Creatary.expects(:consumer_secret).twice().returns(ConsumerSecret)
+    Creatary.expects(:site).returns(Site)
+    Creatary.expects(:request_token_path).returns('/api/1/oauth/request_token')
+    Creatary.expects(:access_token_path).returns('/api/1/oauth/access_token')
+    Creatary.expects(:authorize_path).returns('/web/authorize')
+    Creatary.expects(:oauth_scheme).returns(:query_string)
+    Creatary.expects(:oauth_http_method).returns(:get)
+    http_stub = stub_request(:post, /.*\/api\/1\/sms\/send.*/).with { |request|  assert_request(request, { :query => OAuthParams, :body => "{\"body\":\"test message\",\"from\":\"to_app\"}"})}.to_return(:body => load_fixture("send_sms_success.json"))
+                  
+    #when
+    body = Creatary::API.send_sms("to_app", Creatary::User.new(AccessToken,  AccessSecret), 'test message')
+    
+    #then
+    http_stub.should have_been_requested.times(1)
+    body["status"]["code"].should == 0
+    body["status"]["message"].should == "Message sent successfully"
+  end
+  
+  it "sends sms request with transaction id to platform" do
+    #given
+    Creatary.expects(:consumer_key).twice().returns(ConsumerKey)
+    Creatary.expects(:consumer_secret).twice().returns(ConsumerSecret)
+    Creatary.expects(:site).returns(Site)
+    Creatary.expects(:request_token_path).returns('/api/1/oauth/request_token')
+    Creatary.expects(:access_token_path).returns('/api/1/oauth/access_token')
+    Creatary.expects(:authorize_path).returns('/web/authorize')
+    Creatary.expects(:oauth_scheme).returns(:query_string)
+    Creatary.expects(:oauth_http_method).returns(:get)
+    http_stub = stub_request(:post, /.*\/api\/1\/sms\/send.*/).with { |request| assert_request(request, { :query => OAuthParams, :body => "{\"body\":\"test message\",\"from\":\"to_app\",\"transaction_id\":\"tran_id\"}"})}.to_return(:body => load_fixture("send_sms_success.json"))
+                  
+    #when
+    body = Creatary::API.send_sms("to_app", Creatary::User.new(AccessToken,  AccessSecret), 'test message', 'tran_id')
+    
+    #then
+    http_stub.should have_been_requested.times(1)
+    body["status"]["code"].should == 0
+    body["status"]["message"].should == "Message sent successfully"
+  end
+  
+  def load_fixture(fixture)
+    IO.read("spec/fixtures/#{fixture}")
+  end
+  
+  def assert_request(req, matchers)
+    return (assert_query(req.uri, matchers[:query]) and req.body == matchers[:body])
+  end
+  
+  def assert_query(uri, params)
+    uri_params = uri.query_values
+    params.each do |key, value| 
+      if not value.match(uri_params[key])
+        return false
+      end
+    end
+    return true
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,14 @@
+require 'simplecov'
+SimpleCov.start do
+  add_filter "/spec/"
+end
+
+module OAuthSettings
+  AccessToken = "token"
+  AccessSecret = "secret"
+  ConsumerKey = "consumer_key"
+  ConsumerSecret = "consumer_secret"
+  Site = "https://telcoassetmarketplace.com"
+  
+  OAuthParams = {"oauth_consumer_key" => /^#{ConsumerKey}$/, "oauth_signature_method" => /^HMAC-SHA1$/, "oauth_nonce" => /.+/,  "oauth_signature" => /.+/, "oauth_timestamp" => /^[0-9]+$/, "oauth_version" => /^1.0$/, "oauth_token" => /^#{AccessToken}$/}
+end

metadata

@@ -0,0 +1,177 @@
+--- !ruby/object:Gem::Specification
+name: creatary-sdk
+version: !ruby/object:Gem::Version
+  version: 1.3.0
+  prerelease: 
+platform: ruby
+authors:
+- Carlos Manzanares
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-01-24 00:00:00.000000000Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: sinatra
+  requirement: &2161550180 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.2.1
+  type: :runtime
+  prerelease: false
+  version_requirements: *2161550180
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: &2161549680 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.5'
+  type: :runtime
+  prerelease: false
+  version_requirements: *2161549680
+- !ruby/object:Gem::Dependency
+  name: oauth
+  requirement: &2161549220 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.4.3
+  type: :runtime
+  prerelease: false
+  version_requirements: *2161549220
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: &2161548760 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - =
+      - !ruby/object:Gem::Version
+        version: 0.9.2
+  type: :development
+  prerelease: false
+  version_requirements: *2161548760
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &2161548300 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - =
+      - !ruby/object:Gem::Version
+        version: 1.3.2
+  type: :development
+  prerelease: false
+  version_requirements: *2161548300
+- !ruby/object:Gem::Dependency
+  name: rack-test
+  requirement: &2161547840 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.6.1
+  type: :development
+  prerelease: false
+  version_requirements: *2161547840
+- !ruby/object:Gem::Dependency
+  name: mocha
+  requirement: &2161547380 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.9.0
+  type: :development
+  prerelease: false
+  version_requirements: *2161547380
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: &2161546920 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.7.0
+  type: :development
+  prerelease: false
+  version_requirements: *2161546920
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: &2161546460 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.5.0
+  type: :development
+  prerelease: false
+  version_requirements: *2161546460
+description: The Ruby gem for the Creatary REST APIs
+email:
+- developers@creatary.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE
+- README.mkd
+- Rakefile
+- creatary-sdk.gemspec
+- lib/creatary.rb
+- lib/creatary/api.rb
+- lib/creatary/api/charging.rb
+- lib/creatary/api/location.rb
+- lib/creatary/api/oauth.rb
+- lib/creatary/api/sms.rb
+- lib/creatary/configuration.rb
+- lib/creatary/error.rb
+- lib/creatary/railtie.rb
+- lib/creatary/user.rb
+- lib/creatary/version.rb
+- spec/fixtures/getcoord_success.json
+- spec/fixtures/send_sms_success.json
+- spec/location_get_spec.rb
+- spec/sms_receive_spec.rb
+- spec/sms_send_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/creatary/creatary-ruby-sdk
+licenses: []
+post_install_message: ! "********************************************************************************\n\n
+  \ Visit our community pages for up-to-date information on \n  Creatary:\n      https://creatary.com/\n
+  \ Notice that in order to use this gem you will also need to register as a \n  developer
+  in Creatary:\n      https://telcoassetmarketplace.com\n\n********************************************************************************
+  \ \n"
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: 1.3.6
+requirements: []
+rubyforge_project: creatary-sdk
+rubygems_version: 1.8.15
+signing_key: 
+specification_version: 3
+summary: Creatary Ruby gem
+test_files:
+- spec/fixtures/getcoord_success.json
+- spec/fixtures/send_sms_success.json
+- spec/location_get_spec.rb
+- spec/sms_receive_spec.rb
+- spec/sms_send_spec.rb
+- spec/spec_helper.rb