NEWS für Ruby 3.2.0

Dieses Dokument listet benutzerseitig sichtbare Feature-Änderungen seit der 3.1.0 Version auf, ausgenommen Fehlerbehebungen.

Beachten Sie, dass jeder Eintrag auf ein Minimum beschränkt ist, siehe Links für Details.

Sprachänderungen

• Anonyme Rest- und Keyword-Rest-Argumente können nun als Argumente übergeben werden, anstatt nur in Methodenparametern verwendet zu werden. [Feature #18351]

  def foo(*)
    bar(*)
  end
  def baz(**)
    quux(**)
  end
  

• Ein Proc, der ein einzelnes positionsgebundenes Argument und Keywords akzeptiert, wird nicht mehr automatisch erweitert (autosplat). [Bug #18633]

  proc{|a, **k| a}.call([1, 2])
  # Ruby 3.1 and before
  # => 1
  # Ruby 3.2 and after
  # => [1, 2]
  

• Die Auswertungsreihenfolge für konstante Zuweisungen zu expliziten Objekten wurde mit der Auswertungsreihenfolge für einzelne Attributzuweisungen konsistent gemacht. Mit diesem Code

  foo::BAR = baz
  

  foo wird nun vor baz aufgerufen. Ebenso wird für Mehrfachzuweisungen an Konstanten eine links-nach-rechts-Auswertungsreihenfolge verwendet. Mit diesem Code

  foo1::BAR1, foo2::BAR2 = baz1, baz2
  

  wird nun die folgende Auswertungsreihenfolge verwendet

  1. foo1

  2. foo2

  3. baz1

  4. baz2

  [Bug #15928]

• "Find pattern" ist nicht mehr experimentell. [Feature #18585]

• Methoden, die einen Restparameter (wie *args) annehmen und Keyword-Argumente über foo(*args) weiterleiten möchten, müssen nun mit ruby2_keywords markiert werden (sofern nicht bereits geschehen). Mit anderen Worten, alle Methoden, die Keyword-Argumente über *args weiterleiten möchten, müssen nun mit ruby2_keywords markiert werden, ohne Ausnahme. Dies erleichtert den Übergang zu anderen Weiterleitungsmethoden, sobald eine Bibliothek Ruby 3+ erfordern kann. Zuvor wurde das Flag ruby2_keywords beibehalten, wenn die empfangende Methode *args annahm, aber das war ein Fehler und eine Inkonsistenz. Eine gute Technik, um potenziell fehlende ruby2_keywords zu finden, ist die Ausführung der Testsuite, um dort bei Fehlern die letzte Methode zu finden, die Keyword-Argumente empfangen muss, und dort puts nil, caller, nil zu verwenden und jede Methode/jeden Block in der Aufrufkette, der Keywords weiterleiten muss, korrekt als ruby2_keywords markiert zu prüfen. [Bug #18625] [Bug #16466]

  def target(**kw)
  end
  
  # Accidentally worked without ruby2_keywords in Ruby 2.7-3.1, ruby2_keywords
  # needed in 3.2+. Just like (*args, **kwargs) or (...) would be needed on
  # both #foo and #bar when migrating away from ruby2_keywords.
  ruby2_keywords def bar(*args)
    target(*args)
  end
  
  ruby2_keywords def foo(*args)
    bar(*args)
  end
  
  foo(k: 1)
  

Aktualisierungen von Kernklassen

Hinweis: Wir listen nur wichtige Klassenaktualisierungen auf.

• Fiber

  • Einführung von Fiber.[] und Fiber.[]= für erbliche Faser-Speicher. Einführung von Fiber#storage und Fiber#storage= (experimentell) zum Abrufen und Zurücksetzen des aktuellen Speichers. Einführung von Fiber.new(storage:) zum Festlegen des Speichers bei der Erstellung einer Faser. [Feature #19078]

    Vorhandene Thread- und Faser-lokale Variablen können schwierig zu verwenden sein. Thread-lokale Variablen werden zwischen allen Fasern geteilt, was die Isolierung erschwert, während Faser-lokale Variablen schwer zu teilen sein können. Es ist oft wünschenswert, eine Ausführungseinheit ("Ausführungskontext") zu definieren, so dass ein Teil des Zustands zwischen allen in diesem Kontext erstellten Fasern und Threads geteilt wird. Dies bietet der Fiber-Speicher.

    def log(message)
      puts "#{Fiber[:request_id]}: #{message}"
    end
    
    def handle_requests
      while request = read_request
        Fiber.schedule do
          Fiber[:request_id] = SecureRandom.uuid
    
          request.messages.each do |message|
            Fiber.schedule do
              log("Handling #{message}") # Log includes inherited request_id.
            end
          end
        end
      end
    end
    

    Sie sollten generell den Fiber-Speicher für jeden Zustand in Betracht ziehen, der implizit zwischen allen Fasern und Threads, die in einem bestimmten Kontext erstellt werden, geteilt werden soll, z.B. ein Connection-Pool, eine Request-ID, ein Logger-Level, Umgebungsvariablen, Konfiguration usw.

• Fiber::Scheduler

  • Einführung von Fiber::Scheduler#io_select für nicht-blockierendes IO.select. [Feature #19060]

• IO

  • Einführung von IO#timeout= und IO#timeout, die IO::TimeoutError auslösen können, wenn eine blockierende Operation das angegebene Timeout überschreitet. [Feature #18630]

    STDIN.timeout = 1
    STDIN.read # => Blocking operation timed out! (IO::TimeoutError)
    

  • Einführung von IO.new(..., path:) und Promotion von File#path zu IO#path. [Feature #19036]

• Class

  • Class#attached_object, die das Objekt zurückgibt, für das der Empfänger die Singleton-Klasse ist. Löst TypeError aus, wenn der Empfänger keine Singleton-Klasse ist. [Feature #12084]

    class Foo; end
    
    Foo.singleton_class.attached_object        #=> Foo
    Foo.new.singleton_class.attached_object    #=> #<Foo:0x000000010491a370>
    Foo.attached_object                        #=> TypeError: `Foo' is not a singleton class
    nil.singleton_class.attached_object        #=> TypeError: `NilClass' is not a singleton class
    

• Data

  • Neue Kernklasse zur Darstellung von einfachen unveränderlichen Wertobjekten. Die Klasse ist ähnlich wie Struct und teilt teilweise eine Implementierung, hat aber eine schlankere und strengere API. [Feature #16122]

    Measure = Data.define(:amount, :unit)
    distance = Measure.new(100, 'km')            #=> #<data Measure amount=100, unit="km">
    weight = Measure.new(amount: 50, unit: 'kg') #=> #<data Measure amount=50, unit="kg">
    weight.with(amount: 40)                      #=> #<data Measure amount=40, unit="kg">
    weight.amount                                #=> 50
    weight.amount = 40                           #=> NoMethodError: undefined method `amount='
    

• Encoding

  • Encoding#replicate wurde als veraltet markiert und wird in 3.3 entfernt. [Feature #18949]

  • Die Dummy-Encodings Encoding::UTF_16 und Encoding::UTF_32 versuchen nicht mehr, das Endianness dynamisch anhand eines Byte Order Mark zu erraten. Verwenden Sie stattdessen Encoding::UTF_16BE/UTF_16LE und Encoding::UTF_32BE/UTF_32LE. Diese Änderung beschleunigt das Abrufen der Kodierung eines String. [Feature #18949]

  • Maximale Größe des Kodierungssets auf 256 begrenzt. Bei Überschreitung der Maximalgröße wird EncodingError ausgelöst. [Feature #18949]

• Enumerator

  • Enumerator.product wurde hinzugefügt. Enumerator::Product ist die Implementierung. [Feature #18685]

• Exception

  • Exception#detailed_message wurde hinzugefügt. Der Standard-Fehlerdrucker ruft diese Methode für das Exception-Objekt anstelle der Nachricht auf. [Feature #18564]

• Hash

  • Hash#shift gibt nun immer nil zurück, wenn der Hash leer ist, anstatt den Standardwert zurückzugeben oder die Standard-Proc aufzurufen. [Bug #16908]

• Integer

  • Integer#ceildiv wurde hinzugefügt. [Feature #18809]

• Kernel

  • Kernel#binding löst RuntimeError aus, wenn es von einem nicht-Ruby-Frame (wie einer in C definierten Methode) aufgerufen wird. [Bug #18487]

• MatchData

  • MatchData#byteoffset wurde hinzugefügt. [Feature #13110]

  • MatchData#deconstruct wurde hinzugefügt. [Feature #18821]

  • MatchData#deconstruct_keys wurde hinzugefügt. [Feature #18821]

• Module

  • Module.used_refinements wurde hinzugefügt. [Feature #14332]

  • Module#refinements wurde hinzugefügt. [Feature #12737]

  • Module#const_added wurde hinzugefügt. [Feature #17881]

  • Module#undefined_instance_methods wurde hinzugefügt. [Feature #12655]

• Proc

  • Proc#dup gibt eine Instanz einer Unterklasse zurück. [Bug #17545]

  • Proc#parameters akzeptiert nun das Lambda-Keyword. [Feature #15357]

• Process

  • Konstante RLIMIT_NPTS für die FreeBSD-Plattform hinzugefügt

• Regexp

  • Die Cache-basierte Optimierung wurde eingeführt. Viele (aber nicht alle) Regexp-Übereinstimmungen erfolgen nun in linearer Zeit, was eine Regular-Expression-Denial-of-Service (ReDoS)-Schwachstelle verhindert. [Feature #19104]

  • Regexp.linear_time? wurde eingeführt. [Feature #19194]

  • Regexp.new unterstützt nun das Übergeben der Regex-Flags nicht nur als Integer, sondern auch als String. Unbekannte Flags lösen ArgumentError aus. Andernfalls wird bei allem, was kein true, false, nil oder Integer ist, eine Warnung ausgegeben. [Feature #18788]

  • Regexp.timeout= wurde hinzugefügt. Außerdem unterstützt Regexp.new nun das Timeout-Keyword. Siehe [Feature #17837]

• Refinement

  • Refinement#refined_class wurde hinzugefügt. [Feature #12737]

• RubyVM::AbstractSyntaxTree

  • error_tolerant-Option für parse, parse_file und of hinzugefügt. [Feature #19013] Mit dieser Option

    1. SyntaxError wird unterdrückt

    2. Der AST wird für ungültige Eingaben zurückgegeben

    3. end wird ergänzt, wenn ein Parser das Ende der Eingabe erreicht, aber end nicht ausreicht

    4. end wird basierend auf der Einrückung als Keyword behandelt

    # Without error_tolerant option
    root = RubyVM::AbstractSyntaxTree.parse(<<~RUBY)
    def m
      a = 10
      if
    end
    RUBY
    # => <internal:ast>:33:in `parse': syntax error, unexpected `end' (SyntaxError)
    
    # With error_tolerant option
    root = RubyVM::AbstractSyntaxTree.parse(<<~RUBY, error_tolerant: true)
    def m
      a = 10
      if
    end
    RUBY
    p root # => #<RubyVM::AbstractSyntaxTree::Node:SCOPE@1:0-4:3>
    
    # `end` is treated as keyword based on indent
    root = RubyVM::AbstractSyntaxTree.parse(<<~RUBY, error_tolerant: true)
    module Z
      class Foo
        foo.
      end
    
      def bar
      end
    end
    RUBY
    p root.children[-1].children[-1].children[-1].children[-2..-1]
    # => [#<RubyVM::AbstractSyntaxTree::Node:CLASS@2:2-4:5>, #<RubyVM::AbstractSyntaxTree::Node:DEFN@6:2-7:5>]
    

  • keep_tokens-Option für parse, parse_file und of hinzugefügt. tokens und all_tokens für RubyVM::AbstractSyntaxTree::Node hinzugefügt. [Feature #19070]

    root = RubyVM::AbstractSyntaxTree.parse("x = 1 + 2", keep_tokens: true)
    root.tokens # => [[0, :tIDENTIFIER, "x", [1, 0, 1, 1]], [1, :tSP, " ", [1, 1, 1, 2]], ...]
    root.tokens.map{_1[2]}.join # => "x = 1 + 2"
    

• Set

  • Set ist nun als integrierte Klasse verfügbar, ohne dass require "set" erforderlich ist. [Feature #16989] Sie wird derzeit über die Set-Konstante oder einen Aufruf von Enumerable#to_set verzögert geladen.

• String

  • String#byteindex und String#byterindex wurden hinzugefügt. [Feature #13110]

  • Unicode auf Version 15.0.0 und Emoji auf Version 15.0 aktualisiert. [Feature #18639] (gilt auch für Regexp)

  • String#bytesplice wurde hinzugefügt. [Feature #18598]

  • String#dedup wurde als Alias für String#-@ hinzugefügt. [Feature #18595]

• Struct

  • Eine Struct-Klasse kann auch mit Keyword-Argumenten initialisiert werden, ohne keyword_init: true bei Struct.new [Feature #16806]

    Post = Struct.new(:id, :name)
    Post.new(1, "hello") #=> #<struct Post id=1, name="hello">
    # From Ruby 3.2, the following code also works without keyword_init: true.
    Post.new(id: 1, name: "hello") #=> #<struct Post id=1, name="hello">
    

• Thread

  • Thread.each_caller_location wurde hinzugefügt. [Feature #16663]

• Thread::Queue

  • Thread::Queue#pop(timeout: sec) wurde hinzugefügt. [Feature #18774]

• Thread::SizedQueue

  • Thread::SizedQueue#pop(timeout: sec) wurde hinzugefügt. [Feature #18774]

  • Thread::SizedQueue#push(timeout: sec) wurde hinzugefügt. [Feature #18944]

• Time

  • Time#deconstruct_keys wurde hinzugefügt, was die Verwendung von Time-Instanzen in Mustervergleichsausdrücken ermöglicht [Feature #19071]

  • Time.new kann nun einen String parsen, wie er von Time#inspect generiert wird, und eine Time-Instanz basierend auf dem übergebenen Argument zurückgeben. [Feature #18033]

• SyntaxError

  • SyntaxError#path wurde hinzugefügt. [Feature #19138]

• TracePoint

  • TracePoint#binding gibt nun nil für c_call/c_return TracePoints zurück. [Bug #18487]

  • Das Keyword-Argument target_thread von TracePoint#enable hat nun standardmäßig den aktuellen Thread, wenn ein Block übergeben wird und die Keyword-Argumente target und target_line nicht übergeben werden. [Bug #16889]

• UnboundMethod

  • UnboundMethod#== gibt true zurück, wenn die tatsächliche Methode dieselbe ist. Zum Beispiel gibt String.instance_method(:object_id) == Array.instance_method(:object_id) true zurück. [Feature #18798]

  • UnboundMethod#inspect zeigt nicht den Empfänger von instance_method an. Zum Beispiel gibt String.instance_method(:object_id).inspect "#<UnboundMethod: Kernel#object_id()>" zurück (war "#<UnboundMethod: String(Kernel)#object_id()>").

• GC

  • need_major_gc wird über GC.latest_gc_info verfügbar gemacht. GH-6791

• ObjectSpace

  • ObjectSpace.dump_all gibt auch Shapes aus. GH-6868

Aktualisierungen der Standardbibliothek

• Bundler

  • Bundler verwendet nun den PubGrub-Resolver anstelle von Molinillo zur Leistungsverbesserung.

  • Unterstützung für --ext=rust wurde zu bundle gem hinzugefügt, um einfache Gems mit Rust-Erweiterungen zu erstellen. [GH-rubygems-6149]

  • Das Klonen von Git-Repos wurde beschleunigt [GH-rubygems-4475]

• RubyGems

  • MSWIN-Unterstützung für den Cargo-Builder hinzugefügt. [GH-rubygems-6167]

• CGI

  • CGI.escapeURIComponent und CGI.unescapeURIComponent wurden hinzugefügt. [Feature #18822]

• Coverage

  • Coverage.setup akzeptiert nun eval: true. Dadurch können eval und verwandte Methoden Code Coverage generieren. [Feature #19008]

  • Coverage.supported?(mode) ermöglicht die Erkennung, welche Coverage-Modi unterstützt werden. [Feature #19026]

• Date

  • Date#deconstruct_keys und DateTime#deconstruct_keys wurden hinzugefügt, ähnlich wie bei [Feature #19071]

• ERB

  • ERB::Util.html_escape ist schneller als CGI.escapeHTML.

    • Es wird kein String-Objekt mehr zugewiesen, wenn kein Zeichen maskiert werden muss.

    • Die to_s-Methode wird nicht mehr aufgerufen, wenn ein Argument bereits ein String ist.

    • ERB::Escape.html_escape wurde als Alias für ERB::Util.html_escape hinzugefügt, welches nicht von Rails monkey-patched wurde.

  • ERB::Util.url_encode ist schneller durch die Verwendung von CGI.escapeURIComponent.

  • Die Option -S wurde aus dem erb-Befehl entfernt.

• FileUtils

  • FileUtils.ln_sr-Methode und die Option relative: zu FileUtils.ln_s hinzugefügt. [Feature #18925]

• IRB

  • Integration-Befehle für debug.gem wurden hinzugefügt: debug, break, catch, next, delete, step, continue, finish, backtrace, info

    • Diese funktionieren auch, wenn Sie gem "debug" nicht in Ihrer Gemfile haben.

    • Siehe auch: Was ist neu in Rubys IRB 3.2?

  • Weitere pry-ähnliche Befehle und Features wurden hinzugefügt.

    • edit und show_cmds (ähnlich wie Pry's help) wurden hinzugefügt.

    • ls nimmt die Option -g oder -G zur Filterung der Ausgaben.

    • show_source ist ein Alias von $ und akzeptiert unquote Eingaben.

    • whereami ist ein Alias von @.

• Net::Protocol

  • Leistungsverbesserung von Net::BufferedIO. [GH-net-protocol-14]

• Pathname

  • Pathname#lutime wurde hinzugefügt. [GH-pathname-20]

• Socket

  • Folgende Konstanten für unterstützte Plattformen wurden hinzugefügt.

    • SO_INCOMING_CPU

    • SO_INCOMING_NAPI_ID

    • SO_RTABLE

    • SO_SETFIB

    • SO_USER_COOKIE

    • TCP_KEEPALIVE

    • TCP_CONNECTION_INFO

• SyntaxSuggest

  • Das Feature von syntax_suggest, früher dead_end, wurde in Ruby integriert. [Feature #18159]

• UNIXSocket

  • Unterstützung für UNIXSocket unter Windows hinzugefügt. Anonyme Sockets emuliert. Unterstützung für File.socket? und File::Stat#socket?, wo möglich, hinzugefügt. [Feature #19135]

• Die folgenden Standard-Gems wurden aktualisiert.

  • RubyGems 3.4.1

  • abbrev 0.1.1

  • benchmark 0.2.1

  • bigdecimal 3.1.3

  • bundler 2.4.1

  • cgi 0.3.6

  • csv 3.2.6

  • date 3.3.3

  • delegate 0.3.0

  • did_you_mean 1.6.3

  • digest 3.1.1

  • drb 2.1.1

  • english 0.7.2

  • erb 4.0.2

  • error_highlight 0.5.1

  • etc 1.4.2

  • fcntl 1.0.2

  • fiddle 1.1.1

  • fileutils 1.7.0

  • forwardable 1.3.3

  • getoptlong 0.2.0

  • io-console 0.6.0

  • io-nonblock 0.2.0

  • io-wait 0.3.0

  • ipaddr 1.2.5

  • irb 1.6.2

  • json 2.6.3

  • logger 1.5.3

  • mutex_m 0.1.2

  • net-http 0.3.2

  • net-protocol 0.2.1

  • nkf 0.1.2

  • open-uri 0.3.0

  • open3 0.1.2

  • openssl 3.1.0

  • optparse 0.3.1

  • ostruct 0.5.5

  • pathname 0.2.1

  • pp 0.4.0

  • pstore 0.1.2

  • psych 5.0.1

  • racc 1.6.2

  • rdoc 6.5.0

  • readline-ext 0.1.5

  • reline 0.3.2

  • resolv 0.2.2

  • resolv-replace 0.1.1

  • securerandom 0.2.2

  • set 1.0.3

  • stringio 3.0.4

  • strscan 3.0.5

  • syntax_suggest 1.0.2

  • syslog 0.1.1

  • tempfile 0.1.3

  • time 0.2.1

  • timeout 0.3.1

  • tmpdir 0.1.3

  • tsort 0.1.1

  • un 0.2.1

  • uri 0.12.0

  • weakref 0.1.2

  • win32ole 1.8.9

  • yaml 0.2.1

  • zlib 3.0.0

• Die folgenden gebündelten Gems wurden aktualisiert.

  • minitest 5.16.3

  • power_assert 2.0.3

  • test-unit 3.5.7

  • net-ftp 0.2.0

  • net-imap 0.3.4

  • net-pop 0.1.2

  • net-smtp 0.3.3

  • rbs 2.8.2

  • typeprof 0.21.3

  • debug 1.7.1

Siehe GitHub Releases wie GitHub Releases von Logger oder Changelogs für Details zu den Standard-Gems oder gebündelten Gems.

Unterstützte Plattformen

• WebAssembly/WASI wurde hinzugefügt. Mehr Details finden Sie unter wasm/README.md und ruby.wasm. [Feature #18462]

Kompatibilitätsprobleme

• String#to_c behandelt eine Folge von Unterstrichen derzeit als Ende eines Complex-Strings. [Bug #19087]

• Nun löst ENV.clone ebenso wie ENV.dup eine TypeError aus. [Bug #17767]

Entfernte Konstanten

Die folgenden als veraltet markierten Konstanten wurden entfernt.

• Fixnum und Bignum [Feature #12005]

• Random::DEFAULT [Feature #17351]

• Struct::Group

• Struct::Passwd

Entfernte Methoden

Die folgenden als veraltet markierten Methoden wurden entfernt.

• Dir.exists? [Feature #17391]

• File.exists? [Feature #17391]

• Kernel#=~ [Feature #15231]

• Kernel#taint, Kernel#untaint, Kernel#tainted? [Feature #16131]

• Kernel#trust, Kernel#untrust, Kernel#untrusted? [Feature #16131]

• Method#public?, Method#private?, Method#protected?, UnboundMethod#public?, UnboundMethod#private?, UnboundMethod#protected? [Bug #18729] [Bug #18751] [Bug #18435]

Inkompatibilität des Quellcodes von Erweiterungsbibliotheken

• Erweiterungsbibliotheken, die PRNGs bereitstellen, Unterklassen von Random, benötigen Updates. Weitere Informationen finden Sie unter [PRNG-Update] unten. [Bug #19100]

Fehlerdrucker

• Ruby maskiert keine Steuerzeichen und Backslashes mehr in Fehlermeldungen. [Feature #18367]

Konstanten-Lookup bei der Definition einer Klasse/Moduls

• Bei der direkten Definition einer Klasse/eines Moduls unter der Object-Klasse durch eine Klassen-/Modulanweisung wurde, wenn bereits eine Klasse/ein Modul durch Module#include mit demselben Namen definiert war, die Anweisung in Ruby 3.1 oder früher als "offene Klasse" behandelt. Seit Ruby 3.2 wird stattdessen eine neue Klasse definiert. [Feature #18832]

Kompatibilitätsprobleme der Standardbibliothek

• Psych bündelt keine libyaml-Quellen mehr. Außerdem bündelt Fiddle keine libffi-Quellen mehr. Benutzer müssen die libyaml/libffi-Bibliothek selbst über den Paketmanager wie apt, yum, brew usw. installieren.

  Psych und fiddle unterstützten den statischen Build mit bestimmten Versionen von libyaml- und libffi-Quellen. Sie können psych mit libyaml-0.2.5 wie folgt erstellen.

  $ ./configure --with-libyaml-source-dir=/path/to/libyaml-0.2.5

  Und Sie können fiddle mit libffi-3.4.4 wie folgt erstellen.

  $ ./configure --with-libffi-source-dir=/path/to/libffi-3.4.4

  [Feature #18571]

• Überprüfung von Cookie-Namen/-Pfaden/-Domänenzeichen in CGI::Cookie. [CVE-2021-33621]

• URI.parse gibt im Host einen leeren String statt nil zurück. [sec-156615]

Updates der C-API

Aktualisierte C-APIs

Die folgenden APIs wurden aktualisiert.

• PRNG-Update

  rb_random_interface_t in ruby/random.h wurde aktualisiert und versioniert. Erweiterungsbibliotheken, die diese Schnittstelle verwenden und für ältere Versionen erstellt wurden, müssen mit der Hinzufügung der Funktion init_int32 neu kompiliert werden.

Hinzugefügte C-APIs

• VALUE rb_hash_new_capa(long capa) wurde hinzugefügt, um Hashes mit der gewünschten Kapazität zu erstellen.

• rb_internal_thread_add_event_hook und rb_internal_thread_add_event_hook wurden zur Instrumentierung der Thread-Planung hinzugefügt. Folgende Ereignisse sind verfügbar:

  • RUBY_INTERNAL_THREAD_EVENT_STARTED

  • RUBY_INTERNAL_THREAD_EVENT_READY

  • RUBY_INTERNAL_THREAD_EVENT_RESUMED

  • RUBY_INTERNAL_THREAD_EVENT_SUSPENDED

  • RUBY_INTERNAL_THREAD_EVENT_EXITED

• rb_debug_inspector_current_depth und rb_debug_inspector_frame_depth wurden für Debugger hinzugefügt.

Entfernte C-APIs

Die folgenden als veraltet markierten APIs wurden entfernt.

• rb_cData-Variable.

• Funktionen für "taintedness" und "trustedness". [Feature #16131]

Implementierungsverbesserungen

• Mehrere Race Conditions in Kernel#autoload behoben. [Bug #18782]

• Die Cache-Invalidierung für Ausdrücke, die auf Konstanten verweisen, ist nun feingranularer. RubyVM.stat(:global_constant_state) wurde entfernt, da es eng mit dem vorherigen Caching-Schema verbunden war, bei dem das Setzen einer beliebigen Konstante alle Caches im System invalidiert. Neue Schlüssel, :constant_cache_invalidations und :constant_cache_misses, wurden eingeführt, um Anwendungsfälle für :global_constant_state zu unterstützen. [Feature #18589]

• Die Cache-basierte Optimierung für Regexp-Matching wurde eingeführt. [Feature #19104]

• Variable Width Allocation ist nun standardmäßig aktiviert. [Feature #18239]

• Ein neuer Mechanismus für die Instanzvariablen-Zwischenspeicherung, genannt "Object Shapes", wurde hinzugefügt, der die Trefferquote von Inline-Caches für die meisten Objekte verbessert und die Generierung sehr effizienten JIT-Codes ermöglicht. Objekte, deren Instanzvariablen in konsistenter Reihenfolge definiert sind, werden die größten Leistungsvorteile erzielen. [Feature #18776]

• Beschleunigung der Markierung von Instruktionssequenzen durch die Verwendung einer Bitmap, um "markierbare" Objekte zu finden. Diese Änderung führt zu schnelleren Haupt-Garbage-Collection-Zyklen. [Feature #18875]

JIT

YJIT

• YJIT ist nicht mehr experimentell

  • Wurde über ein Jahr lang auf Produktions-Workloads getestet und hat sich als sehr stabil erwiesen.

• YJIT unterstützt nun sowohl x86-64- als auch arm64/aarch64-CPUs unter Linux, MacOS, BSD und anderen UNIX-Plattformen.

  • Diese Version bringt Unterstützung für Mac M1/M2, AWS Graviton und Raspberry Pi 4.

• Das Erstellen von YJIT erfordert nun Rust 1.58.0+. [Feature #18481]

  • Um sicherzustellen, dass CRuby mit YJIT erstellt wird, installieren Sie bitte rustc >= 1.58.0, bevor Sie ./configure ausführen.

  • Bitte wenden Sie sich an das YJIT-Team, falls Sie auf Probleme stoßen.

• Physischer Speicher für JIT-Code wird verzögert zugewiesen. Im Gegensatz zu Ruby 3.1 wird der RSS-Speicherbedarf eines Ruby-Prozesses minimiert, da virtuelle Speicherseiten, die von --yjit-exec-mem-size zugewiesen werden, erst dann physischen Speicherseiten zugeordnet werden, wenn sie tatsächlich von JIT-Code genutzt werden.

• Einführung von Code GC, der alle Codeseiten freigibt, wenn der Speicherverbrauch durch JIT-Code --yjit-exec-mem-size erreicht.

  • RubyVM::YJIT.runtime_stats gibt neben den vorhandenen Schlüsseln inline_code_size und outlined_code_size auch Metriken für den Code GC zurück: code_gc_count, live_page_count, freed_page_count und freed_code_size.

• Die meisten Statistiken, die von RubyVM::YJIT.runtime_stats erzeugt werden, sind nun in Release-Builds verfügbar.

  • Führen Sie einfach Ruby mit --yjit-stats aus, um Statistiken zu berechnen und auszugeben (verursacht etwas Laufzeit-Overhead).

• YJIT ist nun für die Nutzung von Objektformen optimiert. [Feature #18776]

• Nutzt feingranularere Konstanteninvalidierung, um weniger Code bei der Definition neuer Konstanten zu invalidieren. [Feature #18589]

• Der Standardwert für --yjit-exec-mem-size wurde auf 64 (MiB) geändert.

• Der Standardwert für --yjit-call-threshold wurde auf 30 geändert.

MJIT

• Der MJIT-Compiler wurde in Ruby als ruby_vm/mjit/compiler neu implementiert.

• Der MJIT-Compiler wird in einem geforkten Ruby-Prozess ausgeführt, anstatt in einem nativen Thread namens MJIT-Worker. [Feature #18968]

  • Als Ergebnis wird Microsoft Visual Studio (MSWIN) nicht mehr unterstützt.

• MinGW wird nicht mehr unterstützt. [Feature #18824]

• Umbenennung von --mjit-min-calls zu --mjit-call-threshold.

• Änderung des Standardwerts für --mjit-max-cache von 10000 zurück auf 100.