-
Notifications
You must be signed in to change notification settings - Fork 185
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Ruby 3.2 support #3039
Comments
I'll look at 19071, |
looking at |
Working on |
Working on |
We are looking at |
👋 Manef from Shopify, Is still targeting 3.2 ? Ty ! |
@manefz It's deprecated in 3.2 and removed in 3.3. So this item is to deprecate it, that is emit the same warning as CRuby 3.2 does when using that method. |
Marking this as closed and done (70/88) for 24.0. |
For anyone trying Rails 8 with TruffleRuby, |
Right, thank you for mentioning this. The issue was resolved in Rails 8.0.1 (rails/rails#53582) so it does not require any monkey patching. |
We are working on Ruby 3.2 support for the next release (23.1).
Any help is appreciated whether it is:
To make it easier to find good getting-started issues, I annotated items with
easy
,medium
andhard
.There is also
pure ruby
for changes which should only affect Ruby code and not require any change to Java sources or any Java knowledge.If there is no
pure ruby
then some Java code is involved, but it should still be fairly straightforward ifeasy
ormedium
.hard
typically requires more knowledge about TruffleRuby implementation details.[import]
means this needs the import of Ruby 3.2 sources to happen first.If you'd like to start on some task please mention it here or edit the description directly for committers (to avoid duplicated work).
Currently RUBY_VERSION is still 3.1.x. So to work on 3.2 changes, follow this documentation.
Notes
Full list of changes for Ruby 3.2.0
NOTE: https://rubyreferences.github.io/rubychanges/3.2.html gives more details for many features and changes.
From https://github.com/ruby/ruby/blob/master/doc/NEWS/NEWS-3.2.0.md:
This document is a list of user-visible feature changes
since the 3.1.0 release, except for bug fixes.
Note that each entry is kept to a minimum, see links for details.
Language changes
[parser, YARP] Anonymous rest and keyword rest arguments can now be passed as
arguments, instead of just used in method parameters.
[Feature #18351]
[medium, java] A proc that accepts a single positional argument and keywords will
no longer autosplat. [Bug #18633]
[medium, java] (@andrykonchin) Constant assignment evaluation order for constants set on explicit
objects has been made consistent with single attribute assignment
evaluation order. With this code:
foo
is now called beforebaz
. Similarly, for multiple assignmentsto constants, left-to-right evaluation order is used. With this
code:
The following evaluation order is now used:
foo1
foo2
baz1
baz2
[Bug #15928]
[parser, YARP, need to implement Find pattern in translator] "Find pattern" is no longer experimental.
[Feature #18585]
@eregon Methods taking a rest parameter (like
*args
) and wishing to delegate keywordarguments through
foo(*args)
must now be marked withruby2_keywords
(if not already the case). In other words, all methods wishing to delegate
keyword arguments through
*args
must now be marked withruby2_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 aninconsistency. A good technique to find the potentially-missing
ruby2_keywords
is to run the test suite, for where it fails find the last method which must
receive keyword arguments, use
puts nil, caller, nil
there, and check eachmethod/block on the call chain which must delegate keywords is correctly marked
as
ruby2_keywords
. [Bug #18625] [Bug #16466]Core classes updates
Note: We're only listing outstanding class updates.
Fiber
[medium, java] Introduce Fiber.[] and Fiber.[]= for inheritable fiber storage.
Introduce Fiber#storage and Fiber#storage= (experimental) for
getting and resetting the current storage. Introduce
Fiber.new(storage:)
for setting the storage when creating afiber. [Feature #19078]
Existing Thread and Fiber local variables can be tricky to use.
Thread-local variables are shared between all fibers, making it
hard to isolate, while Fiber-local variables can be hard to
share. It is often desirable to define unit of execution
("execution context") such that some state is shared between all
fibers and threads created in that context. This is what Fiber
storage provides.
You should generally consider Fiber storage for any state which
you want to be shared implicitly between all fibers and threads
created in a given context, e.g. a connection pool, a request
id, a logger level, environment variables, configuration, etc.
Fiber::Scheduler
Fiber::Scheduler#io_select
for non-blocking IO.select.[Feature #19060]
IO
[hard, java] Introduce IO#timeout= and IO#timeout which can cause
IO::TimeoutError to be raised if a blocking operation exceeds the
specified timeout. [Feature #18630]
@moste00 [easy, pure ruby] Introduce
IO.new(..., path:)
and promoteFile#path
toIO#path
. [Feature #19036]Class
[easy, java] Class#attached_object, which returns the object for which
the receiver is the singleton class. Raises TypeError if the receiver is not a singleton class. [Feature #12084]
Data
@moste00 [medium, pure ruby] 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]
Encoding
Encoding::UTF_16
andEncoding::UTF_32
encodings no longertry to dynamically guess the endian based on a byte order mark.
Use
Encoding::UTF_16BE
/UTF_16LE
andEncoding::UTF_32BE
/UTF_32LE
instead.This change speeds up getting the encoding of a String. [Feature #18949]
If exceeding maximum size,
EncodingError
will be raised. [Feature #18949]Enumerator
Exception
The default error printer calls this method on the Exception object
instead of #message. [Feature #18564]
Hash
empty, instead of returning the default value or
calling the default proc. [Bug #16908]
Integer
Kernel
(such as a method defined in C). [Bug #18487]
MatchData
Module
Proc
Process
RLIMIT_NPTS
constant to FreeBSD platformRegexp
The cache-based optimization is introduced.
Many (but not all) Regexp matching is now in linear time, which
will prevent regular expression denial of service (ReDoS)
vulnerability. [Feature #19104]
[medium, java] Regexp.linear_time? is introduced. [Feature #19194]
@rwstauner [easy, pure ruby] Regexp.new now supports passing the regexp flags not only as an Integer,
but also as a String. Unknown flags raise ArgumentError.
Otherwise, anything other than
true
,false
,nil
or Integer will be warned.[Feature #18788]
[hard, java, would need changes in tregex backtracker] Regexp.timeout= has been added. Also, Regexp.new new supports timeout keyword.
See [Feature #17837]
Refinement
Set
require "set"
. [Feature #16989]It is currently autoloaded via the Set constant or a call to Enumerable#to_set.
String
(also applies to Regexp)
Struct
@rwstauner [easy, pure ruby] A Struct class can also be initialized with keyword arguments
without
keyword_init: true
on Struct.new [Feature #16806]Thread
Thread::Queue
Thread::SizedQueue
Time
@rwstauner [easy, pure ruby] Time#deconstruct_keys is added, allowing to use Time instances
in pattern-matching expressions [Feature #19071]
[medium] Time.new now can parse a string like generated by Time#inspect
and return a Time instance based on the given argument.
[Feature #18033]
SyntaxError
TracePoint
nil
forc_call
/c_return
TracePoints.[Bug #18487]
target_thread
keyword argument now defaults to thecurrent thread if a block is given and
target
andtarget_line
keywordarguments are not passed. [Bug #16889]
UnboundMethod
@rwstauner [easy, java]
UnboundMethod#==
returnstrue
if the actual method is same. For example,String.instance_method(:object_id) == Array.instance_method(:object_id)
returns
true
. [Feature #18798]@rwstauner [easy, ruby+java]
UnboundMethod#inspect
does not show the receiver ofinstance_method
.For example
String.instance_method(:object_id).inspect
returns"#<UnboundMethod: Kernel#object_id()>"
(was
"#<UnboundMethod: String(Kernel)#object_id()>"
).Stdlib updates
CGI
CGI.escapeURIComponent
andCGI.unescapeURIComponent
are added.[Feature #18822]
Coverage
[hard, java]
Coverage.setup
now acceptseval: true
. By this,eval
and related methods areable to generate code coverage. [Feature #19008]
[easy, pure ruby]
Coverage.supported?(mode)
enables detection of what coverage modes aresupported. [Feature #19026]
Date
Date#deconstruct_keys
andDateTime#deconstruct_keys
same as [Feature #19071]FileUtils
relative:
option to FileUtils.ln_s.[Feature #18925]
IRB
debug
,break
,catch
,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?
*
edit
andshow_cmds
(like Pry'shelp
) 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@
.Net::Protocol
Net::BufferedIO
performance. [GH-net-protocol-14]Pathname
Pathname#lutime
. [GH-pathname-20]Socket
*
SO_INCOMING_CPU
*
SO_INCOMING_NAPI_ID
*
SO_RTABLE
*
SO_SETFIB
*
SO_USER_COOKIE
*
TCP_KEEPALIVE
*
TCP_CONNECTION_INFO
SyntaxSuggest
syntax_suggest
formerlydead_end
is integrated in Ruby.[Feature #18159]
UNIXSocket
Add support for UNIXSocket on Windows. Emulate anonymous sockets. Add
support for File.socket? and File::Stat#socket? where possible.
[Feature #19135]
[import] The following default gems are updated.
[import] The following bundled gems are updated.
See GitHub releases like GitHub Releases of Logger or changelog for details of the default gems or bundled gems.
Compatibility issues
[easy, pure ruby]
String#to_c
currently treat a sequence of underscores as an end of Complexstring. [Bug #19087]
[easy, pure ruby] Now
ENV.clone
raisesTypeError
as well asENV.dup
[Bug #17767]Removed constants
The following deprecated constants are removed.
Fixnum
andBignum
[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]
Method#public?
,Method#private?
,Method#protected?
,UnboundMethod#public?
,UnboundMethod#private?
,UnboundMethod#protected?
[Bug #18729] [Bug #18751] [Bug #18435]
Error printer
error message. [Feature #18367]
Constant lookup when defining a class/module
statement, if there is already a class/module defined by
Module#include
with the same name, the statement was handled as "open class" in Ruby 3.1 or before.
Since Ruby 3.2, a new class is defined instead. [Feature #18832]
Stdlib compatibility issues
Psych no longer bundles libyaml sources.
And also Fiddle no longer bundles libffi sources.
Users need to install the libyaml/libffi library themselves via the package
manager like apt, yum, brew, etc.
Psych and fiddle supported the static build with specific version of libyaml
and libffi sources. You can build psych with libyaml-0.2.5 like this.
And you can build fiddle with libffi-3.4.4 like this.
[Feature #18571]
[import] Check cookie name/path/domain characters in
CGI::Cookie
. [CVE-2021-33621][import]
URI.parse
return empty string in host instead of nil. [sec-156615]C API updates
Added C APIs
VALUE rb_hash_new_capa(long capa)
was added to created hashes with the desired capacity.rb_internal_thread_add_event_hook
andrb_internal_thread_add_event_hook
were added to instrument threads scheduling.The following events are available:
RUBY_INTERNAL_THREAD_EVENT_STARTED
RUBY_INTERNAL_THREAD_EVENT_READY
RUBY_INTERNAL_THREAD_EVENT_RESUMED
RUBY_INTERNAL_THREAD_EVENT_SUSPENDED
RUBY_INTERNAL_THREAD_EVENT_EXITED
rb_debug_inspector_current_depth
andrb_debug_inspector_frame_depth
are added for debuggers.Removed C APIs
The following deprecated APIs are removed.
rb_cData
variable.Implementation improvements
The text was updated successfully, but these errors were encountered: