restforce 6.2.4 → 8.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5d97cb818f5a5a454ee219c4d0042a9fb3d39d410fdeebd1aefe07fd9787ddcf
-  data.tar.gz: 584614d9bfd4f92b52c62476168cb974999bedd3406829516e75d66fd9f50d35
+  metadata.gz: d15210bc91589b14b39393257c157630f0e97a48f645182f859b111ff217c1ce
+  data.tar.gz: 6e53ae6ada7fcb4743e5e9ee5b42728007d878612bf7487a02510755786d6355
 SHA512:
-  metadata.gz: da659c7c074a0a05b7839a3f28268a3c7c513d5e26a98f0fad80bc2d9c4f8dde9686eefdfce16b54609a41419820949750ef4a81505112c71f8203292ded3583
-  data.tar.gz: c7b03f3ad45db1a83fc2f47c42e00761ca99c8f9a659b217bfaa9ac6d22deffc1346fb7024a87865c69cb658de30ca83d461a8a9db127be49bd6dfa32adb03c6
+  metadata.gz: c8eb88e8e6eb093808deaa1aa6def7c59d9e883069d3835a315b492903cab8b6a3f85bd14a3b0a27ee43376075bfa49ed5af97cf11149748f7e7f2947a29b54d
+  data.tar.gz: f74e373ce9c0c206541f1555fa822ae0b2ade70a05fdec3eb5d3f7cee2ffeb0da8876a33b20e2e7350af34cb97b6335c0eaa64bf5b207d905113aebd5b9095f7

data/.github/workflows/build.yml

@@ -6,7 +6,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        ruby_version: ['2.7', '3.0', '3.1', '3.2']
+        ruby_version: ["3.1", "3.2", "3.3", "3.4", "4.0"]
     steps:
       - name: Checkout code
         uses: actions/checkout@v4
@@ -20,4 +20,4 @@ jobs:
       - name: Lint Ruby files
         run: bundle exec rubocop
       - name: Run RSpec tests
-        run: bundle exec rspec
+        run: bundle exec rspec

data/.github/workflows/faraday.yml

@@ -10,7 +10,35 @@ jobs:
         # For v2.0.x, we test v2.0.0 and v2.0.1 because v2.0.0 has a special behaviour where
         # the Net::HTTP adapter is not included. See
         # https://github.com/lostisland/faraday/blob/main/UPGRADING.md#faraday-20.
-        faraday_version: ['1.1.0', '1.2.0', '1.3.1', '1.4.3', '1.5.1', '1.6.0', '1.7.2', '1.8.0', '1.9.3', '1.10.3', '2.0.0', '2.0.1', '2.1.0', '2.2.0', '2.3.0', '2.4.0', '2.5.2', '2.6.0', '2.7.4']
+        faraday_version:
+          [
+            "1.1.0",
+            "1.2.0",
+            "1.3.1",
+            "1.4.3",
+            "1.5.1",
+            "1.6.0",
+            "1.7.2",
+            "1.8.0",
+            "1.9.3",
+            "1.10.3",
+            "2.0.0",
+            "2.0.1",
+            "2.1.0",
+            "2.2.0",
+            "2.3.0",
+            "2.4.0",
+            "2.5.2",
+            "2.6.0",
+            "2.7.12",
+            "2.8.1",
+            "2.9.2",
+            "2.10.1",
+            "2.11.0",
+            "2.12.3",
+            "2.13.4",
+            "2.14.0"
+          ]
     env:
       FARADAY_VERSION: ~> ${{ matrix.faraday_version }}
     steps:

data/.gitignore

@@ -22,3 +22,4 @@ tmp
 .idea
 Vagrantfile
 .vagrant/
+vendor/

data/.rubocop.yml

@@ -8,7 +8,7 @@ AllCops:
     - .*/**/*
     - vendor/**/*
   NewCops: enable
-  TargetRubyVersion: 2.7
+  TargetRubyVersion: 3.1
 
 # Limit lines to 90 characters.
 Layout/LineLength:

data/CHANGELOG.md

@@ -1,4 +1,53 @@
-# 6.2.4 (Oct 8, 2023)
+## 8.0.1 (December 29, 2025)
+
+* Allow `faraday-follow_redirects` v0.4.x and v0.5.x to unlock Ruby 4.0 compatibility
+
+## 8.0.0 (December 18, 2024)
+
+**This version contains breaking changes. For help with upgrading, see [`UPGRADING.md`](https://github.com/restforce/restforce/blob/main/UPGRADING.md).**
+
+- **⚠️ Drop support for Ruby 3.0**, since Ruby 3.0 has reached its end-of-life (@timrogers)
+
+## 7.6.0 (December 18, 2024)
+
+- **Allow all `faraday` versions up to, but not including, v3.0.0**: For more details, see https://github.com/restforce/restforce/pull/915 (@timrogers)
+
+## 7.5.0 (September 4, 2024)
+
+- Add support for `faraday` v2.11.x (@timrogers)
+
+## 7.4.0 (July 10, 2024)
+
+- Add support for `faraday` v2.10.x (@ryan-mcneil)
+
+# 7.3.1 (Mar 30, 2024)
+
+- Fix `uninitialized constant StringIO` error by explicitly requiring `StringIO` where it's used (@timrogers)
+
+# 7.3.0 (Feb 14, 2024 🧡)
+
+- Add support for making `GET` requests using the Composite API (@shravan097)
+
+# 7.2.0 (Jan 23, 2024)
+
+- Add support for `faraday` v2.9.x (@timrogers)
+
+# 7.1.1 (Jan 23, 2024)
+
+- Handle the `APEX_REST_SERVICES_DISABLED` error returned by the Salesforce API (@timrogers)
+
+# 7.1.0 (Dec 20, 2023)
+
+- Add support for the [OAuth 2.0 Client Credentials authentication flow](https://help.salesforce.com/s/articleView?id=sf.remoteaccess_oauth_client_credentials_flow.htm&type=5) (@rh-taro)
+- Add support for `faraday` v2.8.x (@timrogers)
+
+# 7.0.0 (Oct 6, 2023)
+
+__This version contains breaking changes. For help with upgrading, see [`UPGRADING.md`](https://github.com/restforce/restforce/blob/main/UPGRADING.md).__
+
+* __⚠️  Drop support for Ruby 2.7__, since [Ruby 2.7 has reached its end-of-life](https://www.ruby-lang.org/en/downloads/) (@timrogers)
+
+# 6.2.4 (Oct 6, 2023)
 
 * Register the custom JSON middleware for Faraday with a more unique name to avoid clashes with other middleware (@dbackeus)
 

data/Gemfile

@@ -3,20 +3,20 @@
 source 'https://rubygems.org'
 gemspec
 
-faraday_version = ENV.fetch('FARADAY_VERSION', '~> 2.7.3')
+faraday_version = ENV.fetch('FARADAY_VERSION', '~> 2.12.2')
 
 # Enable us to explicitly pick a Faraday version when running tests
 gem 'faraday', faraday_version
-gem 'faraday-typhoeus', '~> 1.0.0' unless faraday_version.start_with?("~> 1")
+gem 'faraday-typhoeus', '~> 1.1.0' unless faraday_version.start_with?("~> 1")
 gem 'faye' unless RUBY_PLATFORM == 'java'
 gem 'guard-rspec'
 gem 'guard-rubocop'
 gem 'jruby-openssl', platforms: :jruby
 gem 'rake'
-gem 'rspec', '~> 3.12.0'
+gem 'rspec', '~> 3.13.0'
 gem 'rspec-collection_matchers', '~> 1.2.0'
-gem 'rspec-its', '~> 1.3.0'
+gem 'rspec-its', '~> 2.0.0'
 gem 'rspec_junit_formatter', '~> 0.6.0'
-gem 'rubocop', '~> 1.56.3'
+gem 'rubocop', '~> 1.70.0'
 gem 'simplecov', '~> 0.22.0'
-gem 'webmock', '~> 3.19.1'
+gem 'webmock', '~> 3.24.0'

data/README.md

@@ -3,7 +3,7 @@
 [![CircleCI](https://circleci.com/gh/restforce/restforce.svg?style=svg)](https://circleci.com/gh/restforce/restforce)
 ![Downloads](https://img.shields.io/gem/dt/restforce.svg)
 
-Restforce is a ruby gem for the [Salesforce REST api](http://www.salesforce.com/us/developer/docs/api_rest/index.htm).
+Restforce is a ruby gem for the [Salesforce REST API](http://www.salesforce.com/us/developer/docs/api_rest/index.htm).
 
 Features include:
 
@@ -27,7 +27,7 @@ Features include:
 
 Add this line to your application's Gemfile:
 
-    gem 'restforce', '~> 6.2.4'
+    gem 'restforce', '~> 8.0.1'
 
 And then execute:
 
@@ -37,14 +37,16 @@ Or install it yourself as:
 
     $ gem install restforce
 
-__As of version 6.0.0, this gem is only compatible with Ruby 2.7.0 and later.__ If you're using an earlier Ruby version:
+**As of version 8.0.0, this gem is only compatible with Ruby 3.1.0 and later.** If you're using an earlier Ruby version:
 
-* for Ruby 2.6, use version 5.3.1 or earlier
-* for Ruby 2.5, use version 5.0.6 or earlier
-* for Ruby 2.4, use version 4.3.0 or earlier
-* for Ruby 2.3, use version 3.2.0 or earlier
-* for Ruby versions 2.2, 2.1 and 2.0, use version 2.5.3 or earlier
-* for Ruby 1.9.3, use version 2.4.2
+- for Ruby 3.0, use version 7.6.0 or earlier
+- for Ruby 2.7, use version 6.2.4 or earlier
+- for Ruby 2.6, use version 5.3.1 or earlier
+- for Ruby 2.5, use version 5.0.6 or earlier
+- for Ruby 2.4, use version 4.3.0 or earlier
+- for Ruby 2.3, use version 3.2.0 or earlier
+- for Ruby versions 2.2, 2.1 and 2.0, use version 2.5.3 or earlier
+- for Ruby 1.9.3, use version 2.4.2
 
 This gem is versioned using [Semantic Versioning](http://semver.org/), so you can be confident when updating that there will not be breaking changes outside of a major version (following format MAJOR.MINOR.PATCH, so for instance moving from 3.1.0 to 4.0.0 would be allowed to include incompatible API changes). See the [changelog](https://github.com/restforce/restforce/tree/master/CHANGELOG.md) for details on what has changed in each version.
 
@@ -58,7 +60,7 @@ so you can do things like `client.query('select Id, (select Name from Children__
 
 Which authentication method you use really depends on your use case. If you're
 building an application where many users from different organizations are authenticated
-through oauth and you need to interact with data in their org on their behalf,
+through OAuth and you need to interact with data in their org on their behalf,
 you should use the OAuth token authentication method.
 
 If you're using the gem to interact with a single org (maybe you're building some
@@ -115,7 +117,7 @@ If you prefer to use a username and password to authenticate:
 client = Restforce.new(username: config['username'],
                        password: config['password'],
                        instance_url: config['instance_url'],
-                       host: config['host'],                   # https://test.salesforce.com for sandbox (optional)
+                       host: config['host'],                   # test.salesforce.com for sandbox (optional)
                        client_id: config['client_key'],        # Salesforce Client Key
                        client_secret: config['client_secret'], # Salesforce Client Secret
                        api_version: '55.0')
@@ -154,6 +156,17 @@ client = Restforce.new
 
 **Note:** Restforce library does not cache JWT Bearer tokens automatically. This means that every instantiation of the Restforce class will be treated as a new login by Salesforce. Remember that Salesforce enforces [rate limits on login requests](https://help.salesforce.com/s/articleView?id=000312767&type=1). If you are building an application that will instantiate the Restforce class more than this specified rate limit, you might want to consider caching the Bearer token either in-memory or in your own storage by leveraging the `authentication_callback` method. 
 
+#### Client Credentials
+
+If you want to authenticate as an application, you can use the [Client Credentials flow](https://help.salesforce.com/s/articleView?id=sf.remoteaccess_oauth_client_credentials_flow.htm&type=5):
+
+```ruby
+client = Restforce.new(client_id: 'client_id',
+                       client_secret: 'client_secret',
+                       api_version: '55.0',
+                       host: 'MYDOMAIN.my.salesforce.com')
+```
+
 #### Sandbox Organizations
 
 You can connect to sandbox organizations by specifying a host. The default host is
@@ -317,7 +330,7 @@ client.search('FIND {bar}')
 # => #<Restforce::Collection >
 
 # Find accounts matching the term 'genepoint' and return the `Name` field
-client.search('FIND {genepoint} RETURNING Account (Name)').map(&:Name)
+client.search('FIND {genepoint} RETURNING Account (Name)')["searchRecords"].map(&:Name)
 # => ['GenePoint']
 ```
 
@@ -588,7 +601,6 @@ This feature permits the user to send a composite object—that is, a complex
 object with nested children—in a single API call. Up to 25 requests may be
 included in a single composite.
 
-Note that `GET` is not yet implemented for this API.
 
 ```ruby
 # build up an array of requests:
@@ -831,6 +843,18 @@ client.create!("CustomField", {
 })
 ```
 
+## Configuration Precedence
+
+Here's the order of precedence from highest to lowest:
+
+Arguments on new: passing configuration options directly as arguments has the highest precedence. These settings will override any other configuration.
+
+Configuration block: using Restforce.configure to set configuration options is the next in line. They will take precedence over environment variables and defaults but will be overridden by direct arguments on instantiation.
+
+Environment variables: has the lowest precedence. If you set options using environment variables, they will be overridden by any other configuration method.
+
+Defaults: If none of the above methods are used, Restforce falls back to its default configuration values.
+
 ## Contributing
 
 We welcome all contributions - they help us make Restforce the best gem possible.

data/UPGRADING.md

@@ -1,3 +1,27 @@
+# Upgrading from Restforce 7.x to 8.x
+
+## Ruby 3.0 is no longer supported
+
+**Likelyhood of impact**: Moderate
+
+Ruby 3.0 is no longer officially supported as an active version of the Ruby language. That means that it will not receive patches and security fixes.
+
+Accordingly, we've dropped support for Ruby 3.0 in the Restforce library. The gemspec now specifies that only 3.1 onwards is supported, and this will be enforced by RubyGems.
+
+Before you update to Restforce 8.x, you'll need to switch to Ruby 3.1.0 or later. The current version of Ruby at the time of writing is 3.3.6.
+
+# Upgrading from Restforce 6.x to 7.x
+
+## Ruby 2.7 is no longer supported
+
+__Likelyhood of impact__: Moderate
+
+Ruby 2.7 is no longer officially supported as an active version of the Ruby language. That means that it will not receive patches and security fixes.
+
+Accordingly, we've dropped support for Ruby 2.7 in the Restforce library. The gemspec now specifies that only 3.0 onwards is supported, and this will be enforced by RubyGems.
+
+Before you update to Restforce 7.x, you'll need to switch to Ruby 3.0.0 or later. The current version of Ruby at the time of writing is 3.2.2.
+
 # Upgrading from Restforce 5.x to 6.x
 
 __There are two breaking changes introduced in Restforce 6.x__. In this guide, you'll learn about these changes and what you should check in your code to make sure that it will work with the latest version of the library.

data/lib/restforce/collection.rb

@@ -12,12 +12,12 @@ module Restforce
     end
 
     # Yield each value on each page.
-    def each(&block)
+    def each(&)
       @raw_page['records'].each { |record| yield Restforce::Mash.build(record, @client) }
 
       np = next_page
       while np
-        np.current_page.each(&block)
+        np.current_page.each(&)
         np = np.next_page
       end
     end

data/lib/restforce/concerns/authentication.rb

@@ -21,6 +21,8 @@ module Restforce
           Restforce::Middleware::Authentication::Token
         elsif jwt?
           Restforce::Middleware::Authentication::JWTBearer
+        elsif client_credential?
+          Restforce::Middleware::Authentication::ClientCredential
         end
       end
 
@@ -48,6 +50,12 @@ module Restforce
           options[:username] &&
           options[:client_id]
       end
+
+      # Internal: Returns true if client credential flow should be used for
+      # authentication.
+      def client_credential?
+        options[:client_id] && options[:client_secret]
+      end
     end
   end
 end

data/lib/restforce/concerns/batch_api.rb

@@ -29,8 +29,8 @@ module Restforce
         end.flatten
       end
 
-      def batch!(&block)
-        batch(halt_on_error: true, &block)
+      def batch!(&)
+        batch(halt_on_error: true, &)
       end
 
       class Subrequests

data/lib/restforce/concerns/composite_api.rb

@@ -93,6 +93,14 @@ module Restforce
           }
         end
 
+        def find(sobject, reference_id, id)
+          requests << {
+            method: 'GET',
+            url: composite_api_path("#{sobject}/#{id}"),
+            referenceId: reference_id
+          }
+        end
+
         private
 
         def composite_api_path(path)

data/lib/restforce/concerns/picklists.rb

@@ -85,7 +85,7 @@ module Restforce
         def valid?(picklist_entry)
           valid_for = picklist_entry['validFor'].ljust(16, 'A').unpack1('m').
                       unpack('C*')
-          (valid_for[index >> 3] & (0x80 >> (index % 8))).positive?
+          valid_for[index >> 3].anybits?((0x80 >> (index % 8)))
         end
       end
     end

data/lib/restforce/concerns/streaming.rb

@@ -9,9 +9,9 @@ module Restforce
       # block    - A block to run when a new message is received.
       #
       # Returns a Faye::Subscription
-      def legacy_subscribe(topics, options = {}, &block)
+      def legacy_subscribe(topics, options = {}, &)
         topics = Array(topics).map { |channel| "/topic/#{channel}" }
-        subscription(topics, options, &block)
+        subscription(topics, options, &)
       end
       alias subscribe legacy_subscribe
 
@@ -21,12 +21,12 @@ module Restforce
       # block    - A block to run when a new message is received.
       #
       # Returns a Faye::Subscription
-      def subscription(channels, options = {}, &block)
+      def subscription(channels, options = {}, &)
         one_or_more_channels = Array(channels)
         one_or_more_channels.each do |channel|
           replay_handlers[channel] = options[:replay]
         end
-        faye.subscribe(one_or_more_channels, &block)
+        faye.subscribe(one_or_more_channels, &)
       end
 
       # Public: Faye client to use for subscribing to PushTopics

data/lib/restforce/error_code.rb

@@ -19,6 +19,8 @@ module Restforce
 
     class ApexError < ResponseError; end
 
+    class ApexRestServicesDisabled < ResponseError; end
+
     class ApiCurrentlyDisabled < ResponseError; end
 
     class ApiDisabledForOrg < ResponseError; end
@@ -429,6 +431,7 @@ module Restforce
       "ALL_OR_NONE_OPERATION_ROLLED_BACK" => AllOrNoneOperationRolledBack,
       "ALREADY_IN_PROCESS" => AlreadyInProcess,
       "APEX_ERROR" => ApexError,
+      "APEX_REST_SERVICES_DISABLED" => ApexRestServicesDisabled,
       "API_CURRENTLY_DISABLED" => ApiCurrentlyDisabled,
       "API_DISABLED_FOR_ORG" => ApiDisabledForOrg,
       "ASSIGNEE_TYPE_REQUIRED" => AssigneeTypeRequired,
@@ -663,7 +666,7 @@ module Restforce
            "defined. If you're sure that this is a valid Salesforce error, then " \
            "please create an issue on GitHub at <#{GITHUB_ISSUE_URL}>."
 
-      super(constant_name)
+      super
     end
   end
 end

data/lib/restforce/mash.rb

@@ -46,10 +46,10 @@ module Restforce
       end
     end
 
-    def initialize(source_hash = nil, client = nil, default = nil, &blk)
+    def initialize(source_hash = nil, client = nil, default = nil, &)
       @client = client
       deep_update(source_hash) if source_hash
-      default ? super(default) : super(&blk)
+      default ? super(default) : super(&)
     end
 
     def dup

data/lib/restforce/middleware/authentication/client_credential.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Restforce
+  class Middleware
+    class Authentication
+      class ClientCredential < Restforce::Middleware::Authentication
+        def params
+          { grant_type: 'client_credentials',
+            client_id: @options[:client_id],
+            client_secret: @options[:client_secret] }
+        end
+      end
+    end
+  end
+end

data/lib/restforce/middleware/authentication.rb

@@ -9,6 +9,7 @@ module Restforce
     autoload :Password,  'restforce/middleware/authentication/password'
     autoload :Token,     'restforce/middleware/authentication/token'
     autoload :JWTBearer, 'restforce/middleware/authentication/jwt_bearer'
+    autoload :ClientCredential, 'restforce/middleware/authentication/client_credential'
 
     # Rescue from 401's, authenticate then raise the error again so the client
     # can reissue the request.

data/lib/restforce/middleware/gzip.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require 'stringio'
 require 'zlib'
 
 module Restforce

data/lib/restforce/middleware/json_request.rb

@@ -31,7 +31,7 @@ module Restforce
     CONTENT_TYPE = 'Content-Type'
 
     MIME_TYPE = 'application/json'
-    MIME_TYPE_REGEX = %r{^application/(vnd\..+\+)?json$}.freeze
+    MIME_TYPE_REGEX = %r{^application/(vnd\..+\+)?json$}
 
     #
     # Taken from `lib/faraday/middleware.rb` in the `faraday`

data/lib/restforce/middleware/raise_error.rb

@@ -60,7 +60,7 @@ module Restforce
       }
     end
 
-    ERROR_CODE_MATCHER = /\A[A-Z_]+\z/.freeze
+    ERROR_CODE_MATCHER = /\A[A-Z_]+\z/
 
     def exception_class_for_error_code(error_code)
       return Restforce::ResponseError unless ERROR_CODE_MATCHER.match?(error_code)

data/lib/restforce/patches/parts.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require 'stringio'
+
 module Faraday
   module Parts
     module Part

data/lib/restforce/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Restforce
-  VERSION = '6.2.4'
+  VERSION = '8.0.1'
 end

data/restforce.gemspec

@@ -22,10 +22,10 @@ Gem::Specification.new do |gem|
 'rubygems_mfa_required' => 'true'
   }
 
-  gem.required_ruby_version = '>= 2.7'
+  gem.required_ruby_version = '>= 3.1'
 
-  gem.add_dependency 'faraday', '< 2.8.0', '>= 1.1.0'
-  gem.add_dependency 'faraday-follow_redirects', '<= 0.3.0', '< 1.0.0'
+  gem.add_dependency 'faraday', '< 3.0.0', '>= 1.1.0'
+  gem.add_dependency 'faraday-follow_redirects', '< 0.6.0'
   gem.add_dependency 'faraday-multipart', '>= 1.0.0', '< 2.0.0'
   gem.add_dependency 'faraday-net_http', '< 4.0.0'
   gem.add_dependency 'hashie', '>= 1.2.0', '< 6.0'

data/spec/unit/concerns/authentication_spec.rb

@@ -62,6 +62,17 @@ describe Restforce::Concerns::Authentication do
 
       it { should eq Restforce::Middleware::Authentication::JWTBearer }
     end
+
+    context 'when client_id and client_secret options are provided' do
+      before do
+        client.stub username_password?: false
+        client.stub oauth_refresh?: false
+        client.stub jwt?: false
+        client.stub client_credential?: true
+      end
+
+      it { should eq Restforce::Middleware::Authentication::ClientCredential }
+    end
   end
 
   describe '.username_password?' do
@@ -135,4 +146,26 @@ describe Restforce::Concerns::Authentication do
       it { should_not be true }
     end
   end
+
+  describe '.client_credential?' do
+    subject       { client.client_credential? }
+    let(:options) { {} }
+
+    before do
+      client.stub options: options
+    end
+
+    context 'when oauth client credential options are provided' do
+      let(:options) do
+        { client_id: 'client',
+          client_secret: 'secret' }
+      end
+
+      it { should be_truthy }
+    end
+
+    context 'when oauth client credential options are not provided' do
+      it { should_not be true }
+    end
+  end
 end

data/spec/unit/concerns/composite_api_spec.rb

@@ -82,6 +82,23 @@ describe Restforce::Concerns::CompositeAPI do
       end
     end
 
+    it '#find' do
+      client.
+        should_receive(:api_post).
+        with(endpoint, { compositeRequest: [
+          {
+            method: 'GET',
+            url: "/services/data/v38.0/sobjects/Object/00312345",
+            referenceId: 'find_ref'
+          }
+        ], allOrNone: all_or_none, collateSubrequests: false }.to_json).
+        and_return(response)
+
+      client.send(method) do |subrequests|
+        subrequests.find('Object', 'find_ref', '00312345')
+      end
+    end
+
     it 'multiple subrequests' do
       client.
         should_receive(:api_post).

data/spec/unit/concerns/connection_spec.rb

@@ -85,6 +85,8 @@ describe Restforce::Concerns::Connection do
       client.stub options: { adapter: :typhoeus }
     end
 
-    its(:adapter) { should eq(:typhoeus) }
+    it "uses typheous adapter" do
+      expect(client.send(:adapter)).to be(:typhoeus)
+    end
   end
 end

data/spec/unit/config_spec.rb

@@ -70,6 +70,21 @@ describe Restforce do
         expect(Restforce.configuration.send(attr)).to eq 'foobar'
       end
     end
+
+    it 'takes precedence over environment variables' do
+      { 'SALESFORCE_USERNAME'  => 'env_foo',
+        'SALESFORCE_CLIENT_ID' => 'env_client id' }.
+        each { |var, value| ENV.stub(:fetch).with(var, anything).and_return(value) }
+
+      { username: 'config_foo', client_id: nil }.each do |attr, value|
+        Restforce.configure do |config|
+          config.send("#{attr}=", value)
+        end
+      end
+
+      expect(Restforce.configuration.send(:username)).to eq 'config_foo'
+      expect(Restforce.configuration.send(:client_id)).to eq 'env_client id'
+    end
   end
 
   describe '#log?' do
@@ -138,5 +153,17 @@ describe Restforce do
         checker.check!
       end
     end
+
+    it 'shows the precedence over config' do
+      ENV['SALESFORCE_USERNAME'] = 'env_foo'
+      Restforce.configure do |config|
+        config.username = 'config_foo'
+      end
+      client = Restforce.new(username: 'foo')
+
+      expect(client.options[:username]).to eq 'foo'
+
+      Restforce.instance_variable_set :@configuration, nil
+    end
   end
 end

data/spec/unit/middleware/authentication/client_credential_spec.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+describe Restforce::Middleware::Authentication::ClientCredential do
+  let(:options) do
+    { host: 'login.salesforce.com',
+      client_id: 'client_id',
+      client_secret: 'client_secret',
+      adapter: :net_http }
+  end
+
+  it_behaves_like 'authentication middleware' do
+    let(:success_request) do
+      stub_login_request(
+        body: "grant_type=client_credentials&" \
+              "client_id=client_id&client_secret=client_secret"
+      ).to_return(
+        status: 200,
+        body: fixture(:auth_success_response),
+        headers: { "Content-Type" => "application/json" }
+      )
+    end
+
+    let(:fail_request) do
+      stub_login_request(
+        body: "grant_type=client_credentials&" \
+              "client_id=client_id&client_secret=client_secret"
+      ).to_return(
+        status: 400,
+        body: fixture(:refresh_error_response),
+        headers: { "Content-Type" => "application/json" }
+      )
+    end
+  end
+end

data/spec/unit/middleware/gzip_spec.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require 'stringio'
+
 require 'spec_helper'
 
 describe Restforce::Middleware::Gzip do

metadata

@@ -1,15 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: restforce
 version: !ruby/object:Gem::Version
-  version: 6.2.4
+  version: 8.0.1
 platform: ruby
 authors:
 - Tim Rogers
 - Eric J. Holmes
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-10-06 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -17,7 +16,7 @@ dependencies:
     requirements:
     - - "<"
       - !ruby/object:Gem::Version
-        version: 2.8.0
+        version: 3.0.0
     - - ">="
       - !ruby/object:Gem::Version
         version: 1.1.0
@@ -27,7 +26,7 @@ dependencies:
     requirements:
     - - "<"
       - !ruby/object:Gem::Version
-        version: 2.8.0
+        version: 3.0.0
     - - ">="
       - !ruby/object:Gem::Version
         version: 1.1.0
@@ -35,22 +34,16 @@ dependencies:
   name: faraday-follow_redirects
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "<="
-      - !ruby/object:Gem::Version
-        version: 0.3.0
     - - "<"
       - !ruby/object:Gem::Version
-        version: 1.0.0
+        version: 0.6.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "<="
-      - !ruby/object:Gem::Version
-        version: 0.3.0
     - - "<"
       - !ruby/object:Gem::Version
-        version: 1.0.0
+        version: 0.6.0
 - !ruby/object:Gem::Dependency
   name: faraday-multipart
   requirement: !ruby/object:Gem::Requirement
@@ -170,6 +163,7 @@ files:
 - lib/restforce/mash.rb
 - lib/restforce/middleware.rb
 - lib/restforce/middleware/authentication.rb
+- lib/restforce/middleware/authentication/client_credential.rb
 - lib/restforce/middleware/authentication/jwt_bearer.rb
 - lib/restforce/middleware/authentication/password.rb
 - lib/restforce/middleware/authentication/token.rb
@@ -257,6 +251,7 @@ files:
 - spec/unit/document_spec.rb
 - spec/unit/error_code_spec.rb
 - spec/unit/mash_spec.rb
+- spec/unit/middleware/authentication/client_credential_spec.rb
 - spec/unit/middleware/authentication/jwt_bearer_spec.rb
 - spec/unit/middleware/authentication/password_spec.rb
 - spec/unit/middleware/authentication/token_spec.rb
@@ -278,7 +273,6 @@ metadata:
   source_code_uri: https://github.com/restforce/restforce
   changelog_uri: https://github.com/restforce/restforce/blob/master/CHANGELOG.md
   rubygems_mfa_required: 'true'
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -286,15 +280,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.7'
+      version: '3.1'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.20
-signing_key:
+rubygems_version: 3.7.2
 specification_version: 4
 summary: A lightweight Ruby client for the Salesforce REST API
 test_files: []