sfdc 2.4.0 → 3.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: b069e7a4c283823fd8d6c1cb4d91655843aeb825
-  data.tar.gz: 5f4ee6acdefbea239435a03d000e3ff2f5fbfdb0
+  metadata.gz: a4a336e27a5dc02b776c7d3898a80ff1d51c0020
+  data.tar.gz: d7c5c2eb05b464a0da43d7d92cd014831446c5b2
 SHA512:
-  metadata.gz: 7b8ce424aa1aee8e13e61a8b3d79c90f0db1adde39258ff722492d49bc65afcb884352ec617b95db3245399ad238605d1145aed17f6dda7e5b1ec66379ced844
-  data.tar.gz: 476893d58baba2e78b4bbfb2ab111ae92fd756cef72115c712dbcdc29baed9844e5156261030085e1a65cbc322601b4ef5d69b004c668dabcfe7fe6c679d874b
+  metadata.gz: 3081785e27bc7dbd8d55dd481c179d35bee99f420912fc05178a8ee8e08183d0aebb47ab44507504b0710ebdb0d9b3113c21c8fdc073f3802718b4500ce75567
+  data.tar.gz: 27e4897d37ab690d6faa5c82dd1a5c05f83fe1c196de559203f3a1a27ab65d89a734c17aafbad0021d490759b1a80d94bbd133df3afad4f538ddbd9fd5f99d4a

data/README.md

@@ -4,16 +4,6 @@ Sfdc is a ruby gem for the [Salesforce REST api](http://www.salesforce.com/us/de
 
 Features include:
 
-* Support for interacting with multiple users from different orgs.
-* Support for parent-to-child relationships.
-* Support for aggregate queries.
-* Support for the [Streaming API](#streaming)
-* Support for blob data types.
-* Support for GZIP compression.
-* Support for [custom Apex REST endpoints](#custom-apex-rest-endpoints).
-* Support for dependent picklists.
-* Support for decoding [Force.com Canvas](http://www.salesforce.com/us/developer/docs/platform_connectpre/canvas_framework.pdf) signed requests. (NEW!)
-
 
 ## Installation
 

data/lib/sfdc/collection.rb

@@ -22,6 +22,11 @@ module Sfdc
     end
     alias_method :length, :size
 
+    # Return array of the elements on the current page
+    def current_page
+      first(@raw_page['records'].size)
+    end
+
     # Return the current and all of the following pages.
     def pages
       [self] + (has_next_page? ? next_page.pages : [])

data/lib/sfdc/concerns/api.rb

@@ -65,6 +65,30 @@ module Sfdc
         end
       end
 
+      # Public: Returns a detailed description of the Page Layout for the
+      # specified sobject type, or URIs for layouts if the sobject has
+      # multiple Record Types.
+      #
+      # This resource was introduced in version 28.0.
+      #
+      # Examples:
+      #  # get the layouts for the sobject
+      #  client.describe_layouts('Account')
+      #  # => { ... }
+      #
+      #  # get the layout for the specified Id for the sobject
+      #  client.describe_layouts('Account', '012E0000000RHEp')
+      #  # => { ... }
+      #
+      # Returns the Hash representation of the describe_layouts result
+      def describe_layouts(sobject, layout_id = nil)
+        if layout_id
+          api_get("sobjects/#{sobject.to_s}/describe/layouts/#{layout_id}").body
+        else
+          api_get("sobjects/#{sobject.to_s}/describe/layouts").body
+        end
+      end
+
       # Public: Get the current organization's Id.
       #
       # Examples
@@ -275,26 +299,6 @@ module Sfdc
       def find(sobject, id, field=nil)
         api_get(field ? "sobjects/#{sobject}/#{field}/#{id}" : "sobjects/#{sobject}/#{id}").body
       end
-      
-      # Public: Get the current user's Id.
-      # client.user_id
-      def user_id
-        response = authenticate!
-        info = get(response.id).body
-        user_id = info.user_id
-        return user_id
-      end
-      
-      #################### Chatter items ############################
-      # @client.feeds.each do |f|
-          # puts f.to_hash['id']
-          # puts f.to_hash['body']['text']
-      # end
-      def feeds
-        api_get("/chatter/feeds/news/me/feed-items").body.items
-      end
-
-      ###############################################################
 
     private
 

data/lib/sfdc/concerns/base.rb

@@ -37,6 +37,9 @@ module Sfdc
       #        :timeout                - Faraday connection request read/open timeout. (default: nil).
       #
       #        :proxy_uri              - Proxy URI: 'http://proxy.example.com:port' or 'http://user@pass:proxy.example.com:port'
+      #
+      #        :authentication_callback
+      #                                - A Proc that is called with the response body after a successful authentication.
       def initialize(opts = {})
         raise ArgumentError, 'Please specify a hash of options' unless opts.is_a?(Hash)
         @options = Hash[Sfdc.configuration.options.map { |option| [option, Sfdc.configuration.send(option)] }]

data/lib/sfdc/concerns/connection.rb

@@ -51,7 +51,7 @@ module Sfdc
       end
 
       def adapter
-        Sfdc.configuration.adapter
+        options[:adapter]
       end
 
       # Internal: Faraday Connection options

data/lib/sfdc/config.rb

@@ -125,6 +125,9 @@ module Sfdc
 
     option :proxy_uri, :default => lambda { ENV['PROXY_URI'] }
 
+    # A Proc that is called with the response body after a successful authentication.
+    option :authentication_callback
+
     def logger
       @logger ||= ::Logger.new STDOUT
     end

data/lib/sfdc/mash.rb

@@ -46,6 +46,10 @@ module Sfdc
       deep_update(source_hash) if source_hash
       default ? super(default) : super(&blk)
     end
+
+    def dup
+      self.class.new(self, @client, self.default)
+    end
   
     def convert_value(val, duping=false)
       case val

data/lib/sfdc/middleware/authentication.rb

@@ -24,6 +24,7 @@ module Sfdc
       raise Sfdc::AuthenticationError, error_message(response) if response.status != 200
       @options[:instance_url] = response.body['instance_url']
       @options[:oauth_token]  = response.body['access_token']
+      @options[:authentication_callback].call(response.body) if @options[:authentication_callback]
       response.body
     end
 
@@ -34,7 +35,8 @@ module Sfdc
 
     # Internal: Faraday connection to use when sending an authentication request.
     def connection
-      @connection ||= Faraday.new(:url => "https://#{@options[:host]}") do |builder|
+      @connection ||= Faraday.new(faraday_options) do |builder|
+        builder.use Faraday::Request::UrlEncoded
         builder.use Sfdc::Middleware::Mashify, nil, @options
         builder.response :json
         builder.use Sfdc::Middleware::Logger, Sfdc.configuration.logger, @options if Sfdc.log?
@@ -59,5 +61,11 @@ module Sfdc
         end.join('&')
       end
     end
+
+  private
+    def faraday_options
+      { :url   => "https://#{@options[:host]}",
+        :proxy => @options[:proxy_uri] }.reject { |k, v| v.nil? }
+    end
   end
 end

data/lib/sfdc/middleware/raise_error.rb

@@ -7,8 +7,10 @@ module Sfdc
         raise Faraday::Error::ResourceNotFound, message
       when 401
         raise Sfdc::UnauthorizedError, message
+      when 413
+        raise Faraday::Error::ClientError.new("HTTP 413 - Request Entity Too Large", env[:response])
       when 400...600
-        raise Faraday::Error::ClientError, message
+        raise Faraday::Error::ClientError.new(message, env[:response])
       end
     end
 

data/lib/sfdc/sobject.rb

@@ -2,7 +2,7 @@ module Sfdc
   class SObject < Sfdc::Mash
 
     def sobject_type
-      self.attributes.type
+      self.attributes['type']
     end
 
     # Public: Get the describe for this sobject type
@@ -10,6 +10,11 @@ module Sfdc
       @client.describe(sobject_type)
     end
 
+    # Public: Describe layouts for this sobject type
+    def describe_layouts(layout_id = nil)
+      @client.describe_layouts(sobject_type, layout_id)
+    end
+
     # Public: Persist the attributes to Salesforce.
     #
     # Examples

data/lib/sfdc/version.rb

@@ -1,3 +1,3 @@
 module Sfdc
-  VERSION = '2.4.0'
+  VERSION = '3.0.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sfdc
 version: !ruby/object:Gem::Version
-  version: 2.4.0
+  version: 3.0.0
 platform: ruby
 authors:
 - Bruce Yue
@@ -9,7 +9,7 @@ autorequire:
 bindir:
 - bin
 cert_chain: []
-date: 2013-05-21 00:00:00.000000000 Z
+date: 2013-09-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -171,7 +171,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: sfdc
-rubygems_version: 2.0.0
+rubygems_version: 2.0.3
 signing_key: 
 specification_version: 4
 summary: Salesforce API