rbs 3.10.0 → 3.10.1

data/core/set.rbs

@@ -299,7 +299,7 @@ class Set[unchecked out A]
   #   rdoc-file=set.c
   #   - add(obj) -> self
   # -->
-  # Adds the given object to the set and returns self.  Use `merge` to add many
+  # Adds the given object to the set and returns self. Use Set#merge to add many
   # elements at once.
   #
   #     Set[1, 2].add(3)                    #=> Set[1, 2, 3]
@@ -309,7 +309,7 @@ class Set[unchecked out A]
   def add: (A) -> self
 
   # <!-- rdoc-file=set.c -->
-  # Adds the given object to the set and returns self.  Use `merge` to add many
+  # Adds the given object to the set and returns self. Use Set#merge to add many
   # elements at once.
   #
   #     Set[1, 2].add(3)                    #=> Set[1, 2, 3]

data/core/signal.rbs

@@ -65,26 +65,36 @@ module Signal
 
   # <!--
   #   rdoc-file=signal.c
-  #   - Signal.trap( signal, command ) -> obj
-  #   - Signal.trap( signal ) {| | block } -> obj
+  #   - Signal.trap(signal, command) -> obj
+  #   - Signal.trap(signal) { ... } -> obj
   # -->
-  # Specifies the handling of signals. The first parameter is a signal name (a
-  # string such as ``SIGALRM'', ``SIGUSR1'', and so on) or a signal number. The
-  # characters ``SIG'' may be omitted from the signal name. The command or block
-  # specifies code to be run when the signal is raised. If the command is the
-  # string ``IGNORE'' or ``SIG_IGN'', the signal will be ignored. If the command
-  # is ``DEFAULT'' or ``SIG_DFL'', the Ruby's default handler will be invoked. If
-  # the command is ``EXIT'', the script will be terminated by the signal. If the
-  # command is ``SYSTEM_DEFAULT'', the operating system's default handler will be
-  # invoked. Otherwise, the given command or block will be run. The special signal
-  # name ``EXIT'' or signal number zero will be invoked just prior to program
-  # termination. trap returns the previous handler for the given signal.
+  # Specifies the handling of signals. Returns the previous handler for the given
+  # signal.
+  #
+  # Argument `signal` is a signal name (a string or symbol such as `SIGALRM` or
+  # `SIGUSR1`) or an integer signal number. When `signal` is a string or symbol,
+  # the leading characters `SIG` may be omitted.
+  #
+  # Argument `command` or block provided specifies code to be run when the signal
+  # is raised.
+  #
+  # Argument `command` may also be a string or symbol with the following special
+  # values:
+  #
+  # *   `IGNORE`, `SIG_IGN`: the signal will be ignored.
+  # *   `DEFAULT`, `SIG_DFL`: Ruby's default handler will be invoked.
+  # *   `EXIT`: the process will be terminated by the signal.
+  # *   `SYSTEM_DEFAULT`: the operating system's default handler will be invoked.
+  #
+  # The special signal name `EXIT` or signal number zero will be invoked just
+  # prior to program termination:
   #
   #     Signal.trap(0, proc { puts "Terminating: #{$$}" })
   #     Signal.trap("CLD")  { puts "Child died" }
   #     fork && Process.wait
   #
-  # *produces:*
+  # Outputs:
+  #
   #     Terminating: 27461
   #     Child died
   #     Terminating: 27460

data/core/string.rbs

@@ -1177,23 +1177,28 @@ class String
 
   # <!--
   #   rdoc-file=string.c
-  #   - self <=> other_string -> -1, 0, 1, or nil
+  #   - self <=> other -> -1, 0, 1, or nil
   # -->
-  # Compares `self` and `other_string`, returning:
+  # Compares `self` and `other`, evaluating their *contents*, not their *lengths*.
   #
-  # *   -1 if `other_string` is larger.
-  # *   0 if the two are equal.
-  # *   1 if `other_string` is smaller.
-  # *   `nil` if the two are incomparable.
+  # Returns:
+  #
+  # *   `-1`, if `self` is smaller.
+  # *   `0`, if the two are equal.
+  # *   `1`, if `self` is larger.
+  # *   `nil`, if the two are incomparable.
   #
   # Examples:
   #
-  #     'foo' <=> 'foo'  # => 0
-  #     'foo' <=> 'food' # => -1
-  #     'food' <=> 'foo' # => 1
-  #     'FOO' <=> 'foo'  # => -1
-  #     'foo' <=> 'FOO'  # => 1
-  #     'foo' <=> 1      # => nil
+  #     'a'  <=> 'b'  # => -1
+  #     'a'  <=> 'ab' # => -1
+  #     'a'  <=> 'a'  # => 0
+  #     'b'  <=> 'a'  # => 1
+  #     'ab' <=> 'a'  # => 1
+  #     'a'  <=> :a   # => nil
+  #
+  # Class String includes module Comparable, each of whose methods uses String#<=>
+  # for comparison.
   #
   # Related: see [Comparing](rdoc-ref:String@Comparing).
   #
@@ -1576,9 +1581,9 @@ class String
   #     s['ll'] = 'foo'  # => "foo"
   #     s  # => "hefooo"
   #
-  #     s = 'тест'
-  #     s['ес'] = 'foo'  # => "foo"
-  #     s  # => "тfooт"
+  #     s = 'Привет'
+  #     s['ив'] = 'foo'  # => "foo"
+  #     s  # => "Прfooет"
   #
   #     s = 'こんにちは'
   #     s['んにち'] = 'foo'  # => "foo"
@@ -1817,8 +1822,8 @@ class String
   # -->
   # Returns an array of the bytes in `self`:
   #
-  #     'hello'.bytes # => [104, 101, 108, 108, 111]
-  #     'тест'.bytes  # => [209, 130, 208, 181, 209, 129, 209, 130]
+  #     'hello'.bytes  # => [104, 101, 108, 108, 111]
+  #     'Привет'.bytes # => [208, 159, 209, 128, 208, 184, 208, 178, 208, 181, 209, 130]
   #     'こんにちは'.bytes
   #     # => [227, 129, 147, 227, 130, 147, 227, 129, 171, 227, 129, 161, 227, 129, 175]
   #
@@ -1840,9 +1845,9 @@ class String
   #     s = 'foo'
   #     s.bytesize # => 3
   #     s.size     # => 3
-  #     s = 'тест'
-  #     s.bytesize # => 8
-  #     s.size     # => 4
+  #     s = 'Привет'
+  #     s.bytesize # => 12
+  #     s.size     # => 6
   #     s = 'こんにちは'
   #     s.bytesize # => 15
   #     s.size     # => 5
@@ -2108,7 +2113,7 @@ class String
   #     'hello'.center(20, '-|')      # => "-|-|-|-hello-|-|-|-|" # Some padding repeated.
   #     'hello'.center(10, 'abcdefg') # => "abhelloabc"           # Some padding not used.
   #     '  hello  '.center(13)        # => "    hello    "
-  #     'тест'.center(10)             # => "   тест   "
+  #     'Привет'.center(10)           # => "  Привет  "
   #     'こんにちは'.center(10)         # => "  こんにちは   "      # Multi-byte characters.
   #
   # If `size` is less than or equal to the size of `self`, returns an unpadded
@@ -2129,7 +2134,7 @@ class String
   # Returns an array of the characters in `self`:
   #
   #     'hello'.chars     # => ["h", "e", "l", "l", "o"]
-  #     'тест'.chars      # => ["т", "е", "с", "т"]
+  #     'Привет'.chars    # => ["П", "р", "и", "в", "е", "т"]
   #     'こんにちは'.chars # => ["こ", "ん", "に", "ち", "は"]
   #     ''.chars          # => []
   #
@@ -3927,8 +3932,8 @@ class String
   # `self`, not `self`.
   #
   # If `pattern` is a Regexp, performs the equivalent of `self.match(pattern)`
-  # (also setting [pattern-matching global
-  # variables](rdoc-ref:language/globals.md@Pattern+Matching)):
+  # (also setting [matched-data
+  # variables](rdoc-ref:language/globals.md@Matched+Data)):
   #
   #     'hello'.partition(/h/)  # => ["", "h", "ello"]
   #     'hello'.partition(/l/)  # => ["he", "l", "lo"]
@@ -3941,8 +3946,8 @@ class String
   #
   # If `pattern` is not a Regexp, converts it to a string (if it is not already
   # one), then performs the equivalent of `self.index(pattern)` (and does *not*
-  # set [pattern-matching global
-  # variables](rdoc-ref:language/globals.md@Pattern+Matching)):
+  # set [matched-data global
+  # variables](rdoc-ref:language/globals.md@Matched+Data)):
   #
   #     'hello'.partition('h')     # => ["", "h", "ello"]
   #     'hello'.partition('l')     # => ["he", "l", "lo"]
@@ -4132,8 +4137,8 @@ class String
   # `self`, not `self`.
   #
   # If `pattern` is a Regexp, searches for the last matching substring (also
-  # setting [pattern-matching global
-  # variables](rdoc-ref:language/globals.md@Pattern+Matching)):
+  # setting [matched-data global
+  # variables](rdoc-ref:language/globals.md@Matched+Data)):
   #
   #     'hello'.rpartition(/l/)     # => ["hel", "l", "o"]
   #     'hello'.rpartition(/ll/)    # => ["he", "ll", "o"]
@@ -4146,8 +4151,7 @@ class String
   #
   # If `pattern` is not a Regexp, converts it to a string (if it is not already
   # one), then searches for the last matching substring (and does *not* set
-  # [pattern-matching global
-  # variables](rdoc-ref:language/globals.md@Pattern+Matching)):
+  # [matched-data global variables](rdoc-ref:language/globals.md@Matched+Data)):
   #
   #     'hello'.rpartition('l')     # => ["hel", "l", "o"]
   #     'hello'.rpartition('ll')    # => ["he", "ll", "o"]

data/core/symbol.rbs

@@ -130,19 +130,25 @@ class Symbol
 
   # <!--
   #   rdoc-file=string.c
-  #   - symbol <=> object -> -1, 0, +1, or nil
+  #   - self <=> other -> -1, 0, 1, or nil
   # -->
-  # If `object` is a symbol, returns the equivalent of `symbol.to_s <=>
-  # object.to_s`:
+  # Compares `self` and `other`, using String#<=>.
   #
-  #     :bar <=> :foo # => -1
-  #     :foo <=> :foo # => 0
-  #     :foo <=> :bar # => 1
+  # Returns:
   #
-  # Otherwise, returns `nil`:
+  # *   `self.to_s <=> other.to_s`, if `other` is a symbol.
+  # *   `nil`, otherwise.
   #
+  # Examples:
+  #
+  #     :bar <=> :foo  # => -1
+  #     :foo <=> :foo  # => 0
+  #     :foo <=> :bar  # => 1
   #     :foo <=> 'bar' # => nil
   #
+  # Class Symbol includes module Comparable, each of whose methods uses Symbol#<=>
+  # for comparison.
+  #
   # Related: String#<=>.
   #
   def <=>: (Symbol object) -> (-1 | 0 | 1)

data/core/thread.rbs

@@ -963,12 +963,11 @@ class Thread < Object
 
   # <!--
   #   rdoc-file=thread.c
-  #   - thr.raise
-  #   - thr.raise(string)
-  #   - thr.raise(exception [, string [, array]])
+  #   - raise(exception, message = exception.to_s, backtrace = nil, cause: $!)
+  #   - raise(message = nil, cause: $!)
   # -->
   # Raises an exception from the given thread. The caller does not have to be
-  # `thr`. See Kernel#raise for more information.
+  # `thr`. See Kernel#raise for more information on arguments.
   #
   #     Thread.abort_on_exception = true
   #     a = Thread.new { sleep(200) }

data/lib/rbs/collection/config/lockfile_generator.rb

@@ -184,6 +184,13 @@ module RBS
               lockfile.gems[name] = { name: name, version: "0", source: source }
             end
             return
+          when 'set', 'pathname'
+            # set and pathname is migrated to core from stdlib.
+            RBS.logger.info {
+              from = from_gem || "rbs_collection.yaml"
+              "`#{name}` is a part of the Ruby core library. The dependency to the library can be safely deleted from #{from}."
+            }
+            return
           when *ALUMNI_STDLIBS.keys
             version = ALUMNI_STDLIBS.fetch(name)
             if from_gem

data/lib/rbs/environment_loader.rb

@@ -50,12 +50,6 @@ module RBS
       when path
         dirs << path
       when library
-        case library
-        when 'pathname'
-          RBS.logger.warn "`#{library}` has been moved to core library, so it is always loaded. Remove explicit loading `#{library}`"
-          return
-        end
-
         if libs.add?(Library.new(name: library, version: version)) && resolve_dependencies
           resolve_dependencies(library: library, version: version)
         end

data/lib/rbs/subtractor.rb

@@ -107,7 +107,9 @@ module RBS
       each_member(owner).any? do |m|
         case m
         when AST::Members::InstanceVariable
-          m.name == name
+          m.name == name && kind == :instance
+        when AST::Members::ClassInstanceVariable
+          m.name == name && kind == :singleton
         when AST::Members::Attribute
           ivar_name = m.ivar_name == false ? nil : m.ivar_name || :"@#{m.name}"
           ivar_name == name && m.kind == kind

data/lib/rbs/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module RBS
-  VERSION = "3.10.0"
+  VERSION = "3.10.1"
 end

data/stdlib/cgi/0/core.rbs

@@ -1,5 +1,15 @@
 # <!-- rdoc-file=lib/cgi/escape.rb -->
-# :stopdoc
+# Since Ruby 4.0, CGI is a small holder for various escaping methods, included
+# from CGI::Escape
+#
+#     require 'cgi/escape'
+#
+#     CGI.escape("Ruby programming language")
+#     #=> "Ruby+programming+language"
+#     CGI.escapeURIComponent("Ruby programming language")
+#     #=> "Ruby%20programming%20language"
+#
+# See CGI::Escape module for methods list and their description.
 #
 class CGI
   include CGI::Util

data/stdlib/cgi-escape/0/escape.rbs

@@ -1,5 +1,15 @@
 # <!-- rdoc-file=lib/cgi/escape.rb -->
-# :stopdoc
+# Since Ruby 4.0, CGI is a small holder for various escaping methods, included
+# from CGI::Escape
+#
+#     require 'cgi/escape'
+#
+#     CGI.escape("Ruby programming language")
+#     #=> "Ruby+programming+language"
+#     CGI.escapeURIComponent("Ruby programming language")
+#     #=> "Ruby%20programming%20language"
+#
+# See CGI::Escape module for methods list and their description.
 #
 class CGI
   include Escape
@@ -7,7 +17,7 @@ class CGI
   extend Escape
 
   # <!-- rdoc-file=lib/cgi/escape.rb -->
-  # Escape/unescape for CGI, HTML, URI.
+  # Web-related escape/unescape functionality.
   #
   module Escape
     # <!--
@@ -15,7 +25,7 @@ class CGI
     #   - escape(string)
     # -->
     # URL-encode a string into application/x-www-form-urlencoded. Space characters
-    # (+" "+) are encoded with plus signs (+"+"+)
+    # (`" "`) are encoded with plus signs (`"+"`)
     #     url_encoded_string = CGI.escape("'Stop!' said Fred")
     #        # => "%27Stop%21%27+said+Fred"
     #
@@ -45,7 +55,7 @@ class CGI
     #   rdoc-file=lib/cgi/escape.rb
     #   - escapeHTML(string)
     # -->
-    # Escape special characters in HTML, namely '&"<>
+    # Escape special characters in HTML, namely `'&\"<>`
     #     CGI.escapeHTML('Usage: foo "bar" <baz>')
     #        # => "Usage: foo &quot;bar&quot; &lt;baz&gt;"
     #
@@ -55,20 +65,24 @@ class CGI
     #   rdoc-file=lib/cgi/escape.rb
     #   - escapeURIComponent(string)
     # -->
-    # URL-encode a string following RFC 3986 Space characters (+" "+) are encoded
-    # with (+"%20"+)
+    # URL-encode a string following RFC 3986 Space characters (`" "`) are encoded
+    # with (`"%20"`)
     #     url_encoded_string = CGI.escapeURIComponent("'Stop!' said Fred")
     #        # => "%27Stop%21%27%20said%20Fred"
     #
     def escapeURIComponent: (string) -> String
 
-    # <!-- rdoc-file=lib/cgi/escape.rb -->
-    # Synonym for CGI.escapeElement(str)
+    # <!--
+    #   rdoc-file=lib/cgi/escape.rb
+    #   - escape_element(string, *elements)
+    # -->
     #
     alias escape_element escapeElement
 
-    # <!-- rdoc-file=lib/cgi/escape.rb -->
-    # Synonym for CGI.escapeHTML(str)
+    # <!--
+    #   rdoc-file=lib/cgi/escape.rb
+    #   - escape_html(string)
+    # -->
     #
     alias escape_html escapeHTML
 
@@ -101,7 +115,7 @@ class CGI
     #   rdoc-file=lib/cgi/escape.rb
     #   - unescapeElement(string, *elements)
     # -->
-    # Undo escaping such as that done by CGI.escapeElement()
+    # Undo escaping such as that done by CGI.escapeElement
     #
     #     print CGI.unescapeElement(
     #             CGI.escapeHTML('<BR><A HREF="url"></A>'), "A", "IMG")
@@ -133,13 +147,17 @@ class CGI
     #
     def unescapeURIComponent: (string) -> String
 
-    # <!-- rdoc-file=lib/cgi/escape.rb -->
-    # Synonym for CGI.unescapeElement(str)
+    # <!--
+    #   rdoc-file=lib/cgi/escape.rb
+    #   - unescape_element(string, *elements)
+    # -->
     #
     alias unescape_element unescapeElement
 
-    # <!-- rdoc-file=lib/cgi/escape.rb -->
-    # Synonym for CGI.unescapeHTML(str)
+    # <!--
+    #   rdoc-file=lib/cgi/escape.rb
+    #   - unescape_html(string)
+    # -->
     #
     alias unescape_html unescapeHTML
 

data/stdlib/pathname/0/pathname.rbs

@@ -0,0 +1,36 @@
+%a{annotate:rdoc:skip}
+class Pathname
+  # <!--
+  #   rdoc-file=lib/pathname.rb
+  #   - find(ignore_error: true) { |pathname| ... }
+  # -->
+  # Iterates over the directory tree in a depth first manner, yielding a Pathname
+  # for each file under "this" directory.
+  #
+  # Note that you need to require 'pathname' to use this method.
+  #
+  # Returns an Enumerator if no block is given.
+  #
+  # Since it is implemented by the standard library module Find, Find.prune can be
+  # used to control the traversal.
+  #
+  # If `self` is `.`, yielded pathnames begin with a filename in the current
+  # directory, not `./`.
+  #
+  # See Find.find
+  #
+  def find: (?ignore_error: boolish) { (Pathname) -> untyped } -> nil
+          | (?ignore_error: boolish) -> Enumerator[Pathname, nil]
+
+  # <!--
+  #   rdoc-file=lib/pathname.rb
+  #   - rmtree(noop: nil, verbose: nil, secure: nil)
+  # -->
+  # Recursively deletes a directory, including all directories beneath it.
+  #
+  # Note that you need to require 'pathname' to use this method.
+  #
+  # See FileUtils.rm_rf
+  #
+  def rmtree: () -> self
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rbs
 version: !ruby/object:Gem::Version
-  version: 3.10.0
+  version: 3.10.1
 platform: ruby
 authors:
 - Soutaro Matsumoto
@@ -460,6 +460,7 @@ files:
 - stdlib/openssl/0/manifest.yaml
 - stdlib/openssl/0/openssl.rbs
 - stdlib/optparse/0/optparse.rbs
+- stdlib/pathname/0/pathname.rbs
 - stdlib/pp/0/manifest.yaml
 - stdlib/pp/0/pp.rbs
 - stdlib/prettyprint/0/prettyprint.rbs
@@ -562,7 +563,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.2
+rubygems_version: 4.0.3
 specification_version: 4
 summary: Type signature for Ruby.
 test_files: []