[GR-62552] Upgrade Ruby from 3.3.5 to 3.3.7

PullRequest: truffleruby/4487

Author: andrykonchin

.ruby-version

@@ -1 +1 @@
-3.3.5
+3.3.7

CHANGELOG.md

@@ -8,6 +8,7 @@ Bug fixes:
 
 Compatibility:
 
+* Updated to Ruby 3.3.7 (@andrykonchin).
 * Implement `StringScanner#{peek_byte,scan_byte,scan_integer,named_captures}` methods (#3788, @andrykonchin).
 * Support String patterns in `StringScanner#{exist?,scan_until,skip_until,check_until,search_full}` methods (@andrykonchin).
 * Implement `ObjectSpace::WeakKeyMap` (#3681, @andrykonchin).

README.md

@@ -119,7 +119,7 @@ See the [contributor workflow](doc/contributor/workflow.md) document if you wish
 We recommend that people trying TruffleRuby on their gems and applications [get in touch with us](#contact) for any help they might need.
 
 TruffleRuby runs Rails and is compatible with many gems, including C extensions.
-TruffleRuby is not 100% compatible with MRI 3.2 yet. Please [report](https://github.com/oracle/truffleruby/issues) any compatibility issues you might find.
+TruffleRuby is not 100% compatible with MRI 3.3 yet. Please [report](https://github.com/oracle/truffleruby/issues) any compatibility issues you might find.
 TruffleRuby [passes around 97% of ruby/spec](https://eregon.me/rubyspec-stats/),
 more than any other alternative Ruby implementation.
 
@@ -193,4 +193,4 @@ For further licensing information, see [LICENCE](LICENCE.md), [3rd_party_license
 
 ## Attribution
 
-TruffleRuby includes infrastructure code from [JRuby](https://github.com/jruby/jruby) (e.g. parser, JCodings, Joni), core library code from the [Rubinius](https://github.com/rubinius/rubinius) project, as well as code from the standard implementation of Ruby, [MRI](https://github.com/ruby/ruby).
+TruffleRuby includes infrastructure code from [JRuby](https://github.com/jruby/jruby) (e.g. JCodings, Joni), core library code from the [Rubinius](https://github.com/rubinius/rubinius) project, as well as code from the standard implementation of Ruby, [MRI](https://github.com/ruby/ruby).

doc/contributor/updating-ruby.md

@@ -27,13 +27,43 @@ To update a specific default gem to a newer version than in the MRI release, run
 ```
 cd ruby
 git checkout -b truffleruby-updates-$VERSION vn_n_n
+cd ..
+git clone git@github.com:ruby/<gem>.git
+cd <gem>
+git checkout v<gem-version>
+cd ../ruby
 ruby tool/sync_default_gems.rb $GEM
 
 git push -u eregon HEAD
 ```
 to update the default gem in MRI.
 Then follow the instructions below to reimport MRI files and to update default gems.
 
+Another way to update a gem to a specific version is to pass a commits range:
+
+```
+ruby tool/sync_default_gems.rb <gem-name> <sha1-of-currently-imported-version>..<sha1-of-a-new-version>
+```
+
+Run `ruby tool/sync_default_gems.rb --help` to get other ways to run the script.
+
+## Updating a specific bundled gem
+
+Set new version of the bundled gem in `gems/bundled_gems` in a Ruby source code directory.
+
+Build Ruby (currently supported version) with the following commands:
+
+```
+./autogen.sh
+mkdir ~/.rubies
+./configure --prefix="${HOME}/.rubies/ruby-$VERSION-updated-gems" --disable-install-doc
+make -j8 install-nodoc
+```
+
+Use `~/.rubies/ruby-$VERSION-updated-gems` directory as a source for copying a new bundled gem version.
+
+Follow instructions how to update default and bundled gems.
+
 ## Setup
 
 Set the environment variable `$VERSION` to the target version:
@@ -166,8 +196,9 @@ Update all of these:
 
 * Update `.ruby-version`, `TruffleRuby.LANGUAGE_VERSION`
 * Reset `truffleruby-abi-version.h` to `$RUBY_VERSION.1` and `lib/cext/ABI_check.txt` to `1` if `RUBY_VERSION` was updated.
+  * use `$RUBY_VERSION.$GRAALVM_VERSION.1` for releases in `truffleruby-abi-version.h`
 * Update `versions.json`
-  * with bundled gem versions provided by `cat ../ruby/gems/bundled_gems | sort`,
+  * with bundled gem versions provided by `cat ../ruby/gems/bundled_gems | sort` (ensure the target Ruby version is checked out in the `../ruby` directory),
   * default gem versions provided by `ls -l lib/gems/specifications/default`
   * and `gem` gem version provided by `grep 'VERSION =' lib/mri/rubygems.rb`
 * Also update version numbers for `debug`, `racc`, and `rbs` in `src/main/c/Makefile`, `mx.truffleruby/suite.py` and `lib/gems/gems/debug-*/ext/debug/extconf.rb`.
@@ -176,9 +207,11 @@ Update all of these:
 * Copy and paste the TruffleRuby `--help` output to `doc/user/options.md` (e.g., with `jt ruby --help | xsel -b`)
 * Update `doc/user/compatibility.md` and `README.md`
 * Update `doc/legal/legal.md`, notably the `Bundled gems` section
-* Update method lists - see `spec/truffle/methods_spec.rb`
+* Update method lists (see `spec/truffle/methods_spec.rb`)
+  * run `jt -u ruby test spec/truffle/methods_spec.rb` to add new methods
+  * run `jt purge spec/truffle/methods_spec.rb` to remove tags for implemented methods
 * Build TruffleRuby (`jt build`).
-* Run `jt test gems default-bundled-gems`
+* Run `jt test gems default-bundled-gems` and commit generated `Gemfile` and `Gemfile.lock` files
 * Get `jt test spec/truffle/rubygems/default_gems_list_spec.rb` to pass
 * Grep for the old Ruby version with `git grep -F x.y.z`
 * Grep for the old Bundler version with `git grep -F x.y.z`

doc/legal/bundled_gems

@@ -9,15 +9,15 @@ minitest        5.20.0  https://github.com/minitest/minitest
 power_assert    2.0.3   https://github.com/ruby/power_assert
 rake            13.1.0  https://github.com/ruby/rake
 test-unit       3.6.1   https://github.com/test-unit/test-unit
-rexml           3.3.6   https://github.com/ruby/rexml
+rexml           3.3.9   https://github.com/ruby/rexml
 rss             0.3.1   https://github.com/ruby/rss
 net-ftp         0.3.4   https://github.com/ruby/net-ftp
-net-imap        0.4.9.1   https://github.com/ruby/net-imap
+net-imap        0.4.19   https://github.com/ruby/net-imap
 net-pop         0.1.2   https://github.com/ruby/net-pop
 net-smtp        0.4.0.1   https://github.com/ruby/net-smtp
 matrix          0.4.2   https://github.com/ruby/matrix
 prime           0.1.2   https://github.com/ruby/prime
 rbs             3.4.0   https://github.com/ruby/rbs
 typeprof        0.21.9  https://github.com/ruby/typeprof
-debug           1.9.1   https://github.com/ruby/debug
+debug           1.9.2   https://github.com/ruby/debug
 racc            1.7.3   https://github.com/ruby/racc

doc/legal/legal.md

@@ -18,7 +18,7 @@ See `epl-2.0.txt`, `gpl-2.txt`, `lgpl-2.1.txt`.
 ## MRI
 
 The standard implementation of Ruby is MRI. TruffleRuby contains code from MRI
-version 3.3.5, including:
+version 3.3.7, including:
 
 * the standard library in `lib/mri`, 
 * Ruby C extension API in `lib/cext/include` and `src/main/c/cext`, 

doc/user/compatibility.md

@@ -7,7 +7,7 @@ permalink: /reference-manual/ruby/Compatibility/
 # Compatibility
 
 TruffleRuby aims to be fully compatible with the standard implementation of
-Ruby, MRI, version 3.3.5, [including C extensions](#c-extension-compatibility).
+Ruby, MRI, version 3.3.7, [including C extensions](#c-extension-compatibility).
 TruffleRuby is still in development, so it is not 100% compatible yet.
 
 TruffleRuby can run Rails and is compatible with many gems, including C extensions.

lib/cext/ABI_check.txt

@@ -1 +1 @@
-9
+1

lib/cext/include/truffleruby/truffleruby-abi-version.h

@@ -20,6 +20,6 @@
 // $RUBY_VERSION must be the same as TruffleRuby.LANGUAGE_VERSION.
 // $ABI_NUMBER starts at 1 and is incremented for every ABI-incompatible change.
 
-#define TRUFFLERUBY_ABI_VERSION "3.3.5.11"
+#define TRUFFLERUBY_ABI_VERSION "3.3.7.1"
 
 #endif