twilio-rb 0.1.1

data/lib/twilio/call.rb

@@ -0,0 +1,40 @@
+module Twilio
+  class Call
+    include Twilio::Resource
+
+    # Dials the call
+    def save
+      handle_response self.class.post "/Accounts/#{Twilio::ACCOUNT_SID}/Calls.json", :body => attributes
+    end
+
+    # Cancels a call if its state is 'queued' or 'ringing'    
+    def cancel!
+      state_guard { modify_call 'Status' => 'cancelled' }
+    end
+    
+    def complete!
+      state_guard { modify_call 'Status' => 'completed' }
+    end
+    
+    # Update Handler URL
+    def url=(url)
+      # If this attribute exists it is assumed the API call to create a call has been made, so we need to tell Twilio.
+      modify_call "url" => url if self[:status]
+      self[:url] = url
+    end
+
+    private
+
+    def state_guard(&blk)
+      if self[:status] # If this attribute exists it is assumed the API call to create a call has been made, and the object is in the correct state to make request.
+        blk.call
+      else
+        raise Twilio::InvalidStateError.new 'Call is in invalid state to perform this action.'
+      end
+    end
+
+    def modify_call(params)
+      handle_response self.class.post "/Accounts/#{Twilio::ACCOUNT_SID}/Calls/#{self[:sid]}.json", :body => params
+    end
+  end
+end

data/lib/twilio/config.rb

@@ -0,0 +1,14 @@
+module Twilio
+  module Config
+    def setup &blk
+      instance_eval &blk
+    end
+
+    def method_missing(meth, *args, &blk)
+      const = meth.to_s.upcase
+      Twilio.const_set(const, args.first) unless Twilio.const_defined? const
+    end
+
+    extend self
+  end
+end

data/lib/twilio/resource.rb

@@ -0,0 +1,100 @@
+require 'active_support/core_ext/string/inflections' # Chill! we only use the bits of AS we need!
+
+module Twilio
+  module Resource
+    def initialize(attrs ={})  #:nodoc:
+      @attributes = Hash[attrs.map { |k,v| [k.to_s.camelize, v.to_s] }]
+      normalize_http_verbs!
+      escape_send_digits! if attributes.include? 'SendDigits'
+      normalize_if_machine_parameter!
+    end
+
+    # Convenience for accessing attributes. Attributes can be accessed either using the
+    # preferred symbol style, e.g. :if_machine or using the Twilio stringified attribute
+    # style, e.g. 'IfMachine'
+    # Kind of like ActiveSupport::HashWithIndifferentAccess on crack.
+    def [](key)
+      accessor = key.is_a?(Symbol) ? key.to_s.camelize : key
+      attributes[accessor]
+    end
+
+    def []=(key,value)
+      accessor = key.is_a?(Symbol) ? key.to_s.camelize : key
+      attributes[accessor] = value
+    end
+
+    private
+
+    def handle_response(res) # :nodoc:
+      if res.code.to_s =~ /^(4|5)\d\d/
+        raise Twilio::APIError.new "Error ##{res.parsed_response['code']}: #{res.parsed_response['message']}"
+      else
+        attributes.update Hash[res.parsed_response.map { |k,v| [k.camelize, v] }] # params are camelized in requests, yet underscored in the repsonse. inconsistency FTW!
+      end
+    end
+
+    def normalize_http_verbs! #:nodoc:
+      # Twilio accepts a HTTP method for use with various callbacks. The API documentation
+      # indicates that the HTTP verbs are to be passed as upcase.
+      attributes.each { |k,v| v.upcase! if k =~ /Method$/ }
+    end
+
+    def escape_send_digits! #:nodoc:
+      # A pound, i.e. "#" has special meaning in a URL so it must be escaped
+      attributes.update 'SendDigits' => CGI.escape(attributes['SendDigits'])
+    end
+
+    def normalize_if_machine_parameter! #:nodoc:
+      attributes['IfMachine'].capitalize! if attributes['IfMachine']
+    end
+
+    def method_missing(meth, *args, &blk) #:nodoc
+      meth = meth.to_s.camelize
+      if meth.to_s =~ /\=$/
+        add_attr_writer meth
+        send meth, args.first
+      elsif attributes.include? meth = meth.gsub('=', '')
+        add_attr_reader meth
+        send meth
+      else
+        super
+      end
+    end
+
+    def add_attr_writer(attribute) #:nodoc
+      metaclass.class_eval do
+        attribute = attribute.to_s.gsub(/\=$/, '')
+        define_method("#{attribute}=") { |value| attributes[attribute] = value } unless respond_to? "#{attribute}="
+      end
+    end
+
+    def add_attr_reader(attribute) #:nodoc
+      metaclass.class_eval do
+        define_method(attribute) { attributes[attribute] } unless respond_to? attribute
+      end
+    end
+
+    def metaclass #:nodoc
+      class << self; self; end
+    end
+
+    def self.included(base)
+      base.instance_eval do
+        include HTTParty
+        attr_reader :attributes
+        format      :json
+        base_uri    Twilio::API_ENDPOINT
+      end
+
+      class << base
+        def create(attrs={})
+          new(attrs).tap { |c| c.save }
+        end
+
+        def post(url, opts)
+          super url, opts.merge(:basic_auth => { :username => Twilio::ACCOUNT_SID, :password => Twilio::AUTH_TOKEN })
+        end
+      end
+    end
+  end
+end

data/lib/twilio/sms.rb

@@ -0,0 +1,10 @@
+module Twilio
+  class SMS
+    include Twilio::Resource
+
+    # Sends the SMS message
+    def save
+      handle_response self.class.post "/Accounts/#{Twilio::ACCOUNT_SID}/SMS/Messages.json", :body => attributes
+    end
+  end
+end

data/lib/twilio.rb

@@ -0,0 +1,17 @@
+%w<rubygems active_support CGI yajl yajl/json_gem httparty>.each  { |lib| require lib }
+require File.join(File.dirname(__FILE__), 'twilio', 'resource.rb')
+
+module Twilio
+  API_ENDPOINT        = 'https://api.twilio.com/2010-04-01'
+  APIError            = Class.new StandardError
+  ConfigurationError  = Class.new StandardError
+  InvalidStateError   = Class.new StandardError
+  
+  class << self
+    def const_missing(const_name)
+      raise Twilio::ConfigurationError.new "Cannot complete request. Please set #{const_name.to_s.downcase} with Twilio::Config.setup first!"
+    end
+  end
+end
+
+Dir[File.join(File.dirname(__FILE__), 'twilio', '*.rb')].each { |lib| require lib }

metadata

@@ -0,0 +1,129 @@
+--- !ruby/object:Gem::Specification 
+name: twilio-rb
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 1
+  - 1
+  version: 0.1.1
+platform: ruby
+authors: 
+- Stevie Graham
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-09-28 00:00:00 +01:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: activesupport
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 3
+        - 0
+        - 0
+        version: 3.0.0
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: yajl-ruby
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 7
+        - 7
+        version: 0.7.7
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: httparty
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 6
+        - 1
+        version: 0.6.1
+  type: :runtime
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: webmock
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 3
+        - 5
+        version: 1.3.5
+  type: :runtime
+  version_requirements: *id004
+description: A nice Ruby wrapper for the Twilio REST API
+email: sjtgraham@mac.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- lib/twilio/call.rb
+- lib/twilio/config.rb
+- lib/twilio/resource.rb
+- lib/twilio/sms.rb
+- lib/twilio.rb
+has_rdoc: true
+homepage: http://github.com/stevegraham/twilio-rb
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 1
+      - 8
+      - 7
+      version: 1.8.7
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Interact with the Twilio API in a nice Ruby way.
+test_files: []
+