Repository navigation
Write specs for new Ruby 3.1 features and changes #923
Description
Activity
@eregon pls update url for news - https://github.com/ruby/ruby/blob/master/doc/NEWS/NEWS-3.1.0.md
Done, thanks.
- pinned this issue
on Sep 9, 2022 - added 2 commits that reference this issue
on Oct 8, 2022 It seems the spec for
Array#intersect?already exists atcore/array/intersect_spec.rb."One-line pattern matching is no longer experimental." is also taken care of already in
language/pattern_matching_spec.rb.I'll add one for
Struct#keyword_init?now.- added a commit that references this issue
on Oct 8, 2022 It seems
Core classes updatesspecs below already exist.- Class
Class#subclasses
- Enumerable
Enumerable#compact is addedEnumerable#tally now accepts an optional hash to count
- File
File.dirname now accepts an optional argument for the level to strip path components
- GC
"GC.measure_total_time = true" enables the measurement of GC.GC.total_time returns measured time in nano-seconds
- Integer
Integer.try_convert is added
- Marshal
Marshal.load now accepts a freeze: true option
- MatchData
MatchData#match is addedMatchData#match_length is added
- Module
Module#private, #public, #protected, and #module_function will now return their arguments
- String
Update Unicode version to 13.0.0 and Emoji version to 13.0spec/library/rbconfig/unicode_version_spec.rb
Lines 11 to 15 in 5b20199
ruby_version_is "3.1"..."3.2" do it "is 13.0.0" do RbConfig::CONFIG['UNICODE_VERSION'].should == "13.0.0" end end spec/library/rbconfig/unicode_emoji_version_spec.rb
Lines 11 to 15 in 5b20199
ruby_version_is "3.1"..."3.2" do it "is 13.1" do RbConfig::CONFIG['UNICODE_EMOJI_VERSION'].should == "13.1" end end
String#unpack and String#unpack1 now accept an offset: keyword argument
- Thread::Queue
Thread::Queue.new now accepts an Enumerable of initial valuesspec/core/queue/initialize_spec.rb
Lines 10 to 12 in ff4ad11
ruby_version_is '3.1' do it "adds all elements of the passed Enumerable to self" do q = Queue.new([1, 2, 3])
- $LOAD_PATH
$LOAD_PATH.resolve_feature_path does not raise
Reacted by Sampat Badhe, Masato Ohba and Benoit DalozeReacted by Benoit Daloze- Class
I'll work on this one.
- Time.new now accepts optional in: keyword argument for the
timezone, as well as Time.at and Time.now, so that is now
you can omit minor arguments to Time.new. [Feature #17485]
Reacted by Kenichi Kamiya- Time.new now accepts optional in: keyword argument for the
@ytjmt Thank you, this is really helpful, I checked the done items in the list.
Also I would like to take this occasion to thank @byroot @makketagg @kachick @nobu @bjfish @jeremyevans @duerst @chrisseaton @znz @nirvdrum for contributing those specs, most of them done as soon as the feature got implemented, that is really great and helpful.
Reacted by Jean Boussier, Yuki Tsujimoto, Imir Kiyamov, Eduardo Hernandez and Kenichi KamiyaParentheses can be omitted in one-line pattern matching.
[Feature #16182]Has already been implemented:
spec/language/pattern_matching_spec.rb
Lines 1332 to 1342 in 22bb5b2
it "can omit parentheses in one line pattern matching" do eval(<<~RUBY).should == [1, 2] [1, 2] => a, b [a, b] RUBY eval(<<~RUBY).should == 1 {a: 1} => a: a RUBY end The pinning expression specs have also been implemented:
spec/language/pattern_matching_spec.rb
Lines 1380 to 1402 in 22bb5b2
it "supports pinning expressions" do eval(<<~RUBY).should == true case 'abc' in ^(/a/) true end RUBY eval(<<~RUBY).should == true case {name: '2.6', released_at: Time.new(2018, 12, 25)} in {released_at: ^(Time.new(2010)..Time.new(2020))} true end RUBY eval(<<~RUBY).should == true case 0 in ^(0+0) true end RUBY end end Reacted by Benoit DalozeHi,
May I work on this?
Multiple assignment evaluation order has been made consistent with
single assignment evaluation order. With single assignment, Ruby
uses a left-to-right evaluation order. With this code:
[Bug #4443]Edit: I had some free time and was curious about this change so kinda created a PR already. Feel free to close it if someone else was supposed to work on it.
@dushyantss Yes of course, since it's not checked, I'll try to review it soon.
Reacted by Dushyant Singh Shekhawat- unpinned this issue
on May 24, 2023
ruby/spec already contains some specs for 3.1, 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.
Please take a look at open pull requests before starting on a task to avoid duplicated work.
The new specs should be within a version guard block:
NOTE: https://rubyreferences.github.io/rubychanges/3.1.html gives more details for many features and changes.
From https://github.com/ruby/ruby/blob/master/doc/NEWS/NEWS-3.1.0.md:
NEWS for Ruby 3.1.0
This document is a list of user-visible feature changes
since the 3.0.0 release, except for bug fixes.
Note that each entry is kept to a minimum, see links for details.
Language changes
bcbc45e The block argument can now be anonymous if the block will
only be passed to another method. [Feature #11256]
Pin operator now takes an expression. [Feature #17411]
Pin operator now supports instance, class, and global variables.
[Feature #17724]
One-line pattern matching is no longer experimental.
Parentheses can be omitted in one-line pattern matching.
[Feature #16182]
Multiple assignment evaluation order has been made consistent with
single assignment evaluation order. With single assignment, Ruby
uses a left-to-right evaluation order. With this code:
The following evaluation order is used:
foobar[]=called on the result offooIn Ruby before 3.1.0, multiple assignment did not follow this
evaluation order. With this code:
Versions of Ruby before 3.1.0 would evaluate in the following
order
abfoo[]=called on the result offoobarbaz=called on the result ofbarStarting in Ruby 3.1.0, the evaluation order is now consistent with
single assignment, with the left-hand side being evaluated before
the right-hand side:
foobarab[]=called on the result offoobaz=called on the result ofbar[Bug #4443]
Values in Hash literals and keyword arguments can be omitted.
[Feature #14579]
For example,
{x:, y:}is a syntax sugar of{x: x, y: y}.foo(x:, y:)is a syntax sugar offoo(x: x, y: y).Constant names, local variable names, and method names are allowed as
key names. Note that a reserved word is considered as a local
variable or method name even if it's a pseudo variable name such as
self.Non main-Ractors can get instance variables (ivars) of classes/modules
if ivars refer to shareable objects.
[Feature #17592]
A command syntax is allowed in endless method definitions, i.e.,
you can now write
def foo = puts "Hello".Note that
private def foo = puts "Hello"does not parse.[Feature #17398]
Core classes updates
Note: We're only listing outstanding class updates.
Array
Class
Class#subclasses, which returns an array of classes
directly inheriting from the receiver, not
including singleton classes.
[Feature #18273]
Enumerable
Enumerable#compact is added. [Feature #17312]
Enumerable#tally now accepts an optional hash to count. [Feature #17744]
Enumerable#each_cons and each_slice to return a receiver. [GH-1509]
Enumerator::Lazy
File
strip path components. [Feature #12194]
GC
"GC.measure_total_time = true" enables the measurement of GC.
Measurement can introduce overhead. It is enabled by default.
GC.measure_total_time returns the current setting.
GC.stat[:time] or GC.stat(:time) returns measured time
in milli-seconds. [[Feature #10917]]
GC.total_time returns measured time in nano-seconds. [[Feature #10917]]
Integer
Kernel
and will load the file using the given module as the
top-level module. [Feature #6210]
Marshal
freeze: trueoption.All returned objects are frozen except for
ClassandModuleinstances. Strings are deduplicated. [Feature #18148]MatchData
MatchData#match is added [Feature #18172]
MatchData#match_length is added [Feature #18172]
Method / UnboundMethod
UnboundMethod#public?, UnboundMethod#private?,
UnboundMethod#protected? have been added. [Feature #11689]
Module
Module#prepend now modifies the ancestor chain if the receiver
already includes the argument. Module#prepend still does not
modify the ancestor chain if the receiver has already prepended
the argument. [Bug #17423]
Module#private, #public, #protected, and #module_function will
now return their arguments. If a single argument is given, it
is returned. If no arguments are given, nil is returned. If
multiple arguments are given, they are returned as an array.
[Feature #12495]
Process
Do not call this method directly; it is called by existing
fork methods: Kernel.#fork, Process.fork, and IO.popen("-").
Application monitoring libraries can overwrite this method to
hook fork events. [Feature #17795]
Struct
Passing only keyword arguments to Struct#initialize is warned.
You need to use a Hash literal to set a Hash to a first member.
[Feature #16806]
StructClass#keyword_init? is added [Feature #18008]
String
Update Unicode version to 13.0.0 [Feature #17750]
and Emoji version to 13.0 [Feature #18029]
String#unpack and String#unpack1 now accept an
offset:keywordargument to start the unpacking after an arbitrary number of bytes
have been skipped. If
offsetis outside of the string boundsArgumentErroris raised. [Feature #18254]Thread
Thread::Backtrace
length set by
--backtrace-limitcommand line option, is added.[Feature #17479]
Thread::Queue
[Feature #17327]
Time
Time.new now accepts optional
in:keyword argument for thetimezone, as well as
Time.atandTime.now, so that is nowyou can omit minor arguments to
Time.new. [Feature #17485]Time#strftime supports RFC 3339 UTC for unknown offset local
time,
-0000, as%-z. [Feature #17544]TracePoint
callback.
[Feature #15912]
$LOAD_PATH
Fiber Scheduler
Add support for
Addrinfo.getaddrinfousingaddress_resolvehook.[Feature #17370]
Introduce non-blocking
Timeout.timeoutusingtimeout_afterhook.[Feature #17470]
Introduce new scheduler hooks
io_readandio_writealong with alow level
IO::Bufferfor zero-copy read/write. [Feature #18020]IO hooks
io_wait,io_read,io_write, receive the original IO objectwhere possible. [Bug #18003]
Make
Monitorfiber-safe. [Bug #17827]Refinement
includeandprependare deprecated, andimport_methodsis addedinstead. [Bug #17429]
Stdlib updates
Coverage measurement now supports suspension. You can use
Coverage.suspendto stop the measurement temporarily, and
Coverage.resumeto restart it.See [Feature #18176] in detail.
Random::Formatter is moved to random/formatter.rb, so that you can
use
Random#hex,Random#base64, and so on without SecureRandom.[Feature #18190]
Compatibility issues
Note: Excluding feature bug fixes.
rb_io_wait_readable,rb_io_wait_writableandrb_wait_for_single_fdaredeprecated in favour of
rb_io_maybe_wait_readable,rb_io_maybe_wait_writableandrb_io_maybe_waitrespectively.rb_thread_wait_fdandrb_thread_fd_writableare deprecated. [Bug #18003]Stdlib compatibility issues
ERB#initializewarnssafe_leveland later arguments even without -w.[Feature #14256]
lib/debug.rbis replaced withdebug.gemKernel#ppinlib/pp.rbuses the width ofIO#winsizeby default.This means that the output width is automatically changed depending on
your terminal size. [Feature #12913]
Psych 4.0 changes
Psych.loadassafe_loadby the default.You may need to use Psych 3.3.2 for migrating to this behavior.
[Bug #17866]
C API updates
Documented. [GH-4815]
rb_gc_force_recycleis deprecated and has been changed to a no-op.[Feature #18290]
Implementation improvements
Inline cache mechanism is introduced for reading class variables.
[Feature #17763]
instance_evalandinstance_execnow only allocate a singleton class whenrequired, avoiding extra objects and improving performance. [GH-5146]
The performance of
Structaccessors is improved. [GH-5131]mandatory_only?builtin special form to improve performance onbuiltin methods. [GH-5112]
Experimental feature Variable Width Allocation in the garbage collector.
This feature is turned off by default and can be enabled by compiling Ruby
with flag
USE_RVARGC=1set. [Feature #18045] [Feature #18239]Debugger
A new debugger debug.gem is bundled.
debug.gem is a fast debugger implementation, and it provides many features
like remote debugging, colorful REPL, IDE (VSCode) integration, and more.
It replaces
lib/debug.rbstandard library.rdbgcommand is also installed intobin/directory to start and controldebugging execution.
error_highlight
A built-in gem called error_highlight has been introduced.
It shows fine-grained error locations in the backtrace.
Example:
title = json[:article][:title]If
jsonis nil, it shows:If
json[:article]returns nil, it shows:This feature is enabled by default.
You can disable it by using a command-line option
--disable-error_highlight.See the repository in detail.
Miscellaneous changes
lib/objspace/trace.rb is added, which is a tool for tracing the object
allocation. Just by requiring this file, tracing is started immediately.
Just by
Kernel#p, you can investigate where an object was created.Note that just requiring this file brings a large performance overhead.
This is only for debugging purposes. Do not use this in production.
[Feature #17762]
Now exceptions raised in finalizers will be printed to
STDERR, unless$VERBOSEisnil. [Feature #17798]ruby -run -e colorizeto colorize Ruby code usingIRB::Color.colorize_code.