Add Ruby 3.4 support and newer Faraday versions (#66)

This pull request introduces multiple updates across the codebase,
including improvements to the CI/CD pipeline, configuration files, and
dependency management. Key changes include updates to CircleCI
configuration for better caching and compatibility, new configuration
for SonarLint and YAML linting, and expanded support for Faraday
versions.

### CI/CD Pipeline Updates:
- Updated `.circleci/config.yml` to use newer versions of `sonarcloud`
(3.0) and `codecov` (5.4) orbs, updated default Ruby version to `3.4.5`,
and switched Docker images from `stable` to `current`.
[[1]](diffhunk://#diff-78a8a19706dbd2a4425dd72bdab0502ed7a2cef16365ab7030a5a0588927bf47L8-R10)
[[2]](diffhunk://#diff-78a8a19706dbd2a4425dd72bdab0502ed7a2cef16365ab7030a5a0588927bf47L21-R21)
[[3]](diffhunk://#diff-78a8a19706dbd2a4425dd72bdab0502ed7a2cef16365ab7030a5a0588927bf47L33-R38)
- Added caching steps for ASDF in CircleCI jobs to improve performance
and ensure Ruby versions are managed consistently.
[[1]](diffhunk://#diff-78a8a19706dbd2a4425dd72bdab0502ed7a2cef16365ab7030a5a0588927bf47R57-R82)
[[2]](diffhunk://#diff-78a8a19706dbd2a4425dd72bdab0502ed7a2cef16365ab7030a5a0588927bf47R131-R158)
[[3]](diffhunk://#diff-78a8a19706dbd2a4425dd72bdab0502ed7a2cef16365ab7030a5a0588927bf47R238-R267)
- Expanded Ruby version matrix in workflows to include `3.4.5`, `3.3.9`,
`3.2.9`, and `3.1.7`.

### Configuration Improvements:
- Added SonarLint connected mode configuration in
`.vscode/settings.json` to integrate with SonarCloud for code quality
analysis.
- Introduced `.yamllint.yml` configuration for YAML linting with custom
rules, including a line-length limit of 250 characters.

### Dependency Management:
- Updated `.tool-versions` to reflect new Ruby versions (`3.4.5`,
`3.3.9`, `3.2.9`, `3.1.7`).
- Expanded `Appraisals` to include support for Faraday versions `2.10`,
`2.11`, `2.12`, and `2.13`, with corresponding gemfiles added under
`gemfiles/`.
[[1]](diffhunk://#diff-635b20966b1d2fea76ee0565254eab939d55f6d22e3c4727cf9d453f589b87a0R53-R72)
[[2]](diffhunk://#diff-6944a8a7e435b1b47e1b316540c07e8d8b1e574587fa0cc27f6fdb6a579a36b6R1-R7)
[[3]](diffhunk://#diff-163b90daee2d10d72219f028674eeb98ebe0ba44ffc60498adf5e242d8f1daccR1-R7)
[[4]](diffhunk://#diff-35aa6d6536d9c9e3663d6ddc807fe8188b9cad0bf1b656902e77c31e897d22cbR1-R7)
[[5]](diffhunk://#diff-03139eaaf67412a5fe2dc7fecddd4678883e01f3ceac476ec489a244f6d915adR1-R7)

Author: otherguy

.circleci/config.yml

@@ -5,9 +5,9 @@ version: 2.1
 orbs:
   ruby: circleci/ruby@2.5
   node: circleci/node@7.1
-  sonarcloud: sonarsource/sonarcloud@2.0
+  sonarcloud: sonarsource/sonarcloud@3.0
   asdf: rynkowsg/asdf@0.2
-  codecov: codecov/codecov@5.2
+  codecov: codecov/codecov@5.4
   github: circleci/github-cli@2.7
 
 # Pipeline parameters
@@ -18,7 +18,7 @@ parameters:
     default: main
   default-ruby:
     type: string
-    default: 3.3.8
+    default: 3.4.5
 
 # Define common YAML anchors
 x-common-auth: &common-auth
@@ -30,12 +30,12 @@ x-common-auth: &common-auth
 executors:
   docker:  # Docker using the Base Convenience Image
     docker:
-      - image: cimg/base:stable
+      - image: cimg/base:current
         <<: *common-auth
   macos:  # macOS executor running Xcode
     macos:
       # https://circleci.com/developer/machine/image/xcode
-      xcode: 16.2.0
+      xcode: 16.4.0
 
 jobs:
   # Lint Job
@@ -54,17 +54,32 @@ jobs:
               imagemagick libvips42 libffi-dev libreadline-dev \
               libyaml-dev openssl libtool
       - asdf/install
+      - run:
+          name: Set default Ruby to << pipeline.parameters.default-ruby >>
+          command: echo "ruby << pipeline.parameters.default-ruby >>" > ~/.tool-versions
+      # Restore ASDF cache
+      - restore_cache:
+          name: Restore ASDF cache
+          keys:
+            - asdf-docker-<< pipeline.parameters.default-ruby >>
       # Install requested Ruby version
       - run:
           name: Install Ruby << pipeline.parameters.default-ruby >>
           command: |
             asdf plugin add ruby
-            asdf install ruby << pipeline.parameters.default-ruby >>
-            echo "ruby  << pipeline.parameters.default-ruby >>" > ~/.tool-versions
+            ASDF_RUBY_BUILD_VERSION=master asdf install ruby << pipeline.parameters.default-ruby >>
             gem install --user-install executable-hooks
+      # Save ASDF cache
+      - save_cache:
+          name: Save ASDF cache
+          key: asdf-docker-<< pipeline.parameters.default-ruby >>
+          paths:
+            - ~/.asdf/installs
+            - ~/.asdf/plugins
+            - ~/.asdf/shims
       # Install dependencies using bundler
       - ruby/install-deps:
-          key: gems-v{{ .Environment.CACHE_VERSION }}
+          key: gems-v{{ .Environment.CACHE_VERSION }}-{{ checksum "~/.tool-versions" }}
       # Run Rubocop
       - run:
           name: Run Rubocop
@@ -113,19 +128,34 @@ jobs:
                 name: Install ImageMagick, libvips and libffi
                 command: |
                   brew install openssl@3 imagemagick vips asdf libffi
+      - run:
+          name: Install Ruby << parameters.ruby-version >>
+          command: echo "ruby << parameters.ruby-version >>" > ~/.tool-versions
+      # Restore ASDF cache
+      - restore_cache:
+          name: Restore ASDF cache
+          keys:
+            - asdf-<< parameters.os >>-<< parameters.ruby-version >>
       # Install requested Ruby version
       - run:
           name: Install Ruby << parameters.ruby-version >>
           command: |
             asdf plugin add ruby
-            asdf install ruby << parameters.ruby-version >>
-            echo "ruby << parameters.ruby-version >>" > ~/.tool-versions
+            ASDF_RUBY_BUILD_VERSION=master asdf install ruby << parameters.ruby-version >>
             gem install --user-install executable-hooks
+      # Save ASDF cache
+      - save_cache:
+          name: Save ASDF cache
+          key: asdf-<< parameters.os >>-<< parameters.ruby-version >>
+          paths:
+            - ~/.asdf/installs
+            - ~/.asdf/plugins
+            - ~/.asdf/shims
       # Check out code
       - checkout
       # Install dependencies using bundler
       - ruby/install-deps:
-          key: gems-v{{ .Environment.CACHE_VERSION }}
+          key: gems-v{{ .Environment.CACHE_VERSION }}-{{ checksum "~/.tool-versions" }}
       # Run RSpec tests
       - run:
           name: Run tests
@@ -162,7 +192,7 @@ jobs:
   # Sonarcloud Job
   sonarcloud:
     docker:
-      - image: cimg/openjdk:21.0-node
+      - image: cimg/base:current
         <<: *common-auth
     resource_class: small
     steps:
@@ -186,7 +216,7 @@ jobs:
   # Release Job
   release:
     docker:
-      - image: cimg/base:stable
+      - image: cimg/base:current
         <<: *common-auth
     resource_class: medium+
     environment:
@@ -205,21 +235,36 @@ jobs:
               libyaml-dev openssl libtool libz-dev libjemalloc-dev \
               libgmp-dev build-essential ruby-dev libssl-dev zlib1g-dev
       - asdf/install
+      - run:
+          name: Set default Ruby to << pipeline.parameters.default-ruby >>
+          command: echo "ruby << pipeline.parameters.default-ruby >>" > ~/.tool-versions
+      # Restore ASDF cache
+      - restore_cache:
+          name: Restore ASDF cache
+          keys:
+            - asdf-docker-<< pipeline.parameters.default-ruby >>
       # Install requested Ruby version
       - run:
           name: Install Ruby << pipeline.parameters.default-ruby >>
           command: |
             asdf plugin add ruby
-            asdf install ruby << pipeline.parameters.default-ruby >>
-            echo "ruby << pipeline.parameters.default-ruby >>" > ~/.tool-versions
+            ASDF_RUBY_BUILD_VERSION=master asdf install ruby << pipeline.parameters.default-ruby >>
             gem install --user-install executable-hooks
+      # Save ASDF cache
+      - save_cache:
+          name: Save ASDF cache
+          key: asdf-docker-<< pipeline.parameters.default-ruby >>
+          paths:
+            - ~/.asdf/installs
+            - ~/.asdf/plugins
+            - ~/.asdf/shims
       - checkout
       - run:
           name: Check out main branch
           command: git checkout --force "${GIT_MAIN_BRANCH}"
       # Install dependencies using bundler
       - ruby/install-deps:
-          key: gems-v{{ .Environment.CACHE_VERSION }}
+          key: gems-v{{ .Environment.CACHE_VERSION }}-{{ checksum "~/.tool-versions" }}
       - run:
           name: Build and push gem
           command: |
@@ -299,7 +344,7 @@ workflows:
           matrix:
             parameters:
               os: ["docker", "macos"]
-              ruby-version: ["3.3.8", "3.2.3", "3.1.6"]
+              ruby-version: ["3.4.5", "3.3.9", "3.2.9", "3.1.7"]
           filters:
             tags:
               only: /^\d+\.\d+\.\d+$/
@@ -321,7 +366,6 @@ workflows:
             - SonarCloud
           requires:
             - lint
-            - test
           filters:
             tags:
               only: /^\d+\.\d+\.\d+$/

.tool-versions

@@ -1 +1 @@
-ruby 3.3.8 3.2.3 3.1.6
+ruby 3.4.5 3.3.9 3.2.9 3.1.7

.vscode/settings.json

@@ -0,0 +1,6 @@
+{
+    "sonarlint.connectedMode.project": {
+        "connectionId": "remove-bg",
+        "projectKey": "remove-bg_ruby"
+    }
+}

.yamllint.yml

@@ -0,0 +1,19 @@
+---
+
+extends: default
+
+yaml-files:
+  - '*.yaml'
+  - '*.yml'
+
+rules:
+  line-length:
+    max: 250
+    level: warning
+
+ignore: |
+  rspec
+  resources
+  gemfiles
+  examples
+  .git

Appraisals

@@ -50,6 +50,26 @@ appraise "faraday-2-9" do
   gem "faraday", "~> 2.9.0"
 end
 
+# Faraday 2.10
+appraise "faraday-2-10" do
+  gem "faraday", "~> 2.10.0"
+end
+
+# Faraday 2.11
+appraise "faraday-2-11" do
+  gem "faraday", "~> 2.11.0"
+end
+
+# Faraday 2.12
+appraise "faraday-2-12" do
+  gem "faraday", "~> 2.12.0"
+end
+
+# Faraday 2.13
+appraise "faraday-2-13" do
+  gem "faraday", "~> 2.13.0"
+end
+
 # Latest in Faraday 2.x series
 appraise "faraday-2-x" do
   gem "faraday", "~> 2", "< 3"

gemfiles/faraday_2_10.gemfile

@@ -0,0 +1,7 @@
+# This file was generated by Appraisal
+
+source "https://rubygems.org"
+
+gem "faraday", "~> 2.10.0"
+
+gemspec path: "../"

gemfiles/faraday_2_11.gemfile

@@ -0,0 +1,7 @@
+# This file was generated by Appraisal
+
+source "https://rubygems.org"
+
+gem "faraday", "~> 2.11.0"
+
+gemspec path: "../"

gemfiles/faraday_2_12.gemfile

@@ -0,0 +1,7 @@
+# This file was generated by Appraisal
+
+source "https://rubygems.org"
+
+gem "faraday", "~> 2.12.0"
+
+gemspec path: "../"

gemfiles/faraday_2_13.gemfile

@@ -0,0 +1,7 @@
+# This file was generated by Appraisal
+
+source "https://rubygems.org"
+
+gem "faraday", "~> 2.13.0"
+
+gemspec path: "../"