Open eregon opened 1 year ago
If I'm not wrong there are some specs already implemented that can be marked as done here like
Class#attached_object
, Hash#shift
, Integer#ceildiv
, Module#const_added
, Proc#parameters
, String#dedup
and probably few more.
Thank you. Marked the mentioned methods as completed.
Another batch of implemented ones:
A proc that accepts a single positional argument and keywords will no longer autosplat
Constant assignment evaluation order for constants set on explicit...
Encoding#replicate has been deprecated and will be removed in 3.3.
Kernel#binding raises RuntimeError if called from a non-Ruby frame
Added Date#deconstruct_keys and DateTime#deconstruct_keys
Fixnum
, Bignum
, Random::DEFAULT
Kernel#=~
UnboundMethod#inspect does not show the receiver of instance_method.
Thank you, I've updated the tasks.
Encoding#replicate has been deprecated and will be removed in 3.3.
There is a test case that checks the method is removed in Ruby 3.3 but we still need a test that it causes warning in Ruby 3.2
Update Unicode to Version 15.0.0 and Emoji Version 15.0. [Feature #18639]
It looks like that one has been covered in commit 8caf02ddc1d951425a5eea35fe93d5a1492f9c3a
Introduce
IO.new(..., path:)
and promoteFile#path
toIO#path
. [Feature #19036]
This looks to be covered in commit 62c1bbe88028961acd8fc059c3d14c24a95e0316
Thank you, marked as done.
ruby/spec already contains some specs for 3.2, but we should aim to cover all new features and important changes. This will improve the test coverage of these features (and maybe discover a few bugs along the way), allow other Ruby implementations to implement the changes faster with more confidence and document clearly the new behavior.
The new specs should be within a version guard block:
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:
NEWS for Ruby 3.2.0
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
[ ] Anonymous rest and keyword rest arguments can now be passed as arguments, instead of just used in method parameters. [Feature #18351]
[x] A proc that accepts a single positional argument and keywords will no longer autosplat. [Bug #18633]
[x] 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 assignments to constants, left-to-right evaluation order is used. With this code:The following evaluation order is now used:
foo1
foo2
baz1
baz2
[Bug #15928]
[ ] "Find pattern" is no longer experimental. [Feature #18585]
[ ] Methods taking a rest parameter (like
*args
) and wishing to delegate keyword arguments throughfoo(*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, theruby2_keywords
flag was kept if the receiving method took*args
, but this was a bug and an inconsistency. A good technique to find the potentially-missingruby2_keywords
is to run the test suite, for where it fails find the last method which must receive keyword arguments, useputs nil, caller, nil
there, and check each method/block on the call chain which must delegate keywords is correctly marked asruby2_keywords
. [Bug #18625] [Bug #16466]Core classes updates
Note: We're only listing outstanding class updates.
Fiber
[x] 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 a fiber. [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
[x] Introduce IO#timeout= and IO#timeout which can cause IO::TimeoutError to be raised if a blocking operation exceeds the specified timeout. [Feature #18630]
[x] Introduce
IO.new(..., path:)
and promoteFile#path
toIO#path
. [Feature #19036]Class
[x] 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
[x] 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 longer try to dynamically guess the endian based on a byte order mark. UseEncoding::UTF_16BE
/UTF_16LE
andEncoding::UTF_32BE
/UTF_32LE
instead. This change speeds up getting the encoding of a String. [Feature #18949]EncodingError
will be raised. [Feature #18949]Enumerator
Exception
Hash
Integer
Kernel
MatchData
Module
Proc
Process
RLIMIT_NPTS
constant to FreeBSD platformRegexp
[x] 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]
[x] Regexp.linear_time? is introduced. [Feature #19194]
[ ] 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][x] 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
Struct
[x] 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
[x] Time#deconstruct_keys is added, allowing to use Time instances in pattern-matching expressions [Feature #19071]
[x] 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 the current thread if a block is given andtarget
andtarget_line
keyword arguments are not passed. [Bug #16889]UnboundMethod
[ ]
UnboundMethod#==
returnstrue
if the actual method is same. For example,String.instance_method(:object_id) == Array.instance_method(:object_id)
returnstrue
. [Feature #18798][x]
UnboundMethod#inspect
does not show the receiver ofinstance_method
. For exampleString.instance_method(:object_id).inspect
returns"#<UnboundMethod: Kernel#object_id()>"
(was"#<UnboundMethod: String(Kernel)#object_id()>"
).Stdlib updates
Bundler
RubyGems
CGI
CGI.escapeURIComponent
andCGI.unescapeURIComponent
are added. [Feature #18822]Coverage
[ ]
Coverage.setup
now acceptseval: true
. By this,eval
and related methods are able to generate code coverage. [Feature #19008][x]
Coverage.supported?(mode)
enables detection of what coverage modes are supported. [Feature #19026]Date
Date#deconstruct_keys
andDateTime#deconstruct_keys
same as [Feature #19071]ERB
ERB::Util.html_escape
is made faster thanCGI.escapeHTML
.#to_s
method when an argument is already a String.ERB::Escape.html_escape
is added as an alias toERB::Util.html_escape
, which has not been monkey-patched by Rails.ERB::Util.url_encode
is made faster usingCGI.escapeURIComponent
.-S
option is removed fromerb
command.FileUtils
relative:
option to FileUtils.ln_s. [Feature #18925]IRB
debug
,break
,catch
,next
,delete
,step
,continue
,finish
,backtrace
,info
gem "debug"
in your Gemfile.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]
[x] The following default gems are updated.
[x] 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
[x]
String#to_c
currently treat a sequence of underscores as an end of Complex string. [Bug #19087][x] 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
Constant lookup when defining a class/module
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
[x] 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]
[ ] Check cookie name/path/domain characters in
CGI::Cookie
. [CVE-2021-33621][x]
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