[ruby] Update Ruby 3.1.4 → 3.4.1 #402

depfu · 2024-12-27T07:15:59Z

Here is everything you need to know about this upgrade. Please take a good look at what changed and the test results before merging this pull request.

What changed?

Release Notes

3.4.1

Posted by naruse on 25 Dec 2024

Ruby 3.4.1 has been released.

This fixes the version description.

See the GitHub releases for further details.

3.4.0

Posted by naruse on 25 Dec 2024

We are pleased to announce the release of Ruby 3.4.0. Ruby 3.4 adds it block parameter reference, change Prism as default parser, adds Happy Eyeballs Version 2 support to socket library, improves YJIT, adds Modular GC, and so on.

it is introduced

it is added to reference a block parameter with no variable name. [Feature #18980]
ary = ["foo", "bar", "baz"]
p ary.map { it.upcase } #=> ["FOO", "BAR", "BAZ"]
it very much behaves the same as _1. When the intention is to only use _1 in a block, the potential for other numbered parameters such as _2 to also appear imposes an extra cognitive load onto readers. So it was introduced as a handy alias. Use it in simple cases where it speaks for itself, such as in one-line blocks.

Prism is now the default parser

Switch the default parser from parse.y to Prism. [Feature #20564]

This is an internal improvement and there should be little change visible to the user. If you notice any compatibility issues, please report them to us.

To use the conventional parser, use the command-line argument --parser=parse.y.

The socket library now features Happy Eyeballs Version 2 (RFC 8305)

The socket library now features Happy Eyeballs Version 2 (RFC 8305), the latest standardized version of a widely adopted approach for better connectivity in many programming languages, in TCPSocket.new (TCPSocket.open) and Socket.tcp. This improvement enables Ruby to provide efficient and reliable network connections, adapted to modern internet environments.

Until Ruby 3.3, these methods performed name resolution and connection attempts serially. With this algorithm, they now operate as follows:

Performs IPv6 and IPv4 name resolution concurrently

Attempt connections to the resolved IP addresses, prioritizing IPv6, with parallel attempts staggered at 250ms intervals

Return the first successful connection while canceling any others

This ensures minimized connection delays, even if a specific protocol or IP address is delayed or unavailable. This feature is enabled by default, so additional configuration is not required to use it. To disable it globally, set the environment variable RUBY_TCP_NO_FAST_FALLBACK=1 or call Socket.tcp_fast_fallback=false. Or to disable it on a per-method basis, use the keyword argument fast_fallback: false.

YJIT

TL;DR

Better performance across most benchmarks on both x86-64 and arm64 platforms.

Reduced memory usage through compressed metadata and a unified memory limit.

Various bug fixes: YJIT is now more robust and thoroughly tested.

New features

Command-line options

--yjit-mem-size introduces a unified memory limit (default 128MiB) to track total YJIT memory usage, providing a more intuitive alternative to the old --yjit-exec-mem-size option.

--yjit-log enables a compilation log to track what gets compiled.

Ruby API

RubyVM::YJIT.log provides access to the tail of the compilation log at run-time.

YJIT stats

RubyVM::YJIT.runtime_stats now always provides additional statistics on invalidation, inlining, and metadata encoding.

New optimizations

Compressed context reduces memory needed to store YJIT metadata

Allocate registers for local variables and Ruby method arguments

When YJIT is enabled, use more Core primitives written in Ruby:

Array#each, Array#select, Array#map rewritten in Ruby for better performance [Feature #20182].

Ability to inline small/trivial methods such as:

Empty methods

Methods returning a constant

Methods returning self

Methods directly returning an argument

Specialized codegen for many more runtime methods

Optimize String#getbyte, String#setbyte and other string methods

Optimize bitwise operations to speed up low-level bit/byte manipulation

Support shareable constants in multi-ractor mode

Various other incremental optimizations

Modular GC

Alternative garbage collector (GC) implementations can be loaded dynamically through the modular garbage collector feature. To enable this feature, configure Ruby with --with-modular-gc at build time. GC libraries can be loaded at runtime using the environment variable RUBY_GC_LIBRARY. [Feature #20351]

Ruby’s built-in garbage collector has been split into a separate file at gc/default/default.c and interacts with Ruby using an API defined in gc/gc_impl.h. The built-in garbage collector can now also be built as a library using make modular-gc MODULAR_GC=default and enabled using the environment variable RUBY_GC_LIBRARY=default. [Feature #20470]

An experimental GC library is provided based on MMTk. This GC library can be built using make modular-gc MODULAR_GC=mmtk and enabled using the environment variable RUBY_GC_LIBRARY=mmtk. This requires the Rust toolchain on the build machine. [Feature #20860]

Language changes

String literals in files without a frozen_string_literal comment now emit a deprecation warning when they are mutated. These warnings can be enabled with -W:deprecated or by setting Warning[:deprecated] = true. To disable this change, you can run Ruby with the --disable-frozen-string-literal command line argument. [Feature #20205]

Keyword splatting nil when calling methods is now supported. **nil is treated similarly to **{}, passing no keywords, and not calling any conversion methods. [Bug #20064]

Block passing is no longer allowed in index. [Bug #19918]

Keyword arguments are no longer allowed in index. [Bug #20218]

The toplevel name ::Ruby is reserved now, and the definition will be warned when Warning[:deprecated]. [Feature #20884]

Core classes updates

Note: We’re only listing notable updates of Core class.
Exception
<ul>
  <li>
Exception#set_backtrace now accepts an array of Thread::Backtrace::Location.
Kernel#raise, Thread#raise and Fiber#raise also accept this new format. [Feature #13557]
GC
<ul>
  <li>
    <p><code class="language-plaintext highlighter-rouge">GC.config</code> added to allow setting configuration variables on the Garbage
Collector. [Feature #20443]
GC configuration parameter rgengc_allow_full_mark introduced. When false
GC will only mark young objects. Default is true. [Feature #20443]
Ractor
<ul>
  <li>
    <p><code class="language-plaintext highlighter-rouge">require</code> in Ractor is allowed. The requiring process will be run on
the main Ractor.
Ractor._require(feature) is added to run requiring process on the
main Ractor.
[Feature #20627]
Ractor.main? is added. [Feature #20627]

Ractor.[] and Ractor.[]= are added to access the ractor local storage
of the current Ractor. [Feature #20715]

Ractor.store_if_absent(key){ init } is added to initialize ractor local
variables in thread-safty. [Feature #20875]
Range
<ul>
  <li>
Range#size now raises TypeError if the range is not iterable. [Misc #18984]
Standard Library updates

Note: We’re only listing notable updates of Standard librarires.
RubyGems

Add --attestation option to gem push. It enabled to store signature to sigstore.dev

Bundler

Add a lockfile_checksums configuration to include checksums in fresh lockfiles

Add bundle lock --add-checksums to add checksums to an existing lockfile
JSON
<ul>
  <li>Performance improvements of <code class="language-plaintext highlighter-rouge">JSON.parse</code> about 1.5 times faster than json-2.7.x.</li>
</ul>
Tempfile
<ul>
  <li>The keyword argument <code class="language-plaintext highlighter-rouge">anonymous: true</code> is implemented for Tempfile.create.
Tempfile.create(anonymous: true) removes the created temporary file immediately.
So applications don’t need to remove the file.
[Feature #20497]
win32/sspi.rb
<ul>
  <li>This library is now extracted from the Ruby repository to <a href="https://bounce.depfu.com/github.com/ruby/net-http-sspi">ruby/net-http-sspi</a>.
[Feature #20775]
Compatibility issues

Note: Excluding feature bug fixes.
Error messages and backtrace displays have been changed.

Use a single quote instead of a backtick as a opening quote. [Feature #16495]

Display a class name before a method name (only when the class has a permanent name). [Feature #19117]

Kernel#caller, Thread::Backtrace::Location’s methods, etc. are also changed accordingly.
<div class="language-plaintext highlighter-rouge">
Old:
test.rb:1:in `foo': undefined method `time' for an instance of Integer
        from test.rb:2:in `<main>'
New:

test.rb:1:in 'Object#foo': undefined method 'time' for an instance of Integer

from test.rb:2:in '<main>'
Hash#inspect rendering have been changed. [[Bug #20433]]
<ul>
  <li>Symbol keys are displayed using the modern symbol key syntax: <code class="language-plaintext highlighter-rouge">"{user: 1}"</code>
Other keys now have spaces around =>: '{"user" => 1}', while previously they didn’t: '{"user"=>1}'
Kernel#Float() now accepts a decimal string with decimal part omitted. [Feature #20705]
<div class="language-rb highlighter-rouge">
Float("1.")    #=> 1.0 (previously, an ArgumentError was raised)
Float("1.E-1") #=> 0.1 (previously, an ArgumentError was raised)
String#to_f now accepts a decimal string with decimal part omitted. Note that the result changes when an exponent is specified. [Feature #20705]
<div class="language-rb highlighter-rouge">
"1.".to_f    #=> 1.0
"1.E-1".to_f #=> 0.1 (previously, 1.0 was returned)
Refinement#refined_class has been removed. [Feature #19714]

Standard library compatibility issues
DidYouMean
<ul>
  <li>
DidYouMean::SPELL_CHECKERS[]= and DidYouMean::SPELL_CHECKERS.merge! are removed.
Net::HTTP
<ul>
  <li>Removed the following deprecated constants:
    <ul>
      <li><code class="language-plaintext highlighter-rouge">Net::HTTP::ProxyMod</code></li>
      <li><code class="language-plaintext highlighter-rouge">Net::NetPrivate::HTTPRequest</code></li>
      <li><code class="language-plaintext highlighter-rouge">Net::HTTPInformationCode</code></li>
      <li><code class="language-plaintext highlighter-rouge">Net::HTTPSuccessCode</code></li>
      <li><code class="language-plaintext highlighter-rouge">Net::HTTPRedirectionCode</code></li>
      <li><code class="language-plaintext highlighter-rouge">Net::HTTPRetriableCode</code></li>
      <li><code class="language-plaintext highlighter-rouge">Net::HTTPClientErrorCode</code></li>
      <li><code class="language-plaintext highlighter-rouge">Net::HTTPFatalErrorCode</code></li>
      <li><code class="language-plaintext highlighter-rouge">Net::HTTPServerErrorCode</code></li>
      <li><code class="language-plaintext highlighter-rouge">Net::HTTPResponseReceiver</code></li>
      <li><code class="language-plaintext highlighter-rouge">Net::HTTPResponceReceiver</code></li>
    </ul>

    <p>These constants were deprecated from 2012.</p>
  </li>
</ul>
Timeout
<ul>
  <li>Reject negative values for Timeout.timeout. [<a href="https://bugs.ruby-lang.org/issues/20795">Bug #20795</a>]</li>
</ul>
URI
<ul>
  <li>Switched default parser to RFC 3986 compliant from RFC 2396 compliant.
[Bug #19266]
C API updates

rb_newobj and rb_newobj_of (and corresponding macros RB_NEWOBJ, RB_NEWOBJ_OF, NEWOBJ, NEWOBJ_OF) have been removed. [Feature #20265]

Removed deprecated function rb_gc_force_recycle. [Feature #18290]

Miscellaneous changes

Passing a block to a method which doesn’t use the passed block will show a warning on verbose mode (-w). [Feature #15554]

Redefining some core methods that are specially optimized by the interpeter and JIT like String.freeze or Integer#+ now emits a performance class warning (-W:performance or Warning[:performance] = true). [Feature #20429]

See NEWS or commit logs for more details.

With those changes, 4942 files changed, 202244 insertions(+), 255528 deletions(-) since Ruby 3.3.0!

Merry Christmas, Happy Holidays, and enjoy programming with Ruby 3.4!

3.3.0

3.2.0

Posted by naruse on 25 Dec 2022

We are pleased to announce the release of Ruby 3.2.0. Ruby 3.2 adds many features and performance improvements.

WASI based WebAssembly support

This is an initial port of WASI based WebAssembly support. This enables a CRuby binary to be available on a Web browser, a Serverless Edge environment, or other kinds of WebAssembly/WASI embedders. Currently this port passes basic and bootstrap test suites not using the Thread API.

Background

WebAssembly (Wasm) was originally introduced to run programs safely and fast in web browsers. But its objective - running programs efficiently with security on various environment - is long wanted not only for web but also by general applications.

WASI (The WebAssembly System Interface) is designed for such use cases. Though such applications need to communicate with operating systems, WebAssembly runs on a virtual machine which didn’t have a system interface. WASI standardizes it.

WebAssembly/WASI support in Ruby intends to leverage those projects. It enables Ruby developers to write applications which run on such promised platforms.

Use case

This support encourages developers to utilize CRuby in a WebAssembly environment. An example use case is TryRuby playground’s CRuby support. Now you can try original CRuby in your web browser.

Technical points

Today’s WASI and WebAssembly itself is missing some features to implement Fiber, exception, and GC because it’s still evolving, and also for security reasons. So CRuby fills the gap by using Asyncify, which is a binary transformation technique to control execution in userland.

In addition, we built a VFS on top of WASI so that we can easily pack Ruby apps into a single .wasm file. This makes distribution of Ruby apps a bit easier.

Related links

Add WASI based WebAssembly support #5407

An Update on WebAssembly/WASI Support in Ruby

Production-ready YJIT

YJIT is no longer experimental

Has been tested on production workloads for over a year and proven to be quite stable.

YJIT now supports both x86-64 and arm64/aarch64 CPUs on Linux, MacOS, BSD and other UNIX platforms.

This release brings support for Apple M1/M2, AWS Graviton, Raspberry Pi 4 and more.

Building YJIT now requires Rust 1.58.0+. [Feature #18481]

In order to ensure that CRuby is built with YJIT, please install rustc >= 1.58.0 before running the ./configure script.

Please reach out to the YJIT team should you run into any issues.

The YJIT 3.2 release is faster than 3.1, and has about 1/3 as much memory overhead.

Overall YJIT is 41% faster (geometric mean) than the Ruby interpreter on yjit-bench.

Physical memory for JIT code is lazily allocated. Unlike Ruby 3.1, the RSS of a Ruby process is minimized because virtual memory pages allocated by --yjit-exec-mem-size will not be mapped to physical memory pages until actually utilized by JIT code.

Introduce Code GC that frees all code pages when the memory consumption by JIT code reaches --yjit-exec-mem-size.

RubyVM::YJIT.runtime_stats returns Code GC metrics in addition to existing inline_code_size and outlined_code_size keys: code_gc_count, live_page_count, freed_page_count, and freed_code_size.

Most of the statistics produced by RubyVM::YJIT.runtime_stats are now available in release builds.

Simply run ruby with --yjit-stats to compute and dump stats (incurs some run-time overhead).

YJIT is now optimized to take advantage of object shapes. [Feature #18776]

Take advantage of finer-grained constant invalidation to invalidate less code when defining new constants. [Feature #18589]

The default --yjit-exec-mem-size is changed to 64 (MiB).

The default --yjit-call-threshold is changed to 30.

Regexp improvements against ReDoS

It is known that Regexp matching may take unexpectedly long. If your code attempts to match a possibly inefficient Regexp against an untrusted input, an attacker may exploit it for efficient Denial of Service (so-called Regular expression DoS, or ReDoS).

We have introduced two improvements that significantly mitigate ReDoS.

Improved Regexp matching algorithm

Since Ruby 3.2, Regexp’s matching algorithm has been greatly improved by using a memoization technique.
# This match takes 10 sec. in Ruby 3.1, and 0.003 sec. in Ruby 3.2
/^ab?a$/ =~ "a" * 50000 + "x"
The improved matching algorithm allows most Regexp matching (about 90% in our experiments) to be completed in linear time.

(For preview users: this optimization may consume memory proportional to the input length for each match. We expect no practical problems to arise because this memory allocation is usually delayed, and a normal Regexp match should consume at most 10 times as much memory as the input length. If you run out of memory when matching Regexps in a real-world application, please report it.)

The original proposal is https://bugs.ruby-lang.org/issues/19104

Regexp timeout

The optimization above cannot be applied to some kind of regular expressions, such as those including advanced features (e.g., back-references or look-around), or with a huge fixed number of repetitions. As a fallback measure, a timeout feature for Regexp matches is also introduced.
Regexp.timeout = 1.0
/^ab?a()\1$/ =~ "a" * 50000 + "x"

#=> Regexp::TimeoutError is raised in one second
Note that Regexp.timeout is a global configuration. If you want to use different timeout settings for some special Regexps, you may want to use the timeout keyword for Regexp.new.
Regexp.timeout = 1.0
# This regexp has no timeout

long_time_re = Regexp.new('^ab?a()\1$', timeout: Float::INFINITY)
long_time_re =~ "a" * 50000 + "x" # never interrupted
The original proposal is https://bugs.ruby-lang.org/issues/17837.

Other Notable New Features

SyntaxSuggest
The feature of syntax_suggest (formerly dead_end) is integrated into Ruby. This helps you find the position of errors such as missing or superfluous ends, to get you back on your way faster, such as in the following example:
<div class="language-plaintext highlighter-rouge">
Unmatched `end', missing keyword (`do', `def`, `if`, etc.) ?
1  class Dog

> 2    defbark

> 3    end

4  end
<p>[<a href="https://bugs.ruby-lang.org/issues/18159">Feature #18159</a>]</p>
ErrorHighlight

Now it points at the relevant argument(s) for TypeError and ArgumentError
test.rb:2:in `+': nil can't be coerced into Integer (TypeError)
sum = ary[0] + ary[1]

^^^^^^
Language
Anonymous rest and keyword rest arguments can now be passed as arguments, instead of just used in method parameters. [Feature #18351]
<div class="language-ruby highlighter-rouge">
  def foo(*)
    bar(*)
  end
  def baz(**)
    quux(**)
  end
A proc that accepts a single positional argument and keywords will no longer autosplat. [Bug #18633]
<div class="language-ruby highlighter-rouge">
proc{|a, **k| a}.call([1, 2])
# Ruby 3.1 and before
# => 1
# Ruby 3.2 and after
# => [1, 2]
Constant assignment evaluation order for constants set on explicit objects has been made consistent with single attribute assignment evaluation order. With this code:
<div class="language-ruby highlighter-rouge">
  foo::BAR = baz
<p><code class="language-plaintext highlighter-rouge">foo</code> is now called before <code class="language-plaintext highlighter-rouge">baz</code>. Similarly, for multiple assignments
to constants, left-to-right evaluation order is used. With this
code:
<div class="language-ruby highlighter-rouge">
    foo1::BAR1, foo2::BAR2 = baz1, baz2
<p>The following evaluation order is now used:</p>

<ol>
  <li><code class="language-plaintext highlighter-rouge">foo1</code></li>
  <li><code class="language-plaintext highlighter-rouge">foo2</code></li>
  <li><code class="language-plaintext highlighter-rouge">baz1</code></li>
  <li><code class="language-plaintext highlighter-rouge">baz2</code></li>
</ol>

<p>[<a href="https://bugs.ruby-lang.org/issues/15928">Bug #15928</a>]</p>
The find pattern is no longer experimental. [Feature #18585]
Methods taking a rest parameter (like *args) and wishing to delegate keyword arguments through foo(*args) must now be marked with ruby2_keywords (if not already the case). In other words, all methods wishing to delegate keyword arguments through *args must now be marked with ruby2_keywords, with no exception. This will make it easier to transition to other ways of delegation once a library can require Ruby 3+. Previously, the ruby2_keywords flag was kept if the receiving method took *args, but this was a bug and an inconsistency. A good technique to find potentially missing ruby2_keywords is to run the test suite, find the last method which must receive keyword arguments for each place where the test suite fails, and use puts nil, caller, nil there. Then check that each method/block on the call chain which must delegate keywords is correctly marked with ruby2_keywords. [Bug #18625] [Bug #16466]
<div class="language-ruby highlighter-rouge">
  def target(**kw)
  end
# Accidentally worked without ruby2_keywords in Ruby 2.7-3.1, ruby2_keywords

# needed in 3.2+. Just like (args, **kwargs) or (...) would be needed on

# both #foo and #bar when migrating away from ruby2_keywords.

ruby2_keywords def bar(args)

target(*args)

end
ruby2_keywords def foo(args)

bar(args)

end
foo(k: 1)
Performance improvements

MJIT

The MJIT compiler is re-implemented in Ruby as ruby_vm/mjit/compiler.

MJIT compiler is executed under a forked Ruby process instead of doing it in a native thread called MJIT worker. [Feature #18968]

As a result, Microsoft Visual Studio (MSWIN) is no longer supported.

MinGW is no longer supported. [Feature #18824]

Rename --mjit-min-calls to --mjit-call-threshold.

Change default --mjit-max-cache back from 10000 to 100.

PubGrub
Bundler 2.4 now uses PubGrub resolver instead of Molinillo.
<ul>
  <li>PubGrub is the next generation solving algorithm used by <code class="language-plaintext highlighter-rouge">pub</code> package manager for the Dart programming language.</li>
  <li>You may get different resolution result after this change. Please report such cases to <a href="https://bounce.depfu.com/github.com/rubygems/rubygems/issues">RubyGems/Bundler issues</a>
RubyGems still uses Molinillo resolver in Ruby 3.2. We plan to replace it with PubGrub in the future.

Other notable changes since 3.1
Data
New core class to represent simple immutable value object. The class is similar to Struct and partially shares an implementation, but has more lean and strict API. [Feature #16122]
    <div class="language-ruby highlighter-rouge">
  Measure = Data.define(:amount, :unit)
  distance = Measure.new(100, 'km')            #=> #<data Measure amount=100, unit="km">
  weight = Measure.new(amount: 50, unit: 'kg') #=> #<data Measure amount=50, unit="kg">
  weight.with(amount: 40)                      #=> #<data Measure amount=40, unit="kg">
  weight.amount                                #=> 50
  weight.amount = 40                           #=> NoMethodError: undefined method `amount='
Hash

Hash#shift now always returns nil if the hash is empty, instead of returning the default value or calling the default proc. [Bug #16908]

MatchData

MatchData#byteoffset has been added. [Feature #13110]

Module

Module.used_refinements has been added. [Feature #14332]

Module#refinements has been added. [Feature #12737]

Module#const_added has been added. [Feature #17881]

Proc

Proc#dup returns an instance of subclass. [Bug #17545]

Proc#parameters now accepts lambda keyword. [Feature #15357]

Refinement

Refinement#refined_class has been added. [Feature #12737]
RubyVM::AbstractSyntaxTree
Add error_tolerant option for parse, parse_file and of. [Feature #19013] With this option

SyntaxError is suppressed

AST is returned for invalid input

end is complemented when a parser reaches to the end of input but end is insufficient

end is treated as keyword based on indent
    <div class="language-ruby highlighter-rouge">
  # Without error_tolerant option
  root = RubyVM::AbstractSyntaxTree.parse(<<~RUBY)
  def m
    a = 10
    if
  end
  RUBY
  # => <internal:ast>:33:in `parse': syntax error, unexpected `end' (SyntaxError)
# With error_tolerant option

root = RubyVM::AbstractSyntaxTree.parse(<<~RUBY, error_tolerant: true)

def m

a = 10

if

end

  RUBY

p root # => #<RubyVM::AbstractSyntaxTree::Node:SCOPE@1:0-4:3>
# end is treated as keyword based on indent

root = RubyVM::AbstractSyntaxTree.parse(<<~RUBY, error_tolerant: true)

module Z

class Foo

foo.

end
def bar
end

end

  RUBY

p root.children[-1].children[-1].children[-1].children[-2..-1]

# => [#<RubyVM::AbstractSyntaxTree::Node:CLASS@2:2-4:5>, #<RubyVM::AbstractSyntaxTree::Node:DEFN@6:2-7:5>]
Add keep_tokens option for parse, parse_file and of. [Feature #19070]
    <div class="language-ruby highlighter-rouge">
  root = RubyVM::AbstractSyntaxTree.parse("x = 1 + 2", keep_tokens: true)
  root.tokens # => [[0, :tIDENTIFIER, "x", [1, 0, 1, 1]], [1, :tSP, " ", [1, 1, 1, 2]], ...]
  root.tokens.map{_1[2]}.join # => "x = 1 + 2"
Set

Set is now available as a builtin class without the need for require "set". [Feature #16989] It is currently autoloaded via the Set constant or a call to Enumerable#to_set.

String

String#byteindex and String#byterindex have been added. [Feature #13110]

Update Unicode to Version 15.0.0 and Emoji Version 15.0. [Feature #18639] (also applies to Regexp)

String#bytesplice has been added. [Feature #18598]
Struct
A Struct class can also be initialized with keyword arguments without keyword_init: true on Struct.new [Feature #16806]
    <div class="language-ruby highlighter-rouge">
  Post = Struct.new(:id, :name)
  Post.new(1, "hello") #=> #<struct Post id=1, name="hello">
  # From Ruby 3.2, the following code also works without keyword_init: true.
  Post.new(id: 1, name: "hello") #=> #<struct Post id=1, name="hello">
Compatibility issues

Note: Excluding feature bug fixes.

Removed constants

The following deprecated constants are removed.

Fixnum and Bignum [Feature #12005]

Random::DEFAULT [Feature #17351]

Struct::Group

Struct::Passwd

Removed methods

The following deprecated methods are removed.

Dir.exists? [Feature #17391]

File.exists? [Feature #17391]

Kernel#=~ [Feature #15231]

Kernel#taint, Kernel#untaint, Kernel#tainted? [Feature #16131]

Kernel#trust, Kernel#untrust, Kernel#untrusted? [Feature #16131]

Stdlib compatibility issues

No longer bundle 3rd party sources
We no longer bundle 3rd party sources like libyaml, libffi.
<ul>
  <li>
    <p>libyaml source has been removed from psych. You may need to install <code class="language-plaintext highlighter-rouge">libyaml-dev</code> with Ubuntu/Debian platform. The package name is different for each platform.</p>
  </li>
  <li>
    <p>Bundled libffi source is also removed from <code class="language-plaintext highlighter-rouge">fiddle</code></p>
  </li>
</ul>
Psych and fiddle supported static builds with specific versions of libyaml and libffi sources. You can build psych with libyaml-0.2.5 like this:
<div class="language-bash highlighter-rouge">
  $ ./configure --with-libyaml-source-dir=/path/to/libyaml-0.2.5
<p>And you can build fiddle with libffi-3.4.4 like this:</p>

<div class="language-bash highlighter-rouge">
  $ ./configure --with-libffi-source-dir=/path/to/libffi-3.4.4
<p>[<a href="https://bugs.ruby-lang.org/issues/18571">Feature #18571</a>]</p>
C API updates

Updated C APIs

The following APIs are updated.

PRNG update

rb_random_interface_t updated and versioned. Extension libraries which use this interface and built for older versions. Also init_int32 function needs to be defined.

Removed C APIs

The following deprecated APIs are removed.

rb_cData variable.

“taintedness” and “trustedness” functions. [Feature #16131]

Standard library updates
Bundler
<ul>
  <li>Add –ext=rust support to bundle gem for creating simple gems with Rust extensions.
[GH-rubygems-6149]
Make cloning git repos faster [GH-rubygems-4475]
RubyGems
<ul>
  <li>Add mswin support for cargo builder. [<a href="https://bounce.depfu.com/github.com/rubygems/rubygems/pull/6167">GH-rubygems-6167</a>]</li>
</ul>
ERB
<ul>
  <li>
ERB::Util.html_escape is made faster than CGI.escapeHTML.

It no longer allocates a String object when no character needs to be escaped.

It skips calling #to_s method when an argument is already a String.

ERB::Escape.html_escape is added as an alias to ERB::Util.html_escape,
which has not been monkey-patched by Rails.
IRB
<ul>
  <li>debug.gem integration commands have been added: <code class="language-plaintext highlighter-rouge">debug</code>, <code class="language-plaintext highlighter-rouge">break</code>, <code class="language-plaintext highlighter-rouge">catch</code>,
next, delete, step, continue, finish, backtrace, info

They work even if you don’t have gem "debug" in your Gemfile.

See also: What’s new in Ruby 3.2’s IRB?
More Pry-like commands and features have been added.

edit and show_cmds (like Pry’s help) are added.

ls takes -g or -G option to filter out outputs.

show_source is aliased from $ and accepts unquoted inputs.

whereami is aliased from @.
The following default gems are updated.
<ul>
  <li>RubyGems 3.4.1</li>
  <li>abbrev 0.1.1</li>
  <li>benchmark 0.2.1</li>
  <li>bigdecimal 3.1.3</li>
  <li>bundler 2.4.1</li>
  <li>cgi 0.3.6</li>
  <li>csv 3.2.6</li>
  <li>date 3.3.3</li>
  <li>delegate 0.3.0</li>
  <li>did_you_mean 1.6.3</li>
  <li>digest 3.1.1</li>
  <li>drb 2.1.1</li>
  <li>english 0.7.2</li>
  <li>erb 4.0.2</li>
  <li>error_highlight 0.5.1</li>
  <li>etc 1.4.2</li>
  <li>fcntl 1.0.2</li>
  <li>fiddle 1.1.1</li>
  <li>fileutils 1.7.0</li>
  <li>forwardable 1.3.3</li>
  <li>getoptlong 0.2.0</li>
  <li>io-console 0.6.0</li>
  <li>io-nonblock 0.2.0</li>
  <li>io-wait 0.3.0</li>
  <li>ipaddr 1.2.5</li>
  <li>irb 1.6.2</li>
  <li>json 2.6.3</li>
  <li>logger 1.5.3</li>
  <li>mutex_m 0.1.2</li>
  <li>net-http 0.3.2</li>
  <li>net-protocol 0.2.1</li>
  <li>nkf 0.1.2</li>
  <li>open-uri 0.3.0</li>
  <li>open3 0.1.2</li>
  <li>openssl 3.1.0</li>
  <li>optparse 0.3.1</li>
  <li>ostruct 0.5.5</li>
  <li>pathname 0.2.1</li>
  <li>pp 0.4.0</li>
  <li>pstore 0.1.2</li>
  <li>psych 5.0.1</li>
  <li>racc 1.6.2</li>
  <li>rdoc 6.5.0</li>
  <li>readline-ext 0.1.5</li>
  <li>reline 0.3.2</li>
  <li>resolv 0.2.2</li>
  <li>resolv-replace 0.1.1</li>
  <li>securerandom 0.2.2</li>
  <li>set 1.0.3</li>
  <li>stringio 3.0.4</li>
  <li>strscan 3.0.5</li>
  <li>syntax_suggest 1.0.2</li>
  <li>syslog 0.1.1</li>
  <li>tempfile 0.1.3</li>
  <li>time 0.2.1</li>
  <li>timeout 0.3.1</li>
  <li>tmpdir 0.1.3</li>
  <li>tsort 0.1.1</li>
  <li>un 0.2.1</li>
  <li>uri 0.12.0</li>
  <li>weakref 0.1.2</li>
  <li>win32ole 1.8.9</li>
  <li>yaml 0.2.1</li>
  <li>zlib 3.0.0</li>
</ul>
The following bundled gems are updated.
<ul>
  <li>minitest 5.16.3</li>
  <li>power_assert 2.0.3</li>
  <li>test-unit 3.5.7</li>
  <li>net-ftp 0.2.0</li>
  <li>net-imap 0.3.3</li>
  <li>net-pop 0.1.2</li>
  <li>net-smtp 0.3.3</li>
  <li>rbs 2.8.2</li>
  <li>typeprof 0.21.3</li>
  <li>debug 1.7.1</li>
</ul>
See GitHub releases like GitHub Releases of logger or changelog for details of the default gems or bundled gems.

See NEWS or commit logs for more details.

With those changes, 3048 files changed, 218253 insertions(+), 131067 deletions(-) since Ruby 3.1.0!

Merry Christmas, Happy Holidays, and enjoy programming with Ruby 3.2!

All Depfu comment commands

@depfu refresh
Rebases against your default branch and redoes this update

@depfu recreate
Recreates this PR, overwriting any edits that you've made to it

@depfu merge
Merges this PR once your tests are passing and conflicts are resolved

@depfu close
Closes this PR and deletes the branch

@depfu reopen
Restores the branch and reopens this PR (if it's closed)

@depfu pause
Pauses all engine updates and closes this PR

Update Ruby to version 3.4.1

170dd99

depfu bot added dependencies Pull requests that update a dependency file Technical Debt labels Dec 27, 2024

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

[ruby] Update Ruby 3.1.4 → 3.4.1 #402

[ruby] Update Ruby 3.1.4 → 3.4.1 #402

depfu bot commented Dec 27, 2024

[ruby] Update Ruby 3.1.4 → 3.4.1 #402

Are you sure you want to change the base?

[ruby] Update Ruby 3.1.4 → 3.4.1 #402

Conversation

depfu bot commented Dec 27, 2024

What changed?

3.4.1

3.4.0

it is introduced

Prism is now the default parser

The socket library now features Happy Eyeballs Version 2 (RFC 8305)

YJIT

TL;DR

New features

New optimizations

Modular GC

Language changes

Core classes updates

Standard Library updates

Compatibility issues

Standard library compatibility issues

C API updates

Miscellaneous changes

3.3.0

3.2.0

WASI based WebAssembly support

Background

Use case

Technical points

Related links

Production-ready YJIT

Regexp improvements against ReDoS

Improved Regexp matching algorithm

Regexp timeout

Other Notable New Features

SyntaxSuggest

ErrorHighlight

Language

Performance improvements

MJIT

PubGrub

Other notable changes since 3.1

Compatibility issues

Removed constants

Removed methods

Stdlib compatibility issues

No longer bundle 3rd party sources

C API updates

Updated C APIs

Removed C APIs

Standard library updates

`it` is introduced