restforce 7.5.0 → 8.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9489f9967f5db3f3ed0416764939fbc2c2c684d7b2710c9d1e23bbe058cc135f
-  data.tar.gz: 588949562f3af9fab7d56d9dfb40e48a7e7f449cab4b21c0cf8a3f5f153fa0f9
+  metadata.gz: 4ca784cfed06e62e6d2fc0deb0ab93dd9fb626bb0452acc57862cc8955fd20a2
+  data.tar.gz: 326f27b8e2e63639c5c086d99a2434b1fefaed7494285e56b15f4e74d680eb28
 SHA512:
-  metadata.gz: 8149c2d06c96bc909ef1e05fb6ce94e1baeea771b5e45ad349ddbb3cda6ef2731f0450b708de6928ef1b155b60cdca161e75d332306b2256f94e82a86cd752a1
-  data.tar.gz: 554c351180e0c614dc1323d07a25252e54acb9bc37c01e270b9df1d74d44df1996abb0a3a2a70e277935ea053798a7262c2512a743d24ab027639569a871954c
+  metadata.gz: 392d765b3a14c1dc0f28a7c5d46e00bc699d1dabf433a757fdda00e3422e4bb4f10afc9f9332b5b34c5a928ad24c0924d7c961135a13d1e1e15e63a2d56af348
+  data.tar.gz: 7c0508ec94f48747bcb0d6a9544d2a9283730f6676a11bfecf71ecf76539d854992dbd85b52ca30a19fb2b89520d095c721de64d841bb50f7a7409329c66ab7d

data/.github/workflows/build.yml

@@ -6,7 +6,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        ruby_version: ['3.0', '3.1', '3.2', '3.3']
+        ruby_version: ["3.1", "3.2", "3.3", "3.4.0-rc1"]
     steps:
       - name: Checkout code
         uses: actions/checkout@v4

data/.github/workflows/faraday.yml

@@ -10,7 +10,33 @@ 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.12', '2.8.1', '2.9.2', '2.10.1', '2.11.0']
+        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.2",
+          ]
     env:
       FARADAY_VERSION: ~> ${{ matrix.faraday_version }}
     steps:

data/.rubocop.yml

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

data/CHANGELOG.md

@@ -1,3 +1,13 @@
+## 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)

data/Gemfile

@@ -3,7 +3,7 @@
 source 'https://rubygems.org'
 gemspec
 
-faraday_version = ENV.fetch('FARADAY_VERSION', '~> 2.11.0')
+faraday_version = ENV.fetch('FARADAY_VERSION', '~> 2.12.2')
 
 # Enable us to explicitly pick a Faraday version when running tests
 gem 'faraday', faraday_version
@@ -15,8 +15,8 @@ gem 'jruby-openssl', platforms: :jruby
 gem 'rake'
 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.66.0'
+gem 'rubocop', '~> 1.69.2'
 gem 'simplecov', '~> 0.22.0'
-gem 'webmock', '~> 3.23.0'
+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', '~> 7.5.0'
+    gem 'restforce', '~> 8.0.0'
 
 And then execute:
 
@@ -37,15 +37,16 @@ Or install it yourself as:
 
     $ gem install restforce
 
-__As of version 7.0.0, this gem is only compatible with Ruby 3.0.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.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
+- 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.
 
@@ -116,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')
@@ -329,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']
 ```
 

data/UPGRADING.md

@@ -1,3 +1,15 @@
+# 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

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/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/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/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/version.rb

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

data/restforce.gemspec

@@ -22,9 +22,9 @@ Gem::Specification.new do |gem|
 'rubygems_mfa_required' => 'true'
   }
 
-  gem.required_ruby_version = '>= 3.0'
+  gem.required_ruby_version = '>= 3.1'
 
-  gem.add_dependency 'faraday', '< 2.12.0', '>= 1.1.0'
+  gem.add_dependency 'faraday', '< 3.0.0', '>= 1.1.0'
   gem.add_dependency 'faraday-follow_redirects', '<= 0.3.0', '< 1.0.0'
   gem.add_dependency 'faraday-multipart', '>= 1.0.0', '< 2.0.0'
   gem.add_dependency 'faraday-net_http', '< 4.0.0'

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: restforce
 version: !ruby/object:Gem::Version
-  version: 7.5.0
+  version: 8.0.0
 platform: ruby
 authors:
 - Tim Rogers
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-09-04 00:00:00.000000000 Z
+date: 2024-12-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -17,7 +17,7 @@ dependencies:
     requirements:
     - - "<"
       - !ruby/object:Gem::Version
-        version: 2.12.0
+        version: 3.0.0
     - - ">="
       - !ruby/object:Gem::Version
         version: 1.1.0
@@ -27,7 +27,7 @@ dependencies:
     requirements:
     - - "<"
       - !ruby/object:Gem::Version
-        version: 2.12.0
+        version: 3.0.0
     - - ">="
       - !ruby/object:Gem::Version
         version: 1.1.0
@@ -288,14 +288,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.0'
+      version: '3.1'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.3
+rubygems_version: 3.5.16
 signing_key:
 specification_version: 4
 summary: A lightweight Ruby client for the Salesforce REST API