Advent of Changelog: Day 17

Author: zverok

_data/book.yml

@@ -177,6 +177,27 @@ chapters:
         path: "/3.3.html#processstatus--and--are-deprecated"
       - title: "<code>TracePoint</code> supports <code>:rescue</code> event"
         path: "/3.3.html#tracepoint-supports-rescue-event"
+  - title: Standard library
+    path: "/3.3.html#standard-library"
+    children:
+    - title: Version updates
+      path: "/3.3.html#version-updates"
+      children:
+      - title: Default gems
+        path: "/3.3.html#default-gems"
+      - title: Bundled gems
+        path: "/3.3.html#bundled-gems"
+    - title: Standard library content changes
+      path: "/3.3.html#standard-library-content-changes"
+      children:
+      - title: Additions
+        path: "/3.3.html#additions"
+      - title: Removals
+        path: "/3.3.html#removals"
+      - title: Default gems that became bundled
+        path: "/3.3.html#default-gems-that-became-bundled"
+      - title: Gems that are warned to become bundled in the next version
+        path: "/3.3.html#gems-that-are-warned-to-become-bundled-in-the-next-version"
 - title: Ruby 3.2
   path: "/3.2.html"
   is_version: true

_src/3.3.md

@@ -621,8 +621,6 @@ Allows to trace when some exception was `rescue`'d in the code of interest.
 * **Notes:** The event-specific attribute for the event is the same as for `:raise`: [#raised_exception](https://docs.ruby-lang.org/en/master/TracePoint.html#method-i-raised_exception).
 
 
-## Standard library
-
 ## Standard library
 
 Since Ruby 3.1 release, most of the standard library is extracted to either _default_ or _bundled_ gems; their development happens in separate repositories, and changelogs are either maintained there, or absent altogether. Either way, their changes aren't mentioned in the combined Ruby changelog, and I'll not be trying to follow all of them.
@@ -633,6 +631,33 @@ Since Ruby 3.1 release, most of the standard library is extracted to either _def
 
 A few changes to mention, though:
 
+* [BasicSocket#recv](https://docs.ruby-lang.org/en/master/BasicSocket.html#method-i-recv) and [BasicSocket#recv_nonblock](https://docs.ruby-lang.org/en/master/BasicSocket.html#method-i-recv_nonblock) returns `nil` instead of an empty string on closed connections. [BaicSocket#recvmsg](https://docs.ruby-lang.org/en/master/BasicSocket.html#method-i-recvmsg) and BasicSocket#recvmsg_nonblock returns `nil` instead of an empty packet on closed connections. Discussion: [Bug #19012]
+* Name resolution such as [Socket.getaddrinfo](https://docs.ruby-lang.org/en/master/Socket.html#method-c-getaddrinfo), [Socket.getnameinfo](https://docs.ruby-lang.org/en/master/Socket.html#method-c-getnameinfo), [Addrinfo.getaddrinfo](https://docs.ruby-lang.org/en/master/Addrinfo.html#method-c-getaddrinfo) can now be interrupted. Discussion: [Feature #19965]
+* [Random::Formatter#alphanumeric](https://docs.ruby-lang.org/en/master/Random/Formatter.html#method-i-alphanumeric): `chars` keyword argument. [Feature #18183]:
+  ```ruby
+  require 'random/formatter'
+  # The default behavior: uses English alphabet + numbers
+  Random.alphanumeric
+  #=> "fhCshEkcGfCTO6Ny"
+
+  # With the argument provided:
+  Random.alphanumeric(chars: ['a', 'b', 'c'])
+  #=> "cbacacbababccccc"
+
+  # Note that the argument should be an array.
+  # So if you have a string of characters, you can do:
+  Random.alphanumeric(chars: 'abc'.chars)
+  #=> "abbaccaacbacbccc"
+
+  # Any object is acceptable as an array element, the method
+  # would just use their `#to_s`; arrays would be flattened:
+  Random.alphanumeric(chars: [1, true, [2], Object.new])
+  #=> "111true11211true2true#<Object:0x00007fe804e79f48>221"
+
+  # An empty array just hangs forever:
+  Random.alphanumeric(chars: []) # never returns
+  ```
+
 ### Version updates
 
 #### Default gems
@@ -716,17 +741,38 @@ A few changes to mention, though:
 
 ### Standard library content changes
 
-* `ext/readline` is retired
+#### Additions
+
+* [prism](https://github.com/ruby/prism) (nee YARP) is added. It is a new Ruby code parser, developed by Kevin Newton, which intends to become _the_ Ruby parser, shared by all implementations (not only CRuby/MRI, but also TruffleRuby, JRuby, and others) and tools that need to parser Ruby code (like Sorbet or Rubocop). It doesn't replace CRuby's Ruby parser at least for now, but can be used to parse Ruby quickly and produce robust, easy to use AST.
+
+#### Removals
+
+* `readline` extension is removed. It was a standard library written in C to wrap [GNU Readline](https://tiswww.case.edu/php/chet/readline/rltop.html), used to implement interactive consoles like IRB. Ruby includes pure-Ruby replacement called [reline](https://github.com/ruby/reline) [since 2.7](2.7.html#new-libraries), and now `require 'readline'` will just require it and make an alias `Readline = Reline`. Though, if the [readline-ext](https://github.com/ruby/readline-ext) gem is installed explicitly, `require 'readline'` would require it. Discussion: [Feature #19616].
+  ```ruby
+  require 'readline'
 
-The following default gem is added.
+  Readline
+  # Ruby 3.2:
+  #   => Readline -- a separate library/constant
+  # Ruby 3.3:
+  #   => Reline -- Readline is just an alias
 
-* prism 0.19.0
+  Readline.method(:readline)
+  # Ruby 3.2:
+  #   => #<Method: Readline.readline(*)>  -- a C-defined method with no location/signature extracted
+  # Ruby 3.3:
+  #   => #<Method: Reline.readline(*args, &block) <...>/lib/ruby/3.3.0+0/forwardable.rb:231>
+  ```
 
 #### Default gems that became bundled
 
+_This means that if your dependencies are managed by Bundler and your code depend on `racc`, it should be added to a `Gemfile`._
+
 * racc 1.7.3
 
-### Gems that are warned to become bundled in the next version
+#### Gems that are warned to become bundled in the next version
+
+These gems wouldn't in a Bundler-managed environment unless explicitly added to `Gemfile` since the next version of Ruby. For now, requiring them in such environment would produce a warning. Discussion: [Feature #19351] (initial proposal to promote many gems, which then was deemed problematic), [Feature #19776] (the warning proposal)
 
 * abbrev
 * base64