Open eregon opened 3 years ago
I think this is already covered and can be marked completed:
Symbol#to_proc now returns a lambda Proc
Revised the "Language changes" and "Core classes updates" sections and marked items that are already tested.
Thanks!
Pattern matching (case/in) is no longer experimental. [Feature #17260]
Hi! It looks like already done by this commit https://github.com/ruby/spec/commit/10931592e0f7edb57829d990eed2600d726fb5a2
@moofkit Yes, but that change doesn't check there is no warning in 3.0+ for regular pattern matching (1-line pattern matching is still experimental in 3.0). Could you add a spec in that file that check -> { some pattern matching }.should not_complain
for 3.0+?
I'll take on a few pattern matching items:
=>
) [Feature #17260]in
) [Feature #17371]Will wait to go after Feature #16828 until I understand conventions for contributing to this repo.
Feature#16378 (Argument forwarding with leading arg) had been completed by the following commit:
https://github.com/ruby/spec/commit/b089bf7817d1fbe76d1ab752cb3744724bb2a825
@eregon
Hash#except has been added, which returns a hash excluding the given keys and their values. [Feature #15822]
Is already implemented on : https://github.com/ruby/spec/pull/786
@eregon
Random::DEFAULT now refers to the Random class instead of being a Random instance, so it can work with Ractor. [Feature #17322]
And
Random::DEFAULT is deprecated since its value is now confusing and it is no longer global, use Kernel.rand/Random.rand directly, or create a Random instance with Random.new instead. [Feature #17351]
Are already implemented on: https://github.com/ruby/spec/commit/25d878a7b4
@JuanCrg90 Thanks! I noted those as done.
@eregon
Warning Warning#warn now supports a category keyword argument. [Feature #17122]
Was already implemented on: https://github.com/ruby/spec/commit/05ff9d434c
@marcandre I wonder, do you have specs for Ractor? I know you wrote https://github.com/marcandre/backports/tree/master/lib/backports/ractor. Or maybe you used CRuby tests to check it?
@eregon, oops, missed that notification, sorry.
Yes, I used CRuby tests to check my backport (and I was glad to have them all pass, except those that were checking that MovedError
or similar).
The "Core classes updates" has two sections named "Fiber". The second one is in between "Symbol" and "Thread". The last item of the second section is "Thread#join invokes the scheduler hooks block/unblock in a non-blocking execution context", this should probably be moved to "Thread" (similar to "ConditionVariable" and "Queue / SizedQueue")
ruby/spec already contains some specs for 3.0, 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.0.html gives more details for many features and changes.
From https://github.com/ruby/ruby/blob/master/doc/NEWS-3.0.0.md:
NEWS for Ruby 3.0.0
This document is a list of user visible feature changes since the 2.7.0 release, except for bug fixes.
Note that each entry is kept to a minimum, see links for details.
Language changes
[x] Keyword arguments are now separated from positional arguments. Code that resulted in deprecation warnings in Ruby 2.7 will now result in ArgumentError or different behavior. [Feature #14183]
[x] Procs accepting a single rest argument and keywords are no longer subject to autosplatting. This now matches the behavior of Procs accepting a single rest argument and no keywords. [Feature #16166]
[x] Arguments forwarding (
...
) now supports leading arguments. [Feature #16378][x] Pattern matching (
case/in
) is no longer experimental. [Feature #17260][x] One-line pattern matching is redesigned. [EXPERIMENTAL]
=>
is added. It can be used like a rightward assignment. [Feature #17260]in
is changed to returntrue
orfalse
. [Feature #17371][x] Find-pattern is added. [EXPERIMENTAL] [Feature #16828]
[x] Endless method definition is added. [EXPERIMENTAL] [Feature #16746]
[x] Interpolated String literals are no longer frozen when
# frozen-string-literal: true
is used. [Feature #17104][x] Magic comment
shareable_constant_value
added to freeze constants. See {Magic Comments}[rdoc-ref:doc/syntax/comments.rdoc@Magic+Comments] for more details. [Feature #17273][x] Deprecation warnings are no longer shown by default (since Ruby 2.7.2). Turn them on with
-W:deprecated
(or with-w
to show other warnings too). [Feature #16345][x]
$SAFE
and$KCODE
are now normal global variables with no special behavior. C-API methods related to$SAFE
have been removed. [Feature #16131] [Feature #17136][x] yield in singleton class definitions in methods is now a SyntaxError instead of a warning. yield in a class definition outside of a method is now a SyntaxError instead of a LocalJumpError. [Feature #15575]
[x] When a class variable is overtaken by the same definition in an ancestor class/module, a RuntimeError is now raised (previously, it only issued a warning in verbose mode). Additionally, accessing a class variable from the toplevel scope is now a RuntimeError. [Bug #14541]
[x] (to be sync'd from truffleruby) Assigning to a numbered parameter is now a SyntaxError instead of a warning.
Command line options
--help
optionRUBY_PAGER
orPAGER
is present and has a non-empty value, and the standard input and output are tty, the--help
option shows the help message via the pager designated by the value. [Feature #16754]--backtrace-limit
option--backtrace-limit
option limits the maximum length of a backtrace. [Feature #8661]Core classes updates
Outstanding ones only.
Array
[x] The following methods now return Array instances instead of subclass instances when called on subclass instances: [Bug #6087]
[x] Can be sliced with Enumerator::ArithmeticSequence
Binding
"(eval)"
for__FILE__
and1
for__LINE__
in the evaluated code. [Bug #4352] [Bug #17419]ConditionVariable
block
/unblock
scheduler hooks in a non-blocking context. [Feature #16786]Dir
sort:
keyword option. [Feature #8709]ENV
[x] ENV.except has been added, which returns a hash excluding the given keys and their values. [Feature #15822]
[ ] Windows: Read ENV names and values as UTF-8 encoded Strings [Feature #12650]
Encoding
[x] Added new encoding IBM720. [Feature #16233]
[x] Changed default for Encoding.default_external to UTF-8 on Windows [Feature #16604]
Fiber
[x] Fiber.new(blocking: true/false) allows you to create non-blocking execution contexts. [Feature #16786]
[x] Fiber#blocking? tells whether the fiber is non-blocking. [Feature #16786]
[ ] Fiber#backtrace and Fiber#backtrace_locations provide per-fiber backtrace. [Feature #16815]
[ ] The limitation of Fiber#transfer is relaxed. [Bug #17221]
GC
auto_compact=
totrue
will cause compaction to occur during major collections. At the moment, compaction adds significant overhead to major collections, so please test first! [Feature #17176]Hash
[x] Hash#transform_keys and Hash#transform_keys! now accept a hash that maps keys to new keys. [Feature #16274]
[x] Hash#except has been added, which returns a hash excluding the given keys and their values. [Feature #15822]
IO
[x] IO#nonblock? now defaults to
true
. [Feature #16786][ ] @aardvark179 IO#wait_readable, IO#wait_writable, IO#read, IO#write and other related methods (e.g. IO#puts, IO#gets) may invoke the scheduler hook
#io_wait(io, events, timeout)
in a non-blocking execution context. [Feature #16786]Kernel
[x] Kernel#clone when called with the
freeze: false
keyword will call#initialize_clone
with thefreeze: false
keyword. [Bug #14266][x] Kernel#clone when called with the
freeze: true
keyword will call#initialize_clone
with thefreeze: true
keyword, and will return a frozen copy even if the receiver is unfrozen. [Feature #16175][x] Kernel#eval when called with two arguments will use
"(eval)"
for__FILE__
and1
for__LINE__
in the evaluated code. [Bug #4352][x] (added in truffleruby) Kernel#lambda now warns if called without a literal block. [Feature #15973]
[ ] @aardvark179 Kernel.sleep invokes the scheduler hook
#kernel_sleep(...)
in a non-blocking execution context. [Feature #16786]Module
[x] Module#include and Module#prepend now affect classes and modules that have already included or prepended the receiver, mirroring the behavior if the arguments were included in the receiver before the other modules and classes included or prepended the receiver. [Feature #9573]
[x] Module#public, Module#protected, Module#private, Module#public_class_method, Module#private_class_method, toplevel "private" and "public" methods now accept single array argument with a list of method names. [Feature #17314]
[x] Module#attr_accessor, Module#attr_reader, Module#attr_writer and Module#attr methods now return an array of defined method names as symbols. [Feature #17314]
[x] Module#alias_method now returns the defined alias as a symbol. [Feature #17314]
Mutex
Mutex
is now acquired per-Fiber
instead of per-Thread
. This change should be compatible for essentially all usages and avoids blocking when using a scheduler. [Feature #16792]Proc
Queue / SizedQueue
block
/unblock
scheduler hooks in a non-blocking context. [Feature #16786]Ractor
Random
[x]
Random::DEFAULT
now refers to theRandom
class instead of being aRandom
instance, so it can work withRactor
. [Feature #17322][x]
Random::DEFAULT
is deprecated since its value is now confusing and it is no longer global, useKernel.rand
/Random.rand
directly, or create aRandom
instance withRandom.new
instead. [Feature #17351]String
[x] The following methods now return or yield String instances instead of subclass instances when called on subclass instances: [Bug #10845]
Symbol
[x] Symbol#to_proc now returns a lambda Proc. [Feature #16260]
[x] Symbol#name has been added, which returns the name of the symbol if it is named. The returned string is frozen. [Feature #16150]
Fiber
[ ] @aardvark179 Introduce Fiber.set_scheduler for intercepting blocking operations and Fiber.scheduler for accessing the current scheduler. See rdoc-ref:fiber.md for more details about what operations are supported and how to implement the scheduler hooks. [Feature #16786]
[x] Fiber.blocking? tells whether the current execution context is blocking. [Feature #16786]
[ ] @aardvark179 Thread#join invokes the scheduler hooks
block
/unblock
in a non-blocking execution context. [Feature #16786]Thread
Warning
Stdlib updates
Set
[x] SortedSet has been removed for dependency and performance reasons.
[x] Set#join is added as a shorthand for
.to_a.join
.[x] Set#<=> is added.
Socket
Compatibility issues
Excluding feature bug fixes.
[x] Regexp literals and all Range objects are frozen. [Feature #8948] [Feature #16377] [Feature #15504]
[x] EXPERIMENTAL: Hash#each consistently yields a 2-element array. [Bug #12706]
{ a: 1 }.each(&->(k, v) { })
raises an ArgumentError due to lambda's arity check.[ ] When writing to STDOUT redirected to a closed pipe, no broken pipe error message will be shown now. [Feature #14413]
[x]
TRUE
/FALSE
/NIL
constants are no longer defined.[x] Integer#zero? overrides Numeric#zero? for optimization. [Misc #16961]
[x] Enumerable#grep and Enumerable#grep_v when passed a Regexp and no block no longer modify Regexp.last_match. [Bug #17030]
[x] Requiring 'open-uri' no longer redefines
Kernel#open
. CallURI.open
directly oruse URI#open
instead. [Misc #15893][x] SortedSet has been removed for dependency and performance reasons.
Stdlib compatibility issues
[x] Default gems
The following libraries are promoted to default gems from stdlib.
The following extensions are promoted to default gems from stdlib.
[x] Bundled gems
[x] SDBM has been removed from the Ruby standard library. [Bug #8446]
[x] WEBrick has been removed from the Ruby standard library. [Feature #17303]
C API updates
[x] C API functions related to
$SAFE
have been removed. [Feature #16131][x] C API header file
ruby/ruby.h
was split. [GH-2991]This should have no impact on extension libraries, but users might experience slow compilations.
[ ] Memory view interface [EXPERIMENTAL]
[x] Ractor related C APIs are introduced (experimental) in "include/ruby/ractor.h".
Implementation improvements
[x] New method cache mechanism for Ractor. [Feature #16614]
[x] The number of hashes allocated when using a keyword splat in a method call has been reduced to a maximum of 1, and passing a keyword splat to a method that accepts specific keywords does not allocate a hash.
[x]
super
is optimized when the same type of method is called in the previous call if it's not refinements or an attr reader or writer.Miscellaneous changes
[ ] Methods using
ruby2_keywords
will no longer keep empty keyword splats, those are now removed just as they are for methods not usingruby2_keywords
.[x] (seems untestable as 2.7 would only order reversed if TTY) When an exception is caught in the default handler, the error message and backtrace are printed in order from the innermost. [Feature #8661]
[x] (to be sync'd from truffleruby) Accessing an uninitialized instance variable no longer emits a warning in verbose mode. [Feature #17055]