Ruby 3.3 (#55)

Author: zverok

2.4.md

@@ -16,9 +16,9 @@ description: Ruby 2.4 full and annotated changelog
  -->
 
 * **Released at:** Dec 25, 2016 (<a class="github" href="https://github.com/ruby/ruby/blob/trunk/doc/NEWS-2.4.0">NEWS</a> file)
-* **Status (as of Feb 04, 2023):** EOL, latest is 2.4.10
+* **Status (as of Dec 21, 2023):** EOL, latest is 2.4.10
 * **This document first published:** Oct 14, 2019
-* **Last change to this document:** Feb 04, 2023
+* **Last change to this document:** Dec 21, 2023
 
 ## Highlights[](#highlights)
 
@@ -189,6 +189,7 @@ New single-method module was introduced, meant to be overridden in order to cont
     ```
   * In Ruby 2.7, new methods [were added](2.7.html#warning-and-) to `Warning` module allowing control over per-category warning suppression;
   * In Ruby 3.0, category support [was improved](3.0.html#warningwarn-category-keyword-argument).
+  * [3.3](3.3.html#new-warning-category-performance): added new warning category: `:performance`.
 
 ### `Object#clone(freeze: false)`[](#objectclonefreeze-false)
 

2.7.md

@@ -8,9 +8,9 @@ description: Ruby 2.7 full and annotated changelog
 # Ruby 2.7
 
 * **Released at:** Dec 25, 2019 (<a class="github" href="https://github.com/ruby/ruby/blob/ruby_2_7/NEWS">NEWS</a> file)
-* **Status (as of Sep 20, 2023):** 2.7.8 is EOL
+* **Status (as of Dec 21, 2023):** 2.7.8 is EOL
 * **This document first published:** Dec 27, 2019
-* **Last change to this document:** Sep 20, 2023
+* **Last change to this document:** Dec 21, 2023
 
 <!-- TODO: all links to docs should be replaced with /2.7.0/ suffix instead of /master/ when 2.7.0 would be published -->
 
@@ -121,7 +121,9 @@ In block without explicitly specified parameters, variables `_1` through `_9` ca
   # %w[test me].each { _1.each_char { p _1 } }
   #                    ^~
   ```
-* **Follow-up:** Warning on attempt to assign to numbered parameter [became errors in 3.0](3.0.html#other-changes).
+* **Follow-ups:**
+  * [3.0](3.0.html#other-changes): Warning on attempt to assign to numbered parameter became errors.
+  * [3.3](3.3.html#standalone-it-in-blocks-will-become-anonymous-argument-in-ruby-34): a warning introduced indicating that in Ruby 3.4, `it` would become an alternative anonymous block parameter (only one, same as `_1`). There is no plan to deprecate numbered parameters.
 
 ### Beginless range[](#beginless-range)
 
@@ -799,6 +801,7 @@ Like `Array#union` and `#difference`, [added](2.6.html#arrayunion-and-arraydiffe
   map[1]
   # => nil  -- value successfully collected, even if key was not GC-able
   ```
+* **Follow-ups:** [3.3](3.3.html#objectspaceweakkeymap): A new class `ObjectSpace::WeakKeyMap` introduced, more suitable for common use-cases of a "weak mapping." It only has garbage-collectable keys.
 
 ### `Fiber#raise`[](#fiberraise)
 
@@ -1028,7 +1031,7 @@ Allows to emit/suppress separate categories of warnings.
   ```
 * **Notes:**
   * The only existing categories currently are `:deprecated` (covers all deprecations) and `:experimental` (as of 2.7, covers only pattern matching)
-  * Note that turning of `:deprecated` warning will also mute the warning of features which was deprecated explicitly in your code, for example with <a class="ruby-doc" href="https://ruby-doc.org/core-2.7.0/Module.html#method-i-deprecate_constant"><code>Module#deprecate_constant</code></a>
+  * Note that turning off `:deprecated` warning will also mute the warning of features which was deprecated explicitly in your code, for example with <a class="ruby-doc" href="https://ruby-doc.org/core-2.7.0/Module.html#method-i-deprecate_constant"><code>Module#deprecate_constant</code></a>
     ```ruby
     class HTTP
       NOT_FOUND = Exception.new
@@ -1041,7 +1044,9 @@ Allows to emit/suppress separate categories of warnings.
     # ...no warning issued...
     ```
   * Another way to turn on and off separate categories of warnings is passing `-W:(no-)<category>` flag to ruby interpreter, e.g. `-W:no-experimental` means "no warnings when using experimental features".
-* **Follow-up:** In Ruby 3.0, it was [allowed for user code](3.0.html#warningwarn-category-keyword-argument) to specify warning category, and intercept it.
+* **Follow-ups:**
+  * [3.0](3.0.html#warningwarn-category-keyword-argument): user code is allowed to specify warning category, and intercept it;
+  * [3.3](3.3.html#new-warning-category-performance): added new warning category: `:performance`.
 
 ## Standard library[](#standard-library)
 

3.0.md

@@ -8,9 +8,9 @@ description: Ruby 3.0 full and annotated changelog
 # Ruby 3.0
 
 * **Released at:** Dec 25, 2020 (<a class="github" href="https://github.com/ruby/ruby/blob/ruby_3_0/NEWS.md">NEWS.md</a> file)
-* **Status (as of Sep 20, 2023):** 3.0.6 is security maintenance (will EOL soon!)
+* **Status (as of Dec 23, 2023):** 3.0.6 is security maintenance (will EOL soon!)
 * **This document first published:** Dec 25, 2020
-* **Last change to this document:** Sep 20, 2023
+* **Last change to this document:** Dec 23, 2023
 
 ## Highlights[](#highlights)
 
@@ -105,6 +105,7 @@ Just a leftover from the separation of keyword arguments.
   logged_get('Logging', 'https://example.com', headers: {content_type: 'json'})
   ```
 * **Notes:**
+  * The adjustment was considered important enough to be backported to 2.7 branch;
   * "all arguments splat" `...` should be the last statement in the argument list (both on a declaration and a call)
   * on a method declaration, arguments before `...` can only be positional (not keyword) arguments, and can't have default values (it would be `SyntaxError`);
   * on a method call, arguments passed before `...` can't be keyword arguments (it would be `SyntaxError`);
@@ -960,6 +961,7 @@ Just fixes an inconsistency introduced by optimization many versions ago.
   processed.lambda? # => false
   processed.call    # => "nil", it is really still not a lambda
   ```
+* **Follow-ups:** [3.3](3.3.html#kernellambda-raises-when-passed-proc-instance): The warning was turned into an exception.
 
 #### `Proc#==` and `#eql?`[](#proc-and-eql)
 

3.2.md

@@ -1,16 +1,16 @@
 ---
 title: Ruby 3.2 changes
-prev: /
+prev: 3.3
 next: 3.1
 description: Ruby 3.2 full and annotated changelog
 ---
 
 # Ruby 3.2
 
 * **Released at:** Dec 25, 2022 (<a class="github" href="https://github.com/ruby/ruby/blob/ruby_3_2/NEWS.md">NEWS.md</a> file)
-* **Status (as of Sep 20, 2023):** 3.2.2 is current _stable_
+* **Status (as of Dec 24, 2023):** 3.2.2 is current _stable_
 * **This document first published:** Feb 4, 2022
-* **Last change to this document:** Sep 20, 2023
+* **Last change to this document:** Dec 24, 2023
 
 <!--
 * **Reason:**
@@ -249,12 +249,12 @@ A few edge cases after [big keyword argument separation](3.0.html#keyword-argume
 ### Removals[](#removals)
 
 * Constants:
-  * `Fixnum` and `Bignum` (deprecated since unification into `Integer` in [2.4](/2.4.html#fixnum-and-bignum-are-unified-into-integer))
-  * `Random::DEFAULT` (deprecated in favor of per-Ractor random generator since [3.0](/3.0.html#randomdefault-behavior-change))
+  * `Fixnum` and `Bignum` (deprecated since unification into `Integer` in [2.4](2.4.html#fixnum-and-bignum-are-unified-into-integer))
+  * `Random::DEFAULT` (deprecated in favor of per-Ractor random generator since [3.0](3.0.html#randomdefault-behavior-change))
 * Methods:
   * `Dir.exists?`,  `File.exists?` (deprecated since 2.1 as a general rule of having "bare verb" as a method name)
-  * `Object#=~` (deprecated since [2.6](/2.6.html#minor-changes))
-  * `Object#taint`, `#untaint`, `#tainted?`, `#trust`, `#untrust`, `#untrusted?` (deprecated together with a general concept of "safety" since [2.7](/2.7.html#safe-and-taint-concepts-are-deprecated-in-general))
+  * `Object#=~` (deprecated since [2.6](2.6.html#minor-changes))
+  * `Object#taint`, `#untaint`, `#tainted?`, `#trust`, `#untrust`, `#untrusted?` (deprecated together with a general concept of "safety" since [2.7](2.7.html#safe-and-taint-concepts-are-deprecated-in-general))
 
 
 ## Core classes and modules[](#core-classes-and-modules)
@@ -504,20 +504,7 @@ Returns list of refinements the module defines.
 * **Discussion:** <a class="tracker feature" href="https://bugs.ruby-lang.org/issues/12737">Feature #12737</a>
 * **Documentation:** <a class="ruby-doc" href="https://docs.ruby-lang.org/en/3.2/Refinement.html#method-i-refined_class"><code>Refinement#refined_class</code></a>
 * **Code:** See example above that demonstrates usage of `#refined_class` together with `Module#refinements`.
-* **Note:** The name of the method implies only classes can be refined, which is not true; modules can be refined also, and `refined_class` will promptly return them:
-  ```ruby
-  module BetterEnum
-    refine Enumerable do
-      def each2(&block) = each_slice(2, &block)
-    end
-  end
-
-  BetterEnum.refinements[0].refined_class #=> Enumerable
-
-  using BetterEnum
-  (1..6).each2.to_a #=> [[1, 2], [3, 4], [5, 6]]
-  ```
-  Currently [discussed](https://bugs.ruby-lang.org/issues/19366).
+* **Follow-ups:** [3.3](3.3.html#refinementrefined_class-is-renamed-to-refinementtarget): Renamed to `#target`, because not only classes can be refined, modules too.
 
 #### `Module.used_refinements`[](#moduleused_refinements)
 
@@ -622,7 +609,9 @@ Several method were added that operate on multibyte strings at byte-offset level
   str.byteslice(1..3) #=> "\xB2і" -- works, even if the slice is mid-character
   str.bytesplice(1..3, '...') # offset 1 does not land on character boundary (IndexError)
   ```
-* **Note:** After 3.2 release, `bytesplice` behavior [had changed](https://bugs.ruby-lang.org/issues/19314#note-8) to return `self` instead of replacement string.
+* **Note:**
+  * After 3.2 release, `bytesplice` behavior [had changed](https://bugs.ruby-lang.org/issues/19314#note-8) to return `self` instead of replacement string.
+  * [3.3](3.3.html#stringbytesplice-new-arguments-to-select-a-portion-of-the-replacement-string): parameters added to `bytesplice` to allow partial copy of the buffer.
 
 #### `String#dedup` as an alias for `-"string"`[](#stringdedup-as-an-alias-for--string)
 
@@ -753,6 +742,7 @@ The new protocol for `Time.new` is introduced, that parses Time from string.
   #=> 2023-01-29 00:00:00 +0200
   ```
   * `Time.new('2023')` works, too, but it is a feature that worked before (force-conversion of singular year argument to integer), see <a class="tracker bug" href="https://bugs.ruby-lang.org/issues/19293">Bug #19293</a>. It will probably be deprecated, but can't be quickly removed due to backward compatibility.
+* **Follow-ups:**: [3.3](3.3.html#timenew-with-string-argument-became-stricter): `Time.new` became stricting, accepting only fully-specified date-time.
 
 ### `Struct` and `Data`[](#struct-and-data)
 
@@ -891,7 +881,8 @@ A new class for containing value objects: it is somewhat similar to `Struct` (an
     res
     #=> #<data Result array=[4, 3, 2, 1]>
     ```
-  * `#with` method in Ruby 3.2 is naive and just copies all old and new attributes to the new instance, without invoking any custom initialization methods. In the next version, though, it [expected to call `#initialize`](https://bugs.ruby-lang.org/issues/19259):
+* **Follow-ups:**
+  * `#with` method in Ruby 3.2.0 was naive and just copies all old and new attributes to the new instance, without invoking any custom initialization methods. It was fixed to [call `#initialize`](https://bugs.ruby-lang.org/issues/19259) in 3.2.2:
     ```ruby
     Point = Data.define(:x, :y) do
       def initialize(x:, y:) = super(x: x.to_i, y: y.to_i)
@@ -1127,7 +1118,8 @@ Previously a part of standard library, Set (a collection of unique elements) was
     t.tag #=> 'test'
     t.dup.tag #=> nil
     ```
-  This is a [bug](https://bugs.ruby-lang.org/issues/19362) and will probably <a class="github" href="https://github.com/ruby/ruby/pull/7178">change</a> in Ruby 3.2.2.
+  This is a [bug](https://bugs.ruby-lang.org/issues/19362).
+* **Follow-ups:** [3.3](3.3.html#procdup-and-clone-call-initialize_dup-and-initialize_copy): `#dup` properly invokes `#initialize_dup`.
 
 #### `Proc#parameters`: new keyword argument `lambda: true/false`[](#procparameters-new-keyword-argument-lambda-truefalse)
 
@@ -1162,7 +1154,7 @@ Previously a part of standard library, Set (a collection of unique elements) was
 
 #### `Method#public?`, `#protected?`, and `#private?` are removed[](#methodpublic-protected-and-private-are-removed)
 
-Predicates to check method visibility added in Ruby 3.1 were reverted.
+Predicates to check method visibility [added in Ruby 3.1](3.1.html#methodunboundmethod-public-private-protected) were reverted.
 
 * **Reason:** The new feature implementation have led to several bugs with `Method` class behavior; while investigating the root cause for those bugs, Matz have decided that method's visibility is not its inherent property, but rather a property of the module/object that owns the method, and as such, is already present in form of `Module#{private,public,protected}_instance_methods` and `Object#{private,public,protected}_methods`
 * **Discussion:** <a class="tracker feature" href="https://bugs.ruby-lang.org/issues/11689#note-24#note-24">Feature #11689<small>#note-24</small></a>
@@ -1778,7 +1770,7 @@ A few changes to mention, though:
 * <a class="github" href="https://github.com/ruby/net-http">net-http</a> 0.3.2
 * <a class="github" href="https://github.com/ruby/net-protocol">net-protocol</a> 0.2.1
 * <a class="github" href="https://github.com/ruby/nkf">nkf</a> 0.1.2
-* <a class="github" href="https://github.com/ruby/open">open</a>-uri 0.3.0
+* <a class="github" href="https://github.com/ruby/open-uri">open-uri</a> 0.3.0
 * <a class="github" href="https://github.com/ruby/open3">open3</a> 0.1.2
 * <a class="github" href="https://github.com/ruby/openssl">openssl</a> 3.1.0
 * <a class="github" href="https://github.com/ruby/optparse">optparse</a> 0.3.1
@@ -1812,7 +1804,7 @@ A few changes to mention, though:
 
 #### Bundled gems[](#bundled-gems)
 
-* <a class="github" href="https://github.com/ruby/minitest">minitest</a> 5.16.3
+* <a class="github" href="https://github.com/minitest/minitest">minitest</a> 5.16.3
 * <a class="github" href="https://github.com/ruby/power_assert">power_assert</a> 2.0.3
 * <a class="github" href="https://github.com/ruby/test-unit">test-unit</a> 3.5.7
 * <a class="github" href="https://github.com/ruby/net-ftp">net-ftp</a> 0.2.0
@@ -1825,6 +1817,8 @@ A few changes to mention, though:
 
 ### Standard library content changes[](#standard-library-content-changes)
 
+#### New libraries[](#new-libraries)
+
 * <a class="github" href="https://github.com/ruby/syntax_suggest">syntax_suggest</a> (formerly `dead_end`) gem added. It provides helpful error messages for wrong syntax, trying to guess the place of the error. For example, assuming this `test.rb`:
   ```ruby
   def foo