NEWS für Ruby 3.1.0

Dieses Dokument listet änderungen an benutzerorientierten Funktionen seit der Veröffentlichung 3.0.0 auf, mit Ausnahme von Fehlerbehebungen.

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

Sprachänderungen

• Das Blockargument kann nun anonym sein, wenn der Block nur an eine andere Methode übergeben wird. [Feature #11256]

  def foo(&)
    bar(&)
  end
  

• Der Pin-Operator nimmt nun einen Ausdruck an. [Feature #17411]

  Prime.each_cons(2).lazy.find_all{_1 in [n, ^(n + 2)]}.take(3).to_a
  #=> [[3, 5], [5, 7], [11, 13]]
  

• Der Pin-Operator unterstützt nun Instanz-, Klassen- und globale Variablen. [Feature #17724]

  @n = 5
  Prime.each_cons(2).lazy.find{_1 in [n, ^@n]}
  #=> [3, 5]
  

• Pattern Matching für einzeilige Ausdrücke ist nicht mehr experimentell.

• Klammern können beim einzeiligen Pattern Matching weggelassen werden. [Feature #16182]

  [0, 1] => _, x
  {y: 2} => y:
  x #=> 1
  y #=> 2
  

• Die Auswertungsreihenfolge von Mehrfachzuweisungen wurde mit der Auswertungsreihenfolge von Einzelzuweisungen konsistent gemacht. Bei Einzelzuweisungen verwendet Ruby eine Auswertungsreihenfolge von links nach rechts. Mit diesem Code

  foo[0] = bar
  

  Wird die folgende Auswertungsreihenfolge verwendet

  1. foo

  2. bar

  3. []= wird auf dem Ergebnis von foo aufgerufen

  In Ruby vor 3.1.0 folgte die Mehrfachzuweisung nicht dieser Auswertungsreihenfolge. Mit diesem Code

  foo[0], bar.baz = a, b
  

  Würden Versionen von Ruby vor 3.1.0 in der folgenden Reihenfolge ausgewertet

  1. a

  2. b

  3. foo

  4. []= wird auf dem Ergebnis von foo aufgerufen

  5. bar

  6. baz= wird auf dem Ergebnis von bar aufgerufen

  Ab Ruby 3.1.0 ist die Auswertungsreihenfolge nun konsistent mit Einzelzuweisungen, wobei die linke Seite vor der rechten Seite ausgewertet wird

  1. foo

  2. bar

  3. a

  4. b

  5. []= wird auf dem Ergebnis von foo aufgerufen

  6. baz= wird auf dem Ergebnis von bar aufgerufen

  [Bug #4443]

• Werte in Hash-Literalen und Schlüsselwortargumenten können weggelassen werden. [Feature #14579]

  Zum Beispiel,

  • {x:, y:} ist eine Syntax-Zucker von {x: x, y: y}.

  • foo(x:, y:) ist eine Syntax-Zucker von foo(x: x, y: y).

  Konstantennamen, lokale Variablennamen und Methodennamen sind als Schlüsselnamen erlaubt. Beachten Sie, dass ein reserviertes Wort als lokale Variable oder Methodenname betrachtet wird, auch wenn es ein Pseudovariablenname wie self ist.

• Nicht-Haupt-Raktoren können Instanzvariablen (ivars) von Klassen/Modulen abrufen, wenn ivars auf teilbare Objekte verweisen. [Feature #17592]

• Eine Befehlssyntax ist in endlosen Methodendefinitionen erlaubt, d.h. Sie können jetzt def foo = puts "Hello" schreiben. Beachten Sie, dass private def foo = puts "Hello" nicht geparst wird. [Feature #17398]

Kommandozeilenoptionen

• --disable-gems ist nun explizit als "nur zum Debuggen" deklariert. Verwenden Sie es niemals in produktionsrelevantem Code. [Feature #17684]

Aktualisierungen von Kernklassen

Hinweis: Wir listen nur wichtige Klassenaktualisierungen auf.

• Array

  • Array#intersect? wurde hinzugefügt. [Feature #15198]

• Class

  • Class#subclasses, das ein Array von Klassen zurückgibt, die direkt vom Empfänger erben, mit Ausnahme von Singleton-Klassen. [Feature #18273]

    class A; end
    class B < A; end
    class C < B; end
    class D < A; end
    A.subclasses    #=> [D, B]
    B.subclasses    #=> [C]
    C.subclasses    #=> []
    

• Enumerable

  • Enumerable#compact wurde hinzugefügt. [Feature #17312]

  • Enumerable#tally akzeptiert nun einen optionalen Hash zum Zählen. [Feature #17744]

  • Enumerable#each_cons und each_slice geben nun einen Empfänger zurück. [GH-1509]

    [1, 2, 3].each_cons(2){}
    # 3.0 => nil
    # 3.1 => [1, 2, 3]
    
    [1, 2, 3].each_slice(2){}
    # 3.0 => nil
    # 3.1 => [1, 2, 3]
    

• Enumerator::Lazy

  • Enumerator::Lazy#compact wurde hinzugefügt. [Feature #17312]

• File

  • File.dirname akzeptiert nun ein optionales Argument für die Ebene, um Pfadkomponenten zu entfernen. [Feature #12194]

• GC

  • "GC.measure_total_time = true" aktiviert die Messung von GC. Die Messung kann zu Overhead führen. Sie ist standardmäßig aktiviert. GC.measure_total_time gibt die aktuelle Einstellung zurück. GC.stat[:time] oder GC.stat(:time) gibt die gemessene Zeit in Millisekunden zurück. [[Feature #10917]]

  • GC.total_time gibt die gemessene Zeit in Nanosekunden zurück. [[Feature #10917]]

• Integer

  • Integer.try_convert wurde hinzugefügt. [Feature #15211]

• Kernel

  • Kernel#load akzeptiert nun ein Modul als zweites Argument und lädt die Datei unter Verwendung des gegebenen Moduls als oberstes Modul. [Feature #6210]

• Marshal

  • Marshal.load akzeptiert nun die Option freeze: true. Alle zurückgegebenen Objekte sind gefroren, außer Class- und Module-Instanzen. Zeichenketten werden dedupliziert. [Feature #18148]

• MatchData

  • MatchData#match wurde hinzugefügt [Feature #18172]

  • MatchData#match_length wurde hinzugefügt [Feature #18172]

• Methode / UnboundMethod

  • Method#public?, Method#private?, Method#protected?, UnboundMethod#public?, UnboundMethod#private?, UnboundMethod#protected? wurden hinzugefügt. [Feature #11689]

• Module

  • Module#prepend modifiziert nun die Vorfahrenkette, wenn der Empfänger bereits das Argument enthält. Module#prepend modifiziert die Vorfahrenkette immer noch nicht, wenn der Empfänger das Argument bereits vorangestellt hat. [Bug #17423]

  • Module#private, public, protected und module_function geben nun ihre Argumente zurück. Wenn ein einzelnes Argument gegeben wird, wird es zurückgegeben. Wenn keine Argumente gegeben werden, wird nil zurückgegeben. Wenn mehrere Argumente gegeben werden, werden sie als Array zurückgegeben. [Feature #12495]

• Process

  • Process._fork wurde hinzugefügt. Dies ist eine Kernmethode für fork(2). Rufen Sie diese Methode nicht direkt auf; sie wird von bestehenden fork-Methoden aufgerufen: Kernel.#fork, Process.fork und IO.popen(“-”). Anwendungsüberwachungsbibliotheken können diese Methode überschreiben, um fork-Ereignisse abzufangen. [Feature #17795]

• Struct

  • Das Übergeben von nur Schlüsselwortargumenten an Struct#initialize führt zu einer Warnung. Sie müssen ein Hash-Literal verwenden, um einen Hash an das erste Element zu übergeben. [Feature #16806]

  • StructClass#keyword_init? wurde hinzugefügt [Feature #18008]

• String

  • Unicode-Version auf 13.0.0 [Feature #17750] und Emoji-Version auf 13.0 [Feature #18029] aktualisiert

  • String#unpack und String#unpack1 akzeptieren nun ein Schlüsselwortargument offset:, um das Entpacken nach dem Überspringen einer beliebigen Anzahl von Bytes zu starten. Wenn offset außerhalb der String-Grenzen liegt, wird ein ArgumentError ausgelöst. [Feature #18254]

• Thread

  • Thread#native_thread_id wurde hinzugefügt. [Feature #17853]

• Thread::Backtrace

  • Thread::Backtrace.limit, das den durch die Kommandozeilenoption --backtrace-limit gesetzten Wert für die Begrenzung der Rückverfolgungslänge zurückgibt, wurde hinzugefügt. [Feature #17479]

• Thread::Queue

  • Thread::Queue.new akzeptiert nun ein Enumerable von Anfangswerten. [Feature #17327]

• Time

  • Time.new akzeptiert nun ein optionales Schlüsselwortargument in: für die Zeitzone, ebenso wie Time.at und Time.now, so dass Sie nun kleinere Argumente an Time.new weglassen können. [Feature #17485]

    Time.new(2021, 12, 25, in: "+07:00")
    #=> 2021-12-25 00:00:00 +0700
    

    Gleichzeitig werden Zeitkomponenten-Zeichenketten nun strenger in Ganzzahlen umgewandelt.

    Time.new(2021, 12, 25, "+07:30")
    #=> invalid value for Integer(): "+07:30" (ArgumentError)
    

    Ruby 3.0 oder früher gab wahrscheinlich ein unerwartetes Ergebnis 2021-12-25 07:00:00 zurück, nicht 2021-12-25 07:30:00 noch 2021-12-25 00:00:00 +07:30.

  • Time#strftime unterstützt RFC 3339 UTC für unbekannte Offset-Lokalzeit, -0000, als %-z. [Feature #17544]

• TracePoint

  • TracePoint.allow_reentry wurde hinzugefügt, um das erneute Betreten während des TracePoint-Callbacks zu ermöglichen. [Feature #15912]

• $LOAD_PATH

  • $LOAD_PATH.resolve_feature_path löst keinen Fehler aus. [Feature #16043]

• Fiber Scheduler

  • Unterstützung für Addrinfo.getaddrinfo mit dem Hook address_resolve hinzugefügt. [Feature #17370]

  • Nicht-blockierendes Timeout.timeout über den Hook timeout_after eingeführt. [Feature #17470]

  • Neue Scheduler-Hooks io_read und io_write zusammen mit einem Low-Level IO::Buffer für Zero-Copy-Lese-/Schreibvorgänge eingeführt. [Feature #18020]

  • IO-Hooks io_wait, io_read, io_write empfangen das ursprüngliche IO-Objekt, wenn möglich. [Bug #18003]

  • Monitor wurde Fiber-sicher gemacht. [Bug #17827]

  • Kopier-Coroutine durch pthread-Implementierung ersetzt. [Feature #18015]

• Refinement

  • Neue Klasse, die ein durch Module#refine erzeugtes Modul darstellt. include und prepend sind veraltet, und stattdessen wurde import_methods hinzugefügt. [Bug #17429]

Aktualisierungen der Standardbibliothek

• Die folgenden Standardgems wurden aktualisiert.

  • RubyGems 3.3.3

  • base64 0.1.1

  • benchmark 0.2.0

  • bigdecimal 3.1.1

  • bundler 2.3.3

  • cgi 0.3.1

  • csv 3.2.2

  • date 3.2.2

  • did_you_mean 1.6.1

  • digest 3.1.0

  • drb 2.1.0

  • erb 2.2.3

  • error_highlight 0.3.0

  • etc 1.3.0

  • fcntl 1.0.1

  • fiddle 1.1.0

  • fileutils 1.6.0

  • find 0.1.1

  • io-console 0.5.10

  • io-wait 0.2.1

  • ipaddr 1.2.3

  • irb 1.4.1

  • json 2.6.1

  • logger 1.5.0

  • net-http 0.2.0

  • net-protocol 0.1.2

  • nkf 0.1.1

  • open-uri 0.2.0

  • openssl 3.0.0

  • optparse 0.2.0

  • ostruct 0.5.2

  • pathname 0.2.0

  • pp 0.3.0

  • prettyprint 0.1.1

  • psych 4.0.3

  • racc 1.6.0

  • rdoc 6.4.0

  • readline 0.0.3

  • readline-ext 0.1.4

  • reline 0.3.0

  • resolv 0.2.1

  • rinda 0.1.1

  • ruby2_keywords 0.0.5

  • securerandom 0.1.1

  • set 1.0.2

  • stringio 3.0.1

  • strscan 3.0.1

  • tempfile 0.1.2

  • time 0.2.0

  • timeout 0.2.0

  • tmpdir 0.1.2

  • un 0.2.0

  • uri 0.11.0

  • yaml 0.2.0

  • zlib 2.1.1

  • RubyGems 3.3.3

  • base64 0.1.1

  • benchmark 0.2.0

  • bigdecimal 3.1.1

  • bundler 2.3.3

  • cgi 0.3.1

  • csv 3.2.2

  • date 3.2.2

  • did_you_mean 1.6.1

  • digest 3.1.0

  • drb 2.1.0

  • erb 2.2.3

  • error_highlight 0.3.0

  • etc 1.3.0

  • fcntl 1.0.1

  • fiddle 1.1.0

  • fileutils 1.6.0

  • find 0.1.1

  • io-console 0.5.10

  • io-wait 0.2.1

  • ipaddr 1.2.3

  • irb 1.4.1

  • json 2.6.1

  • logger 1.5.0

  • net-http 0.2.0

  • net-protocol 0.1.2

  • nkf 0.1.1

  • open-uri 0.2.0

  • openssl 3.0.0

  • optparse 0.2.0

  • ostruct 0.5.2

  • pathname 0.2.0

  • pp 0.3.0

  • prettyprint 0.1.1

  • psych 4.0.3

  • racc 1.6.0

  • rdoc 6.4.0

  • readline 0.0.3

  • readline-ext 0.1.4

  • reline 0.3.0

  • resolv 0.2.1

  • rinda 0.1.1

  • ruby2_keywords 0.0.5

  • securerandom 0.1.1

  • set 1.0.2

  • stringio 3.0.1

  • strscan 3.0.1

  • tempfile 0.1.2

  • time 0.2.0

  • timeout 0.2.0

  • tmpdir 0.1.2

  • un 0.2.0

  • uri 0.11.0

  • yaml 0.2.0

  • zlib 2.1.1

• Die folgenden gebündelten Gems wurden aktualisiert.

  • minitest 5.15.0

  • power_assert 2.0.1

  • rake 13.0.6

  • test-unit 3.5.3

  • rexml 3.2.5

  • rbs 2.0.0

  • typeprof 0.21.1

  • minitest 5.15.0

  • power_assert 2.0.1

  • rake 13.0.6

  • test-unit 3.5.3

  • rexml 3.2.5

  • rbs 2.0.0

  • typeprof 0.21.1

• Die folgenden Standardgems sind nun gebündelte Gems.

  • net-ftp 0.1.3

  • net-imap 0.2.2

  • net-pop 0.1.1

  • net-smtp 0.3.1

  • matrix 0.4.2

  • prime 0.1.2

  • debug 1.4.0

  • net-ftp 0.1.3

  • net-imap 0.2.2

  • net-pop 0.1.1

  • net-smtp 0.3.1

  • matrix 0.4.2

  • prime 0.1.2

  • debug 1.4.0

• Die folgenden Gems wurden aus der Ruby-Standardbibliothek entfernt.

  • dbm

  • gdbm

  • tracer

  • dbm

  • gdbm

  • tracer

• Coverage-Messung unterstützt nun Unterbrechung. Sie können Coverage.suspend verwenden, um die Messung vorübergehend zu stoppen, und Coverage.resume, um sie neu zu starten. Lesen Sie [Feature #18176] im Detail.

• Random::Formatter wurde nach random/formatter.rb verschoben, sodass Sie Random#hex, Random#base64 usw. ohne SecureRandom verwenden können. [Feature #18190]

Kompatibilitätsprobleme

Hinweis: Ausgeschlossen sind Fehlerbehebungen von Funktionen.

• rb_io_wait_readable, rb_io_wait_writable und rb_wait_for_single_fd sind zugunsten von rb_io_maybe_wait_readable, rb_io_maybe_wait_writable bzw. rb_io_maybe_wait veraltet. rb_thread_wait_fd und rb_thread_fd_writable sind veraltet. [Bug #18003]

Kompatibilitätsprobleme der Standardbibliothek

• ERB#initialize warnt safe_level und spätere Argumente, auch ohne -w. [Feature #14256]

• lib/debug.rb wurde durch debug.gem ersetzt

• Kernel#pp in lib/pp.rb verwendet standardmäßig die Breite von IO#winsize. Das bedeutet, dass die Ausgabebreite je nach Terminalgröße automatisch geändert wird. [Feature #12913]

• Psych 4.0 ändert Psych.load standardmäßig als safe_load. Möglicherweise müssen Sie Psych 3.3.2 für die Migration zu diesem Verhalten verwenden. [Bug #17866]

Updates der C-API

• Dokumentiert. [GH-4815]

• rb_gc_force_recycle ist veraltet und wurde zu einem No-Op geändert. [Feature #18290]

Implementierungsverbesserungen

• Der Inline-Cache-Mechanismus wurde für das Lesen von Klassenvariablen eingeführt. [Feature #17763]

• instance_eval und instance_exec weisen nun nur dann eine Singleton-Klasse zu, wenn dies erforderlich ist, wodurch zusätzliche Objekte vermieden und die Leistung verbessert wird. [GH-5146]

• Die Leistung von Struct-Accessoren wurde verbessert. [GH-5131]

• mandatory_only? eingebaute spezielle Form, um die Leistung bei eingebauten Methoden zu verbessern. [GH-5112]

• Experimentelle Funktion Variable Width Allocation im Garbage Collector. Diese Funktion ist standardmäßig deaktiviert und kann durch Kompilieren von Ruby mit gesetztem Flag USE_RVARGC=1 aktiviert werden. [Feature #18045] [Feature #18239]

JIT

• --jit von Ruby 3.0 wurde in --mjit umbenannt und --jit wurde auf Nicht-Windows x86-64-Plattformen zu --yjit und auf anderen zu --mjit aliasifiziert.

MJIT

• Der Standardwert von --mjit-max-cache wurde von 100 auf 10000 geändert.

• JIT-kompilierter Code wird nicht mehr abgebrochen, wenn ein TracePoint für Klassenevents aktiviert ist.

• Der JIT-Compiler überspringt die Kompilierung von Methoden mit mehr als 1000 Anweisungen nicht mehr.

• --mjit-verbose und --mjit-warning geben "JIT cancel" aus, wenn JIT-kompilierter Code deaktiviert wird, weil TracePoint oder GC.compact verwendet wird.

YJIT: Neuer experimenteller In-Process JIT-Compiler

Neuer JIT-Compiler als experimentelle Funktion verfügbar. [Feature #18229]

Siehe diesen Blogbeitrag, der das Projekt vorstellt.

• Standardmäßig deaktiviert, verwenden Sie die Kommandozeilenoption --yjit, um YJIT zu aktivieren.

• Leistungsverbesserungen bei Benchmarks, die auf realer Software basieren, bis zu 22% bei railsbench, 39% bei liquid-render.

• Schnelle Aufwärmzeiten.

• Derzeit nur für Unix-ähnliche x86-64-Plattformen.

Statische Analyse

RBS

• Generische Typparameter können eingeschränkt werden (PR).

  # `T` must be compatible with the `_Output` interface.
  # `PrettyPrint[String]` is ok, but `PrettyPrint[Integer]` is a type error.
  class PrettyPrint[T < _Output]
    interface _Output
      def <<: (String) -> void
    end
  
    attr_reader output: T
  
    def initialize: (T output) -> void
  end

• Typaliasierungen können generisch sein. (PR)

  # Defines a generic type `list`.
  type list[T] = [ T, list[T] ]
               | nil
  
  type str_list = list[String]
  type int_list = list[Integer]

• rbs collection wurde eingeführt, um RBS von Gems zu verwalten.

• Viele Signaturen für integrierte und Standardbibliotheken wurden hinzugefügt/aktualisiert.

• Es enthält auch viele Fehlerbehebungen und Leistungsverbesserungen.

Weitere Informationen finden Sie im CHANGELOG.md.

TypeProf

• Experimentelle IDE-Unterstützung wurde implementiert.

• Viele Fehlerbehebungen und Leistungsverbesserungen seit Ruby 3.0.0.

Debugger

• Ein neuer Debugger debug.gem ist gebündelt. debug.gem ist eine schnelle Debugger-Implementierung und bietet viele Funktionen wie Remote-Debugging, farbige REPL, IDE (VSCode)-Integration und mehr. Er ersetzt die Standardbibliothek lib/debug.rb.

• Der Befehl rdbg wird auch in das Verzeichnis bin/ installiert, um die Debugging-Ausführung zu starten und zu steuern.

error_highlight

Ein integriertes Gem namens error_highlight wurde eingeführt. Es zeigt detaillierte Fehlerpositionen in der Rückverfolgung.

Beispiel: title = json[:article][:title]

Wenn json nil ist, zeigt es

$ ruby test.rb
test.rb:2:in `<main>': undefined method `[]' for nil:NilClass (NoMethodError)

title = json[:article][:title]
            ^^^^^^^^^^

Wenn json[:article] nil zurückgibt, zeigt es

$ ruby test.rb
test.rb:2:in `<main>': undefined method `[]' for nil:NilClass (NoMethodError)

title = json[:article][:title]
                      ^^^^^^^^

Diese Funktion ist standardmäßig aktiviert. Sie können sie mit der Kommandozeilenoption --disable-error_highlight deaktivieren. Details finden Sie im Repository.

IRB Autovervollständigung und Dokumentationsanzeige

IRB verfügt nun über eine Autovervollständigungsfunktion, bei der Sie einfach Code eingeben können und ein Dialogfeld mit Vervollständigungskandidaten erscheint. Sie können Tab und Shift+Tab verwenden, um nach oben und unten zu navigieren.

Wenn Dokumente installiert sind, wenn Sie einen Vervollständigungskandidaten auswählen, erscheint ein Dokumentationsdialog neben dem Dialogfeld mit den Vervollständigungskandidaten, das einen Teil des Inhalts anzeigt. Sie können das vollständige Dokument lesen, indem Sie Alt+d drücken.

Sonstige Änderungen

• lib/objspace/trace.rb wurde hinzugefügt, ein Werkzeug zur Nachverfolgung der Objektallokation. Allein durch das Einbinden dieser Datei wird die Nachverfolgung *sofort* gestartet. Allein durch Kernel#p können Sie untersuchen, wo ein Objekt erstellt wurde. Beachten Sie, dass allein das Einbinden dieser Datei zu einem erheblichen Leistungs-Overhead führt. Dies ist nur zu Debugging-Zwecken. Verwenden Sie dies nicht in der Produktion. [Feature #17762]

• Ausnahmen, die in Finalizern ausgelöst werden, werden nun auf STDERR gedruckt, es sei denn, $VERBOSE ist nil. [Feature #17798]

• ruby -run -e httpd zeigt URLs zum Zugriff an. [Feature #17847]

• Fügt ruby -run -e colorize hinzu, um Ruby-Code mit IRB::Color.colorize_code zu kolorieren.