Skip to content

Conversation

@mikeCRL
Copy link
Contributor

@mikeCRL mikeCRL commented Nov 20, 2025

Adds explicit dependencies for csv, logger, base64, and bigdecimal gems to support Ruby 3.4+.

Background

Starting in Ruby 3.4.0, several gems that were previously included in the standard library were removed from the default gems bundle.

This causes build failures when running Jekyll on Ruby 3.4+ with errors like:

cannot load such file -- csv (LoadError)
cannot load such file -- logger (LoadError)
cannot load such file -- base64 (LoadError)
cannot load such file -- bigdecimal (LoadError)

I upgraded to Ruby 3.4 locally given the likelihood that it would improve build times, and so it was necessary to add these gems to my Gemfile explicitly. There is no harm in adding these to the Gemfile in the repo—they are still bundled with 3.2 by default. Explicitly adding them to the Gemfile doesn't cause any issues - Bundler will just use the versions that are already available.

However, the benefit is that we can freely upgrade Ruby on team members machines, as well as our preview and production deployment environments.

Changes

Explicitly adds these gems to the Gemfile:

  • csv - required by Jekyll
  • logger - required by Jekyll
  • base64 - required by safe_yaml (Jekyll dependency)
  • bigdecimal - required by Liquid (Jekyll dependency)

Compatibility

These changes are fully backward compatible with Ruby 3.2.x:

  • Ruby 3.2.x (production/Netlify): These gems are bundled by default, so explicitly declaring them has no effect
  • Ruby 3.4.x (local dev): Now works properly with explicit dependencies

No changes required for existing workflows or production builds running Ruby 3.2.1.

Testing

  • Verified make standard works with Ruby 3.4.7
  • No impact on Ruby 3.2.x environments (per Claude, and verified through Netlify Preview build)

@mikeCRL mikeCRL marked this pull request as ready for review November 20, 2025 20:08
@mikeCRL mikeCRL requested a review from a team as a code owner November 20, 2025 20:08
@netlify
Copy link

netlify bot commented Nov 20, 2025

Deploy Preview for cockroachdb-api-docs canceled.

Name Link
🔨 Latest commit 2950d4e
🔍 Latest deploy log https://app.netlify.com/projects/cockroachdb-api-docs/deploys/691f752a2d636c000815d432

@netlify
Copy link

netlify bot commented Nov 20, 2025

Deploy Preview for cockroachdb-interactivetutorials-docs canceled.

Name Link
🔨 Latest commit 2950d4e
🔍 Latest deploy log https://app.netlify.com/projects/cockroachdb-interactivetutorials-docs/deploys/691f752a3a72cd0007bf1649

@github-actions
Copy link

Files changed:

  • src/current/Gemfile

@netlify
Copy link

netlify bot commented Nov 20, 2025

Deploy Preview for cockroachdb-docs failed. Why did it fail? →

Name Link
🔨 Latest commit 2950d4e
🔍 Latest deploy log https://app.netlify.com/projects/cockroachdb-docs/deploys/691f752a13fa2100082ba56d

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant