twilio-rb 0.3.1 → 0.4

data/README.md

@@ -64,6 +64,14 @@ The parameter keys should be given as underscored symbols. They will be converte
 
 Please see the Twilio REST API documentation for an up to date list of supported parameters. 
 
+## Finding an existing telephone call
+
+To retrieve an earlier created call, there is the `Twilio::Call.find` method, which accepts a call SID, e.g.
+
+<pre>call = Twilio::Call.find 'CAa346467ca321c71dbd5e12f627deb854'</pre>
+
+This returns an instance of `Twilio::Call` if a call with the given SID was found, otherwise nil is returned 
+
 ### Modifying a live telephone call
 
 Once a call has been been created it can be modified with the following methods:
@@ -90,6 +98,14 @@ The parameter keys should be given as underscored symbols. They will be converte
 
 Please see the Twilio REST API documentation for an up to date list of supported parameters.
 
+## Finding an existing telephone SMS message
+
+To retrieve an earlier created SMS message, there is the `Twilio::SMS.find` method, which accepts a SMS message SID, e.g.
+
+<pre>call = Twilio::SMS.find 'SM90c6fc909d8504d45ecdb3a3d5b3556e'</pre>
+
+This returns an instance of `Twilio::SMS` if a SMS message with the given SID was found, otherwise nil is returned
+
 ## Building TwiML documents
 
 A TwiML document is an XML document. The best way to build XML in Ruby is with Builder, and so it follows that we should use builder for TwiML. `Twilio::TwiML.build` behaves like builder except element names are capitalised for you and attributes are camelized for you as well. This is so you may continue to write beautiful code.

data/lib/twilio/resource.rb

@@ -1,4 +1,4 @@
-require 'active_support/core_ext/string/inflections' # Chill! we only use the bits of AS we need!
+require 'active_support/core_ext/string' # Chill! we only use the bits of AS we need!
 
 module Twilio
   module Resource
@@ -73,10 +73,20 @@ module Twilio
       end
 
       class << base
-        def create(attrs={})
-          new(attrs).tap { |c| c.save }
-        end if instance_of? Class # Don't want this mixed into singleton objects e.g. Twilio::Account 
-        
+        if instance_of? Class # Don't want this mixed into singleton objects e.g. Twilio::Account
+          def find(id)
+            # All Twilio resources follow a convention, except SMS :(
+            klass_name = name.demodulize
+            resource = klass_name == 'SMS' ? "#{klass_name}/Messages" : klass_name.pluralize
+            res = get "/Accounts/#{Twilio::ACCOUNT_SID}/#{resource}/#{id}.json"
+            new Hash[res.parsed_response.map { |k,v| [k.camelize, v] }] if (200..299).include? res.code
+          end
+
+          def create(attrs={})
+            new(attrs).tap { |c| c.save }
+          end 
+        end
+
         # decorate http methods with authentication
         %w<post get put delete>.each do |meth| 
           define_method(meth) do |*args| # splatted args necessary hack since <= 1.8.7 does not support optional block args 
@@ -87,4 +97,4 @@ module Twilio
       end
     end
   end
-end
+end

data/lib/twilio/twiml.rb

@@ -5,8 +5,8 @@ module Twilio
       xm.instance_eval do
         def method_missing(meth, *args, &blk)
           # camelize options
-          if args.last.kind_of? Hash
-            args[-1] = Hash[args.last.map { |k,v| [k.to_s.camelize(:lower), v]}]
+          if args.last.kind_of? ::Hash
+            args[-1] = ::Hash[args.last.map { |k,v| [k.to_s.camelize(:lower), v]}]
           end
           # let builder do the heavy lifting
           super(meth.to_s.capitalize, *args, &blk)
@@ -17,4 +17,4 @@ module Twilio
     end
     extend self
   end
-end
+end

data/lib/twilio.rb

@@ -1,4 +1,4 @@
-%w<rubygems active_support CGI yajl yajl/json_gem httparty builder>.each  { |lib| require lib }
+%w<rubygems active_support cgi yajl yajl/json_gem httparty builder>.each  { |lib| require lib }
 require File.join(File.dirname(__FILE__), 'twilio', 'resource.rb')
 
 module Twilio
@@ -6,7 +6,7 @@ module Twilio
   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!"
@@ -14,4 +14,5 @@ module Twilio
   end
 end
 
-Dir[File.join(File.dirname(__FILE__), 'twilio', '*.rb')].each { |lib| require lib }
+Dir[File.join(File.dirname(__FILE__), 'twilio', '*.rb')].each { |lib| require lib }
+

metadata

@@ -4,9 +4,8 @@ version: !ruby/object:Gem::Version
   prerelease: false
   segments: 
   - 0
-  - 3
-  - 1
-  version: 0.3.1
+  - 4
+  version: "0.4"
 platform: ruby
 authors: 
 - Stevie Graham
@@ -14,7 +13,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-09-30 00:00:00 +01:00
+date: 2010-12-13 00:00:00 +00:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -63,7 +62,7 @@ dependencies:
   type: :runtime
   version_requirements: *id003
 - !ruby/object:Gem::Dependency 
-  name: webmock
+  name: builder
   prerelease: false
   requirement: &id004 !ruby/object:Gem::Requirement 
     none: false
@@ -71,14 +70,14 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version 
         segments: 
+        - 2
         - 1
-        - 3
-        - 5
-        version: 1.3.5
+        - 2
+        version: 2.1.2
   type: :runtime
   version_requirements: *id004
 - !ruby/object:Gem::Dependency 
-  name: builder
+  name: webmock
   prerelease: false
   requirement: &id005 !ruby/object:Gem::Requirement 
     none: false
@@ -86,12 +85,27 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version 
         segments: 
-        - 2
         - 1
-        - 2
-        version: 2.1.2
-  type: :runtime
+        - 6
+        - 1
+        version: 1.6.1
+  type: :development
   version_requirements: *id005
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id006 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 2
+        - 2
+        - 0
+        version: 2.2.0
+  type: :development
+  version_requirements: *id006
 description: A nice Ruby wrapper for the Twilio REST API
 email: sjtgraham@mac.com
 executables: []
@@ -109,7 +123,7 @@ files:
 - lib/twilio/sms.rb
 - lib/twilio/twiml.rb
 - lib/twilio.rb
-has_rdoc: true
+has_rdoc: false
 homepage: http://github.com/stevegraham/twilio-rb
 licenses: []